Vérification préalable à l’installation et à la mise à niveau du VDA
Présentation d’une vérification préalable découplée pour l’installation et les mises à niveau du VDA, permettant aux clients d’identifier de manière proactive les problèmes potentiels avant de poursuivre. Cette vérification valide toutes les dépendances et les prérequis, fournissant un statut clair de réussite/échec pour chaque condition. En cas d’échec, des conseils de correction détaillés avec des recommandations spécifiques sont fournis. Le processus d’installation ou de mise à niveau réel reste distinct et doit être lancé manuellement une fois la vérification préalable terminée.
Cet article décrit les étapes à suivre pour effectuer la vérification préalable à l’installation et à la mise à niveau du VDA.
Étape 1. Exécuter la ligne de commande
Remarque :
- La vérification préalable n’est prise en charge qu’en mode ligne de commande.
- L’installation ou la mise à niveau n’est pas lancée lors de l’exécution de cette commande.
Pour effectuer une vérification préalable, ajoutez l’option /precheckonly à votre commande fréquemment utilisée pour l’installation ou la mise à niveau. Toutes les conditions de vérification préalable pour l’installation ou la mise à niveau de votre VDA seront vérifiées.
Effectuer la vérification préalable pour l’installation et la mise à niveau par défaut
Exécutez la commande suivante pour effectuer une vérification préalable et vous assurer que l’état de la machine est acceptable :
\x64\XenDesktop Setup\XenDesktopVdaSetup.exe /quiet /precheckonly

Effectuer la vérification préalable pour l’installation et la mise à niveau de composants spécifiés
Pour vérifier les prérequis de composants spécifiques avant l’installation ou la mise à niveau, ajoutez /precheckonly à votre commande.
\x64\XenDesktop Setup\XenDesktopVdaSetup.exe /quiet /precheckonly /components vda,plugins

Effectuer la vérification préalable pour l’installation et la mise à niveau d’un composant supplémentaire - Citrix Backup and Restore
La commande \x64\XenDesktop Setup\XenDesktopVdaSetup.exe /quiet /precheckonly vérifie les prérequis pour le composant Citrix Backup and Restore en tant que vérification facultative. Si toutes les vérifications préliminaires réussissent, à l’exception de la vérification facultative, le résultat global est PASS.

Les commandes suivantes vérifient les prérequis pour le composant Citrix Backup and Restore dans le cadre d’une vérification obligatoire :
\x64\XenDesktop Setup\XenDesktopVdaSetup.exe /quiet /precheckonly /includeadditional "Citrix Backup and Restore"\x64\XenDesktop Setup\XenDesktopVdaSetup.exe /quiet /precheckonly /enablerestore\x64\XenDesktop Setup\XenDesktopVdaSetup.exe /quiet /precheckonly /enablerestorecleanup

Étape 2. Afficher les résultats de la vérification préliminaire
Les résultats de la vérification préliminaire sont affichés dans la ligne de commande, enregistrés dans %temp%/Citrix/XenDesktop Installer/XenDesktop Installation.log et sauvegardés dans %temp%/Citrix/XenDesktop Installer/PrecheckResult_{yyyyMMddHHmmss}.json. Si la vérification préliminaire échoue, le résultat global est FAIL, avec des correctifs suggérés pour chaque problème.
Sortie de la ligne de commande
Les résultats de la vérification préliminaire dans la ligne de commande incluent :
- Critères de vérification préliminaire
- État de la vérification préliminaire
- Suggestions de correctifs en cas d’échec
- Résultat global
- Heure de fin.
Si le résultat est FAIL, les suggestions de correction sont disponibles dans les lignes commençant par Precheck - Fix Suggestion :

Sortie du journal
Les résultats de la vérification préalable dans XenDesktop Installation.log sont identiques à ceux affichés dans la ligne de commande. Pour les localiser, recherchez Precheck - dans le fichier journal.
Si le résultat global est FAIL, les suggestions de correction sont disponibles dans les lignes contenant Precheck - Fix Suggestion:.

Sortie JSON
Un fichier .json est généré chaque fois qu’une commande avec /quiet /precheckonly est exécutée. Le fichier est nommé PrecheckResult_{yyyyMMddHHmmss}.json, avec un suffixe d’horodatage.

Le fichier .json comprend :
- Heure de fin locale de la vérification préalable
- Résultat global
- Détails de la vérification préalable
- Critères
- Valeur réelle
- Statut
- Suggestion de correction

Les suggestions de correction pour chaque élément de pré-vérification ayant le statut FAIL se trouvent dans la section des détails de la pré-vérification du fichier .json.
