Citrix Hypervisor

Befehlszeilenoberfläche

Mit der xe CLI können Sie Systemadministrationsaufgaben skripten und automatisieren. Verwenden Sie die CLI, um Citrix Hypervisor in eine vorhandene IT-Infrastruktur zu integrieren.

Erste Schritte mit der Xe-CLI

Die xe-Befehlszeilenschnittstelle ist standardmäßig auf allen Citrix Hypervisor-Servern installiert. Eine Remote-Windows-Version ist in XenCenter enthalten. Eine eigenständige Remote-CLI ist auch für Linux verfügbar.

Auf Ihrem Citrix Hypervisor-Server

Die xe-Befehlszeilenschnittstelle ist standardmäßig auf Ihrem Server installiert. Sie können Xe-CLI-Befehle in der dom0-Konsole ausführen. Greifen Sie auf eine der folgenden Arten auf die dom0-Konsole zu:

  • Gehen Sie in XenCenter zur Registerkarte Konsole für den Server, auf dem Sie den Befehl ausführen möchten.
  • SSH zu dem Server, auf dem Sie den Befehl ausführen möchten.

Unter Windows

Unter Windows wird der Befehl xe.exe zusammen mit XenCenter installiert.

Um den Befehl xe.exe zu verwenden, öffnen Sie eine Windows-Eingabeaufforderung und wechseln Sie in das Verzeichnis, in dem die Datei xe.exe ist (normalerweise C:\Program Files (x86)\Citrix\XenCenter). Wenn Sie das Installationsverzeichnis von xe.exe zu Ihrem Systempfad hinzufügen, können Sie den Befehl verwenden, ohne in das Verzeichnis wechseln zu müssen.

Unter Linux

Auf RPM-basierten Distributionen (wie Red Hat) können Sie den eigenständigen xe-Befehl aus RPM client_install/xapi-xe-BUILD.x86_64.rpm installieren, das auf dem Citrix Hypervisor-Hauptinstallations-ISO-Image angegeben ist.

Verwenden Sie den folgenden Befehl, um vom RPM aus zu installieren:

rpm -ivh xapi-xe-BUILD.x86_64.rpm
<!--NeedCopy-->

Sie können Parameter in der Befehlszeile verwenden, um den Citrix Hypervisor-Server, den Benutzernamen und das Kennwort zu definieren, die beim Ausführen von xe-Befehlen verwendet werden sollen. Sie haben jedoch auch die Möglichkeit, diese Informationen als Umgebungsvariable festzulegen. Beispiel:

export XE_EXTRA_ARGS="server=<host name>,username=<user name>,password=<password>"
<!--NeedCopy-->

Hinweis:

Die Remote-XE-CLI unter Linux hängt möglicherweise beim Versuch, Befehle über eine sichere Verbindung auszuführen, und diese Befehle beinhalten die Dateiübertragung. In diesem Fall können Sie den Parameter --no-ssl verwenden, um den Befehl über eine unsichere Verbindung zum Citrix Hypervisor-Server auszuführen.

Hilfe mit xe-Befehlen erhalten

Grundlegende Hilfe für CLI-Befehle auf dem Host ist verfügbar, indem Sie Folgendes eingeben:

xe help command
<!--NeedCopy-->

Eine Liste der am häufigsten verwendeten xe-Befehle wird angezeigt, wenn Sie Folgendes eingeben:

xe help
<!--NeedCopy-->

Oder es wird eine Liste aller xe-Befehle angezeigt, wenn Sie Folgendes eingeben:

xe help --all
<!--NeedCopy-->

Grundlegende xe-Syntax

Die grundlegende Syntax aller Citrix Hypervisor xe CLI-Befehle lautet:

xe command-name argument=value argument=value
<!--NeedCopy-->

Jeder spezifische Befehl enthält seine eigenen Argumente, die das Format argument=value haben. Für einige Befehle sind Argumente erforderlich, und die meisten haben einige optionale Argumente. In der Regel geht ein Befehl von Standardwerten für einige der optionalen Argumente aus, wenn er ohne sie aufgerufen wird.

Wenn der xe-Befehl remote ausgeführt wird, werden zusätzliche Argumente für die Verbindung und Authentifizierung verwendet. Diese Argumente haben auch das Format argument=argument_value.

Das Argument server wird verwendet, um den Hostnamen oder die IP-Adresse anzugeben. Die Argumente username und password werden verwendet, um Anmeldeinformationen anzugeben.

Anstelle des Kennworts kann direkt ein Argument password-file angegeben werden. In diesem Fall versucht der xe-Befehl, das Kennwort aus der angegebenen Datei zu lesen, und verwendet dieses Kennwort, um eine Verbindung herzustellen. (Alle nachfolgenden CRs und LFs am Ende der Datei werden entfernt.) Diese Methode ist sicherer als die Angabe des Kennworts direkt in der Befehlszeile.

Das optionale port-Argument kann verwendet werden, um den Agentport auf dem Citrix Hypervisor-Remoteserver anzugeben (standardmäßig 443).

Beispiel: Auf dem lokalen Citrix Hypervisor-Server:

xe vm-list
<!--NeedCopy-->

Beispiel: Auf einem Citrix Hypervisor-Remoteserver:

xe vm-list username=username password=password server=hostname
<!--NeedCopy-->

Die Kurzschriftsyntax ist auch für Argumente für Remoteverbindungen verfügbar:

  • -u user name
  • -pw password
  • -pwf password file
  • -p Port
  • -s server

Beispiel: Auf einem Citrix Hypervisor-Remoteserver:

xe vm-list -u myuser -pw mypassword -s hostname
<!--NeedCopy-->

Argumente werden auch aus der Umgebungsvariablen XE_EXTRA_ARGS in Form von kommagetrennten Schlüssel/Wert-Paaren übernommen. Um beispielsweise Befehle einzugeben, die auf einem Citrix Hypervisor-Remoteserver ausgeführt werden, führen Sie zuerst den folgenden Befehl aus:

export XE_EXTRA_ARGS="server=jeffbeck,port=443,username=root,password=pass"
<!--NeedCopy-->

Nachdem Sie diesen Befehl ausgeführt haben, müssen Sie die Citrix Hypervisor-Remoteserverparameter nicht mehr in jedem XE-Befehl angeben, den Sie ausführen.

Die Verwendung der Umgebungsvariablen XE_EXTRA_ARGS ermöglicht auch die Tab-Vervollständigung von xe-Befehlen, wenn sie für einen Citrix Hypervisor-Remoteserver ausgegeben werden, der standardmäßig deaktiviert ist.

Sonderzeichen und Syntax

Um Argument-/Wertepaare in der xe-Befehlszeile anzugeben, schreiben Sie: argument=value

Verwenden Sie keine Anführungszeichen, sofern der Wert keine Leerzeichen enthält. Fügen Sie keine Leerzeichen zwischen dem Argumentnamen, dem Gleichheitszeichen (=) und dem Wert ein. Jedes Argument, das diesem Format nicht entspricht, wird ignoriert.

Für Werte, die Leerzeichen enthalten, schreiben Sie: argument="value with spaces"

Wenn Sie die CLI auf Ihrem Citrix Hypervisor-Server verwenden, verfügen Befehle über eine Funktion zur Tab-Vervollständigung, die der Funktion in der Standard-Linux-Bash-Shell ähnelt. Wenn Sie beispielsweise xe vm-l eingeben und dann die TAB-Taste drücken, wird der Rest des Befehls angezeigt. Wenn mehrere Befehle mit vm-l beginnen, werden durch erneutes Drücken der Tabulatortaste die Möglichkeiten aufgelistet. Diese Funktion ist nützlich, wenn Objekt-UUIDs in Befehlen angegeben werden

Hinweis:

Die Tab-Vervollständigung funktioniert normalerweise nicht, wenn Befehle auf einem Citrix Hypervisor-Remoteserver ausgeführt werden. Wenn Sie jedoch die Variable XE_EXTRA_ARGS auf dem Computer festlegen, auf dem Sie die Befehle eingeben, ist die Tab-Vervollständigung aktiviert. Weitere Informationen finden Sie unter Grundlegende XE-Syntax.

Befehlstypen

Die CLI-Befehle können in zwei Hälften aufgeteilt werden. Befehle auf niedriger Ebene befassen sich mit dem Auflisten und der Parametermanipulation von API-Objekten. Befehle auf höherer Ebene werden verwendet, um mit VMs oder Hosts auf einer abstrakteren Ebene zu interagieren.

Die Befehle auf niedriger Ebene sind:

  • class-list

  • class-param-get

  • class-param-set

  • class-param-list

  • class-param-add

  • class-param-remove

  • class-param-clear

Dabei ist class eine dieser Optionen:

  • bond

  • console

  • host

  • host-crashdump

  • host-cpu

  • network

  • patch

  • pbd

  • pif

  • pool

  • sm

  • sr

  • task

  • template

  • vbd

  • vdi

  • vif

  • vlan

  • vm

Nicht jeder Wert von class hat den vollständigen Satz von Befehlen für class-param-action. Einige Werte von class haben einen kleineren Befehlssatz.

Typen von Parametern

Die Objekte, die mit den xe-Befehlen angesprochen werden, haben Parametersätze, die sie identifizieren und ihre Zustände definieren.

Die meisten Parameter nehmen einen einzigen Wert an. Beispielsweise enthält der Parameter name-label einer VM einen einzelnen Zeichenfolgenwert. In der Ausgabe von Befehlen der Parameterliste gibt ein Wert in Klammern - z. B. xe vm-param-list - an, ob es sich bei den Parametern um Lese-/Schreibzugriff (RW) oder schreibgeschützt (RO) handelt. Die Ausgabe von xe vm-param-list auf einer angegebenen VM kann die folgenden Zeilen haben:

user-version ( RW): 1
 is-control-domain ( RO): false

Der erste Parameter ist beschreibbar und hat den Wert 1. user-version Die zweite, is-control-domain, ist schreibgeschützt und hat den Wert false.

Die beiden anderen Arten von Parametern sind mehrwertig. Ein eingestellter Parameter enthält eine Liste von Werten. Ein Map-Parameter ist ein Satz von Schlüssel/Wert-Paaren. Sehen Sie sich als Beispiel die folgende Beispielausgabe von xe vm-param-list auf einer bestimmten VM an:

platform (MRW): acpi: true; apic: true; pae: true; nx: false
allowed-operations (SRO): pause; clean_shutdown; clean_reboot; \
hard_shutdown; hard_reboot; suspend

Der Parameter platform enthält eine Liste von Elementen, die Schlüssel/Wert-Paare darstellen. Auf die Schlüsselnamen folgt ein Doppelpunkt (:). Jedes Schlüssel/Wert-Paar ist durch ein Semikolon (;) vom nächsten getrennt. Das M vor dem RW zeigt an, dass dieser Parameter ein Map-Parameter ist und lesbar und beschreibbar ist. Der Parameter allowed-operations hat eine Liste, die aus einer Reihe von Elementen besteht. Das S vor dem RO zeigt an, dass dies ein festgelegter Parameter ist und lesbar, aber nicht beschreibbar ist.

Um nach einem Map-Parameter zu filtern oder einen Map-Parameter festzulegen, verwenden Sie einen Doppelpunkt (:), um den Map-Parameternamen und das Schlüssel/Wert-Paar zu trennen. Um beispielsweise den Wert des Schlüssels foo des Parameters other-config einer VM auf baa festzulegen, lautet der Befehl

xe vm-param-set uuid=VM uuid other-config:foo=baa
<!--NeedCopy-->

Parameter-Befehle auf niedriger Ebene

Es gibt mehrere Befehle für die Bedienung von Parametern von Objekten: class-param-get, class-param-set, class-param-add, class-param-remove, class-param-clear, and class-param-list. Jeder dieser Befehle benötigt einen Parameter uuid, um das bestimmte Objekt anzugeben. Da diese Befehle als Befehle auf niedriger Ebene betrachtet werden, müssen sie die UUID und nicht die VM-Namensbezeichnung verwenden.

  • xe class-param-list uuid=uuid

    Listet alle Parameter und die zugehörigen Werte auf. Im Gegensatz zum Befehl class-list listet dieser Befehl die Werte von “teuren” Feldern auf.

  • xe class-param-get uuid=uuid param-name=parameter param-key=key

    Gibt den Wert eines bestimmten Parameters zurück. Bei einem Map-Parameter wird durch Angabe des Parameter-Schlüssels der Wert abgerufen, der diesem Schlüssel in der Map zugeordnet ist. Wenn param-key nicht angegeben ist oder wenn der Parameter eine Menge ist, gibt der Befehl eine Zeichenfolgendarstellung des Satzes oder der Zuordnung zurück.

  • xe class-param-set uuid=uuid param=value

    Setzt den Wert eines oder mehrerer Parameter.

  • xe class-param-add uuid=uuid param-name=parameter key=value param-key=key

    Fügt entweder zu einer Map oder einem festgelegten Parameter hinzu. Fügen Sie für einen Map-Parameter Schlüssel/Wert-Paare hinzu, indem Sie die Schlüssel=Wert-Syntax verwenden. Wenn der Parameter ein Satz ist, fügen Sie Schlüssel mit der param-key=key-Syntax hinzu.

  • xe class-param-remove uuid=uuid param-name=parameter param-key=key

    Entfernt entweder ein Schlüssel/Wert-Paar aus einer Map oder einen Schlüssel aus einer Menge.

  • xe class-param-clear uuid=uuid param-name=parameter

    Löscht einen Satz oder eine Map vollständig.

Listenbefehle auf niedriger Ebene

Der Befehl class-list listet die Objekte vom Typ classauf. Standardmäßig listet dieser Befehlstyp alle Objekte auf und druckt eine Teilmenge der Parameter. Dieses Verhalten kann auf folgende Weise geändert werden:

  • Es kann die Objekte so filtern, dass es nur eine Teilmenge ausgibt
  • Die gedruckten Parameter können geändert werden.

Um die gedruckten Parameter zu ändern, geben Sie das Argument params als kommagetrennte Liste der erforderlichen Parameter an. Beispiel:

xe vm-list params=name-label,other-config
<!--NeedCopy-->

Um alle Parameter aufzulisten, verwenden Sie alternativ die Syntax:

xe vm-list params=all
<!--NeedCopy-->

Der Befehl list zeigt einige Parameter nicht an, deren Berechnung teuer ist. Diese Parameter werden beispielsweise wie folgt dargestellt:

allowed-VBD-devices (SRO): <expensive field>
<!--NeedCopy-->

Um diese Felder zu erhalten, verwenden Sie entweder die Befehlsklasse-param-list oder die Klasse-param-get

Um die Liste zu filtern, gleicht die CLI Parameterwerte mit den in der Befehlszeile angegebenen Werten ab und druckt nur Objekte, die allen angegebenen Einschränkungen entsprechen. Beispiel:

xe vm-list HVM-boot-policy="BIOS order" power-state=halted
<!--NeedCopy-->

Dieser Befehl listet nur die VMs auf, für die sowohl das Feld power-state den Wert halted hat als auch das Feld HVM-boot-policy den Wert BIOS order.

Sie können die Liste auch nach dem Wert von Schlüsseln in Maps oder nach dem Vorhandensein von Werten in einer Menge filtern. Die Syntax für das Filtern basierend auf Schlüsseln in Maps ist map-name:key=value. Die Syntax für das Filtern basierend auf Werten, die in einer Menge vorhanden sind, lautet set-name:contains=value.

Beim Scripting ist es eine nützliche Technik, --minimal an die Befehlszeile zu übergeben, wodurch xe nur das erste Feld in einer kommagetrennten Liste druckt. Beispielsweise gibt der Befehl xe vm-list --minimal auf einem Host mit drei installierten VMs die drei UUIDs der VMs an:

    a85d6717-7264-d00e-069b-3b1d19d56ad9,aaa3eec5-9499-bcf3-4c03-af10baea96b7, \
    42c044de-df69-4b30-89d9-2c199564581d
<!--NeedCopy-->

Secrets

Citrix Hypervisor bietet einen geheimen Mechanismus, um zu verhindern, dass Kennwörter im Befehlszeilenverlauf oder auf API-Objekten im Klartext gespeichert werden. XenCenter verwendet diese Funktion automatisch und kann auch über die xe CLI für jeden Befehl verwendet werden, der ein Kennwort erfordert.

Hinweis:

Kennwortgeheimnisse können nicht verwendet werden, um sich mit einem Citrix Hypervisor Host von einer Remote-Instanz der xe CLI aus zu authentifizieren.

Um ein geheimes Objekt zu erstellen, führen Sie den folgenden Befehl auf Ihrem Citrix Hypervisor-Host aus.

xe secret-create value=my-password
<!--NeedCopy-->

Ein Secret wird erstellt und auf dem Citrix Hypervisor Host gespeichert. Der Befehl gibt die UUID des geheimen Objekts aus. Beispiel: 99945d96-5890-de2a-3899-8c04ef2521db. Fügen Sie _secret an den Namen des Kennwortarguments an, um diese UUID an einen Befehl zu übergeben, der ein Kennwort erfordert.

Beispiel: Auf dem Citrix Hypervisor Host, auf dem Sie das Secret erstellt haben, können Sie den folgenden Befehl ausführen:

    xe sr-create device-config:location=sr_address device-config:type=cifs device-config:username=cifs_username  \
    device-config:cifspassword_secret=secret_uuid name-label="CIFS ISO SR" type="iso" content-type="iso" shared="true"
<!--NeedCopy-->

Befehlsverlauf

Einige XE-Befehle, zum Beispiel xe vm-migrate oder xe pool-enable-external-auth, nehmen Secrets wie Kennwörter als Parameter. Diese können im Shell-Verlauf enden und sind während der Ausführung des Befehls in der Prozesstabelle sichtbar. Es ist daher wichtig, diese Befehle nur in vertrauenswürdigen Umgebungen auszuführen.

Für die Bash-Shell können Sie die Variable HISTCONTROL verwenden, um zu steuern, welche Befehle im Shell-Verlauf gespeichert werden.

xe-Befehlsreferenz

In diesem Abschnitt werden die Befehle nach den Objekten gruppiert, die der Befehl adressiert. Diese Objekte sind alphabetisch aufgelistet.

Appliance-Befehle

Befehle zum Erstellen und Ändern von VM-Appliances (auch bekannt als vApps). Weitere Informationen finden Sie unter vApps.

Geräte-Parameter

Appliance-Befehle haben die folgenden Parameter:

Parametername Beschreibung Typ
uuid Die Appliance uuid Erforderlich
name-description Die Beschreibung des Geräts Optional
paused   Optional
force Herunterfahren erzwingen Optional

appliance-assert-can-be-recovered

xe appliance-assert-can-be-recovered uuid=appliance-uuid database:vdi-uuid=vdi-uuid
<!--NeedCopy-->

Testet, ob Speicher zur Wiederherstellung dieser VM Appliance/vApp verfügbar ist.

appliance-create

xe appliance-create name-label=name-label [name-description=name-description]
<!--NeedCopy-->

Erstellt eine Appliance/vApp. Beispiel:

xe appliance-create name-label=my_appliance
<!--NeedCopy-->

Hinzufügen von virtuellen Rechnern zur Appliance:

xe vm-param-set uuid=VM-UUID appliance=appliance-uuid
<!--NeedCopy-->

appliance-destroy

xe appliance-destroy uuid=appliance-uuid
<!--NeedCopy-->

Zerstört ein Gerät/eine vApp. Beispiel:

xe appliance-destroy uuid=appliance-uuid
<!--NeedCopy-->

appliance-recover

xe appliance-recover uuid=appliance-uuid database:vdi-uuid=vdi-uuid [paused=true|false]
<!--NeedCopy-->

Stellen Sie eine VM Appliance/vApp aus der Datenbank wieder her, die im bereitgestellten VDI enthalten ist.

appliance-shutdown

xe appliance-shutdown uuid=appliance-uuid [force=true|false]
<!--NeedCopy-->

Schließt alle virtuellen Maschinen in einer Appliance/vApp herunter. Beispiel:

xe appliance-shutdown uuid=appliance-uuid
<!--NeedCopy-->

appliance-start

xe appliance-start uuid=appliance-uuid [paused=true|false]
<!--NeedCopy-->

Startet eine Appliance/vApp. Beispiel:

xe appliance-start uuid=appliance-uuid
<!--NeedCopy-->

Befehle für die Prüfung

Mit Überwachungsbefehlen werden alle verfügbaren Datensätze der RBAC-Überwachungsdatei im Pool heruntergeladen. Wenn der optionale Parameter since vorhanden ist, werden nur die Datensätze von diesem bestimmten Zeitpunkt heruntergeladen.

audit-log-get-Parameter

audit-log-get hat die folgenden Parameter

Parametername Beschreibung Typ
filename Schreiben Sie das Überwachungsprotokoll des Pools in den Dateinamen Erforderlich
since Spezifischer Datum/Uhrzeit Optional

audit-log-get

xe audit-log-get [since=timestamp] filename=filename
<!--NeedCopy-->

Um beispielsweise Überwachungsaufzeichnungen des Pools seit einem genauen Millisekunden-Zeitstempel abzurufen, führen Sie den folgenden Befehl aus:

Führen Sie den folgenden Befehl aus:

xe audit-log-get since=2009-09-24T17:56:20.530Z filename=/tmp/auditlog-pool-actions.out
<!--NeedCopy-->

Bonding-Befehle

Befehle für die Arbeit mit Netzwerkbindungen, für Ausfallsicherheit bei Failover für physische Schnittstellen. Weitere Informationen finden Sie unter Netzwerk.

Das Bond-Objekt ist ein Referenzobjekt, das Master- und Member-PIFs miteinander verbindet. Der Master-PIF ist das Bonding-Interface, das als Gesamt-PIF verwendet werden muss, um sich auf die Bindung zu beziehen. Die Mitglied-PIFs sind ein Satz von zwei oder mehr physikalischen Schnittstellen, die zu der gebundenen High-Level-Schnittstelle kombiniert wurden.

Bond-Parameter

Bonds haben die folgenden Parameter:

Parametername Beschreibung Typ
uuid Eindeutige Identifikator/Objektreferenz für die Bindung Lesezugriff
master UUID für Masterbond-PIF Lesezugriff
members Satz von UUIDs für die zugrunde liegenden gebundenen PIFs Lesezugriff

bond-create

xe bond-create network-uuid=network_uuid pif-uuids=pif_uuid_1,pif_uuid_2,...
<!--NeedCopy-->

Erstellen Sie eine gebundene Netzwerkschnittstelle in dem Netzwerk, das aus einer Liste vorhandener PIF-Objekte angegeben ist. Der Befehl schlägt in einem der folgenden Fälle fehl:

  • Wenn PIFs bereits in einer anderen Bindung sind
  • Wenn bei einem Mitglied ein VLAN-Tag festgelegt ist
  • Wenn sich die referenzierten PIFs nicht auf demselben Citrix Hypervisor-Server befinden
  • Wenn weniger als 2 PIFs geliefert werden

bond-destroy

xe bond-destroy uuid=bond_uuid
<!--NeedCopy-->

Löscht eine gebundene Schnittstelle, die durch ihre UUID angegeben ist, von einem Host.

bond-set-mode

xe bond-set-mode uuid=bond_uuid mode=bond_mode
<!--NeedCopy-->

Ändern Sie den Bond-Modus.

CD-Befehle

Befehle zum Arbeiten mit physischen CD/DVD-Laufwerken auf Citrix Hypervisor-Servern.

CD-Parameter

CDs haben folgende Parameter:

Parametername Beschreibung Typ
uuid Eindeutige Identifikator/Objektreferenz für die CD Lesezugriff
name-label Name der CD Lese-/Schreibrechte
name-description Beschreibungstext für die CD Lese-/Schreibrechte
allowed-operations Eine Liste der Vorgänge, die auf dieser CD ausgeführt werden können Schreibgeschützter Parameter
current-operations Eine Liste der Vorgänge, die derzeit auf dieser CD ausgeführt werden Schreibgeschützter Parameter
sr-uuid Die eindeutige Identifikator/Objektreferenz für das SR, zu dem diese CD gehört Lesezugriff
sr-name-label Der Name für das SR, zu dem diese CD gehört Lesezugriff
vbd-uuids Eine Liste der eindeutigen Kennungen für die VBDs auf VMs, die mit dieser CD verbunden sind Schreibgeschützter Parameter
crashdump-uuids Wird nicht auf CDs verwendet. Weil Crashdumps nicht auf CDs geschrieben werden können Schreibgeschützter Parameter
virtual-size Größe der CD, wie sie für virtuelle Rechner erscheint (in Byte) Lesezugriff
physical-utilisation Menge an physischem Speicherplatz, den das CD-Image auf dem SR belegt (in Byte) Lesezugriff
type Für CDs auf Benutzer setzen Lesezugriff
sharable Ob das CD-Laufwerk gemeinsam genutzt werden kann oder nicht. Die Standardeinstellung ist false. Lesezugriff
read-only Ob die CD schreibgeschützt ist false, wenn das Gerät beschreibbar ist. Stimmt immer für CDs. Lesezugriff
storage-lock Der Wert ist true, wenn dieser Datenträger auf Speicherebene gesperrt ist. Lesezugriff
parent Verweis auf den übergeordnete Datenträger, falls diese CD Teil einer Kette ist. Lesezugriff
missing Wert ist true, wenn der SR-Scanvorgang diese CD als nicht auf dem Datenträger vorhanden gemeldet hat Lesezugriff
other-config Eine Liste von Schlüssel/Wert-Paaren, die zusätzliche Konfigurationsparameter für die CD angeben Map-Parameter lesen/schreiben
location Der Pfad, auf dem das Gerät montiert ist Lesezugriff
managed Wert ist true, wenn das Gerät verwaltet wird Lesezugriff
xenstore-data In den xenstore-Baum einzufügende Daten Schreibgeschützter Map-Parameter
sm-config Namen und Beschreibungen der Speichermanager-Gerätekonfigurationsschlüssel Schreibgeschützter Map-Parameter
is-a-snapshot Wert ist true, wenn diese Vorlage ein CD-Snapshot ist Lesezugriff
snapshot_of Die UUID der CD, von der diese Vorlage ein Snapshot ist Lesezugriff
snapshots Die UUIDs aller Snapshots, die von dieser CD aufgenommen wurden Lesezugriff
snapshot_time Der Zeitstempel des Snapshot-Vorgangs Lesezugriff

cd-list

xe cd-list [params=param1,param2,...] [parameter=parameter_value]
<!--NeedCopy-->

Listen Sie die CDs und ISOs (CD-Image-Dateien) auf dem Citrix Hypervisor-Server oder -Pool auf und filtern Sie nach dem optionalen Argument params.

Wenn das optionale Argument params verwendet wird, ist der Wert von params eine Zeichenfolge, die eine Liste von Parametern dieses Objekts enthält, die Sie anzeigen möchten. Alternativ können Sie das Schlüsselwort verwenden all, um alle Parameter anzuzeigen. Wenn params nicht verwendet wird, zeigt die zurückgegebene Liste eine Standard-Teilmenge aller verfügbaren Parameter an.

Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten CD-Parameter sein.

Cluster-Befehle

Befehle zum Arbeiten mit Clusterpools.

Clusterpools sind Ressourcenpools, für die die Clustering-Funktion aktiviert ist. Verwenden Sie diese Pools mit GFS2-SRs. Weitere Informationen finden Sie unter Clustered-Pools.

Die Cluster- und Clusterhost-Objekte können mit den Befehlen zur Standardobjektauflistung (xe cluster-list und xe cluster-host-list) und den mit den Standardparameterbefehlen manipulierten Parametern aufgeführt werden. Weitere Informationen finden Sie unter Parameterbefehle auf niedriger Ebene. Befehle zum Arbeiten mit Clusterpools.

Cluster-Parameter

Cluster haben die folgenden Parameter:

Parametername Beschreibung Typ
uuid Die eindeutige Bezeichner/Objektreferenz für den Cluster Lesezugriff
cluster-hosts Eine Liste von eindeutigen Bezeichnern/Objektreferenzen für die Hosts im Cluster Schreibgeschützter Parameter
cluster-token Der geheime Schlüssel, der verwendet wird xapi-clusterd, wenn es auf anderen Hosts mit sich selbst spricht Lesezugriff
cluster-stack Der Technologie-Stack, der die Cluster-Funktionen bereitstellt. Mögliche Werte sind corosync. Lesezugriff
allowed-operations Listet die in diesem Zustand zulässigen Vorgänge auf. Diese Liste ist nur eine Empfehlung und der Clusterstatus hat sich möglicherweise geändert, bis ein Client dieses Feld liest. Schreibgeschützter Parameter
current-operations Listet die aktuell laufenden Vorgänge auf. Diese Liste ist nur eine Empfehlung und der Clusterstatus hat sich möglicherweise geändert, bis ein Client dieses Feld liest. Schreibgeschützter Parameter
token-timeout Das corosync-Token-Timeout in Sekunden Lesezugriff
token-timeout-coefficient Der corosync-Token-Timeout-Koeffizient in Sekunden Lesezugriff
pool-auto-join True, wenn automatisch neue Poolmitglieder dem Cluster beitreten. Dies ist auf eingestellt true. Lesezugriff
cluster-config Eine Liste von Schlüssel/Wert-Paaren, die zusätzliche Konfigurationsparameter für den Cluster angeben. Schreibgeschützter Map-Parameter
other-config Eine Liste von Schlüssel/Wert-Paaren, die zusätzliche Konfigurationsparameter für den Cluster angeben. Map-Parameter lesen/schreiben

cluster-host-destroy

xe cluster-host-destroy uuid=host_uuid
<!--NeedCopy-->

Zerstören Sie einen Clusterhost und verlassen Sie effektiv den Cluster.

cluster-host-disable

xe cluster-host-disable uuid=cluster_uuid
<!--NeedCopy-->

Deaktivieren der Clustermitgliedschaft für einen aktivierten Clusterhost.

cluster-host-enable

xe cluster-host-enable uuid=cluster_uuid
<!--NeedCopy-->

Aktivieren der Clustermitgliedschaft für einen deaktivierten Clusterhost

