Instant-Clone-Wartungsdienstprogramme

Auf dem Verbindungsserver finden Sie drei Dienstprogramme, mit denen Sie virtuelle Instant-Clone-Maschinen (VMs) in vCenter Server und die darin enthaltenen Cluster warten können.

Die Hilfsprogramme sind IcMaint.cmd, IcUnprotect.cmd und IcCleanup.cmd und befinden sich in C:\Program Files\Omnissa\Horizon\Server\tools\bin.

IcMaint.cmd

Wenn Sie den ESXi-Host in den Wartungsmodus versetzen, löscht Horizon 8 in der Regel automatisch die übergeordnete virtuelle Maschine, damit der Host ohne manuellen Eingriff in den Wartungsmodus wechseln kann.

Sie können diesen Befehl jedoch verwenden, um cp-parent-VMs zu löschen. Der Host wird nicht automatisch in den Wartungsmodus versetzt. Um eine Wartung auf dem Host durchführen zu können, muss der vCenter Server-Administrator den Host manuell in den Wartungsmodus versetzen.

Syntax:

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

Parameter:

• -vc Hostname oder IP-Adresse von vCenter Server

• -uid vCenter Server-Benutzer-ID

• -hostname ESXi-Hostname

• -maintenance ON|OFF

  Dieser Parameter legt fest, ob der Host für das Hosten der Golden Image-VM verfügbar ist.

  Nach der Ausführung des Befehls auf dem Host wird der Anmerkungswert für InstantClone.Maintenance auf 1 gesetzt, und die Golden Image-VMs werden gelöscht. Wenn die Golden Image-VMs gelöscht sind, wird der Anmerkungswert für InstantClone.Maintenance auf 2 gesetzt, und es werden keine Golden Image-VMs mehr auf dem Host erstellt. Wenn Sie diesen Befehl erneut mit -maintenance OFF ausführen, wird der Anmerkungswert für InstantClone.Maintenance für den Host gelöscht, damit dieser für das Hosten von Golden Image-VMs verfügbar ist.

Alle Parameter sind erforderlich.

IcUnprotect.cmd

Nachdem ClonePrep Ordner und VMs erstellt hat, können Sie mit diesem Dienstprogramm den Schutz von Ordnern und VMs aufheben, VMs löschen und VMs ermitteln, deren Golden Image oder Snapshot gelöscht wurde. Mit ClonePrep werden die Instant Clones während des Erstellungsvorgangs angepasst.

Hinweis: Ein interner Dienst für Instant Clones, der während Instant-Clone-Vorgängen durchgeführt wird, erkennt, ob interne Ordner neu geschützt werden müssen. Wenn diese Ordner nicht leer sind, schützt der Dienst die Ordner automatisch erneut.

Syntax:

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

Parameter:

• -action

  Sie können für diesen Parameter die folgenden Optionen verwenden:

  • unprotect. Hebt den Schutz interner VMs auf.
  • delete. Löscht interne VMs.
  • detect. Ermittelt interne VMs, deren Golden Image oder Snapshot gelöscht wurde, und listet diese auf. Wenn Sie den Parameter -action nicht angeben, bleiben interne VMs standardmäßig ungeschützt.

• -vc Hostname oder IP-Adresse von vCenter Server

• -uid vCenter Server-Benutzer-ID

• -clientId Instant-Clone-Client-ID (Optional)

  Wird clientId nicht angegeben, wird der Schutz von allen ClonePrep-VMs in allen Rechenzentren entfernt.

• -domain Domänenname (Optional)

  Sie können mehrere durch Komma (ohne Leerzeichen) getrennte Domänennamen verwenden.

• -host Hostname (Optional)

  Sie können mehrere durch Komma (ohne Leerzeichen) getrennte Hostnamen verwenden.

• -datastore Datenspeichername (Optional)

  Sie können mehrere durch Komma (ohne Leerzeichen) getrennte Datenspeichernamen verwenden.

• -vmName VM-Name (Optional)

  Sie können mehrere durch Komma (ohne Leerzeichen) getrennte VM-Namen verwenden.

