Le serveur de connexion comprend trois utilitaires que vous pouvez utiliser pour la maintenance de machines virtuelles d'Instant Clone dans vCenter Server et les clusters dans lesquels se trouvent les machines virtuelles.

Les utilitaires sont IcMaint.cmd, IcUnprotect.cmd et IcCleanup.cmd. Ils se trouvent dans C:\Program Files\VMware\VMware View\Server\tools\bin.

IcMaint.cmd

Généralement, lorsque vous mettez l'hôte ESXi en mode de maintenance, VMware Horizon 8 supprime automatiquement la VM parente afin que l'hôte puisse entrer en mode de maintenance sans intervention manuelle.

Cependant, vous pouvez utiliser cette commande pour supprimer les machines virtuelles cp-parentes. L'hôte n'est pas automatiquement placé en mode de maintenance. Pour réaliser la maintenance sur l'hôte, l'administrateur de vCenter Server doit mettre manuellement l'hôte en mode de maintenance.

Syntaxe :

IcMaint.cmd -vc hostname_or_IP_address -uid user_ID -hostName ESXi_hostname -maintenance ON|OFF

Paramètres :

  • -vc nom d'hôte ou adresse IP de vCenter Server
  • -uid ID d'utilisateur de vCenter Server
  • -hostname nom d'hôte ESXi
  • -maintenance ON|OFF

    Ce paramètre spécifie si l'hôte est disponible pour héberger la machine virtuelle d'image standard.

    Une fois la commande exécutée sur l'hôte, la valeur d'annotation InstantClone.Maintenance est définie sur 1 et les machines virtuelles d'image standard sont supprimées. Une fois les machines virtuelles d'image standard supprimées, la valeur d'annotation InstantClone.Maintenance est définie sur 2 et aucune autre machine virtuelle d'image standard n'est créée sur l'hôte. Lorsque vous réexécutez cette commande avec -maintenanceOFF, la valeur d'annotation InstantClone.Maintenance est effacée afin que l'hôte soit disponible pour héberger les machines virtuelles d'image standard.

Tous les paramètres sont obligatoires.

IcUnprotect.cmd

Une fois que ClonePrep crée les dossiers et les machines virtuelles, vous pouvez utiliser cet utilitaire pour annuler la protection des machines virtuelles et des dossiers, supprimer des machines virtuelles et détecter les machines virtuelles dont une image standard ou un snapshot est supprimé. ClonePrep est le mécanisme qui personnalise les Instant Clones lors du processus de création.

Note : Un service interne pour les Instant Clones qui s'exécute pendant les opérations d'Instant Clone détecte si des dossiers internes doivent être reprotégés. Si ces dossiers ne sont pas vides, le service protège à nouveau les dossiers automatiquement.

Syntaxe :

IcUnprotect.cmd -vc hostname_or_IP_address -uid user_ID [-includeFolders][-skipCertVeri]

Paramètres :

  • -action

    Vous pouvez utiliser les options suivantes pour ce paramètre :

    • unprotect. Annulez la protection des machines virtuelles internes.
    • delete. Supprimez des machines virtuelles internes.
    • detect. Détectez et répertoriez les machines virtuelles internes dont l'image standard ou le snapshot est supprimé.

    Si vous ne spécifiez pas le paramètre -action, les machines virtuelles internes ne sont pas protégées par défaut.

  • -vc nom d'hôte ou adresse IP de vCenter Server
  • -uid ID d'utilisateur de vCenter Server
  • -clientId ID de client d'Instant Clone (Facultatif)

    Si clientId n'est pas spécifié, la protection est supprimée de toutes les machines virtuelles ClonePrep dans tous les centres de données.

  • -domain nom de domaine (Facultatif)

    Vous pouvez utiliser plusieurs noms de domaine séparés par des virgules et aucun espace.

  • -host nom d'hôte (Facultatif)

    Vous pouvez utiliser plusieurs noms d'hôte séparés par des virgules et aucun espace.

  • -datastore nom de banque de données (Facultatif)

    Vous pouvez utiliser plusieurs noms de banque de données séparés par des virgules et aucun espace.

  • -vmName nom de VM (Facultatif)

    Vous pouvez utiliser plusieurs noms de machine virtuelle séparés par des virgules et aucun espace.

  • -vmType type de VM interne (Facultatif)

    Vous pouvez utiliser plusieurs types de machine virtuelle séparés par des virgules et aucun espace. Vous pouvez utiliser modèle, réplica, parent comme options de ce paramètre.

  • -includeFolders inclure des dossiers

    Ce paramètre annule la protection des dossiers et des machines virtuelles.

  • -skipCertVeri ignorer la vérification des certificats

    IcUnprotect.cmd applique la vérification du nom d'hôte. Vous devez entrer le nom d'hôte correct de vCenter Server au lieu de son adresse IP lorsque vous spécifiez les paramètres de commande. Pour désactiver la vérification du nom d'hôte et utiliser l'adresse IP de vCenter Server à la place, utilisez -skipCertVeri.

Spécifiez les paramètres suivants pour supprimer toutes les VM parentes dans vCenter Server :

