Guide PoC : Outil de configuration automatique - Migration sur site vers local

Vue d’ensemble

L’outil de configuration automatique facilite la migration et l’exportation de configurations vers Citrix DaaS. Toutefois, les configurations de site Citrix Virtual Apps and Desktops peuvent également être migrées et exportées d’un environnement local vers un autre à l’aide de l’ACT local. Ce guide POC vous guide pour migrer un site Citrix Virtual Apps and Desktops local vers un autre site local Citrix Virtual Apps and Desktops à l’aide de l’outil de configuration automatique Citrix. Envisagez de déplacer des configurations DEV/UAT testées et validées vers la production en tant que cas d’utilisation potentiel pour la migration de l’outil de configuration automatique sur site vers local.

Déploiement source :

Déploiement source

Déploiement cible :

Déploiement cible

Configuration avec source et cible :

Source et cible

Remarque :

Web Studio doit être installé sur le site cible, nécessitant au minimum la version actuelle 2212 de Citrix Virtual Apps and Desktops. Web Studio est nécessaire pour utiliser les API d’orchestration localement sur le DDC.

Conditions préalables

Environnement local

  • Environnement local Citrix Virtual Apps and Desktops avec au moins un VDA enregistré.
  • Source : environnement local Citrix Virtual Apps and Desktops s’exécutant sur l’une des versions suivantes :
    • Toutes les versions de Long Term Service Release (LTSR) avec leur dernière CU (1912, 2203)
    • Ou l’une des deux dernières versions actuelles (CR) correspondantes (par exemple, 2112, 2206).
  • Destination : environnement local Citrix Virtual Apps and Desktops exécutant au minimum les dernières versions actuelles (CR) version 2212.
  • La machine jointe au domaine sur laquelle vous prévoyez d’exécuter les commandes de l’outil de configuration automatisée doit exécuter une version .NET 4.7.2 ou supérieure.
  • Une machine dotée du SDK Citrix PowerShell, qui s’installe automatiquement sur le DDC.

Remarque

Si vous exécutez l’outil sur une autre machine, il doit être joint au domaine et Studio nécessite l’installation des composants logiciels enfichables PowerShell appropriés. Le programme d’installation se trouve sur le support d’installation ISO du produitcorrespondant à vos versions, obtenu sur le site Web de téléchargement de Citrix Virtual Apps and Desktops .

  • Téléchargez l’outil de configuration automatique MSI ici.

Ce guide de validation de concept montre comment

  1. Déployez un nouveau Delivery Controller.
  2. Configurez le nouveau Delivery Controller.
  3. Exportez la configuration depuis le DDC source.
  4. Préparez l’importation.
  5. Importez la configuration sur le DDC cible.

Déployer un nouveau Delivery Controller

Pour ce guide POC, le nouveau serveur s’appelle UAT-DDC-01.

Remarque :

Le nouveau serveur Delivery Controller nécessite au moins 5 Go de mémoire.

  1. Utilisez un serveur joint au domaine Windows Server récemment déployé.
  2. Téléchargez Citrix Virtual Apps and Desktops 2212 ou version ultérieure .
  3. Montez le fichier ISO.
  4. Exécutez AutoSelect en tant qu’administrateur.

    Déploiement du DDC

  5. Cliquez sur Démarrer.

    Déploiement du DDC

  6. Cliquez sur Delivery Controller.

    Déploiement du DDC

  7. Acceptez la licence et cliquez sur Suivant.

    Déploiement du DDC

  8. Effacez le serveur de licences et cliquez sur Suivant.

    Déploiement du DDC

  9. Cliquez sur Suivant.

    Déploiement du DDC

  10. Désélectionnez Installer Microsoft SQL Server 2019 Express CU15 pour utiliser votre serveur de base de données actuel et cliquez sur Suivant.

    Déploiement du DDC

  11. Cliquez sur Suivant.

    Déploiement du DDC

  12. Cliquez sur Installer.

    Déploiement du DDC

  13. Cliquez sur Connecter ou décochez la case et cliquez sur Suivant.

    Déploiement du DDC

  14. Cliquez sur Finish.

    Déploiement du DDC

Configurer le nouveau Delivery Controller

Configuration initiale

  1. Cliquez sur Fournir des applications et des postes de travail à vos utilisateurs.

    Déploiement d'un nouveau DDC

  2. Indiquez un nom de site et cliquez sur Suivant.

    Déploiement d'un nouveau DDC

  3. Fournissez les informations de base de données et cliquez sur Suivant.

    Déploiement d'un nouveau DDC

  4. Indiquez le nom de votre serveur de licences Citrix et cliquez sur Connect.

    Déploiement d'un nouveau DDC

  5. Sélectionnez Me connecter et cliquez sur Confirmer.

    Déploiement d'un nouveau DDC

  6. Cliquez sur Suivant.

    Déploiement d'un nouveau DDC

  7. Cliquez sur Finish.

    Déploiement d'un nouveau DDC

Se connecter à Web Studio

Parcourez le site Web Studio à l’adresse https://<servername>/Citrix/WebStudio.

  1. Connectez-vous à Web Studio depuis le menu Démarrer et sélectionnez Citrix Web Studio.

    Studio Web

  2. Fournissez les informations d’identification et cliquez sur Se connecter.

    Studio Web

  3. Au premier lancement, la console est vide

Exporter la configuration depuis le DDC source

  1. Connectez-vous au Source Delivery Controller.
  2. Téléchargez la dernière version de l’outil de configuration automatique Citrix ici
  3. Installez AutoConfig_Powershell_x64.msi.
  4. Ouvrez Auto Config à partir de l’icône sur votre bureau.
  5. Exécutez Export-CvadAcToFile.

    Export-CvadAcToFile