cluster-host-force-destroy

xe cluster-host-force-destroy uuid=cluster_host
<!--NeedCopy-->

Zerstören Sie ein Clusterhostobjekt mit Nachdruck und verlassen Sie effektiv den Cluster

cluster-pool-create

xe cluster-pool-create network-uuid=network_uuid [cluster-stack=cluster_stack] [token-timeout=token_timeout] [token-timeout-coefficient=token_timeout_coefficient]
<!--NeedCopy-->

Erstellen Sie einen poolweiten Cluster.

cluster-pool-destroy

xe cluster-pool-destroy cluster-uuid=cluster_uuid
<!--NeedCopy-->

Zerstört den poolweiten Cluster. Der Pool ist weiterhin vorhanden, aber er ist nicht mehr geclustert und kann keine GFS2-SRs mehr verwenden.

cluster-pool-force-destroy

xe cluster-pool-force-destroy cluster-uuid=cluster_uuid
<!--NeedCopy-->

Erzwingen der Zerstörung des poolweiten Clusters.

cluster-pool-resync

xe cluster-pool-resync cluster-uuid=cluster_uuid
<!--NeedCopy-->

Synchronisieren Sie einen Cluster in einem Pool neu.

Befehle für die Konsole

Befehle zum Arbeiten mit Konsolen.

Die Konsolenobjekte können mit dem Standardbefehl für die Objektauflistung (xe console-list) aufgelistet werden, und die Parameter können mit den Standardparameterbefehlen bearbeitet werden. Weitere Informationen finden Sie unter Parameterbefehle auf niedriger Ebene.

Konsolen-Parameter

Konsolen haben die folgenden Parameter:

Parametername Beschreibung Typ
uuid Die eindeutige Bezeichner/Objektreferenz für die Konsole Lesezugriff
vm-uuid Die eindeutige Bezeichner/Objektreferenz der VM, auf der diese Konsole geöffnet ist Lesezugriff
vm-name-label Der Name der VM, auf der diese Konsole geöffnet ist Lesezugriff
protocol Protokoll, das diese Konsole verwendet. Mögliche Werte sind vt100: VT100-Terminal, rfb: Remote Framebuffer-Protokoll (wie in VNC verwendet) oder rdp: Remote Desktop Protocol Lesezugriff
location URI für den Konsolendienst Lesezugriff
other-config Eine Liste von Schlüssel/Wert-Paaren, die zusätzliche Konfigurationsparameter für die Konsole angeben. Map-Parameter lesen/schreiben

console

xe console
<!--NeedCopy-->

An einer bestimmten Konsole befestigen.

Diagnostische Befehle

Befehle zum Sammeln von Diagnoseinformationen von Citrix Hypervisor.

diagnostic-compact

xe diagnostic-compact
<!--NeedCopy-->

Führen Sie eine größere GC-Sammlung und Heap-Verdichtung durch.

VERALTET: diagnostic-db-log

xe diagnostic-db-log
<!--NeedCopy-->

Protokollieren Sie die Datenbankoperationen. Warnung: Einmal gestartet, kann dies nicht gestoppt werden.

diagnostic-db-stats

xe diagnostic-db-stats
<!--NeedCopy-->

Druckt Datenbankstatistiken.

diagnostic-gc-stats

xe diagnostic-gc-stats
<!--NeedCopy-->

GC-Statistiken drucken.

diagnostic-license-status

xe diagnostic-license-status
<!--NeedCopy-->

Hilft bei der Diagnose von poolweiten Lizenzproblemen.

diagnostic-net-stats

xe diagnostic-net-stats [uri=uri] [method=method] [params=param1,param2...]
<!--NeedCopy-->

Netzwerkstatistiken drucken.

diagnostic-timing-stats

xe diagnostic-timing-stats
<!--NeedCopy-->

Timing-Statistiken drucken.

diagnostic-vdi-status

xe diagnostic-vdi-status uuid=vdi_uuid
<!--NeedCopy-->

Fragen Sie den Sperr- und Freigabestatus eines VDI ab.

diagnostic-vm-status

xe diagnostic-vm-status uuid=vm_uuid
<!--NeedCopy-->

Fragen Sie die Hosts ab, auf denen die VM booten kann, und überprüfen Sie den Freigabe-/Sperrstatus aller VBDs.

Befehle zur Notfallwiederherstellung

Befehle zum Wiederherstellen von virtuellen Rechnern nach einer Katastrophe

drtask-create

xe drtask-create type=type sr-whitelist=sr-white-list device-config=device-config
<!--NeedCopy-->

Erstellt eine Disaster Recovery-Aufgabe. Um beispielsweise eine Verbindung zu einem iSCSI-SR in Vorbereitung auf die Notfallwiederherstellung herzustellen:

xe drtask-create type=lvmoiscsi device-config:target=target-ip-address \
    device-config:targetIQN=targetIQN device-config:SCSIid=SCSIid \
    sr-whitelist=sr-uuid-list
<!--NeedCopy-->

Hinweis:

Der Befehl sr-whitelist listet erlaubte SR-UUIDs auf. Der Befehl drtask-create führt nur ein SR ein und stellt eine Verbindung dazu her, das eine der zulässigen UUIDs hat

drtask-destroy

xe drtask-destroy uuid=dr-task-uuid
<!--NeedCopy-->

Zerstört eine Disaster Recovery-Aufgabe und vergisst das eingeführte SR.

vm-assert-can-be-recovered

xe vm-assert-can-be-recovered uuid=vm-uuid database:vdi-uuid=vdi-uuid
<!--NeedCopy-->

Testet, ob Speicher für die Wiederherstellung dieser VM verfügbar ist.

appliance-assert-can-be-recovered

xe appliance-assert-can-be-recovered uuid=appliance-uuid database:vdi-uuid=vdi-uuid
<!--NeedCopy-->

Überprüft, ob der Speicher (der die Appliance-/vApp-Disk enthält) sichtbar ist.

appliance-recover

xe appliance-recover uuid=appliance-uuid database:vdi-uuid=vdi-uuid [force=true|false]
<!--NeedCopy-->

Stellen Sie eine Appliance/vApp aus der Datenbank wieder her, die im mitgelieferten VDI enthalten ist.

vm-recover

xe vm-recover uuid=vm-uuid database:vdi-uuid=vdi-uuid [force=true|false]
<!--NeedCopy-->

Stellt eine VM aus der Datenbank wieder her, die im bereitgestellten VDI enthalten ist.

sr-enable-database-replication

xe sr-enable-database-replication uuid=sr_uuid
<!--NeedCopy-->

Ermöglicht die XAPI-Datenbankreplikation auf das angegebene (gemeinsame) SR.

sr-disable-database-replication

xe sr-disable-database-replication uuid=sr_uuid
<!--NeedCopy-->

Deaktiviert die XAPI-Datenbankreplikation auf das angegebene SR.

Beispiel Verwendung

Das folgende Beispiel zeigt die DR CLI-Befehle im Kontext:

Aktivieren Sie am primären Standort die Datenbankreplikation:

xe sr-database-replication uuid=sr=uuid
<!--NeedCopy-->

Stellen Sie nach einer Katastrophe am sekundären Standort eine Verbindung zum SR her. Der Befehl device-config hat dieselben Felder wie sr-probe.

xe drtask-create type=lvmoiscsi \
    device-config:target=target ip address \
    device-config:targetIQN=target-iqn \
    device-config:SCSIid=scsi-id \
    sr-whitelist=sr-uuid
<!--NeedCopy-->

Suchen Sie in dem SR nach Datenbank-VDIs:

xe vdi-list sr-uuid=sr-uuid type=Metadata
<!--NeedCopy-->

Abfrage eines Datenbank-VDI für vorhandene virtuelle Rechner:

xe vm-list database:vdi-uuid=vdi-uuid
<!--NeedCopy-->

Wiederherstellen einer VM:

xe vm-recover uuid=vm-uuid database:vdi-uuid=vdi-uuid
<!--NeedCopy-->

Zerstöre die DR-Aufgabe. Alle SRs, die durch die DR-Task eingeführt wurden und nicht von virtuellen Rechnern benötigt werden, werden vernichtet:

xe drtask-destroy uuid=drtask-uuid
<!--NeedCopy-->

Event-Befehle

Befehle zum Arbeiten mit Ereignissen.

Event-Kurse

Ereignisklassen sind in der folgenden Tabelle aufgeführt:

Name der Klasse Beschreibung
pool Ein Pool physischer Hosts
vm Eine virtuelle Maschine
host Ein physischer Host
network Ein virtuelles Netzwerk
vif Eine virtuelle Netzwerkschnittstelle
pif Eine physische Netzwerkschnittstelle (separate VLANs werden als mehrere PIFs dargestellt)
sr Ein Speicherrepository
vdi Ein virtuelles Disk-Image
vbd Ein virtuelles Blockgerät
pbd Die physischen Blockgeräte, über die Hosts auf SRs zugreifen

event-wait

xe event-wait class=class_name [param-name=param_value] [param-name=/=param_value]
<!--NeedCopy-->

Blockiert die Ausführung anderer Befehle, bis ein Objekt existiert, das die in der Befehlszeile angegebenen Bedingungen erfüllt. Das Argument x=y bedeutet “warte, bis Feld x den Wert y annimmt” und x=/=y bedeutet “warte, bis Feld x einen anderen Wert als y annimmt”.

Beispiel: Warten Sie, bis eine bestimmte VM ausgeführt wird.

xe event-wait class=vm name-label=myvm power-state=running
<!--NeedCopy-->

Blockiert andere Befehle, bis eine aufgerufene VM mit dem Namen myvm den power-state-Status “running” hat.

Beispiel: Warten Sie, bis eine bestimmte VM neu gestartet wurde:

xe event-wait class=vm uuid=$VM start-time=/=$(xe vm-list uuid=$VM params=start-time --minimal)
<!--NeedCopy-->

Sperrt andere Befehle, bis eine VM mit UUID $VM neu gestartet wird. Der Befehl verwendet den Wert von start-time, um zu entscheiden, wann die VM neu gestartet wird.

Der Klassenname kann eine der am Anfang dieses Abschnitts aufgeführten Ereignisklassen sein. Bei den Parametern kann es sich um einen der Parameter handeln, die in der CLI-Befehlsklasse-param-list aufgeführt sind.

GPU Befehle

Befehle zum Arbeiten mit physischen GPUs, GPU-Gruppen und virtuellen GPUs.

Die GPU-Objekte können mit den Standardbefehlen für die Objektauflistung aufgelistet werden: xe pgpu-listxe gpu-group-list, und xe vgpu-list. Die Parameter können mit den Standardparameterbefehlen manipuliert werden. Weitere Informationen finden Sie unter Parameterbefehle auf niedriger Ebene.

Physikalische GPU-Parameter

Physikalische GPUS (pGPUs) haben die folgenden Parameter:

Parametername Beschreibung Typ
uuid Die eindeutige Bezeichner/Objektreferenz für die pGPU Lesezugriff
vendor-name Der Herstellername der pGPU Lesezugriff
device-name Der vom Hersteller diesem pGPU Modell zugewiesene Name Lesezugriff
gpu-group-uuid Die eindeutige Bezeichner/Objektreferenz für die GPU-Gruppe, der diese pGPU automatisch von Citrix Hypervisor zugewiesen wurde. Identische pGPUs auf Hosts in einem Pool werden gruppiert Lesezugriff
gpu-group-name-label Der Name der GPU-Gruppe, der die pGPU zugewiesen ist Lesezugriff
host-uuid Die eindeutige Bezeichner/Objektreferenz für den Citrix Hypervisor-Server, mit dem die pGPU verbunden ist Lesezugriff
host-name-label Der Name des Citrix Hypervisor-Servers, mit dem die pGPU verbunden ist Lesezugriff
pci-id PCI-Kennung Lesezugriff
dependencies Listet die abhängigen PCI-Geräte auf, die an dieselbe VM weitergegeben wurden Map-Parameter lesen/schreiben
other-config Eine Liste von Schlüssel/Wert-Paaren, die zusätzliche Konfigurationsparameter für die pGPU angeben Map-Parameter lesen/schreiben
supported-VGPU-types Liste der virtuellen GPU-Typen, die von der zugrunde liegenden Hardware unterstützt werden Lesezugriff
enabled-VGPU-types Liste der virtuellen GPU-Typen, die für diese pGPU aktiviert wurden Lesen/Schreiben
resident-VGPUs Liste der vGPUs, die auf dieser pGPU ausgeführt werden Lesezugriff

pgpu-disable-dom0-access

xe pgpu-disable-dom0-access uuid=uuid
<!--NeedCopy-->

Deaktivieren Sie den pGPU Zugriff auf dom0.

pgpu-enable-dom0-access

xe pgpu-enable-dom0-access uuid=uuid
<!--NeedCopy-->

Ermöglichen Sie den pGPU Zugriff auf dom0.

GPU-Gruppenparameter

GPU-Gruppen haben die folgenden Parameter:

Parametername Beschreibung Typ
uuid Die eindeutige Bezeichner/Objektreferenz für die GPU-Gruppe Lesezugriff
name-label Der Name der GPU-Gruppe Lese-/Schreibrechte
name-description Der beschreibende Text der GPU-Gruppe Lese-/Schreibrechte
VGPU-uuids Listet die eindeutigen Bezeichner/Objektreferenzen für die virtuellen GPUs in der GPU-Gruppe auf Schreibgeschützter Parameter
PGPU-uuids Listet die eindeutigen Bezeichner/Objektreferenzen für die pGPUs in der GPU-Gruppe auf Schreibgeschützter Parameter
other-config Eine Liste von Schlüssel/Wert-Paaren, die zusätzliche Konfigurationsparameter für die GPU-Gruppe angeben Map-Parameter lesen/schreiben
supported-VGPU-types Vereinigung aller virtuellen GPU-Typen, die von der zugrunde liegenden Hardware unterstützt werden Lesezugriff
enabled-VGPU-types Vereinigung aller virtuellen GPU-Typen, die auf den zugrunde liegenden pGPUs aktiviert wurden Lesezugriff
allocation-algorithm Tiefen-zuerst/Breite-First-Einstellung für die Zuweisung virtueller GPUs auf pGPUs innerhalb der Gruppe Enum-Parameter mit Lese-/Schreibzugriff

GPU-Gruppenbetrieb

Befehle zum Arbeiten mit GPU-Gruppen

gpu-group-create
xe gpu-group-create name-label=name_for_group [name-description=description]
<!--NeedCopy-->

Erstellt eine neue (leere) GPU-Gruppe, in die pGPUs verschoben werden können.

gpu-group-destroy
xe gpu-group-destroy uuid=uuid_of_group
<!--NeedCopy-->

Zerstört die GPU-Gruppe; nur für leere Gruppen zulässig.

gpu-group-get-remaining-capacity
xe gpu-group-get-remaining-capacity uuid=uuid_of_group vgpu-type-uuid=uuid_of_vgpu_type
<!--NeedCopy-->

Gibt zurück, wie viele virtuelle GPUs des angegebenen Typs in dieser GPU-Gruppe instanziiert werden können.

gpu-group-param-set
xe gpu-group-param-set uuid=uuid_of_group allocation-algorithm=breadth-first|depth-first
<!--NeedCopy-->

Ändert den Algorithmus, den die GPU-Gruppe verwendet, um virtuelle GPUs zu pGPUs zuzuweisen.

gpu-group-param-get-uuid
xe gpu-group-param-get-uuid uuid=uuid_of_group param-name=supported-vGPU-types|enabled-vGPU-types
<!--NeedCopy-->

Gibt die unterstützten oder aktivierten Typen für diese GPU-Gruppe zurück.

Virtuelle GPU-Parameter

Virtuelle GPUs haben die folgenden Parameter:

Parametername Beschreibung Typ
uuid Die eindeutige Bezeichner/Objektreferenz für die virtuelle GPU Lesezugriff
vm-uuid Die eindeutige Bezeichner/Objektreferenz für die VM, der die virtuelle GPU zugewiesen ist Lesezugriff
vm-name-label Der Name der VM, der die virtuelle GPU zugewiesen ist Lesezugriff
gpu-group-uuid Die eindeutige Bezeichner/Objektreferenz für die GPU-Gruppe, in der die virtuelle GPU enthalten ist Lesezugriff
gpu-group-name-label Der Name der GPU-Gruppe, in der die virtuelle GPU enthalten ist Lesezugriff
currently-attached Wahr, wenn eine VM mit GPU-Passthrough läuft, andernfalls false Lesezugriff
other-config Eine Liste von Schlüssel/Wert-Paaren, die zusätzliche Konfigurationsparameter für die virtuelle GPU angeben Map-Parameter lesen/schreiben
type-uuid Die eindeutige Bezeichner/Objektreferenz für den virtuellen GPU-Typ dieser virtuellen GPU Map-Parameter lesen/schreiben
type-model-name Mit dem virtuellen GPU-Typ verknüpfter Modellname Lesezugriff

Typenparameter für virtuelle GPU

Hinweis:

GPU-Passthrough und virtuelle GPUs sind nicht mit Live-Migration, Storage-Live-Migration oder VM Suspend kompatibel, sofern nicht unterstützte Software und Grafikkarten von GPU-Anbietern vorhanden sind. Virtuelle Rechner ohne diese Unterstützung können nicht migriert werden, um Ausfallzeiten zu vermeiden. Informationen zur Kompatibilität von NVIDIA vGPU mit Livemigration, Speicher-Livemigration und VM Suspend finden Sie unter Grafik.

Virtuelle GPU-Typen haben die folgenden Parameter:

Parametername Beschreibung Typ
uuid Die eindeutige Bezeichner/Objektreferenz für den virtuellen GPU-Typ Lesezugriff
vendor-name Name des virtuellen GPU-Anbieters Lesezugriff
model-name Mit dem virtuellen GPU-Typ verknüpfter Modellname Lesezugriff
freeze-frame Frame-Puffergröße des virtuellen GPU-Typs in Byte Lesezugriff
max-heads Maximale Anzahl von Displays, die vom virtuellen GPU-Typ unterstützt werden Lesezugriff
supported-on-PGPUs Liste der pGPUs, die diesen virtuellen GPU-Typ unterstützen Lesezugriff
enabled-on-PGPUs Liste der pGPUs, für die dieser virtuelle GPU-Typ aktiviert ist Lesezugriff
VGPU-uuids Liste der virtuellen GPUs dieses Typs Lesezugriff

Virtueller GPU-Betrieb

vgpu-create

xe vgpu-create vm-uuid=uuid_of_vm gpu_group_uuid=uuid_of_gpu_group [vgpu-type-uuid=uuid_of_vgpu-type]
<!--NeedCopy-->

Erstellt eine virtuelle GPU. Dieser Befehl hängt die VM an die angegebene GPU-Gruppe an und gibt optional den virtuellen GPU-Typ an. Wenn kein virtueller GPU-Typ angegeben ist, wird der “Passthrough” -Typ angenommen.

vgpu-destroy

xe vgpu-destroy uuid=uuid_of_vgpu
<!--NeedCopy-->

Zerstört die angegebene virtuelle GPU.

Deaktivieren von VNC für VMs mit virtueller GPU

xe vm-param-add uuid=uuid_of_vmparam-name=platform vgpu_vnc_enabled=true|false
<!--NeedCopy-->

Mit false wird die VNC-Konsole für eine VM deaktiviert, während disablevnc=1 zum Anzeigeemulator weitergeleitet wird. Standardmäßig ist VNC aktiviert.

Host-Befehle

Befehle für die Interaktion mit dem Citrix Hypervisor-Server.

Citrix Hypervisor-Server sind die physischen Server, auf denen Citrix Hypervisor-Software ausgeführt wird. Auf ihnen laufen VMs unter der Kontrolle einer speziellen privilegierten virtuellen Maschine, die als Steuerdomäne oder Domäne 0 bekannt ist.

Die Citrix Hypervisor-Serverobjekte können mit den Befehlen der Standardobjektauflistung aufgeführt werden: xe host-listxe host-cpu-list, und xe host-crashdump-list). Die Parameter können mit den Standardparameterbefehlen manipuliert werden. Weitere Informationen finden Sie unter Parameterbefehle auf niedriger Ebene.

Host-Selektoren

Einige der hier aufgeführten Befehle haben einen gemeinsamen Mechanismus zum Auswählen eines oder mehrerer Citrix Hypervisor-Server, auf denen der Vorgang ausgeführt werden soll. Am einfachsten ist es, das Argument zu liefern host=uuid_or_name_label. Sie können Citrix Hypervisor auch angeben, indem Sie die vollständige Liste der Hosts nach den Werten von Feldern filtern. Wenn Sie beispielsweise enabled=true angeben, werden alle Citrix Hypervisor-Server ausgewählt, deren enabled-Feld gleich true ist. Wenn mehrere Citrix Hypervisor-Server übereinstimmen und der Vorgang auf mehreren Citrix Hypervisor-Servern ausgeführt werden kann, müssen Sie --multiple angeben, damit der Vorgang ausgeführt wird. Die vollständige Liste der Parameter, die abgeglichen werden können, wird am Anfang dieses Abschnitts beschrieben. Sie können diese Befehlsliste abrufen, indem Sie den Befehl ausführen xe host-list params=all. Wenn keine Parameter zur Auswahl von Citrix Hypervisor-Servern angegeben sind, wird der Vorgang auf allen Citrix Hypervisor-Servern ausgeführt.

Host-Parameter

Citrix Hypervisor-Server haben die folgenden Parameter:

Parametername Beschreibung Typ
uuid Die eindeutige Bezeichner/Objektreferenz für den Citrix Hypervisor-Server Lesezugriff
name-label Der Name des Citrix Hypervisor-Servers Lese-/Schreibrechte
name-description Die Beschreibungszeichenfolge des Citrix Hypervisor-Servers Lesezugriff
enabled Der Wert ist false, falls deaktiviert. Dies verhindert, dass neue VMs auf den Hosts gestartet werden, und bereitet die Hosts auf das Herunterfahren oder Neustarten vor. Wert ist true, wenn der Host aktiviert ist Lesezugriff
API-version-major Hauptversionsnummer Lesezugriff
API-version-minor Kleinere Versionsnummer Lesezugriff
API-version-vendor Identifizierung des API-Anbieters Lesezugriff
API-version-vendor-implementation Einzelheiten der Implementierung des Anbieters Schreibgeschützter Map-Parameter
logging Protokollierungskonfiguration Map-Parameter lesen/schreiben
suspend-image-sr-uuid Die eindeutige Kennung/Objektreferenz für das SR, in der suspendierte Images platziert werden Lese-/Schreibrechte
crash-dump-sr-uuid Die eindeutige Bezeichner/Objektreferenz für das SR, in der Absturzabbilder abgelegt werden Lese-/Schreibrechte
software-version Liste der Versionierungsparameter und ihrer Werte Schreibgeschützter Map-Parameter
capabilities Liste der Xen-Versionen, die der Citrix Hypervisor-Server ausführen kann Schreibgeschützter Parameter
other-config Eine Liste von Schlüssel/Wert-Paaren, die zusätzliche Konfigurationsparameter für den Citrix Hypervisor-Server angeben Map-Parameter lesen/schreiben
chipset-info Eine Liste von Schlüssel/Wert-Paaren, die Informationen über den Chipsatz angeben Schreibgeschützter Map-Parameter
hostname Citrix Hypervisor-Serverhostname Lesezugriff
address Citrix Hypervisor-Server-IP-Adresse Lesezugriff
license-server Eine Liste von Schlüssel/Wert-Paaren, die Informationen über den Lizenzserver angeben. Der Standardanschluss für die Kommunikation mit Citrix Produkten ist 27000. Informationen zum Ändern Port Portnummern aufgrund von Konflikten finden Sie unter Portnummern ändern Schreibgeschützter Map-Parameter
supported-bootloaders Liste der Bootloader, die der Citrix Hypervisor-Server unterstützt pygrub, z. B. eliloader Schreibgeschützter Parameter
memory-total Gesamtmenge des physischen Arbeitsspeichers auf dem Citrix Hypervisor-Server in Byte Lesezugriff
memory-free Gesamtmenge an verbleibendem physischem RAM, das virtuellen Rechnern zugewiesen werden kann, in Byte Lesezugriff
host-metrics-live True, wenn der Host betriebsbereit ist Lesezugriff
logging Der syslog_destination-Schlüssel kann auf den Hostnamen eines Syslog-Dienstes mit Remote-Listening festgelegt werden. Map-Parameter lesen/schreiben
allowed-operations Listet die in diesem Zustand zulässigen Vorgänge auf. Diese Liste ist nur eine Empfehlung und der Serverstatus hat sich möglicherweise geändert, bis ein Client dieses Feld liest. Schreibgeschützter Parameter
current-operations Listet die aktuell laufenden Vorgänge auf. Diese Liste ist nur eine Empfehlung und der Serverstatus hat sich möglicherweise geändert, bis ein Client dieses Feld liest. Schreibgeschützter Parameter
patches Satz von Host-Patches Schreibgeschützter Parameter
blobs Binärer Datenspeicher Lesezugriff
memory-free-computed Eine konservative Schätzung der maximalen Menge an freiem Speicher auf einem Host Lesezugriff
ha-statefiles Die UUIDs aller HA-State-Dateien Lesezugriff
ha-network-peers Die UUIDs aller Hosts, die bei einem Ausfall die VMs auf diesem Host hosten können Lesezugriff
external-auth-type Art der externen Authentifizierung, z. B. Active Directory. Lesezugriff
external-auth-service-name Der Name des externen Authentifizierungsdienstes Lesezugriff
external-auth-configuration Konfigurationsinformationen für den externen Authentifizierungsdienst. Schreibgeschützter Map-Parameter

Citrix Hypervisor-Server enthalten einige andere Objekte, die ebenfalls über Parameterlisten verfügen.

CPUs auf Citrix Hypervisor-Servern haben die folgenden Parameter:

Parametername Beschreibung Typ
uuid Die eindeutige Bezeichner/Objektreferenz für die CPU Lesezugriff
number Die Nummer des physischen CPU-Kerns innerhalb des Citrix Hypervisor-Servers Lesezugriff
vendor Die Herstellerzeichenfolge für den CPU-Namen Lesezugriff
speed Die CPU-Taktrate in Hz Lesezugriff
modelname Die Herstellerzeichenfolge für das CPU-Modell, z. B. “Intel (R) Xeon (TM) CPU 3,00 GHz” Lesezugriff
stepping Die CPU Revisionsnummer Lesezugriff
flags Die Flags der physischen CPU (eine decodierte Version des Feature-Feldes) Lesezugriff
Utilisation Die aktuelle CPU-Auslastung Lesezugriff
host-uuid Die UUID, wenn der Host, in dem sich die CPU befindet Lesezugriff
model Die Modellnummer der physikalischen CPU Lesezugriff
family Die Nummer der physischen CPU-Familie Lesezugriff

Absturzabbilder auf Citrix Hypervisor-Servern haben die folgenden Parameter:

Parametername Beschreibung Typ
uuid Die eindeutige Bezeichner/Objektreferenz für den Crashdump Lesezugriff
host Citrix Hypervisor-Server, dem der Crashdump entspricht Lesezugriff
timestamp Zeitstempel des Datums und der Uhrzeit, zu der der Crashdump aufgetreten ist, in der Form yyyymmdd-hhmmss-ABC, wobei ABC die Zeitzonenanzeige ist, zum Beispiel GMT Lesezugriff
size Größe des Crashdump in Byte Lesezugriff

host-all-editions

xe host-all-editions
<!--NeedCopy-->

Holen Sie sich eine Liste aller verfügbaren Editionen

host-apply-edition

xe host-apply-edition [host-uuid=host_uuid] [edition=xenserver_edition="free" "per-socket" "xendesktop"]
<!--NeedCopy-->

Weist die Citrix Hypervisor-Lizenz einem Hostserver zu. Wenn Sie eine Lizenz zuweisen, kontaktiert Citrix Hypervisor den Lizenzserver und fordert den angegebenen Lizenztyp an. Wenn eine Lizenz verfügbar ist, wird sie dann vom Lizenzserver ausgecheckt.

Verwenden Sie für Citrix Hypervisor für Citrix Virtual Desktops und DaaS-Editionen "xendesktop".

Informationen zur Erstkonfiguration der Lizenzierung finden Sie auch unter license-server-address und license-server-port.

host-backup

xe host-backup file-name=backup_filename host=host_name
<!--NeedCopy-->

Laden Sie eine Backup der Steuerdomäne des angegebenen Citrix Hypervisor-Servers auf den Computer herunter, von dem aus der Befehl aufgerufen wird. Speichern Sie es dort als Datei mit dem Namen file-name.

Wichtig:

Der Befehl xe host-backup funktioniert zwar, wenn er auf dem lokalen Host ausgeführt wird (d. h. ohne Angabe eines bestimmten Hostnamens). Sie sollten ihn jedoch nicht auf diese Weise verwenden. Dadurch würde die Steuerdomänenpartition mit der Backupdatei aufgefüllt. Verwenden Sie den Befehl nur von einer remoten Maschine, die nicht auf dem Host ist, und auf der Sie Platz für die Backupdatei haben.

host-bugreport-upload

xe host-bugreport-upload [host-selector=host_selector_value...] [url=destination_url http-proxy=http_proxy_name]
<!--NeedCopy-->

Generieren Sie einen neuen Fehlerbericht (mit xen-bugtool, alle optionalen Dateien eingeschlossen) und laden Sie ihn auf die FTP-Site des Supports oder an einen anderen Ort hoch.

Die Hosts, auf denen dieser Vorgang ausgeführt werden soll, werden mithilfe des Standardauswahlmechanismus ausgewählt (siehe Host-Selektoren oben). Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten Host-Parameter sein.

Optionale Parameter sind http-proxy: angegebenen HTTP-Proxy verwenden und url: auf diese Ziel-URL hochladen. Wenn optionale Parameter nicht verwendet werden, wird kein Proxyserver identifiziert und das Ziel ist die standardmäßige FTP-Support-Site.

host-call-plugin

xe host-call-plugin host-uuid=host_uuid plugin=plugin fn=function [args=args]
<!--NeedCopy-->

