PoC Guide: Automated Configuration Tool

Vue d’ensemble

L’outil de configuration automatiséefacilite la migration et l’exportation des configurations versCitrix Desktops-as-a-Service(DaaS). Ce guide de validation de concept illustre les instructions étape par étape sur l’utilisation de cet outil.

Les administrateurs peuvent facilement tester et explorer les fonctionnalités et avantages deCitrix DaaS, tout en exécutant simultanément des environnements locaux existants et même faciliter les déplacements entre les régions cloud, sauvegarder les configurations existantes et d’autres cas d’utilisation. Lelien de téléchargement de la configuration automatiséecontient égalementdes informations supplémentairesetune documentation détailléesur lesditscas d’utilisationetpersonnalisations．

Qu’est-ce que l’outil de configuration automatisée pour Citrix Virtual Apps and Desktops ?

Cet outil est conçu pour aider à automatiser lamigration de la configuration CVAD(stratégies, applications, catalogues, rôles d’administrateur, étendues et autres) d’un ou de plusieurs sites locaux versCitrix DaaShébergé sur Citrix Cloud. Il peut également être utilisé pour migrer des informations entredifférentes régions Cloudoulocataires．

La migration peut être effectuée par étapes en exécutant l’outil plusieurs fois, ce qui permet aux administrateurs d’atteindre facilement l’état de configuration souhaité. Une vidéo de 2 minutes fournit une présentationrapide de l’outil de configuration automatisée:

Pourquoi utiliser cet outil ?

Les administrateurs informatiques chargés d’environnements volumineux ou complexes trouvent souvent les migrations comme un processus fastidieux. Ils finissent souvent par écrire leurs propres outils pour accomplir cette tâche avec succès car elle tend à être spécifique à leurs cas d’utilisation.

Citrix souhaite faciliter ce processus en fournissant un outil qui traite les cas d’utilisation grâce à l’automatisation. Les administrateurs peuvent facilement tester les configurations actuelles dansCitrix Cloudet profiter des avantages offerts parCitrix DaaStout en préservant leurs environnements actuels. Ces avantages incluent une réduction de la surcharge administrative lorsque Citrix gère une partie du plan dorsal et du plan de contrôle, des mises à jour automatiques et personnalisables des composantsCitrix Cloud, etc.

Comment cet outil est-il implémenté ?

Citrix utilise la configuration standard du secteur comme code pour fournir un mécanisme permettant d’automatiser les processus de migration. Cet outil découvre et exporte un ou plusieurs sites locaux sous la formed’un ensemble de fichiers de configuration, que les administrateurs peuvent éventuellement modifier. La configuration de ces fichiers peut ensuite être importée dans Citrix DaaS.

Ce code ne se limite pas aux migrations, il est l’avenir de la création de la configuration pour les sites Citrix et, par conséquent, applicable à denombreux cas d’utilisation différents．La reprise après sinistre, la synchronisation de développement/teste/intermédiaire vers le site de production, les déplacements géographiques (GEO) et plusieurs autres scénarios sont pris en charge. Pour les administrateurs utilisant des fournisseurs de cloud public, cela peut aider à créer automatiquement une combinaison d’objets (parallèlement aux modèles Microsoft Azure ARM et AWS CloudFormation).

L’outil permet également aux administrateurs defusionner plusieurs sites locaux en un seul site, tout en évitant les collisions de noms. Les administrateurs peuvent contrôler si les ressources sur site ou dans le cloud sont contrôlées. Les fichiers peuvent désormais être placésdans un partage de fichiers réseau sécuriséqui nécessite une authentification lors de l’utilisation du paramètreSecurityFileFolderqui pointe versle fichier CvadacSecurity.yml．

Conditions préalables

Environnement local