• -vmType Interner VM-Typ (Optional)

  Sie können mehrere durch Komma (ohne Leerzeichen) getrennte VM-Typen verwenden. Sie können für diesen Parameter die Optionen „template“, „replica“ und „parent“ verwenden.

• -includeFolders Einzuschließende Ordner

  Durch diesen Parameter wird der Schutz für die Ordner zusätzlich zu den VMs aufgehoben.

• -skipCertVeri Zertifizierungsprüfung überspringen

  IcUnprotect.cmd erzwingt Verifizierung des Hostnamens. Sie müssen den erforderlichen Hostnamen von vCenter Server anstelle der IP-Adresse eingeben, wenn Sie die Parameter des Befehls angeben. Verwenden Sie -skipCertVeri, um die Hostnamen-Verifizierung zu deaktivieren und stattdessen die IP-Adresse von vCenter Server zu verwenden.

Mit den folgenden Parametern können Sie alle übergeordneten VMs in vCenter Server löschen:

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

Mit den folgenden Parametern können Sie bestimmte übergeordnete VMs in vCenter Server löschen:

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

Sie können dieses Dienstprogramm zum Aufheben des Schutzes und zum Löschen von einigen oder allen internen VMs verwenden, die von Instant Clones erstellt wurden. Dieses Dienstprogramm bietet auch einen Listenbefehl zur Gruppierung interner VMs in der hierarchischen Struktur gemäß ihrer Golden-VM und dem Snapshot, mit dem der Instant Clone-Pool erstellt wurde. Der Listenbefehl verfügt über eine Erkennungsoption, die nur die internen VM-Gruppen anzeigt, deren Priming-Tag oder Snapshot fehlt. Sie können dann den Schutz einer bestimmten Gruppe oder aller dieser Gruppen aufheben und diese löschen. Sie können auch alle Gruppen für zukünftige Referenz in eine Festplattendatei ausgeben.

Syntax:

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

Parameter:

• -vc Hostname oder IP-Adresse von vCenter Server
• -uid vCenter Server-Benutzer-ID
• -skipCertVeri Überspringen der Überprüfung des vCenter Serverzertifikats (optional)
• -clientId Client-UUID, die eindeutige ID für den Server-Cluster, der aus dem Verbindungsserver und einem oder mehreren Replikatservern besteht.(Optional)

Hinweis: Um die Client-UUID zu finden, melden Sie sich beim Verbindungsserver oder einem der Replikatserver an, und führen Sie ADSI Edit aus. Navigieren Sie im DC-Eintrag, der DC=vdi enthält, zu OU=Properties > OU=Global > CN=Common und suchen Sie den Wert für pae-GUID, der dem Wert für die Client-UUID entspricht. Wenn Sie die Client-UUID nicht angeben, befasst sich das Bereinigungstool mit sämtlichen internen VMs. Wenn Sie die Client-UUID angeben, befasst sich das Bereinigungstool nur mit den internen VMs, die zu dieser speziellen Client-UUID gehören.

Befehle:

• list Einige oder alle internen VMs auflisten und diese in einer hierarchischen Struktur darstellen, die auch als interne VM-Gruppen bezeichnet wird. Zu den Optionen gehören:

  • -all Alle internen VM-Gruppen auflisten

  • -D,--detect Im Erkennungsmodus nur die internen VM-Gruppen mit fehlendem Priming-Tag oder Snapshot auflisten

  • -h,--help Die verfügbare Nutzung und Optionen für diesen Befehl drucken Nach der Ausführung des Befehls list können Sie qualifizierte interne VMs in einer hierarchischen Struktur anzeigen, die als interne VM-Gruppen bezeichnet wird. Für diese internen VM-Gruppen können Sie diese Befehle ausführen:

  • unprotect Den Schutz für einige oder alle internen VM-Gruppen anhand der folgenden Optionen aufheben:

    • -all Den Schutz für alle internen VMs aufheben. Ohne die Option -I müssen Sie -all angeben, um den Schutz für alle internen VM-Gruppen aufzuheben
    • -I,--index Den Schutz für eine bestimmte interne VM-Gruppe aufheben
    • -h,--help Die verfügbare Nutzung und Optionen für diesen Befehl drucken Hinweis: Um den Schutz einzelner VM-Gruppen aufzuheben, verwenden Sie den Index der internen Vorlagen-VM in der vCenter vSphere-Benutzeroberfläche, um die VM-Gruppe zu filtern. Verwenden Sie anschließend das Dienstprogramm zum Aufheben des Schutzes für jede Maschine einzeln. Zählen Sie beispielsweise in der Bestandsliste der vCenter vSphere-Benutzeroberfläche, die interne Vorlagen-VMs auflistet, die internen Vorlagen-VMs von oben und geben Sie den Indexwert für die Aufhebung des Schutzes dieser bestimmten Entität an.

  • delete Einige oder alle internen VM-Gruppen löschen

  • output Die internen VM-Gruppen in eine Festplattendatei ausgeben.

    • -F,--file Dateiname, unter dem die internen VM-Gruppen gespeichert werden sollen
    • -h,--help Die verfügbare Nutzung und Optionen für diesen Befehl drucken

  • back Zum Hauptmenü zurückkehren

  • unprotect Den Schutz für einige oder alle internen VMs einschließlich Ordnern aufheben. Zu den Optionen gehören:

    • -A,--adDomain Domänenname
    • -H,--host Hostname
    • -D,--datastore Datenspeichername
    • -T,--vmType Interner VM-Typ: Vorlage, Replikat oder übergeordnete VM
    • -N,--name Interner VM-Name
    • -I,--includeFolders Die internen VM-Ordner einschließen
    • -all Den Schutz für alle internen VMs aufheben
    • -h,--help Die verfügbare Nutzung und Optionen für diesen Befehl drucken

  • delete Einige oder alle internen VMs einschließlich Ordnern löschen. Zu den Optionen gehören:

    • -A,--adDomain Domänenname
    • -H,--host Hostname
    • -D,--datastore Datenspeichername
    • -T,--vmType Interner VM-Typ: Vorlage, Replikat oder übergeordnete VM
    • -N,--name Interner VM-Name
    • -I,--includeFolders Die internen VM-Ordner einschließen
    • -all Alle internen VMs löschen
    • -h,--help Die verfügbare Nutzung und Optionen für diesen Befehl drucken

  • exit Bei vCenter Server abmelden und das Programm beenden

Schutz für bestimmte VMs aufheben

Befolgen Sie die nachstehenden Informationen, um ein Dienstprogramm zum Aufheben des Schutzes bestimmter VMs gemäß Ihren Anforderungen auszuwählen. Derzeit gibt es kein unterstütztes Dienstprogramm, um die VMs nach dem Aufheben des Schutzes wieder zu schützen.

IcUnprotect.cmd – Dieses Dienstprogramm bietet mehrere Methoden zum Aufheben des Schutzes von VMs und Ordnern.

• `-vmName` Schutz basierend auf dem VM-Namen aufheben    
  

• `-vmType` Schutz basierend auf dem VM-Typ aufheben (z. B. übergeordnet)    
  

• `-includeFolders` Schutz für alle VMs, einschließlich zugeordneter Ordner, aufheben
  

IcCleanup.cmd – Dieses Dienstprogramm bietet detailliertere Optionen zum Aufheben des Schutzes von VMs.

• `-list` Zeigt eine Liste der VM-Gruppen zusammen mit ihren Indexnummern an.
  

• `-unprotect -I` <index> Hebt den Schutz einer VM-Gruppe mithilfe ihres Index aus der Liste auf
  

• `-unprotect -N` <vmName> Hebt den Schutz basierend auf dem VM-Namen auf
  

• `-unprotect -T` <vmType> Hebt den Schutz basierend auf dem VM-Typ auf
  

• `-unprotect -all` Hebt den Schutz für alle VMs auf
  

1. Führen Sie iccleanup.cmd -vc <host> -uid <username> aus.

2. Wählen Sie die Option list aus, um alle VM-Gruppen mit ihren entsprechenden Indizes anzuzeigen.

3. Verwenden Sie den entsprechenden Befehl unprotect -, um den Schutz einer bestimmten VM aufzuheben. Im folgenden Beispiel wird -unprotect -I (unprotect -I 31) verwendet.