Ruft die Funktion innerhalb des Plug-Ins auf dem angegebenen Host mit optionalen Argumenten auf.

host-compute-free-memory

xe host-compute-free-memory
<!--NeedCopy-->

Berechnet die Menge an freiem Speicher auf dem Host.

host-compute-memory-overhead

xe host-compute-memory-overhead
<!--NeedCopy-->

Berechnet den Virtualisierungsspeicher-Overhead eines Hosts.

host-cpu-info

xe host-cpu-info [uuid=uuid]
<!--NeedCopy-->

Listet Informationen über die physischen CPUs des Hosts auf.

host-crashdump-destroy

xe host-crashdump-destroy uuid=crashdump_uuid
<!--NeedCopy-->

Löschen Sie einen Host-Crashdump, der durch seine UUID angegeben ist, vom Citrix Hypervisor-Server.

host-crashdump-upload

xe host-crashdump-upload uuid=crashdump_uuid [url=destination_url] [http-proxy=http_proxy_name]
<!--NeedCopy-->

Laden Sie einen Crashdump auf die FTP-Site des Supports oder an einem anderen Wenn optionale Parameter nicht verwendet werden, wird kein Proxyserver identifiziert und das Ziel ist die standardmäßige FTP-Support-Site. Optionale Parameter sind http-proxy: angegebenen HTTP-Proxy verwenden und url: auf diese Ziel-URL hochladen.

host-declare-dead

xe host-declare-dead uuid=host_uuid
<!--NeedCopy-->

Erklären Sie, dass der Host tot ist, ohne ihn explizit zu kontaktieren.

Warnung:

Dieser Aufruf ist gefährlich und kann zu Datenverlust führen, wenn der Host nicht wirklich tot ist.

host-disable

xe host-disable [host-selector=host_selector_value...]
<!--NeedCopy-->

Deaktiviert die angegebenen Citrix Hypervisor-Server, wodurch verhindert wird, dass neue VMs auf ihnen gestartet werden. Diese Aktion bereitet die Citrix Hypervisor-Server auf das Herunterfahren oder Neustarten vor. Wenn nach dem Neustart des Hosts alle Bedingungen für die Aktivierung erfüllt sind (z. B. ist Speicher verfügbar), wird der Host automatisch wieder aktiviert.

Die Hosts, auf denen dieser Vorgang ausgeführt werden soll, werden mithilfe des Standardauswahlmechanismus ausgewählt (siehe Host-Selektoren). Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten Host-Parameter sein.

host-disable-display

xe host-disable-display uuid=host_uuid
<!--NeedCopy-->

Deaktiviert die Anzeige für den Host.

host-disable-local-storage-caching

xe host-disable-local-storage-caching
<!--NeedCopy-->

Deaktivieren Sie das lokale Speichercaching auf dem angegebenen Host.

host-dmesg

xe host-dmesg [host-selector=host_selector_value...]
<!--NeedCopy-->

Rufen Sie Xen dmesg (die Ausgabe des Kernelringpuffers) von angegebenen Citrix Hypervisor-Servern ab.

Die Hosts, auf denen dieser Vorgang ausgeführt werden soll, werden mithilfe des Standardauswahlmechanismus ausgewählt (siehe Host-Selektoren oben). Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten Host-Parameter sein.

host-emergency-ha-disable

xe host-emergency-ha-disable  [--force]
<!--NeedCopy-->

Deaktivieren Sie HA auf dem lokalen Host. Nur zur Wiederherstellung eines Pools mit einem defekten HA-Setup verwendet werden.

host-emergency-management-reconfigure

xe host-emergency-management-reconfigure interface=uuid_of_management_interface_pif
<!--NeedCopy-->

Konfigurieren Sie die Verwaltungsschnittstelle dieses Citrix Hypervisor-Servers neu. Verwenden Sie diesen Befehl nur, wenn sich der Citrix Hypervisor-Server im Notfallmodus befindet. Notfallmodus bedeutet, dass der Host Mitglied in einem Ressourcenpool ist, dessen Master aus dem Netzwerk verschwunden ist und nach mehreren Wiederholungsversuchen nicht kontaktiert werden kann.

host-emergency-reset-server-certificate

xe host-emergency-reset-server-certificate
<!--NeedCopy-->

Installiert ein selbstsigniertes Zertifikat auf dem Citrix Hypervisor-Server, auf dem der Befehl ausgeführt wird.

host-enable

xe host-enable [host-selector=host_selector_value...]
<!--NeedCopy-->

Aktiviert die angegebenen Citrix Hypervisor-Server, sodass neue VMs auf ihnen gestartet werden können.

Die Hosts, auf denen dieser Vorgang ausgeführt werden soll, werden mithilfe des Standardauswahlmechanismus ausgewählt (siehe Host-Selektoren oben). Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten Host-Parameter sein.

host-enable-display

xe host-enable-display uuid=host_uuid
<!--NeedCopy-->

Aktiviert die Anzeige für den Host.

host-enable-local-storage-caching

xe host-enable-local-storage-caching  sr-uuid=sr_uuid
<!--NeedCopy-->

Aktiviert das lokale Speichercaching auf dem angegebenen Host.

host-evacuate

xe host-evacuate [host-selector=host_selector_value...]
<!--NeedCopy-->

Live migriert alle laufenden VMs auf andere geeignete Hosts in einem Pool. Deaktivieren Sie zunächst den Host mit dem Befehl host-disable.

Wenn der evakuierte Host der Poolmaster ist, muss ein anderer Host als Poolmaster ausgewählt werden. Um den Poolmaster mit deaktivierter HA zu ändern, verwenden Sie den Befehl pool-designate-new-master. Weitere Informationen finden Sie unter Pool-designiert-neuer-Master.

Wenn HA aktiviert ist, besteht Ihre einzige Option darin, den Server herunterzufahren, wodurch HA nach dem Zufallsprinzip einen neuen Master auswählt. Weitere Informationen finden Sie unter Host-shutdown.

Die Hosts, auf denen dieser Vorgang ausgeführt werden soll, werden mithilfe des Standardauswahlmechanismus ausgewählt (siehe Host-Selektoren oben). Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten Host-Parameter sein.

host-forget

xe host-forget uuid=host_uuid
<!--NeedCopy-->

Der XAPI-Agent vergisst den angegebenen Citrix Hypervisor-Server, ohne ihn explizit zu kontaktieren.

Verwenden Sie den Parameter --force, um zu vermeiden, dass Sie aufgefordert werden, zu bestätigen, dass Sie diesen Vorgang wirklich ausführen möchten.

Warnung:

Verwenden Sie diesen Befehl nicht, wenn HA für den Pool aktiviert ist. Deaktivieren Sie zuerst HA und aktivieren Sie sie dann erneut, nachdem Sie den Host vergessen haben.

Dieser Befehl ist nützlich, wenn der Citrix Hypervisor-Server zum “Vergessen” tot ist. Wenn der Citrix Hypervisor-Server jedoch live und Teil des Pools ist, verwenden Sie stattdessen xe pool-eject.

host-get-server-certificate

xe host-get-server-certificate
<!--NeedCopy-->

Holen Sie sich das TLS-Zertifikat des installierten Servers.

host-get-sm-diagnostics

xe host-get-sm-diagnostics uuid=uuid
<!--NeedCopy-->

SM-Diagnoseinformationen pro Host anzeigen.

host-get-system-status

xe host-get-system-status filename=name_for_status_file [entries=comma_separated_list] [output=tar.bz2|zip] [host-selector=host_selector_value...]
<!--NeedCopy-->

Laden Sie Systemstatusinformationen in die angegebene Datei herunter. Der optionale Parameter entries ist eine kommagetrennte Liste von Systemstatuseinträgen, die dem vom Befehl host-get-system-status-capabilities zurückgegebenen XML-Fragment der Fähigkeiten entnommen wurden. Weitere Informationen finden Sie unter Host-Get-Systemstatus-Funktionen. Wenn nicht angegeben, werden alle Systemstatusinformationen in der Datei gespeichert. Der Parameter output kann tar.bz2 (die Standardeinstellung) oder zipsein. Wenn dieser Parameter nicht angegeben ist, wird die Datei im tar.bz2-Format gespeichert.

Die Hosts, auf denen dieser Vorgang ausgeführt werden soll, werden mithilfe des Standardauswahlmechanismus ausgewählt (siehe Host-Selektoren oben).

host-get-system-status-capabilities

xe host-get-system-status-capabilities [host-selector=host_selector_value...]
<!--NeedCopy-->

Ruft Systemstatus-Funktionen für die angegebenen Hosts ab. Die Funktionen werden als XML-Fragment zurückgegeben, das dem folgenden Beispiel ähnelt:

<?xml version="1.0" ?>
<system-status-capabilities>
    <capability content-type="text/plain" default-checked="yes" key="xenserver-logs"  \
        max-size="150425200" max-time="-1" min-size="150425200" min-time="-1" \
        pii="maybe"/>
    <capability content-type="text/plain" default-checked="yes" \
        key="xenserver-install" max-size="51200" max-time="-1" min-size="10240" \
        min-time="-1" pii="maybe"/>
    ...
</system-status-capabilities>
<!--NeedCopy-->

Jede Capability-Entität kann die folgenden Attribute haben.

  • key Eine eindeutige Kennung für die Funktion.
  • content-type Kann entweder Text/Normaltext oder Anwendung/Daten sein. Zeigt an, ob eine UI die Einträge für den menschlichen Verzehr rendern kann.
  • default-checked Kann entweder Ja oder Nein sein. Gibt an, ob eine Benutzeroberfläche diesen Eintrag standardmäßig auswählt.
  • min-size, max-size Gibt einen ungefähren Bereich für die Größe dieses Eintrags in Byte an. -1 bedeutet, dass die Größe unwichtig ist.
  • min-time, max-time Gibt einen ungefähren Bereich für die Zeit in Sekunden an, die zum Erfassen dieses Eintrags benötigt wird. -1 zeigt an, dass die Zeit unwichtig ist.
  • pii Personenbezogene Daten. Zeigt an, ob der Eintrag Informationen enthält, die den Systembesitzer oder Details seiner Netzwerktopologie identifizieren können. Das Attribut kann einen der folgenden Werte annehmen:

    • no: In diesen Einträgen sind keine PII enthalten
    • yes: PII ist wahrscheinlich oder sicher in diesen Einträgen
    • maybe: Vielleicht möchten Sie diese Einträge auf PII überprüfen
    • if_customized wenn die Dateien unverändert sind, enthalten sie keine PII. Da wir jedoch die Bearbeitung dieser Dateien fördern, wurde PII möglicherweise durch eine solche Anpassung eingeführt. Dieser Wert wird insbesondere für die Netzwerkskripte in der Steuerdomäne verwendet.

    Kennwörter dürfen niemals in einen Fehlerbericht aufgenommen werden, unabhängig von einer PII-Deklaration.

Die Hosts, auf denen dieser Vorgang ausgeführt werden soll, werden mithilfe des Standardauswahlmechanismus ausgewählt (siehe Host-Selektoren oben).

host-get-thread-diagnostics

xe host-get-thread-diagnostics uuid=uuid
<!--NeedCopy-->

Zeigt Diagnoseinformationen für Threads pro Host an.

host-get-vms-which-prevent-evacuation

xe host-get-vms-which-prevent-evacuation uuid=uuid
<!--NeedCopy-->

Gibt eine Liste von virtuellen Rechnern zurück, die die Evakuierung eines bestimmten Hosts verhindern, und zeigt die Gründe für jeden einzelnen an.

host-is-in-emergency-mode

xe host-is-in-emergency-mode
<!--NeedCopy-->

Gibt true zurück, wenn der Host, mit dem die CLI kommuniziert, im Notfallmodus ist, andernfalls false. Dieser CLI-Befehl funktioniert direkt auf Poolmitgliedsservern, auch wenn kein Masterserver vorhanden ist.

host-license-add

xe host-license-add [license-file=path/license_filename] [host-uuid=host_uuid]
<!--NeedCopy-->

Verwenden Sie für Citrix Hypervisor (kostenlose Version), um eine lokale Lizenzdatei zu analysieren und sie dem angegebenen Citrix Hypervisor-Server hinzuzufügen.

host-license-remove

xe host-license-remove [host-uuid=host_uuid]
<!--NeedCopy-->

Entfernen Sie alle auf einen Host angewendeten Lizenzen.

host-license-view

xe host-license-view [host-uuid=host_uuid]
<!--NeedCopy-->

Zeigt den Inhalt der Citrix Hypervisor-Serverlizenz an.

host-logs-download

xe host-logs-download [file-name=logfile_name] [host-selector=host_selector_value...]
<!--NeedCopy-->

Laden Sie eine Kopie der Protokolle der angegebenen Citrix Hypervisor-Server herunter. Die Kopie wird standardmäßig in einer Datei mit Zeitstempel namens gespeichert hostname-yyyy-mm-dd T hh:mm:ssZ.tar.gz. Mit dem optionalen Parameter file-name können Sie einen anderen Dateinamen angeben.

Die Hosts, auf denen dieser Vorgang ausgeführt werden soll, werden mithilfe des Standardauswahlmechanismus ausgewählt (siehe Host-Selektoren oben). Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten Host-Parameter sein.

Wichtig:

Der Befehl xe host-logs-download funktioniert zwar, wenn er auf dem lokalen Host ausgeführt wird (d. h. ohne Angabe eines bestimmten Hostnamens). Sie sollten ihn jedoch nicht auf diese Weise verwenden. Dadurch wird die Steuerdomänenpartition mit der Kopie der Protokolle überladen. Verwenden Sie den Befehl nur von einem Remote-Off-Host-Computer aus, auf dem Sie Speicherplatz für die Kopie der Protokolle haben.

host-management-disable

xe host-management-disable
<!--NeedCopy-->

Deaktiviert den Host-Agent, der auf einer externen Verwaltungsnetzwerkschnittstelle lauscht, und trennt alle verbundenen API-Clients (z. B. XenCenter). Dieser Befehl wird direkt auf dem Citrix Hypervisor-Server ausgeführt, mit dem die CLI verbunden ist. Der Befehl wird nicht an den Poolmaster weitergeleitet, wenn er auf einen Citrix Hypervisor-Mitgliedsserver angewendet wird.

Warnung:

Seien Sie vorsichtig, wenn Sie diesen CLI-Befehl außerhalb des Hosts verwenden. Nachdem dieser Befehl ausgeführt wurde, können Sie sich nicht remote über das Netzwerk mit der Steuerdomäne verbinden, um den Host-Agent erneut zu aktivieren.

host-management-reconfigure

xe host-management-reconfigure [interface=device] [pif-uuid=uuid]
<!--NeedCopy-->

Konfiguriert den Citrix Hypervisor-Server neu, um die angegebene Netzwerkschnittstelle als Verwaltungsschnittstelle zu verwenden. Dies ist die Schnittstelle, die für die Verbindung mit dem XenCenter verwendet wird. Der Befehl schreibt den Schlüssel MANAGEMENT_INTERFACE um /etc/xensource-inventory.

Wenn der Gerätename einer Schnittstelle (die eine IP-Adresse haben muss) angegeben wird, bindet der Citrix Hypervisor-Server sofort neu. Dieser Befehl funktioniert sowohl im Normal- als auch im Notfallmodus.

Wenn die UUID eines PIF-Objekts angegeben ist, bestimmt der Citrix Hypervisor-Server, welche IP-Adresse an sich selbst neu gebunden werden soll. Es darf sich nicht im Notfallmodus befinden, wenn dieser Befehl ausgeführt wird.

Warnung:

Seien Sie vorsichtig, wenn Sie diesen CLI-Befehl außerhalb des Hosts verwenden, und stellen Sie sicher, dass die neue Schnittstelle über Netzwerkkonnektivität verfügt. Verwenden Sie xe pif-reconfigure zum Einrichten. Andernfalls können nachfolgende CLI-Befehle den Citrix Hypervisor-Server nicht erreichen.

host-power-on

xe host-power-on [host=host_uuid]
<!--NeedCopy-->

Schaltet Citrix Hypervisor-Server mit aktivierter Host-Einschaltfunktion ein. Bevor Sie diesen Befehl verwenden, aktivieren Sie host-set-power-on auf dem Host.

host-reboot

xe host-reboot [host-selector=host_selector_value...]
<!--NeedCopy-->

Starten Sie die angegebenen Citrix Hypervisor-Server neu. Die angegebenen Hosts müssen zuerst mit dem Befehl xe host-disable deaktiviert werden, andernfalls wird eine Fehlermeldung HOST_IN_USEangezeigt.

Die Hosts, auf denen dieser Vorgang ausgeführt werden soll, werden mithilfe des Standardauswahlmechanismus ausgewählt (siehe Host-Selektoren oben). Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten Host-Parameter sein.

Wenn die angegebenen Citrix Hypervisor-Server Mitglieder eines Pools sind, wird der Verbindungsverlust beim Herunterfahren behandelt und der Pool wird wiederhergestellt, wenn die Citrix Hypervisor-Server zurückkehren. Die anderen Mitglieder und der Master funktionieren weiterhin.

Wenn Sie den Master herunterfahren, ist der Pool außer Betrieb, bis eine der folgenden Aktionen eintritt:

  • Du machst eines der Mitglieder zum Master
  • Der ursprüngliche Master wird neu gestartet und ist wieder online.

    Wenn der Master wieder online ist, verbinden sich die Mitglieder erneut und synchronisieren sich mit dem Master.

host-restore

xe host-restore [file-name=backup_filename] [host-selector=host_selector_value...]
<!--NeedCopy-->

Stellen Sie eine Backup mit dem Namen file-name der Citrix Hypervisor-Serversteuerungssoftware wieder her. Die Verwendung des Wortes “Wiederherstellen” bedeutet hier keine vollständige Wiederherstellung im üblichen Sinne, sondern bedeutet lediglich, dass die komprimierte Backupdatei dekomprimiert und auf die sekundäre Partition entpackt wurde. Nachdem Sie xe host-restore abgeschlossen haben, müssen Sie die Installations-CD starten und die Option Wiederherstellen von Backup verwenden.

Die Hosts, auf denen dieser Vorgang ausgeführt werden soll, werden mithilfe des Standardauswahlmechanismus ausgewählt (siehe Host-Selektoren oben). Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten Host-Parameter sein.

host-send-debug-keys

xe host-send-debug-keys  host-uuid=host_uuid keys=keys
<!--NeedCopy-->

Sendet angegebene Hypervisor-Debug-Schlüssel an den angegebenen Host.

host-server-certificate-install

xe host-server-certificate-install certificate=path_to_certificate_file private-key=path_to_private_key [certificate-chain=path_to_chain_file] [host=host_name | uuid=host_uuid]
<!--NeedCopy-->

Installieren Sie ein TLS-Zertifikat auf einem Citrix Hypervisor-Server.

host-set-hostname-live

xe host-set-hostname-live host-uuid=uuid_of_host host-name=new_hostname
<!--NeedCopy-->

Ändern Sie den Hostnamen des mit host-uuid angegebenen Citrix Hypervisor-Servers. Dieser Befehl legt sowohl den Hostnamen in der Kontrolldomänendatenbank als auch den tatsächlichen Linux-Hostnamen des Citrix Hypervisor-Servers dauerhaft fest. Der Wert von host-name ist nicht mit dem Wert des Feldes name_label identisch.

host-set-power-on-mode

xe host-set-power-on-mode host=host_uuid power-on-mode={"" | "wake-on-lan" | "DRAC" | "custom"} \
    [ power-on-config:power_on_ip=ip-address power-on-config:power_on_user=user power-on-config:power_on_password_secret=secret-uuid ]
<!--NeedCopy-->

Verwenden Sie diese Option, um die Host-Einschaltfunktion auf Citrix Hypervisor-Hosts zu aktivieren, die mit Remote-Energielösungen kompatibel sind. Wenn Sie den Befehl host-set-power-on verwenden, müssen Sie den Typ der Energieverwaltungslösung auf dem Host angeben (d. h. den Einschaltmodus). Geben Sie dann die Konfigurationsoptionen mit dem Argument power-on-config und den zugehörigen Schlüssel-Wert-Paaren an.

Geben Sie den Schlüssel "power_on_password_secret" an, um die Funktion “Geheimnisse” zum Speichern Ihres Kennworts zu verwenden. Weitere Informationen finden Sie unter Secrets.

host-shutdown

xe host-shutdown [host-selector=host_selector_value...]
<!--NeedCopy-->

Fahren Sie die angegebenen Citrix Hypervisor-Server herunter. Die angegebenen Citrix Hypervisor-Server müssen zuerst mit dem Befehl xe host-disable deaktiviert werden, andernfalls wird eine Fehlermeldung HOST_IN_USE angezeigt.

Die Hosts, auf denen dieser Vorgang ausgeführt werden soll, werden mithilfe des Standardauswahlmechanismus ausgewählt (siehe Host-Selektoren oben). Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten Host-Parameter sein.

Wenn die angegebenen Citrix Hypervisor-Server Mitglieder eines Pools sind, wird der Verbindungsverlust beim Herunterfahren behandelt und der Pool wird wiederhergestellt, wenn die Citrix Hypervisor-Server zurückkehren. Die anderen Mitglieder und der Master funktionieren weiterhin.

Wenn Sie den Master herunterfahren, ist der Pool außer Betrieb, bis eine der folgenden Aktionen eintritt:

  • Du machst eines der Mitglieder zum Master
  • Der ursprüngliche Master wird neu gestartet und ist wieder online.

    Wenn der Master wieder online ist, verbinden sich die Mitglieder erneut und synchronisieren sich mit dem Master.

Wenn HA für den Pool aktiviert ist, wird eines der Mitglieder automatisch zum Master gemacht. Wenn HA deaktiviert ist, müssen Sie den gewünschten Server mit dem Befehlpool-designate-new-master manuell als Master festlegen. Weitere Informationen finden Sie unter Pool-designiert-neuer-Master.

host-sm-dp-destroy

xe host-sm-dp-destroy uuid=uuid dp=dp [allow-leak=true|false]
<!--NeedCopy-->

Versuch, einen Speicherdatenpfad auf einem Host zu zerstören und zu bereinigen. Wenn allow-leak=true angegeben wird, löscht es alle Datensätze des Datenpfads, auch wenn er nicht sauber heruntergefahren wurde.

host-sync-data

xe host-sync-data
<!--NeedCopy-->

Synchronisieren Sie die auf dem Poolmaster gespeicherten Daten mit dem benannten Host. Dies beinhaltet nicht die Datenbankdaten).

host-syslog-reconfigure

xe host-syslog-reconfigure [host-selector=host_selector_value...]
<!--NeedCopy-->

Konfigurieren Sie den syslog-Daemon auf den angegebenen Citrix Hypervisor-Servern neu. Mit diesem Befehl werden die Konfigurationsinformationen angewendet, die im logging-Hostparameter definiert sind.

Die Hosts, auf denen dieser Vorgang ausgeführt werden soll, werden mithilfe des Standardauswahlmechanismus ausgewählt (siehe Host-Selektoren oben). Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten Host-Parameter sein.

host-data-source-list

xe host-data-source-list [host-selectors=host selector value...]
<!--NeedCopy-->

Listen Sie die Datenquellen auf, die für einen Host aufgezeichnet werden können.

Wählen Sie die Hosts aus, auf denen dieser Vorgang ausgeführt werden soll, indem Sie den Standardauswahlmechanismus verwenden (siehe Host-Selektoren). Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten Host-Parameter sein. Wenn keine Parameter zur Auswahl von Hosts angegeben sind, wird der Vorgang auf allen Hosts ausgeführt.

Datenquellen haben zwei Parameter — standard und enabled. Dieser Befehl gibt die Werte der Parameter aus:

  • Wenn in einer Datenquelle enabled auf true festgelegt wurde, werden die Metriken derzeit in der Performance-Datenbank aufgezeichnet.
  • Wenn in einer Datenquelle standard auf true eingestellt ist, werden die Metriken standardmäßigin der Performance-Datenbank aufgezeichnet. Der Wert von enabled ist auch für diese Datenquelle auf true festgelegt.
  • Wenn für eine Datenquelle standard auf false eingestellt ist, werden die Metriken nicht standardmäßig in der Performance-Datenbank aufgezeichnet. Der Wert von enabled ist auch für diese Datenquelle auf false festgelegt.

Führen Sie den Befehl host-data-source-record aus, um die Aufzeichnung von Datenquellenmetriken in der Performance-Datenbank zu starten. Mit diesem Befehl wird enabled auf true festgelegt. Um aufzuhören, führe das aus host-data-source-forget. Mit diesem Befehl wird enabled auf false festgelegt.

host-data-source-record

xe host-data-source-record data-source=name_description_of_data_source [host-selectors=host_selector_value...]
<!--NeedCopy-->

Notieren Sie die angegebene Datenquelle für einen Host.

Bei diesem Vorgang werden die Informationen aus der Datenquelle in die Datenbank der persistenten Leistungsmetriken der angegebenen Hosts geschrieben. Aus Leistungsgründen unterscheidet sich diese Datenbank von der normalen Agentdatenbank.

Wählen Sie die Hosts aus, auf denen dieser Vorgang ausgeführt werden soll, indem Sie den Standardauswahlmechanismus verwenden (siehe Host-Selektoren). Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten Host-Parameter sein. Wenn keine Parameter zur Auswahl von Hosts angegeben sind, wird der Vorgang auf allen Hosts ausgeführt.

host-data-source-forget

xe host-data-source-forget data-source=name_description_of_data_source [host-selectors=host_selector_value...]
<!--NeedCopy-->

Beenden Sie die Aufzeichnung der angegebenen Datenquelle für einen Host und vergessen Sie alle aufgezeichneten Daten.

Wählen Sie die Hosts aus, auf denen dieser Vorgang ausgeführt werden soll, indem Sie den Standardauswahlmechanismus verwenden (siehe Host-Selektoren). Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten Host-Parameter sein. Wenn keine Parameter zur Auswahl von Hosts angegeben sind, wird der Vorgang auf allen Hosts ausgeführt.

host-data-source-query

xe host-data-source-query data-source=name_description_of_data_source [host-selectors=host_selector_value...]
<!--NeedCopy-->

Zeigt die angegebene Datenquelle für einen Host an.

Wählen Sie die Hosts aus, auf denen dieser Vorgang ausgeführt werden soll, indem Sie den Standardauswahlmechanismus verwenden (siehe Host-Selektoren). Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten Host-Parameter sein. Wenn keine Parameter zur Auswahl von Hosts angegeben sind, wird der Vorgang auf allen Hosts ausgeführt.

VERALTET: Protokollbefehle

Befehle zum Arbeiten mit Protokollen.

VERALTET: log-get

xe log-get
<!--NeedCopy-->

Gibt das aktuell im String-Logger gespeicherte Protokoll zurück.

VERALTET: log-get-keys

xe log-get-keys
<!--NeedCopy-->

Listen Sie die vom Logger bekannten Schlüssel auf.

VERALTET: log-reopen

xe log-reopen
<!--NeedCopy-->

Öffnen Sie alle Logger erneut (verwenden Sie dies zum Drehen von Dateien).

VERALTET: log-set-output

xe log-set-output output=output [key=key] [level=level]
<!--NeedCopy-->

Setzt alle Logger auf die angegebene Ausgabe (nil, stderr, string, file:Dateiname, syslog:etwas).

Message-Befehle

Befehle zum Arbeiten mit Nachrichten. Nachrichten werden erstellt, um Benutzer über wichtige Ereignisse zu informieren, und werden in XenCenter als Warnungen angezeigt.

Die Meldungsobjekte können mit dem Standard-Objektauflistungsbefehl (xe message-list) aufgelistet werden, und die Parameter können mit den Standardparameterbefehlen bearbeitet werden. Weitere Informationen finden Sie unter Parameterbefehle auf niedriger Ebene

Message-Parameter

Parametername Beschreibung Typ
uuid Die eindeutige Bezeichner/Objektreferenz für die Nachricht Lesezugriff
name Der eindeutige Name der Nachricht Lesezugriff
priority Die Priorität der Nachricht. Höhere Zahlen bedeuten eine höhere Priorität Lesezugriff
class Die Nachrichtenklasse, zum Beispiel VM. Lesezugriff
obj-uuid Die UUID des betroffenen Objekts. Lesezugriff
timestamp Die Zeit, zu der die Nachricht generiert wurde. Lesezugriff
body Der Inhalt der Nachricht. Lesezugriff

message-create

xe message-create name=message_name body=message_text [[host-uuid=uuid_of_host] | [sr-uuid=uuid_of_sr] | [vm-uuid=uuid_of_vm] | [pool-uuid=uuid_of_pool]]
<!--NeedCopy-->

Erstellt eine Nachricht.

message-destroy

xe message-destroy [uuid=message_uuid]
<!--NeedCopy-->

Zerstört eine vorhandene Nachricht. Sie können ein Skript erstellen, um alle Nachrichten zu vernichten. Beispiel:

# Dismiss all alerts   \
    IFS=","; for m in $(xe message-list params=uuid --minimal); do  \
    xe message-destroy uuid=$m  \
    done
<!--NeedCopy-->

Netzwerkbefehle

Befehle zum Arbeiten mit Netzwerken.

Die Netzwerkobjekte können mit dem Standardbefehl für die Objektauflistung (xe network-list) aufgelistet werden, und die Parameter können mit den Standardparameterbefehlen bearbeitet werden. Weitere Informationen finden Sie unter Parameterbefehle auf niedriger Ebene

Netzwerkparameter

Netzwerke haben folgende Parameter:

Parametername Beschreibung Typ
uuid Die eindeutige Bezeichner/Objektreferenz für das Netzwerk Lesezugriff
name-label Der Name des Netzwerks Lese-/Schreibrechte
name-description Der Beschreibungstext des Netzwerks Lese-/Schreibrechte
VIF-uuids Eine Liste der eindeutigen Identifikatoren der VIFs (Virtual Network Interfaces), die von virtuellen Rechnern an dieses Netzwerk angehängt werden Schreibgeschützter Parameter
PIF-uuids Eine Liste der eindeutigen Kennungen der PIFs (physische Netzwerkschnittstellen), die von Citrix Hypervisor-Servern an dieses Netzwerk angeschlossen sind Schreibgeschützter Parameter
bridge Name der Bridge, die diesem Netzwerk auf dem lokalen Citrix Hypervisor-Server entspricht Lesezugriff
default-locking-mode Ein Netzwerkobjekt, das mit VIF-Objekten für die ARP-Filterung verwendet wird. Stellen Sie auf ein unlocked, um alle mit dem VIF verknüpften Filterregeln zu entfernen. Auf disabled eingestellt, damit das VIF den gesamten Datenverkehr verwirft. Lese-/Schreibrechte
purpose Eine Reihe von Zwecken, für die der Citrix Hypervisor-Server dieses Netzwerk verwendet. Stellen Sie ein nbd, um das Netzwerk zum Herstellen von NBD-Verbindungen zu verwenden. Lese-/Schreibrechte
other-config:staticroutes Kommagetrennte Liste formatierter Subnetz-/Netzmasken-/Gateway-Einträge, die die Gatewayadresse angeben, über die Subnetze weitergeleitet werden Wenn Sie beispielsweise other-config:static-routes auf 172.16.0.0/15/192.168.0.3,172.18.0.0/16/192.168.0.4 setzen, wird der Datenverkehr auf 172.16.0.0/15 über 192.168.0.3 und der Verkehr auf 172.18.0.0/16 über 192.168.0.4 geroutet. Lese-/Schreibrechte
other-config:ethtoolautoneg Auf Nein setzen, um die Autonegotiation der physikalischen Schnittstelle oder Bridge zu deaktivieren. Die Standardeinstellung ist ja. Lese-/Schreibrechte
other-config:ethtool-rx Auf “on” einstellen, um die Empfangsprüfsumme zu aktivieren, auf “off” zum Deaktivieren Lese-/Schreibrechte
other-config:ethtool-tx Auf “on” einstellen, um die Übertragungsprüfsumme zu aktivieren, auf “off” zum Deaktivieren Lese-/Schreibrechte
other-config:ethtool-sg Auf “on” einstellen, um Scatter Gather zu aktivieren, auf “off” zum Deaktivieren Lese-/Schreibrechte
other-config:ethtool-tso Auf “on” einstellen, um die TCP-Segmentierungsoffload zu aktivieren, auf “off” zum Deaktivieren Lese-/Schreibrechte
other-config:ethtool-ufo Auf on setzen, um das Abladen von UDP-Fragmenten zu aktivieren, aus zum Deaktivieren Lese-/Schreibrechte
other-config:ethtool-gso Auf “on” einstellen, um die generisches Segmentierungsoffload zu aktivieren, auf “off” zum Deaktivieren Lese-/Schreibrechte
blobs Binärer Datenspeicher Lesezugriff

network-create

xe network-create name-label=name_for_network [name-description=descriptive_text]
<!--NeedCopy-->

Erstellt ein Netzwerk.

network-destroy

xe network-destroy uuid=network_uuid
<!--NeedCopy-->

Zerstört ein vorhandenes Netzwerk.

SR-IOV-Befehle

Befehle für die Arbeit mit SR-IOV.

Die network-sriov-Objekte können mit dem Standardbefehl zur Objektauflistung (xe network-sriov-list) aufgelistet werden, und die Parameter können mit den Standardparameterbefehlen bearbeitet werden. Weitere Informationen finden Sie unter Parameterbefehle auf niedriger Ebene

SR-IOV-Parameter

SR-IOV hat die folgenden Parameter:

Parametername Beschreibung Typ
physical-PIF Das PIF, um SR-IOV zu ermöglichen. Lesezugriff
logical-PIF Ein logisches SR-IOV-PIF. Benutzer können diesen Parameter verwenden, um ein SR-IOV-VLAN-Netzwerk zu erstellen. Lesezugriff
requires-reboot Wenn auf True gesetzt, wird der Host neu gestartet, um die SR-IOV-Aktivierung in Kraft zu setzen. Lesezugriff
remaining-capacity Anzahl der verbleibenden verfügbaren VFs. Lesezugriff

network-sriov-create

xe network-sriov-create network-uuid=network_uuid pif-uuid=physical_pif_uuid
<!--NeedCopy-->

Erstellt ein SR-IOV-Netzwerkobjekt für ein bestimmtes physisches PIF und aktiviert SR-IOV auf dem physischen PIF.

network-sriov-destroy

xe network-sriov-destroy uuid=network_sriov_uuid
<!--NeedCopy-->

Entfernt ein Netzwerk-SR-IOV-Objekt und deaktiviert SR-IOV auf seinem physischen PIF.

Weisen Sie einen SR-IOV-VF zu

xe vif-create device=device_index mac=vf_mac_address network-uuid=sriov_network vm-uuid=vm_uuid
<!--NeedCopy-->

Weist einer VM einen VF aus einem SR-IOV-Netzwerk zu.

SDN-Controller-Befehle

Befehle zum Arbeiten mit dem SDN-Controller.

sdn-controller-forget

xe sdn-controller-introduce [address=address] [protocol=protocol] [tcp-port=tcp_port]
<!--NeedCopy-->

Stellen Sie einen SDN-Controller vor.

sdn-controller-introduce

xe sdn-controller-forget uuid=uuid
<!--NeedCopy-->

Entfernen Sie einen SDN-Controller.

Tunnel-Befehle

Befehle zum Arbeiten mit Tunneln.

tunnel-create

xe tunnel-create pif-uuid=pif_uuid network-uuid=network_uuid
<!--NeedCopy-->

Erstellen Sie einen neuen Tunnel auf einem Host.

tunnel-destroy

xe tunnel-destroy uuid=uuid
<!--NeedCopy-->

Zerstöre einen Tunnel.

Patch-Befehle

Befehle zum Arbeiten mit Patches.

patch-apply

xe patch-apply uuid=patch_uuid host-uuid=host_uuid
<!--NeedCopy-->

Wendet den zuvor hochgeladenen Patch auf den angegebenen Host an.

patch-clean

xe patch-clean uuid=uuid
<!--NeedCopy-->

Löscht eine zuvor hochgeladene Patch-Datei.

patch-destroy

xe patch-destroy uuid=uuid
<!--NeedCopy-->

Entfernt einen nicht angewendeten Patch-Datensatz und Dateien vom Server.

patch-pool-apply

xe patch-pool-apply uuid=uuid
<!--NeedCopy-->

Wenden Sie den zuvor hochgeladenen Patch auf alle Hosts im Pool an.

patch-pool-clean

xe patch-pool-clean uuid=uuid
<!--NeedCopy-->

Löschen Sie eine zuvor hochgeladene Patch-Datei auf allen Hosts im Pool.

patch-precheck

xe patch-precheck uuid=uuid host-uuid=host_uuid
<!--NeedCopy-->

Führen Sie die Vorprüfungen aus, die in dem zuvor auf den angegebenen Host hochgeladenen Patch enthalten sind

patch-upload

xe patch-upload file-name=file_name
<!--NeedCopy-->

Laden Sie eine Patch-Datei auf den Server hoch.

PBD-Befehle

Befehle zum Arbeiten mit PBDs (Physical Block Devices). PBDs sind die Softwareobjekte, über die der Citrix Hypervisor-Server auf Speicherrepositories (SRs) zugreift.

Die PBD-Objekte können mit dem Standard-Objektauflistungsbefehl (xe pbd-list) aufgelistet werden, und die Parameter können mit den Standardparameterbefehlen bearbeitet werden. Weitere Informationen finden Sie unter Parameterbefehle auf niedriger Ebene

PBD-Parameter

PBDs haben die folgenden Parameter:

Parametername Beschreibung Typ
uuid Die eindeutige Bezeichner/Objektreferenz für die PBD. Lesezugriff
sr-uuid Das Speicherrepository, auf das die PBD verweist Lesezugriff
device-config Zusätzliche Konfigurationsinformationen, die dem SR-Backend-Treiber eines Hosts zur Verfügung gestellt werden Schreibgeschützter Map-Parameter
currently-attached True, wenn das SR an diesen Host angeschlossen ist, andernfalls False Lesezugriff
host-uuid UUID der physischen Maschine, auf der die PBD verfügbar ist Lesezugriff
host Das Host-Feld ist veraltet. Verwenden Sie stattdessen host_uuid. Lesezugriff
other-config Zusätzliche Informationen zur Konfiguration. Map-Parameter lesen/schreiben

pbd-create

xe pbd-create host-uuid=uuid_of_host sr-uuid=uuid_of_sr [device-config:key=corresponding_value]
<!--NeedCopy-->

Erstellen Sie eine PBD auf Ihrem Citrix Hypervisor-Server. Der schreibgeschützte Parameter device-config kann nur bei der Erstellung festgelegt werden.

Um eine Zuordnung von ‘path’ zu ‘/tmp’ hinzuzufügen, stellen Sie sicher, dass die Befehlszeile das Argument enthält device-config:path=/tmp

Eine vollständige Liste der unterstützten Schlüssel/Wert-Paare für Geräte-Konfiguration für jeden SR-Typ finden Sie unter Speicher.

pbd-destroy

xe pbd-destroy uuid=uuid_of_pbd
<!--NeedCopy-->

Zerstört die angegebene PBD.

pbd-plug

xe pbd-plug uuid=uuid_of_pbd
<!--NeedCopy-->

Versucht, die PBD an den Citrix Hypervisor-Server anzuschließen. Wenn dieser Befehl erfolgreich ist, wird die referenzierte SR (und die darin enthaltenen VDIs) für den Citrix Hypervisor-Server sichtbar.

pbd-unplug

xe pbd-unplug uuid=uuid_of_pbd
<!--NeedCopy-->

Versuchen Sie, die PBD vom Citrix Hypervisor-Server zu trennen.

PIF-Befehle

Befehle zum Arbeiten mit PIFs (Objekte, die die physikalischen Netzwerkschnittstellen darstellen).

Die PIF-Objekte können mit dem Standard-Objektauflistungsbefehl (xe pif-list) aufgelistet werden, und die Parameter können mit den Standardparameterbefehlen bearbeitet werden. Weitere Informationen finden Sie unter Parameterbefehle auf niedriger Ebene

PIF-Parameter

PIFs haben folgende Parameter:

Parametername Beschreibung Typ
uuid Die eindeutige Bezeichner/Objektreferenz für das PIF Lesezugriff
device machine-readable Name der Schnittstelle (z. B. eth0) Lesezugriff
MAC Die MAC-Adresse des PIF Lesezugriff
other-config Zusätzliche name:value-Paare für die PIF-Konfiguration. Map-Parameter lesen/schreiben
physical Wenn das stimmt, zeigt der PIF auf eine tatsächliche physische Netzwerkschnittstelle Lesezugriff
currently-attached Ist das PIF derzeit an diesem Host angeschlossen? true oder false Lesezugriff
MTU Maximale Übertragungseinheit des PIF in Byte. Lesezugriff
VLAN VLAN-Tag für den gesamten Datenverkehr, der über diese Schnittstelle fließt. -1 zeigt an, dass kein VLAN-Tag zugewiesen ist Lesezugriff
bond-master-of Die UUID des Bonds, deren Master dieser PIF ist (falls vorhanden) Lesezugriff
bond-slave-of Die UUID des Bonds, zu der dieser PIF gehört (falls vorhanden) Lesezugriff
management Ist dieser PIF als Verwaltungsschnittstelle für die Steuerdomäne bezeichnet? Lesezugriff
network-uuid Die eindeutige Identifikator/Objektreferenz des virtuellen Netzwerks, an das dieser PIF angeschlossen ist Lesezugriff
network-name-label Der Name des virtuellen Netzwerks, mit dem dieser PIF verbunden ist Lesezugriff
host-uuid Die eindeutige Bezeichner/Objektreferenz des Citrix Hypervisor-Servers, mit dem dieser PIF verbunden ist Lesezugriff
host-name-label Der Name des Citrix Hypervisor-Servers, mit dem dieser PIF verbunden ist Lesezugriff
IP-configuration-mode Art der verwendeten Netzwerkadresskonfiguration; DHCP oder statisch Lesezugriff
IP Die IP-Adresse des PIF. Hier definiert, wenn der IP-Konfigurationsmodus statisch ist; undefiniert wenn DHCP Lesezugriff
netmask Netzmaske des PIF. Hier definiert, wenn der IP-Konfigurationsmodus statisch ist; undefiniert, wenn er von DHCP bereitgestellt wird Lesezugriff
gateway Gateway-Adresse des PIF. Hier definiert, wenn der IP-Konfigurationsmodus statisch ist; undefiniert, wenn er von DHCP bereitgestellt wird Lesezugriff
DNS DNS-Adresse des PIF. Hier definiert, wenn der IP-Konfigurationsmodus statisch ist; undefiniert, wenn er von DHCP bereitgestellt wird Lesezugriff
io_read_kbs Durchschnittliche Leserate in KB/s für das Gerät Lesezugriff
io_write_kbs Durchschnittliche Schreibrate in KB/s für das Gerät Lesezugriff
carrier Verbindungsstatus für dieses Gerät Lesezugriff
vendor-id Die dem Anbieter der NIC zugewiesene ID Lesezugriff
vendor-name Der Name des NIC-Anbieters Lesezugriff
device-id Die vom Hersteller diesem NIC-Modell zugewiesene ID Lesezugriff
device-name Der vom Hersteller diesem NIC-Modell zugewiesene Name Lesezugriff
speed Datenübertragungsrate der NIC Lesezugriff
duplex Duplexmodus der NIC; voll oder halb Lesezugriff
pci-bus-path PCI-Buspfad-Adresse Lesezugriff
other-config:ethtoolspeed Legt die Verbindungsgeschwindigkeit in Mbit/s fest Lese-/Schreibrechte
other-config:ethtoolautoneg Auf Nein setzen, um die Autonegotiation der physikalischen Schnittstelle oder Bridge zu deaktivieren. Die Standardeinstellung ist ja. Lese-/Schreibrechte
other-config:ethtoolduplex Legt die Duplexfähigkeit des PIF fest, entweder voll oder halb. Lese-/Schreibrechte
other-config:ethtool-rx Auf “on” einstellen, um die Empfangsprüfsumme zu aktivieren, auf “off” zum Deaktivieren Lese-/Schreibrechte
other-config:ethtool-tx Auf “on” einstellen, um die Übertragungsprüfsumme zu aktivieren, auf “off” zum Deaktivieren Lese-/Schreibrechte
other-config:ethtool-sg Auf “on” einstellen, um Scatter Gather zu aktivieren, auf “off” zum Deaktivieren Lese-/Schreibrechte
other-config:ethtool-tso Auf “on” einstellen, um die TCP-Segmentierungsoffload zu aktivieren, auf “off” zum Deaktivieren Lese-/Schreibrechte
other-config:ethtool-ufo Auf on setzen, um das Abladen von UDP-Fragmenten zu aktivieren, aus zum Deaktivieren Lese-/Schreibrechte
other-config:ethtool-gso Auf “on” einstellen, um die generisches Segmentierungsoffload zu aktivieren, auf “off” zum Deaktivieren Lese-/Schreibrechte
other-config:domain Kommagetrennte Liste zum Festlegen des DNS-Suchpfads Lese-/Schreibrechte
other-config:bondmiimon Intervall zwischen den Verbindungsüberprüfungen in Millisekunden Lese-/Schreibrechte
other-config:bonddowndelay Anzahl der Millisekunden, die gewartet werden müssen, nachdem der Link verloren gegangen ist, bevor der Link wirklich verschwunden ist. Dieser Parameter ermöglicht einen vorübergehenden Verbindungsverlust Lese-/Schreibrechte
other-config:bondupdelay Anzahl der Millisekunden, die nach dem Start des Links gewartet werden müssen, bevor er wirklich darüber nachgedacht wird. Ermöglicht das Hochklappen von Links. Die Standardeinstellung ist 31s, dass Switches Zeit haben, um den Datenverkehr weiterzuleiten. Lese-/Schreibrechte
disallow-unplug Wahr, wenn dieser PIF eine dedizierte Speicher-NIC ist, andernfalls false Lese-/Schreibrechte

Hinweis:

Änderungen an den other-config-Feldern eines PIF werden erst nach einem Neustart wirksam. Verwenden Sie alternativ die Befehle xe pif-unplug und xe pif-plug, um die PIF-Konfiguration neu zu schreiben.

pif-forget

xe pif-forget uuid=uuid_of_pif
<!--NeedCopy-->

Zerstört das angegebene PIF-Objekt auf einem bestimmten Host.

pif-introduce

xe pif-introduce host-uuid=host_uuid mac=mac_address_for_pif device=interface_name
<!--NeedCopy-->

Erstellen Sie ein PIF-Objekt, das eine physische Schnittstelle auf dem angegebenen Citrix Hypervisor-Server darstellt.

pif-plug

xe pif-plug uuid=uuid_of_pif
<!--NeedCopy-->

Versuch, die angegebene physikalische Schnittstelle hochzufahren.

pif-reconfigure-ip

xe pif-reconfigure-ip uuid=uuid_of_pif [mode=dhcp|mode=static] gateway=network_gateway_address IP=static_ip_for_this_pif netmask=netmask_for_this_pif [DNS=dns_address]
<!--NeedCopy-->

Ändern Sie die IP-Adresse des PIF. Bei einer statischen IP-Konfiguration legen Sie den Parameter mode auf static, und die Parameter gateway, IP und netmask auf die entsprechenden Werte fest. Um DHCP zu verwenden, setzen Sie den Parameter mode auf DHCP und lassen Sie die statischen Parameter undefiniert.

Hinweis:

Die Verwendung statischer IP-Adressen auf physischen Netzwerkschnittstellen, die über das Spanning Tree Protocol mit ausgeschaltetem (oder nicht unterstütztem) STP Fast Link an einen Port eines Switches angeschlossen sind, führt zu einem Zeitraum, in dem kein Datenverkehr stattfindet.

pif-reconfigure-ipv6

xe pif-reconfigure-ipv6 uuid=uuid_of_pif mode=mode [gateway=network_gateway_address] [IPv6=static_ip_for_this_pif] [DNS=dns_address]
<!--NeedCopy-->

Konfigurieren Sie die IPv6-Adresseinstellungen auf einem PIF neu.

pif-scan

xe pif-scan host-uuid=host_uuid
<!--NeedCopy-->

Suchen Sie auf Ihrem Citrix Hypervisor-Server nach neuen physischen Schnittstellen.

pif-set-primary-address-type

xe pif-set-primary-address-type  uuid=uuid primary_address_type=address_type
<!--NeedCopy-->

Ändern Sie den von diesem PIF verwendeten primären Adresstyp.

pif-unplug

xe pif-unplug uuid=uuid_of_pif
<!--NeedCopy-->

Versuch, die angegebene physikalische Schnittstelle herunterzufahren.

Pool-Befehle

Befehle zum Arbeiten mit Pools. Ein Pool ist ein Aggregat aus einem oder mehreren Citrix Hypervisor-Servern. Ein Pool verwendet ein oder mehrere gemeinsam genutzte Speicherrepositories, sodass die VMs, die auf einem Host im Pool ausgeführt werden, nahezu in Echtzeit zu einem anderen Host im Pool migriert werden können. Diese Migration findet statt, während die VM noch läuft, ohne dass sie heruntergefahren und wieder hochgefahren werden muss. Jeder Citrix Hypervisor-Server ist wirklich ein Pool, der standardmäßig aus einem einzelnen Mitglied besteht. Wenn Ihr Citrix Hypervisor-Server mit einem Pool verbunden ist, wird er als Mitglied festgelegt, und der Pool, dem er beigetreten ist, wird zum Master für den Pool.

Das Singleton-Pool-Objekt kann mit dem Standard-Objektauflistungsbefehl (xe pool-list) aufgelistet werden. Seine Parameter können mit den Standardparameterbefehlen manipuliert werden. Weitere Informationen finden Sie unter Parameterbefehle auf niedriger Ebene

Pool-Parameter

Pools haben die folgenden Parameter:

Parametername Beschreibung Typ
uuid Die eindeutige Bezeichner/Objektreferenz für den Pool Lesezugriff
name-label Der Name des Pools Lese-/Schreibrechte
name-description Die Beschreibungszeichenfolge des Pools Lese-/Schreibrechte
master Die eindeutige Bezeichner/Objektreferenz des Citrix Hypervisor-Servers, der als Master des Pools bestimmt ist Lesezugriff
default-SR Die eindeutige Bezeichner/Objektreferenz des Standard-SRs für den Pool Lese-/Schreibrechte
crash-dump-SR Die eindeutige Bezeichner/Objektreferenz des SRs, in dem alle Absturzabbilder für Poolmitglieder gespeichert werden Lese-/Schreibrechte
metadata-vdis Alle bekannten Metadaten-VDIs für den Pool Lesezugriff
suspend-image-SR Die eindeutige Bezeichner/Objektreferenz des SRs, in dem angehaltene VMs auf Poolmitgliedern gespeichert werden Lese-/Schreibrechte
other-config Eine Liste von Schlüssel/Wert-Paaren, die zusätzliche Konfigurationsparameter für den Pool angeben Map-Parameter lesen/schreiben
supported-sr-types SR-Typen, die dieser Pool verwenden kann Lesezugriff
ha-enabled Wahr, wenn HA für den Pool aktiviert ist, false sonst Lesezugriff
ha-configuration Reserviert für zukünftige Verwendung. Lesezugriff
ha-statefiles Listet die UUIDs der VDIs auf, die von HA zur Bestimmung des Speicherzustands verwendet Lesezugriff
ha-host-failures-to-tolerate Die Anzahl der vor dem Senden einer Systemwarnung zu tolerierenden Host-Ausfälle Lese-/Schreibrechte
ha-plan-exists-for Die Anzahl der Hosts-Ausfälle, die gemäß den Berechnungen des HA-Algorithmus tatsächlich behandelt werden können Lesezugriff
ha-allow-overcommit Wahr, wenn der Pool überstimmt werden darf, andernfalls False Lese-/Schreibrechte
ha-overcommitted True, wenn der Pool überlastet ist Lesezugriff
blobs Binärer Datenspeicher Lesezugriff
live-patching-disabled Auf False setzen, um Live-Patching zu ermöglichen. Auf True setzen, um das Live-Patching zu deaktivieren. Lese-/Schreibrechte
igmp-snooping-enabled Auf True setzen, um IGMP-Snooping zu ermöglichen. Auf False setzen, um IGMP-Snooping zu deaktivieren. Lese-/Schreibrechte
https-only Auf False setzen, damit externe Clients, die die Management-API verwenden, entweder über HTTPS über Port 443 oder HTTP über Port 80 eine Verbindung zu Citrix Hypervisor herstellen können. Auf True setzen, um Port 80 zu blockieren und zu verlangen, dass Clients ausschließlich über HTTPS über Port 443 eine Verbindung herstellen. Lese-/Schreibrechte

pool-apply-edition

xe pool-apply-edition edition=edition [uuid=uuid] [license-server-address=address] [license-server-port=port]
<!--NeedCopy-->

Wenden Sie eine Ausgabe im gesamten Pool an.

pool-certificate-install

xe pool-certificate-install filename=file_name
<!--NeedCopy-->

Installieren Sie ein TLS-Zertifikat, poolweit.

pool-certificate-list

xe pool-certificate-list
<!--NeedCopy-->

Listet alle installierten TLS-Zertifikate in einem Pool auf.

pool-certificate-sync

xe pool-certificate-sync
<!--NeedCopy-->

Synchronisieren Sie TLS-Zertifikate und Zertifikatssperrlisten vom Poolmaster mit den anderen Poolmitgliedern.

pool-certificate-uninstall

xe pool-certificate-uninstall name=name
<!--NeedCopy-->

Deinstalliert ein TLS-Zertifikat.

pool-crl-install

xe pool-crl-install filename=file_name
<!--NeedCopy-->

Installieren Sie eine TLS-Zertifikatssperrliste, poolweit.

pool-crl-list

xe pool-crl-list
<!--NeedCopy-->

Listet alle installierten TLS-Zertifikatssperrlisten auf.

pool-crl-uninstall

xe pool-crl-uninstall name=name
<!--NeedCopy-->

Deinstalliert eine TLS-Zertifikatssperrliste.

pool-deconfigure-wlb

xe pool-deconfigure-wlb
<!--NeedCopy-->

Entfernen Sie die Konfiguration für den Arbeitslastausgleich dauerhaft.

pool-designate-new-master

xe pool-designate-new-master host-uuid=uuid_of_new_master
<!--NeedCopy-->

Weisen Sie den angegebenen Citrix Hypervisor-Server an, Master eines vorhandenen Pools zu werden. Dieser Befehl führt eine geordnete Übergabe der Rolle des Masterhosts an einen anderen Host im Ressourcenpool durch. Dieser Befehl funktioniert nur, wenn der aktuelle Master online ist. Es ist kein Ersatz für die unten aufgeführten Befehle im Notfallmodus.

pool-disable-external-auth

xe pool-disable-external-auth [uuid=uuid] [config=config]
<!--NeedCopy-->

Deaktiviert die externe Authentifizierung bei allen Hosts in einem Pool.

pool-disable-local-storage-caching

xe pool-disable-local-storage-caching uuid=uuid
<!--NeedCopy-->

Deaktivieren Sie das lokale Speicher-Caching im gesamten Pool.

pool-disable-redo-log

xe pool-disable-redo-log
<!--NeedCopy-->

Deaktivieren Sie das Redo-Protokoll, falls es verwendet wird, sofern HA nicht aktiviert ist.

pool-dump-database

xe pool-dump-database file-name=filename_to_dump_database_into_(on_client)
<!--NeedCopy-->

Laden Sie eine Kopie der gesamten Pooldatenbank herunter und speichern Sie sie in einer Datei auf dem Client.

pool-enable-external-auth

xe pool-enable-external-auth  auth-type=auth_type service-name=service_name [uuid=uuid] [config:=config]
<!--NeedCopy-->

Ermöglicht die externe Authentifizierung bei allen Hosts in einem Pool. Beachten Sie, dass für einige Werte von auth-type bestimmte config:-Werte erforderlich sind.

pool-enable-local-storage-caching

xe pool-enable-local-storage-caching uuid=uuid
<!--NeedCopy-->

Aktivieren Sie das lokale Speicher-Caching im gesamten Pool.

pool-enable-redo-log

xe pool-enable-redo-log sr-uuid=sr_uuid
<!--NeedCopy-->

Aktiviert das Redo-Protokoll auf dem angegebenen SR, falls es verwendet wird, sofern HA nicht aktiviert ist.

pool-eject

xe pool-eject host-uuid=uuid_of_host_to_eject
<!--NeedCopy-->

Weisen Sie den angegebenen Citrix Hypervisor-Server an, einen vorhandenen Pool zu verlassen.

pool-emergency-reset-master

xe pool-emergency-reset-master master-address=address_of_pool_master
<!--NeedCopy-->

Weisen Sie einen Poolmitgliedsserver an, seine Master-Server-Adresse auf den neuen Wert zurückzusetzen, und versuchen Sie, eine Verbindung zu ihm herzustellen. Führen Sie diesen Befehl nicht auf Masterservern aus.

pool-emergency-transition-to-master

xe pool-emergency-transition-to-master
<!--NeedCopy-->

Weisen Sie einen Citrix Hypervisor-Mitgliedsserver an, Poolmaster zu werden. Der Citrix Hypervisor-Server akzeptiert diesen Befehl erst, nachdem der Host in den Notfallmodus übergegangen ist. Notfallmodus bedeutet, dass er Mitglied eines Pools ist, dessen Master aus dem Netzwerk verschwunden ist und nach einigen Wiederholungsversuchen nicht mehr kontaktiert werden kann.

Wenn das Host-Kennwort geändert wurde, seit der Host dem Pool beigetreten ist, kann dieser Befehl dazu führen, dass das Kennwort des Hosts zurückgesetzt wird. Weitere Informationen finden Sie unter (Benutzerbefehle).

pool-ha-enable

xe pool-ha-enable heartbeat-sr-uuids=uuid_of_heartbeat_sr
<!--NeedCopy-->

Aktivieren Sie Hochverfügbarkeit im Ressourcenpool, indem Sie die angegebene SR-UUID als zentrales Speicher-Heartbeat-Repository verwenden.

pool-ha-disable

xe pool-ha-disable
<!--NeedCopy-->

Deaktiviert die Hochverfügbarkeitsfunktion im Ressourcenpool.

pool-ha-compute-hypothetical-max-host-failures-to-tolerate

Berechnet die maximale Anzahl von Host-Ausfällen, die in der aktuellen Pool-Konfiguration toleriert werden sollen.

pool-ha-compute-max-host-failures-to-tolerate

xe pool-ha-compute-hypothetical-max-host-failures-to-tolerate [vm-uuid=vm_uuid] [restart-priority=restart_priority]
<!--NeedCopy-->

Berechnen Sie die maximale Anzahl von zu tolerierenden Hostausfällen mit den bereitgestellten, vorgeschlagenen geschützten VMs.

pool-initialize-wlb

xe pool-initialize-wlb wlb_url=url wlb_username=wlb_username wlb_password=wlb_password xenserver_username=username xenserver_password=password
<!--NeedCopy-->

Initialisieren Sie den Arbeitslastausgleich für den aktuellen Pool mit dem Workload Balancing-Zielserver.

pool-join

xe pool-join master-address=address master-username=username master-password=password
<!--NeedCopy-->

Weisen Sie Ihren Citrix Hypervisor-Server an, einem vorhandenen Pool beizutreten.

pool-management-reconfigure

xe pool-management-reconfigure [network-uuid=network-uuid]
<!--NeedCopy-->

Konfiguriert die Verwaltungsschnittstelle aller Hosts im Pool neu, um die angegebene Netzwerkschnittstelle zu verwenden, die für die Verbindung mit dem XenCenter verwendet wird. Der Befehl schreibt den Schlüssel MANAGEMENT_INTERFACE in /etc/xensource-inventory für alle Hosts im Pool um.

