Fusion de plusieurs sites en un seul site
La prise en charge multisite de la configuration automatisée fournit une méthode pour fusionner plusieurs sites locaux en un seul site cloud.
La prise en charge multisite ajoute des préfixes et des suffixes uniques aux noms de composants basés sur chaque site local, garantissant ainsi l’unicité des noms après la fusion de plusieurs sites locaux en un seul site cloud.
Des préfixes et des suffixes peuvent être affectés à chacun des composants suivants pour chaque site.
AdminScopeAdminRoleApplicationAdminApplicationFolderApplicationGroupApplicationUserDeliveryGroupGroupPolicyHostConnectionMachineCatalogStoreFrontTag
Les dossiers d’application prennent en charge l’ajout de préfixe, de suffixe et le changement de racine. Le changement de racine ajoute un dossier de niveau supérieur supplémentaire à la structure de dossiers existante d’une application.
Règles d’ajout de préfixe et de suffixe
- Les préfixes et les suffixes ne peuvent contenir aucun des caractères spéciaux suivants :
\ , / ; : # . * ? = < > | ( ) " ' { } [ ] - Les préfixes et les suffixes peuvent contenir des espaces de fin mais pas des espaces de début.
- Les préfixes et les suffixes doivent être placés entre guillemets pour pouvoir contenir des espaces de fin.
- Les préfixes et les suffixes sont appliqués au moment de l’importation, de la fusion et de l’ajout. Les fichiers .yml source ne sont jamais modifiés.
- Le processus ajoute automatiquement des préfixes et des suffixes aux noms de composants dépendants le cas échéant. Par exemple, si les noms de catalogue de machines sont préfixés par « East », les groupes de mise à disposition qui les référencent sont également préfixés par « East ».
- Si un nom de composant commence déjà par le préfixe ou le suffixe, aucun préfixe ou suffixe n’est ajouté. Les noms de composants ne peuvent pas contenir de préfixes ou de suffixes doubles identiques.
- Les préfixes et les suffixes peuvent être utilisés individuellement ou combinés.
- L’utilisation d’un préfixe ou d’un suffixe sur un composant est facultative.
Remarque :
Studio affiche les composants par ordre alphabétique.
Grouper par site
Utilisez un préfixe pour regrouper visuellement les composants d’un seul site. Chaque site est répertorié dans son propre groupe avec préfixe appliqué par ordre alphabétique pour contrôler l’ordre des différents groupes de sites.
Grouper par nom
Utilisez un suffixe pour regrouper visuellement des composants de nom similaire dans plusieurs sites. Les composants de même nom provenant de différents sites alternent visuellement.
Fichier SitePrefixes.yml
Pour les préfixes de site, le processus commence par le fichier SiteMerging.yml qui contient le mappage de préfixe et de suffixe pour un ou plusieurs sites locaux. Vous pouvez gérer le fichier SiteMerging.yml manuellement ou à l’aide des applets de commande disponibles répertoriées dans la section Fusion de plusieurs applets de commande de sites locaux.
Exportation, importation, fusion et ajout
La fusion ne peut pas commencer tant que vous n’avez pas exporté un site local. Pour exporter un site local, consultez la section Migration d’une configuration locale vers le cloud.
Dossier cible central pour l’exportation
Les méthodes décrites dans cette section placent plusieurs exportations de sites dans un emplacement central de partage de fichiers. Le fichier SiteMerging.yml, le fichier CustomerInfo.yml et tous les fichiers d’exportation résident dans cet emplacement de partage de fichiers, ce qui vous permet d’effectuer l’importation à partir d’un emplacement indépendant des sites locaux.
Les opérations d’accès au cloud ne font jamais référence aux sites locaux ou à Active Directory, ce qui vous permet d’effectuer des opérations d’accès au cloud depuis n’importe où.
Partage direct de fichiers
Les opérations d’exportation, d’importation, de fusion et de création/ajout fournissent un paramètre pour utiliser un dossier cible ou source autre que le dossier par défaut, %HOMEPATH%\Documents\Citrix\AutoConfig. Les exemples suivants utilisent un partage de fichiers central situé sur \\share.central.net auquel l’administrateur a déjà accès, après avoir fourni des informations d’identification si nécessaire.
Pour effectuer l’exportation vers un dossier cible spécifique au site, utilisez le paramètre –TargetFolder :
Depuis le DDC East :
mkdir \\share.central.net\AutoConfig\SiteEast
Export-CvadAcToFile –TargetFolder \\share.central.net\AutoConfig\SiteEast
Depuis le DDC West :
mkdir \\share.central.net\AutoConfig\SiteWest
Export-CvadAcToFile –TargetFolder \\share.central.net\AutoConfig\SiteWest
Une fois les exportations terminées, créez les fichiers CustomerInfo.yml et SiteMerging.yml et placez-les dans \\share.central.net\AutoConfig.
Remarque :
N’utilisez pas le paramètre
SiteRootFolderlors de la création de SitePrefixes.yml si vous utilisez cette méthode de référence de partage de fichiers direct.
Pour importer, fusionner ou ajouter à partir du partage de fichiers direct, vous devez décider de la machine à partir de laquelle vous souhaitez effectuer l’opération d’accès au cloud. Les options sont les suivantes :
- Un des DDC locaux où l’outil est déjà installé.
- La machine hébergeant le partage de fichiers.
- Une autre machine.
La configuration automatisée doit être installée sur la machine accédant au cloud. Ni le SDK PowerShell local, ni le DDC, ni Active Directory ne sont utilisés, de sorte que les exigences d’accès au cloud sont plus simples que les exigences d’exportation.
Pour fusionner le DDC East sur le cloud :
Merge-CvadAcToSite –SiteName East –SourceFolder \\share.central.net\AutoConfig\SiteEast -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml
Pour fusionner le DDC West sur le cloud :
Merge-CvadAcToSite –SiteName West –SourceFolder \\share.central.net\AutoConfig\SiteWest -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml
Voici un exemple de fichier SitePrefixes.yml basé sur l’exemple précédent.
East:
SiteRootFolder: "" # Important: leave this empty
AdminScopePrefix: "East_"
AdminRolePrefix: "East_"
ApplicationAdminPrefix: "East_"
ApplicationFolderPrefix: "" # Note that a new parent root folder is used instead
ApplicationFolderRoot: "East"
ApplicationGroupPrefix: "East_"
ApplicationUserPrefix: "East_"
DeliveryGroupPrefix: "East_"
GroupPolicyPrefix: "East_"
HostConnectionPrefix: "East_"
MachineCatalogPrefix: "East_"
StoreFrontPrefix: "East_"
TagPrefix: "East_"
AdminScopeSuffix: "_east"
AdminRoleSuffix: "_east"
ApplicationAdminSuffix: "_east"
ApplicationFolderSuffix: "_east"
ApplicationGroupSuffix: "_east"
ApplicationUserSuffix: "_east"
DeliveryGroupSuffix: "_east"
GroupPolicySuffix: "_east"
HostConnectionSuffix: "_east"
MachineCatalogSuffix: "_east"
StoreFrontSuffix: "_east"
TagSuffix: "_east"
West:
SiteRootFolder: "" # Important: leave this empty
AdminScopePrefix: "Western "
AdminRolePrefix: "Western "
ApplicationAdminPrefix: "Western "
ApplicationFolderPrefix: "" # Note that a new parent root folder is used instead
ApplicationFolderRoot: "Western"
ApplicationGroupPrefix: "Western "
ApplicationUserPrefix: "Western "
DeliveryGroupPrefix: "Western "
GroupPolicyPrefix: "Western "
HostConnectionPrefix: "Western "
MachineCatalogPrefix: "Western "
StoreFrontPrefix: "Western "
TagPrefix: "Western "
AdminScopeSuffix: ""
AdminRoleSuffix: ""
ApplicationAdminSuffix: ""
ApplicationFolderSuffix: ""
ApplicationGroupSuffix: ""
ApplicationUserSuffix: ""
DeliveryGroupSuffix: ""
GroupPolicySuffix: ""
HostConnectionSuffix: ""
MachineCatalogSuffix: ""
StoreFrontSuffix: ""
TagSuffix: ""
Référence de partage de fichiers à l’aide de SiteMerging.yml
Cette méthode utilise le membre SiteRootFolder du jeu de préfixes du site. Bien qu’elle soit plus impliquée que la méthode de partage de fichiers direct, cette méthode réduit les chances de cibler le mauvais dossier lors de l’exportation, de l’importation, de la fusion ou de l’ajout.
Tout d’abord, définissez le SiteRootFolder pour chaque site dans le fichier SiteMerging.yml. Vous devez le faire sur l’emplacement partagé.
New-CvadAcSiteMergingInfo –SiteName East –SiteRootFolder \\share.central.net\AutoConfig\SiteEast -SitePrefixesFolder \\share.central.net\AutoConfig
New-CvadAcSiteMergingInfo –SiteName West –SiteRootFolder SiteWest -SitePrefixesFolder \\share.central.net\AutoConfig
Dans cet exemple, East est une spécification de dossier complète et West est une spécification de dossier relative.
Pour utiliser un dossier d’exportation cible spécifique au site à l’aide du fichier SiteMerging.yml :
Depuis le DDC East :
mkdir \\share.central.net\AutoConfig\SiteEast
Export-CvadAcToFile -SiteName East -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml
Depuis le DDC West :
mkdir \\share.central.net\AutoConfig\SiteWest
Export-CvadAcToFile -SiteName West -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml
L’applet de commande d’exportation utilise l’emplacement du dossier CustomerInfo.yml pour localiser le fichier SiteMerging.yml. Dans le cas du dossier East, la spécification SiteRootFolder est complète. Elle est utilisée telle quelle. Dans le cas du dossier West, la spécification SiteRootFolder n’est pas complète. Elle est combinée avec l’emplacement du dossier CustomerInfo.yml pour récupérer un emplacement de dossier complet pour West.
Pour fusionner le DDC East sur le cloud :
Merge-CvadAcToSite –SiteName East -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml
Pour fusionner le DDC West sur le cloud :
Merge-CvadAcToSite –SiteName West -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml
Voici un exemple de fichier SitePrefixes.yml basé sur l’exemple précédent.
East:
SiteRootFolder: "\\\\share.central.net\\AutoConfig\\SiteEast"
AdminScopePrefix: "East_"
AdminRolePrefix: "East_"
ApplicationAdminPrefix: "East_"
ApplicationFolderPrefix: "" # Note that a new parent root folder is used instead
ApplicationFolderRoot: "East"
ApplicationGroupPrefix: "East_"
ApplicationUserPrefix: "East_"
DeliveryGroupPrefix: "East_"
GroupPolicyPrefix: "East_"
HostConnectionPrefix: "East_"
MachineCatalogPrefix: "East_"
StoreFrontPrefix: "East_"
TagPrefix: "East_"
AdminScopeSuffix: "_east"
AdminRoleSuffix: "_east"
ApplicationAdminSuffix: "_east"
ApplicationFolderSuffix: "_east"
ApplicationGroupSuffix: "_east"
ApplicationUserSuffix: "_east"
DeliveryGroupSuffix: "_east"
GroupPolicySuffix: "_east"
HostConnectionSuffix: "_east"
MachineCatalogSuffix: "_east"
StoreFrontSuffix: "_east"
TagSuffix: "_east"
West:
SiteRootFolder: "\\\\share.central.net\\AutoConfig\\SiteWest"
AdminScopePrefix: "Western "
AdminRolePrefix: "Western "
ApplicationAdminPrefix: "Western "
ApplicationFolderPrefix: "" # Note that a new parent root folder is used instead
ApplicationFolderRoot: "Western"
ApplicationGroupPrefix: "Western "
ApplicationUserPrefix: "Western "
DeliveryGroupPrefix: "Western "
GroupPolicyPrefix: "Western "
HostConnectionPrefix: "Western "
MachineCatalogPrefix: "Western "
StoreFrontPrefix: "Western "
TagPrefix: "Western "
AdminScopeSuffix: ""
AdminRoleSuffix: ""
ApplicationAdminSuffix: ""
ApplicationFolderSuffix: ""
ApplicationGroupSuffix: ""
ApplicationUserSuffix: ""
DeliveryGroupSuffix: ""
GroupPolicySuffix: ""
HostConnectionSuffix: ""
MachineCatalogSuffix: ""
StoreFrontSuffix: ""
TagSuffix: ""
Si aucune méthode de partage de fichiers central n’est utilisée et que l’importation, la fusion ou l’ajout est effectué à partir de DDC individuels, créez et répliquez le fichier SiteMerging.yml sur chaque DDC en cours de migration vers le cloud. L’emplacement par défaut est %HOMEPATH%\Documents\Citrix\AutoConfig. Vous devez spécifier le paramètre –SiteName pour sélectionner les préfixes de site corrects.
Fusionner les sites
Citrix recommande d’effectuer les opérations cloud par étapes et de procéder à un examen complet de chaque résultat avant d’effectuer la prochaine opération cloud. Par exemple, si vous fusionnez trois sites vers un seul site cloud :
- Fusionnez le site initial sur le cloud à l’aide de la valeur
SiteNameappropriée. - Passez en revue les résultats dans Studio.
- Si les résultats sont incorrects, déterminez le problème et sa cause, corrigez-le, puis relancez la fusion. Si nécessaire, supprimez les composants cloud et commencez à partir de zéro en utilisant
Remove-CvadAcFromSitepour le composant et les membres sélectionnés. Si les résultats sont corrects, continuez. - Si la fusion initiale est correcte, fusionnez le deuxième site sur le site cloud unique.
- Répétez les étapes 2 et 3.
- Si la deuxième fusion est correcte, fusionnez le troisième site sur le site cloud unique.
- Répétez les étapes 2 et 3.
- Examinez les ressources du point de vue de l’utilisateur et vérifiez que la vue est à l’état souhaité.
Supprimer un composant à l’aide du préfixe de site
Vous pouvez supprimer certains composants de site unique à l’aide du préfixe du paramètre –IncludeByName de l’applet de commande Remove-CvadAcFromSite. Dans l’exemple suivant, les groupes de mise à disposition DDC West ne sont pas corrects. Pour supprimer les groupes de mise à disposition uniquement pour le site West :
Remove-CvadAcFromSite –DeliveryGroups –IncludeByName “Western *”
Pour supprimer tous les composants West, exécutez les applets de commande suivantes dans l’ordre indiqué.
Remove-CvadAcFromSite –GroupPolicies –IncludeByName “Western *”
Remove-CvadAcFromSite –Applications –IncludeByName “Western *”
Remove-CvadAcFromSite – ApplicationGroups –IncludeByName “Western *”
Remove-CvadAcFromSite –DeliveryGroups –IncludeByName “Western *”
Remove-CvadAcFromSite –MachineCatalogs –IncludeByName “Western *”
Remove-CvadAcFromSite –HostConnections –IncludeByName “Western *”
Remove-CvadAcFromSite –Tags –IncludeByName “Western *”
Pour supprimer les stratégies de groupe des composants East, utilisez le suffixe :
Remove-CvadAcFromSite –GroupPolicies –IncludeByName “*_east”