IcUnprotect -action delete -vc <IP address of vCenter Server> -uid <vCenter Server user ID> -clientId <instant clone client ID> -host <hostname 1>,<hostname 2> -vmType parent

Spécifiez les paramètres suivants pour supprimer les VM parentes spécifiques dans vCenter Server :

IcUnprotect -action delete -vc <IP address of vCenter Server> -uid <vCenter Server user ID> -clientId <instant clone client ID> -host <hostname 1>,<hostname 2> -vmType parent -vmName <parent VM name 1>,< parent VM name 2>

IcCleanup.cmd

Vous pouvez exécuter cet utilitaire pour annuler la protection et supprimer une partie ou l'ensemble des VM internes créées par des Instant Clones. Cet utilitaire fournit également une commande de liste pour regrouper les VM internes dans la structure hiérarchique en fonction de leur VM standard et du snapshot utilisé pour créer le pool d'Instant Clones. La commande de liste inclut une option de détection qui ne révèle que les groupes de VM internes dont la balise d'amorçage ou le snapshot sont manquants. Vous pouvez ensuite annuler la protection et supprimer un groupe spécifique ou tous ces groupes. Vous pouvez également copier tous les groupes dans un fichier de disque pour référence ultérieure.

Syntaxe :

iccleanup.cmd -vc vcName -uid userId [-skipCertVeri] [-clientId clientUuid]

Paramètres :

  • -vc nom d'hôte ou adresse IP de vCenter Server
  • -uid ID d'utilisateur de vCenter Server
  • -skipCertVeri Ignorer la vérification du certificat de vCenter Server (facultatif)
  • -clientId UUID du client, l'ID unique du cluster de serveurs est constitué du Serveur de connexion et d'un ou plusieurs serveurs de réplication. (Facultatif)
    Note : Pour trouver l'UUID du client, connectez-vous au Serveur de connexion ou à l'un des serveurs de réplica, exécutez ADSI Edit. Dans DC=vdi,dc=vmware,dc=int > OU=Properties > OU=Global > CN=Common, recherchez la valeur de pae-GUID, qui correspond à la valeur de l'UUID du client. Si vous ne spécifiez pas l'UUID du client, l'outil de nettoyage traitera toutes les machines virtuelles internes. Si vous spécifiez l'UUID du client, l'outil de nettoyage traitera uniquement les machines virtuelles internes qui appartiennent à cet UUID de client particulier.
Commandes :
  • list Répertorie une partie ou l'ensemble des machines virtuelles internes et les présente dans une structure hiérarchique, également appelées groupes de machines virtuelles internes. Voici les options possibles :
    • -all Répertorier tous les groupes de machines virtuelles internes
    • -D,--detect Le mode de détection répertorie uniquement les groupes de machines virtuelles internes avec une balise ou un snapshot d'amorçage manquant
    • -h,--help Imprimer les options et l'utilisation disponibles pour cette commande

    Après avoir exécuté la commande list, vous pouvez voir les machines virtuelles internes qualifiées présentées dans une structure hiérarchique appelée groupes de machines virtuelles internes. Pour ces groupes de VM internes, vous pouvez exécuter les commandes suivantes :

    • unprotect Annuler la protection de certains ou de tous les groupes de machines virtuelles internes à l'aide des options suivantes :
      • -all Annuler la protection de toutes les machines virtuelles internes. Sans l'option -I, vous devez spécifier -all pour annuler la protection de tous les groupes de machines virtuelles internes
      • -I,--index Annuler la protection d'un certain groupe de machines virtuelles internes
      • -h,--help Imprimer les options et l'utilisation disponibles pour cette commande
    • delete Supprimer un ou tous les groupes de machines virtuelles internes
    • output génère les groupes de VM internes dans un fichier de disque.
      • -F,--file Nom de fichier pour enregistrer les groupes de machines virtuelles internes
      • -h,--help Imprimer les options et l'utilisation disponibles pour cette commande
    • back Retourner au menu principal
  • unprotect Annuler la protection de certaines ou de toutes les machines virtuelles internes, y compris des dossiers. Voici les options possibles :
    • -A,--adDomain Nom de domaine
    • -H,--host Nom d'hôte
    • -D,--datastore Nom de banque de données
    • -T,--vmType Type de machine virtuelle interne : modèle, réplica ou parent
    • -N,--name Nom de machine virtuelle interne
    • -I,--includeFolders Inclure les dossiers de machines virtuelles internes
    • -all Annuler la protection de toutes les machines virtuelles internes
    • -h,--help Imprimer les options et l'utilisation disponibles pour cette commande
  • delete Supprimer une partie ou l'ensemble des machines virtuelles internes, y compris les dossiers. Voici les options possibles :
    • -A,--adDomain Nom de domaine
    • -H,--host Nom d'hôte
    • -D,--datastore Nom de banque de données
    • -T,--vmType Type de machine virtuelle interne : modèle, réplica ou parent
    • -N,--name Nom de machine virtuelle interne
    • -I,--includeFolders Inclure les dossiers de machines virtuelles internes
    • -all Annuler la protection de toutes les VM internes
    • -h,--help Imprimer les options et l'utilisation disponibles pour cette commande
  • exit Se déconnecter de vCenter Server et quitter le programme