Wenn der Gerätename einer Schnittstelle (die eine IP-Adresse haben muss) angegeben wird, bindet der Citrix Hypervisor Masterhost sofort neu. Dieser Befehl funktioniert sowohl im Normal- als auch im Notfallmodus.

Aus der angegebenen Netzwerk-UUID wird die UUID des PIF-Objekts identifiziert und dem Citrix Hypervisor-Server zugeordnet, der bestimmt, welche IP-Adresse an sich selbst neu gebunden werden soll. Es darf sich nicht im Notfallmodus befinden, wenn dieser Befehl ausgeführt wird.

Warnung:

Seien Sie vorsichtig, wenn Sie diesen CLI-Befehl außerhalb des Hosts verwenden, und stellen Sie sicher, dass die neue Schnittstelle über Netzwerkkonnektivität verfügt. Verwenden Sie xe pif-reconfigure zum Einrichten. Andernfalls können nachfolgende CLI-Befehle den Citrix Hypervisor-Server nicht erreichen.

pool-recover-slaves

xe pool-recover-slaves
<!--NeedCopy-->

Weisen Sie den Poolmaster an, zu versuchen, die Masteradresse aller Mitglieder zurückzusetzen, die gerade im Notfallmodus laufen. Dieser Befehl wird normalerweise verwendet, nachdem mit pool-emergency-transition-to-master eines der Mitglieder als neuen Master festgelegt wurde.

pool-restore-database

xe pool-restore-database file-name=filename_to_restore_from_on_client [dry-run=true|false]
<!--NeedCopy-->

Laden Sie ein Datenbankbackup (erstellt mit pool-dump-database) in einen Pool hoch. Nach Erhalt des Uploads startet sich der Master mit der neuen Datenbank neu.

Es gibt auch eine Testlaufoption, mit der Sie überprüfen können, ob die Pooldatenbank wiederhergestellt werden kann, ohne den Vorgang tatsächlich auszuführen. Standardmäßig ist dry-run auf “false” festgelegt.

pool-retrieve-wlb-configuration

xe pool-retrieve-wlb-configuration
<!--NeedCopy-->

Ruft die Pool-Optimierungskriterien vom Workload Balancing-Server ab.

pool-retrieve-wlb-diagnostics

xe pool-retrieve-wlb-diagnostics [filename=file_name]
<!--NeedCopy-->

Ruft Diagnosen vom Workload Balancing-Server ab.

pool-retrieve-wlb-recommendations

xe pool-retrieve-wlb-recommendations
<!--NeedCopy-->

Ruft VM-Migrationsempfehlungen für den Pool vom Workload Balancing-Server ab.

pool-retrieve-wlb-report

xe pool-retrieve-wlb-report report=report [filename=file_name]
<!--NeedCopy-->

Ruft Berichte vom Workload Balancing-Server ab.

pool-secret-rotate

xe pool-secret-rotate
<!--NeedCopy-->

Rotieren Sie das Poolgeheimnis.

Das Poolgeheimnis ist ein Geheimnis, das von den Servern in einem Pool geteilt wird und es dem Server ermöglicht, seine Mitgliedschaft in einem Pool nachzuweisen. Benutzer mit der Rolle “Pool Admin” können dieses Geheimnis anzeigen, wenn sie sich über SSH mit dem Server verbinden. Rotieren Sie das Poolgeheimnis, wenn einer dieser Benutzer Ihre Organisation verlässt oder seine Pooladministratorrolle verliert.

pool-send-test-post

xe pool-send-test-post dest-host=destination_host dest-port=destination_port body=post_body
<!--NeedCopy-->

Senden Sie den angegebenen Text mithilfe von HTTPS an den angegebenen Host und Port und drucken Sie die Antwort aus. Dies wird für das Debuggen der TLS-Schicht verwendet.

pool-send-wlb-configuration

xe pool-send-wlb-configuration [config:=config]
<!--NeedCopy-->

Legt die Pool-Optimierungskriterien für den Workload Balancing-Server fest.

pool-sync-database

xe pool-sync-database
<!--NeedCopy-->

Erzwingt die Synchronisierung der Pooldatenbank über alle Hosts im Ressourcenpool. Dieser Befehl ist im normalen Betrieb nicht erforderlich, da die Datenbank regelmäßig automatisch repliziert wird. Der Befehl kann jedoch nützlich sein, um sicherzustellen, dass Änderungen schnell repliziert werden, nachdem ein erheblicher Satz von CLI-Operationen ausgeführt wurde.

igmp-snooping-enabled

xe pool-param-set [uuid=pool-uuid] [igmp-snooping-enabled=true|false]
<!--NeedCopy-->

Aktiviert oder deaktiviert IGMP-Snooping in einem Citrix Hypervisor-Pool.

https-only

xe pool-param-set [uuid=pool-uuid] [https-only=true|false]
<!--NeedCopy-->

Aktiviert oder deaktiviert die Blockierung von Port 80 auf der Verwaltungsschnittstelle von Citrix Hypervisor-Hosts.

PVS Accelerator-Befehle

Befehle zum Arbeiten mit dem PVS-Beschleuniger.

pvs-cache-storage-create

xe pvs-cache-storage-create sr-uuid=sr_uuid pvs-site-uuid=pvs_site_uuid size=size
<!--NeedCopy-->

Konfigurieren Sie einen PVS-Cache auf einem bestimmten SR für einen bestimmten Host.

pvs-cache-storage-destroy

xe pvs-cache-storage-destroy uuid=uuid
<!--NeedCopy-->

Entferne einen PVS-Cache.

pvs-proxy-create

xe pvs-proxy-create pvs-site-uuid=pvs_site_uuid vif-uuid=vif_uuid
<!--NeedCopy-->

Konfigurieren Sie eine VM/VIF für die Verwendung eines PVS-Proxys.

pvs-proxy-destroy

xe pvs-proxy-destroy uuid=uuid
<!--NeedCopy-->

Entfernen (oder schalten) Sie einen PVS-Proxy für diese VIF/VM aus.

pvs-server-forget

xe pvs-server-forget uuid=uuid
<!--NeedCopy-->

Vergessen Sie einen PVS-Server.

pvs-server-introduce

xe pvs-server-introduce addresses=adresses first-port=first_port last-port=last_port pvs-site-uuid=pvs_site_uuid
<!--NeedCopy-->

Einführung eines neuen PVS-Servers.

pvs-site-forget

xe pvs-site-forget uuid=uuid
<!--NeedCopy-->

Vergiss eine PVS-Site.

pvs-site-introduce

xe pvs-site-introduce name-label=name_label [name-description=name_description] [pvs-uuid=pvs_uuid]
<!--NeedCopy-->

Einführung einer neuen PVS-Site.

Storage Manager-Befehle

Befehle zum Steuern von Storage Manager-Plug-ins.

Die Storage-Manager-Objekte können mit dem Standard-Objektauflistungsbefehl (xe sm-list) aufgelistet werden. Die Parameter können mit den Standardparameterbefehlen manipuliert werden. Weitere Informationen finden Sie unter Parameterbefehle auf niedriger Ebene

SM-Parameter

SMs haben folgende Parameter:

Parametername Beschreibung Typ
uuid Die eindeutige Bezeichner/Objektreferenz für das SM-Plug-In Lesezugriff
name-label Der Name des SM-Plug-ins Lesezugriff
name-description Die Beschreibungszeichenfolge des SM-Plug-ins Lesezugriff
type Der SR-Typ, an den dieses Plug-In angeschlossen wird Lesezugriff
vendor Name des Anbieters, der dieses Plug-in erstellt hat Lesezugriff
copyright Copyright-Erklärung für dieses SM-Plug-In Lesezugriff
required-api-version Minimale SM-API-Version auf dem Citrix Hypervisor-Server erforderlich Lesezugriff
configuration Namen und Beschreibungen der Gerätekonfigurationsschlüssel Lesezugriff
capabilities Funktionen des SM-Plug-ins Lesezugriff
driver-filename Der Dateiname des SR-Treibers. Lesezugriff

Snapshot-Befehle

Befehle zum Arbeiten mit Schnappschüssen.

snapshot-clone

xe snapshot-clone new-name-label=name_label [uuid=uuid] [new-name-description=description]
<!--NeedCopy-->

Erstellen Sie eine neue Vorlage, indem Sie einen vorhandenen Snapshot klonen und, sofern verfügbar, einen schnellen Datenträgerklonvorgang auf Speicherebene verwenden.

snapshot-copy

xe snapshot-copy new-name-label=name_label [uuid=uuid] [new-name-description=name_description] [sr-uuid=sr_uuid]
<!--NeedCopy-->

Erstellen Sie eine neue Vorlage, indem Sie eine vorhandene VM kopieren, ohne jedoch den schnellen Datenträgerklonvorgang auf Speicherebene zu verwenden (auch wenn diese verfügbar ist). Die Disk-Images der kopierten VM sind garantiert “vollständige Images” - also nicht Teil einer CoW-Kette.

snapshot-destroy

xe snapshot-destroy  [uuid=uuid] [snapshot-uuid=snapshot_uuid]
<!--NeedCopy-->

Zerstöre einen Schnappschuss. Dadurch bleibt der mit dem Snapshot verknüpfte Speicher intakt. Um auch Speicher zu löschen, verwenden Sie die Snapshot-Deinstallation.

snapshot-disk-list

xe snapshot-disk-list [uuid=uuid] [snapshot-uuid=snapshot_uuid] [vbd-params=vbd_params] [vdi-params=vdi_params]
<!--NeedCopy-->

Listet die Datenträger der ausgewählten VM(s) auf.

snapshot-export-to-template

xe snapshot-export-to-template filename=file_name snapshot-uuid=snapshot_uuid  [preserve-power-state=true|false]
<!--NeedCopy-->

Exportiert einen Snapshot in den Dateinamen.

snapshot-reset-powerstate

xe snapshot-reset-powerstate [uuid=uuid] [snapshot-uuid=snapshot_uuid] [--force]
<!--NeedCopy-->

Erzwingt das Anhalten des VM-Energiezustands nur in der Datenbank des Management-Toolstack. Dieser Befehl wird verwendet, um einen Snapshot wiederherzustellen, der als “angehalten” markiert ist. Dies ist ein potenziell gefährlicher Vorgang: Sie müssen sicherstellen, dass Sie das Speicherimage nicht mehr benötigen. Sie können Ihren Snapshot nicht mehr fortsetzen.

snapshot-revert

xe snapshot-revert [uuid=uuid] [snapshot-uuid=snapshot_uuid]
<!--NeedCopy-->

Setzt eine vorhandene VM in einen früheren Checkpoint- oder Snapshot-Zustand zurück.

snapshot-uninstall

xe snapshot-uninstall [uuid=uuid] [snapshot-uuid=snapshot_uuid] [--force]
<!--NeedCopy-->

Deinstalliert einen Schnappschuss Durch diesen Vorgang werden die VDIs zerstört, die als RW gekennzeichnet sind und nur mit diesem Snapshot verbunden sind. Um den VM-Datensatz einfach zu löschen, verwenden Sie Snapshot-Zerstören.

SR-Befehle

Befehle zur Steuerung von SRs (Speicherrepositories).

Die SR-Objekte können mit dem Standard-Objektauflistungsbefehl (xe sr-list) aufgelistet werden, und die Parameter können mit den Standardparameterbefehlen manipuliert werden. Weitere Informationen finden Sie unter Parameterbefehle auf niedriger Ebene

SR-Parameter

SRs haben die folgenden Parameter:

Parametername Beschreibung Typ
uuid Die eindeutige Identifikator/Objektreferenz für das SR Lesezugriff
name-label Der Name des SRs Lese-/Schreibrechte
name-description Die Beschreibungszeichenfolge des SRs Lese-/Schreibrechte
host Der Host-Name des Speicherrepository Lesezugriff
allowed-operations Liste der auf dem SR in diesem Status zulässigen Vorgänge Schreibgeschützter Parameter
current-operations Liste der Vorgänge, die derzeit auf diesem SR ausgeführt werden Schreibgeschützter Parameter
VDIs Eindeutige Bezeichner/Objektreferenz für die virtuellen Datenträger in diesem SR Schreibgeschützter Parameter
PBDs Eindeutige Identifikator/Objektreferenz für die an dieses SR angeschlossenen PBDs Schreibgeschützter Parameter
virtual-allocation Summe der Werte virtueller Größe aller VDIs in diesem Speicherrepository (in Byte) Lesezugriff
physical-utilisation Derzeit auf diesem SR genutzter physischer Speicherplatz in Byte. Bei Datenträgerformaten mit Thin-Provisioning ist die physische Auslastung möglicherweise geringer als die virtuelle Zuweisung Lesezugriff
physical-size Physische Gesamtgröße des SRs in Byte Lesezugriff
type Typ des SR, der zur Angabe des zu verwendenden SR-Back-End-Treibers verwendet wird Lesezugriff
content-type Die Art des Inhalts des SRs. Wird verwendet, um ISO-Libraries von anderen SRs zu unterscheiden. Für Speicher-Repositorys, die eine Bibliothek von ISOs speichern, muss content-type auf iso gesetzt werden. In anderen Fällen empfehlen wir, diesen Parameter entweder auf leer oder auf den Zeichenfolgenbenutzer festzulegen. Lesezugriff
shared Stimmt, wenn diese SR von mehreren Citrix Hypervisor-Servern gemeinsam genutzt werden kann. Sonst falsch. Lese-/Schreibrechte
introduced-by drtask (falls vorhanden), das das SR einführte Lesezugriff
is-tools-sr Stimmt, wenn dies die SR ist, die die Tools-ISO-VDIs enthält. Sonst falsch. Lesezugriff
other-config Liste der Schlüssel/Wert-Paare, die zusätzliche Konfigurationsparameter für das SR angeben Map-Parameter lesen/schreiben
sm-config SM-abhängige Daten Schreibgeschützter Map-Parameter
blobs Binärer Datenspeicher Lesezugriff
local-cache-enabled Wahr, wenn dieser SR als lokaler Cache für seinen Host zugewiesen ist. Sonst falsch. Lesezugriff
tags Benutzerspezifische Tags für Kategorisierungszwecke Set-Parameter lesen/schreiben
clustered Stimmt, die SR verwendet aggregierten lokalen Speicher. Sonst falsch. Lesezugriff

sr-create

xe sr-create name-label=name physical-size=size type=type content-type=content_type device-config:config_name=value [host-uuid=host_uuid] [shared=true|false]
<!--NeedCopy-->

Erstellt ein SR auf dem Datenträger, führt es in die Datenbank ein und erstellt eine PBD, die das SR an den Citrix Hypervisor-Server anhängt. Wenn shared auf true festgelegt ist, wird für jeden Citrix Hypervisor-Server im Pool eine PBD erstellt. Wenn shared nicht angegeben oder auf false festgelegt ist, wird eine PBD nur für den mit host-uuid angegebenen Citrix Hypervisor-Server erstellt.

Die genauen Parameter device-config unterscheiden sich je nach type für das Gerät. Einzelheiten zu diesen Parametern in den verschiedenen Speicher-Back-Ends finden Sie unter SR erstellen.

sr-data-source-forget

xe sr-data-source-forget data-source=data_source
<!--NeedCopy-->

Beenden Sie die Aufzeichnung der angegebenen Datenquelle für ein SR und vergessen Sie alle aufgezeichneten Daten.

sr-data-source-list

xe sr-data-source-list
<!--NeedCopy-->

Listen Sie die Datenquellen auf, die für ein SR aufgezeichnet werden können.

sr-data-source-query

xe sr-data-source-query data-source=data_source
<!--NeedCopy-->

Fragen Sie den zuletzt aus einer SR-Datenquelle gelesenen Wert ab.

sr-data-source-record

xe sr-data-source-record  data-source=data_source
<!--NeedCopy-->

Notieren Sie die angegebene Datenquelle für ein SR.

sr-destroy

xe sr-destroy uuid=sr_uuid
<!--NeedCopy-->

Zerstört das angegebene SR auf dem Citrix Hypervisor-Server.

sr-enable-database-replication

xe sr-enable-database-replication uuid=sr_uuid
<!--NeedCopy-->

Ermöglicht die XAPI-Datenbankreplikation auf das angegebene (gemeinsame) SR.

sr-disable-database-replication

xe sr-disable-database-replication uuid=sr_uuid
<!--NeedCopy-->

Deaktiviert die XAPI-Datenbankreplikation auf das angegebene SR.

sr-forget

xe sr-forget uuid=sr_uuid
<!--NeedCopy-->

Der XAPI-Agent vergisst ein angegebenes SR auf dem Citrix Hypervisor-Server. Wenn der XAPI-Agent ein SR vergisst, wird das SR getrennt und Sie können nicht auf VDIs darauf zugreifen, aber es bleibt auf dem Quellmedium intakt (die Daten gehen nicht verloren).

sr-introduce

xe sr-introduce name-label=name physical-size=physical_size type=type content-type=content_type uuid=sr_uuid
<!--NeedCopy-->

Platziert einfach einen SR-Datensatz in die Datenbank. Verwenden Sie device-config, um zusätzliche Parameter im Format device-config:parameter_key=parameter_value anzugeben, zum Beispiel:

xe sr-introduce device-config:device=/dev/sdb1
<!--NeedCopy-->

Hinweis:

Dieser Befehl wird niemals im Normalbetrieb verwendet. Dieser erweiterte Vorgang kann nützlich sein, wenn ein SR nach seiner Erstellung als freigegeben neu konfiguriert werden muss oder um die Wiederherstellung nach verschiedenen Ausfallszenarien zu unterstützen.

sr-probe

xe sr-probe type=type [host-uuid=host_uuid] [device-config:config_name=value]
<!--NeedCopy-->

Führt einen Scan des Back-End mit den bereitgestellten device-config-Schlüsseln durch. Wenn device-config für das SR-Backend abgeschlossen ist, gibt dieser Befehl eine Liste der SRs zurück, die auf dem Gerät vorhanden sind, falls vorhanden. Wenn die Parameter device-config nur teilweise sind, wird ein Back-End-spezifischer Scan durchgeführt, der Ergebnisse liefert, die Sie bei der Verbesserung der verbleibenden Parameter device-config anleiten. Die Scanergebnisse werden als XML-spezifisch für das Backend zurückgegeben und auf der CLI gedruckt.

Die genauen Parameter device-config unterscheiden sich je nach type für das Gerät. Einzelheiten zu diesen Parametern in den verschiedenen Speicher-Backends finden Sie unter Speicher.

sr-probe-ext

xe sr-probe-ext type=type [host-uuid=host_uuid] [device-config:=config] [sm-config:-sm_config]
<!--NeedCopy-->

Führen Sie eine Speichersonde durch. Die Gerätekonfigurationsparameter können beispielsweise durch device-config:devs=/dev/sdb1 angegeben werden. Im Gegensatz zu sr-probe gibt dieser Befehl Ergebnisse in demselben menschenlesbaren Format für jeden SR-Typ zurück.

sr-scan

xe sr-scan uuid=sr_uuid
<!--NeedCopy-->

Erzwingt einen SR-Scan und synchronisiert die XAPI-Datenbank mit VDIs, die im zugrunde liegenden Speichersubstrat vorhanden sind.

sr-update

xe sr-update uuid=uuid
<!--NeedCopy-->

Aktualisieren Sie die Felder des SR-Objekts in der Datenbank.

lvhd-enable-thin-provisioning

xe lvhd-enable-thin-provisioning  sr-uuid=sr_uuid initial-allocation=initial_allocation allocation-quantum=allocation_quantum
<!--NeedCopy-->

Ermöglichen Sie Thin-Provisioning auf einem LVHD-SR.

Subject-Befehle

Befehle zum Arbeiten mit Themen.

session-subject-identifier-list

xe session-subject-identifier-list
<!--NeedCopy-->

Gibt eine Liste aller Benutzersubjekt-IDs aller extern authentifizierten vorhandenen Sitzungen zurück.

session-subject-identifier-logout

xe session-subject-identifier-logout subject-identifier=subject_identifier
<!--NeedCopy-->

Melden Sie alle extern authentifizierten Sitzungen ab, die mit einer Benutzersubjekt-ID verknüpft sind.

session-subject-identifier-logout-all

xe session-subject-identifier-logout-all
<!--NeedCopy-->

Melden Sie alle extern authentifizierten Sitzungen ab.

subject-add

xe subject-add subject-name=subject_name
<!--NeedCopy-->

Fügen Sie der Liste der Themen, die auf den Pool zugreifen können, einen Betreff hinzu.

subject-remove

xe subject-remove subject-uuid=subject_uuid
<!--NeedCopy-->

Entfernt einen Betreff aus der Liste der Themen, die auf den Pool zugreifen können.

subject-role-add

xe subject-role-add uuid=uuid [role-name=role_name] [role-uuid=role_uuid]
<!--NeedCopy-->

Fügt einem Betreff eine Rolle hinzu.

subject-role-remove

xe subject-role-remove uuid=uuid [role-name=role_name] [role-uuid=role_uuid]
<!--NeedCopy-->

Entfernt eine Rolle aus einem Betreff.

secret-create

xe secret-create value=value
<!--NeedCopy-->

Erstelle ein Geheimnis.

secret-destroy

xe secret-destroy uuid=uuid
<!--NeedCopy-->

Zerstöre ein Geheimnis.

Task-Befehle

Befehle zum Arbeiten mit langwierigen asynchronen Aufgaben. Bei diesen Befehlen handelt es sich um Aufgaben wie das Starten, Stoppen und Anhalten einer virtuellen Maschine. Die Aufgaben bestehen normalerweise aus einer Reihe anderer atomarer Unteraufgaben, die zusammen den angeforderten Vorgang ausführen.

Die Aufgabenobjekte können mit dem Standardbefehl für die Objektauflistung (xe task-list) aufgelistet werden, und die Parameter können mit den Standardparameterbefehlen bearbeitet werden. Weitere Informationen finden Sie unter Parameterbefehle auf niedriger Ebene

Parameter der Aufgabe

Aufgaben haben folgende Parameter:

Parametername Beschreibung Typ
uuid Die eindeutige Bezeichner/Objektreferenz für die Aufgabe Lesezugriff
name-label Der Name der Aufgabe Lesezugriff
name-description Die Beschreibungszeichenfolge der Aufgabe Lesezugriff
resident-on Die eindeutige Bezeichner/Objektreferenz des Hosts, auf dem die Aufgabe ausgeführt wird Lesezugriff
status Status der Aufgabe Lesezugriff
progress Wenn die Aufgabe noch aussteht, enthält dieses Feld den geschätzten Prozentsatz der Fertigstellung von 0 bis 1. Wenn die Aufgabe erfolgreich oder erfolglos abgeschlossen wurde, ist der Wert 1. Lesezugriff
type Wenn die Aufgabe erfolgreich abgeschlossen wurde, enthält dieser Parameter den Typ des codierten Ergebnisses. Der Typ ist der Name der Klasse, deren Referenz sich im Ergebnisfeld befindet. Andernfalls ist der Wert dieses Parameters undefined Lesezugriff
result Wenn die Aufgabe erfolgreich abgeschlossen wurde, enthält dieses Feld den Ergebniswert, entweder Ungültig oder eine Objektreferenz. Andernfalls ist der Wert dieses Parameters nicht definiert Lesezugriff
error_info Wenn die Aufgabe fehlgeschlagen ist, enthält dieser Parameter den Satz der zugehörigen Fehlerzeichenfolgen. Andernfalls ist der Wert dieses Parameters undefined Lesezugriff
allowed_operations Liste der in diesem Status zulässigen Vorgänge Lesezugriff
created Zeit, zu der die Aufgabe erstellt wurde Lesezugriff
finished Zeit, in der die Aufgabe abgeschlossen wurde (d. h. erfolgreich oder nicht erfolgreich). Wenn der Aufgabenstatus ausstehend ist, hat der Wert dieses Feldes keine Bedeutung Lesezugriff
subtask_of Enthält die UUID der Aufgaben, von denen diese Aufgabe eine Unteraufgabe ist Lesezugriff
subtasks Enthält die UUIDs aller Teilaufgaben dieser Aufgabe Lesezugriff

task-cancel

xe task-cancel [uuid=task_uuid]
<!--NeedCopy-->

Weisen Sie die angegebene Aufgabe an, abzubrechen und zurückzukehren.

Template-Befehle

Befehle zum Arbeiten mit VM-Vorlagen.

Vorlagen sind im Wesentlichen VMs, bei denen der Parameter is-a-template auf true festgelegt ist. Eine Vorlage ist ein “Gold-Image”, das alle verschiedenen Konfigurationseinstellungen enthält, um eine bestimmte VM zu instanziieren. Citrix Hypervisor wird mit einem Basissatz von Vorlagen geliefert, bei denen es sich um generische “rohe” VMs handelt, mit denen eine Installations-CD eines Betriebssystemanbieters gestartet werden kann (z. B.: RHEL, CentOS, SLES, Windows). Sie können VMs erstellen, sie in Standardformularen für Ihre speziellen Anforderungen konfigurieren und eine Kopie davon als Vorlagen für die zukünftige Verwendung in der VM-Bereitstellung speichern.

Die Vorlagenobjekte können mit dem Standardbefehl für die Objektauflistung (xe template-list) aufgelistet werden, und die Parameter können mit den Standardparameterbefehlen bearbeitet werden. Weitere Informationen finden Sie unter Parameterbefehle auf niedriger Ebene

Hinweis:

Vorlagen können nicht direkt in VMs konvertiert werden, indem Sie den Parameter is-a-template auf false festlegen. Das Festlegen des Parameters is-a-template auf false wird nicht unterstützt und führt zu einer VM, die nicht gestartet werden kann.

Parameter der VM-Vorlage

