Fusion de plusieurs sites en un seul site
La prise en charge multisite pour la configuration automatisée offre une méthode pour fusionner plusieurs sites sur site en un seul site cloud.
La prise en charge multisite ajoute des préfixes et des suffixes uniques aux noms des composants, par site sur site, garantissant l’unicité des noms après la fusion de plusieurs sites sur site en un seul site cloud.
Des préfixes et des suffixes peuvent être attribués pour chacun des composants suivants, par site sur site.
AdminScopeAdminRoleApplicationAdminApplicationFolderApplicationGroupApplicationUserDeliveryGroupGroupPolicyHostConnectionMachineCatalogStoreFront™Tag
Les dossiers d’applications prennent en charge le préfixage, le suffixage et le réenracinement. Le réenracinement ajoute un dossier de niveau supérieur supplémentaire à la structure de dossiers existante d’une application.
Règles de préfixage et de suffixage
- Les préfixes et les suffixes ne peuvent pas contenir les 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 doubles pour 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
.ymlsource ne sont jamais modifiés. - Le processus de préfixage et de suffixage préfixe ou suffixe automatiquement les noms des composants dépendants, le cas échéant. Par exemple, si les noms des catalogues 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 en combinaison.
- L’utilisation d’un préfixe ou d’un suffixe sur un composant est facultative.
Remarque :
Studio affiche les composants par ordre alphabétique.
Regrouper les composants par site
Utilisez le préfixage pour regrouper visuellement les composants d’un même site. Chaque site est répertorié dans son propre groupe, le préfixage contrôlant alphabétiquement l’ordre des différents groupes de sites.
Regrouper les composants par nom
Utilisez le suffixage pour regrouper visuellement les composants de noms similaires provenant de plusieurs sites. Les composants de noms similaires provenant de différents sites alternent visuellement.
Fichier de mappage des préfixes et suffixes
Le préfixage de site commence par le fichier SiteMerging.yml qui contient le mappage des préfixes et suffixes de site pour un ou plusieurs sites sur site. Vous pouvez gérer le fichier SiteMerging.yml manuellement ou en utilisant les cmdlets disponibles répertoriées dans la section Cmdlets de fusion de plusieurs sites sur site.
Exporter un site sur site
La fusion ne peut pas commencer tant que vous n’avez pas exporté un site sur site. Pour exporter un site sur site, consultez Exporter la configuration sur site.
Dossier cible d’exportation centralisé
Les méthodes décrites dans cette section placent plusieurs exportations de sites dans un emplacement de partage de fichiers centralisé. 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 seul emplacement, indépendamment des sites sur site.
Les opérations d’accès au cloud ne référencent jamais les sites sur site ou Active Directory, ce qui vous permet d’effectuer des opérations d’accès au cloud depuis n’importe où.
Partage de fichiers direct
Il existe deux méthodes pour ce faire :
- Partage de fichiers direct : Pour importer, fusionner ou ajouter à partir du partage de fichiers direct, vous devez décider à partir de quelle machine vous souhaitez effectuer l’opération d’accès au cloud.
-
Référence de partage de fichiers à l’aide de SiteMerging.yml : Cette méthode utilise le membre
SiteRootFolderde l’ensemble de préfixes du site et réduit les risques de cibler le mauvais dossier lors de l’exportation, de l’importation, de la fusion ou de l’ajout.
Si vous n’utilisez pas de méthode de partage de fichiers centralisé, effectuez l’importation, la fusion ou l’ajout à partir des Delivery Controllers individuels. Créez et répliquez le fichier SiteMerging.yml sur chaque Delivery Controller migré 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.
Partage de fichiers direct
Les opérations d’exportation, d’importation, de fusion et de création/ajout fournissent un paramètre pour cibler ou sourcer un dossier autre que le dossier par défaut, %HOMEPATH%\Documents\Citrix\AutoConfig. Les exemples suivants utilisent un partage de fichiers centralisé situé à \\share.central.net auquel l’administrateur a déjà accès, après avoir fourni les informations d’identification nécessaires.
Pour cibler l’exportation vers un dossier spécifique au site, utilisez le paramètre –TargetFolder :
Depuis le Delivery Controller™ Est ::
mkdir \\share.central.net\AutoConfig\SiteEast
Export-CvadAcToFile –TargetFolder \\share.central.net\AutoConfig\SiteEast
Depuis le Delivery Controller Ouest ::
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 du fichierSitePrefixes.ymllorsque 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 à partir de quelle machine vous souhaitez effectuer l’opération d’accès au cloud. Les options incluent :
- L’un des Delivery Controllers sur site où l’outil est déjà installé.
- La machine hébergeant le partage de fichiers.
- Une machine différente.
La configuration automatisée doit être installée sur la machine accédant au cloud. Ni le SDK PowerShell sur site, ni les Delivery Controllers, ni Active Directory ne sont utilisés, de sorte que les exigences d’exécution de l’accès au cloud sont plus simples que les exigences d’exportation.
Pour fusionner les Delivery Controllers Est vers le cloud :
Merge-CvadAcToSite –SiteName East –SourceFolder \\share.central.net\AutoConfig\SiteEast -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml
Pour fusionner les Delivery Controllers Ouest vers 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 utilisé dans 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: ""
<!--NeedCopy-->
Référence de partage de fichiers à l’aide de SiteMerging.yml
Cette méthode utilise le membre SiteRootFolder de l’ensemble de préfixes du site. Bien que plus complexe que la méthode de partage de fichiers directe, cette méthode réduit les risques 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 effectuer cette opération à 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 entièrement qualifiée et West est une spécification de dossier relative.
Pour cibler l’exportation vers un dossier spécifique au site à l’aide du fichier SiteMerging.yml :
Depuis le Delivery Controller East :
mkdir \\share.central.net\AutoConfig\SiteEast
Export-CvadAcToFile -SiteName East -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml
Depuis le Delivery Controller 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 d’East, le SiteRootFolder est entièrement qualifié. Il est utilisé tel quel. Dans le cas de West, le SiteRootFolder n’est pas entièrement qualifié. Il est combiné avec l’emplacement du dossier CustomerInfo.yml pour récupérer un emplacement de dossier entièrement qualifié pour West.
Pour fusionner le Delivery Controller East avec le cloud :
Merge-CvadAcToSite –SiteName East -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml
Pour fusionner le Delivery Controller West avec le cloud :
Merge-CvadAcToSite –SiteName West -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml
Voici un exemple de fichier SitePrefixes.yml utilisé dans 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: ""
<!--NeedCopy-->
Si une méthode de partage de fichiers centralisée n’est pas utilisée et que l’importation, la fusion ou l’ajout est effectué à partir des Delivery Controllers individuels, créez et répliquez le fichier SiteMerging.yml sur chaque Delivery Controller migré 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 de passer à l’opération cloud suivante. Par exemple, si vous fusionnez trois sites en un seul site cloud :
- Fusionnez le site initial avec le cloud en utilisant la valeur
SiteNameappropriée. - Examinez 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 recommencez à 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 avec le site cloud unique.
- Répétez les étapes 2 et 3.
- Si la deuxième fusion est correcte, fusionnez le troisième site avec 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 dans l’état souhaité.
Supprimer un composant à l’aide du préfixe du site
Vous pouvez supprimer sélectivement des composants de site individuels en utilisant le préfixe sur le paramètre –IncludeByName de l’applet de commande Remove-CvadAcFromSite. Dans l’exemple suivant, les groupes de mise à disposition du Delivery Controller 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.
-
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”