Utiliser la commande d’exécution Set-ToolsRepo

Cet article explique comment utiliser la Set-ToolsRepo commande d’exécution de bout en bout, comment télécharger et héberger la version GuestStore correcte du fichier ZIP VMware Tools et comment valider la réussite.

Quand utiliser la commande d’exécution Set-ToolsRepo

Utilisez la commande d’exécution Set-ToolsRepo lorsque vous souhaitez :

• Rendre une version spécifique de VMware Tools disponible pour l’installation et la mise à niveau des outils invités de machine virtuelle dans un cloud privé Azure VMware Solution.
• Publiez de manière centralisée la version GuestStore du fichier ZIP VMware Tools sur l’emplacement central vSAN pour VMware Tools afin que tous les hôtes pertinents puissent référencer le package.

Prerequisites

• URL HTTP ou HTTPS accessible publiquement qui pointe vers la version GuestStore de votre fichier ZIP VMware Tools. L’URL doit être accessible depuis l’environnement d’exécution des commandes d’exécution d’Azure VMware Solution.
• Autorisation d’exécuter les packages de commandes d’exécution d’Azure VMware Solution dans le portail Azure pour le cloud privé cible.

Contenu ZIP attendu

Le fichier ZIP que vous chargez doit :

• Incluez un répertoire de charge utile VMware Tools dans la disposition attendue.
• Contiennez le dossier versionné sous la vmware/apps/vmtools/windows64/vmtools-<version>/ section. Le nom du dossier doit suivre le format vmtools-<version> (par exemple, vmtools-12.4.0).

-Valider l’option

L’option -Validate active un mode d’audit en lecture seule pour le référentiel VMware Tools. Lorsque vous spécifiez cette option, Set-ToolsRepo inspecte les fichiers de métadonnées de magasin de données actuels sans apporter de modifications à votre environnement.

Quand utiliser l’option -Validate

• Avant d’exécuter Set-ToolsRepo, en tant que vérification de référence
• Après l’exécution Set-ToolsRepo, pour confirmer que tout est synchronisé
• Si vous soupçonnez un problème de dépôt ou de synchronisation et que vous souhaitez une vérification rapide en lecture seule

Quelles sont les vérifications de l’option -Validate

• Identifie tous les datastores vSAN dans le centre de données défini par logiciel (SDDC)
• Lit les métadonnées du référentiel (top-level-metadata.json et version-metadata.json)
• Vérifie que les métadonnées et l’état du magasin de données sont cohérents et synchronisés

Résultats de l’option -Validate

• PASS: les versions correspondent et les magasins de données sont synchronisés.
• FAIL: une incompatibilité ou une incohérence est détectée.

Échecs courants de l’option -Validate

• Incompatibilité des métadonnées : réexécuter Set-ToolsRepo avec une URL ZIP VMware Tools valide (sans l’option -Validate ) pour redéployer ou réparer le référentiel. Ensuite, exécutez Set-ToolsRepo -Validate pour vérifier que les métadonnées sont synchronisées.
• Chemin d’accès GuestStore introuvable : le référentiel peut être manquant ou inaccessible. Déployez ou réinitialisez en exécutant Set-ToolsRepo avec une URL ZIP valide (sans l’option -Validate). Ensuite, exécutez Set-ToolsRepo -Validate pour vérifier que le référentiel est présent et synchronisé.

URL du fichier ZIP de VMware Tools

La commande Set-ToolsRepo run accepte une URL HTTP ou HTTPS accessible publiquement pointant vers la version GuestStore du fichier ZIP VMware Tools qui sera publiée dans l’emplacement central de vSAN pour VMware Tools.

Avant que la commande n’apporte de modifications, la validation de ces éléments se produit :

• L’URL utilise HTTP ou HTTPS et est un lien de téléchargement direct.
• Le fichier est accessible sans authentification interactive et peut être téléchargé de bout en bout.

Workflow de bout en bout

1. Téléchargez la version requise de VMware Tools.

   Obtenez la version GuestStore du fichier ZIP VMware Tools pour la version spécifique que vous souhaitez publier à l’emplacement central vSAN pour VMware Tools.

2. Hébergez le fichier ZIP sur une URL HTTP ou HTTPS accessible publiquement. Par exemple, utilisez n’importe quel serveur web ou stockage d’objets qui peut servir le fichier sans authentification interactive.

   Ensuite, fournissez cette URL de téléchargement direct à utiliser avec la commande Run.

   Important

   L’URL doit être un lien de téléchargement direct et être accessible sans authentification interactive afin que la commande d’exécution puisse récupérer le fichier ZIP.

3. Exécutez la commande d’exécution Azure VMware Solution Set-ToolsRepo. Indiquez l’URL ZIP de l’étape 2.

   Une fois la commande terminée, sa sortie indique la réussite ou fournit un message d’erreur.

4. Le package VMware Tools est publié.

   La version demandée est disponible à partir de l’emplacement central vSAN pour VMware Tools pour le cloud privé.