Vorlagen haben die folgenden Parameter:

  • uuid (schreibgeschützt) die eindeutige Bezeichner/Objektreferenz für die Vorlage
  • name-label (lesen/schreiben) den Namen der Vorlage
  • name-description (lesen/schreiben) die Beschreibungszeichenfolge der Vorlage
  • user-version (Lese-/Schreib-) Zeichenfolge für Ersteller von VMs und Vorlagen zum Ablegen von Versionsinformationen
  • is-a-template (Lesen/Schreiben) true, wenn diese VM eine Vorlage ist. Vorlagen-VMs können niemals gestartet werden, sie werden nur zum Klonen anderer VMs verwendet. Nachdem dieser Wert auf “true” gesetzt wurde, kann er nicht auf “false” zurückgesetzt werden. Vorlagen-VMs können mit diesem Parameter nicht in virtuelle Rechner umgewandelt werden.

    Sie können eine VM in eine Vorlage konvertieren mit:

     xe vm-param-set uuid=<vm uuid> is-a-template=true
     <!--NeedCopy-->
    
  • is-control-domain (schreibgeschützt) true, wenn dies eine Steuerdomäne (Domäne 0 oder eine Treiberdomäne) ist
  • power-state (schreibgeschützt) aktueller Energiezustand. Der Wert wird für eine Vorlage immer angehalten
  • memory-dynamic-max (schreibgeschützt) dynamischer maximaler Speicher in Byte. Derzeit nicht verwendet, aber wenn geändert, muss die folgende Einschränkung eingehalten werden: memory_static_max >= memory_dynamic_max >= memory_dynamic_min >= memory_static_min.
  • memory-dynamic-min (Lesen/Schreiben) dynamischer Mindestspeicher in Byte. Derzeit nicht verwendet, aber wenn geändert, müssen die gleichen Einschränkungen wie für memory-dynamic-max eingehalten werden.
  • memory-static-max (Lesen/Schreiben) setzt statisch (absolut) maximalen Speicher in Byte. Dieses Feld ist der Hauptwert, der verwendet wird, um die Größe des Speichers zu bestimmen, der einer VM zugewiesen ist.
  • memory-static-min (Lesen/Schreiben) setzt statisch (absolut) Mindestspeicher in Byte. Dieses Feld stellt den absoluten Mindestspeicher dar und memory-static-min muss kleiner als memory-static-max sein. Dieser Wert wird im Normalbetrieb nicht verwendet, aber die vorherige Einschränkung muss eingehalten werden.
  • suspend-VDI-uuid (schreibgeschützt) der VDI, auf dem ein Suspend-Image gespeichert ist (hat keine Bedeutung für eine Vorlage)
  • VCPUs-params (Zuordnungsparameter lesen/schreiben) für die ausgewählte vCPU-Richtlinie.

    Sie können das Pinning einer vCPU tunen mit:

     xe template-param-set uuid=<template_uuid> vCPUs-params:mask=1,2,3
     <!--NeedCopy-->
    

    Eine mit dieser Vorlage erstellte VM wird nur auf den physischen CPUs 1, 2 und 3 ausgeführt.

    Sie können auch die vCPU-Priorität (Xen-Planung) mit den Cap- und Gewicht-Parametern optimieren. Beispiel:

     xe template-param-set uuid=<template_uuid> VCPUs-params:weight=512 xe template-param-set uuid=<template_uuid> VCPUs-params:cap=100
     <!--NeedCopy-->
    

    Eine VM, die auf dieser Vorlage mit einem Gewicht von 512 basiert, erhält doppelt so viel CPU wie eine Domäne mit einem Gewicht von 256 auf einem umstrittenen Host. Die zulässigen Gewichte reichen von 1 bis 65535 und die Standardeinstellung ist 256.

    Die Obergrenze legt optional die maximale Menge an CPU fest, die eine auf dieser Vorlage basierende VM verbrauchen kann, selbst wenn der Citrix Hypervisor-Server CPU-Zyklen im Leerlauf hat. Die Obergrenze wird in Prozent einer physischen CPU ausgedrückt: 100 ist 1 physische CPU, 50 ist eine halbe CPU, 400 sind 4 CPUs usw. Der Standardwert 0 bedeutet, dass es keine Obergrenze gibt.

  • VCPUs-max (Lesen/Schreiben) maximale Anzahl von vCPUs
  • VCPUs-at-startup (Lesen/Schreiben) Startnummer der vCPUs
  • actions-after-crash (Lese-/Schreib-) Aktion, die ausgeführt werden muss, wenn eine auf dieser Vorlage basierende VM abstürzt
  • console-uuids (schreibgeschützte eingestellte Parameter) virtuelle Konsolengeräte
  • platform (Map-Parameter lesen/schreiben) plattformspezifische Konfiguration

    So deaktivieren Sie die Emulation eines Parallelports für HVM-Gäste (z. B. Windows-Gäste):

     xe vm-param-set uuid=<vm_uuid> platform:parallel=none
     <!--NeedCopy-->
    

    So deaktivieren Sie die Emulation einer seriellen Port für HVM-Gäste:

     xe vm-param-set uuid=<vm_uuid> platform:hvm_serial=none
     <!--NeedCopy-->
    

    So deaktivieren Sie die Emulation eines USB-Controllers und eines USB-Tablet-Geräts für HVM-Gäste:

     xe vm-param-set uuid=<vm_uuid> platform:usb=false
     xe vm-param-set uuid=<vm_uuid> platform:usb_tablet=false
     <!--NeedCopy-->
    
  • allowed-operations (schreibgeschützt eingestellter Parameter) Liste der in diesem Zustand zulässigen Operationen
  • current-operations (schreibgeschützter Set-Parameter) Liste der Vorgänge, die derzeit auf dieser Vorlage ausgeführt werden
  • allowed-VBD-devices (schreibgeschützter Set-Parameter) Liste der zur Verwendung verfügbaren VBD-Identifikatoren, dargestellt durch Ganzzahlen im Bereich 0—15. Diese Liste dient nur zur Information und andere Geräte können verwendet werden (funktionieren aber möglicherweise nicht).
  • allowed-VIF-devices (schreibgeschützter Set-Parameter) Liste der zur Verwendung verfügbaren VIF-Identifikatoren, dargestellt durch Ganzzahlen im Bereich 0—15. Diese Liste dient nur zur Information und andere Geräte können verwendet werden (funktionieren aber möglicherweise nicht).
  • HVM-boot-policy (Lesen/Schreiben) der Boot-Richtlinie für HVM-Gäste. Entweder BIOS Order oder eine leere Zeichenfolge.
  • HVM-boot-params (Zuordnungsparameter lesen/schreiben) Der Ordnungsschlüssel steuert die Startreihenfolge des HVM-Gastes, dargestellt als Zeichenfolge, wobei jedes Zeichen eine Startmethode ist: d für die CD/DVD, c für den Stammdatenträger und n für den Netzwerk-PXE-Start. Die Standardeinstellung ist Gleichstrom.
  • PV-kernel (lesen/schreiben) Pfad zum Kernel
  • PV-ramdisk (lesen/schreiben) Pfad zum initrd
  • PV-args (lesen/schreiben) Zeichenfolge von Kernel-Befehlszeilenargumenten
  • PV-legacy-args (Lese-/Schreib) Zeichenfolge von Argumenten, um Legacy-VMs basierend auf dieser Vorlage zum Booten zu bringen
  • PV-bootloader (lesen/schreiben) Name oder Pfad zum Bootloader
  • PV-bootloader-args (lesen/schreiben) Zeichenfolge mit verschiedenen Argumenten für den Bootloader
  • last-boot-CPU-flags (schreibgeschützt) beschreibt die CPU-Flags, auf denen eine auf dieser Vorlage basierende VM zuletzt gebootet wurde; nicht für eine Vorlage aufgefüllt
  • resident-on (schreibgeschützt) der Citrix Hypervisor-Server, auf dem eine auf dieser Vorlage basierende VM residiert ist. Erscheint als not in database für eine Vorlage
  • affinity (Lesen/Schreiben) der Citrix Hypervisor-Server, auf dem eine auf dieser Vorlage basierende VM bevorzugt ausgeführt werden soll. Wird vom Befehl xe vm-start verwendet, um zu entscheiden, wo die VM ausgeführt werden soll.
  • other-config (Map-Parameter mit Lese-/Schreibzugriff) Liste von Schlüssel/Wert-Paaren, die zusätzliche Konfigurationsparameter für die Vorlage angeben
  • start-time (schreibgeschützt) Zeitstempel des Datums und der Uhrzeit, zu der die Metriken für eine VM basierend auf dieser Vorlage gelesen wurden, in der Form yyyymmddThh:mm:ss z, wobei z die militärische Zeitzonenanzeige mit einem Buchstaben ist, z. B. Z für UTC (GMT). Legen Sie für eine Vorlage auf 1 Jan 1970 Z (Anfang Unix/POSIX-Epoche) fest
  • install-time (schreibgeschützt) Zeitstempel des Datums und der Uhrzeit, zu der die Metriken für eine VM basierend auf dieser Vorlage gelesen wurden, in der Form yyyymmddThh:mm:ss z, wobei z die militärische Zeitzonenanzeige mit einem Buchstaben ist, z. B. Z für UTC (GMT). Legen Sie für eine Vorlage auf 1 Jan 1970 Z (Anfang Unix/POSIX-Epoche) fest
  • memory-actual (schreibgeschützt) der tatsächliche Speicher, der von einer VM basierend auf dieser Vorlage verwendet wird; 0 für eine Vorlage
  • VCPUs-number (schreibgeschützt) die Anzahl der virtuellen CPUs, die einer VM basierend auf dieser Vorlage zugewiesen wurden; 0 für eine Vorlage
  • VCPUs-Utilization (schreibgeschützter Map-Parameter) Liste der virtuellen CPUs und deren Gewichtung schreibgeschützter Zuordnungsparameter os-version Die Version des Betriebssystems für eine VM, die auf dieser Vorlage basiert. Erscheint als not in database für eine Vorlage
  • PV-drivers-version (schreibgeschützter Zuordnungsparameter) die Versionen der paravirtualisierten Treiber für eine VM, die auf dieser Vorlage basieren. Erscheint als not in database für eine Vorlage
  • PV-drivers-detected (schreibgeschützt) für die neueste Version der paravirtualisierten Treiber für eine auf dieser Vorlage basierende VM. Erscheint als not in database für eine Vorlage
  • memory (schreibgeschützter Zuordnungsparameter) Speichermetriken, die vom Agent auf einer VM basierend auf dieser Vorlage gemeldet wurden. Erscheint als not in database für eine Vorlage
  • disks (schreibgeschützter Zuordnungsparameter) Datenträgermetriken, die vom Agent auf einer VM basierend auf dieser Vorlage gemeldet wurden. Erscheint als not in database für eine Vorlage
  • networks (schreibgeschützter Zuordnungsparameter) Netzwerkmetriken, die vom Agent auf einer VM basierend auf dieser Vorlage gemeldet wurden. Erscheint als not in database für eine Vorlage
  • other (schreibgeschützter Zuordnungsparameter) andere Metriken, die vom Agent auf einer VM basierend auf dieser Vorlage gemeldet wurden. Erscheint als not in database für eine Vorlage
  • guest-metrics-last-updated (schreibgeschützt) Zeitstempel, an dem der Gast-Agent den letzten Schreibvorgang in diese Felder ausgeführt hat. In dem Formular yyyymmddThh:mm:ss z, wobei z die militärische Zeitzonenanzeige mit einem Buchstaben ist, z. B. Z für UTC (GMT)
  • actions-after-shutdown (Lesen/Schreiben) Aktion, die nach dem Herunterfahren der VM ausgeführt werden soll
  • actions-after-reboot (Lesen/Schreiben) Aktion, die nach dem Neustart der VM ausgeführt werden soll
  • possible-hosts (schreibgeschützt) Liste der Hosts, die die VM potenziell hosten können
  • HVM-shadow-multiplier (Lese-/Schreib-) Multiplikator, der auf die Menge an Schatten angewendet wird, die dem Gast zur Verfügung gestellt wird
  • dom-id (schreibgeschützt) Domänen-ID (falls verfügbar, andernfalls -1)
  • recommendations (schreibgeschützt) XML-Spezifikation der empfohlenen Werte und Bereiche für Eigenschaften dieser VM
  • xenstore-data ( Read/Write Map-Parameter) Daten, die nach dem Erstellen der VM in die Struktur xenstore (/local/domain/*domid*/vmdata) eingefügt werden.
  • is-a-snapshot (schreibgeschützt) True, wenn diese Vorlage ein VM-Snapshot ist
  • snapshot_of (schreibgeschützt) die UUID der VM, von der diese Vorlage ein Snapshot ist
  • snapshots (schreibgeschützt) die UUIDs aller Snapshots, die von dieser Vorlage erstellt wurden
  • snapshot_time (schreibgeschützt) der Zeitstempel des zuletzt aufgenommenen VM-Snapshots
  • memory-target (schreibgeschützt) die für diese Vorlage festgelegte Zielspeichermenge
  • blocked-operations (Map-Parameter mit Lese-/Schreibzugriff) listet die Vorgänge auf, die mit dieser Vorlage nicht ausgeführt werden können
  • last-boot-record (schreibgeschützt) Aufzeichnung der letzten Bootparameter für diese Vorlage im XML-Format
  • ha-always-run (Lesen/Schreiben) True, wenn eine Instanz dieser Vorlage immer auf einem anderen Host neu gestartet wird, wenn der Host, auf dem sie ansässig ist, ausfällt. Dieser Parameter ist jetzt veraltet. Verwenden Sie stattdessen den Parameter ha-restartpriority.
  • ha-restart-priority (schreibgeschützt) Neustart oder Bestleistung Lese-/Schreibblobs binärer Datenspeicher
  • live (schreibgeschützt) nur für eine laufende VM relevant.

template-export

xe template-export template-uuid=uuid_of_existing_template filename=filename_for_new_template
<!--NeedCopy-->

Exportiert eine Kopie einer angegebenen Vorlage in eine Datei mit dem angegebenen neuen Dateinamen.

template-uninstall

xe template-uninstall template-uuid=template_uuid [--force]
<!--NeedCopy-->

Deinstallieren Sie eine benutzerdefinierte Vorlage. Dieser Vorgang zerstört die VDIs, die als “Eigentum” dieser Vorlage markiert sind.

Befehle aktualisieren

Der folgende Abschnitt enthält Befehle zum Aktualisieren des Citrix Hypervisor-Servers.

Die Aktualisierungsobjekte können mit dem Standardbefehl für die Objektauflistung (xe update-list) aufgelistet werden, und die Parameter können mit den Standardparameterbefehlen bearbeitet werden. Weitere Informationen finden Sie unter Parameterbefehle auf niedriger Ebene

Parameter aktualisieren

Citrix Hypervisor-Serverupdates haben die folgenden Parameter:

Parametername Beschreibung Typ
uuid Die eindeutige Bezeichner/Objektreferenz für das Update Lesezugriff
host Die Liste der Hosts, auf die dieses Update angewendet wird Lesezugriff
host-uuid Die eindeutige Kennung für den abzufragenden Citrix Hypervisor-Server Lesezugriff
name-label Der Name des Updates Lesezugriff
name-description Die Beschreibungszeichenfolge des Updates Lesezugriff
applied Ob das Update angewendet wurde oder nicht; wahr oder falsch Lesezugriff
installation-size Die Größe des Updates in Byte Lesezugriff
after-apply-guidance Ob der XAPI-Toolstack oder der Host einen Neustart erfordert Lesezugriff
version Die Version des Updates Lesezugriff

update-upload

xe update-upload file-name=update_filename
<!--NeedCopy-->

Laden Sie eine angegebene Aktualisierungsdatei auf den Citrix Hypervisor-Server hoch. Dieser Befehl bereitet ein anzuwendendes Update vor. Bei Erfolg wird die UUID des hochgeladenen Updates gedruckt. Wenn das Update zuvor hochgeladen wurde, wird stattdessen ein Fehler UPDATE_ALREADY_EXISTS zurückgegeben und der Patch wird nicht erneut hochgeladen.

update-precheck

xe update-precheck uuid=update_uuid host-uuid=host_uuid
<!--NeedCopy-->

Führen Sie die im angegebenen Update enthaltenen Vorprüfungen auf dem angegebenen Citrix Hypervisor-Server aus.

update-destroy

xe update-destroy uuid=update_file_uuid
<!--NeedCopy-->

Löscht eine Aktualisierungsdatei, die nicht aus dem Pool angewendet wurde. Kann verwendet werden, um eine Aktualisierungsdatei zu löschen, die nicht auf die Hosts angewendet werden kann.

update-apply

xe update-apply host-uuid=host_uuid uuid=update_file_uuid
<!--NeedCopy-->

Wendet die angegebene Aktualisierungsdatei an.

update-pool-apply

xe update-pool-apply uuid=update_uuid
<!--NeedCopy-->

Wenden Sie das angegebene Update auf alle Citrix Hypervisor-Server im Pool an.

update-introduce

xe update-introduce vdi-uuid=vdi_uuid
<!--NeedCopy-->

Einführung des Update-VDI.

update-pool-clean

xe update-pool-clean uuid=uuid
<!--NeedCopy-->

Entfernt die Dateien des Updates von allen Hosts im Pool.

Benutzer-Befehle

user-password-change

xe user-password-change old=old_password new=new_password
<!--NeedCopy-->

Ändert das Kennwort des angemeldeten Benutzers. Das alte Kennwortfeld ist nicht aktiviert, da Sie für die Verwendung dieses Befehls Supervisor-Privileg benötigen.

VBD-Befehle

Befehle zum Arbeiten mit VBDs (Virtual Block Devices).

Eine VBD ist ein Softwareobjekt, das eine VM mit dem VDI verbindet, der den Inhalt des virtuellen Laufwerks darstellt. Die VBD hat die Attribute, die den VDI mit der VM verknüpfen (ist er bootfähig, seine Lese-/Schreibmetriken usw.). Der VDI enthält Informationen zu den physikalischen Attributen des virtuellen Laufwerks (welcher SR-Typ, ob der Datenträger gemeinsam genutzt werden kann, ob das Medium schreibgeschützt oder schreibgeschützt ist usw.).

Die VBD-Objekte können mit dem Standard-Objektauflistungsbefehl (xe vbd-list) aufgelistet werden, und die Parameter können mit den Standardparameterbefehlen bearbeitet werden. Weitere Informationen finden Sie unter Parameterbefehle auf niedriger Ebene

VBD-Parameter

VBDs haben die folgenden Parameter:

Parametername Beschreibung Typ
uuid Die eindeutige Identifikator/Objektreferenz für die VBD Lesezugriff
vm-uuid Die eindeutige Bezeichner/Objektreferenz für die VM, an die diese VBD angehängt ist Lesezugriff
vm-name-label Der Name der VM, an die diese VBD angehängt ist Lesezugriff
vdi-uuid Die eindeutige Bezeichner/Objektreferenz für den VDI, dem dieser VBD zugeordnet ist Lesezugriff
vdi-name-label Der Name des VDI, dem dieser VBD zugeordnet ist Lesezugriff
empty Wenn truediese VBD ein leeres Laufwerk darstellt Lesezugriff
device Das Gerät, das der Gast sieht, zum Beispiel hda Lesezugriff
userdevice Gerätenummer , die durch den Geräteparameter bei vbd-create angegeben wird, z. B. 0 für hda, 1 für hdb usw. Lese-/Schreibrechte
bootable True, wenn diese VBD bootfähig ist Lese-/Schreibrechte
mode Der Modus, mit dem die VBD montiert ist Lese-/Schreibrechte
type Wie die VBD der VM erscheint, zum Beispiel Datenträger oder CD Lese-/Schreibrechte
currently-attached Wahr, wenn die VBD an diesen Host angeschlossen ist, andernfalls false Lesezugriff
storage-lock True, wenn eine Sperre auf Speicherebene erworben wurde Lesezugriff
status-code Fehler-/Erfolgscode, der mit dem letzten Anhängevorgang verknüpft ist Lesezugriff
status-detail Fehler-/Erfolgsinformationen im Zusammenhang mit dem Status des letzten Anhängevorgangs Lesezugriff
qos_algorithm_type Der zu verwendende Priorisierungsalgorithmus Lese-/Schreibrechte
qos_algorithm_params Parameter für den gewählten Priorisierungsalgorithmus Map-Parameter lesen/schreiben
qos_supported_algorithms Unterstützte Priorisierungsalgorithmen für diese VBD Schreibgeschützter Parameter
io_read_kbs Durchschnittliche Leserate in kB pro Sekunde für diese VBD Lesezugriff
io_write_kbs Durchschnittliche Schreibrate in kB pro Sekunde für diese VBD Lesezugriff
allowed-operations Liste der in diesem Status zulässigen Vorgänge Diese Liste ist nur eine Empfehlung und der Serverstatus hat sich möglicherweise geändert, bis dieses Feld von einem Client gelesen wurde. Schreibgeschützter Parameter
current-operations Verknüpft jede der laufenden Aufgaben, die dieses Objekt verwenden (als Referenz), mit einer current_operation-Aufzählung, die die Art der Aufgabe beschreibt. Schreibgeschützter Parameter
unpluggable True, wenn diese VBD Hot-Unplug unterstützt Lese-/Schreibrechte
attachable True, wenn das Gerät angeschlossen werden kann Lesezugriff
other-config Zusätzliche Konfiguration Map-Parameter lesen/schreiben

vbd-create

xe vbd-create vm-uuid=uuid_of_the_vm device=device_value vdi-uuid=uuid_of_vdi_to_connect_to [bootable=true] [type=Disk|CD] [mode=RW|RO]
<!--NeedCopy-->

Erstellen Sie eine VBD auf einer VM.

Die zulässigen Werte für das device-Feld sind Ganzzahlen 0-15, und die Zahl muss für jede VM eindeutig sein. Die aktuell zulässigen Werte können im Parameter allowed-VBD-devices auf der angegebenen VM angezeigt werden. Dies wird als userdevice in den Parametern vbd gesehen.

Wenn type auf Disk gesetzt ist, ist vdi-uuid erforderlich. Der Modus kann RO oder RW für einen Datenträger sein.

Wenn type auf CD gesetzt ist, ist vdi-uuid optional. Wenn kein VDI angegeben ist, wird eine leere VBD für die CD erstellt. Der Modus muss RO für eine CD sein.

vbd-destroy

xe vbd-destroy uuid=uuid_of_vbd
<!--NeedCopy-->

Zerstört die angegebene VBD.

Wenn der Parameter other-config:owner für die VBD auf true eingestellt ist, wird auch der zugehörige VDI zerstört.

vbd-eject

xe vbd-eject uuid=uuid_of_vbd
<!--NeedCopy-->

Entfernen Sie das Medium aus dem Laufwerk, das durch eine VBD dargestellt wird. Dieser Befehl funktioniert nur, wenn das Medium vom Typ eines Wechselmediums ist (eine physische CD oder ein ISO). Andernfalls wird eine Fehlermeldung VBD_NOT_REMOVABLE_MEDIA zurückgegeben.

vbd-insert

xe vbd-insert uuid=uuid_of_vbd vdi-uuid=uuid_of_vdi_containing_media
<!--NeedCopy-->

Legen Sie neue Medien in das durch eine VBD dargestellte Laufwerk ein. Dieser Befehl funktioniert nur, wenn das Medium vom Typ eines Wechselmediums ist (eine physische CD oder ein ISO). Andernfalls wird eine Fehlermeldung VBD_NOT_REMOVABLE_MEDIA zurückgegeben.

vbd-plug

xe vbd-plug uuid=uuid_of_vbd
<!--NeedCopy-->

Versuchen Sie, die VBD anzuhängen, während sich die VM im laufenden Zustand befindet.

vbd-unplug

xe vbd-unplug uuid=uuid_of_vbd
<!--NeedCopy-->

Versucht, die VBD von der VM zu trennen, während sie sich im laufenden Zustand befindet.

VDI-Befehle

Befehle für die Arbeit mit VDIs (Virtual Disk Images).

Ein VDI ist ein Softwareobjekt, das den Inhalt des virtuellen Laufwerks darstellt, das von einer VM gesehen wird. Dies unterscheidet sich von der VBD, bei der es sich um ein Objekt handelt, das eine VM an den VDI bindet. Der VDI enthält Informationen zu den physikalischen Attributen des virtuellen Laufwerks (welcher SR-Typ, ob der Datenträger gemeinsam genutzt werden kann, ob das Medium schreibgeschützt oder schreibgeschützt ist usw.). Die VBD hat die Attribute, die den VDI mit der VM verknüpfen (ist er bootfähig, seine Lese-/Schreibmetriken usw.).

Die VDI-Objekte können mit dem Standard-Objektauflistungsbefehl (xe vdi-list) aufgelistet werden, und die Parameter können mit den Standardparameterbefehlen manipuliert werden. Weitere Informationen finden Sie unter Parameterbefehle auf niedriger Ebene

VDI-Parameter

VDIs haben die folgenden Parameter:

Parametername Beschreibung Typ
uuid Die eindeutige Bezeichner/Objektreferenz für den VDI Lesezugriff
name-label Der Name des VDI Lese-/Schreibrechte
name-description Die Beschreibungszeichenfolge des VDI Lese-/Schreibrechte
allowed-operations Eine Liste der in diesem Status zulässigen Vorgänge Schreibgeschützter Parameter
current-operations Eine Liste der Vorgänge, die derzeit auf diesem VDI ausgeführt werden Schreibgeschützter Parameter
sr-uuid SR, in dem sich der VDI befindet Lesezugriff
vbd-uuids Eine Liste von VBDs, die sich auf diesen VDI beziehen Schreibgeschützter Parameter
crashdump-uuids Liste der Crash-Dumps, die sich auf diesen VDI beziehen Schreibgeschützter Parameter
virtual-size Größe des Datenträger, wie sie der VM präsentiert wird, in Byte. Je nach Speicher-Back-End-Typ wird die Größe möglicherweise nicht genau eingehalten Lesezugriff
physical-utilisation Menge an physischem Speicherplatz, den der VDI auf dem SR belegt, in Byte Lesezugriff
type Typ des VDI, z. B. System oder Benutzer Lesezugriff
sharable True, wenn dieser VDI geteilt werden darf Lesezugriff
read-only True, wenn dieser VDI nur schreibgeschützt gemountet werden kann Lesezugriff
storage-lock True, wenn dieser VDI auf Speicherebene gesperrt ist Lesezugriff
parent Verweist auf den übergeordneten VDI, wenn dieser VDI Teil einer Kette ist Lesezugriff
missing True, wenn der SR-Scanvorgang diesen VDI als nicht vorhanden gemeldet hat Lesezugriff
other-config Zusätzliche Konfigurationsinformationen für diesen VDI Map-Parameter lesen/schreiben
sr-name-label Name des enthaltenden Speicherrepositorys Lesezugriff
location Informationen zum Standort Lesezugriff
managed True, wenn der VDI verwaltet wird Lesezugriff
xenstore-data Daten, die in den xenstore-Baum eingefügt werden sollen (/local/domain/0/backend/ vbd/domid/device-id/smdata), nachdem der VDI angehängt wurde. Die SM-Backends setzen dieses Feld normalerweise ein vdi_attach. Schreibgeschützter Map-Parameter
sm-config SM-abhängige Daten Schreibgeschützter Map-Parameter
is-a-snapshot True, wenn dieser VDI ein VM-Speicher-Snapshot ist Lesezugriff
snapshot_of Die UUID des Speichers, von dem dieser VDI ein Snapshot ist Lesezugriff
snapshots Die UUIDs aller Snapshots dieses VDI Lesezugriff
snapshot_time Der Zeitstempel des Snapshot-Vorgangs, der diesen VDI erstellt hat Lesezugriff
metadata-of-pool Die UUID des Pools, der diesen Metadaten-VDI erstellt hat Lesezugriff
metadata-latest Flag, das angibt, ob der VDI die neuesten bekannten Metadaten für diesen Pool enthält Lesezugriff
cbt-enabled Flag, das angibt, ob Tracking geänderter Blocks für den VDI aktiviert ist Lese-/Schreibrechte

vdi-clone

xe vdi-clone uuid=uuid_of_the_vdi [driver-params:key=value]
<!--NeedCopy-->

Erstellen Sie eine neue, beschreibbare Kopie des angegebenen VDI, die direkt verwendet werden kann. Es ist eine Variante davon vdi-copy, die Hochgeschwindigkeits-Image-Klon-Funktionen verfügbar machen kann, wo sie existieren.

Verwenden Sie den optionalen Zuordnungsparameter driver-params, um zusätzliche herstellerspezifische Konfigurationsinformationen an den Back-End-Speichertreiber zu übergeben, auf dem der VDI basiert. Weitere Informationen finden Sie in der Treiberdokumentation des Speicheranbieters.

vdi-copy

xe vdi-copy uuid=uuid_of_the_vdi sr-uuid=uuid_of_the_destination_sr
<!--NeedCopy-->

Kopieren Sie einen VDI auf ein angegebenes SR.

vdi-create

xe vdi-create sr-uuid=uuid_of_sr_to_create_vdi_on name-label=name_for_the_vdi type=system|user|suspend|crashdump virtual-size=size_of_virtual_disk sm-config-*=storage_specific_configuration_data
<!--NeedCopy-->

Erstellen Sie einen VDI.

Der Parameter virtual-size kann in Byte oder mit den IEC-Standardsuffixen KiB, MiB, GiB und TiB angegeben werden.

Hinweis:

SR-Typen, die Thin Provisioning von Datenträgern unterstützen (z. B. Local VHD und NFS), erzwingen keine virtuelle Zuweisung von Datenträgern. Seien Sie vorsichtig, wenn Sie virtuellen Speicherplatz auf einem SR mehrfach zuweisen. Wenn ein zu mehrfach zugewiesenes SR voll wird, muss Speicherplatz entweder auf dem SR-Zielsubstrat oder durch Löschen nicht verwendeter VDIs in dem SR verfügbar gemacht werden.

Einige SR-Typen runden den Wert virtual-size möglicherweise auf, um ihn durch eine konfigurierte Blockgröße teilbar zu machen.

vdi-data-destroy

xe vdi-data-destroy uuid=uuid_of_vdi
<!--NeedCopy-->

Löschen Sie die mit dem angegebenen VDI verknüpften Daten, behalten Sie jedoch die Metadaten für das Tracking geänderter Blocks bei.

Hinweis:

Wenn Sie Changed-Block-Tracking verwenden, um inkrementelle Backups des VDI zu erstellen, stellen Sie sicher, dass Sie den Befehl vdi-data-destroy verwenden, um Snapshots zu löschen, aber die Metadaten beizubehalten. Verwenden Sie vdi-destroy nicht für Snapshots von VDIs, bei denen das Tracking geänderter Blocks aktiviert wurde.

vdi-destroy

xe vdi-destroy uuid=uuid_of_vdi
<!--NeedCopy-->

Zerstört den angegebenen VDI.

Hinweis:

Wenn Sie Changed-Block-Tracking verwenden, um inkrementelle Backups des VDI zu erstellen, stellen Sie sicher, dass Sie den Befehl vdi-data-destroy verwenden, um Snapshots zu löschen, aber die Metadaten beizubehalten. Verwenden Sie vdi-destroy nicht für Snapshots von VDIs, bei denen das Tracking geänderter Blocks aktiviert wurde.

Bei lokalen VHD- und NFS-SR-Typen wird Speicherplatz nicht sofort mit vdi-destroy freigegeben, sondern sporadisch während eines Speicherrepositoryscanvorgangs. Wenn Sie die Bereitstellung von gelöschtem Speicherplatz erzwingen müssen, rufen Sie sr-scan manuell auf.

vdi-disable-cbt

xe vdi-disable-cbt uuid=uuid_of_vdi
<!--NeedCopy-->

Deaktivieren Sie das Tracking geänderter Blocks für den VDI.

vdi-enable-cbt

xe vdi-enable-cbt uuid=uuid_of_vdi
<!--NeedCopy-->

Aktivieren Sie das Tracking geänderter Blocks für den VDI.

Hinweis:

Sie können das Tracking geänderter Blocks nur für lizenzierte Instanzen von Citrix Hypervisor Premium Edition aktivieren.

vdi-export

xe vdi-export uuid=uuid_of_vdi filename=filename_to_export_to [format=format] [base=uuid_of_base_vdi] [--progress]
<!--NeedCopy-->

Exportiert einen VDI in den angegebenen Dateinamen. Sie können einen VDI in einem der folgenden Formate exportieren:

  • raw
  • vhd

Das VHD-Format kann sparse sein. Wenn innerhalb des VDI nicht zugewiesene Blöcke vorhanden sind, werden diese Blöcke möglicherweise in der VHD-Datei weggelassen, wodurch die VHD-Datei kleiner wird. Sie können von allen unterstützten VHD-basierten Speichertypen (EXT3/EXT4, NFS) in das VHD-Format exportieren.

Wenn Sie den Parameter base angeben, exportiert dieser Befehl nur die Blöcke, die sich zwischen dem exportierten VDI und dem Basis-VDI geändert haben.

vdi-forget

xe vdi-forget uuid=uuid_of_vdi
<!--NeedCopy-->

Entfernt bedingungslos einen VDI-Record aus der Datenbank, ohne das Speicher-Backend zu berühren. Verwenden Sie im Normalbetrieb stattdessen vdi-destroy.

vdi-import

xe vdi-import uuid=uuid_of_vdi filename=filename_to_import_from [format=format] [--progress]
<!--NeedCopy-->

Importieren Sie ein VDI. Sie können einen VDI aus einem der folgenden Formate importieren:

  • raw
  • vhd

vdi-introduce

xe vdi-introduce uuid=uuid_of_vdi sr-uuid=uuid_of_sr name-label=name_of_new_vdi type=system|user|suspend|crashdump location=device_location_(varies_by_storage_type) [name-description=description_of_vdi] [sharable=yes|no] [read-only=yes|no] [other-config=map_to_store_misc_user_specific_data] [xenstore-data=map_to_of_additional_xenstore_keys] [sm-config=storage_specific_configuration_data]
<!--NeedCopy-->

Erstellen Sie ein VDI-Objekt, das ein vorhandenes Speichergerät darstellt, ohne tatsächlich Speicher zu ändern oder zu erstellen. Dieser Befehl wird hauptsächlich intern verwendet, um Hot-Plug-Speichergeräte automatisch einzuführen.

vdi-list-changed-blocks