• Environnement local Citrix Virtual Apps and Desktops (CVAD) avecau moins un VDA enregistré．
• Environnement CVAD On-Premises s’exécutant sur l’une des versions suivantes : n’importe quelle versionLTSR (Long Term Service Release)avec sa dernière CU (7.6, 7.15, 1912, 2203) ; Ou l’une des deux dernièresversions actuelles (CR) correspondantes (par exemple : 2112, 2206)．
• La machine jointe au domaine sur laquelle vous prévoyez d’exécuter lescommandes de l’outil de configuration automatiséedoit exécuter laversion .NET 4.7.2 ou supérieure．
• Machine dotée dukit SDK Citrix PowerShell, qui est automatiquement installé sur le DDC.Remarque :Si vous exécutez l’outil sur une autre machine, il doit être joint au domaine etStudiodoit disposer descomposants logiciels enfichables PowerShell correctsinstallés. Ce programme d’installation se trouve sur lesupport d’installation ISO du produitcorrespondant à vos versions correspondantes, que vous pouvez obtenir sur le site WebCitrix Downloads > Citrix Virtual Apps and Desktops．
• Téléchargez l’outil de configuration automatisée MSI sur le网站officiel des telechargements

Composants liés au cloud

Remarque :Si vous effectuez une migration entre des sites cloud (migration cloud vers le cloud), consultez ladocumentation officiellepour connaître les étapes détaillées.

• LicencesCitrix DaaSouWorkspace Premium Plusvalides.
• L’administrateur doit être en mesure de se connecter auportail Cloudet d’obtenir : lenom de l’emplacement de la ressource, l’ID client,le secret client(ID de l’applicationetclé secrète)
• L’emplacement de ressourceCitrix Cloud existant possède au moinsun Cloud Connector, qui est marqué comme vert (sain) et fait partie du même domaine que la configuration locale.Remarque :Citrix recommande d’avoirdeux ou plusieurs Cloud Connector(pour la redondance et la haute disponibilité). Pour plus d’informations sur la configuration de vos Cloud Connector, consultezce guide．

Ce guide de validation de concept montre comment

1. Remplir les conditions préalables sur site
2. Exportez la configuration de votre site sur site dans des fichiers YAML (．yml)
3. Compléter les conditions préalables du cloud
4. Remplissez les conditions requises pour importer la configuration du site lors de l’utilisation de différentes méthodes de provisionnement (Machine Creation Services (MCS) pour les catalogues groupés et statiques)
5. Importer la configuration de votre site dans le Cloud (en modifiant les fichiers requis)
6. Conseils de dépannage et où trouver plus d’informations

Prérequis complets pour l’exportation à partir d’un site local

Ces étapes doivent être exécutées dans votre DDC ou sur la machine jointe au domaine sur laquelle vous souhaitez exécuter l’outil deconfiguration automatisée．

1. Téléchargez le dernieroutil de configuration automatisée MSIsur votreDDC sur siteou sur une machine associée à un domaine.Remarque :reportez-vous à la sectionPrérequispour plus de détails sur la façon de l’exécuter à partir d’une autre machine. L’outil peut être téléchargéici．Remarque :reportez-vous à la sectionPrérequispour plus de détails sur la façon de l’exécuter à partir d’une autre machine.
2. Exécutez leMSIsur votreDDC local, en cliquant avec le bouton droit sur le programme d’installationAutoConfig_PowerShell_x64.msiet en cliquant surInstaller．
3. Lisez leContrat de licenceet cochez la case si vous acceptez les termes. Cliquez ensuite surInstall:

4. Les fichiers sont copiés et la barre de progression continue de se déplacer jusqu’à ce que l’installation soit terminée.

5. Après l’exécution duMSI, une fenêtre indiquant l’achèvement réussi apparaît. Cliquez surTerminerpour fermer la fenêtre deconfiguration MSI．

• Remarque: Une fois l’exécution réussie, une icône de bureau appeléeAuto Configest créée. Au lancement, la structure de dossiers correspondante située dansC:\Users\\Documents\Citrix\AutoConfig, est créée. Cet outil est celui utilisé lors des étapes suivantes.

Exporter la configuration de votre site local

À l’aide d’une commande PowerShellexport, vous pouvez exporter votre configuration locale existante et obtenir les fichiers．ymlnécessaires. Ces fichiers sont utilisés pour importer la configuration souhaitée dansCitrix Cloud．