5. Les hôtes sont configurés pour utiliser le référentiel vSAN.

   Dans le cadre de la commande d’exécution, les hôtes ESXi appropriés dans le cloud privé sont mis à jour pour utiliser l’emplacement central vSAN comme source VMware Tools.

Validation

Après avoir réussi l’exécution de la Set-ToolsRepo commande d’exécution, procédez comme suit :

1. Accédez à votre client vCenter et parcourez le magasin de données vSAN. Vérifiez que le dossier de version existe sous GuestStore/vmware/apps/vmtools/windows64/.

2. Vérifiez que la version correcte de VMware Tools est disponible pour installer ou mettre à niveau à partir d’une machine virtuelle de test invité.

3. Si des problèmes se produisent avec VMware Tools après une opération de commande réussie, capturez la sortie de la commande et ouvrez une demande de support.

Résolution des problèmes

Si la commande d’exécution échoue, les causes côté client les plus courantes sont les suivantes :

• L’URL n’est pas accessible publiquement en tant que lien de téléchargement direct.
• Le fichier ZIP ne contient pas la structure de dossiers attendue.

Utilisez le message d’erreur avec les étapes de dépannage suivantes.

Problèmes d’URL ou de téléchargement

• URL inaccessible ou téléchargement ayant échoué. Vérifiez que l’URL s’ouvre à partir d’un réseau externe et qu’elle est un lien de téléchargement direct. Vérifiez également que l’URL ne nécessite pas de jetons de connexion, d’authentification multifacteur ou de jetons limités dans le temps.
• Erreur TLS/SSL. Vérifiez que le point de terminaison HTTPS prend en charge des versions modernes de TLS et présente un certificat valide.

Problèmes de structure du ZIP

• Dossier attendu introuvable. Vérifiez que le fichier ZIP contient vmware/apps/vmtools/windows64/vmtools-<version> (y compris le répertoire de début vmware/ ).
• Plusieurs versions d’un fichier ZIP. Hébergez un fichier ZIP qui contient uniquement la version unique que vous envisagez de publier, avec un dossier vmtools-<version> .

Problèmes de magasin de données

• Erreur de publication ou de configuration côté service. Si l’URL et la structure ZIP sont correctes, mais que la commande d’exécution échoue toujours, capturez la sortie complète de la commande et ouvrez une demande de support.
• Échecs intermittents. Réessayez la commande d’exécution après avoir confirmé que l’URL ZIP est toujours valide et accessible.

L’option de mise à niveau de VMware Tools n’est pas disponible et non sur la version actuelle

L’option Installer ou mettre à niveau VMware Tools peut être disponible (s’afficher grisée) pour les machines virtuelles dans vCenter. Cette situation peut se produire lorsque les métadonnées du référentiel VMware Tools dans le magasin de données vSAN sont incohérentes ou incorrectes.

Pour la résolution, utilisez les procédures suivantes.

Vérifier les métadonnées du référentiel dans GuestStore

1. Accédez à vSAN Datastore>GuestStore>vmware>apps>vmtools>windows64.

   

2. Vérifiez les fichiers suivants :

   • Métadonnées de niveau supérieur : windows64/metadata.json.

     

   • Métadonnées spécifiques à la version : windows64/vmtools-<version>/metadata.json.

     

Valider la cohérence des métadonnées

Le fichier de niveau metadata.json supérieur et le fichier spécifique à la metadata.json version doivent :

• Mettre en correspondance la même version de VMware Tools.
• Soyez cohérents les uns avec les autres (comme le montrent les captures d’écran de référence).

S’ils correspondent, les métadonnées sont cohérentes. S’ils ne correspondent pas, les métadonnées sont incohérentes.

Corriger l’incompatibilité des métadonnées (si elle est identifiée)

Si le fichier de niveau supérieur est incorrect :

1. Supprimer windows64/metadata.json (par exemple, vSAN Datastore/GuestStore/vmware/apps/vmtools/windows64/metadata.json).

2. Téléchargez le fichier correct windows64/metadata.json du package VMware Tools le plus récent que vous avez téléversé.

Si le fichier spécifique à la version est incorrect :

1. Supprimer windows64/vmtools-<version>/metadata.json (par exemple, vSAN Datastore/GuestStore/vmware/apps/vmtools/windows64/vmtools-<version>/metadata.json).

2. Téléchargez le fichier correct windows64/vmtools-<version>/metadata.json du package VMware Tools le plus récent que vous avez téléversé.

Vérifiez également que les deux fichiers de métadonnées correspondent à la version de VMware Tools.

Attendre le rafraîchissement de l’hôte

Laissez le temps nécessaire à la propagation de la modification entre les hôtes. L’opération peut prendre jusqu’à 24 heures.

Vérifier la résolution

Revérifier la machine virtuelle dans vCenter. L’option Installer ou mettre à niveau VMware Tools doit maintenant être disponible.

Confirmer la cohérence (facultatif)

Exécutez Set-ToolsRepo -Validate pour confirmer la cohérence des métadonnées.

Contenu connexe

• Pour en savoir plus sur les commandes d’exécution, consultez Utiliser les commandes d’exécution.