xe vdi-list-changed-blocks vdi-from-uuid=first-vdi-uuid vdi-to-uuid=second-vdi-uuid
<!--NeedCopy-->

Vergleichen Sie zwei VDIs und geben Sie die Liste der Blöcke, die sich zwischen den beiden geändert haben, als Base64-codierte Zeichenfolge zurück. Dieser Befehl funktioniert nur für VDIs, bei denen das Tracking geänderter Blocks aktiviert wurde.

Weitere Informationen finden Sie unter Tracking geänderter Blocks.

vdi-pool-migrate

xe vdi-pool-migrate uuid=VDI_uuid sr-uuid=destination-sr-uuid
<!--NeedCopy-->

Migrieren Sie einen VDI zu einem angegebenen SR, während der VDI an einen laufenden Gast angeschlossen ist. (Speicher-Livemigration)

Weitere Informationen finden Sie unter Migrieren von virtuellen Rechnern.

vdi-resize

xe vdi-resize uuid=vdi_uuid disk-size=new_size_for_disk
<!--NeedCopy-->

Ändern Sie die Größe des durch UUID angegebenen VDI.

vdi-snapshot

xe vdi-snapshot uuid=uuid_of_the_vdi [driver-params=params]
<!--NeedCopy-->

Erstellt eine Lese-/Schreibversion eines VDI, die als Referenz für Backup- oder Vorlagenerstellungszwecke oder beides verwendet werden kann. Verwenden Sie den Snapshot, um eine Backup durchzuführen, anstatt Backupsoftware innerhalb der VM zu installieren und auszuführen. Die VM wird weiterhin ausgeführt, während externe Backupsoftware den Inhalt des Snapshots auf das Backupmedium streamt. In ähnlicher Weise kann ein Snapshot als “Goldenes Image” verwendet werden, auf dem eine Vorlage basiert. Eine Vorlage kann mit beliebigen VDIs erstellt werden.

Verwenden Sie den optionalen Zuordnungsparameter driver-params, um zusätzliche herstellerspezifische Konfigurationsinformationen an den Back-End-Speichertreiber zu übergeben, auf dem der VDI basiert. Weitere Informationen finden Sie in der Treiberdokumentation des Speicheranbieters.

Ein Klon eines Snapshots erzeugt immer einen beschreibbaren VDI.

vdi-unlock

xe vdi-unlock uuid=uuid_of_vdi_to_unlock [force=true]
<!--NeedCopy-->

Versucht, die angegebenen VDIs zu entsperren. Wenn force=true an den Befehl übergeben wird, erzwingt es den Entsperrvorgang.

vdi-update

xe vdi-update uuid=uuid
<!--NeedCopy-->

Aktualisieren Sie die Felder des VDI-Objekts in der Datenbank.

VIF-Befehle

Befehle zum Arbeiten mit VIFs (Virtual Network Interfaces).

Die VIF-Objekte können mit dem Standard-Objektauflistungsbefehl (xe vif-list) aufgelistet werden, und die Parameter können mit den Standardparameterbefehlen bearbeitet werden. Weitere Informationen finden Sie unter Parameterbefehle auf niedriger Ebene

VIF-Parameter

VIFs haben die folgenden Parameter:

  • uuid (schreibgeschützt) die eindeutige Bezeichner/Objektreferenz für das VIF
  • vm-uuid (schreibgeschützt) die eindeutige Bezeichner/Objektreferenz für die VM, auf der sich dieses VIF befindet
  • vm-name-label (schreibgeschützt) der Name der VM, auf der sich dieses VIF befindet
  • allowed-operations (schreibgeschützter Set-Parameter) eine Liste der in diesem Zustand zulässigen Vorgänge
  • current-operations (schreibgeschützter Set-Parameter) eine Liste der Vorgänge, die derzeit auf diesem VIF ausgeführt werden
  • device (schreibgeschützt) Integer-Label dieses VIF, das die Reihenfolge angibt, in der VIF-Backends erstellt wurden
  • MAC (schreibgeschützt) MAC-Adresse von VIF, wie sie der VM ausgesetzt ist
  • MTU (schreibgeschützt) Maximale Übertragungseinheit des VIF in Byte.

    Dieser Parameter ist schreibgeschützt, Sie können jedoch die MTU-Einstellung mit dem Schlüssel mtu überschreiben mit dem Map-Parameter other-config. Um beispielsweise die MTU auf einer virtuellen Netzwerkkarte zurückzusetzen, um Jumbo-Frames zu verwenden:

     xe vif-param-set \
         uuid=<vif_uuid> \
         other-config:mtu=9000
     <!--NeedCopy-->
    
  • currently-attached (schreibgeschützt) true wenn das Gerät angeschlossen ist
  • qos_algorithm_type (lesen/schreiben) zu verwendender QoS-Algorithmus
  • qos_algorithm_params (Map-Parameter lesen/schreiben) für den ausgewählten QoS-Algorithmus
  • qos_supported_algorithms (schreibgeschützter Set-Parameter) unterstützte QoS-Algorithmen für dieses VIF
  • MAC-autogenerated (schreibgeschützt) True, wenn die MAC-Adresse des VIF automatisch generiert wurde
  • other-config (Map-Parameter lesen/schreiben) Zusätzliche key:value-Konfigurationspaare
  • other-config:ethtoolrx (Lesen/Schreiben) auf on setzen, um Prüfsumme empfangen zu können, aus zum Deaktivieren
  • other-config:ethtooltx (Lesen/Schreiben) auf on gesetzt, um Prüfsumme zu übertragen, aus zum Deaktivieren
  • other-config:ethtoolsg (Lesen/Schreiben) auf on setzen, um Scatter Gather zu aktivieren, aus zum Deaktivieren
  • other-config:ethtooltso (Lesen/Schreiben) auf on gesetzt, um TCP-Segmentierungs-Offload zu ermöglichen, aus zum Deaktivieren
  • other-config:ethtoolufo (Lesen/Schreiben) auf on gesetzt, um das Abladen von UDP-Fragmenten zu ermöglichen, aus zum Deaktivieren
  • other-config:ethtoolgso (Lesen/Schreiben) auf on gesetzt, um generische Segmentierungsabladung zu ermöglichen, aus zum Deaktivieren
  • other-config:promiscuous (Lesen/Schreiben) entspricht einem VIF, um auf der Brücke promiskuitiv zu sein, so dass es den gesamten Verkehr über die Brücke sieht. Nützlich zum Ausführen eines Intrusion Detection Systems (IDS) oder ähnlichem in einer VM.
  • network-uuid (schreibgeschützt) die eindeutige Bezeichner/Objektreferenz des virtuellen Netzwerks, an das dieses VIF angeschlossen ist
  • network-name-label (schreibgeschützt) der beschreibende Name des virtuellen Netzwerks, mit dem dieses VIF verbunden ist
  • io_read_kbs (schreibgeschützt) durchschnittliche Leserate in KB/s für dieses VIF
  • io_write_kbs (schreibgeschützt) durchschnittliche Schreibrate in KB/s für dieses VIF
  • locking_mode (Lesen/Schreiben) Beeinflusst die Fähigkeit von VIFs, Datenverkehr zu/von einer Liste von MAC- und IP-Adressen zu filtern. Benötigt zusätzliche Parameter.
  • locking_mode:default (Lesen/Schreiben) Variiert je nach Standardsperrmodus für das VIF-Netzwerk.

    Wenn der Standardsperrmodus auf festgelegt ist disabled, wendet Citrix Hypervisor eine Filterregel an, damit das VIF keinen Datenverkehr senden oder empfangen kann. Wenn der Standardsperrmodus auf festgelegt ist unlocked, entfernt Citrix Hypervisor alle mit dem VIF verknüpften Filterregeln. Weitere Informationen finden Sie unter Netzwerkbefehle.

  • locking_mode:locked (Lesen/Schreiben) Im VIF ist nur Datenverkehr zulässig, der an oder von den angegebenen MAC- und IP-Adressen gesendet wird. Wenn keine IP-Adressen angegeben sind, ist kein Datenverkehr zulässig.
  • locking_mode:unlocked (Lesen/Schreiben) Es werden keine Filter auf Datenverkehr angewendet, der zum oder vom VIF geht.
  • locking_mode:disabled (Lesen/Schreiben) Citrix Hypervisor wendet eine Filterregel an, damit das VIF den gesamten Datenverkehr löscht.

vif-create

xe vif-create vm-uuid=uuid_of_the_vm device=see below network-uuid=uuid_of_network_to_connect_to [mac=mac_address]
<!--NeedCopy-->

Erstellen Sie eine VIF auf einer VM.

Entsprechende Werte für das device-Feld sind im Parameter allowed-VIF-devices auf der angegebenen VM aufgeführt. Bevor dort VIFs existieren, sind die zulässigen Werte ganze Zahlen von 0-15.

Der Parameter mac ist die Standard-MAC-Adresse im Format aa:bb:cc:dd:ee:ff. Wenn Sie es nicht spezifiziert lassen, wird eine entsprechende zufällige MAC-Adresse erstellt. Sie können auch explizit eine zufällige MAC-Adresse festlegen, indem Sie angeben mac=random.

vif-destroy

xe vif-destroy uuid=uuid_of_vif
<!--NeedCopy-->

Zerstöre ein VIF.

vif-move

xe vif-move uuid=uuid network-uuid=network_uuid
<!--NeedCopy-->

Verschieben Sie das VIF in ein anderes Netzwerk.

vif-plug

xe vif-plug uuid=uuid_of_vif
<!--NeedCopy-->

Versuchen Sie, das VIF anzuhängen, während sich die VM im laufenden Zustand befindet.

vif-unplug

xe vif-unplug uuid=uuid_of_vif
<!--NeedCopy-->

Versucht, das VIF während der Ausführung von der VM zu trennen.

vif-configure-ipv4

Konfigurieren Sie IPv4-Einstellungen für diese virtuelle Schnittstelle. Stellen Sie die IPv4-Einstellungen wie folgt ein:

xe vif-configure-ipv4 uuid=uuid_of_vif mode=static address=CIDR_address gateway=gateway_address
<!--NeedCopy-->

Beispiel:

VIF.configure_ipv4(vifObject,"static", " 192.168.1.10/24", " 192.168.1.1")
<!--NeedCopy-->

Reinigen Sie die IPv4-Einstellungen wie folgt:

xe vif-configure-ipv4 uuid=uuid_of_vif mode=none
<!--NeedCopy-->

vif-configure-ipv6

Konfigurieren Sie IPv6-Einstellungen für diese virtuelle Schnittstelle. Stellen Sie die IPv6-Einstellungen wie folgt ein:

xe vif-configure-ipv6 uuid=uuid_of_vif mode=static address=IP_address gateway=gateway_address
<!--NeedCopy-->

Beispiel:

VIF.configure_ipv6(vifObject,"static", "fd06:7768:b9e5:8b00::5001/64", "fd06:7768:b9e5:8b00::1")
<!--NeedCopy-->

Reinigen Sie die IPv6-Einstellungen wie folgt:

xe vif-configure-ipv6 uuid=uuid_of_vif mode=none
<!--NeedCopy-->

VLAN-Befehle

Befehle zum Arbeiten mit VLANs (virtuelle Netzwerke). Informationen zum Auflisten und Bearbeiten virtueller Schnittstellen finden Sie in den PIF-Befehlen, die über einen VLAN-Parameter verfügen, um zu signalisieren, dass sie über ein zugehöriges virtuelles Netzwerk verfügen. Weitere Informationen finden Sie unter PIF-Befehle. Um beispielsweise VLANs aufzulisten, verwenden Sie xe pif-list.

vlan-create

xe vlan-create pif-uuid=uuid_of_pif vlan=vlan_number network-uuid=uuid_of_network
<!--NeedCopy-->

Erstellen Sie ein VLAN auf Ihrem Citrix Hypervisor-Server.

pool-vlan-create

xe pool-vlan-create pif-uuid=uuid_of_pif vlan=vlan_number network-uuid=uuid_of_network
<!--NeedCopy-->

Erstellen Sie ein VLAN auf allen Hosts in einem Pool, indem Sie festlegen, auf welcher Schnittstelle (z. B. eth0) sich das angegebene Netzwerk befindet (auf jedem Host) und ein neues PIF-Objekt an jedem Host entsprechend erstellen und einstecken.

vlan-destroy

xe vlan-destroy uuid=uuid_of_pif_mapped_to_vlan
<!--NeedCopy-->

Zerstöre ein VLAN. Benötigt die UUID des PIF, das das VLAN darstellt.

VM-Befehle

Befehle zur Steuerung von virtuellen Rechnern und ihren Attributen.

VM-Selektoren

Einige der hier aufgeführten Befehle haben einen gemeinsamen Mechanismus zum Auswählen einer oder mehrerer VMs, auf denen der Vorgang ausgeführt werden soll. Der einfachste Weg ist die Angabe des Arguments vm=name_or_uuid. Eine einfache Möglichkeit, die UUID einer tatsächlichen VM zu erhalten, besteht beispielsweise darin, auszuführen xe vm-list power-state=running. (Ruft die vollständige Liste der Felder ab, die mit dem Befehl xe vm-list params=all abgeglichen werden können.) Wenn Sie z. B. power-state=halted angeben, werden VMs ausgewählt, deren Parameter power-state gleich halted ist. Wenn mehrere VMs übereinstimmen, geben Sie die Option --multiple zum Ausführen des Vorgangs an. Die vollständige Liste der Parameter, die abgeglichen werden können, wird am Anfang dieses Abschnitts beschrieben.

Die VM-Objekte können mit dem Standard-Objektauflistungsbefehl (xe vm-list) aufgelistet werden, und die Parameter können mit den Standardparameterbefehlen manipuliert werden. Weitere Informationen finden Sie unter Parameterbefehle auf niedriger Ebene

VM-Parameter

Virtuelle Rechner haben die folgenden Parameter:

Hinweis:

Alle beschreibbaren VM-Parameterwerte können geändert werden, während die VM ausgeführt wird, aber neue Parameter werden nicht dynamisch angewendet und können erst angewendet werden, wenn die VM neu gestartet wurde.

  • appliance (Lesen/Schreiben) der Appliance/vApp, zu der die VM gehört
  • uuid (schreibgeschützt) die eindeutige Bezeichner/Objektreferenz für die VM
  • name-label (lesen/schreiben) der Name der VM
  • name-description (lesen/schreiben) die Beschreibungszeichenfolge der VM
  • order (Lesen/Schreiben) für das Starten/Herunterfahren der vApp und für den Start nach einem HA-Failover. VMs mit einem Ordnungswert von 0 (Null) werden zuerst gestartet, dann VMs mit einem Ordnungswert von 1 usw.
  • version (schreibgeschützt) wie oft diese VM wiederhergestellt wurde. Wenn Sie eine neue VM mit einer älteren Version überschreiben möchten, rufen Sie vm-recover
  • user-version (Lese-/Schreib-) Zeichenfolge für Ersteller von VMs und Vorlagen zum Ablegen von Versionsinformationen
  • is-a-template (Lesen/Schreiben) False, sofern diese VM keine Vorlage ist. Vorlagen-VMs können nie gestartet werden, sie werden nur zum Klonen anderer VMs verwendet. Nachdem dieser Wert auf true gesetzt wurde, kann er nicht auf false zurückgesetzt werden. Vorlagen-VMs können mit diesem Parameter nicht in virtuelle Rechner umgewandelt werden.

    Sie können eine VM in eine Vorlage konvertieren mit:

     xe vm-param-set uuid=<vm uuid> is-a-template=true
     <!--NeedCopy-->
    
  • is-control-domain (schreibgeschützt) True, wenn dies eine Steuerdomäne (Domäne 0 oder eine Treiberdomäne) ist
  • power-state (schreibgeschützt) aktueller Energiezustand
  • start-delay (lesen/schreiben) Die Wartezeit, bis ein Aufruf zum Starten der VM dauert, kehrt in Sekunden zurück
  • shutdown-delay (lesen/schreiben) Die Wartezeit, bis ein Aufruf zum Herunterfahren der VM dauert, kehrt in Sekunden zurück
  • memory-dynamic-max (Lesen/Schreiben) dynamisches Maximum in Byte
  • memory-dynamic-min (Lesen/Schreiben) dynamisches Minimum in Byte
  • memory-static-max (Lesen/Schreiben) statisch gesetztes (absolutes) Maximum in Byte. Wenn Sie diesen Wert ändern möchten, muss die VM heruntergefahren werden.
  • memory-static-min (Lesen/Schreiben) statisch gesetztes (absolutes) Minimum in Byte. Wenn Sie diesen Wert ändern möchten, muss die VM heruntergefahren werden.
  • suspend-VDI-uuid (schreibgeschützt) der VDI, auf dem ein Suspend-Image gespeichert ist
  • VCPUs-params (Zuordnungsparameter lesen/schreiben) für die ausgewählte vCPU-Richtlinie.

    Sie können das Pinning einer vCPU mit

     xe vm-param-set uuid=<vm_uuid> VCPUs-params:mask=1,2,3
     <!--NeedCopy-->
    

    Die ausgewählte VM läuft dann nur auf den physischen CPUs 1, 2 und 3. Sie können auch die vCPU-Priorität (Xen-Planung) mit den Cap- und Gewicht-Parametern optimieren. Beispiel:

     xe vm-param-set uuid=<vm_uuid> VCPUs-params:weight=512 xe vm-param-set uuid=<vm_uuid> VCPUs-params:cap=100
     <!--NeedCopy-->
    

    Eine VM mit einem Gewicht von 512 erhält auf einem umstrittenen Citrix Hypervisor-Server doppelt so viel CPU wie eine Domäne mit einem Gewicht von 256. Die zulässigen Gewichte reichen von 1 bis 65535 und die Standardeinstellung ist 256. Die Obergrenze legt optional die maximale Menge an CPU fest, die eine VM verbrauchen kann, selbst wenn der Citrix Hypervisor-Server CPU-Zyklen im Leerlauf hat. Die Obergrenze wird in Prozent einer physischen CPU ausgedrückt: 100 ist 1 physische CPU, 50 ist eine halbe CPU, 400 sind 4 CPUs usw. Der Standardwert 0 bedeutet, dass es keine Obergrenze gibt.

  • VCPUs-max (Lesen/Schreiben) maximale Anzahl virtueller CPUs.
  • VCPUs-at-startup (Lesen/Schreiben) Startnummer der virtuellen CPUs
  • actions-after-crash (Lesen/Schreiben) Aktion, die ergriffen werden muss, wenn die VM abstürzt. Für PV-Gäste sind gültige Parameter:
    • preserve (nur zur Analyse)
    • coredump_and_restart (Coredump aufzeichnen und VM neu starten)
    • coredump_and_destroy (Coredump aufzeichnen und VM angehalten lassen)
    • restart (kein Coredump und Neustart der VM)
    • destroy (kein Coredump und VM verlassen angehalten)
  • console-uuids (schreibgeschützte eingestellte Parameter) virtuelle Konsolengeräte
  • platform (Map-Parameter lesen/schreiben) plattformspezifische Konfiguration

    Deaktivieren des VDA, um Windows 10 in den Tablet-Modus zu versetzen:

     xe vm-param-set uuid=<vm_uuid> platform:acpi_laptop_slate=0
     <!--NeedCopy-->
    

    So ermöglichen Sie dem VDA, Windows 10 in den Tablet-Modus zu versetzen:

     xe vm-param-set uuid=<vm_uuid> platform:acpi_laptop_slate=1
     <!--NeedCopy-->
    

    Um den aktuellen Status zu überprüfen:

     xe vm-param-get uuid=<vm_uuid> param-name=platform param-key=acpi_laptop_slate
     <!--NeedCopy-->
    
  • allowed-operations (schreibgeschützt eingestellter Parameter) Liste der in diesem Zustand zulässigen Operationen
  • current-operations (schreibgeschützter Set-Parameter) eine Liste der Vorgänge, die derzeit auf der VM ausgeführt werden
  • allowed-VBD-devices (schreibgeschützter Set-Parameter) Liste der zur Verwendung verfügbaren VBD-Identifikatoren, dargestellt durch Ganzzahlen im Bereich 0—15. Diese Liste dient nur zur Information und andere Geräte können verwendet werden (funktioniert aber möglicherweise nicht).
  • allowed-VIF-devices (schreibgeschützter Set-Parameter) Liste der zur Verwendung verfügbaren VIF-Identifikatoren, dargestellt durch Ganzzahlen im Bereich 0—15. Diese Liste dient nur zur Information und andere Geräte können verwendet werden (funktioniert aber möglicherweise nicht).
  • HVM-boot-policy (Lesen/Schreiben) der Boot-Richtlinie für HVM-Gäste. Entweder BIOS Order oder eine leere Zeichenfolge.
  • HVM-boot-params (Zuordnungsparameter lesen/schreiben) Der Ordnungsschlüssel steuert die Startreihenfolge des HVM-Gastes, dargestellt als Zeichenfolge, wobei jedes Zeichen eine Startmethode ist: d für die CD/DVD, c für den Stammdatenträger und n für den Netzwerk-PXE-Start. Die Standardeinstellung ist Gleichstrom.
  • HVM-shadow-multiplier (Lese-/Schreibzugriff) Gleitkommawert, der den Schattenspeicher-Overhead steuert, der der VM gewährt werden soll. Der Standardwert ist 1,0 (der Mindestwert). Ändern Sie diesen Wert nur, wenn Sie ein fortgeschrittener Benutzer sind.
  • PV-kernel (lesen/schreiben) Pfad zum Kernel
  • PV-ramdisk (lesen/schreiben) Pfad zum initrd
  • PV-args (lesen/schreiben) Zeichenfolge von Kernel-Befehlszeilenargumenten
  • PV-legacy-args (lesen/schreiben) Zeichenfolge von Argumenten, um ältere VMs zum Booten zu bringen
  • PV-bootloader (lesen/schreiben) Name oder Pfad zum Bootloader
  • PV-bootloader-args (lesen/schreiben) Zeichenfolge mit verschiedenen Argumenten für den Bootloader
  • last-boot-CPU-flags (schreibgeschützt) beschreibt die CPU-Flags, auf denen die VM zuletzt gebootet wurde
  • resident-on (schreibgeschützt) der Citrix Hypervisor-Server, auf dem eine VM ansässig ist
  • affinity (Lesen/Schreiben) Der Citrix Hypervisor-Server, auf dem die VM bevorzugt ausgeführt wird. Wird vom Befehl xe vm-start verwendet, um zu entscheiden, wo die VM ausgeführt werden soll.
  • other-config (Zuordnungsparameter mit Lese-/Schreibzugriff) Eine Liste von Schlüssel/Wert-Paaren, die zusätzliche Konfigurationsparameter für die VM angeben.

    Das other-config-Schlüssel/Wert-Paar auto_poweron: true fordert beispielsweise an, die VM automatisch zu starten, nachdem ein Host im Pool gestartet wurde. Sie müssen diesen Parameter auch in Ihrem Pool unter other-config festlegen. Diese Parameter sind jetzt veraltet. Verwenden Sie stattdessen den Parameter ha-restart-priority.

  • start-time (schreibgeschützt) Zeitstempel des Datums und der Uhrzeit, zu der die Metriken für die VM gelesen wurden. Dieser Zeitstempel hat das Format yyyymmddThh:mm:ss z, in der z der einbuchstabige militärische Zeitzonenindikator ist, z. B. Z für UTC (GMT)
  • install-time (schreibgeschützt) Zeitstempel des Datums und der Uhrzeit, zu der die Metriken für die VM gelesen wurden. Dieser Zeitstempel hat das Format yyyymmddThh:mm:ss z, in der z der einbuchstabige militärische Zeitzonenindikator ist, z. B. Z für UTC (GMT)
  • memory-actual (schreibgeschützt) der tatsächliche Speicher, der von einer VM verwendet wird
  • VCPUs-number (schreibgeschützt) die Anzahl der virtuellen CPUs, die der VM für eine Linux-VM zugewiesen sind. Diese Nummer kann von VCPUS-max abweichen und kann geändert werden, ohne die VM mit dem Befehl vm-vcpu-hotplug neu zu starten. Weitere Informationen finden Sie unter vm-vcpu-hotplug. Windows-VMs werden immer mit der Anzahl der vCPUs ausgeführt, die in VCPUsmaxeingestellt ist, und müssen neu gestartet werden, um diesen Wert zu ändern. Die Leistung nimmt stark ab, wenn Sie einen Wert festlegen VCPUs-number, der größer ist als die Anzahl der physischen CPUs auf dem Citrix Hypervisor-Server.
  • VCPUs-Utilization (schreibgeschützter Map-Parameter) eine Liste virtueller CPUs und deren Gewicht
  • os-version (schreibgeschützter Zuordnungsparameter) die Version des Betriebssystems für die VM
  • PV-drivers-version (schreibgeschützter Map-Parameter) die Versionen der paravirtualisierten Treiber für die VM
  • PV-drivers-detected (schreibgeschützt) Flag für die neueste Version der paravirtualisierten Treiber für die VM
  • memory (schreibgeschützte Zuordnungsparameter) Speichermetriken, die vom Agent auf der VM gemeldet wurden
  • disks (schreibgeschützte Zuordnungsparameter) Datenträgermetriken, die vom Agent auf der VM gemeldet wurden
  • networks (schreibgeschützte Zuordnungsparameter) Netzwerkmetriken, die vom Agent auf der VM gemeldet wurden
  • other (schreibgeschützter Zuordnungsparameter) andere vom Agent auf der VM gemeldete Metriken
  • guest-metrics-lastupdated (schreibgeschützt) Zeitstempel, an dem der Gast-Agent den letzten Schreibvorgang in diese Felder ausgeführt hat. Der Zeitstempel hat das Format yyyymmddThh:mm:ss z, wobei z die militärische Zeitzonenanzeige mit einem Buchstaben ist, z. B. Z für UTC (GMT)
  • actions-after-shutdown (Lesen/Schreiben) Aktion, die nach dem Herunterfahren der VM ausgeführt werden soll
  • actions-after-reboot (Lesen/Schreiben) Aktion, die nach dem Neustart der VM ausgeführt werden soll
  • possible-hosts potenzielle Hosts dieser VM schreibgeschützt
  • dom-id (schreibgeschützt) Domänen-ID (falls verfügbar, andernfalls -1)
  • recommendations (schreibgeschützt) XML-Spezifikation der empfohlenen Werte und Bereiche für Eigenschaften dieser VM
  • xenstore-data (Map-Parameter lesen/schreiben) Daten, die nach dem Erstellen der VM in die xenstore-Struktur (/local/domain/*domid*/vm-data) eingefügt werden
  • is-a-snapshot (schreibgeschützt) True, wenn diese VM ein Snapshot ist
  • snapshot_of (schreibgeschützt) die UUID der VM, zu der dieser Snapshot gehört
  • snapshots (schreibgeschützt) die UUIDs aller Snapshots dieser VM
  • snapshot_time (schreibgeschützt) der Zeitstempel des Snapshot-Vorgangs, der diesen VM-Snapshot erstellt hat
  • memory-target (schreibgeschützt) die für diese VM festgelegte Zielmenge an Arbeitsspeicher
  • blocked-operations (Map-Parameter mit Lese-/Schreibzugriff) listet die Vorgänge auf, die auf dieser VM nicht ausgeführt werden können
  • last-boot-record (schreibgeschützt) Aufzeichnung der letzten Bootparameter für diese Vorlage im XML-Format
  • ha-always-run (Lesen/Schreiben) True, wenn diese VM immer auf einem anderen Host neu gestartet wird, wenn der Host, auf dem sie sich befindet, ausfällt. Dieser Parameter ist jetzt veraltet. Verwenden Sie stattdessen den Parameter ha-restart-priority.
  • ha-restart-priority (Lesen/Schreiben) Neustart oder Bestleistung
  • blobs (schreibgeschützt) binärer Datenspeicher
  • live (schreibgeschützt) True, wenn die VM läuft. False, wenn HA vermutet, dass die VM nicht läuft.

vm-assert-can-be-recovered

xe vm-assert-can-be-recovered uuid [database] vdi-uuid
<!--NeedCopy-->

Testet, ob Speicher für die Wiederherstellung dieser VM verfügbar ist.

vm-call-plugin

xe vm-call-plugin vm-uuid=vm_uuid plugin=plugin fn=function [args:key=value]
<!--NeedCopy-->

Ruft die Funktion innerhalb des Plug-Ins auf der angegebenen VM mit optionalen Argumenten auf (args:key=value). Um eine “value” -Zeichenfolge mit Sonderzeichen zu übergeben (z. B. neue Zeile), kann eine alternative Syntax args:key:file=local_file verwendet werden, wobei der Inhalt von local_file abgerufen und “key” als Ganzes zugewiesen wird.

vm-cd-add

xe vm-cd-add cd-name=name_of_new_cd device=integer_value_of_an_available_vbd [vm-selector=vm_selector_value...]
<!--NeedCopy-->

Fügen Sie der ausgewählten VM eine neue virtuelle CD hinzu. Wählen Sie den Parameter device aus dem Wert des Parameters allowed-VBD-devices der VM aus.

Die VM oder VMs, auf denen dieser Vorgang ausgeführt wird, werden über den Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten VM-Parameter sein.

vm-cd-eject

xe vm-cd-eject [vm-selector=vm_selector_value...]
<!--NeedCopy-->

Werfen Sie eine CD aus dem virtuellen CD-Laufwerk aus. Dieser Befehl funktioniert nur, wenn genau eine CD an die VM angeschlossen ist. Wenn zwei oder mehr CDs vorhanden sind, verwenden Sie den Befehl xe vbd-eject und geben Sie die UUID der VBD an.

Die VM oder VMs, auf denen dieser Vorgang ausgeführt wird, werden über den Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten VM-Parameter sein.

vm-cd-insert

xe vm-cd-insert cd-name=name_of_cd [vm-selector=vm_selector_value...]
<!--NeedCopy-->

Legen Sie eine CD in das virtuelle CD-Laufwerk ein. Dieser Befehl funktioniert nur, wenn genau ein leeres CD-Gerät an die VM angeschlossen ist. Wenn zwei oder mehr leere CD-Geräte vorhanden sind, verwenden Sie den Befehl xe vbd-insert und geben Sie die UUIDs der VBD und des VDI an, die eingefügt werden sollen.

