Dépannage de la configuration automatisée et informations supplémentaires
Important :
Pour les messages d’erreur courants liés à la configuration automatisée et les solutions correspondantes, consultez la FAQ de dépannage dans l’article du centre de connaissances CTX277730.
Erreurs de l’outil de configuration automatisée
Les opérations de l’outil de configuration automatisée peuvent parfois générer des erreurs. Dans ce cas, des échecs peuvent se produire lors du traitement de composants tels que les catalogues de machines, les groupes de mise à disposition ou les stratégies de groupe, par exemple. L’utilisation des paramètres OnErrorAction et de continuation vous permet d’intercepter les erreurs en cours de traitement, de les résoudre et de reprendre là où vous vous étiez arrêté.
La valeur par défaut de OnErrorAction est StopCompEnd. Lorsqu’une erreur se produit, l’outil termine le traitement du composant actuel. Aucun composant supplémentaire n’est traité et les erreurs ne sont pas reportées aux composants dépendants en aval. Après avoir résolu les erreurs, vous pouvez réexécuter vos cmdlets avec n’importe quel paramètre de continuation appliqué.
Paramètre OnErrorAction
Vous pouvez définir les valeurs du paramètre OnErrorAction sur les commandes de migration pour contrôler la façon dont l’outil réagit aux erreurs qu’il rencontre lors du traitement des composants.
Ce tableau présente les valeurs des paramètres et leurs descriptions :
| Valeur | Description |
| — | — |
| Continue | Tente de traiter autant de composants que possible. |
| Pause | Met en pause à la fin du traitement et vous invite à continuer ou à arrêter. |
| StopCompEnd | Tente de traiter le composant autant que possible. S’arrête une fois le composant terminé. (Par défaut) |
| StopImmediately | Le traitement s’arrête lorsqu’une erreur est détectée. |
Cmdlets de migration
Vous pouvez appliquer le paramètre OnErrorAction aux commandes de migration suivantes :
Compare-CvadAcToSiteImport-CvadAcToSiteMerge-CvadAcToSiteNew-CvadAcToSiteRestore-CvadAcToSite
Exemple : Merge-CvadAcToSite -OnErrorAction StopImmediately
Paramètres de reprise
Ces paramètres définissent la manière dont l’outil reprend après qu’une opération a été mise en pause ou arrêtée en raison d’une erreur.
Vous pouvez appliquer des paramètres de reprise aux cmdlets de migration qui incluent l’une des valeurs de paramètre OnErrorAction suivantes :
PauseStopCompEndStopImmediately
Ce tableau présente les valeurs des paramètres et leurs descriptions :
| Valeur | Description |
|---|---|
-AllRemaining |
Nécessite un composant de départ. Le traitement commence au composant de départ et traite tous les composants restants. Plusieurs composants sont traités. |
-Resume |
Utilise le composant de CurrentComponent.txt comme point de départ. Tous les composants restants sont définis sur true. Plusieurs composants sont traités. |
-Repeat |
Utilise le composant de CurrentComponent.txt comme point de départ. Tous les composants restants sont définis sur false. Un seul composant est traité. |
Le dernier composant traité est stocké dans le fichier CurrentComponent.txt du dossier AutoConfig. Il n’est pas recommandé de modifier ce fichier.
Si vous spécifiez -Resume ou -Repeat, et que CurrentComponent.txt est manquant ou non valide, le traitement s’arrête et vous êtes invité à sélectionner un composant.
Définition de OnErrorAction dans le fichier CustomerInfo.yml
Vous pouvez également définir les valeurs OnErrorAction dans le fichier CustomerInfo.yml. Définissez les valeurs à l’aide des cmdlets suivantes :
- Pour un nouveau fichier :
New-CvadAcCustomerInfoFile -OnErrorAction Continue | Pause | StopCompEnd | StopImmediately - Pour un fichier existant :
Set-CvadAcCustomerInfoFile -OnErrorAction Continue | Pause | StopCompEnd | StopImmediately
Journaux
L’exécution de toute cmdlet entraîne la création d’un fichier journal et d’une entrée dans le fichier journal d’historique principal. Tous les fichiers journaux d’opération sont placés dans un dossier de sauvegarde. Tous les noms de fichiers journaux commencent par CitrixLog, puis affichent l’opération de configuration automatique et la date et l’heure d’exécution de la cmdlet. Les journaux ne sont pas supprimés automatiquement.
Le journal d’historique principal se trouve dans *%HOMEPATH%\Documents\Citrix\AutoConfig*, dans le fichier nommé History.Log. Chaque exécution de cmdlet entraîne une entrée de journal principal contenant la date, l’opération, le résultat, la sauvegarde et les emplacements des fichiers journaux de l’exécution.
Vous pouvez également utiliser la cmdlet New-CvadAcZipInfoForSupport pour collecter les journaux à envoyer à Citrix pour le support. Cette cmdlet compresse tous les fichiers journaux et .yml dans un seul fichier zip. Les informations sensibles du client (CustomerInfo.yml et CvadAcSecurity.yml) ne sont pas incluses dans le fichier zip. Le fichier Icon.yml est également exclu en raison de sa taille. Le fichier zip est placé dans %HOMEPATH%\Documents\Citrix\AutoConfig et nommé CvadAcSupport_aaaa_mm_jj_hh_mm_ss.zip, en fonction de la date et de l’heure. Ce fichier zip peut également servir de sauvegarde.
Chaque fichier journal comprend les éléments suivants :
- Le nom de l’opération et si le mode de vérification est activé
- La date et l’heure de début et de fin
- Plusieurs entrées pour les actions de chaque composant et les notifications de succès/échec
- Résumé des actions entreprises, y compris divers décomptes d’objets créés
- Corrections suggérées le cas échéant
- Emplacement du dossier de sauvegarde le cas échéant
- Emplacement du journal principal
- Durée
Fichiers de diagnostic
Les fichiers de diagnostic vous aident à déterminer et à résoudre les problèmes. Les fichiers suivants sont créés lorsque leur opération est exécutée. Ils se trouvent dans le sous-dossier spécifique à l’action sous %HOMEPATH%\Documents\Citrix\AutoConfig. Incluez ces fichiers lorsque vous fournissez des informations pour le support de résolution de problèmes.
Exportation
PoshSdk_aaaa_mm_jj_hh_mm_ss.ps1
Ce fichier compte tous les appels PowerShell SDK Broker effectués pour exporter la configuration du site vers des fichiers.
Importation, fusion, restauration, synchronisation, sauvegarde, comparaison
Transaction_aaaa_mm_jj_hh_mm_ss.txt
Ce fichier documente chaque appel d’API Rest et les informations associées.
RestApiContent_aaaa_mm_jj_hh_mm_ss.txt
Ce fichier contient tout le contenu de l’API Rest Add, Update et Delete.
Problèmes résultant de dépendances
Les importations et les fusions peuvent échouer en raison de dépendances manquantes. Voici quelques problèmes courants :
- Les stratégies de groupe ne contiennent pas de filtres de groupe de mise à disposition. Les causes habituelles sont des groupes de mise à disposition qui n’ont pas été importés.
- Les applications ne parviennent pas à être importées ou fusionnées. La cause habituelle est l’absence de groupes de mise à disposition ou de groupes d’applications qui n’ont pas été importés.
- Les groupes d’applications ne contiennent pas de RestrictToTag. Les causes habituelles sont des balises qui n’ont pas été importées.
- Les connexions d’hôte échouent. La cause habituelle est l’absence d’informations de sécurité dans le fichier CvadAcSecurity.yml.
- Les catalogues de machines échouent. La cause habituelle est des connexions d’hôte qui n’ont pas été importées.
- Machines manquantes dans les catalogues de machines et les groupes de mise à disposition. La cause habituelle est des machines qui n’ont pas été trouvées dans Active Directory.
- Utilisateurs manquants dans les groupes de mise à disposition. La cause habituelle est des utilisateurs qui n’ont pas été trouvés dans Active Directory.
Recommandations
- N’exécutez pas plus d’une instance de configuration automatisée à la fois. L’exécution de plusieurs instances concurrentes produit des résultats imprévisibles dans le site cloud. Si cela se produit, réexécutez une instance de configuration automatisée pour ramener le site à l’état attendu.
- Ne travaillez pas et ne modifiez pas les données dans Studio pendant l’exécution de la configuration automatisée.
- Vérifiez toujours visuellement les résultats de la fusion, de l’importation ou de la restauration dans Studio pour vous assurer que le site cloud répond aux attentes.
Dossiers
Emplacement racine du dossier par défaut
Toutes les opérations de l’outil de configuration automatisée se produisent dans le dossier racine ou dans des sous-dossiers à l’intérieur de celui-ci. Le dossier racine se trouve dans %HOMEPATH%\Documents\Citrix\AutoConfig.
Exportation
Tous les fichiers exportés sont placés à deux emplacements de dossier, offrant une facilité d’utilisation et un historique des exportations. Les exportations sont toujours placées dans le dossier racine. Des copies sont placées dans un sous-dossier nommé Export avec la date et l’heure de l’exportation.
Le dossier racine contient toujours la configuration du site sur site la plus récemment exportée. Chaque sous-dossier Export contient l’exportation effectuée à la date et à l’heure indiquées, ce qui maintient un historique des exportations. Vous pouvez utiliser n’importe quel sous-dossier Export pour configurer le site cloud. La configuration automatisée ne supprime ni ne modifie les sous-dossiers d’exportation existants.
Importation/Fusion/Synchronisation/Comparaison
Les opérations d’Importation, de Fusion et de Comparaison proviennent toujours de fichiers situés dans le dossier racine. Chaque opération entraîne la création d’un sous-dossier vers lequel les fichiers du dossier racine sont copiés, fournissant un historique des fichiers source modifiant le site cloud.
Restauration
L’opération de Restauration utilise un sous-dossier existant pour configurer le site cloud. Le dossier source est spécifié via le paramètre obligatoire -RestoreFolder. Contrairement aux autres commandes, aucun nouveau sous-dossier n’est créé car l’opération de Restauration utilise un sous-dossier existant. Le dossier de restauration peut être le dossier racine, mais il doit toujours être spécifié via le paramètre -RestoreFolder.
Sauvegardes
La configuration automatisée initialise, met à jour et sauvegarde une configuration de site cloud. Au fil du temps, de nombreuses configurations différentes peuvent changer sur le site cloud. Pour faciliter l’utilisation à long terme et préserver l’historique des modifications, la configuration automatisée utilise un schéma de préservation pour enregistrer cet historique des modifications et fournir une méthode de restauration des états antérieurs.
Les sauvegardes de configuration du site cloud sont toujours effectuées dans un sous-dossier nommé Backup avec la date et l’heure de la sauvegarde. La configuration automatisée ne supprime ni ne modifie les sous-dossiers d’exportation existants.
Vous pouvez utiliser les sauvegardes pour restaurer des composants spécifiques ou l’intégralité de votre configuration. Pour restaurer l’intégralité du groupe de mise à disposition et des composants du catalogue de machines, utilisez l’applet de commande :
Restore-CvadAcToSite -RestoreFolder %HOMEPATH%\Documents\Citrix\AutoConfig/Backup_yyyy_mm_dd_hh_mm_ss -DeliveryGroups -MachineCatalogs
Remarque :
Les informations du fichier de sauvegarde dans l’applet de commande précédente sont basées sur vos propres sauvegardes.
Pour restaurer l’intégralité de la configuration du site cloud, utilisez l’applet de commande :
Restore-CvadAcToSite -RestoreFolder %HOMEPATH%\Documents\Citrix\AutoConfig/Backup_yyyy_mm_dd_hh_mm_ss
Remarque :
Les informations du fichier de sauvegarde dans l’applet de commande précédente sont basées sur vos propres sauvegardes.
Modification du dossier racine par défaut
Les opérations d’Exportation, d’Importation, de Fusion, de Synchronisation et de Comparaison peuvent modifier le dossier racine par défaut en utilisant le paramètre –AlternateFolder. La création et la gestion des sous-dossiers par opération restent les mêmes que celles décrites précédemment.
Fichiers copiés dans des sous-dossiers
Tous les fichiers ayant une extension « .yml » sont copiés dans les sous-dossiers d’opération, à l’exception des suivants :
- CustomerInfo.yml
- ZoneMapping.yml
- CvadAcSecurity.yml
Sauvegardes automatiques de sécurité du site cloud
Une sauvegarde de la configuration actuelle du site cloud est effectuée avant d’exécuter des opérations qui modifient la configuration. Cela inclut les paramètres Import, Merge, Sync et Restore. La sauvegarde se trouve toujours dans un sous-dossier sous le sous-dossier opérationnel.
Dans le cas de Restore, le dossier de sauvegarde est un sous-dossier du dossier spécifié par le paramètre -RestoreFolder.
Automatisation
Les applets de commande de l’outil de configuration automatisée peuvent être exécutées dans des scripts d’automatisation sans intervention de l’administrateur en supprimant les invites et l’affichage des résultats du journal à la fin de l’exécution de l’applet de commande. Vous pouvez également définir des paramètres pour faire de même en utilisant le fichier CustomerInfo.yml.
Ajoutez le paramètre suivant aux applets de commande de modification du cloud pour supprimer l’affichage des invites.
-Confirm $false
Ajoutez le paramètre suivant aux applets de commande pour supprimer l’affichage du journal à la fin de l’exécution de l’applet de commande.
-DisplayLog $false
Ajoutez le paramètre suivant aux applets de commande pour supprimer la journalisation dans la fenêtre de commande PowerShell.
-Quiet
Autre méthode, les paramètres suivants peuvent être placés dans le fichier CustomerInfo.yml.
Confirm: False
DisplayLog: False
Exportation depuis des PC autres que le Delivery Controller™
L’outil de configuration automatisée utilise plusieurs SDK PowerShell Citrix pour exporter la configuration du site sur site vers des fichiers. Ces SDK sont automatiquement installés sur le Delivery Controller, ce qui permet à l’outil de s’exécuter sur le Delivery Controller sans actions supplémentaires. Lors de l’exécution sur des machines non-Delivery Controller, il est nécessaire d’installer l’ensemble des SDK PowerShell Citrix requis par l’outil. Cet ensemble de SDK fait partie de Citrix Studio qui peut être installé à partir du support d’installation de Citrix Virtual Apps and Desktops™.
Remarque :
La configuration automatisée ne peut pas être exécutée sur le Cloud Connector.
Migration vers les plans de contrôle Citrix Cloud™ Government et Japon
Les environnements Citrix Cloud Government et Japan Control Plane utilisent différents points d’accès pour authentifier et allouer des jetons d’accès. Cette exigence unique s’applique à tout outil de configuration automatisée accédant au cloud. Effectuez les étapes suivantes pour utiliser la configuration automatisée dans ces environnements.
- Dans le dossier %HOMEPATH%\Documents\Citrix\AutoConfig, modifiez CustomerInfo.yml.
-
Ajoutez l’une des lignes suivantes, en fonction de l’environnement auquel vous souhaitez vous connecter, à CustomerInfo.yml (ou modifiez-la, si elle est déjà présente).
Environment: 'ProductionGov'ou
Environment: 'ProductionJP'
La configuration automatisée peut désormais être utilisée dans ces environnements.
Collecte de données Citrix Cloud
Pour plus d’informations sur les données collectées par Citrix Cloud, consultez Gestion du contenu client et des journaux des services Citrix Cloud.
Ressources supplémentaires
Forum de discussion
Visitez le forum de discussion Citrix pour la configuration automatisée.
Vidéo
Regardez Under the Hood of the Automated Configuration Tool for Citrix Virtual Apps and Desktops sur YouTube.
Formation
Le Cloud Learning Center contient des guides vidéo étape par étape pour la création d’un déploiement de service, y compris les tâches décrites dans cet article. Consultez le parcours d’apprentissage Migration de Citrix Virtual Apps and Desktops vers Citrix Cloud.
Dans cet article
- Erreurs de l’outil de configuration automatisée
- Journaux
- Fichiers de diagnostic
- Problèmes résultant de dépendances
- Recommandations
- Dossiers
- Sauvegardes
- Automatisation
- Exportation depuis des PC autres que le Delivery Controller™
- Migration vers les plans de contrôle Citrix Cloud™ Government et Japon
- Collecte de données Citrix Cloud
- Ressources supplémentaires