1. Après avoir exécuté le programme d’installationMSIà l’étape précédente, vous obtenez un raccourciAuto Configcréé automatiquement sur le Bureau. Cliquez avec le bouton droit sur ce raccourci et cliquez surExécuter en tant qu’administrateur

2. Exécutez la commandeExport-CvadAcToFile．这个对exporte les策略,les catalogues provisionnés manuellement et les groupes de mise à disposition. Il exporte également des applications, des dossiers d’applications, des icônes, des mappages de zones, des balises, des rôles et des étendues d’administration, ainsi que d’autres éléments.Remarque :Pour les catalogues de machines et les groupes de mise à dispositionMCS, reportez-vous à lasection Procédure requise pour l’importation de la configuration du site à l’aide de différentes méthodes de provisionnementde ce guide.

3. Une fois l’outil terminé, l’état généralaffiche lavaleur Trueet le processus d’exportation est terminé (les lignes de sortie affichées correspondent à l’illustration suivante).Remarque :S’il y a des erreurs, des fichiers de diagnostic sont créés dans les sous-dossiers spécifiques à l’action(Export, Import, Merge, Restore, Sync, Backup, Compare), qui se trouvent sous%HOMEPATH%\Documents\Citrix\AutoConfig．Reportez-vous à lasection Conseils de dépannagesi vous rencontrez des erreurs.

4. Les fichiers．ymlrésultants se trouvent désormais dans le cheminDocuments\Citrix\AutoConfigdes utilisateurs actuels :

• Remarque :Voir l’image suivante pour un exemple du contenu d’un fichier．yml(Application.yml)

• Remarque :si nécessaire, copiez les fichiers．ymlsur la machine que vous souhaitez utiliser pour importer des paramètres dans votre environnementCitrix Cloud．L’exportation et l’importation peuvent se faire à partir de la même machine.

Compléter les conditions préalables dans le Cloud

Accédez à votreemplacement des ressourceset assurez-vous que vosCloud Connectorsont tous deux verts (Disponible).Remarque :si vous avez besoin d’instructions sur la façon de configurer vosCloud Connector, consultezce guide．

1. Pour vérifier l’état de santé de vosCloud Connector, connectez-vous d’abord à votreportail cloudavec vos informations d’identification d’administrateur Citrix (ou vos informations d’identification Azure AD, le cas échéant).

2. Si vous disposez de plusieurs ID d’organisation (ID organisation), sélectionnez votre locataire correspondant.

3. Lors de l’ouverture de session, allez dans lemenu hamburger dansle coin supérieur gauche, puis cliquez surEmplacements des ressources:

4. Accédez à la vignetteCloud Connectorsous votreemplacement de ressource．

• Remarque :Leou les Cloud Connectordoivent apparaître en vert, indiquant un état sain, comme indiqué sur l’image suivante. Citrix recommande d’avoir plus d’unCloud Connectorparemplacement de ressource, à des fins de redondance.

Conditions requises pour l’importation de la configuration du site à l’aide de différentes méthodes de provisioning

Traiter les catalogues de machines Provisioning Services (PVS), les groupes et stratégies de mise à disposition et d’applications

Aucune étape supplémentaire n’est requise pour importer voscatalogues PVSet leurs applications correspondantes pour le moment. Suivez les étapes mentionnées dans la sectionImporter la configuration de votre site dans le cloudde ce guide.

Gestion des services de création de machines (MCS) : catalogues de machines VDI multisession (aléatoires) et RDS groupés

Remarque :Une section distincte est disponible avec des instructions pour les machines virtuelles assignées statiques. Reportez-vous aux étapes mentionnées dans la sectionMCS Static Assigned VDIde ce guide.

Les commandes d’importation et d’exportation sont désormais prises en charge pour cette tâche. L’image de référence et la configuration dans Catalogues avecdonnées utilisateur : Discardpeuvent être migrées. Toutefois, les machines virtuelles de ces catalogues ne sont pas migrées, car le site à partir duquel vous importez est responsable de la gestion du cycle de vie de la machine virtuelle.

