Fusionner plusieurs sites en un seul
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.
AdminScope
AdminRole
ApplicationAdmin
ApplicationFolder
ApplicationGroup
ApplicationUser
DeliveryGroup
GroupPolicy
HostConnection
MachineCatalog
StoreFront
Balise
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 supplémentaire de niveau supérieur à la structure de dossiers existante d’une application.
Règles relatives aux préfixes et aux suffixes
- Les préfixes et 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 source
.yml
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 catalogues de machines sont préfixés par « Est », les groupes de mise à disposition qui les référencent sont également préfixés par « Est ».
- 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.
Regrouper les composants 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.
Regrouper les composants 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 de mappage de préfixes et de suffixes
La préfixation du site commence par le fichier SiteMerging.yml
qui contient le mappage de préfixe et de suffixe de site pour un ou plusieurs sites locaux. Vous pouvez gérer le fichier SiteMerging.yml
manuellement ou en utilisant les applets de commande disponibles répertoriées dans la section Fusion de plusieurs applets de commande de sites locaux .
Exporter le site local
La fusion ne peut pas commencer tant que vous n’avez pas exporté un site local. Pour exporter un site local, consultez la section Exporter la configuration locale.
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. Les fichiers SiteMerging.yml
et CustomerInfo.yml
, ainsi que 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. Vous pouvez ainsi effectuer des opérations d’accès au cloud depuis n’importe où.
Il existe deux façons de procéder :
- Partage direct de fichiers : 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
- Référence de partage de fichiers à l’aide de
SiteMerging.yml
: cette méthode utilise le membreSiteRootFolder
de 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ée, effectuez l’importation, la fusion ou l’ajout à partir des Delivery Controller individuels. Créez et répliquez le fichier SiteMerging.yml
sur chaque Delivery Controller à faire migrer 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 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 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
<!--NeedCopy-->
Depuis le Delivery Controller Ouest :
mkdir \\share.central.net\AutoConfig\SiteWest
Export-CvadAcToFile –TargetFolder \\share.central.net\AutoConfig\SiteWest`
<!--NeedCopy-->
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
SiteRootFolder
pour créer le fichier SitePrefixes.yml lors de l’utilisation de 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 :
- L’un des Delivery Controller locaux sur lequel 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 Delivery Controller, 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 Delivery Controller Est avec le cloud :
Merge-CvadAcToSite –SiteName East –SourceFolder \\share.central.net\AutoConfig\SiteEast -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml
<!--NeedCopy-->
Pour fusionner le Delivery Controller Ouest avec le cloud :
Merge-CvadAcToSite –SiteName West –SourceFolder \\share.central.net\AutoConfig\SiteWest -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml
<!--NeedCopy-->
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: ""
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 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 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
<!--NeedCopy-->
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 Delivery Controller Est :
mkdir \\share.central.net\AutoConfig\SiteEast
Export-CvadAcToFile -SiteName East -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml
<!--NeedCopy-->
Depuis le Delivery Controller Ouest :
mkdir \\share.central.net\AutoConfig\SiteWest
Export-CvadAcToFile -SiteName West -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml
<!--NeedCopy-->
L’applet de commande d’exportation utilise l’emplacement du dossier CustomerInfo.yml pour localiser le fichier SiteMerging.yml. Dans le cas du dossier Est, SiteRootFolder
est entièrement qualifié. Elle est utilisée telle quelle. Dans le cas du dossier Ouest, le SiteRootFolder
n’est pas entièrement qualifié. 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 Delivery Controller Est avec le cloud :
Merge-CvadAcToSite –SiteName East -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml
<!--NeedCopy-->
Pour fusionner le Delivery Controller Ouest avec le cloud :
Merge-CvadAcToSite –SiteName West -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml
<!--NeedCopy-->
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: ""
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 avec le cloud en utilisant la valeur
SiteName
approprié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-CvadAcFromSite
pour 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 effectuer une suppression sélective de composants de site uniques en utilisant le préfixe du paramètre –IncludeByName
de l’applet de commande Remove-CvadAcFromSite
. Dans l’exemple suivant, les groupes de mise à disposition Delivery Controller Ouest sont incorrects. Pour supprimer les groupes de mise à disposition uniquement pour le site West :
Remove-CvadAcFromSite –DeliveryGroups –IncludeByName “Western *”
<!--NeedCopy-->
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”
<!--NeedCopy-->