Préparer l’importation

  1. Connectez-vous au Destination Delivery Controller.
  2. Téléchargez la dernière version de l’outil de configuration automatique Citrix ici
  3. Installez AutoConfig_Powershell_x64.msi.
  4. Ouvrez Auto Config à partir de l’icône sur votre bureau (cela crée le dossier Citrix sous C:\Users%username%\Documents).
  5. Copiez le dossier C:\Users%username%\Documents\Citrix sur le Delivery Controller source et collez-le dans C:\Users%username%\Documents\Citrix sur le serveur de destination. Acceptez l’option de fusion.

    ACT

  6. Modifiez CvadAcSecurity.yml à l’aide du bloc-notes.

    ACT

  7. Entrez le mot de passe d’hyperviseur correct et enregistrez le fichier.

    ACT

  8. Modifiez CustomerInfo.yml à l’aide du bloc-notes.

    ACT

  9. Mettez à jour l’environnement de Production vers OnPrem et enregistrez le fichier.

    ACT

Importer la configuration sur le DDC cible

  1. Connectez-vous au Destination Delivery Controller.
  2. Ouvrez Auto Config à partir de l’icône sur votre bureau.
  3. Exécutez Import-CvadAcToSite.

    Import

  4. Entrez Oui pour confirmer et poursuivre l’importation.

    Import

  5. La connexion d’hébergement est créée en premier.

    Import

  6. Ensuite, les catalogues de machines sont créés.

    Import

  7. Les groupes de mise à disposition sont ensuite créés.

    Import

  8. Ensuite, les applications.

    Import

  9. Enfin, les stratégies sont créées.

    Import

Remarque :

Vous pouvez également exécuter Merge-CvadAcToSite pour vous assurer que les configurations existantes ne seront pas remplacées. Vous pouvez éventuellement migrer un composant à la fois en exécutant Merge-CvadAcToSite -Tags, suivi de Merge-CvadAcToSite -MachineCatalogs, etc. Cliquez ici pour plus d’informations sur la migration granulaire.

Validation

Création de ressources

Tout d’abord, vérifiez que les ressources ont été créées sur le Destination Delivery Controller.

  1. Sur Destination Delivery Controller, connectez-vous à Web Studio.

    Studio Web

  2. Cliquez sur Catalogues de machines pour valider vos catalogues de machines.

    Studio Web

    Nous pouvons voir ici que des VDA PVS et statiques sont présents et que le catalogue de machines MCS est toujours en cours d’exécution (les métadonnées de l’image principale ont été copiées)

  3. Cliquez sur Groupes de mise à disposition pour valider vos groupes de miseà disposition.

    Studio Web

    Ici, nous pouvons voir que les groupes de mise à disposition ont été créés et que des PVS et des VDA statiques ont été ajoutés. Toutefois, les groupes de mise à disposition sont en mode maintenance.

  4. Cliquez sur Applications et assurez-vous de voir toutes vos applications (et tout dossier d’applications que vous avez configuré).

    Studio Web

  5. Cliquez sur Stratégies et assurez-vous de voir toutes vos stratégies.

    Studio Web

  6. Cliquez sur Catalogue de machines. Attendez que le processus de création de la copie principale soit terminé.

Création d’un VDA

Tous les VDA doivent être créés manuellement pour le catalogue de machines MCS. Nous ajoutons un VDA MCS Windows 10 et un VDA MCS Windows Server 2022 pour valider. VDA

Inscription VDA

Maintenant que nous avons créé nos VDA MCS, nous pouvons utiliser PVS et Static sans avoir à les recréer.

  1. Désactivez le mode de maintenance sur le groupe de mise à disposition.
  2. Redémarrez tous vos VDA.
  3. Vérifiez l’état de l’enregistrement.

    Inscription VDA

  4. Tous les VDA Windows 10 MCS sont enregistrés. Ils se sont enregistrés parce qu’ils ont été installés avec le VDA sélectionné pour laisser le service de création de machines le faire pour l’enregistrement.

  5. Tous les VDA doivent s’enregistrer auprès du nouveau Delivery Controller pour pouvoir tout tester. Dans notre cas, nous avons créé une unité d’organisation dans Active Directory pour placer le nouveau MCS, le PVS actuel et Static et créer un GPO pour modifier l’enregistrement.

    Inscription VDA

    Inscription VDA

  6. Déplacez les VDA que vous souhaitez tester vers l’unité d’organisation où le GPO est appliqué.
  7. Redémarrez les VDA et vérifiez l’état de l’enregistrement.
  8. Les VDA déplacés vers la bonne unité d’organisation avec GPO appliqué sont désormais enregistrés.

    Inscription VDA

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 *.yml fichiers dans un seul fichier zip en exécutant New-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 un fichier journal et une entrée dans le fichier 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.
  • Le journal d’historique principal se trouve dans %HOMEPATH%\Documents\Citrix\AutoConfigle fichier nommé History.Log.* Tous les fichiers du journal des opérations sont placés dans un dossier de sauvegarde.
  • Tous les noms de fichiers journaux commencent par CitrixLog, puis affichent l’opération auto-config ainsi que la date et l’ horodatage de l’exécution de l’applet de commande.
  • Les journaux ne sont pas supprimés automatiquement.
  • La journalisation de la console peut être supprimée à l’aide du -quiet paramètre

Informations supplémentaires :

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

  2. Lisez la documentation de l’outil de configuration automatisée

  3. Téléchargez les nouvelles versions à partir du lien 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 direct avec un panel d’experts Citrix.

  5. Reportez-vous à la section Migration vers le cloud de Citrix DaaS pour plus d’informations et pour consulter la documentation 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.

Guide PoC : Outil de configuration automatique - Migration sur site vers local