Lorsque les machines sont mises sous tension, leur état peut changer, ce qui affecte les données d’importation pour la synchronisation des machines virtuelles. Par conséquent, lors de la migration de ces catalogues à l’aide de l’outil, il crée des métadonnées de catalogue et lance la création d’une image principale. Cependant, aucune machine n’est importée.

Considérations importantes :

• Le突起d 'importation du目录MCS可以prendre quelques heures en fonction de la taille de l’image principale. Par conséquent, la commande d’importation de l’outil ne fait que démarrer la création du catalogue MCS et n’attend pas sa fin.
• Une fois l’importation terminée, la progression de la création du catalogue peut être surveillée via Studio dans le déploiement cloud.
• Une fois l’image principale créée, vous pouvez approvisionner des machines. Tenez compte de la capacité existante de votre hyperviseur, étant donné que votre consommation provient de votre utilisation sur site.
• Tous les autres objets (y compris le groupe de mise à disposition, les applications, les stratégies et tout ce qui utilise le catalogue) peuvent être importés, sans avoir à attendre la création de l’image principale. Les mêmes commandes disponibles dans l’outil peuvent être utilisées pour migrer les catalogues et tous les autres objets.
• Lorsque la création du catalogue est terminée, des machines peuvent être ajoutées au catalogue importé, puis les utilisateurs peuvent lancer leurs ressources.

Remarque :Après ces considérations, suivez lasection Importer la configuration de votre site dans le cloudde ce guide pour fusionner votre configuration selon vos besoins.

Traitement des services de création de machines (MCS) : Machines assignées statiques

Remarque :Une section distincte est disponible avec des instructions pour les machines groupées et RDS. Reportez-vous aux étapes mentionnées sur lesmachines VDI et RDS groupées MCS

Les commandes d’importation et d’exportation sont désormais prises en charge pour cette tâche. Ce processus importe certains détails de bas niveau qui sont stockés dans la base de données etdoivent donc être exécutés à partir d’une machine ayant accès à la basede données. Le processus d’importation d’outils migre la configuration, l’image principale et les machines également. C’est une opération rapide puisqu’aucune image n’est créée.

Considérations importantes :

• Les VDAdoiventêtre pointés vers les Cloud Connector pour qu’ils puissent s’enregistrer auprès deCitrix Cloud．
• Reportez-vous à la documentationActivating sitespour activer votre site Cloud et ainsi contrôler le calendrier de redémarrage, la gestion de l’alimentation, etc., viaCitrix Cloud．
• Une fois la migration terminée, si vous souhaitez supprimer le catalogue correspondant de votre sitesur site, vousdevezsélectionner l’option permettant dequitter la machine virtuelle et le compte AD．Sinon, les deux enregistrements seront supprimés et le site Cloud pointera vers la machine virtuelle supprimée.

Remarque :Après ces considérations, suivez lasection Importer la configuration de votre site dans le cloudde ce guide pour fusionner votre configuration selon vos besoins.

Importer la configuration de votre site dans le Cloud

Au cours de cette étape, vous obtenez lesdétails de connexion client, créez manuellement vosmappages de zoneetimportez la configurationvers votre locataire Cloud.Remarque :PourMCS, suivez d’abord les sous-sections correspondantes dans lasection Importer la configuration de votre site dans le cloudde ce guide.

Obtention des détails de connexion client

Les administrateurs doivent modifier le fichierCustomerInfo.ymlet y ajouter les valeursCustomerName,CustomerIDetSecretKeycorrespondantes. Ces valeurs peuvent être obtenues et générées à partir duportail Cloud, comme indiqué dans les étapes suivantes.

1. Tout d’abord, ouvrez votre fichierCustomerInfo.ymlà l’aide d’une application d’éditeur de texte, telle que leBloc-notes．La capture d’écran suivante montre les valeurs deCustomerInfo.ymlfichier qui doivent être modifiées (soulignées en rouge) :

2. Sur votreportail Cloud, cliquez à nouveau sur lemenu hamburgeret accédez àGestion des identités et des accès:

3. Accédez à l’ongletAccès à l’APIet copiez la valeur de l’ID client, qui se trouve à côté du textecustomer ID, comme indiqué sur la capture d’écran suivante (rectangle rouge) :

4. Collez la valeur récupéréeentre les guillemetsqui suivent lechamp CustomerIDde votreCustomerInfo.ymlfichier, entre les“”(guillemets) :

5. De retour sur votreportail Cloud, accédez au portailIdentity and Accesset à l’ongletAPI Access．Entrez le nom que vous souhaitez utiliser pour identifier cette clé API dans la zoneNommez votre client sécurisé．Cliquez ensuite sur le boutonCréer un client．Remarque :Cette action génère leClient IDet leSecret Key．

6. Copiez le les valeursIDetSecretet, une par une (collez-les sur le fichierCustomerInfo.yml像indique l 'etape suivante). Cliquez ensuite surTéléchargerpour enregistrer le fichier pour référence ultérieure.

7. Collez lesSecretvaleursIDet dans les champs correspondants duCustomerInfo.ymlfichier :

Mettre à jour manuellement le fichier de mappage de zones (Zonemapping.yml)

Les区地区ne peuvent pas être migrées automatiquement vers unemplacement de ressources cloud, elles doivent donc être mappées à l’aide du fichierZoneMapping.yml．Remarque :Les échecs de migration se produisent si la zone n’est pas mappée avec un emplacement de ressource homonyme (un emplacement de ressource portantexactement le même nom).

1. De retour dans le même répertoire où résident vos fichiers．yml(Documents\Citrix\AutoConfig), ouvrezZoneMapping.ymlà l’aide duBloc-notesou à l’aide de votre éditeur de texte préféré.Remarque :la valeurPrimarydoit être remplacée par le nom de lazonecorrespondante à partir de laquelle vous souhaitez migrer les objets (dans votre environnement local).

2. Vous pouvez trouver ce nom sous votreconsole Citrix Studio locale > Configuration > Zones．Remarque :si votre zone est nomméePrimarydans votre environnement sur site, il n’est pas nécessaire de modifier cette valeur dans leZoneMapping.ymlfichier :

3. Toujours dans le fichierZoneMapping.yml, la valeurName_Of_Your_Resource_Zonedoit可能remplacee相提并论的nom d’emplacement de ressource Cloud．Cette valeur peut être trouvée sur votreportail cloudsous le menu Hamburger >Resource Locations:

4. Copiez lenom de votre emplacement de ressources(illustréMy Resource Location关于以下这个捕获d 'ecran):

5. Collez cette valeur dans leZoneMapping.ymlfichier au lieu de laName_Of_Your_Resouce_Zonevaleur :

• Remarque :plusieurs zones de votre environnement local peuvent également être mappées àun seul emplacement de ressourcedans le cloud. Cependant, il doit toujours y avoir une ligne dans le fichier pourchaque zonedel’environnement local．Pourplusieurs zones localesetun emplacement de ressource, le format de ce fichier se présente comme suit :

Lors du mappage dezonesà différentsemplacements de ressources, le fichier doit ressembler à ceci :

Mettre à jour manuellement le fichier CvadAcSecurity.yml

Les connexions hôtes等他们hyperviseurs过渡群系peuvent可能migresvers Citrix DaaS. L’ajout desconnexions hôtesnécessite des informations de sécurité pour l’hyperviseur spécifique. Ces informations doivent être ajoutées manuellement dans le fichierCvadAcSecurity.yml．Remarque比如我们Citrix Hypervisor倒cet(中央东部东京)为例,常识．Pour plus d’informations sur les informations de sécurité requises pour les autres types d’hyperviseurs, visitez le site de documentation des produitsCitrix DaaS．

1. De retour dans le même répertoire où résident vos fichiers．yml(Documents\Citrix\AutoConfig), ouvrezCvadAcSecurity.ymlà l’aide duBloc-notesou à l’aide de votre éditeur de texte préféré.

2. Dans le fichierCvadAcSecurity.yml, entrezusernameetpasswordpour la connexion à votre hyperviseur, puisenregistrezle fichier.

Fusionner la configuration

1. De nouveau dans laconsole PowerShell de l’outil de migration, exécutez la commande suivante :Merge-CvadAcToSitepour fusionner la configuration Cloud existante (le cas échéant) avec la configuration exportée à partir du site local.

2. Lorsque chaque tâche s’exécute correctement, la sortie apparaît en vert au fur et à mesure que les fichiers．ymlsont importés et que les composants correspondants sont ajoutés au site cloud :

3. Les fichiers résultants s’affichent dans le répertoire suivant :\Documents\Citrix\AutoConfig\Import_

4. Dans ce même dossier, vous pouvez trouver un dossierBackup_YYYY_MM_DD_HH_mm_ss．Remarque :Copiez ce dossier dans un endroit sûr car il s’agit d’une sauvegarde de la configuration.

5. LeBackupdossier contient les fichiers suivants, qui sont utiles pour annuler les modifications, si nécessaire :

Vérifier la configuration créée dans Cloud Studio

1. Accédez à votre ongletGestionCitrix DaaS via laconsole Cloud>Mes services > Citrix DaaS > onglet Gérer).

2. Actualisez pour vous assurer que lescatalogues de machines, lesgroupes de mise à disposition, lesstratégies, lesbaliseset lesapplicationss’affichent désormais comme prévu.Remarque :en fonction de ce que vous importez, les résultats varient car ils sont spécifiques à votre propre configuration unique. Vérifiezchaque sectionpour vous assurer que les éléments attendus sont répertoriés.

• Exemple de liste des catalogues de machines :

Si tout se passe comme prévu, votre migration Citrix DaaS est terminée.

Conseils de dépannage

Informations générales pour le dépannage :

• Consultez l’article FAQ sur le dépannage de l’outil de configuration automatisée．
• Avant d’ouvrir un ticket d’assistance auprès de Citrix, rassemblez tous les journaux et*.ymlfichiers dans un seul fichier zip en exécutantNew-CvadAcZipInfoForSupport．Aucune information de sécurité client n’est incluse.Transférez le fichier zip à l’emplacement suivant%HOMEPATH%\Documents\Citrix\AutoConfig\CvadAcSupport_yyyy_mm_dd_hh_mm_ss.zipNew-CvadAcZipInfoForSupport．
• L’exécution d’une applet de commande crée unfichier journalet une entrée dans lefichier journal de l’historique maître．Les entrées contiennent la date, l’opération, le résultat, la sauvegarde et les emplacements du fichier journal de l’exécution. Ce journal fournit des solutions potentielles et des correctifs aux erreurs courantes.
• Lejournal historique principalse trouve dans%HOMEPATH%\Documents\Citrix\AutoConfigle fichierHistory.Lognom.* Tous les fichiers journaux des opérations sont placés dans undossier de sauvegarde．
• Tous les noms de fichiers journaux commencent parCitrixLog, puis affichent l’opérationauto-configainsi que ladateet l’horodatagede l’exécution de l’applet de commande.
• Les journauxne sont passupprimés automatiquement.
• La journalisation de la console peut être supprimée à l’aide du-quietparamètre

Informations supplémentaires :

1. Vous pouvez également nous contacter via leforum d’assistance

2. Lisez ladocumentation de l’outil de configuration automatisée

3. Téléchargez les nouvelles versions à partir dulien direct du site Web Downloads

4. Découvrez l’enregistrement de notre webinaire à la demande du 19 août: « Pourquoi la migration vers Citrix Cloud est plus facile que jamais »．Nous avons partagé plus d’informations sur l’outil et avons organiséune session de questions-réponses en directavec un panel d’experts Citrix.

5. Reportez-vous à la sectionMigration vers le cloud deCitrix DaaS pour plus d’informations et pour consulter ladocumentation officielle．

6. Si, après avoir consulté les informations répertoriées précédemment, vous avez toujours besoin d’assistance, contactez vos représentants Citrix, Customer Success Manager ou Support.