Die VM oder VMs, auf denen dieser Vorgang ausgeführt wird, werden über den Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten VM-Parameter sein.

vm-cd-list

xe vm-cd-list [vbd-params] [vdi-params] [vm-selector=vm_selector_value...]
<!--NeedCopy-->

Listet CDs auf, die an die angegebenen VMs angeschlossen

Die VM oder VMs, auf denen dieser Vorgang ausgeführt wird, werden über den Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten VM-Parameter sein.

Sie können auch auswählen, welche VBD- und VDI-Parameter aufzulisten sind.

vm-cd-remove

xe vm-cd-remove cd-name=name_of_cd [vm-selector=vm_selector_value...]
<!--NeedCopy-->

Entfernen Sie eine virtuelle CD von den angegebenen virtuellen Rechnern.

Die VM oder VMs, auf denen dieser Vorgang ausgeführt wird, werden über den Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten VM-Parameter sein.

vm-checkpoint

xe vm-checkpoint new-name-label=name_label [new-name-description=description]
<!--NeedCopy-->

Überprüfen Sie eine vorhandene VM und verwenden Sie den schnellen Datenträger-Snapshot-Betrieb auf Speicherebene, sofern verfügbar.

vm-clone

xe vm-clone new-name-label=name_for_clone [new-name-description=description_for_clone] [vm-selector=vm_selector_value...]
<!--NeedCopy-->

Klonen Sie eine vorhandene VM und verwenden Sie den schnellen Datenträgerklonvorgang auf Speicherebene, sofern verfügbar. Geben Sie den Namen und die optionale Beschreibung für die resultierende geklonte VM mit den Argumenten new-name-label und new-name-description an.

Die VM oder VMs, auf denen dieser Vorgang ausgeführt wird, werden über den Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten VM-Parameter sein.

vm-compute-maximum-memory

xe vm-compute-maximum-memory total=amount_of_available_physical_ram_in_bytes [approximate=add overhead memory for additional vCPUS? true|false] [vm_selector=vm_selector_value...]
<!--NeedCopy-->

Berechnen Sie die maximale Menge an statischem Speicher, die einer vorhandenen VM zugewiesen werden kann, indem Sie die Gesamtmenge an physischem RAM als Obergrenze verwenden. Der optionale Parameter approximate reserviert ausreichend zusätzlichen Speicher in der Berechnung, um das spätere Hinzufügen zusätzlicher vCPUs zur VM zu berücksichtigen.

Beispiel:

xe vm-compute-maximum-memory vm=testvm total=`xe host-list params=memory-free --minimal`
<!--NeedCopy-->

Dieser Befehl verwendet den Wert des vom Befehl xe host-list zurückgegebenen Parameters memory-free, um den maximalen Speicher der VM testvm festzulegen.

Die VM oder VMs, auf denen dieser Vorgang ausgeführt wird, werden über den Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten VM-Parameter sein.

vm-compute-memory-overhead

xe vm-compute-memory-overhead
<!--NeedCopy-->

Berechnet den Virtualisierungsspeicher-Overhead einer VM.

vm-copy

xe vm-copy new-name-label=name_for_copy [new-name-description=description_for_copy] [sr-uuid=uuid_of_sr] [vm-selector=vm_selector_value...]
<!--NeedCopy-->

Kopieren Sie eine vorhandene VM, ohne den schnellen Datenträgerklonvorgang auf Speicherebene zu verwenden (auch wenn diese Option verfügbar ist). Bei den Disk-Images der kopierten VM handelt es sich garantiert um vollständige Images, d. h. sie sind nicht Teil einer Copy-on-Write-Kette (CoW).

Geben Sie den Namen und die optionale Beschreibung für die resultierende kopierte VM mit den Argumenten new-name-label und new-name-description an.

Geben Sie das Ziel-SR für die resultierende kopierte VM mit sr-uuid an. Wenn dieser Parameter nicht angegeben wird, entspricht das Ziel demselben SR, in dem die ursprüngliche VM ist.

Die VM oder VMs, auf denen dieser Vorgang ausgeführt wird, werden über den Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten VM-Parameter sein.

vm-copy-bios-strings

xe vm-copy-bios-strings host-uuid=host_uuid
<!--NeedCopy-->

Kopieren Sie die BIOS-Strings des angegebenen Hosts auf die VM.

Hinweis:

Nachdem Sie eine VM zum ersten Mal gestartet haben, können Sie ihre BIOS-Zeichenfolgen nicht ändern. Stellen Sie sicher, dass die BIOS-Zeichenfolgen korrekt sind, bevor Sie die VM zum ersten Mal starten.

vm-crashdump-list

xe vm-crashdump-list [vm-selector=vm selector value...]
<!--NeedCopy-->

Listet Crashdumps auf, die mit den angegebenen VMs verknüpft sind

Wenn Sie das optionale Argument verwenden params, ist der Wert von params eine Zeichenfolge, die eine Liste von Parametern dieses Objekts enthält, die Sie anzeigen möchten. Alternativ können Sie das Schlüsselwort verwenden all, um alle Parameter anzuzeigen. Wenn params nicht verwendet wird, zeigt die zurückgegebene Liste eine Standardteilmenge aller verfügbaren Parameter an.

Die VM oder VMs, auf denen dieser Vorgang ausgeführt wird, werden über den Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten VM-Parameter sein.

vm-data-source-list

xe vm-data-source-list [vm-selector=vm selector value...]
<!--NeedCopy-->

Listen Sie die Datenquellen auf, die für eine VM aufgezeichnet werden können.

Wählen Sie die VMs aus, auf denen dieser Vorgang ausgeführt werden soll, indem Sie den Standardauswahlmechanismus verwenden. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten VM-Parameter sein. Wenn keine Parameter zur Auswahl von Hosts angegeben sind, wird der Vorgang auf allen VMs ausgeführt.

Datenquellen haben zwei Parameter - standard und enabled -, die Sie in der Ausgabe dieses Befehls sehen können. Wenn in einer Datenquelle enabled auf true festgelegt wurde, werden die Metriken derzeit in der Performance-Datenbank aufgezeichnet. Wenn für eine Datenquelle standard auf true eingestellt ist, werden die Metriken standardmäßig in der Performance-Datenbank aufgezeichnet (und enabled ist auch für diese Datenquelle auf true festgelegt). Wenn für eine Datenquelle standard auf false eingestellt ist, werden die Metriken nicht standardmäßig in der Performance-Datenbank aufgezeichnet (und enabled sind auch für diese Datenquelle auf false festgelegt).

Führen Sie den Befehl vm-data-source-record aus, um die Aufzeichnung von Datenquellenmetriken in der Performance-Datenbank zu starten. Mit diesem Befehl wird enabled auf true festgelegt. Um aufzuhören, führe das aus vm-data-source-forget. Mit diesem Befehl wird enabled auf false festgelegt.

vm-data-source-record

xe vm-data-source-record data-source=name_description_of_data-source [vm-selector=vm selector value...]
<!--NeedCopy-->

Notieren Sie die angegebene Datenquelle für eine VM.

Bei diesem Vorgang werden die Informationen aus der Datenquelle in die Datenbank der persistenten Leistungsmetriken der angegebenen VMs geschrieben. Aus Leistungsgründen unterscheidet sich diese Datenbank von der normalen Agentdatenbank.

Wählen Sie die VMs aus, auf denen dieser Vorgang ausgeführt werden soll, indem Sie den Standardauswahlmechanismus verwenden. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten VM-Parameter sein. Wenn keine Parameter zur Auswahl von Hosts angegeben sind, wird der Vorgang auf allen VMs ausgeführt.

vm-data-source-forget

xe vm-data-source-forget data-source=name_description_of_data-source [vm-selector=vm selector value...]
<!--NeedCopy-->

Beenden Sie die Aufzeichnung der angegebenen Datenquelle für eine VM und vergessen Sie alle aufgezeichneten Daten.

Wählen Sie die VMs aus, auf denen dieser Vorgang ausgeführt werden soll, indem Sie den Standardauswahlmechanismus verwenden. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten VM-Parameter sein. Wenn keine Parameter zur Auswahl von Hosts angegeben sind, wird der Vorgang auf allen VMs ausgeführt.

vm-data-source-query

xe vm-data-source-query data-source=name_description_of_data-source [vm-selector=vm_selector_value...]
<!--NeedCopy-->

Zeigt die angegebene Datenquelle für eine VM an.

Wählen Sie die VMs aus, auf denen dieser Vorgang ausgeführt werden soll, indem Sie den Standardauswahlmechanismus verwenden. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten VM-Parameter sein. Wenn keine Parameter zur Auswahl von Hosts angegeben sind, wird der Vorgang auf allen VMs ausgeführt.

vm-destroy

xe vm-destroy uuid=uuid_of_vm
<!--NeedCopy-->

Zerstört die angegebene VM. Dadurch bleibt der mit der VM verknüpfte Speicher intakt. Um auch Speicher zu löschen, verwenden Sie xe vm-uninstall.

vm-disk-add

xe vm-disk-add disk-size=size_of_disk_to_add device=uuid_of_device [vm-selector=vm_selector_value...]
<!--NeedCopy-->

Fügen Sie den angegebenen virtuellen Rechnern einen Datenträger hinzu. Wählen Sie den Parameter device aus dem Wert des Parameters allowed-VBD-devices der VMs aus.

Der Parameter disk-size kann in Byte oder mit den IEC-Standardsuffixen KiB, MiB, GiB und TiB angegeben werden.

Die VM oder VMs, auf denen dieser Vorgang ausgeführt wird, werden über den Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten VM-Parameter sein.

vm-disk-list

xe vm-disk-list [vbd-params] [vdi-params] [vm-selector=vm_selector_value...]
<!--NeedCopy-->

Listet die an die angegebenen VMs angeschlossenen Datenträger auf. Die Parameter vbd-params und vdi-params steuern die Felder der jeweiligen Objekte, die ausgegeben werden sollen. Geben Sie die Parameter als kommagetrennte Liste oder den speziellen Schlüssel all für die vollständige Liste an.

Die VM oder VMs, auf denen dieser Vorgang ausgeführt wird, werden über den Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten VM-Parameter sein.

vm-disk-remove

xe vm-disk-remove device=integer_label_of_disk [vm-selector=vm_selector_value...]
<!--NeedCopy-->

Entfernen Sie einen Datenträger aus den angegebenen VMs und löschen Sie ihn.

Die VM oder VMs, auf denen dieser Vorgang ausgeführt wird, werden über den Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten VM-Parameter sein.

vm-export

xe vm-export filename=export_filename [metadata=true|false] [vm-selector=vm_selector_value...]
<!--NeedCopy-->

Exportieren Sie die angegebenen VMs (einschließlich Datenträgerimages) in eine Datei auf dem lokalen Computer. Geben Sie mit dem Parameter filename den Dateinamen an, in den die VM exportiert werden soll. Konventionell hat der Dateiname eine Erweiterung .xva.

Wenn der Parameter metadata auf true gesetzt ist, werden die Datenträger nicht exportiert. Nur die VM-Metadaten werden in die Ausgabedatei geschrieben. Verwenden Sie diesen Parameter, wenn der zugrunde liegende Speicher über andere Mechanismen übertragen wird, und ermöglicht die Neuerstellung der VM-Informationen. Weitere Informationen finden Sie unter vm-import.

Die VM oder VMs, auf denen dieser Vorgang ausgeführt wird, werden über den Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten VM-Parameter sein.

vm-import

xe vm-import filename=export_filename [metadata=true|false] [preserve=true|false][sr-uuid=destination_sr_uuid]
<!--NeedCopy-->

Importieren Sie eine VM aus einer zuvor exportierten Datei. Wenn preserve auf true eingestellt ist , wird die MAC-Adresse der ursprünglichen VM beibehalten. sr-uuid bestimmt das Ziel-SR, in die die VM importiert werden soll. Wenn dieser Parameter nicht angegeben ist, wird das Standard-SR verwendet.

Wenn metadata auf true gesetzt ist, können Sie einen zuvor exportierten Satz von Metadaten ohne die zugehörigen Datenträgerblöcke importieren. Der Import nur für Metadaten schlägt fehl, wenn keine VDIs gefunden werden können (von SR benannt und VDI.location), sofern die Option --force nicht angegeben ist. In diesem Fall wird der Import trotzdem fortgesetzt. Wenn Datenträger gespiegelt oder aus dem Band verschoben werden können, ist der Import/Export von Metadaten eine schnelle Möglichkeit, VMs zwischen unzusammenhängenden Pools zu verschieben. Zum Beispiel als Teil eines Notfallwiederherstellungsplans.

Hinweis:

Mehrere VM-Importe werden seriell schneller ausgeführt als parallel.

vm-install

xe vm-install new-name-label=name [template-uuid=uuid_of_desired_template] [template=template_uuid_or_name] [sr-uuid=sr_uuid | sr-name-label=name_of_sr][copy-bios-strings-from=host_uuid]
<!--NeedCopy-->

Installieren oder klonen Sie eine VM aus einer Vorlage. Geben Sie den Vorlagennamen mit dem Argument template-uuid oder template an. Geben Sie ein SR mit dem Argument sr-uuid oder sr-name-label an. Geben Sie mit dem Argument copy-bios-strings-from an, dass BIOS-gesperrte Medien installiert werden.

Hinweis:

Bei der Installation von einer Vorlage mit vorhandenen Datenträgern werden standardmäßig neue Datenträger in demselben SR wie diese vorhandenen Datenträger erstellt. Wo das SR dies unterstützt, sind diese Datenträger schnelle Kopien. Wenn in der Befehlszeile ein anderes SR angegeben ist, werden die neuen Datenträger dort erstellt. In diesem Fall ist ein schnelles Kopieren nicht möglich und die Datenträger sind vollständige Kopien.

Bei der Installation von einer Vorlage, die keine vorhandenen Datenträger hat, werden alle neuen Datenträger in dem angegebenen SR oder dem Standard-SR des Pools erstellt, wenn kein SR angegeben ist.

vm-is-bios-customized

xe vm-is-bios-customized
<!--NeedCopy-->

Zeigt an, ob die BIOS-Zeichenfolgen der VM angepasst wurden.

vm-memory-dynamic-range-set

xe vm-memory-dynamic-range-set min=min max=max
<!--NeedCopy-->

Konfigurieren Sie den dynamischen Speicherbereich einer VM. Der dynamische Speicherbereich definiert weiche Unter- und Obergrenzen für den Speicher einer VM. Es ist möglich, diese Felder zu ändern, wenn eine VM läuft oder angehalten wird. Der Dynamikbereich muss innerhalb des statischen Bereichs liegen.

vm-memory-limits-set

xe vm-memory-limits-set static-min=static_min static-max=static_max dynamic-min=dynamic_min dynamic-max=dynamic_max
<!--NeedCopy-->

Konfigurieren Sie die Speicherbeschränkungen einer VM.

vm-memory-set

xe vm-memory-set memory=memory
<!--NeedCopy-->

Konfigurieren Sie die Speicherzuweisung einer VM.

vm-memory-shadow-multiplier-set

xe vm-memory-shadow-multiplier-set [vm-selector=vm_selector_value...] [multiplier=float_memory_multiplier]
<!--NeedCopy-->

Setzt den Schattenspeicher-Multiplikator für die angegebene VM.

Dies ist eine erweiterte Option, mit der die Größe des Shadow-Speichers geändert wird, der einer hardwareunterstützten VM zugewiesen ist.

In einigen spezialisierten Anwendungsworkloads, wie Citrix Virtual Apps, ist zusätzlicher Schattenspeicher erforderlich, um die volle Leistung zu erzielen.

Dieser Speicher wird als Overhead angesehen. Es ist von den normalen Speicherberechnungen für die Abrechnung von Speicher an eine VM getrennt. Wenn dieser Befehl aufgerufen wird, verringert sich die Menge an freiem Hostspeicher entsprechend dem Multiplikator und das Feld HVM_shadow_multiplier wird mit dem Wert aktualisiert, den Xen der VM zugewiesen hat. Wenn nicht genügend Citrix Hypervisor-Serverspeicher frei ist, wird ein Fehler zurückgegeben.

Die virtuellen Maschinen, auf denen dieser Vorgang ausgeführt werden soll, werden mithilfe des Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Selektoren.

vm-memory-static-range-set

xe vm-memory-static-range-set min=min max=max
<!--NeedCopy-->

Konfigurieren Sie den statischen Speicherbereich einer VM. Der statische Speicherbereich definiert harte Unter- und Obergrenzen für den Speicher einer VM. Es ist möglich, diese Felder nur zu ändern, wenn eine VM angehalten wird. Der statische Bereich muss den Dynamikbereich umfassen.

vm-memory-target-set

xe vm-memory-target-set target=target
<!--NeedCopy-->

Setzt das Speicherziel für eine angehaltene oder laufende VM. Der angegebene Wert muss innerhalb des Bereichs liegen, der durch die Werte memory_static_min und memory_static_max der VM definiert ist.

vm-migrate

xe vm-migrate [copy=true|false] [host-uuid=destination_host_uuid] [host=name_or_ uuid_of_destination_host] [force=true|false] [live=true|false] [vm-selector=vm_selector_value...] [remote-master=destination_pool_master_uuid] [remote-username=destination_pool_username] [remote-password=destination_pool_password] [remote-network=destination_pool_network_uuid ][vif:source_vif_uuid=destination_network_uuid] [vdi:vdi_uuid=destination_sr_uuid]
<!--NeedCopy-->

Dieser Befehl migriert die angegebenen virtuellen Maschinen zwischen physischen Hosts. Der Parameter host kann entweder der Name oder die UUID des Citrix Hypervisor-Servers sein. Um beispielsweise die VM auf einen anderen Host im Pool zu migrieren, wo sich die VM-Datenträger auf einem von beiden Hosts gemeinsam genutzten Speicher befinden:

xe vm-migrate uuid=vm_uuid host-uuid=destination_host_uuid
<!--NeedCopy-->

So verschieben Sie VMs zwischen Hosts im selben Pool, die sich keinen Speicher teilen (Speicher-Livemigration):

xe vm-migrate uuid=vm_uuid host-uuid=destination_host_uuid \
    remote-master=192.0.2.35 remote-username=username remote-password=password
<!--NeedCopy-->

Für die Speicher-Live-Migration müssen Sie den Hostnamen oder die IP-Adresse, den Benutzernamen und das Kennwort für den Poolmaster angeben, auch wenn Sie innerhalb desselben Pools migrieren.

Sie können das SR wählen, in der jeder VDI gespeichert wird:

xe vm-migrate uuid=vm_uuid remote-master=192.0.2.35 remote-username=username remote-password=password host-uuid=destination_host_uuid \
    vdi:vdi_1=destination_sr1_uuid \
    vdi:vdi_2=destination_sr2_uuid \
    vdi:vdi_3=destination_sr3_uuid
<!--NeedCopy-->

Darüber hinaus können Sie auswählen, welches Netzwerk die VM nach der Migration anhängen soll:

xe vm-migrate uuid=vm_uuid \
    vdi1:vdi_1_uuid=destination_sr1_uuid \
    vdi2:vdi_2_uuid=destination_sr2_uuid \
    vdi3:vdi_3_uuid=destination_sr3_uuid \
    vif:vif_uuid=network_uuid
<!--NeedCopy-->

Für die poolübergreifende Migration:

xe vm-migrate uuid=vm_uuid remote-master=192.0.2.35 \
    remote-username=username remote-password=password \
    host-uuid=destination_host_uuid  \
    vif:source_vif_uuid=destination_network_uuid \
    vdi:vdi_uuid=destination_sr_uuid
<!--NeedCopy-->

Weitere Informationen zur Speicher-Livemigration, Live-Migration und Live-VDI-Migration finden Sie unter Migrieren von VMs.

Standardmäßig wird die VM angehalten, migriert und auf dem anderen Host fortgesetzt. Der Parameter live wählt die Livemigration aus. Die Live-Migration sorgt dafür, dass die VM während der Migration läuft, wodurch die Ausfallzeiten der virtuellen Maschine minimiert werden. Unter bestimmten Umständen, z. B. bei extrem speicherintensiven Workloads in der VM, fällt die Livemigration wieder in den Standardmodus und setzt die VM für kurze Zeit an, bevor die Speicherübertragung abgeschlossen wird.

Die VM oder VMs, auf denen dieser Vorgang ausgeführt wird, werden über den Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten VM-Parameter sein.

vm-pause

xe vm-pause
<!--NeedCopy-->

Pausieren Sie eine laufende VM. Beachten Sie, dass dieser Vorgang den zugehörigen Speicher nicht freigibt (siehe vm-suspend).

vm-reboot

xe vm-reboot [vm-selector=vm_selector_value...] [force=true]
<!--NeedCopy-->

Starten Sie die angegebenen VMs neu.

Die VM oder VMs, auf denen dieser Vorgang ausgeführt wird, werden über den Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten VM-Parameter sein.

Verwenden Sie das Argument force, um einen nicht ordnungsgemäßen Neustart zu verursachen. Wo das Herunterfahren dem Ziehen des Steckers auf einem physischen Server ähnelt.

vm-recover

xe vm-recover vm-uuid [database] [vdi-uuid] [force]
<!--NeedCopy-->

Stellt eine VM aus der Datenbank wieder her, die im bereitgestellten VDI enthalten ist.

vm-reset-powerstate

xe vm-reset-powerstate [vm-selector=vm_selector_value...] {force=true}
<!--NeedCopy-->

Die VM oder VMs, auf denen dieser Vorgang ausgeführt wird, werden über den Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten VM-Parameter sein.

Dies ist ein erweiterter Befehl, der nur verwendet wird, wenn ein Mitgliedshost in einem Pool ausfällt. Sie können diesen Befehl verwenden, um den Poolmaster zu zwingen, den Energiezustand der VMs zurückzusetzen halted. Im Wesentlichen erzwingt dieser Befehl die Sperre der VM und der Datenträger, sodass sie als Nächstes auf einem anderen Poolhost gestartet werden kann. Für diesen Aufruf muss das Force-Flag angegeben werden und schlägt fehl, wenn es sich nicht in der Befehlszeile befindet.

vm-resume

xe vm-resume [vm-selector=vm_selector_value...] [force=true|false] [on=host_uuid]
<!--NeedCopy-->

Setzt die angegebenen VMs fort.

Die VM oder VMs, auf denen dieser Vorgang ausgeführt wird, werden über den Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten VM-Parameter sein.

Wenn sich die VM auf einem gemeinsam genutzten SR in einem Pool von Hosts befindet, verwenden Sie das Argument on, um anzugeben, auf welchem Poolmitglied sie gestartet werden soll. Standardmäßig bestimmt das System einen geeigneten Host, bei dem es sich um eines der Mitglieder des Pools handeln kann.

vm-retrieve-wlb-recommendations

xe vm-retrieve-wlb-recommendations
<!--NeedCopy-->

Rufen Sie die Empfehlungen für den Arbeitslastausgleich für die ausgewählte VM ab.

vm-shutdown

xe vm-shutdown [vm-selector=vm_selector_value...] [force=true|false]
<!--NeedCopy-->

Fahren Sie die angegebene VM herunter.

Die VM oder VMs, auf denen dieser Vorgang ausgeführt wird, werden über den Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten VM-Parameter sein.

Verwenden Sie das Argument force, um ein nicht ordnungsgemäßen Herunterfahren zu verursachen, ähnlich dem Ziehen des Steckers auf einem physischen Server.

vm-snapshot

xe vm-snapshot new-name-label=name_label [new-name-description+name_description]
<!--NeedCopy-->

Snapshot einer vorhandenen VM mit schnellem Datenträger-Snapshot-Betrieb auf Speicherebene, sofern verfügbar.

vm-start

xe vm-start [vm-selector=vm_selector_value...] [force=true|false] [on=host_uuid] [--multiple]
<!--NeedCopy-->

Startet die angegebenen VMs.

Die VM oder VMs, auf denen dieser Vorgang ausgeführt wird, werden über den Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten VM-Parameter sein.

Wenn sich die VMs auf einem gemeinsam genutzten SR in einem Pool von Hosts befinden, verwenden Sie das Argument on, um anzugeben, auf welchem Poolmitglied die VMs gestartet werden sollen. Standardmäßig bestimmt das System einen geeigneten Host, bei dem es sich um eines der Mitglieder des Pools handeln kann.

vm-suspend

xe vm-suspend [vm-selector=vm_selector_value...]
<!--NeedCopy-->

Die angegebene VM aussetzen.

Die VM oder VMs, auf denen dieser Vorgang ausgeführt wird, werden über den Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten VM-Parameter sein.

vm-uninstall

xe vm-uninstall [vm-selector=vm_selector_value...] [force=true|false]
<!--NeedCopy-->

Deinstallieren Sie eine VM und löschen Sie ihre Datenträger (die VDIs, die als RW gekennzeichnet sind und nur mit dieser VM verbunden sind) zusätzlich zu ihrem Metadatensatz. Um nur die VM-Metadaten zu löschen, verwenden Sie xe vm-destroy.

Die VM oder VMs, auf denen dieser Vorgang ausgeführt wird, werden über den Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten VM-Parameter sein.

vm-unpause

xe vm-unpause
<!--NeedCopy-->

Unterbrechen Sie eine angehaltene VM.

vm-vcpu-hotplug

xe vm-vcpu-hotplug new-vcpus=new_total_vcpu_count [vm-selector=vm_selector_value...]
<!--NeedCopy-->

Passen Sie dynamisch die Anzahl der vCPUs an, die für eine laufende Linux-VM verfügbar sind. Die Anzahl der vCPUs wird durch den Parameter begrenzt VCPUs-max. Windows-VMs werden immer mit der Anzahl der vCPUs ausgeführt, die in VCPUs-maxeingestellt ist, und müssen neu gestartet werden, um diesen Wert zu ändern.

Verwenden Sie den Parameter new-vcpus, um die neue Gesamtzahl der vCPUs zu definieren, die Sie nach der Ausführung dieses Befehls haben möchten. Verwenden Sie diesen Parameter nicht, um die Anzahl der vCPUs zu übergeben, die Sie hinzufügen möchten. Wenn Sie beispielsweise zwei vorhandene vCPUs in Ihrer VM haben und zwei weitere vCPUs hinzufügen möchten, geben Sie new-vcpus=4 an.

Die Linux-VM oder Windows-VMs, auf denen dieser Vorgang ausgeführt wird, werden mithilfe des Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten VM-Parameter sein.

Hinweis:

Wenn Sie Linux-VMs ohne installierte Citrix VM Tools ausführen, führen Sie den folgenden Befehl auf der VM als root aus, um sicherzustellen, dass die neu im laufenden Betrieb angeschlossenen vCPUs verwendet werden: # for i in /sys/devices/system/cpu/cpu[1-9]*/online; do if [ "$(cat $i)" = 0 ]; then echo 1 > $i; fi; done

vm-vif-list

xe vm-vif-list [vm-selector=vm_selector_value...]
<!--NeedCopy-->

Listet die VIFs der angegebenen VMs auf.

Die VM oder VMs, auf denen dieser Vorgang ausgeführt wird, werden über den Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Selektoren. Die Selektoren arbeiten beim Filtern mit den VM-Datensätzen und nicht mit den VIF-Werten. Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten VM-Parameter sein.

Geplante Snapshots

Befehle zum Steuern von VM-geplanten Snapshots und deren Attributen.

Die vmss-Objekte können mit dem Standardbefehl zur Objektauflistung (xe vmss-list) aufgelistet werden, und die Parameter können mit den Standardparameterbefehlen bearbeitet werden. Weitere Informationen finden Sie unter Parameterbefehle auf niedriger Ebene

vmss-create

xe vmss-create enabled=True/False name-label=name type=type frequency=frequency retained-snapshots=value name-description=description schedule:schedule
<!--NeedCopy-->

Erstellt einen Snapshot-Zeitplan im Pool.

Beispiel:

xe vmss-create retained-snapshots=9 enabled=true frequency=daily \
    name-description=sample name-label=samplepolicy type=snapshot \
    schedule:hour=10 schedule:min=30
<!--NeedCopy-->

Snapshot-Zeitpläne haben die folgenden Parameter:

Parametername Beschreibung Typ
name-label Name des Snapshot-Zeitplans. Lese-/Schreibrechte
name-description Beschreibung des Snapshot-Zeitplans. Lese-/Schreibrechte
type Datenträger-Snapshot oder Speicher-Snapshot Lese-/Schreibrechte
frequency Stündlich; täglich; wöchentlich Lese-/Schreibrechte
retained-snapshots Snapshots müssen beibehalten werden. Reichweite: 1-10. Lese-/Schreibrechte
schedule schedule:days (Montag bis Sonntag), schedule:hours (0 bis 23), schedule:minutes (0, 15, 30, 45) Lese-/Schreibrechte

vmss-destroy

xe vmss-destroy uuid=uuid
<!--NeedCopy-->

Zerstört einen Snapshot-Zeitplan im Pool.

USB-Durchgang

USB-Passthrough wird für die folgenden USB-Versionen unterstützt: 1.1, 2.0 und 3.0.

USB-Pass-Through aktivieren/deaktivieren

xe pusb-param-set uuid=pusb_uuid passthrough-enabled=true/false
<!--NeedCopy-->

Aktivieren/Deaktivieren von USB-Passthrough.

pusb-scan

xe pusb-scan host-uuid=host_uuid
<!--NeedCopy-->

PUSB scannen und aktualisieren.

vusb-create

xe vusb-create usb-group-uuid=usb_group_uuid vm-uuid=vm_uuid
<!--NeedCopy-->

Erstellt einen virtuellen USB-Stick im Pool. Starten Sie die VM, um den USB zur VM zu leiten.

vusb-unplug

xe vusb-unplug uuid=vusb_uuid
<!--NeedCopy-->

Trennen Sie den USB-Stecker von der VM.

vusb-destroy

xe vusb-destroy uuid=vusb_uuid
<!--NeedCopy-->

Entfernt die virtuelle USB-Liste von der VM.