Utilitaires de maintenance d'Instant Clone

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.cmdet IcCleanup.cmd et se trouvent dans C:\Program Files\Omnissa\Horizon\Server\tools\bin.

IcMaint.cmd

Généralement, lorsque vous mettez l'hôte ESXi en mode de maintenance, Horizon 8 supprime automatiquement la machine virtuelle 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 exécutez de nouveau cette commande avec -maintenance désactivé, 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.

Remarque : 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 machines virtuelles 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 des machines virtuelles 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 réplica. (Facultatif)

Remarque : pour trouver l'UUID du client, connectez-vous au Serveur de connexion ou à l'un des serveurs réplica et exécutez ADSI Edit. Dans l'entrée DC contenant DC=vdi, accédez à OU=Properties > OU=Global > CN=Common et recherchez la valeur de pae-GUID, qui est 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 Remarque : pour annuler la protection de groupes de machines virtuelles individuels, utilisez l'index de machine virtuelle modèle interne dans l'UI de vCenter vSphere pour filtrer le groupe de machines virtuelles. Ensuite, utilisez l'utilitaire unprotect pour chaque machine, une par une. Par exemple, dans l'inventaire de l'UI de vCenter vSphere qui répertorie les machines virtuelles modèles internes, comptez la machine virtuelle modèle interne à partir du haut et mentionnez la valeur d'index pour annuler la protection de cette entité particulière.

  • 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

Annuler la protection de VM spécifiques

Suivez les informations ci-dessous pour sélectionner un utilitaire afin d'annuler la protection de machines virtuelles spécifiques en fonction de vos besoins. Actuellement, il n'existe aucun utilitaire pris en charge pour protéger à nouveau les machines virtuelles après l'annulation de la protection.

IcUnprotect.cmd - Cet utilitaire propose plusieurs méthodes pour annuler la protection des machines virtuelles et des dossiers.

• `-vmName` Annuler la protection en fonction du nom de la VM    
  

• `-vmType` Annuler la protection selon le type de machine virtuelle (par exemple, parent)    
  

• `-includeFolders` Annuler la protection de toutes les machines virtuelles, y compris des dossiers associés
  

IcCleanup.cmd - Cet utilitaire fournit des options plus détaillées pour annuler la protection des machines virtuelles.

• `-list` Affiche une liste de groupes de machines virtuelles ainsi que leurs numéros d'index.
  

• `-unprotect -I` <index> Annule la protection d'un groupe de machines virtuelles à l'aide de son index dans la liste
  

• `-unprotect -N` <vmName> Annule la protection en fonction du nom de la machine virtuelle
  

• `-unprotect -T` <vmType> Annule la protection en fonction du type de machine virtuelle
  

• `-unprotect -all` Annule la protection de toutes les machines virtuelles
  

1. Exécutez iccleanup.cmd -vc <host> -uid <username>.

2. Sélectionnez l'option list pour afficher tous les groupes de VM avec leurs index correspondants.

3. Utilisez la commande unprotect - appropriée pour annuler la protection d'une VM spécifique. L'exemple ci-dessous utilise -unprotect -I (unprotect -I 31).