Befehlszeilenschnittstelle

Last published : Nov 04, 2026
Die xe-CLI ermöglicht Ihnen das Skripting und die Automatisierung von Systemverwaltungsaufgaben. Verwenden Sie die CLI, um XenServer® in eine bestehende IT-Infrastruktur zu integrieren.

Erste Schritte mit der xe-CLI

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

Auf Ihrem XenServer-Host

Die xe-Befehlszeilenschnittstelle ist standardmäßig auf Ihrem Host installiert. Sie können xe-CLI-Befehle in der dom0-Konsole ausführen. Greifen Sie auf die dom0-Konsole auf eine der folgenden Weisen zu:
  • Gehen Sie in XenCenter zur Registerkarte Konsole für den Host, auf dem Sie den Befehl ausführen möchten.
  • Stellen Sie eine SSH-Verbindung zum Host her, 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 sich die Datei xe.exe befindet (typischerweise C:\Program Files (x86)\XenServer\XenCenter). Wenn Sie den Installationspfad 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 dem RPM namens client_install/xapi-xe-BUILD.x86_64.rpm auf der Haupt-XenServer-Installations-ISO installieren.
Um von der RPM zu installieren, verwenden Sie den folgenden Befehl:
rpm -ivh xapi-xe-BUILD.x86_64.rpm
Sie können Parameter in der Befehlszeile verwenden, um den XenServer-Host, den Benutzernamen und das Kennwort zu definieren, die bei der Ausführung von xe-Befehlen verwendet werden sollen. Sie haben jedoch auch die Möglichkeit, diese Informationen als Umgebungsvariable festzulegen. Zum Beispiel:
export XE_EXTRA_ARGS="server=<host name>,username=<user name>,password=<password>"
Hinweis:
Die Remote-xe-CLI unter Linux kann hängen bleiben, wenn versucht wird, Befehle über eine sichere Verbindung auszuführen und diese Befehle eine Dateiübertragung beinhalten. In diesem Fall können Sie den Parameter --no-ssl verwenden, um den Befehl über eine unsichere Verbindung zum XenServer-Host auszuführen.

Hilfe zu xe-Befehlen erhalten

Grundlegende Hilfe für CLI-Befehle auf dem Host erhalten Sie durch Eingabe von:
xe help command
Eine Liste der am häufigsten verwendeten xe-Befehle wird angezeigt, wenn Sie Folgendes eingeben:
xe help
Oder eine Liste aller xe-Befehle wird angezeigt, wenn Sie Folgendes eingeben:
xe help --all

Grundlegende xe-Syntax

Die grundlegende Syntax aller XenServer xe CLI-Befehle lautet:
xe command-name argument=value argument=value
Jeder spezifische Befehl enthält seinen eigenen Satz von Argumenten, die die Form argument=value haben. Einige Befehle haben erforderliche Argumente, und die meisten haben eine Reihe optionaler Argumente. Typischerweise nimmt ein Befehl Standardwerte für einige der optionalen Argumente an, wenn er ohne diese aufgerufen wird.
Wenn der xe-Befehl remote ausgeführt wird, werden zusätzliche Argumente zum Verbinden und Authentifizieren verwendet. Diese Argumente haben ebenfalls die Form 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.
Ein password-file-Argument kann anstelle des Passworts direkt angegeben werden. In diesem Fall versucht der xe-Befehl, das Passwort aus der angegebenen Datei zu lesen und verwendet dieses Passwort zur Verbindung. (Alle nachgestellten CRs und LFs am Ende der Datei werden entfernt.) Diese Methode ist sicherer, als das Passwort direkt in der Befehlszeile anzugeben.
Das optionale Argument port kann verwendet werden, um den Agent-Port auf dem Remote-XenServer-Host anzugeben (Standardwert ist 443).
Beispiel: Auf dem lokalen XenServer-Host:
xe vm-list
Beispiel: Auf einem Remote-XenServer-Host:
xe vm-list username=username password=password server=hostname
Eine Kurzschreibweise ist auch für Argumente zur Remote-Verbindung verfügbar:
  • -u Benutzername
  • -pw Passwort
  • -pwf Passwortdatei
  • -p Port
  • -s Server
Beispiel: Auf einem Remote-XenServer-Host:
xe vm-list -u myuser -pw mypassword -s hostname
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 Remote-XenServer-Host ausgeführt werden, führen Sie zuerst den folgenden Befehl aus:
export XE_EXTRA_ARGS="server=jeffbeck,port=443,username=root,password=pass"
Nach Ausführung dieses Befehls müssen Sie die Remote-XenServer-Host-Parameter 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 diese auf einem Remote-XenServer-Host ausgeführt werden, was standardmäßig deaktiviert ist.

Sonderzeichen und Syntax

Um Argument-/Wert-Paare in der Befehlszeile xe anzugeben, schreiben Sie: argument=value
Sofern der Wert keine Leerzeichen enthält, verwenden Sie keine Anführungszeichen. 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 XenServer-Host verwenden, verfügen Befehle über eine Tab-Vervollständigungsfunktion, 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 mehr als ein Befehl mit vm-l beginnt, listet ein erneutes Drücken der TAB-Taste die Möglichkeiten auf. Diese Funktion ist nützlich, wenn Sie Objekt-UUIDs in Befehlen angeben.
Hinweis:
Die Tab-Vervollständigung funktioniert normalerweise nicht, wenn Befehle auf einem entfernten XenServer-Host ausgeführt werden. Wenn Sie jedoch die Variable XE_EXTRA_ARGS auf dem Computer festlegen, auf dem Sie die Befehle eingeben, wird die Tab-Vervollständigung aktiviert. Weitere Informationen finden Sie unter Grundlegende xe-Syntax.

Befehlstypen

Die CLI-Befehle können in zwei Hälften unterteilt werden. Low-Level-Befehle befassen sich mit der Auflistung und Parameterbearbeitung von API-Objekten. Höherstufige Befehle werden verwendet, um auf einer abstrakteren Ebene mit VMs oder Hosts zu interagieren.
Die Low-Level-Befehle sind:
  • class-list
  • class-param-get
  • class-param-set
  • class-param-list
  • class-param-add
  • class-param-remove
  • class-param-clear
Wobei class eine der folgenden ist:
  • 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 verfügt über den vollständigen Satz von class-param-action-Befehlen. Einige Werte von class haben einen kleineren Satz von Befehlen.

Parametertypen

Die Objekte, die mit den xe-Befehlen adressiert werden, verfügen über Parametersätze, die sie identifizieren und ihre Zustände definieren.
Die meisten Parameter nehmen einen einzelnen Wert an. Zum Beispiel enthält der name-label-Parameter einer VM einen einzelnen Zeichenfolgenwert. In der Ausgabe von Parameterlistenbefehlen, wie z. B. xe vm-param-list, gibt ein Wert in Klammern an, ob Parameter Lese-/Schreibzugriff (RW) oder Nur-Lesezugriff (RO) haben. Die Ausgabe von xe vm-param-list auf einer bestimmten VM könnte die folgenden Zeilen enthalten:
user-version ( RW): 1
 is-control-domain ( RO): false
Der erste Parameter, user-version, ist beschreibbar und hat den Wert 1. Der zweite, is-control-domain, ist schreibgeschützt und hat den Wert false.
Die beiden anderen Parametertypen sind mehrwertig. Ein set-Parameter enthält eine Liste von Werten. Ein map-Parameter ist ein Satz von Schlüssel-Wert-Paaren. Als Beispiel sehen Sie sich den folgenden Auszug der 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 platform-Parameter enthält eine Liste von Elementen, die Schlüssel-Wert-Paare darstellen. Den 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 schreibbar ist. Der allowed-operations-Parameter enthält eine Liste, die einen Satz von Elementen bildet. Das S vor dem RO zeigt an, dass dies ein Set-Parameter ist und lesbar, aber nicht schreibbar ist.
Um nach einem Map-Parameter zu filtern oder einen Map-Parameter festzulegen, verwenden Sie einen Doppelpunkt (:) zur Trennung des Map-Parameternamens und des Schlüssel-Wert-Paares. Um beispielsweise den Wert des foo-Schlüssels des other-config-Parameters einer VM auf baa zu setzen, lautet der Befehl
xe vm-param-set uuid=VM uuid other-config:foo=baa

Low-Level-Parameterbefehle

Es gibt mehrere Befehle zum Bearbeiten von Parametern von Objekten: class-param-get, class-param-set, class-param-add, class-param-remove, class-param-clear und class-param-list. Jeder dieser Befehle nimmt einen uuid-Parameter an, um das jeweilige Objekt anzugeben. Da diese Befehle als Low-Level-Befehle gelten, müssen sie die UUID und nicht das VM-Namenslabel verwenden.
  • xe class-param-list uuid=uuid
    Listet alle Parameter und ihre 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 Kartenparameter ruft die Angabe des Param-Schlüssels den Wert ab, der diesem Schlüssel in der Karte zugeordnet ist. Wenn der Param-Schlüssel nicht angegeben wird oder wenn der Parameter ein Satz ist, gibt der Befehl eine Zeichenfolgendarstellung des Satzes oder der Karte zurück.
  • xe class-param-set uuid=uuid param=value
    Legt den Wert eines oder mehrerer Parameter fest.
  • xe class-param-add uuid=uuid param-name=parameter key=value param-key=key
    Fügt entweder einem Karten- oder einem Satzparameter hinzu. Bei einem Kartenparameter fügen Sie Schlüssel-Wert-Paare mit der Syntax key=value hinzu. Wenn der Parameter ein Satz ist, fügen Sie Schlüssel mit der Syntax param-key=key hinzu.
  • xe class-param-remove uuid=uuid param-name=parameter param-key=key
    Entfernt entweder ein Schlüssel-Wert-Paar aus einer Karte oder einen Schlüssel aus einem Satz.
  • xe class-param-clear uuid=uuid param-name=parameter
    Löscht einen Satz oder eine Karte vollständig.

Low-Level-Listenbefehle

Der Befehl class-list listet die Objekte des Typs class auf. Standardmäßig listet dieser Befehlstyp alle Objekte auf und gibt eine Untermenge der Parameter aus. Dieses Verhalten kann auf folgende Weisen geändert werden:
  • Er kann die Objekte filtern, sodass nur eine Untermenge ausgegeben wird.
  • Die ausgegebenen Parameter können geändert werden.
Um die ausgegebenen Parameter zu ändern, geben Sie das Argument params als kommagetrennte Liste der erforderlichen Parameter an. Zum Beispiel:
xe vm-list params=name-label,other-config
Alternativ können Sie alle Parameter mit folgender Syntax auflisten:
xe vm-list params=all
Der Befehl „list“ zeigt einige Parameter nicht an, deren Berechnung aufwendig ist. Diese Parameter werden beispielsweise wie folgt angezeigt:
allowed-VBD-devices (SRO): <expensive field>
Um diese Felder zu erhalten, verwenden Sie entweder den Befehl class-param-list oder class-param-get.
Um die Liste zu filtern, gleicht die CLI Parameterwerte mit den in der Befehlszeile angegebenen Werten ab und gibt nur Objekte aus, die alle angegebenen Einschränkungen erfüllen. Zum Beispiel:
xe vm-list HVM-boot-policy="BIOS order" power-state=halted
Dieser Befehl listet nur die VMs auf, bei denen sowohl das Feld power-state den Wert halted als auch das Feld HVM-boot-policy den Wert BIOS order hat.
Sie können die Liste auch nach dem Wert von Schlüsseln in Maps oder nach dem Vorhandensein von Werten in einem Set 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 vorhandenen Werten in einem Set ist set-name:contains=value.
Beim Skripting ist es eine nützliche Technik, --minimal in der Befehlszeile zu übergeben, wodurch xe nur das erste Feld in einer kommagetrennten Liste ausgibt. Zum Beispiel gibt der Befehl xe vm-list --minimal auf einem Host mit drei installierten VMs die drei UUIDs der VMs aus:
a85d6717-7264-d00e-069b-3b1d19d56ad9,aaa3eec5-9499-bcf3-4c03-af10baea96b7, \
42c044de-df69-4b30-89d9-2c199564581d

Geheimnisse

XenServer bietet einen Geheimnis-Mechanismus, um zu verhindern, dass Passwörter im Klartext in der Befehlszeilenhistorie oder in API-Objekten gespeichert werden. XenCenter verwendet diese Funktion automatisch, und sie kann auch über die xe CLI für jeden Befehl verwendet werden, der ein Passwort erfordert.
Hinweis:
Passwort-Geheimnisse können nicht zur Authentifizierung bei einem XenServer-Host von einer Remote-Instanz der xe CLI verwendet werden.
Um ein Geheimnisobjekt zu erstellen, führen Sie den folgenden Befehl auf Ihrem XenServer-Host aus.
xe secret-create value=my-password
Ein Geheimnis wird erstellt und auf dem XenServer-Host gespeichert. Der Befehl gibt die UUID des Geheimnisobjekts aus. Zum Beispiel 99945d96-5890-de2a-3899-8c04ef2521db. Hängen Sie _secret an den Namen des Passwortarguments an, um diese UUID an jeden Befehl zu übergeben, der ein Passwort erfordert.
Beispiel: Auf dem XenServer-Host, auf dem Sie das Geheimnis 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"

Befehlsverlauf

Einige xe-Befehle, zum Beispiel xe vm-migrate oder xe pool-enable-external-auth, verwenden Geheimnisse wie Passwörter als Parameter. Diese können im Shell-Verlauf landen 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

Dieser Abschnitt gruppiert die Befehle nach den Objekten, die der Befehl anspricht. 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.

Appliance-Parameter

Appliance-Befehle haben die folgenden Parameter:
Parametername Beschreibung Typ
uuid Die Appliance-UUID Erforderlich
name-description Die Appliance-Beschreibung Optional
paused Optional
force Erzwungenes Herunterfahren Optional

appliance-assert-can-be-recovered

xe appliance-assert-can-be-recovered uuid=appliance-uuid database:vdi-uuid=vdi-uuid
Prüft, ob Speicher zur Wiederherstellung dieser VM-Appliance/vApp verfügbar ist.

appliance-create

xe appliance-create name-label=name-label [name-description=name-description]
Erstellt eine Appliance/vApp. Beispiel:
xe appliance-create name-label=my_appliance
VMs zur Appliance hinzufügen:
xe vm-param-set uuid=VM-UUID appliance=appliance-uuid

appliance-destroy

xe appliance-destroy uuid=appliance-uuid
Zerstört eine Appliance/vApp. Beispiel:
xe appliance-destroy uuid=appliance-uuid

appliance-recover

xe appliance-recover uuid=appliance-uuid database:vdi-uuid=vdi-uuid [paused=true|false]
Stellt eine VM-Appliance/vApp aus der in der bereitgestellten VDI enthaltenen Datenbank wieder her.

appliance-shutdown

xe appliance-shutdown uuid=appliance-uuid [force=true|false]
Fährt alle VMs in einer Appliance/vApp herunter. Zum Beispiel:
xe appliance-shutdown uuid=appliance-uuid

appliance-start

xe appliance-start uuid=appliance-uuid [paused=true|false]
Startet eine Appliance/vApp. Zum Beispiel:
xe appliance-start uuid=appliance-uuid

Audit-Befehle

Audit-Befehle laden alle verfügbaren Datensätze der RBAC-Auditdatei im Pool herunter. Wenn der optionale Parameter since vorhanden ist, werden nur die Datensätze ab diesem spezifischen Zeitpunkt heruntergeladen.

audit-log-get Parameter

audit-log-get hat die folgenden Parameter
Parametername Beschreibung Typ
filename Schreibt das Audit-Protokoll des Pools in Dateiname Erforderlich
since Spezifischer Datums-/Zeitpunkt Optional

audit-log-get

xe audit-log-get [since=timestamp] filename=filename
Um beispielsweise Audit-Datensätze des Pools seit einem präzisen 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

Bonding-Befehle

Befehle für die Arbeit mit Netzwerk-Bonds, zur Ausfallsicherheit bei physischem Schnittstellen-Failover. Weitere Informationen finden Sie unter Netzwerk.
Das Bond-Objekt ist ein Referenzobjekt, das Master- und Member-PIFs miteinander verbindet. Die Master-PIF ist die Bonding-Schnittstelle, die als übergeordnete PIF verwendet werden muss, um auf den Bond zu verweisen. Die Member-PIFs sind eine Gruppe von zwei oder mehr physischen Schnittstellen, die zu der übergeordneten Bonded-Schnittstelle kombiniert wurden.

Bond-Parameter

Bonds haben die folgenden Parameter:
Parametername Beschreibung Typ
uuid Eindeutiger Bezeichner/Objektreferenz für den Bond Schreibgeschützt
master UUID für die Haupt-Bond-PIF Schreibgeschützt
members Satz von UUIDs für die zugrunde liegenden gebundenen PIFs Schreibgeschützt

bond-create

xe bond-create network-uuid=network_uuid pif-uuids=pif_uuid_1,pif_uuid_2,...
Erstellt eine gebundene Netzwerkschnittstelle im angegebenen Netzwerk aus einer Liste vorhandener PIF-Objekte. Der Befehl schlägt in einem der folgenden Fälle fehl:
  • Wenn PIFs bereits in einem anderen Bond sind
  • Wenn ein Mitglied ein VLAN-Tag gesetzt hat
  • Wenn die referenzierten PIFs nicht auf demselben XenServer-Host sind
  • Wenn weniger als 2 PIFs bereitgestellt werden

bond-destroy

xe bond-destroy uuid=bond_uuid
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
Bond-Modus ändern.

CD-Befehle

Befehle zum Arbeiten mit physischen CD/DVD-Laufwerken auf XenServer-Hosts.

CD-Parameter

CDs haben die folgenden Parameter:
Parametername Beschreibung Typ
uuid Eindeutiger Bezeichner/Objektreferenz für die CD Nur Lesezugriff
name-label Name für die CD Lese-/Schreibzugriff
name-description Beschreibungstext für die CD Lese-/Schreibzugriff
allowed-operations Eine Liste der Operationen, die auf dieser CD ausgeführt werden können Nur-Lese-Satzparameter
current-operations Eine Liste der Operationen, die derzeit auf dieser CD ausgeführt werden Nur-Lese-Satzparameter
sr-uuid Der eindeutige Bezeichner/Objektreferenz für den SR, zu dem diese CD gehört Schreibgeschützt
sr-name-label Der Name des SR, zu dem diese CD gehört Schreibgeschützt
vbd-uuids Eine Liste der eindeutigen Bezeichner für die VBDs auf VMs, die mit dieser CD verbunden sind Schreibgeschützter Parameter
crashdump-uuids Wird auf CDs nicht verwendet. Da Crashdumps nicht auf CDs geschrieben werden können. Schreibgeschützter Parameter
virtual-size Größe der CD, wie sie für VMs erscheint (in Byte) Schreibgeschützt
physical-utilisation Physischer Speicherplatz, den das CD-Image auf dem SR belegt (in Byte) Schreibgeschützt
type Für CDs auf Benutzer eingestellt Schreibgeschützt
sharable Ob das CD-Laufwerk freigegeben werden kann oder nicht. Standard ist false. Schreibgeschützt
read-only Ob die CD schreibgeschützt ist; wenn false, ist das Gerät beschreibbar. Immer wahr für CDs. Schreibgeschützt
storage-lock Der Wert ist true, wenn diese Festplatte auf Speicherebene gesperrt ist. Schreibgeschützt
parent Referenz auf die übergeordnete Festplatte, wenn diese CD Teil einer Kette ist. Schreibgeschützt
missing Der Wert ist true, wenn der SR-Scanvorgang diese CD als nicht auf der Festplatte vorhanden gemeldet hat. Schreibgeschützt
other-config Eine Liste von Schlüssel-Wert-Paaren, die zusätzliche Konfigurationsparameter für die CD angeben Lese-/Schreib-Map-Parameter
location Der Pfad, auf dem das Gerät eingebunden ist Nur Lesezugriff
managed Der Wert ist true, wenn das Gerät verwaltet wird Nur Lesezugriff
xenstore-data Daten, die in den xenstore Baum eingefügt werden sollen Nur Lesezugriff Map-Parameter
sm-config Namen und Beschreibungen der Konfigurationsschlüssel für Speichermanager-Geräte Nur Lesezugriff Map-Parameter
is-a-snapshot Der Wert ist true, wenn diese Vorlage ein CD-Snapshot ist Schreibgeschützt
snapshot_of Die UUID der CD, von der diese Vorlage ein Snapshot ist Schreibgeschützt
snapshots Die UUIDs aller Snapshots, die von dieser CD erstellt wurden Schreibgeschützt
snapshot_time Der Zeitstempel des Snapshot-Vorgangs Schreibgeschützt

cd-list

xe cd-list [params=param1,param2,...] [parameter=parameter_value]
Listet die CDs und ISOs (CD-Image-Dateien) auf dem XenServer-Host oder -Pool auf, gefiltert 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 all verwenden, um alle Parameter anzuzeigen. Wenn params nicht verwendet wird, zeigt die zurückgegebene Liste eine Standarduntermenge aller verfügbaren Parameter.
Optionale Argumente können eine beliebige Anzahl der CD-Parameter sein, die am Anfang dieses Abschnitts aufgeführt sind.

GFS2-Cluster-Befehle

Befehle für die Arbeit mit GFS2-Cluster-Pools.
GFS2-Cluster-Pools sind Ressourcen-Pools, die die Clustering-Funktion aktiviert haben. Verwenden Sie diese Pools mit GFS2-SRs. Weitere Informationen finden Sie unter GFS2-Cluster-Pools
Die Cluster- und Cluster-Host-Objekte können mit den Standard-Objektlistungsbefehlen (xe cluster-list und xe cluster-host-list) aufgelistet und die Parameter mit den Standard-Parameterbefehlen manipuliert werden. Weitere Informationen finden Sie unter Befehle für Parameter auf niedriger Ebene. Befehle für die Arbeit mit GFS2-Cluster-Pools.

GFS2-Cluster-Parameter

GFS2-Cluster haben die folgenden Parameter:
Parametername Beschreibung Typ
uuid Der eindeutige Bezeichner/Objektreferenz für den GFS2-Cluster. Schreibgeschützt
cluster-hosts Eine Liste eindeutiger Bezeichner/Objektreferenzen für die Hosts im GFS2-Cluster. Gesetzter Nur-Lese-Parameter
cluster-token Der geheime Schlüssel, der von xapi-clusterd verwendet wird, wenn es mit sich selbst auf anderen Hosts kommuniziert. Nur lesbar
cluster-stack Der Technologie-Stack, der die Clustering-Funktionen bereitstellt. Mögliche Werte sind corosync. Nur lesbar
cluster-stack-version Die Version des Technologie-Stacks, der die Clustering-Funktionen bereitstellt. Nur lesbar
allowed-operations Listet die in diesem Zustand zulässigen Operationen auf. Diese Liste dient nur zur Information, und der GFS2-Cluster-Status kann sich geändert haben, bis ein Client dieses Feld liest. Gesetzter Nur-Lese-Parameter
current-operations Listet die aktuell laufenden Operationen auf. Diese Liste dient nur zur Information, und der GFS2-Cluster-Status kann sich geändert haben, bis ein Client dieses Feld liest. Schreibgeschützter Parameter
token-timeout Die corosync-Token-Zeitüberschreitung in Sekunden. Schreibgeschützt
token-timeout-coefficient Der corosync-Token-Zeitüberschreitungskoeffizient in Sekunden. Schreibgeschützt
pool-auto-join Der Wert ist wahr, wenn neue Pool-Mitglieder automatisch dem GFS2-Cluster beitreten. Dies ist auf true eingestellt. Schreibgeschützt
is-quorate Ob der GFS2-Cluster ein Quorum hat. Schreibgeschützt
quorum Die Anzahl der aktiven Hosts, die erforderlich sind, damit der GFS2-Cluster ein Quorum hat. Schreibgeschützt
live-hosts Die Anzahl der Hosts im GFS2-Cluster, die derzeit aktiv sind. Schreibgeschützt
cluster-config Eine Liste von Schlüssel/Wert-Paaren, die zusätzliche Konfigurationsparameter für den GFS2-Cluster angeben. Schreibgeschützter Map-Parameter
other-config Eine Liste von Schlüssel/Wert-Paaren, die zusätzliche Konfigurationsparameter für den GFS2-Cluster angeben. Lese-/Schreib-Map-Parameter
Die Hosts innerhalb des GFS2-Clusters (cluster-host) haben die folgenden Parameter:
Parametername Beschreibung Typ
uuid Der eindeutige Bezeichner/Objektreferenz für den GFS2-Cluster-Host. Dies ist nicht dasselbe wie die Host-UUID. Schreibgeschützt
cluster Der eindeutige Bezeichner/Objektreferenz für den GFS2-Cluster, dessen dieser Host Mitglied ist. Schreibgeschützt
PIF Der eindeutige Bezeichner/Objektreferenz für das PIF-Objekt. Schreibgeschützt
host Der eindeutige Bezeichner/Objektreferenz für den Host. Schreibgeschützt
enabled Gibt an, ob der GFS2-Cluster-Host der Meinung ist, dass GFS2-Clustering auf diesem Host aktiviert werden sollte. Dieses Feld kann durch Aufrufen der Aktivierungs-/Deaktivierungsnachricht auf einem GFS2-Cluster-Host geändert werden. Nur aktivierte Mitglieder führen den zugrunde liegenden Cluster-Stack aus. Deaktivierte Mitglieder gelten weiterhin als Mitglied des GFS2-Clusters (siehe joined) und können vom Benutzer wieder aktiviert werden. Schreibgeschützt
joined Gibt an, ob der GFS2-Cluster-Host dem GFS2-Cluster beigetreten ist. Im Gegensatz zu „enabled“ wird ein Host, der nicht beigetreten ist, nicht als Mitglied des GFS2-Clusters betrachtet, und daher können für diesen Host keine Aktivierungs- und Deaktivierungsvorgänge durchgeführt werden. Nur Lesezugriff
live Gibt an, ob der Cluster-Stack diesen Host als aktiv betrachtet. Nur Lesezugriff
last-update-live Zeitpunkt, zu dem das Feld „live“ zuletzt basierend auf Informationen aus dem Cluster-Stack aktualisiert wurde. Nur Lesezugriff
allowed-operations Listet die in diesem Zustand zulässigen Operationen auf. Diese Liste dient nur zur Information, und der Status des GFS2-Cluster-Hosts kann sich geändert haben, bis ein Client dieses Feld liest. Nur Lesezugriff-Set-Parameter
current-operations Listet die aktuell laufenden Operationen auf. Diese Liste dient nur zur Information, und der Status des GFS2-Cluster-Hosts kann sich geändert haben, bis ein Client dieses Feld liest. Nur Lesezugriff-Set-Parameter
other-config Eine Liste von Schlüssel/Wert-Paaren, die zusätzliche Konfigurationsparameter für den GFS2-Cluster-Host angeben. Schreibgeschützter Map-Parameter

cluster-host-destroy

xe cluster-host-destroy uuid=host_uuid
Einen GFS2-Cluster-Host zerstören, wodurch der GFS2-Cluster effektiv verlassen wird.

cluster-host-disable

xe cluster-host-disable uuid=cluster_uuid
GFS2-Cluster-Mitgliedschaft für einen aktivierten GFS2-Cluster-Host deaktivieren.

cluster-host-enable

xe cluster-host-enable uuid=cluster_uuid
GFS2-Cluster-Mitgliedschaft für einen deaktivierten GFS2-Cluster-Host aktivieren.

cluster-host-force-destroy

xe cluster-host-force-destroy uuid=cluster_host
Ein GFS2-Cluster-Host-Objekt zwangsweise zerstören, wodurch der GFS2-Cluster effektiv verlassen wird.

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]
Pool-weiten GFS2-Cluster erstellen.

cluster-pool-destroy

xe cluster-pool-destroy cluster-uuid=cluster_uuid
Pool-weiten GFS2-Cluster zerstören. Der Pool existiert weiterhin, ist aber nicht mehr GFS2-geclustert und kann keine GFS2-SRs mehr verwenden.

cluster-pool-force-destroy

xe cluster-pool-force-destroy cluster-uuid=cluster_uuid
Poolweiten GFS2-Cluster zwangsweise zerstören.

cluster-pool-resync

xe cluster-pool-resync cluster-uuid=cluster_uuid
Einen GFS2-Cluster über einen Pool hinweg neu synchronisieren.

Konsolenbefehle

Befehle für die Arbeit mit Konsolen.
Die Konsolenobjekte können mit dem Standardbefehl zur Objektlistung (xe console-list) aufgelistet und die Parameter mit den Standard-Parameterbefehlen manipuliert werden. Weitere Informationen finden Sie unter Befehle für Parameter auf niedriger Ebene.

Konsolenparameter

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

console

xe console
An eine bestimmte Konsole anhängen.

Diagnosebefehle

Befehle zum Sammeln von Diagnoseinformationen von XenServer.

diagnostic-compact

xe diagnostic-compact
Führt eine große GC-Sammlung und Heap-Kompaktierung durch.

diagnostic-db-stats

xe diagnostic-db-stats
Datenbankstatistiken ausgeben.

diagnostic-gc-stats

xe diagnostic-gc-stats
GC-Statistiken ausgeben.

diagnostic-license-status

xe diagnostic-license-status
Hilft bei der Diagnose von poolweiten Lizenzierungsproblemen.

diagnostic-net-stats

xe diagnostic-net-stats [uri=uri] [method=method] [params=param1,param2...]
Netzwerkstatistiken ausgeben.

diagnostic-timing-stats

xe diagnostic-timing-stats
Timing-Statistiken ausgeben.

diagnostic-vdi-status

xe diagnostic-vdi-status uuid=vdi_uuid
Abfrage des Sperr- und Freigabestatus eines VDI.

diagnostic-vm-status

xe diagnostic-vm-status uuid=vm_uuid
Abfrage der Hosts, auf denen die VM booten kann, Überprüfung des Freigabe-/Sperrstatus aller VBDs.

Befehle zur Notfallwiederherstellung

Befehle zur Wiederherstellung von VMs nach einem Notfall

drtask-create

xe drtask-create type=type sr-whitelist=sr-white-list device-config=device-config
Erstellt eine Notfallwiederherstellungsaufgabe. Zum Beispiel, um eine iSCSI SR zur Vorbereitung der Notfallwiederherstellung zu verbinden:
xe drtask-create type=lvmoiscsi device-config:target=target-ip-address \
    device-config:targetIQN=targetIQN device-config:SCSIid=SCSIid \
    sr-whitelist=sr-uuid-list
Hinweis:
Der Befehl sr-whitelist listet zulässige SR-UUIDs auf. Der Befehl drtask-create führt nur eine SR ein und verbindet sich mit ihr, die eine der zulässigen UUIDs besitzt.

drtask-destroy

xe drtask-destroy uuid=dr-task-uuid
Zerstört eine Notfallwiederherstellungsaufgabe und vergisst die eingeführte SR.

vm-assert-can-be-recovered

xe vm-assert-can-be-recovered uuid=vm-uuid database:vdi-uuid=vdi-uuid
Testet, ob Speicher zur 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
Prüft, ob der Speicher (der die Appliance-/vAPP-Festplatte enthält) sichtbar ist.

appliance-recover

xe appliance-recover uuid=appliance-uuid database:vdi-uuid=vdi-uuid [force=true|false]
Stellt eine Appliance/vAPP aus der Datenbank wieder her, die in der bereitgestellten VDI enthalten ist.

vm-recover

xe vm-recover uuid=vm-uuid database:vdi-uuid=vdi-uuid [force=true|false]
Stellt eine VM aus der Datenbank wieder her, die in der bereitgestellten VDI enthalten ist.

sr-enable-database-replication

xe sr-enable-database-replication uuid=sr_uuid
Aktiviert die XAPI-Datenbankreplikation auf dem angegebenen (gemeinsamen) SR.

sr-disable-database-replication

xe sr-disable-database-replication uuid=sr_uuid
Deaktiviert die XAPI-Datenbankreplikation auf dem angegebenen SR.

Anwendungsbeispiel

Das folgende Beispiel zeigt die DR-CLI-Befehle im Kontext:
Am primären Standort die Datenbankreplikation aktivieren:
xe sr-database-replication uuid=sr=uuid
Nach einem Notfall am sekundären Standort mit dem SR verbinden. Der Befehl device-config hat die gleichen 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
Suchen Sie nach Datenbank-VDIs auf dem SR:
xe vdi-list sr-uuid=sr-uuid type=Metadata
Eine Datenbank-VDI nach vorhandenen VMs abfragen:
xe vm-list database:vdi-uuid=vdi-uuid
Eine VM wiederherstellen:
xe vm-recover uuid=vm-uuid database:vdi-uuid=vdi-uuid
Zerstören Sie die DR-Aufgabe. Alle SRs, die durch die DR-Aufgabe eingeführt wurden und nicht von VMs benötigt werden, werden zerstört:
xe drtask-destroy uuid=drtask-uuid

Ereignisbefehle

Befehle für die Arbeit mit Ereignissen.

Ereignisklassen

Ereignisklassen sind in der folgenden Tabelle aufgeführt:
Klassenname 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 Speicher-Repository
vdi Ein virtuelles Festplatten-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]
Blockiert die Ausführung anderer Befehle, bis ein Objekt existiert, das die in der Befehlszeile angegebenen Bedingungen erfüllt. Das Argument x=y bedeutet „Warten, bis Feld x den Wert y annimmt“ und x=/=y bedeutet „Warten, bis Feld x einen beliebigen Wert außer y annimmt.“
Beispiel: Warten Sie, bis eine bestimmte VM ausgeführt wird.
xe event-wait class=vm name-label=myvm power-state=running
Blockiert andere Befehle, bis eine VM namens myvm den Status power-state "running" hat.
Beispiel: Warten Sie, bis eine bestimmte VM neu gestartet wird:
xe event-wait class=vm uuid=$VM start-time=/=$(xe vm-list uuid=$VM params=start-time --minimal)
Blockiert andere Befehle, bis eine VM mit der 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 Ereignisklassen sein, die am Anfang dieses Abschnitts aufgeführt sind. Die Parameter können beliebige der Parameter sein, die im CLI-Befehl class-param-list aufgeführt sind.

GPU-Befehle

Befehle für die Arbeit mit physischen GPUs, GPU-Gruppen und virtuellen GPUs.
Die GPU-Objekte können mit den Standardbefehlen zur Objektlistung aufgelistet werden: xe pgpu-list, xe gpu-group-list und xe vgpu-list. Die Parameter können mit den Standard-Parameterbefehlen manipuliert werden. Weitere Informationen finden Sie unter Low-level parameter commands.

Parameter für physische GPUs

Physische GPUs (pGPUs) haben die folgenden Parameter:
Parametername Beschreibung Typ
uuid Der eindeutige Bezeichner/die Objekt-Referenz für die pGPU Schreibgeschützt
vendor-name Der Herstellername der pGPU Schreibgeschützt
device-name Der vom Hersteller diesem pGPU-Modell zugewiesene Name Schreibgeschützt
gpu-group-uuid Die eindeutige Kennung/Objektreferenz für die GPU-Gruppe, der diese pGPU von XenServer automatisch zugewiesen wurde. Identische pGPUs über Hosts in einem Pool hinweg werden gruppiert. Schreibgeschützt
gpu-group-name-label Der Name der GPU-Gruppe, der die pGPU zugewiesen ist Schreibgeschützt
host-uuid Die eindeutige Kennung/Objektreferenz für den XenServer-Host, mit dem die pGPU verbunden ist Schreibgeschützt
host-name-label Der Name des XenServer-Hosts, mit dem die pGPU verbunden ist Schreibgeschützt
pci-id PCI-Bezeichner Schreibgeschützt
dependencies Listet die abhängigen PCI-Geräte auf, die an dieselbe VM durchgereicht werden Lese-/Schreib-Map-Parameter
other-config Eine Liste von Schlüssel-Wert-Paaren, die zusätzliche Konfigurationsparameter für die pGPU angeben Lese-/Schreib-Map-Parameter
supported-VGPU-types Liste der virtuellen GPU-Typen, die von der zugrunde liegenden Hardware unterstützt werden Nur lesen
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 Nur lesen

pgpu-disable-dom0-access

xe pgpu-disable-dom0-access uuid=uuid
Deaktivieren Sie den PGPU-Zugriff auf dom0.

pgpu-enable-dom0-access

xe pgpu-enable-dom0-access uuid=uuid
Aktivieren Sie den PGPU-Zugriff auf dom0.

GPU-Gruppenparameter

GPU-Gruppen haben die folgenden Parameter:
Parametername Beschreibung Typ
uuid Der eindeutige Bezeichner/Objektreferenz für die GPU-Gruppe Nur lesen
name-label Der Name der GPU-Gruppe Lesen/Schreiben
name-description Der beschreibende Text der GPU-Gruppe Lesen/Schreiben
VGPU-uuids Listet die eindeutigen Bezeichner/Objektreferenzen für die virtuellen GPUs in der GPU-Gruppe auf Nur lesbarer Satzparameter
PGPU-uuids Listet die eindeutigen Bezeichner/Objektreferenzen für die pGPUs in der GPU-Gruppe auf Nur-Lese-Parameter
other-config Eine Liste von Schlüssel-Wert-Paaren, die zusätzliche Konfigurationsparameter für die GPU-Gruppe angeben Lese-/Schreib-Map-Parameter
supported-VGPU-types Vereinigung aller virtuellen GPU-Typen, die von der zugrunde liegenden Hardware unterstützt werden Schreibgeschützt
enabled-VGPU-types Vereinigung aller virtuellen GPU-Typen, die auf den zugrunde liegenden pGPUs aktiviert wurden Schreibgeschützt
allocation-algorithm Tiefen-/Breiten-Einstellung für die Zuweisung virtueller GPUs auf pGPUs innerhalb der Gruppe Lese-/Schreib-Enum-Parameter

GPU-Gruppen-Operationen

Befehle für die Arbeit mit GPU-Gruppen
gpu-group-create
xe gpu-group-create name-label=name_for_group [name-description=description]
Erstellt eine neue (leere) GPU-Gruppe, in die pGPUs verschoben werden können.
gpu-group-destroy
xe gpu-group-destroy uuid=uuid_of_group
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
Gibt zurück, wie viele weitere 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
Ändert den Algorithmus, den die GPU-Gruppe verwendet, um virtuelle GPUs pGPUs zuzuweisen.

Parameter der virtuellen GPU

Virtuelle GPUs haben die folgenden Parameter:
Parametername Beschreibung Typ
uuid Der eindeutige Bezeichner/Objektreferenz für die virtuelle GPU Schreibgeschützt
vm-uuid Der eindeutige Bezeichner/Objektreferenz für die VM, der die virtuelle GPU zugewiesen ist Schreibgeschützt
vm-name-label Der Name der VM, der die virtuelle GPU zugewiesen ist Schreibgeschützt
gpu-group-uuid Der eindeutige Bezeichner/Objektreferenz für die GPU-Gruppe, in der die virtuelle GPU enthalten ist Schreibgeschützt
gpu-group-name-label Der Name der GPU-Gruppe, in der die virtuelle GPU enthalten ist Schreibgeschützt
currently-attached Der Wert ist true, wenn eine VM mit GPU-Passthrough ausgeführt wird, andernfalls false Schreibgeschützt
other-config Eine Liste von Schlüssel-Wert-Paaren, die zusätzliche Konfigurationsparameter für die virtuelle GPU angeben Lese-/Schreib-Map-Parameter
type-uuid Der eindeutige Bezeichner/die Objektreferenz für den virtuellen GPU-Typ dieser virtuellen GPU Lese-/Schreib-Map-Parameter
type-model-name Modellname, der dem virtuellen GPU-Typ zugeordnet ist Schreibgeschützt

Parameter des virtuellen GPU-Typs

Hinweis:
GPU-Passthrough und virtuelle GPUs sind nicht kompatibel mit Live-Migration, Storage-Live-Migration oder VM-Suspend, es sei denn, es sind unterstützte Software und Grafikkarten von GPU-Anbietern vorhanden. VMs ohne diese Unterstützung können nicht migriert werden, um Ausfallzeiten zu vermeiden. Informationen zur Kompatibilität von NVIDIA vGPU mit Live-Migration, Storage-Live-Migration und VM-Suspend finden Sie unter Grafik.
Virtuelle GPU-Typen haben die folgenden Parameter:
Parametername Beschreibung Typ
uuid Der eindeutige Bezeichner/Objektreferenz für den virtuellen GPU-Typ Schreibgeschützt
vendor-name Name des Anbieters der virtuellen GPU Schreibgeschützt
model-name Modellname, der dem virtuellen GPU-Typ zugeordnet ist Schreibgeschützt
freeze-frame Framebuffer-Größe des virtuellen GPU-Typs, in Bytes Schreibgeschützt
max-heads Maximale Anzahl der vom virtuellen GPU-Typ unterstützten Anzeigen Schreibgeschützt
supported-on-PGPUs Liste der pGPUs, die diesen virtuellen GPU-Typ unterstützen Schreibgeschützt
enabled-on-PGPUs Liste der pGPUs, bei denen dieser virtuelle GPU-Typ aktiviert ist Schreibgeschützt
VGPU-uuids Liste der virtuellen GPUs dieses Typs Schreibgeschützt

Virtuelle GPU-Vorgänge

vgpu-create

xe vgpu-create vm-uuid=uuid_of_vm gpu_group_uuid=uuid_of_gpu_group [vgpu-type-uuid=uuid_of_vgpu-type]
Erstellt eine virtuelle GPU. Dieser Befehl hängt die VM an die angegebene GPU-Gruppe an und gibt optional den virtuellen GPU-Typ an. Wird kein virtueller GPU-Typ angegeben, wird der Typ 'Pass-Through' angenommen.

vgpu-destroy

xe vgpu-destroy uuid=uuid_of_vgpu
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
Die Verwendung von false deaktiviert die VNC-Konsole für eine VM, da disablevnc=1 an den Display-Emulator weitergeleitet wird. Standardmäßig ist VNC aktiviert.

Host-Befehle

Befehle zur Interaktion mit dem XenServer-Host.
XenServer-Hosts sind die physischen Server, auf denen die XenServer-Software ausgeführt wird. Auf ihnen laufen VMs, die von einer speziellen privilegierten virtuellen Maschine, bekannt als Kontrolldomäne oder Domäne 0, gesteuert werden.
Die XenServer-Hostobjekte können mit den Standardbefehlen zur Objektlistung aufgelistet werden: xe host-list, xe host-cpu-list und xe host-crashdump-list). Die Parameter können mit den Standardparameterbefehlen manipuliert werden. Weitere Informationen finden Sie unter Low-level parameter commands.

Host-Selektoren

Mehrere der hier aufgeführten Befehle verfügen über einen gemeinsamen Mechanismus zur Auswahl eines oder mehrerer XenServer-Hosts, auf denen der Vorgang ausgeführt werden soll. Am einfachsten ist dies durch die Angabe des Arguments host=uuid_or_name_label. Sie können XenServer auch durch Filtern der vollständigen Hostliste nach den Werten von Feldern angeben. Wenn Sie beispielsweise enabled=true angeben, werden alle XenServer-Hosts ausgewählt, deren Feld enabled gleich true ist. Wenn mehrere XenServer-Hosts übereinstimmen und der Vorgang auf mehreren XenServer-Hosts ausgeführt werden kann, müssen Sie --multiple angeben, um den Vorgang auszuführen. Die vollständige Liste der Parameter, die abgeglichen werden können, wird am Anfang dieses Abschnitts beschrieben. Sie können diese Befehlsliste erhalten, indem Sie den Befehl xe host-list params=all ausführen. Wenn keine Parameter zur Auswahl von XenServer-Hosts angegeben werden, wird der Vorgang auf allen XenServer-Hosts ausgeführt.

Host-Parameter

XenServer-Hosts haben die folgenden Parameter:
Parametername Beschreibung Typ
uuid Der eindeutige Bezeichner/Objektreferenz für den XenServer-Host Nur lesen
name-label Der Name des XenServer-Hosts Lesen/Schreiben
name-description Die Beschreibungszeichenfolge des XenServer-Hosts Nur lesen
enabled Der Wert ist false, wenn deaktiviert. Dies verhindert, dass neue VMs auf den Hosts gestartet werden, und bereitet die Hosts auf das Herunterfahren oder den Neustart vor. Der Wert ist true, wenn der Host aktiviert ist. Nur lesen
API-version-major Hauptversionsnummer Nur lesen
API-version-minor Kleinere Versionsnummer Schreibgeschützt
API-version-vendor Identifizierung des API-Anbieters Schreibgeschützt
API-version-vendor-implementation Details der Anbieterimplementierung Schreibgeschützter Map-Parameter
logging Protokollierungskonfiguration Lese-/Schreib-Map-Parameter
suspend-image-sr-uuid Der eindeutige Bezeichner/Objektreferenz für den SR, in dem angehaltene Images abgelegt werden Lese-/Schreibzugriff
crash-dump-sr-uuid Die eindeutige Kennung/Objektreferenz für den SR, in dem Absturzabbilder abgelegt werden Lese-/Schreibzugriff
software-version Liste der Versionsparameter und ihrer Werte Nur Lese-Map-Parameter
capabilities Liste der Xen-Versionen, die der XenServer-Host ausführen kann Nur Lese-Set-Parameter
other-config Eine Liste von Schlüssel-Wert-Paaren, die zusätzliche Konfigurationsparameter für den XenServer-Host angeben Lese-/Schreib-Map-Parameter
chipset-info Eine Liste von Schlüssel-Wert-Paaren, die Informationen über den Chipsatz angeben Nur Lese-Map-Parameter
hostname XenServer-Host-Hostname Schreibgeschützt
address XenServer-Host-IP-Adresse Schreibgeschützt
license-server Eine Liste von Schlüssel-Wert-Paaren, die Informationen über den Lizenzserver angeben. Der Standardport für die Kommunikation mit dem Citrix Lizenzserver und dem Lizenzaktivierungsdienst ist 8083. Informationen zum Ändern von Portnummern aufgrund von Konflikten finden Sie unter Portnummern ändern Schreibgeschützter Map-Parameter
supported-bootloaders Liste der Bootloader, die der XenServer-Host unterstützt, zum Beispiel pygrub, eliloader Schreibgeschützter Set-Parameter
memory-total Gesamter physischer RAM auf dem XenServer-Host, in Byte Schreibgeschützt
memory-free Gesamter verbleibender physischer RAM, der VMs zugewiesen werden kann, in Bytes Schreibgeschützt
host-metrics-live Der Wert ist wahr, wenn der Host betriebsbereit ist, andernfalls falsch Schreibgeschützt
logging Der syslog_destination Schlüssel kann auf den Hostnamen eines entfernten, lauschenden Syslog-Dienstes gesetzt werden. Lese-/Schreib-Map-Parameter
allowed-operations Listet die in diesem Zustand zulässigen Operationen auf. Diese Liste dient nur zur Information, und der Host-Zustand kann sich geändert haben, bis ein Client dieses Feld liest. Schreibgeschützter Set-Parameter
current-operations Listet die aktuell laufenden Operationen auf. Diese Liste dient nur zur Information, und der Host-Zustand kann sich geändert haben, bis ein Client dieses Feld liest. Schreibgeschützter Set-Parameter
patches Satz von Host-Patches Schreibgeschützter Satzparameter
blobs Binärer Datenspeicher Schreibgeschützt
memory-free-computed Eine konservative Schätzung des maximalen freien Speichers auf einem Host Schreibgeschützt
ha-statefiles Die UUIDs aller HA-Statusdateien Schreibgeschützt
ha-network-peers Die UUIDs aller Hosts, die die VMs auf diesem Host hosten können, falls ein Fehler auftritt Schreibgeschützt
external-auth-type Art der externen Authentifizierung, zum Beispiel Active Directory. Schreibgeschützt
external-auth-service-name Der Name des externen Authentifizierungsdienstes Schreibgeschützt
external-auth-configuration Konfigurationsinformationen für den externen Authentifizierungsdienst. Schreibgeschützter Zuordnungsparameter
XenServer-Hosts enthalten einige andere Objekte, die ebenfalls Parameterlisten haben.
CPUs auf XenServer-Hosts haben die folgenden Parameter:
Parametername Beschreibung Typ
uuid Der eindeutige Bezeichner/die Objekt-Referenz für die CPU Schreibgeschützt
number Die Nummer des physischen CPU-Kerns innerhalb des XenServer-Hosts Schreibgeschützt
vendor Die Herstellerzeichenfolge für den CPU-Namen Schreibgeschützt
speed Die CPU-Taktrate in Hz Schreibgeschützt
modelname Die Herstellerzeichenfolge für das CPU-Modell, zum Beispiel „Intel(R) Xeon(TM) CPU 3.00 GHz“ Schreibgeschützt
stepping Die CPU-Revisionsnummer Schreibgeschützt
flags Die Flags der physischen CPU (eine dekodierte Version des Features-Feldes) Schreibgeschützt
Utilisation Die aktuelle CPU-Auslastung Schreibgeschützt
host-uuid Die UUID des Hosts, in dem sich die CPU befindet Schreibgeschützt
model Die Modellnummer der physischen CPU Schreibgeschützt
family Die Familiennummer der physischen CPU Schreibgeschützt
Absturzabbilder auf XenServer-Hosts haben die folgenden Parameter:
Parametername Beschreibung Typ
uuid Der eindeutige Bezeichner/Objektreferenz für das Absturzabbild Schreibgeschützt
host XenServer-Host, dem das Absturzabbild entspricht Schreibgeschützt
timestamp Zeitstempel des Datums und der Uhrzeit, zu der das Absturzabbild aufgetreten ist, im Format yyyymmdd-hhmmss-ABC, wobei ABC der Zeitzonenindikator ist, zum Beispiel GMT Schreibgeschützt
size Größe des Crashdumps in Bytes Nur lesen

host-all-editions

xe host-all-editions
Eine Liste aller verfügbaren Editionen abrufen

host-apply-edition

xe host-apply-edition [host-uuid=host_uuid] [edition=premium-per-socket|standard-per-socket|cloud]
Weist einem Hostserver die XenServer-Lizenz zu. Wenn Sie eine Lizenz zuweisen, kontaktiert XenServer den Lizenzserver und fordert den angegebenen Lizenztyp an. Wenn eine Lizenz verfügbar ist, wird sie vom Lizenzserver ausgecheckt.
Informationen zur anfänglichen Lizenzkonfiguration finden Sie auch unter license-server-address und license-server-port.
Editionswerte umfassen „cloud“, „free“, „premium-per-socket“ und „standard-per-socket“. Zukünftig wird nur noch „cloud“ unterstützt.

host-backup

xe host-backup file-name=backup_filename host=host_name
Laden Sie ein Backup der Steuerdomäne des angegebenen XenServer-Hosts auf den Computer herunter, von dem aus der Befehl aufgerufen wird. Speichern Sie es dort als Datei mit dem Namen file-name.
Wichtig:
Obwohl der Befehl xe host-backup funktioniert, wenn er auf dem lokalen Host ausgeführt wird (d. h. ohne Angabe eines spezifischen Hostnamens), sollten Sie ihn nicht auf diese Weise verwenden. Dies würde die Partition der Steuerdomäne mit der Sicherungsdatei füllen. Verwenden Sie den Befehl nur von einem entfernten, externen Computer aus, auf dem Sie genügend Speicherplatz für die Sicherungsdatei haben.

host-bugreport-upload

xe host-bugreport-upload [host-selector=host_selector_value...] [url=destination_url http-proxy=http_proxy_name]
Erstellen Sie einen neuen Fehlerbericht (mit xen-bugtool, einschließlich aller optionalen Dateien) und laden Sie ihn auf die Support-FTP-Site oder einen anderen Speicherort hoch.
Die Hosts, auf denen dieser Vorgang ausgeführt werden soll, werden über den Standardauswahlmechanismus ausgewählt (siehe Host-Selektoren oben). Optionale Argumente können eine beliebige Anzahl der zu Beginn dieses Abschnitts aufgeführten Host-Parameter sein.
Optionale Parameter sind http-proxy: Verwenden Sie den angegebenen HTTP-Proxy, und url: Laden Sie auf diese Ziel-URL hoch. Wenn optionale Parameter nicht verwendet werden, wird kein Proxyserver identifiziert und das Ziel ist die standardmäßige Support-FTP-Site.

host-call-plugin

xe host-call-plugin host-uuid=host_uuid plugin=plugin fn=function [args=args]
Ruft die Funktion innerhalb des Plug-ins auf dem angegebenen Host mit optionalen Argumenten auf.

host-compute-free-memory

xe host-compute-free-memory
Berechnet die Menge des freien Speichers auf dem Host.

host-compute-memory-overhead

xe host-compute-memory-overhead
Berechnet den Virtualisierungsspeicher-Overhead eines Hosts.

host-cpu-info

xe host-cpu-info [uuid=uuid]
Listet Informationen über die physischen CPUs des Hosts auf.

host-crashdump-destroy

xe host-crashdump-destroy uuid=crashdump_uuid
Löscht einen durch seine UUID angegebenen Host-Crashdump vom XenServer-Host.

host-crashdump-upload

xe host-crashdump-upload uuid=crashdump_uuid [url=destination_url] [http-proxy=http_proxy_name]
Lädt einen Crashdump auf die Support-FTP-Site oder einen anderen Speicherort hoch. Wenn optionale Parameter nicht verwendet werden, wird kein Proxyserver identifiziert und das Ziel ist die standardmäßige Support-FTP-Site. Optionale Parameter sind http-proxy: Verwenden Sie den angegebenen HTTP-Proxy, und url: Laden Sie auf diese Ziel-URL hoch.

host-declare-dead

xe host-declare-dead uuid=host_uuid
Erklärt, 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 tatsächlich ausgefallen ist.

host-disable

xe host-disable [host-selector=host_selector_value...]
Deaktiviert die angegebenen XenServer-Hosts, wodurch verhindert wird, dass neue VMs auf ihnen gestartet werden. Diese Aktion bereitet die XenServer-Hosts auf das Herunterfahren oder den Neustart vor. Nachdem dieser Host neu gestartet wurde, wird er automatisch wieder aktiviert, wenn alle Bedingungen für die Aktivierung erfüllt sind (z. B. Speicher verfügbar ist).
Die Hosts, auf denen dieser Vorgang ausgeführt werden soll, werden über den Standardauswahlmechanismus ausgewählt (siehe Host-Selektoren). Optionale Argumente können eine beliebige Anzahl der Host-Parameter sein, die am Anfang dieses Abschnitts aufgeführt sind.

host-disable-display

xe host-disable-display uuid=host_uuid
Deaktiviert die Anzeige für den Host.

host-disable-local-storage-caching

xe host-disable-local-storage-caching
Deaktiviert das lokale Speichercaching auf dem angegebenen Host.

host-dmesg

xe host-dmesg [host-selector=host_selector_value...]
Ruft einen Xen dmesg (die Ausgabe des Kernel-Ringpuffers) von den angegebenen XenServer-Hosts ab.
Die Hosts, auf denen dieser Vorgang ausgeführt werden soll, werden über den Standardauswahlmechanismus ausgewählt (siehe Host-Selektoren oben). Optionale Argumente können eine beliebige Anzahl der Host-Parameter sein, die am Anfang dieses Abschnitts aufgeführt sind.

host-emergency-ha-disable

xe host-emergency-ha-disable  [--force]
Deaktiviert HA auf dem lokalen Host. Nur zu verwenden, um einen Pool mit einer fehlerhaften HA-Einrichtung wiederherzustellen.

host-emergency-management-reconfigure

xe host-emergency-management-reconfigure interface=uuid_of_management_interface_pif
Konfigurieren Sie die Verwaltungsschnittstelle dieses XenServer-Hosts neu. Verwenden Sie diesen Befehl nur, wenn sich der XenServer-Host im Notfallmodus befindet. Der Notfallmodus bedeutet, dass der Host Mitglied eines Ressourcenpools ist, dessen Pool-Koordinator aus dem Netzwerk verschwunden ist und nach mehreren Versuchen nicht kontaktiert werden kann.

host-emergency-reset-server-certificate

xe host-emergency-reset-server-certificate
Installiert ein selbstsigniertes Zertifikat auf dem XenServer-Host, auf dem der Befehl ausgeführt wird.

host-enable

xe host-enable [host-selector=host_selector_value...]
Aktiviert die angegebenen XenServer-Hosts, wodurch neue VMs auf ihnen gestartet werden können.
Die Hosts, auf denen dieser Vorgang ausgeführt werden soll, werden über den Standardauswahlmechanismus ausgewählt (siehe Host-Selektoren oben). Optionale Argumente können eine beliebige Anzahl der Host-Parameter sein, die am Anfang dieses Abschnitts aufgeführt sind.

host-enable-display

xe host-enable-display uuid=host_uuid
Anzeige für den Host aktivieren.

host-enable-local-storage-caching

xe host-enable-local-storage-caching  sr-uuid=sr_uuid
Lokales Speichercaching auf dem angegebenen Host aktivieren.

host-evacuate

xe host-evacuate [host-selector=host_selector_value...]
Migriert alle laufenden VMs live auf andere geeignete Hosts in einem Pool. Deaktivieren Sie zuerst den Host mit dem Befehl host-disable.
Wenn der evakuierte Host der Pool-Koordinator ist, muss ein anderer Host als Pool-Koordinator ausgewählt werden. Um den Pool-Koordinator bei deaktiviertem HA zu ändern, verwenden Sie den Befehl pool-designate-new-master. Weitere Informationen finden Sie unter pool-designate-new-master.
Wenn HA aktiviert ist, besteht Ihre einzige Möglichkeit darin, den XenServer-Host herunterzufahren, wodurch HA zufällig einen neuen Pool-Koordinator wählt. Weitere Informationen finden Sie unter host-shutdown.
Die Hosts, auf denen dieser Vorgang ausgeführt werden soll, werden über den Standardauswahlmechanismus ausgewählt (siehe Host-Selektoren oben). Optionale Argumente können eine beliebige Anzahl der Host-Parameter sein, die am Anfang dieses Abschnitts aufgeführt sind.

host-forget

xe host-forget uuid=host_uuid
Der XAPI-Agent vergisst den angegebenen XenServer-Host, ohne ihn explizit zu kontaktieren.
Verwenden Sie den Parameter --force, um nicht zur Bestätigung aufgefordert zu werden, dass Sie diesen Vorgang wirklich ausführen möchten.
Warnung:
Verwenden Sie diesen Befehl nicht, wenn HA im Pool aktiviert ist. Deaktivieren Sie zuerst HA und aktivieren Sie es dann wieder, nachdem Sie den Host vergessen haben.
Dieser Befehl ist nützlich, wenn der XenServer-Host, der „vergessen“ werden soll, tot ist. Wenn der XenServer-Host jedoch aktiv und Teil des Pools ist, verwenden Sie stattdessen xe pool-eject.

host-get-server-certificate

xe host-get-server-certificate
Abrufen des installierten Server-TLS-Zertifikats.

host-get-sm-diagnostics

xe host-get-sm-diagnostics uuid=uuid
Anzeigen von SM-Diagnoseinformationen pro Host.

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...]
Laden Sie Systemstatusinformationen in die angegebene Datei herunter. Der optionale Parameter entries ist eine durch Kommas getrennte Liste von Systemstatuseinträgen, die aus dem XML-Fragment der Funktionen stammen, das vom Befehl host-get-system-status-capabilities zurückgegeben wird. Weitere Informationen finden Sie unter host-get-system-status-capabilities. Wenn nicht angegeben, werden alle Systemstatusinformationen in der Datei gespeichert. Der Parameter output kann tar.bz2 (Standard) oder zip sein. Wenn dieser Parameter nicht angegeben ist, wird die Datei im Format tar.bz2 gespeichert.
Die Hosts, auf denen dieser Vorgang ausgeführt werden soll, werden über den Standardauswahlmechanismus ausgewählt (siehe Host-Selektoren oben).

host-get-system-status-capabilities

xe host-get-system-status-capabilities [host-selector=host_selector_value...]
Abrufen der Systemstatusfunktionen für die angegebenen Hosts. 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>
Jede Fähigkeitsentität kann die folgenden Attribute haben.
  • key Eine eindeutige Kennung für die Fähigkeit.
  • content-type Kann entweder text/plain oder application/data sein. Zeigt an, ob eine Benutzeroberfläche die Einträge zur menschlichen Nutzung rendern kann.
  • default-checked Kann entweder ja oder nein sein. Zeigt an, ob eine Benutzeroberfläche diesen Eintrag standardmäßig auswählt.
  • min-size, max-size Zeigt einen ungefähren Größenbereich in Bytes für diesen Eintrag an. -1 bedeutet, dass die Größe unwichtig ist.
  • min-time, max-time Zeigt einen ungefähren Zeitbereich in Sekunden an, der zum Sammeln dieses Eintrags benötigt wird. -1 bedeutet, dass die Zeit unwichtig ist.
  • pii Persönlich identifizierbare Informationen. 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 haben:
    • no: keine PII in diesen Einträgen enthalten
    • yes: PII ist wahrscheinlich oder sicher in diesen Einträgen enthalten
    • maybe: Sie sollten diese Einträge möglicherweise auf PII prüfen
    • if_customized Wenn die Dateien unverändert sind, enthalten sie keine PII. Da wir jedoch die Bearbeitung dieser Dateien fördern, könnten durch solche Anpassungen PII eingeführt worden sein. Dieser Wert wird insbesondere für die Netzwerk-Skripte in der Kontrolldomäne verwendet.
    Passwörter dürfen niemals in Fehlerberichten enthalten sein, unabhängig von einer PII-Deklaration.
Die Hosts, auf denen dieser Vorgang ausgeführt werden soll, werden über den Standardauswahlmechanismus ausgewählt (siehe Host-Selektoren oben).

host-get-thread-diagnostics

xe host-get-thread-diagnostics uuid=uuid
Anzeige der Thread-Diagnoseinformationen pro Host.

host-get-vms-which-prevent-evacuation

xe host-get-vms-which-prevent-evacuation uuid=uuid
Gibt eine Liste von VMs zurück, die die Evakuierung eines bestimmten Hosts verhindern, und zeigt die Gründe für jede einzelne an.

host-is-in-emergency-mode

xe host-is-in-emergency-mode
Gibt true zurück, wenn sich der Host, mit dem die CLI kommuniziert, im Notfallmodus befindet, andernfalls false. Dieser CLI-Befehl funktioniert direkt auf Pool-Mitglieds-Hosts, auch wenn kein Pool-Koordinator vorhanden ist.

host-license-view

xe host-license-view [host-uuid=host_uuid]
Zeigt den Inhalt der XenServer-Hostlizenz an.

host-logs-download

xe host-logs-download [file-name=logfile_name] [host-selector=host_selector_value...]
Lädt eine Kopie der Protokolle der angegebenen XenServer-Hosts herunter. Die Kopie wird standardmäßig in einer mit einem Zeitstempel versehenen Datei namens hostname-yyyy-mm-dd T hh:mm:ssZ.tar.gz gespeichert. Sie können einen anderen Dateinamen mit dem optionalen Parameter file-name angeben.
Die Hosts, auf denen dieser Vorgang ausgeführt werden soll, werden über den Standardauswahlmechanismus ausgewählt (siehe Host-Selektoren oben). Optionale Argumente können eine beliebige Anzahl der zu Beginn dieses Abschnitts aufgeführten Host-Parameter sein.
Wichtig:
Obwohl der Befehl xe host-logs-download funktioniert, wenn er auf dem lokalen Host ausgeführt wird (d. h. ohne Angabe eines spezifischen Hostnamens), sollten Sie ihn nicht auf diese Weise verwenden. Dies würde die Partition der Steuerdomäne mit der Kopie der Protokolle überladen. Verwenden Sie den Befehl nur von einem entfernten, externen Computer aus, auf dem Sie Platz für die Kopie der Protokolle haben.

host-management-disable

xe host-management-disable
Deaktiviert den Host-Agenten, der auf einer externen Management-Netzwerkschnittstelle lauscht, und trennt alle verbundenen API-Clients (wie XenCenter). Dieser Befehl wird direkt auf dem XenServer-Host ausgeführt, mit dem die CLI verbunden ist. Der Befehl wird nicht an den Pool-Koordinator weitergeleitet, wenn er auf einen Mitglieds-XenServer-Host angewendet wird.
Warnung:
Seien Sie vorsichtig, wenn Sie diesen CLI-Befehl extern verwenden. Nachdem dieser Befehl ausgeführt wurde, können Sie sich nicht mehr remote über das Netzwerk mit der Steuerdomäne verbinden, um den Host-Agenten wieder zu aktivieren.

host-management-reconfigure

xe host-management-reconfigure [interface=device] [pif-uuid=uuid]
Konfiguriert den XenServer-Host neu, um die angegebene Netzwerkschnittstelle als seine Verwaltungsschnittstelle zu verwenden, welche die Schnittstelle ist, die zur Verbindung mit dem XenCenter verwendet wird. Der Befehl überschreibt den MANAGEMENT_INTERFACE-Schlüssel in /etc/xensource-inventory.
Wenn der Gerätename einer Schnittstelle (die eine IP-Adresse haben muss) angegeben wird, bindet der XenServer-Host sofort neu. Dieser Befehl funktioniert sowohl im Normal- als auch im Notfallmodus.
Wenn die UUID eines PIF-Objekts angegeben wird, bestimmt der XenServer-Host, welche IP-Adresse er sich selbst neu zuweisen soll. Er 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 Sie auf der neuen Schnittstelle Netzwerkverbindung haben. Verwenden Sie xe pif-reconfigure, um zuerst eine einzurichten. Andernfalls können nachfolgende CLI-Befehle den XenServer-Host nicht erreichen.

host-power-on

xe host-power-on [host=host_uuid]
Schaltet die Stromversorgung von XenServer-Hosts ein, bei denen die Funktion Host Power On aktiviert ist. Bevor Sie diesen Befehl verwenden, aktivieren Sie host-set-power-on auf dem Host.

host-reboot

xe host-reboot [host-selector=host_selector_value...]
Startet die angegebenen XenServer-Hosts neu. Die angegebenen Hosts 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 über den Standardauswahlmechanismus ausgewählt (siehe Host-Selektoren oben). Optionale Argumente können beliebig viele der Host-Parameter sein, die am Anfang dieses Abschnitts aufgeführt sind.
Wenn die angegebenen XenServer-Hosts Mitglieder eines Pools sind, wird der Verbindungsverlust beim Herunterfahren behandelt und der Pool stellt sich wieder her, wenn die XenServer-Hosts zurückkehren. Die anderen Mitglieder und der Pool-Koordinator funktionieren weiterhin.
Wenn Sie den Pool-Koordinator herunterfahren, ist der Pool außer Betrieb, bis eine der folgenden Aktionen eintritt:
  • Sie machen eines der Mitglieder zum Pool-Koordinator
  • Der ursprüngliche Pool-Koordinator wird neu gestartet und ist wieder online.
    Wenn der Pool-Koordinator wieder online ist, verbinden sich die Mitglieder wieder und synchronisieren sich mit dem Pool-Koordinator.

host-restore

xe host-restore [file-name=backup_filename] [host-selector=host_selector_value...]
Stellen Sie ein Backup namens file-name der XenServer-Host-Steuerungssoftware wieder her. Die Verwendung des Wortes „Wiederherstellen“ bedeutet hier keine vollständige Wiederherstellung im üblichen Sinne, sondern lediglich, dass die komprimierte Sicherungsdatei entpackt und auf die sekundäre Partition ausgepackt wurde. Nachdem Sie ein xe host-restore durchgeführt haben, müssen Sie die Installations-CD booten und deren Option „Aus Backup wiederherstellen“ verwenden.
Die Hosts, auf denen dieser Vorgang ausgeführt werden soll, werden über den Standardauswahlmechanismus ausgewählt (siehe Host-Selektoren oben). Optionale Argumente können eine beliebige Anzahl der Host-Parameter sein, die am Anfang dieses Abschnitts aufgeführt sind.

host-send-debug-keys

xe host-send-debug-keys  host-uuid=host_uuid keys=keys
Senden Sie die angegebenen 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]
Installieren Sie ein TLS-Zertifikat auf einem XenServer-Host.

host-set-hostname-live

xe host-set-hostname-live host-uuid=uuid_of_host host-name=new_hostname
Ändern Sie den Hostnamen des XenServer-Hosts, der durch host-uuid angegeben ist. Dieser Befehl legt den Hostnamen sowohl in der Steuerdomänen-Datenbank als auch den tatsächlichen Linux-Hostnamen des XenServer-Hosts dauerhaft fest. Der Wert von host-name ist nicht derselbe wie der Wert des Feldes name_label.

host-set-power-on-mode

xe host-set-power-on-mode host=host_uuid power-on-mode={"" | "wake-on-lan" | "IPMI" | "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 ]
Verwenden Sie dies, um die Funktion Host Power On auf XenServer-Hosts zu aktivieren, die mit Remote-Stromversorgungslösungen kompatibel sind. Bei Verwendung des Befehls host-set-power-on müssen Sie den Typ der Energieverwaltungslösung auf dem Host angeben (d. h. den Power-On-Modus). Geben Sie dann Konfigurationsoptionen mithilfe des Arguments power-on-config und der zugehörigen Schlüssel-Wert-Paare an.
Um die Secrets-Funktion zum Speichern Ihres Passworts zu verwenden, geben Sie den Schlüssel "power_on_password_secret" an. Weitere Informationen finden Sie unter Secrets.

host-shutdown

xe host-shutdown [host-selector=host_selector_value...]
Fahren Sie die angegebenen XenServer-Hosts herunter. Die angegebenen XenServer-Hosts 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 über den Standardauswahlmechanismus ausgewählt (siehe Host-Selektoren oben). Optionale Argumente können beliebig viele der Host-Parameter sein, die am Anfang dieses Abschnitts aufgeführt sind.
Wenn die angegebenen XenServer-Hosts Mitglieder eines Pools sind, wird der Konnektivitätsverlust beim Herunterfahren behandelt und der Pool erholt sich, wenn die XenServer-Hosts zurückkehren. Die anderen Mitglieder und der Pool-Koordinator funktionieren weiterhin.
Wenn Sie den Pool-Koordinator herunterfahren, ist der Pool außer Betrieb, bis eine der folgenden Aktionen eintritt:
  • Sie machen eines der Mitglieder zum Pool-Koordinator
  • Der ursprüngliche Pool-Koordinator wird neu gestartet und ist wieder online.
    Wenn der Pool-Koordinator wieder online ist, verbinden sich die Mitglieder wieder und synchronisieren sich mit dem Pool-Koordinator.
Wenn HA für den Pool aktiviert ist, wird eines der Mitglieder automatisch zum Pool-Koordinator ernannt. Wenn HA deaktiviert ist, müssen Sie den gewünschten XenServer-Host manuell mit dem Befehl pool-designate-new-master als Pool-Koordinator festlegen. Weitere Informationen finden Sie unter pool-designate-new-master.

host-sm-dp-destroy

xe host-sm-dp-destroy uuid=uuid dp=dp [allow-leak=true|false]
Versuchen Sie, einen Speicher-Datenpfad auf einem Host zu zerstören und zu bereinigen. Wenn allow-leak=true angegeben ist, werden alle Datensätze des Datenpfads gelöscht, auch wenn er nicht sauber heruntergefahren wurde.

host-sync-data

xe host-sync-data
Synchronisieren Sie die auf dem Pool-Koordinator gespeicherten Daten mit dem benannten Host. Dies schließt die Datenbankdaten nicht ein).

host-syslog-reconfigure

xe host-syslog-reconfigure [host-selector=host_selector_value...]
Konfigurieren Sie den syslog Daemon auf den angegebenen XenServer-Hosts neu. Dieser Befehl wendet die Konfigurationsinformationen an, die im Host-Parameter logging definiert sind.
Die Hosts, auf denen dieser Vorgang ausgeführt werden soll, werden über den Standardauswahlmechanismus ausgewählt (siehe Host-Selektoren oben). Optionale Argumente können beliebig viele der Host-Parameter sein, die am Anfang dieses Abschnitts aufgeführt sind.

host-data-source-list

xe host-data-source-list [host-selectors=host selector value...]
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 beliebig viele der Host-Parameter sein, die am Anfang dieses Abschnitts aufgeführt sind. Wenn keine Parameter zur Auswahl von Hosts angegeben werden, wird der Vorgang auf allen Hosts ausgeführt.
Datenquellen haben zwei Parameter – standard und enabled. Dieser Befehl gibt die Werte der Parameter aus:
  • Wenn für eine Datenquelle enabled auf true gesetzt ist, werden die Metriken derzeit in der Leistungsdatenbank aufgezeichnet.
  • Wenn für eine Datenquelle standard auf true gesetzt ist, werden die Metriken standardmäßig in der Leistungsdatenbank aufgezeichnet. Der Wert von enabled wird für diese Datenquelle ebenfalls auf true gesetzt.
  • Wenn für eine Datenquelle standard auf false gesetzt ist, werden die Metriken nicht standardmäßig in der Leistungsdatenbank aufgezeichnet. Der Wert von enabled wird für diese Datenquelle ebenfalls auf false gesetzt.
Um die Aufzeichnung von Datenquellenmetriken in der Leistungsdatenbank zu starten, führen Sie den Befehl host-data-source-record aus. Dieser Befehl setzt enabled auf true. Zum Beenden führen Sie host-data-source-forget aus. Dieser Befehl setzt enabled auf false.

host-data-source-record

xe host-data-source-record data-source=name_description_of_data_source [host-selectors=host_selector_value...]
Die angegebene Datenquelle für einen Host aufzeichnen.
Dieser Vorgang schreibt die Informationen aus der Datenquelle in die persistente Leistungsmetrikdatenbank der angegebenen Hosts. Aus Leistungsgründen ist diese Datenbank von der normalen Agentendatenbank getrennt.
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 beliebig viele der Host-Parameter sein, die am Anfang dieses Abschnitts aufgeführt sind. Wenn keine Parameter zur Auswahl von Hosts angegeben werden, 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...]
Beenden Sie die Aufzeichnung der angegebenen Datenquelle für einen Host und löschen 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 beliebig viele der Host-Parameter sein, die am Anfang dieses Abschnitts aufgeführt sind. Wenn keine Parameter zur Auswahl von Hosts angegeben werden, 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...]
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 Host-Parameter sein, die am Anfang dieses Abschnitts aufgeführt sind. Wenn keine Parameter zur Auswahl von Hosts angegeben werden, wird der Vorgang auf allen Hosts ausgeführt.

Nachrichtenbefehle

Befehle für die Arbeit mit Nachrichten. Nachrichten werden erstellt, um Benutzer über wichtige Ereignisse zu informieren, und werden in XenCenter als Warnungen angezeigt.
Die Nachrichtenobjekte können mit dem Standardbefehl zur Objektlistung (xe message-list) aufgelistet und die Parameter mit den Standardparameterbefehlen manipuliert werden. Weitere Informationen finden Sie unter Low-level-Parameterbefehle

Nachrichtenparameter

Parametername Beschreibung Typ
uuid Der eindeutige Bezeichner/Objektreferenz für die Nachricht Nur lesen
name Der eindeutige Name der Nachricht Nur lesen
priority Die Nachrichtenpriorität. Höhere Zahlen weisen auf eine höhere Priorität hin. Schreibgeschützt
class Die Nachrichtenklasse, zum Beispiel VM. Schreibgeschützt
obj-uuid Die UUID des betroffenen Objekts. Schreibgeschützt
timestamp Die Zeit, zu der die Nachricht generiert wurde. Schreibgeschützt
body Der Nachrichteninhalt. Schreibgeschützt

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]]
Erstellt eine Nachricht.

message-destroy

xe message-destroy [uuid=message_uuid]
Zerstört eine vorhandene Nachricht. Sie können ein Skript erstellen, um alle Nachrichten zu zerstören. Zum Beispiel:
# Dismiss all alerts   \
    IFS=","; for m in $(xe message-list params=uuid --minimal); do  \
    xe message-destroy uuid=$m  \
    done

Netzwerkbefehle

Befehle für die Arbeit mit Netzwerken.
Die Netzwerkobjekte können mit dem Standardbefehl zur Objektlistung (xe network-list) aufgelistet und die Parameter mit den Standardparameterbefehlen manipuliert werden. Weitere Informationen finden Sie unter Befehle für Parameter auf niedriger Ebene

Netzwerkparameter

Netzwerke haben die folgenden Parameter:
Parametername Beschreibung Typ
uuid Der eindeutige Bezeichner/Objektreferenz für das Netzwerk Nur Lesezugriff
name-label Der Name des Netzwerks Lesen/Schreiben
name-description Der Beschreibungstext des Netzwerks Lesen/Schreiben
VIF-uuids Eine Liste eindeutiger Bezeichner der VIFs (virtuelle Netzwerkschnittstellen), die von VMs mit diesem Netzwerk verbunden sind Nur-Lese-Satzparameter
PIF-uuids Eine Liste eindeutiger Bezeichner der PIFs (physische Netzwerkschnittstellen), die von XenServer-Hosts mit diesem Netzwerk verbunden sind Nur-Lese-Satzparameter
bridge Name der Brücke, die diesem Netzwerk auf dem lokalen XenServer-Host entspricht Nur-Lese
default-locking-mode Ein Netzwerkobjekt, das mit VIF-Objekten für die ARP-Filterung verwendet wird. Auf unlocked setzen, um alle mit dem VIF verbundenen Filterregeln zu entfernen. Auf disabled setzen, damit das VIF den gesamten Datenverkehr verwirft. Lesen/Schreiben
purpose Eine Reihe von Zwecken, für die der XenServer-Host dieses Netzwerk verwendet. Auf nbd setzen, um das Netzwerk für NBD-Verbindungen zu verwenden. Lesen/Schreiben
other-config:staticroutes Kommagetrennte Liste von Einträgen im Format Subnetz/Netzmaske/Gateway, die die Gateway-Adresse angeben, über die Subnetze geroutet werden sollen. 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 Datenverkehr auf 172.18.0.0/16 über 192.168.0.4 geleitet. Lesen/Schreiben
other-config:ethtoolautoneg Auf no setzen, um die Autonegotiation der physischen Schnittstelle oder Bridge zu deaktivieren. Standard ist yes. Lesen/Schreiben
other-config:ethtool-rx Auf on setzen, um die Empfangs-Prüfsumme zu aktivieren, auf off, um sie zu deaktivieren. Lesen/Schreiben
other-config:ethtool-tx Auf 'on' setzen, um die Übertragungsprüfsumme zu aktivieren, auf 'off', um sie zu deaktivieren Lesen/Schreiben
other-config:ethtool-sg Auf 'on' setzen, um Scatter-Gather zu aktivieren, auf 'off', um es zu deaktivieren Lesen/Schreiben
other-config:ethtool-tso Auf 'on' setzen, um die TCP-Segmentierungs-Auslagerung zu aktivieren, auf 'off', um sie zu deaktivieren Lesen/Schreiben
other-config:ethtool-ufo Auf 'on' setzen, um die UDP-Fragment-Auslagerung zu aktivieren, auf 'off', um sie zu deaktivieren Lesen/Schreiben
other-config:ethtool-gso Auf 'on' setzen, um die generische Segmentierungs-Auslagerung zu aktivieren, auf 'off', um sie zu deaktivieren Lesen/Schreiben
blobs Binärer Datenspeicher Nur lesen

network-create

xe network-create name-label=name_for_network [name-description=descriptive_text]
Erstellt ein Netzwerk.

network-destroy

xe network-destroy uuid=network_uuid
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 Objektlistung (xe network-sriov-list) aufgelistet und die Parameter mit den Standardparameterbefehlen manipuliert werden. Weitere Informationen finden Sie unter Low-level parameter commands

SR-IOV-Parameter

SR-IOV hat die folgenden Parameter:
Parametername Beschreibung Typ
physical-PIF Die PIF zur Aktivierung von SR-IOV. Schreibgeschützt
logical-PIF Eine logische SR-IOV-PIF. Benutzer können diesen Parameter verwenden, um ein SR-IOV-VLAN-Netzwerk zu erstellen. Schreibgeschützt
requires-reboot Wenn auf true gesetzt, wird der Host neu gestartet, um die SR-IOV-Aktivierung wirksam werden zu lassen. Schreibgeschützt
remaining-capacity Anzahl der verbleibenden verfügbaren VFs. Schreibgeschützt

network-sriov-create

xe network-sriov-create network-uuid=network_uuid pif-uuid=physical_pif_uuid
Erstellt ein SR-IOV-Netzwerkobjekt für eine gegebene physische PIF und aktiviert SR-IOV auf der physischen PIF.

network-sriov-destroy

xe network-sriov-destroy uuid=network_sriov_uuid
Entfernt ein Netzwerk-SR-IOV-Objekt und deaktiviert SR-IOV auf seinem physischen PIF.

SR-IOV VF zuweisen

xe vif-create device=device_index mac=vf_mac_address network-uuid=sriov_network vm-uuid=vm_uuid
Weist einer VM einen VF aus einem SR-IOV-Netzwerk zu.

SDN-Controller-Befehle

Befehle für die Arbeit mit dem SDN-Controller.

sdn-controller-forget

xe sdn-controller-introduce [address=address] [protocol=protocol] [tcp-port=tcp_port]
Einen SDN-Controller einführen.

sdn-controller-introduce

xe sdn-controller-forget uuid=uuid
Einen SDN-Controller entfernen.

Tunnelbefehle

Befehle für die Arbeit mit Tunneln.

tunnel-create

xe tunnel-create pif-uuid=pif_uuid network-uuid=network_uuid
Einen neuen Tunnel auf einem Host erstellen.

tunnel-destroy

xe tunnel-destroy uuid=uuid
Einen Tunnel zerstören.

Patch-Befehle

Befehle für die Arbeit mit Patches.

patch-apply

xe patch-apply uuid=patch_uuid host-uuid=host_uuid
Wendet den zuvor hochgeladenen Patch auf den angegebenen Host an.

patch-clean

xe patch-clean uuid=uuid
Löscht eine zuvor hochgeladene Patch-Datei.

patch-destroy

xe patch-destroy uuid=uuid
Entfernt einen nicht angewendeten Patch-Eintrag und zugehörige Dateien vom Host.

patch-pool-apply

xe patch-pool-apply uuid=uuid
Wendet den zuvor hochgeladenen Patch auf alle Hosts im Pool an.

patch-pool-clean

xe patch-pool-clean uuid=uuid
Löscht eine zuvor hochgeladene Patch-Datei auf allen Hosts im Pool.

patch-precheck

xe patch-precheck uuid=uuid host-uuid=host_uuid
Führt die im Patch enthaltenen Vorabprüfungen aus, der zuvor auf den angegebenen Host hochgeladen wurde.

patch-upload

xe patch-upload file-name=file_name
Laden Sie eine Patch-Datei auf den Host hoch.

PBD-Befehle

Befehle für die Arbeit mit PBDs (Physical Block Devices). PBDs sind die Softwareobjekte, über die der XenServer-Host auf Speicher-Repositorys (SRs) zugreift.
Die PBD-Objekte können mit dem Standardbefehl zur Objektlistung (xe pbd-list) aufgelistet und die Parameter mit den Standard-Parameterbefehlen manipuliert werden. Weitere Informationen finden Sie unter Low-level parameter commands

PBD-Parameter

PBDs haben die folgenden Parameter:
Parametername Beschreibung Typ
uuid Der eindeutige Bezeichner/Objektreferenz für das PBD. Schreibgeschützt
sr-uuid Das Speicher-Repository, auf das das PBD verweist Schreibgeschützt
device-config Zusätzliche Konfigurationsinformationen, die dem SR-Backend-Treiber eines Hosts bereitgestellt werden Schreibgeschützter Map-Parameter
currently-attached Der Wert ist wahr, wenn der SR an diesem Host angehängt ist, andernfalls falsch. Schreibgeschützt
host-uuid UUID der physischen Maschine, auf der die PBD verfügbar ist Schreibgeschützt
host Das Feld host ist veraltet. Verwenden Sie stattdessen host_uuid. Schreibgeschützt
other-config Zusätzliche Konfigurationsinformationen. Lese-/Schreib-Map-Parameter

pbd-create

xe pbd-create host-uuid=uuid_of_host sr-uuid=uuid_of_sr [device-config:key=corresponding_value]
Erstellen Sie eine PBD auf Ihrem XenServer-Host. Der schreibgeschützte device-config Parameter kann nur bei der Erstellung festgelegt werden.
Um eine Zuordnung von 'path' zu '/tmp' hinzuzufügen, stellen Sie sicher, dass die Befehlszeile das Argument device-config:path=/tmp enthält
Eine vollständige Liste der unterstützten Gerätekonfigurations-Schlüssel-Wert-Paare für jeden SR-Typ finden Sie unter Speicher.

pbd-destroy

xe pbd-destroy uuid=uuid_of_pbd
Zerstören Sie die angegebene PBD.

pbd-plug

xe pbd-plug uuid=uuid_of_pbd
Versucht, die PBD an den XenServer-Host anzuschließen. Wenn dieser Befehl erfolgreich ist, wird der referenzierte SR (und die darin enthaltenen VDIs) für den XenServer-Host sichtbar.

pbd-unplug

xe pbd-unplug uuid=uuid_of_pbd
Versuchen Sie, die PBD vom XenServer-Host zu trennen.

PIF-Befehle

Befehle für die Arbeit mit PIFs (Objekte, die die physischen Netzwerkschnittstellen darstellen).
Die PIF-Objekte können mit dem Standardbefehl zur Objektlistung (xe pif-list) aufgelistet und die Parameter mit den Standard-Parameterbefehlen manipuliert werden. Weitere Informationen finden Sie unter Low-level-Parameterbefehle

PIF-Parameter

PIFs haben die folgenden Parameter:
Parametername Beschreibung Typ
uuid Der eindeutige Bezeichner/Objektreferenz für die PIF Nur lesen
device machine-readable Name der Schnittstelle (z. B. eth0) Nur lesen
MAC Die MAC-Adresse der PIF Nur lesen
other-config Zusätzliche PIF-Konfigurations-name:value-Paare. Lese-/Schreibkartenparameter
physical Wenn wahr, verweist die PIF auf eine tatsächliche physische Netzwerkschnittstelle Nur Lesezugriff
currently-attached Ist die PIF derzeit an diesem Host angehängt? true oder false Nur Lesezugriff
MTU Maximale Übertragungseinheit der PIF in Bytes. Nur Lesezugriff
VLAN VLAN-Tag für den gesamten Datenverkehr, der diese Schnittstelle durchläuft. -1 bedeutet, dass kein VLAN-Tag zugewiesen ist Nur Lesezugriff
bond-master-of Die UUID des Bonds, dessen Hauptschnittstelle diese PIF ist (falls vorhanden) Nur Lesezugriff
bond-slave-of Die UUID des Bonds, zu dem dieses PIF gehört (falls vorhanden) Schreibgeschützt
management Ist dieses PIF als Verwaltungsschnittstelle für die Kontrolldomäne vorgesehen? Schreibgeschützt
network-uuid Der eindeutige Bezeichner/die Objektreferenz des virtuellen Netzwerks, mit dem dieses PIF verbunden ist Schreibgeschützt
network-name-label Der Name des virtuellen Netzwerks, mit dem dieses PIF verbunden ist Schreibgeschützt
host-uuid Der eindeutige Bezeichner/die Objektreferenz des XenServer-Hosts, mit dem dieses PIF verbunden ist Schreibgeschützt
host-name-label Der Name des XenServer-Hosts, mit dem diese PIF verbunden ist Schreibgeschützt
IP-configuration-mode Verwendeter Typ der Netzwerkadresskonfiguration; DHCP oder statisch Schreibgeschützt
IP IP-Adresse der PIF. Hier definiert, wenn der IP-Konfigurationsmodus statisch ist; undefiniert bei DHCP Schreibgeschützt
netmask Netzmaske der PIF. Hier definiert, wenn der IP-Konfigurationsmodus statisch ist; undefiniert, wenn von DHCP bereitgestellt Schreibgeschützt
gateway Gateway-Adresse der PIF. Hier definiert, wenn der IP-Konfigurationsmodus statisch ist; undefiniert, wenn von DHCP bereitgestellt Schreibgeschützt
DNS DNS-Adresse des PIF. Hier definiert, wenn der IP-Konfigurationsmodus statisch ist; undefiniert, wenn von DHCP bereitgestellt Schreibgeschützt
io_read_kbs Durchschnittliche Leserate in kB/s für das Gerät Schreibgeschützt
io_write_kbs Durchschnittliche Schreibrate in kB/s für das Gerät Schreibgeschützt
carrier Verbindungsstatus für dieses Gerät Schreibgeschützt
vendor-id Die dem Hersteller der NIC zugewiesene ID Schreibgeschützt
vendor-name Der Name des NIC-Herstellers Schreibgeschützt
device-id Die vom Hersteller diesem NIC-Modell zugewiesene ID Schreibgeschützt
device-name Der vom Hersteller diesem NIC-Modell zugewiesene Name Schreibgeschützt
speed Datenübertragungsrate der NIC Schreibgeschützt
duplex Duplexmodus der NIC; voll oder halb Schreibgeschützt
pci-bus-path PCI-Buspfadadresse Schreibgeschützt
other-config:ethtoolspeed Legt die Verbindungsgeschwindigkeit in Mbit/s fest Lese-/Schreibzugriff
other-config:ethtoolautoneg Auf „no“ setzen, um die Autonegotiation der physischen Schnittstelle oder Bridge zu deaktivieren. Standard ist „yes“. Lese-/Schreibzugriff
other-config:ethtoolduplex Legt die Duplex-Fähigkeit der PIF fest, entweder Full oder Half. Lese-/Schreibzugriff
other-config:ethtool-rx Auf „on“ setzen, um die Empfangs-Prüfsumme zu aktivieren, auf „off“, um sie zu deaktivieren. Lese-/Schreibzugriff
other-config:ethtool-tx Auf 'on' setzen, um die Übertragungs-Prüfsumme zu aktivieren, auf 'off', um sie zu deaktivieren Lesen/Schreiben
other-config:ethtool-sg Auf 'on' setzen, um Scatter/Gather zu aktivieren, auf 'off', um es zu deaktivieren Lesen/Schreiben
other-config:ethtool-tso Auf 'on' setzen, um TCP-Segmentierungs-Offload zu aktivieren, auf 'off', um es zu deaktivieren Lesen/Schreiben
other-config:ethtool-ufo Auf 'on' setzen, um UDP-Fragment-Offload zu aktivieren, auf 'off', um es zu deaktivieren Lesen/Schreiben
other-config:ethtool-gso Auf 'on' setzen, um generisches Segmentierungs-Offload zu aktivieren, auf 'off', um es zu deaktivieren Lesen/Schreiben
other-config:domain Kommagetrennte Liste zum Festlegen des DNS-Suchpfads Lesen/Schreiben
other-config:bondmiimon Intervall zwischen Link-Liveness-Prüfungen, in Millisekunden Lesen/Schreiben
other-config:bonddowndelay Anzahl der Millisekunden, die nach dem Verlust der Verbindung gewartet werden soll, bevor die Verbindung wirklich als verloren betrachtet wird. Dieser Parameter ermöglicht vorübergehenden Verbindungsverlust. Lesen/Schreiben
other-config:bondupdelay Anzahl der Millisekunden, die nach dem Herstellen der Verbindung gewartet werden soll, bevor sie wirklich als hergestellt betrachtet wird. Ermöglicht das Hochfahren von Links. Der Standardwert ist 31s, um den Switches Zeit zu geben, mit der Weiterleitung des Datenverkehrs zu beginnen. Lesen/Schreiben
disallow-unplug Der Wert ist true, wenn diese PIF eine dedizierte Speicher-NIC ist, andernfalls false. Lesen/Schreiben
Hinweis:
Änderungen an den other-config Feldern eines PIF werden erst nach einem Neustart wirksam. Alternativ verwenden Sie die Befehle xe pif-unplug und xe pif-plug, um die PIF-Konfiguration neu schreiben zu lassen.

pif-forget

xe pif-forget uuid=uuid_of_pif
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
Erstellt ein PIF-Objekt, das eine physische Schnittstelle auf dem angegebenen XenServer-Host darstellt.

pif-plug

xe pif-plug uuid=uuid_of_pif
Versucht, die angegebene physische 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]
Ändern Sie die IP-Adresse des PIF. Für die statische IP-Konfiguration setzen Sie den Parameter mode auf static, wobei die Parameter gateway, IP und netmask auf die entsprechenden Werte eingestellt werden. 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 mit einem Port an einem Switch verbunden sind, der das Spanning Tree Protocol verwendet, wobei STP Fast Link deaktiviert (oder nicht unterstützt) ist, führt zu einer Zeitspanne, in der 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]
Konfiguriert die IPv6-Adresseinstellungen auf einem PIF neu.

pif-scan

xe pif-scan host-uuid=host_uuid
Suchen Sie auf Ihrem XenServer-Host nach neuen physischen Schnittstellen.

pif-set-primary-address-type

xe pif-set-primary-address-type  uuid=uuid primary_address_type=address_type
Ändern Sie den primären Adresstyp, der von dieser PIF verwendet wird.

pif-unplug

xe pif-unplug uuid=uuid_of_pif
Versuchen Sie, die angegebene physische Schnittstelle herunterzufahren.

Pool-Befehle

Befehle für die Arbeit mit Pools. Ein Pool ist eine Aggregation von einem oder mehreren XenServer-Hosts. Ein Pool verwendet einen oder mehrere gemeinsam genutzte Speicher-Repositories, sodass die auf einem Host im Pool ausgeführten VMs nahezu in Echtzeit auf einen anderen Host im Pool migriert werden können. Diese Migration erfolgt, während die VM noch läuft, ohne dass sie heruntergefahren und neu gestartet werden muss.
Jeder XenServer-Host ist standardmäßig ein Pool, der aus einem einzelnen Mitglied besteht. Wenn Ihr XenServer-Host einem Pool beigetreten ist, wird er als Mitglied bezeichnet. Wenn der Pool, dem der Host beigetreten ist, aus einem einzelnen Mitglied besteht, wird dieses Mitglied zum Pool-Koordinator. Wenn der Pool, dem der Host beigetreten ist, bereits mehrere Mitglieder hat, ist eines dieser Mitglieder bereits der Pool-Koordinator und bleibt dies auch, wenn der neue Host dem Pool beitritt.
Das Singleton-Pool-Objekt kann mit dem Standardbefehl zur Objektlistung (xe pool-list) aufgelistet werden. Seine Parameter können mit den Standardparameterbefehlen manipuliert werden. Weitere Informationen finden Sie unter Low-level parameter commands

Pool-Parameter

Pools haben die folgenden Parameter:
Parametername Beschreibung Typ
uuid Der eindeutige Bezeichner/Objektreferenz für den Pool Nur lesen
name-label Der Name des Pools Lesen/Schreiben
name-description Die Beschreibungszeichenfolge des Pools Lesen/Schreiben
master Der eindeutige Bezeichner/Objektreferenz des XenServer-Hosts, der als Koordinator des Pools festgelegt ist Nur lesen
default-SR Der eindeutige Bezeichner/Objektreferenz des Standard-SR für den Pool Lesen/Schreiben
crash-dump-SR Der eindeutige Bezeichner/Objektreferenz des SR, auf dem Absturzabbilder für Poolmitglieder gespeichert werden Lese-/Schreibzugriff
metadata-vdis Alle bekannten Metadaten-VDIs für den Pool Nur Lesezugriff
suspend-image-SR Der eindeutige Bezeichner/Objektreferenz des SR, auf dem angehaltene VMs von Poolmitgliedern gespeichert werden Lese-/Schreibzugriff
other-config Eine Liste von Schlüssel-Wert-Paaren, die zusätzliche Konfigurationsparameter für den Pool angeben Lese-/Schreib-Map-Parameter
other-config:default_ha_timeout Hochverfügbarkeits-Timeout in Sekunden. Lese-/Schreibzugriff
supported-sr-types SR-Typen, die dieser Pool verwenden kann Nur lesen
ha-enabled Der Wert ist true, wenn HA für den Pool aktiviert ist, andernfalls false Nur lesen
ha-configuration Für zukünftige Verwendung reserviert. Nur lesen
ha-statefiles Listet die UUIDs der VDIs auf, die von HA zur Bestimmung des Speicherzustands verwendet werden Nur lesen
ha-host-failures-to-tolerate Die Anzahl der Host-Ausfälle, die toleriert werden, bevor eine Systemwarnung gesendet wird Lesen/Schreiben
ha-plan-exists-for Die Anzahl der Hostausfälle, die gemäß den Berechnungen des HA-Algorithmus tatsächlich bewältigt werden können Schreibgeschützt
ha-allow-overcommit Der Wert ist wahr, wenn der Pool überprovisioniert werden darf, andernfalls falsch Lese-/Schreibzugriff
ha-overcommitted Der Wert ist wahr, wenn der Pool überprovisioniert ist Schreibgeschützt
ha-reboot-vm-on-internal-shutdown Der Wert ist wahr, wenn geschützte VMs bei sauberem Herunterfahren neu gestartet werden, andernfalls falsch. Lese-/Schreibzugriff
blobs Binärer Datenspeicher Schreibgeschützt
live-patching-disabled Auf false setzen, um Live-Patching zu aktivieren. Auf true setzen, um Live-Patching zu deaktivieren. Lese-/Schreibzugriff
igmp-snooping-enabled Auf true setzen, um IGMP-Snooping zu aktivieren. Auf false setzen, um IGMP-Snooping zu deaktivieren. Lese-/Schreibzugriff
https-only Auf false setzen, um externen Clients, die die Verwaltungs-API verwenden, die Verbindung zu XenServer entweder über HTTPS über Port 443 oder HTTP über Port 80 zu ermöglichen. Auf true setzen, um Port 80 zu blockieren und Clients zu zwingen, sich ausschließlich über HTTPS über Port 443 zu verbinden. Lese-/Schreibzugriff
migration-compression Auf true setzen, um die Migrationsstromkomprimierung für Ihren XenServer-Pool zu aktivieren. Auf false setzen, um die Migrationsstromkomprimierung zu deaktivieren. Der Standardwert ist false. Kann durch den compress-Parameter des vm-migrate-Befehls überschrieben werden. Lese-/Schreibzugriff

pool-apply-edition

xe pool-apply-edition edition=cloud|standard-per-socket|premium-per-socket [uuid=uuid] [license-server-address=address] [license-server-port=port]
Eine Edition auf den gesamten Pool anwenden. Editionswerte umfassen „cloud“, „standard-per-socket“ und „premium-per-socket“. Zukünftig wird nur „cloud“ unterstützt.

pool-certificate-install

xe pool-certificate-install filename=file_name
Ein TLS-Zertifikat poolweit installieren.

pool-certificate-list

xe pool-certificate-list
Alle installierten TLS-Zertifikate in einem Pool auflisten.

pool-certificate-sync

xe pool-certificate-sync
TLS-Zertifikate und Zertifikatsperrlisten vom Pool-Koordinator mit den anderen Pool-Mitgliedern synchronisieren.

pool-certificate-uninstall

xe pool-certificate-uninstall name=name
Ein TLS-Zertifikat deinstallieren.

pool-crl-install

xe pool-crl-install filename=file_name
Eine TLS-Zertifikatsperrliste poolweit installieren.

pool-crl-list

xe pool-crl-list
Alle installierten TLS-Zertifikatsperrlisten auflisten.

pool-crl-uninstall

xe pool-crl-uninstall name=name
Eine TLS-Zertifikatsperrliste deinstallieren.

pool-deconfigure-wlb

xe pool-deconfigure-wlb
Die Konfiguration für den Workload-Ausgleich dauerhaft entfernen.

pool-designate-new-master

xe pool-designate-new-master host-uuid=uuid_of_new_master
Weisen Sie den angegebenen XenServer-Mitgliedshost an, der Koordinator (früher „Master“ genannt) eines bestehenden Pools zu werden. Dieser Befehl führt eine geordnete Übergabe der Rolle des Pool-Koordinators an einen anderen Host im Ressourcenpool durch. Dieser Befehl funktioniert nur, wenn der aktuelle Pool-Koordinator online ist. Er ist kein Ersatz für die unten aufgeführten Notfallmodus-Befehle.

pool-disable-external-auth

xe pool-disable-external-auth [uuid=uuid] [config=config]
Deaktiviert die externe Authentifizierung auf allen Hosts in einem Pool.

pool-disable-local-storage-caching

xe pool-disable-local-storage-caching uuid=uuid
Deaktiviert das lokale Speichercaching im gesamten Pool.

pool-disable-redo-log

xe pool-disable-redo-log
Deaktiviert das Redo-Log, falls es verwendet wird, es sei denn, HA ist aktiviert.

pool-dump-database

xe pool-dump-database file-name=filename_to_dump_database_into_(on_client)
Lädt eine Kopie der gesamten Pool-Datenbank herunter und speichert 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]
Aktiviert die externe Authentifizierung auf allen Hosts in einem Pool. Beachten Sie, dass einige Werte von auth-type bestimmte config:-Werte erfordern.

pool-enable-local-storage-caching

xe pool-enable-local-storage-caching uuid=uuid
Aktiviert das lokale Speichercaching im gesamten Pool.

pool-enable-redo-log

xe pool-ensable-redo-log sr-uuid=sr_uuid
Aktiviert das Redo-Log auf dem angegebenen SR, falls es verwendet wird, es sei denn, HA ist aktiviert.

pool-eject

xe pool-eject host-uuid=uuid_of_host_to_eject
Weisen Sie den angegebenen XenServer-Host an, einen bestehenden Pool zu verlassen.

pool-emergency-reset-master

xe pool-emergency-reset-master master-address=address_of_pool_master
Weisen Sie einen Pool-Mitgliedshost an, seine Pool-Koordinator-Adresse auf den neuen Wert zurückzusetzen und zu versuchen, sich mit ihr zu verbinden. Führen Sie diesen Befehl nicht auf Pool-Koordinatoren aus.

pool-emergency-transition-to-master

xe pool-emergency-transition-to-master
Weisen Sie einen XenServer-Mitgliedshost an, der Pool-Koordinator (früher „Pool-Master“ genannt) zu werden. Der XenServer-Host akzeptiert diesen Befehl nur, nachdem der Host in den Notfallmodus gewechselt ist. Notfallmodus bedeutet, dass er Mitglied eines Pools ist, dessen Koordinator aus dem Netzwerk verschwunden ist und nach mehreren Wiederholungsversuchen nicht kontaktiert werden kann.
Wenn das Host-Passwort geändert wurde, seit der Host dem Pool beigetreten ist, kann dieser Befehl dazu führen, dass das Passwort 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
Aktivieren Sie Hochverfügbarkeit für den Ressourcenpool, indem Sie die angegebene SR-UUID als zentrales Speicher-Heartbeat-Repository verwenden.

pool-ha-disable

xe pool-ha-disable
Deaktiviert die Hochverfügbarkeitsfunktion für den Ressourcenpool.

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

Berechnet die maximale Anzahl von Host-Ausfällen, die unter der aktuellen Pool-Konfiguration toleriert werden können.

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]
Berechnet die maximale Anzahl von Host-Ausfällen, die mit den bereitgestellten, vorgeschlagenen geschützten VMs toleriert werden können.

pool-initialize-wlb

xe pool-initialize-wlb wlb_url=url wlb_username=wlb_username wlb_password=wlb_password xenserver_username=username xenserver_password=password
Initialisieren Sie den Lastausgleich für den aktuellen Pool mit dem Ziel-Workload-Balancing-Server.

pool-join

xe pool-join master-address=address master-username=username master-password=password
Weisen Sie Ihren XenServer-Host an, einem vorhandenen Pool beizutreten.

pool-management-reconfigure

xe pool-management-reconfigure [network-uuid=network-uuid]
Konfiguriert die Verwaltungsschnittstelle aller Hosts im Pool neu, um die angegebene Netzwerkschnittstelle zu verwenden, die für die Verbindung mit XenCenter verwendet wird. Der Befehl überschreibt den MANAGEMENT_INTERFACE-Schlüssel in /etc/xensource-inventory für alle Hosts im Pool.
Wenn der Gerätename einer Schnittstelle (die eine IP-Adresse haben muss) angegeben wird, bindet der XenServer-Pool-Koordinator sofort neu. Dieser Befehl funktioniert sowohl im normalen als auch im Notfallmodus.
Aus der angegebenen Netzwerk-UUID wird die UUID des PIF-Objekts identifiziert und dem XenServer-Host 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 Sie auf der neuen Schnittstelle über Netzwerkkonnektivität verfügen. Verwenden Sie xe pif-reconfigure, um zuerst eine einzurichten. Andernfalls können nachfolgende CLI-Befehle den XenServer-Host nicht erreichen.

pool-recover-slaves

xe pool-recover-slaves
Weisen Sie den Pool-Koordinator an, zu versuchen, die Adresse aller Mitglieder zurückzusetzen, die sich derzeit im Notfallmodus befinden. Dieser Befehl wird typischerweise verwendet, nachdem pool-emergency-transition-to-master verwendet wurde, um eines der Mitglieder als neuen Pool-Koordinator festzulegen.

pool-restore-database

xe pool-restore-database file-name=filename_to_restore_from_on_client [dry-run=true|false]
Laden Sie ein Datenbank-Backup (erstellt mit pool-dump-database) in einen Pool hoch. Nach Erhalt des Uploads startet sich der Pool-Koordinator mit der neuen Datenbank neu.
Es gibt auch eine Trockenlauf-Option, mit der Sie überprüfen können, ob die Pool-Datenbank wiederhergestellt werden kann, ohne den Vorgang tatsächlich auszuführen. Standardmäßig ist dry-run auf false gesetzt.

pool-retrieve-wlb-configuration

xe pool-retrieve-wlb-configuration
Ruft die Pool-Optimierungskriterien vom Workload Balancing-Server ab.

pool-retrieve-wlb-diagnostics

xe pool-retrieve-wlb-diagnostics [filename=file_name]
Ruft Diagnosedaten vom Workload Balancing-Server ab.

pool-retrieve-wlb-recommendations

xe pool-retrieve-wlb-recommendations
Ruft VM-Migrations-Empfehlungen für den Pool vom Workload Balancing-Server ab.

pool-retrieve-wlb-report

xe pool-retrieve-wlb-report report=report [filename=file_name]
Ruft Berichte vom Workload Balancing-Server ab.

pool-secret-rotate

xe pool-secret-rotate
Rotieren Sie das Pool-Geheimnis.
Das Pool-Geheimnis ist ein Geheimnis, das unter den XenServer-Hosts in einem Pool geteilt wird und es dem Host ermöglicht, seine Zugehörigkeit zu einem Pool nachzuweisen. Benutzer mit der Rolle Pool-Administrator können dieses Geheimnis einsehen, wenn sie sich über SSH mit dem Host verbinden. Rotieren Sie das Pool-Geheimnis, wenn einer dieser Benutzer Ihr Unternehmen verlässt oder seine Rolle als Pool-Administrator verliert.

pool-send-test-post

xe pool-send-test-post dest-host=destination_host dest-port=destination_port body=post_body
Senden Sie den angegebenen Text an den angegebenen Host und Port, unter Verwendung von HTTPS, und geben Sie die Antwort aus. Dies wird zum Debuggen der TLS-Schicht verwendet.

pool-send-wlb-configuration

xe pool-send-wlb-configuration [config:=config]
Legt die Pool-Optimierungskriterien für den Workload Balancing-Server fest.

pool-sync-database

xe pool-sync-database
Erzwingt die Synchronisierung der Pooldatenbank auf allen Hosts im Ressourcenpool. Dieser Befehl ist im Normalbetrieb nicht erforderlich, da die Datenbank regelmäßig automatisch repliziert wird. Der Befehl kann jedoch nützlich sein, um sicherzustellen, dass Änderungen nach der Durchführung einer Reihe wichtiger CLI-Operationen schnell repliziert werden.

Festlegen https-only

xe pool-param-set [uuid=pool-uuid] [https-only=true|false]
Aktiviert oder deaktiviert die Blockierung von Port 80 auf der Verwaltungsschnittstelle von XenServer-Hosts.

PVS Accelerator-Befehle

Befehle für die Arbeit mit dem PVS Accelerator.

pvs-cache-storage-create

xe pvs-cache-storage-create sr-uuid=sr_uuid pvs-site-uuid=pvs_site_uuid size=size
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
Entfernen Sie einen PVS-Cache.

pvs-proxy-create

xe pvs-proxy-create pvs-site-uuid=pvs_site_uuid vif-uuid=vif_uuid
Konfigurieren Sie eine VM/VIF zur Verwendung eines PVS-Proxys.

pvs-proxy-destroy

xe pvs-proxy-destroy uuid=uuid
Entfernen (oder deaktivieren) Sie einen PVS-Proxy für diese VIF/VM.

pvs-server-forget

xe pvs-server-forget uuid=uuid
PVS-Server vergessen.

pvs-server-introduce

xe pvs-server-introduce addresses=adresses first-port=first_port last-port=last_port pvs-site-uuid=pvs_site_uuid
Neuen PVS-Server einführen.

pvs-site-forget

xe pvs-site-forget uuid=uuid
PVS-Site vergessen.

pvs-site-introduce

xe pvs-site-introduce name-label=name_label [name-description=name_description] [pvs-uuid=pvs_uuid]
Neue PVS-Site einführen.

Storage Manager-Befehle

Befehle zur Steuerung von Storage Manager-Plug-Ins.
Die Storage Manager-Objekte können mit dem Standardbefehl zur Objektlistung (xe sm-list) aufgelistet werden. Die Parameter können mit den Standard-Parameterbefehlen bearbeitet werden. Weitere Informationen finden Sie unter Low-level parameter commands

SM-Parameter

SMs haben die folgenden Parameter:
Parametername Beschreibung Typ
uuid Der eindeutige Bezeichner/Objektreferenz für das SM-Plug-in Schreibgeschützt
name-label Der Name des SM-Plug-ins Schreibgeschützt
name-description Die Beschreibungszeichenfolge des SM-Plug-ins Schreibgeschützt
type Der SR-Typ, mit dem dieses Plug-in verbunden ist Schreibgeschützt
vendor Name des Anbieters, der dieses Plug-in erstellt hat Schreibgeschützt
copyright Copyright-Erklärung für dieses SM-Plug-in Schreibgeschützt
required-api-version Mindest-SM-API-Version, die auf dem XenServer-Host erforderlich ist Schreibgeschützt
configuration Namen und Beschreibungen der Gerätekonfigurationsschlüssel Schreibgeschützt
capabilities Funktionen des SM-Plug-ins Schreibgeschützt
driver-filename Der Dateiname des SR-Treibers. Schreibgeschützt

SSH-Zugriff auf Hosts und Pools verwalten

Übersicht

In XenServer 8.4 ist der SSH-Zugriff auf dom0 jetzt standardmäßig aktiviert. Diese Version führt die Möglichkeit ein, den SSH-Zugriff entweder über die XenAPI oder die Befehlszeilenschnittstelle (CLI) von xe programmatisch zu steuern.
Diese Verbesserung ermöglicht es Administratoren, den SSH-Zugriff sowohl auf der Ebene einzelner Hosts als auch ganzer Pools zu verwalten, wodurch die Notwendigkeit einer manuellen Interaktion mit jeder Serverkonsole entfällt.

Vorteile

  • Automatisierte Verwaltung: SSH auf einzelnen Hosts oder über einen gesamten Pool hinweg programmatisch aktivieren oder deaktivieren.
  • Reduzierter Verwaltungsaufwand: Den manuellen Verwaltungsaufwand für die Verwaltung des SSH-Zugriffs erheblich reduzieren.
  • Verbesserte Workflows: Automatisierungsskripte verbessern und Sicherheits-Workflows stärken, indem die SSH-Steuerung in bestehende Verwaltungssysteme integriert wird.

Kompatibilität und Hinweise

  • Keine zusätzlichen Anforderungen: Diese Funktion erfordert keine zusätzliche Konfiguration oder spezifische Kompatibilitätsanpassungen.
  • Dienstverhalten: Das Deaktivieren von SSH stoppt und deaktiviert den sshd-Dienst auf dem/den angegebenen Host(s).
  • Bestehende Sitzungen: Alle bestehenden SSH-Sitzungen bleiben aktiv und ununterbrochen, auch nachdem der Dienst deaktiviert wurde.
  • Neue Verbindungen: Neue Verbindungsversuche werden abgelehnt, sobald SSH deaktiviert ist.
  • Poolweite Operationen: Operationen, die über einen gesamten Pool hinweg durchgeführt werden, werden fortgesetzt, auch wenn ein oder mehrere Hosts innerhalb des Pools einen Fehler aufweisen.
Eine Zusammenfassungsnachricht wird bereitgestellt, die alle fehlgeschlagenen Operationen detailliert beschreibt.

CLI-Konfiguration

SSH auf einem Host aktivieren

xe host-enable-ssh host=<host_uuid_or_name_label>
Dieser Befehl startet und aktiviert den sshd Dienst auf dem angegebenen Host. Gültige host Selektoren finden Sie unter Host-Selektoren .

SSH auf einem Host deaktivieren

xe host-disable-ssh host=<host_uuid_or_name_label>
Dieser Befehl stoppt und deaktiviert den sshd-Dienst auf dem angegebenen Host.

SSH auf allen Hosts in einem Pool aktivieren

xe pool-enable-ssh
Dieser Befehl startet und aktiviert den sshd-Dienst auf allen Hosts im aktuellen Pool.

SSH auf allen Hosts in einem Pool deaktivieren

xe pool-disable-ssh
Dieser Befehl stoppt und deaktiviert den sshd-Dienst auf allen Hosts im aktuellen Pool.

Beispielausgabe (Operation auf Poolebene)

xe pool-enable-ssh

Some of hosts failed to enable SSH access.
hosts: d734ff47-f429-4bd4-93f7-245cffbdc79e (genus-35-003d)
Wenn ein Host ausfällt, verarbeitet der Befehl die verbleibenden Hosts weiter und meldet Fehler am Ende.

Snapshot-Befehle

Befehle für die Arbeit mit Snapshots.

snapshot-clone

xe snapshot-clone new-name-label=name_label [uuid=uuid] [new-name-description=description]
Erstellen Sie eine neue Vorlage durch Klonen eines vorhandenen Snapshots, wobei, falls verfügbar, eine schnelle Festplattenklonoperation auf Speicherebene verwendet wird.

snapshot-copy

xe snapshot-copy new-name-label=name_label [uuid=uuid] [new-name-description=name_description] [sr-uuid=sr_uuid]
Erstellen Sie eine neue Vorlage, indem Sie eine vorhandene VM kopieren, jedoch ohne die schnelle Datenträgerklon-Operation auf Speicherebene zu verwenden (selbst wenn diese verfügbar ist). Die Datenträger-Images der kopierten VM sind garantiert 'vollständige Images' – d.h. sie sind nicht Teil einer CoW-Kette.

snapshot-destroy

xe snapshot-destroy  [uuid=uuid] [snapshot-uuid=snapshot_uuid]
Zerstören Sie einen Snapshot. Dadurch bleibt der mit dem Snapshot verbundene Speicher intakt. Um auch den Speicher zu löschen, verwenden Sie snapshot-uninstall.

snapshot-disk-list

xe snapshot-disk-list [uuid=uuid] [snapshot-uuid=snapshot_uuid] [vbd-params=vbd_params] [vdi-params=vdi_params]
Listen Sie die Datenträger auf der/den 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]
Exportieren Sie einen Snapshot in die Datei Dateiname.

snapshot-reset-powerstate

xe snapshot-reset-powerstate [uuid=uuid] [snapshot-uuid=snapshot_uuid] [--force]
Erzwingen Sie den VM-Stromzustand auf 'angehalten' nur in der Management-Toolstack-Datenbank. 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 Speicher-Image nicht mehr benötigen. Sie werden Ihren Snapshot danach nicht mehr fortsetzen können.

snapshot-revert

xe snapshot-revert [uuid=uuid] [snapshot-uuid=snapshot_uuid]
Setzen Sie eine vorhandene VM auf einen vorherigen Checkpoint- oder Snapshot-Zustand zurück.

snapshot-uninstall

xe snapshot-uninstall [uuid=uuid] [snapshot-uuid=snapshot_uuid] [--force]
Deinstallieren Sie einen Snapshot. Dieser Vorgang zerstört nur die VDIs, die als RW markiert und mit diesem Snapshot verbunden sind. Um den VM-Eintrag einfach zu zerstören, verwenden Sie snapshot-destroy.

SR-Befehle

Befehle zum Steuern von SRs (Speicher-Repositorys).
Die SR-Objekte können mit dem Standardbefehl zur Objektlistung (xe sr-list) aufgelistet und die Parameter mit den Standard-Parameterbefehlen manipuliert werden. Weitere Informationen finden Sie unter Befehle für Parameter auf niedriger Ebene

SR-Parameter

SRs haben die folgenden Parameter:
Parametername Beschreibung Typ
uuid Der eindeutige Bezeichner/Objektreferenz für das SR Schreibgeschützt
name-label Der Name des SR Lese-/Schreibzugriff
name-description Die Beschreibungszeichenfolge des SR Lese-/Schreibzugriff
host Der Hostname des Speicher-Repositorys Schreibgeschützt
allowed-operations Liste der auf dem SR in diesem Zustand zulässigen Operationen Schreibgeschützter Satzparameter
current-operations Liste der Operationen, die derzeit auf diesem SR ausgeführt werden Schreibgeschützter Satzparameter
VDIs Eindeutiger Bezeichner/Objektreferenz für die virtuellen Datenträger in diesem SR Schreibgeschützter Satzparameter
PBDs Eindeutiger Bezeichner/Objektreferenz für die an dieses SR angeschlossenen PBDs Nur Lese-Parameter
virtual-allocation Summe der virtual-size-Werte aller VDIs in diesem Speicher-Repository (in Bytes) Nur lesbar
physical-utilisation Derzeit auf diesem SR genutzter physischer Speicherplatz in Bytes. Bei Thin-Provisioning-Festplattenformaten kann die physische Auslastung geringer sein als die virtuelle Zuweisung. Nur lesbar
physical-size Gesamte physische Größe des SR in Bytes Nur lesbar
type Typ des SR, wird verwendet, um den zu verwendenden SR-Backend-Treiber anzugeben Nur lesbar
content-type Der Typ des SR-Inhalts. Wird verwendet, um ISO-Bibliotheken von anderen SRs zu unterscheiden. Für Speicher-Repositories, 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 die Zeichenfolge user zu setzen. Schreibgeschützt
shared Der Wert ist true, wenn dieser SR von mehreren Hosts gemeinsam genutzt werden kann, andernfalls false. Lese-/Schreibzugriff
introduced-by Der drtask (falls vorhanden), der den SR eingeführt hat Schreibgeschützt
is-tools-sr Der Wert ist true, wenn dies der SR ist, der die Tools ISO VDIs enthält, andernfalls false. Schreibgeschützt
other-config Liste von Schlüssel-Wert-Paaren, die zusätzliche Konfigurationsparameter für den SR angeben Lese-/Schreib-Map-Parameter
sm-config SM-abhängige Daten Nur-Lese-Kartenparameter
blobs Binärer Datenspeicher Nur lesen
local-cache-enabled Der Wert ist „true“, wenn dieser SR als lokaler Cache für seinen Host zugewiesen ist, andernfalls „false“. Nur lesen
tags Benutzerdefinierte Tags für Kategorisierungszwecke Lese-/Schreib-Set-Parameter
clustered Der Wert ist „true“, wenn der SR aggregierten lokalen Speicher verwendet, andernfalls „false“. Nur lesen

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]
Erstellt einen SR auf der Festplatte, führt ihn in die Datenbank ein und erstellt eine PBD, die den SR mit dem XenServer-Host verbindet. Wenn shared auf true gesetzt ist, wird für jeden XenServer-Host im Pool eine PBD erstellt. Wenn shared nicht angegeben oder auf false gesetzt ist, wird eine PBD nur für den mit host-uuid angegebenen XenServer-Host erstellt.
Die genauen device-config-Parameter unterscheiden sich je nach Gerät type. Details zu diesen Parametern für die verschiedenen Speicher-Back-Ends finden Sie unter SR erstellen.

sr-data-source-forget

xe sr-data-source-forget data-source=data_source
Beendet die Aufzeichnung der angegebenen Datenquelle für einen SR und löscht alle aufgezeichneten Daten.

sr-data-source-list

xe sr-data-source-list
Listet die Datenquellen auf, die für einen SR aufgezeichnet werden können.

sr-data-source-query

xe sr-data-source-query data-source=data_source
Fragt den letzten Wert ab, der von einer SR-Datenquelle gelesen wurde.

sr-data-source-record

xe sr-data-source-record  data-source=data_source
Zeichnet die angegebene Datenquelle für einen SR auf.

sr-destroy

xe sr-destroy uuid=sr_uuid
Zerstört den angegebenen SR auf dem XenServer-Host.

sr-enable-database-replication

xe sr-enable-database-replication uuid=sr_uuid
Aktiviert die XAPI-Datenbankreplikation auf den angegebenen (freigegebenen) SR.

sr-disable-database-replication

xe sr-disable-database-replication uuid=sr_uuid
Deaktiviert die XAPI-Datenbankreplikation auf den angegebenen SR.

sr-forget

xe sr-forget uuid=sr_uuid
Der XAPI-Agent vergisst einen angegebenen SR auf dem XenServer-Host. Wenn der XAPI-Agent einen SR vergisst, wird der SR getrennt und Sie können nicht auf VDIs darauf zugreifen, aber er 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
Fügt lediglich einen SR-Eintrag in die Datenbank ein. Verwenden Sie device-config, um zusätzliche Parameter in der Form device-config:parameter_key=parameter_value anzugeben, zum Beispiel:
xe sr-introduce device-config:device=/dev/sdb1
Hinweis:
Dieser Befehl wird im Normalbetrieb nie verwendet. Dieser erweiterte Vorgang kann nützlich sein, wenn ein SR nach seiner Erstellung als gemeinsam genutzt neu konfiguriert werden muss oder um die Wiederherstellung nach verschiedenen Fehlerszenarien zu unterstützen.

sr-probe

xe sr-probe type=type [host-uuid=host_uuid] [device-config:config_name=value]
Führt einen Scan des Backends durch, wobei die bereitgestellten device-config Schlüssel verwendet werden. Wenn die device-config für das SR-Backend vollständig ist, gibt dieser Befehl eine Liste der auf dem Gerät vorhandenen SRs zurück, falls vorhanden. Wenn die device-config Parameter nur teilweise vorhanden sind, wird ein Backend-spezifischer Scan durchgeführt, der Ergebnisse liefert, die Sie bei der Verbesserung der verbleibenden device-config Parameter anleiten. Die Scan-Ergebnisse werden als Backend-spezifisches XML zurückgegeben und auf der CLI ausgegeben.
Die genauen device-config Parameter unterscheiden sich je nach Gerät type. Details zu diesen Parametern für die 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]
Führt eine Speicherprüfung durch. Die device-config-Parameter können beispielsweise durch device-config:devs=/dev/sdb1 angegeben werden. Im Gegensatz zu sr-probe gibt dieser Befehl Ergebnisse im selben menschenlesbaren Format für jeden SR-Typ zurück.

sr-scan

xe sr-scan uuid=sr_uuid
Erzwingt einen SR-Scan, der die XAPI-Datenbank mit den im zugrunde liegenden Speichersubstrat vorhandenen VDIs synchronisiert.

sr-update

xe sr-update uuid=uuid
Aktualisiert 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
Aktivieren Sie Thin Provisioning auf einem LVHD SR.

Subjektbefehle

Befehle zum Arbeiten mit Subjekten.

session-subject-identifier-list

xe session-subject-identifier-list
Gibt eine Liste aller Benutzer-Subjekt-IDs aller extern authentifizierten bestehenden Sitzungen zurück.

session-subject-identifier-logout

xe session-subject-identifier-logout subject-identifier=subject_identifier
Meldet alle extern authentifizierten Sitzungen ab, die einer Benutzer-Subjekt-ID zugeordnet sind.

session-subject-identifier-logout-all

xe session-subject-identifier-logout-all
Meldet alle extern authentifizierten Sitzungen ab.

subject-add

xe subject-add subject-name=subject_name
Fügt ein Subjekt zur Liste der Subjekte hinzu, die auf den Pool zugreifen können.

subject-remove

xe subject-remove subject-uuid=subject_uuid
Entfernt ein Subjekt aus der Liste der Subjekte, die auf den Pool zugreifen können.

subject-role-add

xe subject-role-add uuid=uuid [role-name=role_name] [role-uuid=role_uuid]
Eine Rolle zu einem Subjekt hinzufügen.

subject-role-remove

xe subject-role-remove uuid=uuid [role-name=role_name] [role-uuid=role_uuid]
Eine Rolle von einem Subjekt entfernen.

secret-create

xe secret-create value=value
Ein Geheimnis erstellen.

secret-destroy

xe secret-destroy uuid=uuid
Ein Geheimnis zerstören.

Aufgabenbefehle

Befehle für die Arbeit mit langlaufenden asynchronen Aufgaben. Diese Befehle sind Aufgaben wie das Starten, Stoppen und Anhalten einer virtuellen Maschine. Die Aufgaben bestehen typischerweise aus einer Reihe anderer atomarer Unteraufgaben, die zusammen die angeforderte Operation ausführen.
Die Aufgabenobjekte können mit dem Standardbefehl zur Objektlistung (xe task-list) aufgelistet und die Parameter mit den Standardparameterbefehlen manipuliert werden. Weitere Informationen finden Sie unter Low-level parameter commands

Aufgabenparameter

Aufgaben haben die folgenden Parameter:
Parametername Beschreibung Typ
uuid Der eindeutige Bezeichner/Objektreferenz für die Aufgabe Schreibgeschützt
name-label Der Name der Aufgabe Schreibgeschützt
name-description Die Beschreibung der Aufgabe Schreibgeschützt
resident-on Der eindeutige Bezeichner/Objektreferenz des Hosts, auf dem die Aufgabe ausgeführt wird Schreibgeschützt
status Status der Aufgabe Schreibgeschützt
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 nicht erfolgreich abgeschlossen wurde, ist der Wert 1. Schreibgeschützt
type Wenn die Aufgabe erfolgreich abgeschlossen wurde, enthält dieser Parameter den Typ des kodierten Ergebnisses. Der Typ ist der Name der Klasse, deren Referenz sich im Ergebnisfeld befindet. Andernfalls ist der Wert dieses Parameters undefiniert. Schreibgeschützt
result Wenn die Aufgabe erfolgreich abgeschlossen wurde, enthält dieses Feld den Ergebniswert, entweder Void oder eine Objektreferenz; andernfalls ist der Wert dieses Parameters undefiniert. Schreibgeschützt
error_info Wenn die Aufgabe fehlgeschlagen ist, enthält dieser Parameter die Menge der zugehörigen Fehlerzeichenfolgen. Andernfalls ist der Wert dieses Parameters undefiniert. Schreibgeschützt
allowed_operations Liste der Operationen, die in diesem Zustand zulässig sind. Schreibgeschützt
created Zeitpunkt der Aufgabenerstellung Schreibgeschützt
finished Zeitpunkt, zu dem die Aufgabe beendet wurde (d.h. erfolgreich oder fehlgeschlagen). Wenn der Aufgabenstatus ausstehend ist, hat der Wert dieses Feldes keine Bedeutung. Schreibgeschützt
subtask_of Enthält die UUID der Aufgaben, deren Unteraufgabe diese Aufgabe ist Schreibgeschützt
subtasks Enthält die UUIDs aller Unteraufgaben dieser Aufgabe Schreibgeschützt

task-cancel

xe task-cancel [uuid=task_uuid]
Weist die angegebene Aufgabe an, abzubrechen und zurückzukehren.

Vorlagenbefehle

Befehle für die Arbeit mit VM-Vorlagen.
Vorlagen sind im Wesentlichen VMs, bei denen der Parameter is-a-template auf true gesetzt ist. Eine Vorlage ist ein „Gold-Image“, das alle verschiedenen Konfigurationseinstellungen enthält, um eine bestimmte VM zu instanziieren. XenServer wird mit einem Basissatz von Vorlagen ausgeliefert, die generische „rohe“ VMs sind, die eine OS-Hersteller-Installations-CD (zum Beispiel: RHEL, CentOS, SLES, Windows) booten können. Sie können VMs erstellen, sie in Standardformen für Ihre speziellen Anforderungen konfigurieren und eine Kopie davon als Vorlagen für die zukünftige Verwendung bei der VM-Bereitstellung speichern.
Die Vorlagenobjekte können mit dem Standardbefehl zur Objektlistung (xe template-list) aufgelistet und die Parameter mit den Standardparameterbefehlen bearbeitet werden. Weitere Informationen finden Sie unter Befehle für Parameter auf niedriger Ebene
Hinweis:
Vorlagen können nicht direkt in VMs umgewandelt werden, indem der Parameter is-a-template auf false gesetzt wird. Das Setzen des Parameters is-a-template auf false wird nicht unterstützt und führt zu einer VM, die nicht gestartet werden kann.

VM-Vorlagenparameter

Vorlagen haben die folgenden Parameter:
  • uuid (schreibgeschützt) der eindeutige Bezeichner/Objektreferenz für die Vorlage
  • name-label (Lese-/Schreibzugriff) der Name der Vorlage
  • name-description (Lese-/Schreibzugriff) die Beschreibungszeichenfolge der Vorlage
  • user-version (Lese-/Schreibzugriff) Zeichenfolge für Ersteller von VMs und Vorlagen zur Angabe von Versionsinformationen
  • is-a-template (Lese-/Schreibzugriff) 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 mehr auf false zurückgesetzt werden. Vorlagen-VMs können mit diesem Parameter nicht in VMs umgewandelt werden.
    Sie können eine VM mit folgendem Befehl in eine Vorlage konvertieren:
    xe vm-param-set uuid=<vm uuid> is-a-template=true
  • is-control-domain (schreibgeschützt) true, wenn dies eine Steuerdomäne ist (Domäne 0 oder eine Treiberdomäne)
  • power-state (schreibgeschützt) aktueller Energiezustand. Der Wert ist für eine Vorlage immer angehalten
  • memory-dynamic-max (schreibgeschützt) dynamischer maximaler Speicher in Bytes. Derzeit ungenutzt, aber bei Änderung muss die folgende Einschränkung beachtet werden: memory_static_max >= memory_dynamic_max >= memory_dynamic_min >= memory_static_min.
  • memory-dynamic-min (Lese-/Schreibzugriff) dynamischer Mindestspeicher in Bytes. Derzeit ungenutzt, aber bei Änderung müssen die gleichen Einschränkungen für memory-dynamic-max beachtet werden.
  • memory-static-max (Lese-/Schreibzugriff) statisch festgelegter (absoluter) maximaler Speicher in Bytes. Dieses Feld ist der Hauptwert, der zur Bestimmung der einer VM zugewiesenen Speichermenge verwendet wird.
  • memory-static-min (Lese-/Schreibzugriff) statisch festgelegter (absoluter) Mindestspeicher in Bytes. Dieses Feld stellt den absoluten Mindestspeicher dar, und memory-static-min muss kleiner sein als memory-static-max. Dieser Wert wird im Normalbetrieb nicht verwendet, aber die vorherige Einschränkung muss beachtet werden.
  • suspend-VDI-uuid (schreibgeschützt) die VDI, auf der ein Suspend-Image gespeichert ist (hat keine Bedeutung für eine Vorlage)
  • VCPUs-params (Lese-/Schreib-Map-Parameter) Konfigurationsparameter für die ausgewählte vCPU-Richtlinie.
  • VCPUs-max (Lese-/Schreibzugriff) maximale Anzahl von vCPUs
  • VCPUs-at-startup (Lese-/Schreibzugriff) Startanzahl von vCPUs
  • actions-after-crash (Lese-/Schreibzugriff) Aktion, die ausgeführt werden soll, wenn eine auf dieser Vorlage basierende VM abstürzt
  • console-uuids (schreibgeschützter Set-Parameter) virtuelle Konsolengeräte
  • platform (Lese-/Schreib-Map-Parameter) plattformspezifische Konfiguration
    So deaktivieren Sie die Emulation eines parallelen Ports für Gäste:
    xe vm-param-set uuid=<vm_uuid> platform:parallel=none
    So deaktivieren Sie die Emulation eines seriellen Ports:
    xe vm-param-set uuid=<vm_uuid> platform:hvm_serial=none
    So deaktivieren Sie die Emulation eines USB-Controllers und eines USB-Tablet-Geräts:
    xe vm-param-set uuid=<vm_uuid> platform:usb=false
    xe vm-param-set uuid=<vm_uuid> platform:usb_tablet=false
  • allowed-operations (schreibgeschützter Set-Parameter) Liste der in diesem Zustand zulässigen Operationen
  • current-operations (Nur-Lese-Set-Parameter) Liste der Operationen, die derzeit für diese Vorlage ausgeführt werden
  • allowed-VBD-devices (Nur-Lese-Set-Parameter) Liste der verfügbaren VBD-Bezeichner, dargestellt durch Ganzzahlen im Bereich 0–254. Diese Liste dient nur zu Informationszwecken, und andere Geräte können verwendet werden (funktionieren aber möglicherweise nicht).
  • allowed-VIF-devices (Nur-Lese-Set-Parameter) Liste der verfügbaren VIF-Bezeichner, dargestellt durch Ganzzahlen im Bereich 0–6. Diese Liste dient nur zu Informationszwecken, und andere Geräte können verwendet werden (funktionieren aber möglicherweise nicht).
  • HVM-boot-policy (Lese-/Schreibzugriff) die Startrichtlinie für Gäste. Entweder BIOS-Reihenfolge oder eine leere Zeichenfolge.
  • HVM-boot-params (Lese-/Schreib-Map-Parameter) Der Reihenfolgeschlüssel steuert die Startreihenfolge des Gastes, dargestellt als Zeichenfolge, wobei jedes Zeichen eine Startmethode ist: d für die CD/DVD, c für die Root-Festplatte und n für den Netzwerk-PXE-Start. Der Standardwert ist dc.
  • PV-kernel (Lese-/Schreibzugriff) Pfad zum Kernel
  • PV-ramdisk (Lese-/Schreibzugriff) Pfad zu initrd
  • PV-args (Lese-/Schreibzugriff) Zeichenfolge von Kernel-Befehlszeilenargumenten
  • PV-legacy-args (Lese-/Schreibzugriff) Zeichenfolge von Argumenten, um Legacy-VMs, die auf dieser Vorlage basieren, zu starten
  • PV-bootloader (Lese-/Schreibzugriff) Name oder Pfad des Bootloaders
  • PV-bootloader-args (Lese-/Schreibzugriff) Zeichenfolge von verschiedenen Argumenten für den Bootloader
  • last-boot-CPU-flags (Nur-Lese-Zugriff) beschreibt die CPU-Flags, mit denen eine auf dieser Vorlage basierende VM zuletzt gestartet wurde; nicht für eine Vorlage ausgefüllt
  • resident-on (Nur-Lese-Zugriff) der XenServer-Host, auf dem eine auf dieser Vorlage basierende VM resident ist. Wird für eine Vorlage als not in database angezeigt
  • affinity (Lese-/Schreibzugriff) der XenServer-Host, auf dem eine auf dieser Vorlage basierende VM bevorzugt ausgeführt wird. Wird vom Befehl xe vm-start verwendet, um zu entscheiden, wo die VM ausgeführt werden soll. Auch bekannt als Home-Server.
  • groups (Lese-/Schreibzugriff) die VM-Gruppe, zu der diese VM gehört. Eine VM-Gruppe definiert, wo XenServer versucht, die VM zu starten oder zu evakuieren.
  • other-config (Lese-/Schreib-Map-Parameter) Liste von Schlüssel-Wert-Paaren, die zusätzliche Konfigurationsparameter für die Vorlage angeben
  • start-time (nur lesbar) Zeitstempel des Datums und der Uhrzeit, zu dem die Metriken für eine auf dieser Vorlage basierende VM gelesen wurden, in der Form yyyymmddThh:mm:ss z, wobei z der einbuchstabige militärische Zeitzonenindikator ist, zum Beispiel Z für UTC(GMT). Für eine Vorlage auf 1 Jan 1970 Z (Beginn der Unix/POSIX-Epoche) gesetzt
  • install-time (nur lesbar) Zeitstempel des Datums und der Uhrzeit, zu dem die Metriken für eine auf dieser Vorlage basierende VM gelesen wurden, in der Form yyyymmddThh:mm:ss z, wobei z der einbuchstabige militärische Zeitzonenindikator ist, zum Beispiel Z für UTC (GMT). Für eine Vorlage auf 1 Jan 1970 Z (Beginn der Unix/POSIX-Epoche) gesetzt
  • memory-actual (nur lesbar) der tatsächlich von einer auf dieser Vorlage basierenden VM verwendete Speicher; 0 für eine Vorlage
  • VCPUs-number (nur lesbar) die Anzahl der virtuellen CPUs, die einer auf dieser Vorlage basierenden VM zugewiesen sind; 0 für eine Vorlage
  • VCPUs-Utilization (Nur-Lese-Map-Parameter) Liste der virtuellen CPUs und deren Gewicht. (Nur-Lese-Map-Parameter) os-version die Version des Betriebssystems für eine auf dieser Vorlage basierende VM. Erscheint als not in database für eine Vorlage
  • PV-drivers-version (Nur-Lese-Map-Parameter) die Versionen der paravirtualisierten Treiber für eine auf dieser Vorlage basierende VM. Erscheint als not in database für eine Vorlage
  • PV-drivers-detected (nur lesbar) Flag 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 (Nur-Lese-Map-Parameter) Speichermetriken, die vom Agenten auf einer auf dieser Vorlage basierenden VM gemeldet werden. Erscheint als not in database für eine Vorlage
  • disks (Nur-Lese-Map-Parameter) Festplattenmetriken, die vom Agenten auf einer auf dieser Vorlage basierenden VM gemeldet werden. Erscheint als not in database für eine Vorlage
  • networks (Nur-Lese-Map-Parameter) Netzwerkmetriken, die vom Agenten auf einer auf dieser Vorlage basierenden VM gemeldet werden. Erscheint als not in database für eine Vorlage
  • other (Nur-Lese-Map-Parameter) andere Metriken, die vom Agenten auf einer auf dieser Vorlage basierenden VM gemeldet werden. Erscheint als not in database für eine Vorlage
  • guest-metrics-last-updated (nur lesbar) Zeitstempel, wann der In-Guest-Agent den letzten Schreibvorgang in diese Felder durchgeführt hat. In der Form yyyymmddThh:mm:ss z, wobei z der einbuchstabige militärische Zeitzonenindikator ist, zum Beispiel Z für UTC (GMT)
  • actions-after-shutdown (Lese-/Schreibzugriff) Aktion, die nach dem Herunterfahren der VM ausgeführt werden soll
  • actions-after-reboot (Lese-/Schreibzugriff) 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-/Schreibzugriff) Multiplikator, der auf die Menge des Schattens angewendet wird, die dem Gast zur Verfügung gestellt wird
  • dom-id (schreibgeschützt) Domänen-ID (falls verfügbar, sonst -1)
  • recommendations (schreibgeschützt) XML-Spezifikation der empfohlenen Werte und Bereiche für Eigenschaften dieser VM
  • xenstore-data (Lese-/Schreib-Map-Parameter) Daten, die nach der Erstellung der VM in den xenstore Baum (/local/domain/*domid*/vmdata) eingefügt werden sollen.
  • is-a-snapshot (schreibgeschützt) Der Wert ist wahr, 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 erstellten VM-Snapshots
  • memory-target (schreibgeschützt) die für diese Vorlage festgelegte Zielspeichermenge
  • blocked-operations (Lese-/Schreib-Map-Parameter) listet die Operationen auf, die für diese Vorlage nicht ausgeführt werden können
  • last-boot-record (schreibgeschützt) Aufzeichnung der letzten Boot-Parameter für diese Vorlage, im XML-Format
  • ha-always-run (Lese-/Schreibzugriff) Der Wert ist wahr, wenn eine Instanz dieser Vorlage immer auf einem anderen Host neu gestartet wird, falls der Host, auf dem sie sich befindet, ausfällt. Dieser Parameter ist jetzt veraltet. Verwenden Sie stattdessen den ha-restartpriority Parameter.
  • ha-restart-priority (schreibgeschützt) Neustart oder Best-Effort-Lese-/Schreib-Blobs-Binärdatenspeicher
  • 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
Exportiert eine Kopie einer angegebenen Vorlage in eine Datei mit dem angegebenen neuen Dateinamen.

template-uninstall

xe template-uninstall template-uuid=template_uuid [--force]
Deinstalliert eine benutzerdefinierte Vorlage. Dieser Vorgang zerstört die VDIs, die als 'im Besitz' dieser Vorlage gekennzeichnet sind.

Update-Befehle

Der folgende Abschnitt enthält XenServer Host-Update-Befehle.
Die Update-Objekte können mit dem Standardbefehl zur Objektlistung (xe update-list) aufgelistet und die Parameter mit den Standardparameterbefehlen bearbeitet werden. Weitere Informationen finden Sie unter Low-level parameter commands

Update-Parameter

XenServer Host-Updates haben die folgenden Parameter:
Parametername Beschreibung Typ
uuid Der eindeutige Bezeichner/die Objekt-Referenz für das Update Schreibgeschützt
host Die Liste der Hosts, auf die dieses Update angewendet wird Schreibgeschützt
host-uuid Der eindeutige Bezeichner für den abzufragenden XenServer-Host Schreibgeschützt
name-label Der Name des Updates Schreibgeschützt
name-description Die Beschreibungszeichenfolge des Updates Schreibgeschützt
applied Ob das Update angewendet wurde oder nicht; wahr oder falsch Schreibgeschützt
installation-size Die Größe des Updates in Bytes Schreibgeschützt
after-apply-guidance Ob der XAPI-Toolstack oder der Host einen Neustart erfordert Schreibgeschützt
version Die Version des Updates Schreibgeschützt

update-upload

xe update-upload file-name=update_filename
Laden Sie eine angegebene Update-Datei auf den XenServer-Host hoch. Dieser Befehl bereitet ein Update zur Anwendung vor. Bei Erfolg wird die UUID des hochgeladenen Updates ausgegeben. Wenn das Update zuvor bereits hochgeladen wurde, wird stattdessen ein UPDATE_ALREADY_EXISTS Fehler zurückgegeben und der Patch wird nicht erneut hochgeladen.

update-precheck

xe update-precheck uuid=update_uuid host-uuid=host_uuid
Führen Sie die in dem angegebenen Update enthaltenen Vorabprüfungen auf dem angegebenen XenServer-Host aus.

update-destroy

xe update-destroy uuid=update_file_uuid
Löscht eine Update-Datei, die nicht aus dem Pool angewendet wurde. Kann verwendet werden, um eine Update-Datei zu löschen, die nicht auf die Hosts angewendet werden kann.

update-apply

xe update-apply host-uuid=host_uuid uuid=update_file_uuid
Wendet die angegebene Updatedatei an.

update-pool-apply

xe update-pool-apply uuid=update_uuid
Wendet das angegebene Update auf alle XenServer-Hosts im Pool an.

update-introduce

xe update-introduce vdi-uuid=vdi_uuid
Update-VDI einführen.

update-pool-clean

xe update-pool-clean uuid=uuid
Entfernt die Updatedateien von allen Hosts im Pool.

Benutzerbefehle

user-password-change

xe user-password-change old=old_password new=new_password
Ändert das Passwort des angemeldeten Benutzers. Das Feld für das alte Passwort wird nicht überprüft, da Sie zur Verwendung dieses Befehls Supervisor-Berechtigungen benötigen.

VBD-Befehle

Befehle für die Arbeit mit VBDs (Virtual Block Devices).
Ein VBD ist ein Softwareobjekt, das eine VM mit dem VDI verbindet, das den Inhalt der virtuellen Festplatte darstellt. Das VBD verfügt über die Attribute, die das VDI an die VM binden (ist es bootfähig, seine Lese-/Schreibmetriken usw.). Das VDI enthält die Informationen zu den physikalischen Attributen der virtuellen Festplatte (welcher SR-Typ, ob die Festplatte gemeinsam genutzt werden kann, ob das Medium Lese-/Schreibzugriff oder nur Lesezugriff hat usw.).
Die VBD-Objekte können mit dem Standardbefehl zur Objektlistung (xe vbd-list) aufgelistet und die Parameter mit den Standardparameterbefehlen manipuliert werden. Weitere Informationen finden Sie unter Low-level parameter commands

VBD-Parameter

VBDs haben die folgenden Parameter:
Parametername Beschreibung Typ
uuid Der eindeutige Bezeichner/Objektreferenz für die VBD Schreibgeschützt
vm-uuid Der eindeutige Bezeichner/Objektreferenz für die VM, an die diese VBD angehängt ist Schreibgeschützt
vm-name-label Der Name der VM, an die diese VBD angehängt ist Schreibgeschützt
vdi-uuid Der eindeutige Bezeichner/Objektreferenz für die VDI, der diese VBD zugeordnet ist Schreibgeschützt
vdi-name-label Der Name der VDI, der diese VBD zugeordnet ist Schreibgeschützt
empty Wenn true, stellt diese VBD ein leeres Laufwerk dar Schreibgeschützt
device Das vom Gast gesehene Gerät, zum Beispiel hda Schreibgeschützt
userdevice Gerätenummer, die durch den Geräteparameter während vbd-create angegeben wird, zum Beispiel 0 für hda, 1 für hdb und so weiter Lese-/Schreibzugriff
bootable Der Wert ist true, wenn diese VBD bootfähig ist Lesen/Schreiben
mode Der Modus, in dem die VBD gemountet ist Lesen/Schreiben
type Wie die VBD der VM erscheint, zum Beispiel als Festplatte oder CD Lesen/Schreiben
currently-attached Der Wert ist true, wenn die VBD auf diesem Host angehängt ist, andernfalls false Nur lesen
storage-lock Der Wert ist true, wenn eine Sperre auf Speicherebene erworben wurde Nur lesen
status-code Fehler-/Erfolgscode, der dem letzten Anfügevorgang zugeordnet ist Nur lesen
status-detail Fehler-/Erfolgsinformationen, die dem Status des letzten Anfügevorgangs zugeordnet sind Nur lesen
qos_algorithm_type Der zu verwendende Priorisierungsalgorithmus Lesen/Schreiben
qos_algorithm_params Parameter für den ausgewählten Priorisierungsalgorithmus Lese-/Schreib-Map-Parameter
qos_supported_algorithms Unterstützte Priorisierungsalgorithmen für dieses VBD Nur-Lese-Set-Parameter
io_read_kbs Durchschnittliche Leserate in kB pro Sekunde für dieses VBD Schreibgeschützt
io_write_kbs Durchschnittliche Schreibrate in kB pro Sekunde für dieses VBD Schreibgeschützt
allowed-operations Liste der in diesem Zustand zulässigen Operationen. Diese Liste dient nur zur Information, und der Serverstatus kann sich geändert haben, bis dieses Feld von einem Client gelesen wird. Schreibgeschützter Satzparameter
current-operations Verknüpft jede der laufenden Aufgaben, die dieses Objekt verwenden (als Referenz), mit einem current_operation-Enum, das die Art der Aufgabe beschreibt. Schreibgeschützter Satzparameter
unpluggable Der Wert ist wahr, wenn dieses VBD Hot-Unplug unterstützt Lese-/Schreibzugriff
attachable Der Wert ist „true“, wenn das Gerät angeschlossen werden kann. Nur lesen
other-config Zusätzliche Konfiguration Lese-/Schreib-Kartenparameter

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]
Erstellen Sie eine VBD auf einer VM.
Die zulässigen Werte für das Feld device sind ganze Zahlen von 0 bis 254, und die Zahl muss für jede VM eindeutig sein. Die aktuell zulässigen Werte können im Parameter allowed-VBD-devices der angegebenen VM eingesehen werden. Dies wird als userdevice in den Parametern vbd angezeigt.
Wenn type Disk ist, ist vdi-uuid erforderlich. Der Modus kann RO oder RW für eine Festplatte sein.
Wenn type CD ist, ist vdi-uuid optional. Wenn keine 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
Zerstören Sie die angegebene VBD.
Wenn der Parameter other-config:owner der VBD auf true gesetzt ist, wird die zugehörige VDI ebenfalls zerstört.

vbd-eject

xe vbd-eject uuid=uuid_of_vbd
Entfernen Sie die Medien aus dem Laufwerk, das durch eine VBD dargestellt wird. Dieser Befehl funktioniert nur, wenn die Medien von einem entfernbaren Typ sind (eine physische CD oder eine 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
Legen Sie neue Medien in das Laufwerk ein, das durch eine VBD dargestellt wird. Dieser Befehl funktioniert nur, wenn die Medien von einem entfernbaren Typ sind (eine physische CD oder eine ISO). Andernfalls wird eine Fehlermeldung VBD_NOT_REMOVABLE_MEDIA zurückgegeben.

vbd-plug

xe vbd-plug uuid=uuid_of_vbd
Versuchen Sie, die VBD anzuhängen, während die VM im laufenden Zustand ist.

vbd-unplug

xe vbd-unplug uuid=uuid_of_vbd
Versucht, die VBD von der VM zu trennen, während diese sich im laufenden Zustand befindet.

VDI-Befehle

Befehle für die Arbeit mit VDIs (virtuellen Festplatten-Images).
Ein VDI ist ein Softwareobjekt, das den Inhalt der von einer VM gesehenen virtuellen Festplatte darstellt. Dies unterscheidet sich von der VBD, die ein Objekt ist, das eine VM an das VDI bindet. Das VDI enthält Informationen über die physikalischen Attribute der virtuellen Festplatte (welcher SR-Typ, ob die Festplatte gemeinsam genutzt werden kann, ob die Medien Lese-/Schreib- oder Nur-Lese-Zugriff haben usw.). Die VBD enthält die Attribute, die das VDI an die VM binden (ist es bootfähig, seine Lese-/Schreibmetriken usw.).
Die VDI-Objekte können mit dem Standardbefehl zur Objektlistung (xe vdi-list) aufgelistet und die Parameter mit den Standardparameterbefehlen manipuliert werden. Weitere Informationen finden Sie unter Low-level parameter commands

VDI-Parameter

VDIs haben die folgenden Parameter:
Parametername Beschreibung Typ
uuid Der eindeutige Bezeichner/die Objektreferenz für die VDI Nur Lesezugriff
name-label Der Name der VDI Lese-/Schreibzugriff
name-description Die Beschreibungszeichenfolge der VDI Lese-/Schreibzugriff
allowed-operations Eine Liste der in diesem Zustand zulässigen Operationen Nur Lesezugriff auf den Parameter
current-operations Eine Liste der Operationen, die derzeit auf dieser VDI ausgeführt werden Nur Lesezugriff auf den Parameter
sr-uuid SR, in dem sich die VDI befindet Schreibgeschützt
vbd-uuids Eine Liste von VBDs, die auf diese VDI verweisen Schreibgeschützter Satzparameter
crashdump-uuids Liste der Crash-Dumps, die auf diese VDI verweisen Schreibgeschützter Satzparameter
virtual-size Größe der Festplatte, wie sie der VM präsentiert wird, in Bytes. Abhängig vom Typ des Speicher-Backends wird die Größe möglicherweise nicht exakt eingehalten. Schreibgeschützt
physical-utilisation Menge des physischen Speichers, den die VDI auf dem SR belegt, in Bytes Schreibgeschützt
type Typ des VDI, zum Beispiel System oder Benutzer Schreibgeschützt
sharable Der Wert ist true, wenn dieses VDI freigegeben werden kann, andernfalls false. Schreibgeschützt
read-only Der Wert ist true, wenn dieses VDI nur schreibgeschützt eingebunden werden kann, andernfalls false. Schreibgeschützt
storage-lock Der Wert ist true, wenn dieses VDI auf Speicherebene gesperrt ist, andernfalls false. Schreibgeschützt
parent Verweist auf das übergeordnete VDI, wenn dieses VDI Teil einer Kette ist. Schreibgeschützt
missing Der Wert ist wahr, wenn der SR-Scanvorgang diese VDI als nicht vorhanden gemeldet hat Nur lesen
other-config Zusätzliche Konfigurationsinformationen für diese VDI Lese-/Schreibkartenparameter
sr-name-label Name des enthaltenden Speicher-Repositorys Nur lesen
location Standortinformationen Nur lesen
managed Der Wert ist wahr, wenn die VDI verwaltet wird Nur lesen
xenstore-data Daten, die nach dem Anhängen des VDI in den xenstore Baum (/local/domain/0/backend/ vbd/domid/device-id/smdata) eingefügt werden sollen. Die SM-Backends setzen dieses Feld normalerweise auf vdi_attach. Nur-Lese-Kartenparameter
sm-config SM-abhängige Daten Nur-Lese-Kartenparameter
is-a-snapshot Der Wert ist wahr, wenn dieses VDI ein VM-Speicherschnappschuss ist, andernfalls falsch. Schreibgeschützt
snapshot_of Die UUID des Speichers, von dem dieses VDI ein Schnappschuss ist Schreibgeschützt
snapshots Die UUIDs aller Schnappschüsse dieses VDI Schreibgeschützt
snapshot_time Der Zeitstempel des Snapshot-Vorgangs, der dieses VDI erstellt hat Schreibgeschützt
metadata-of-pool Die UUID des Pools, der dieses Metadaten-VDI erstellt hat Schreibgeschützt
metadata-latest Flag, das anzeigt, ob das VDI die neuesten bekannten Metadaten für diesen Pool enthält Schreibgeschützt
cbt-enabled Flag, das anzeigt, ob die Änderungsblockverfolgung für das VDI aktiviert ist Lese-/Schreibzugriff

vdi-clone

xe vdi-clone uuid=uuid_of_the_vdi [driver-params:key=value]
Erstellen Sie eine neue, beschreibbare Kopie des angegebenen VDI, die direkt verwendet werden kann. Es ist eine Variante von vdi-copy, die Hochgeschwindigkeits-Image-Klonfunktionen bereitstellen kann, wo diese vorhanden sind.
Verwenden Sie den optionalen driver-params Map-Parameter, um zusätzliche anbieterspezifische Konfigurationsinformationen an den Backend-Speichertreiber zu übergeben, auf dem das VDI basiert. Weitere Informationen finden Sie in der Dokumentation des Speichertreiber-Anbieters.

vdi-copy

xe vdi-copy uuid=uuid_of_the_vdi sr-uuid=uuid_of_the_destination_sr
Eine VDI auf einen angegebenen SR kopieren.

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
Eine VDI erstellen.
Der Parameter virtual-size kann in Bytes oder unter Verwendung der IEC-Standard-Suffixe KiB, MiB, GiB und TiB angegeben werden.
Hinweis:
SR-Typen, die Thin Provisioning von Datenträgern unterstützen (wie Lokales VHD und NFS), erzwingen keine virtuelle Zuweisung von Datenträgern. Seien Sie äußerst vorsichtig, wenn Sie virtuellen Speicherplatz auf einem SR überprovisionieren. Wenn ein überprovisionierter SR voll wird, muss Speicherplatz entweder auf dem SR-Zielsubstrat oder durch Löschen ungenutzter VDIs im SR freigegeben 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
Zerstören Sie die Daten, die mit der angegebenen VDI verknüpft sind, aber behalten Sie die Metadaten der geänderten Blockverfolgung bei.
Hinweis:
Wenn Sie die geänderte Blockverfolgung verwenden, um inkrementelle Backups der 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 die geänderte Blockverfolgung aktiviert ist.

vdi-destroy

xe vdi-destroy uuid=uuid_of_vdi
Zerstören Sie die angegebene 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 zu behalten. Verwenden Sie vdi-destroy nicht für Snapshots von VDIs, bei denen Changed Block Tracking aktiviert ist.
Bei lokalen VHD- und NFS-SR-Typen wird Speicherplatz auf vdi-destroy nicht sofort freigegeben, sondern periodisch während eines Speicher-Repository-Scanvorgangs. Wenn Sie erzwingen müssen, dass gelöschter Speicherplatz verfügbar gemacht wird, rufen Sie sr-scan manuell auf.

vdi-disable-cbt

xe vdi-disable-cbt uuid=uuid_of_vdi
Changed Block Tracking für das VDI deaktivieren.

vdi-enable-cbt

xe vdi-enable-cbt uuid=uuid_of_vdi
Changed Block Tracking für das VDI aktivieren.
Hinweis:
Sie können Changed Block Tracking nur auf lizenzierten Instanzen von XenServer 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]
Exportieren Sie ein VDI in den angegebenen Dateinamen. Sie können ein VDI in einem der folgenden Formate exportieren:
  • raw
  • vhd
Das VHD-Format kann sparse sein. Wenn nicht zugewiesene Blöcke innerhalb des VDI vorhanden sind, können diese Blöcke aus der VHD-Datei weggelassen werden, wodurch die VHD-Datei kleiner wird. Sie können in das VHD-Format von allen unterstützten VHD-basierten Speichertypen (EXT3/EXT4, NFS) 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
Entfernt bedingungslos einen VDI-Eintrag aus der Datenbank, ohne das Speicher-Backend zu berühren. Im Normalbetrieb verwenden Sie stattdessen vdi-destroy.

vdi-import

xe vdi-import uuid=uuid_of_vdi filename=filename_to_import_from [format=format] [--progress]
Importieren Sie eine VDI. Sie können eine 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]
Erstellt 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
Vergleicht zwei VDIs und gibt die Liste der Blöcke zurück, die sich zwischen den beiden geändert haben, als base64-kodierte Zeichenfolge. Dieser Befehl funktioniert nur für VDIs, bei denen die Änderungsblockverfolgung aktiviert ist.
Weitere Informationen finden Sie unter Geänderte Blockverfolgung.

vdi-pool-migrate

xe vdi-pool-migrate uuid=VDI_uuid sr-uuid=destination-sr-uuid
Migriert eine VDI zu einem angegebenen SR, während die VDI an einen laufenden Gast angehängt ist. (Speicher-Live-Migration)
Weitere Informationen finden Sie unter VMs migrieren.

vdi-resize

xe vdi-resize uuid=vdi_uuid disk-size=new_size_for_disk
Ändert die Größe der VDI, die durch die UUID angegeben ist.

vdi-snapshot

xe vdi-snapshot uuid=uuid_of_the_vdi [driver-params=params]
Erzeugt eine Lese-/Schreibversion eines VDI, die als Referenz für Sicherungs- oder Vorlagenerstellungszwecke oder beides verwendet werden kann. Verwenden Sie den Snapshot, um eine Sicherung durchzuführen, anstatt Sicherungssoftware innerhalb der VM zu installieren und auszuführen. Die VM läuft weiter, während externe Sicherungssoftware den Inhalt des Snapshots auf das Sicherungsmedium streamt. Ähnlich kann ein Snapshot als „Gold-Image“ verwendet werden, auf dem eine Vorlage basiert. Eine Vorlage kann mit beliebigen VDIs erstellt werden.
Verwenden Sie den optionalen driver-params Map-Parameter, um zusätzliche anbieterspezifische Konfigurationsinformationen an den Backend-Speichertreiber zu übergeben, auf dem das VDI basiert. Weitere Informationen finden Sie in der Dokumentation des Speichertreiberanbieters.
Ein Klon eines Snapshots erzeugt immer ein beschreibbares VDI.

vdi-unlock

xe vdi-unlock uuid=uuid_of_vdi_to_unlock [force=true]
Versucht, die angegebenen VDIs zu entsperren. Wenn force=true an den Befehl übergeben wird, erzwingt dies den Entsperrvorgang.

vdi-update

xe vdi-update uuid=uuid
Aktualisiert die Felder des VDI-Objekts in der Datenbank.

VIF-Befehle

Befehle zum Arbeiten mit VIFs (virtuelle Netzwerkschnittstellen).
Die VIF-Objekte können mit dem Standardbefehl zur Objektlistung (xe vif-list) aufgelistet und die Parameter mit den Standardparameterbefehlen manipuliert werden. Weitere Informationen finden Sie unter Befehle für Parameter auf niedriger Ebene

VIF-Parameter

VIFs haben die folgenden Parameter:
  • uuid (nur lesbar) der eindeutige Bezeichner/Objektreferenz für das VIF
  • vm-uuid (nur lesbar) der 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 Satzparameter) eine Liste der in diesem Zustand zulässigen Operationen
  • current-operations (schreibgeschützter Satzparameter) eine Liste der Operationen, die derzeit auf diesem VIF ausgeführt werden
  • device (schreibgeschützt) Ganzzahlbezeichnung dieses VIF, die die Reihenfolge angibt, in der VIF-Back-Ends erstellt wurden
  • MAC (schreibgeschützt) MAC-Adresse des VIF, wie sie der VM angezeigt wird
  • MTU (schreibgeschützt) Maximale Übertragungseinheit des VIF in Bytes.
    Dieser Parameter ist schreibgeschützt, Sie können die MTU-Einstellung jedoch mit dem Schlüssel mtu über den Kartenparameter other-config überschreiben. Um beispielsweise die MTU auf einer virtuellen NIC zurückzusetzen, um Jumbo-Frames zu verwenden:
    xe vif-param-set \
        uuid=<vif_uuid> \
        other-config:mtu=9000
  • currently-attached (schreibgeschützt) true, wenn das Gerät angeschlossen ist
  • qos_algorithm_type (Lese-/Schreibzugriff) zu verwendender QoS-Algorithmus
  • qos_algorithm_params (Lese-/Schreib-Kartenparameter) Parameter für den ausgewählten QoS-Algorithmus
  • qos_supported_algorithms (schreibgeschützter Satzparameter) unterstützte QoS-Algorithmen für dieses VIF
  • MAC-autogenerated (schreibgeschützt) Der Wert ist true, wenn die MAC-Adresse des VIF automatisch generiert wurde
  • other-config (Lese-/Schreib-Kartenparameter) zusätzliche Konfigurations-key:value-Paare
  • other-config:ethtoolrx (Lese-/Schreibzugriff) auf „on“ setzen, um die Empfangs-Prüfsumme zu aktivieren, auf „off“, um sie zu deaktivieren
  • other-config:ethtooltx (Lese-/Schreibzugriff) auf „on“ setzen, um die Sende-Prüfsumme zu aktivieren, auf „off“, um sie zu deaktivieren
  • other-config:ethtoolsg (Lese-/Schreibzugriff) auf „on“ setzen, um Scatter/Gather zu aktivieren, auf „off“, um es zu deaktivieren
  • other-config:ethtooltso (Lese-/Schreibzugriff) auf „on“ setzen, um TCP-Segmentierungs-Offload zu aktivieren, auf „off“, um es zu deaktivieren
  • other-config:ethtoolufo (Lese-/Schreibzugriff) auf „on“ setzen, um UDP-Fragment-Offload zu aktivieren, auf „off“, um es zu deaktivieren
  • other-config:ethtoolgso (Lese-/Schreibzugriff) auf „on“ setzen, um generisches Segmentierungs-Offload zu aktivieren, auf „off“, um es zu deaktivieren
  • other-config:promiscuous (Lese-/Schreibzugriff) auf „true“ setzen, damit ein VIF auf der Bridge promiskuitiv ist und den gesamten Datenverkehr über die Bridge sieht. Nützlich für den Betrieb eines Intrusion Detection Systems (IDS) oder Ähnlichem in einer VM.
  • network-uuid (nur Lesezugriff) der eindeutige Bezeichner/Objektreferenz des virtuellen Netzwerks, mit dem dieses VIF verbunden ist
  • network-name-label (nur Lesezugriff) der beschreibende Name des virtuellen Netzwerks, mit dem dieses VIF verbunden ist
  • io_read_kbs (nur Lesezugriff) durchschnittliche Leserate in kB/s für dieses VIF
  • io_write_kbs (nur Lesezugriff) durchschnittliche Schreibrate in kB/s für dieses VIF
  • locking_mode (Lese-/Schreibzugriff) Beeinflusst die Fähigkeit des VIFs, Datenverkehr zu/von einer Liste von MAC- und IP-Adressen zu filtern. Erfordert zusätzliche Parameter.
  • locking_mode:default (Lese-/Schreibzugriff) Variiert je nach dem Standard-Sperrmodus für das VIF-Netzwerk.
    Wenn der Standard-Sperrmodus auf disabled gesetzt ist, wendet XenServer eine Filterregel an, sodass das VIF keinen Datenverkehr senden oder empfangen kann. Wenn der Standard-Sperrmodus auf unlocked gesetzt ist, entfernt XenServer alle mit dem VIF verbundenen Filterregeln. Weitere Informationen finden Sie unter Netzwerkbefehle.
  • locking_mode:locked (Lese-/Schreibzugriff) Nur Datenverkehr, der an die oder von den angegebenen MAC- und IP-Adressen gesendet wird, ist auf dem VIF zulässig. Wenn keine IP-Adressen angegeben sind, ist kein Datenverkehr zulässig.
  • locking_mode:unlocked (Lese-/Schreibzugriff) Es werden keine Filter auf den Datenverkehr angewendet, der zum oder vom VIF geht.
  • locking_mode:disabled (Lese-/Schreibzugriff) XenServer wendet eine Filterregel an, sodass das VIF den gesamten Datenverkehr verwirft.

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]
Ein VIF auf einer VM erstellen.
Geeignete Werte für das Feld device sind im Parameter allowed-VIF-devices auf der angegebenen VM aufgeführt. Bevor dort VIFs vorhanden sind, sind die zulässigen Werte ganze Zahlen von 0–6.
Der Parameter mac ist die Standard-MAC-Adresse im Format aa:bb:cc:dd:ee:ff. Wenn Sie ihn nicht angeben, wird eine geeignete zufällige MAC-Adresse erstellt. Sie können auch explizit eine zufällige MAC-Adresse festlegen, indem Sie mac=random angeben.

vif-destroy

xe vif-destroy uuid=uuid_of_vif
Ein VIF zerstören.

vif-move

xe vif-move uuid=uuid network-uuid=network_uuid
Das VIF in ein anderes Netzwerk verschieben.

vif-plug

xe vif-plug uuid=uuid_of_vif
Versuchen Sie, das VIF anzuschließen, während die VM im laufenden Zustand ist.

vif-unplug

xe vif-unplug uuid=uuid_of_vif
Versucht, das VIF von der VM zu trennen, während diese läuft.

vif-configure-ipv4

Konfigurieren Sie die IPv4-Einstellungen für diese virtuelle Schnittstelle. Legen Sie die IPv4-Einstellungen wie folgt fest:
xe vif-configure-ipv4 uuid=uuid_of_vif mode=static address=CIDR_address gateway=gateway_address
Zum Beispiel:
VIF.configure_ipv4(vifObject,"static", " 192.168.1.10/24", " 192.168.1.1")
IPv4-Einstellungen wie folgt bereinigen:
xe vif-configure-ipv4 uuid=uuid_of_vif mode=none

vif-configure-ipv6

Konfigurieren Sie die IPv6-Einstellungen für diese virtuelle Schnittstelle. Legen Sie die IPv6-Einstellungen wie folgt fest:
xe vif-configure-ipv6 uuid=uuid_of_vif mode=static address=IP_address gateway=gateway_address
Zum Beispiel:
VIF.configure_ipv6(vifObject,"static", "fd06:7768:b9e5:8b00::5001/64", "fd06:7768:b9e5:8b00::1")
IPv6-Einstellungen wie folgt bereinigen:
xe vif-configure-ipv6 uuid=uuid_of_vif mode=none

VLAN-Befehle

Befehle für die Arbeit mit VLANs (virtuellen Netzwerken). Um virtuelle Schnittstellen aufzulisten und zu bearbeiten, siehe die PIF-Befehle, die einen VLAN-Parameter haben, um anzuzeigen, dass sie ein zugehöriges virtuelles Netzwerk haben. 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
Erstellen Sie ein VLAN auf Ihrem XenServer-Host.

pool-vlan-create

xe pool-vlan-create pif-uuid=uuid_of_pif vlan=vlan_number network-uuid=uuid_of_network
Erstellen Sie ein VLAN auf allen Hosts in einem Pool, indem Sie ermitteln, auf welcher Schnittstelle (z. B. eth0) sich das angegebene Netzwerk befindet (auf jedem Host), und entsprechend ein neues PIF-Objekt auf jedem Host erstellen und anschließen.

vlan-destroy

xe vlan-destroy uuid=uuid_of_pif_mapped_to_vlan
Zerstören Sie ein VLAN. Erfordert die UUID des PIF, das das VLAN darstellt.

VM-Befehle

Befehle zur Steuerung von VMs und deren Attributen.

VM-Selektoren

Mehrere der hier aufgeführten Befehle verfügen über einen gemeinsamen Mechanismus zur Auswahl 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, ist beispielsweise die Ausführung von xe vm-list power-state=running. (Die vollständige Liste der Felder, die abgeglichen werden können, erhalten Sie mit dem Befehl xe vm-list params=all.) Wenn Sie beispielsweise power-state=halted angeben, werden VMs ausgewählt, deren Parameter power-state gleich halted ist. Wenn mehrere VMs übereinstimmen, geben Sie die Option --multiple an, um den Vorgang auszuführen. Die vollständige Liste der Parameter, die abgeglichen werden können, wird am Anfang dieses Abschnitts beschrieben.
Die VM-Objekte können mit dem Standardbefehl zur Objektlistung (xe vm-list) aufgelistet und die Parameter mit den Standard-Parameterbefehlen manipuliert werden. Weitere Informationen finden Sie unter Low-level parameter commands

VM-Parameter

VMs haben die folgenden Parameter:
Hinweis:
Alle beschreibbaren VM-Parameterwerte können geändert werden, während die VM läuft, aber neue Parameter werden nicht dynamisch angewendet und können erst nach einem Neustart der VM wirksam werden.
  • appliance (Lese-/Schreibzugriff) die Appliance/vApp, zu der die VM gehört
  • uuid (schreibgeschützt) der eindeutige Bezeichner/die Objekt-Referenz für die VM
  • name-label (Lese-/Schreibzugriff) der Name der VM
  • name-description (Lese-/Schreibzugriff) die Beschreibungszeichenfolge der VM
  • order (Lese-/Schreibzugriff) für den Start/das Herunterfahren von vApps 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 und so weiter.
  • version (schreibgeschützt) die Häufigkeit, mit der diese VM wiederhergestellt wurde. Wenn Sie eine neue VM mit einer älteren Version überschreiben möchten, rufen Sie vm-recover auf.
  • user-version (Lese-/Schreibzugriff) Zeichenfolge für Ersteller von VMs und Vorlagen, um Versionsinformationen einzufügen
  • is-a-template (Lese-/Schreibzugriff) Der Wert ist false, es sei denn, diese VM ist eine Vorlage. 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 mehr auf false zurückgesetzt werden. Vorlagen-VMs können mit diesem Parameter nicht in VMs umgewandelt werden.
    Sie können eine VM mit folgender Option in eine Vorlage konvertieren:
    xe vm-param-set uuid=<vm uuid> is-a-template=true
  • is-control-domain (schreibgeschützt) Der Wert ist wahr, wenn es sich um eine Steuerdomäne (Domäne 0 oder eine Treiberdomäne) handelt.
  • power-state (schreibgeschützt) aktueller Energiestatus
  • start-delay (Lese-/Schreibzugriff) die Verzögerung in Sekunden, die gewartet werden soll, bevor ein Aufruf zum Starten der VM zurückkehrt
  • shutdown-delay (Lese-/Schreibzugriff) die Verzögerung in Sekunden, die gewartet werden soll, bevor ein Aufruf zum Herunterfahren der VM zurückkehrt
  • memory-dynamic-max (Lese-/Schreibzugriff) dynamisches Maximum in Bytes
  • memory-dynamic-min (Lese-/Schreibzugriff) dynamisches Minimum in Bytes
  • memory-static-max (Lese-/Schreibzugriff) statisch festgelegtes (absolutes) Maximum in Bytes. Wenn Sie diesen Wert ändern möchten, muss die VM heruntergefahren werden.
  • memory-static-min (Lese-/Schreibzugriff) statisch festgelegtes (absolutes) Minimum in Bytes. Wenn Sie diesen Wert ändern möchten, muss die VM heruntergefahren werden.
  • suspend-VDI-uuid (schreibgeschützt) die VDI, auf der ein Suspend-Image gespeichert ist
  • VCPUs-params (Lese-/Schreib-Map-Parameter) Konfigurationsparameter für die ausgewählte vCPU-Richtlinie.
  • VCPUs-max (Lese-/Schreibzugriff) maximale Anzahl virtueller CPUs.
  • VCPUs-at-startup (Lese-/Schreibzugriff) Startanzahl virtueller CPUs
  • actions-after-crash (Lese-/Schreibzugriff) Aktion, die ausgeführt werden soll, wenn die VM abstürzt. Für PV-Gäste sind folgende Parameter gültig:
    • preserve (nur zur Analyse)
    • coredump_and_restart (einen Coredump aufzeichnen und VM neu starten)
    • coredump_and_destroy (einen Coredump aufzeichnen und VM angehalten lassen)
    • restart (kein Coredump und VM neu starten)
    • destroy (kein Coredump und VM angehalten lassen)
  • console-uuids (Nur-Lese-Satzparameter) virtuelle Konsolengeräte
  • platform (Lese-/Schreib-Map-Parameter) plattformspezifische Konfiguration
    So deaktivieren Sie VDA, um Windows 10 in den Tablet-Modus zu wechseln:
    xe vm-param-set uuid=<vm_uuid> platform:acpi_laptop_slate=0
    So aktivieren Sie VDA, um Windows 10 in den Tablet-Modus zu wechseln:
    xe vm-param-set uuid=<vm_uuid> platform:acpi_laptop_slate=1
    So überprüfen Sie den aktuellen Status:
    xe vm-param-get uuid=<vm_uuid> param-name=platform param-key=acpi_laptop_slate
  • allowed-operations (Nur-Lese-Satzparameter) Liste der in diesem Zustand zulässigen Operationen
  • current-operations (Nur-Lese-Satzparameter) eine Liste der Operationen, die derzeit auf der VM ausgeführt werden
  • allowed-VBD-devices (Nur-Lese-Satzparameter) Liste der zur Verwendung verfügbaren VBD-Bezeichner, dargestellt durch Ganzzahlen im Bereich 0–254. Diese Liste dient nur zu Informationszwecken, und andere Geräte können verwendet werden (funktionieren aber möglicherweise nicht).
  • allowed-VIF-devices (Nur-Lese-Satzparameter) Liste der zur Verwendung verfügbaren VIF-Bezeichner, dargestellt durch Ganzzahlen im Bereich 0–6. Diese Liste dient nur zu Informationszwecken, und andere Geräte können verwendet werden (funktionieren aber möglicherweise nicht).
  • HVM-boot-policy (Lese-/Schreibzugriff) die Startrichtlinie für Gäste. Entweder BIOS-Reihenfolge oder eine leere Zeichenfolge.
  • HVM-boot-params (Lese-/Schreib-Map-Parameter) der Reihenfolgeschlüssel steuert die Startreihenfolge des Gastes, dargestellt als Zeichenfolge, wobei jedes Zeichen eine Startmethode ist: d für die CD/DVD, c für die Root-Disk und n für den Netzwerk-PXE-Start. Der Standardwert ist dc.
  • HVM-shadow-multiplier (Lese-/Schreibzugriff) Gleitkommawert, der den Overhead des Schattenarbeitsspeichers steuert, der der VM zugewiesen wird. Der Standardwert ist 1.0 (der Mindestwert), und Sie sollten diesen Wert nur ändern, wenn Sie ein fortgeschrittener Benutzer sind.
  • PV-kernel (Lese-/Schreibzugriff) Pfad zum Kernel
  • PV-ramdisk (Lese-/Schreibzugriff) Pfad zu/zum initrd
  • PV-args (Lese-/Schreibzugriff) Zeichenfolge von Kernel-Befehlszeilenargumenten
  • PV-legacy-args (Lese-/Schreibzugriff) Zeichenfolge von Argumenten, um ältere VMs zu starten
  • PV-bootloader (Lese-/Schreibzugriff) Name oder Pfad des Bootloaders
  • PV-bootloader-args (Lese-/Schreibzugriff) Zeichenfolge von verschiedenen Argumenten für den Bootloader
  • last-boot-CPU-flags (Nur Lesezugriff) beschreibt die CPU-Flags, auf denen die VM zuletzt gestartet wurde
  • resident-on (Nur Lesezugriff) der XenServer-Host, auf dem eine VM resident ist
  • affinity (Lese-/Schreibzugriff) Der XenServer-Host, 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. Auch als Home-Server bekannt.
  • groups (Lese-/Schreibzugriff) die VM-Gruppe, zu der diese VM gehört. Eine VM-Gruppe definiert, wo XenServer versucht, die VM zu starten oder wohin sie evakuiert werden soll.
  • other-config (Lese-/Schreib-Map-Parameter) Eine Liste von Schlüssel-Wert-Paaren, die zusätzliche Konfigurationsparameter für die VM angeben.
    Zum Beispiel fordert das Schlüssel-Wert-Paar other-config auto_poweron: true an, die VM automatisch zu starten, nachdem ein beliebiger Host im Pool gebootet hat. Sie müssen diesen Parameter auch in der other-config Ihres Pools festlegen. Diese Parameter sind jetzt veraltet. Verwenden Sie stattdessen den Parameter ha-restart-priority.
  • start-time (Nur Lesezugriff) 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, wobei z der einbuchstabige militärische Zeitzonenindikator ist, zum Beispiel Z für UTC (GMT)
  • install-time (Nur Lesezugriff) 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, wobei z der einbuchstabige militärische Zeitzonenindikator ist, zum Beispiel Z für UTC (GMT)
  • memory-actual (schreibgeschützt) der tatsächlich von einer VM verwendete Speicher
  • VCPUs-number (schreibgeschützt) die Anzahl der virtuellen CPUs, die der VM für eine Linux-VM zugewiesen sind. Diese Zahl kann von VCPUS-max abweichen und kann ohne Neustart der VM mit dem Befehl vm-vcpu-hotplug geändert werden. Weitere Informationen finden Sie unter vm-vcpu-hotplug. Windows-VMs laufen immer mit der Anzahl der vCPUs, die auf VCPUsmax eingestellt ist, und müssen neu gestartet werden, um diesen Wert zu ändern. Die Leistung sinkt drastisch, wenn Sie VCPUs-number auf einen Wert setzen, der größer ist als die Anzahl der physischen CPUs auf dem XenServer-Host.
  • VCPUs-Utilization (schreibgeschützter Kartenparameter) eine Liste der virtuellen CPUs und deren Gewichtung
  • os-version (schreibgeschützter Kartenparameter) die Version des Betriebssystems für die VM
  • PV-drivers-version (schreibgeschützter Kartenparameter) 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ützter Kartenparameter) vom Agenten auf der VM gemeldete Speichermetriken
  • disks (schreibgeschützter Kartenparameter) vom Agenten auf der VM gemeldete Festplattenmetriken
  • networks (schreibgeschützter Kartenparameter) vom Agenten auf der VM gemeldete Netzwerkmetriken
  • other (schreibgeschützter Kartenparameter) andere vom Agenten auf der VM gemeldete Metriken
  • guest-metrics-lastupdated (schreibgeschützt) Zeitstempel, wann der In-Guest-Agent den letzten Schreibvorgang in diese Felder durchgeführt hat. Der Zeitstempel hat das Format yyyymmddThh:mm:ss z, wobei z der einbuchstabige militärische Zeitzonenindikator ist, z. B. Z für UTC (GMT)
  • actions-after-shutdown (Lese-/Schreibzugriff) Aktion, die nach dem Herunterfahren der VM ausgeführt werden soll
  • actions-after-reboot (Lese-/Schreibzugriff) 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, sonst -1)
  • recommendations (schreibgeschützt) XML-Spezifikation der empfohlenen Werte und Bereiche für Eigenschaften dieser VM
  • xenstore-data (Lese-/Schreib-Kartenparameter) Daten, die nach der Erstellung der VM in den xenstore Baum (/local/domain/*domid*/vm-data) eingefügt werden sollen
  • is-a-snapshot (schreibgeschützt) Der Wert ist wahr, wenn diese VM ein Snapshot ist
  • snapshot_of (schreibgeschützt) die UUID der VM, von der dieser Snapshot stammt
  • 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 Zielspeichermenge
  • blocked-operations (Lese-/Schreib-Kartenparameter) listet die Vorgänge auf, die für diese VM nicht ausgeführt werden können
  • last-boot-record (schreibgeschützt) Aufzeichnung der letzten Boot-Parameter für diese Vorlage im XML-Format
  • ha-always-run (Lese-/Schreibzugriff) Der Wert ist wahr, wenn diese VM immer auf einem anderen Host neu gestartet wird, falls 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 (Lese-/Schreibzugriff) Neustart oder Best-Effort
  • blobs (schreibgeschützt) binärer Datenspeicher
  • live (schreibgeschützt) Der Wert ist wahr, wenn die VM läuft. Der Wert ist falsch, wenn HA vermutet, dass die VM nicht läuft.

vm-assert-can-be-recovered

xe vm-assert-can-be-recovered uuid [database] vdi-uuid
Prüft, ob Speicher zur Wiederherstellung dieser VM verfügbar ist.

vm-call-plugin

xe vm-call-plugin vm-uuid=vm_uuid plugin=plugin fn=function [args:key=value]
Ruft die Funktion innerhalb des Plug-ins auf der angegebenen VM mit optionalen Argumenten (args:key=value) auf. Um eine „value“-Zeichenfolge mit Sonderzeichen (z. B. Zeilenumbruch) zu übergeben, kann stattdessen 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...]
Fügt der ausgewählten VM eine neue virtuelle CD hinzu. Wählen Sie den Parameter device von 0–3 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 beliebig viele der VM-Parameter sein, die am Anfang dieses Abschnitts aufgeführt sind.

vm-cd-eject

xe vm-cd-eject [vm-selector=vm_selector_value...]
Wirft 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 des 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 beliebig viele der VM-Parameter sein, die am Anfang dieses Abschnitts aufgeführt sind.

vm-cd-insert

xe vm-cd-insert cd-name=name_of_cd [vm-selector=vm_selector_value...]
Legt 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 des 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 beliebig viele der VM-Parameter sein, die am Anfang dieses Abschnitts aufgeführt sind.

vm-cd-list

xe vm-cd-list [vbd-params] [vdi-params] [vm-selector=vm_selector_value...]
Listet die an die angegebenen VMs angeschlossenen CDs 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. Optionale Argumente können beliebig viele der VM-Parameter sein, die am Anfang dieses Abschnitts aufgeführt sind.
Sie können auch auswählen, welche VBD- und VDI-Parameter aufgelistet werden sollen.

vm-cd-remove

xe vm-cd-remove cd-name=name_of_cd [vm-selector=vm_selector_value...]
Entfernen Sie eine virtuelle CD von den 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 beliebig viele der VM-Parameter sein, die am Anfang dieses Abschnitts aufgeführt sind.

vm-checkpoint

xe vm-checkpoint new-name-label=name_label [new-name-description=description]
Erstellen Sie einen Prüfpunkt einer vorhandenen VM unter Verwendung eines schnellen Datenträger-Snapshot-Vorgangs 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...]
Klonen Sie eine vorhandene VM unter Verwendung eines schnellen Datenträger-Klonvorgangs 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 beliebig viele der VM-Parameter sein, die am Anfang dieses Abschnitts aufgeführt sind.

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...]
Berechnen Sie die maximale Menge an statischem Speicher, die einer vorhandenen VM zugewiesen werden kann, wobei die Gesamtmenge des physischen RAM als Obergrenze dient. Der optionale Parameter approximate reserviert in der Berechnung ausreichend zusätzlichen Speicher, um das spätere Hinzufügen weiterer vCPUs zur VM zu berücksichtigen.
Zum Beispiel:
xe vm-compute-maximum-memory vm=testvm total=`xe host-list params=memory-free --minimal`
Dieser Befehl verwendet den Wert des Parameters memory-free, der vom Befehl xe host-list zurückgegeben wird, um den maximalen Speicher der VM mit dem Namen 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 beliebig viele der VM-Parameter sein, die am Anfang dieses Abschnitts aufgeführt sind.

vm-compute-memory-overhead

xe vm-compute-memory-overhead
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...]
Kopieren Sie eine vorhandene VM, jedoch ohne Verwendung eines schnellen Festplatten-Klonvorgangs auf Speicherebene (selbst wenn diese Option verfügbar ist). Die Festplatten-Images der kopierten VM sind garantiert vollständige Images, d.h. sie sind nicht Teil einer Copy-on-Write (CoW)-Kette.
Geben Sie den Namen und die optionale Beschreibung für die resultierende kopierte VM mithilfe der Argumente new-name-label und new-name-description an.
Geben Sie das Ziel-SR für die resultierende kopierte VM mithilfe von sr-uuid an. Wenn dieser Parameter nicht angegeben wird, ist das Ziel dasselbe SR, in dem sich die ursprüngliche VM befindet.
Die VM oder 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 VM-Parameter sein, die am Anfang dieses Abschnitts aufgeführt sind.

vm-copy-bios-strings

xe vm-copy-bios-strings host-uuid=host_uuid
Kopieren Sie die BIOS-Zeichenfolgen des angegebenen Hosts auf die VM.
Hinweis:
Nachdem Sie eine VM zum ersten Mal gestartet haben, können Sie ihre BIOS-Zeichenfolgen nicht mehr ä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...]
Listen Sie Crashdumps auf, die den angegebenen VMs zugeordnet sind.
Wenn Sie das optionale Argument params verwenden, 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 all verwenden, um alle Parameter anzuzeigen. Wenn params nicht verwendet wird, zeigt die zurückgegebene Liste eine Standarduntermenge aller verfügbaren Parameter an.
Die VM oder 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 VM-Parameter sein, die am Anfang dieses Abschnitts aufgeführt sind.

vm-data-source-list

xe vm-data-source-list [vm-selector=vm selector value...]
Listen Sie die Datenquellen auf, die für eine VM aufgezeichnet werden können.
Wählen Sie die VMs, auf denen dieser Vorgang ausgeführt werden soll, mithilfe des Standardauswahlmechanismus aus. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl der VM-Parameter sein, die am Anfang dieses Abschnitts aufgeführt sind. Wenn keine Parameter zur Auswahl von Hosts angegeben werden, 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 für eine Datenquelle enabled auf true gesetzt ist, werden die Metriken derzeit in der Leistungsdatenbank aufgezeichnet. Wenn für eine Datenquelle standard auf true gesetzt ist, werden die Metriken standardmäßig in der Leistungsdatenbank aufgezeichnet (und enabled ist für diese Datenquelle ebenfalls auf true gesetzt). Wenn für eine Datenquelle standard auf false gesetzt ist, werden die Metriken standardmäßig nicht in der Leistungsdatenbank aufgezeichnet (und enabled ist für diese Datenquelle ebenfalls auf false gesetzt).
Um die Aufzeichnung von Datenquellenmetriken in der Leistungsdatenbank zu starten, führen Sie den Befehl vm-data-source-record aus. Dieser Befehl setzt enabled auf true. Zum Beenden führen Sie den Befehl vm-data-source-forget aus. Dieser Befehl setzt enabled auf false.

vm-data-source-record

xe vm-data-source-record data-source=name_description_of_data-source [vm-selector=vm selector value...]
Zeichnen Sie die angegebene Datenquelle für eine VM auf.
Dieser Vorgang schreibt die Informationen aus der Datenquelle in die persistente Leistungsmetrikdatenbank der angegebenen VMs. Aus Leistungsgründen unterscheidet sich diese Datenbank von der normalen Agenten-Datenbank.
Wählen Sie die VMs, auf denen dieser Vorgang ausgeführt werden soll, mithilfe des Standardauswahlmechanismus aus. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl der VM-Parameter sein, die am Anfang dieses Abschnitts aufgeführt sind. Wenn keine Parameter zur Auswahl von Hosts angegeben werden, 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...]
Beenden Sie die Aufzeichnung der angegebenen Datenquelle für eine VM und löschen Sie alle aufgezeichneten Daten.
Wählen Sie die VMs, auf denen dieser Vorgang ausgeführt werden soll, mithilfe des Standardauswahlmechanismus aus. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl der VM-Parameter sein, die am Anfang dieses Abschnitts aufgeführt sind. Wenn keine Parameter zur Auswahl von Hosts angegeben werden, 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...]
Zeigen Sie die angegebene Datenquelle für eine VM an.
Wählen Sie die VMs, auf denen dieser Vorgang ausgeführt werden soll, mithilfe des Standardauswahlmechanismus aus. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl der VM-Parameter sein, die am Anfang dieses Abschnitts aufgeführt sind. Wenn keine Parameter zur Auswahl von Hosts angegeben werden, wird der Vorgang auf allen VMs ausgeführt.

vm-destroy

xe vm-destroy uuid=uuid_of_vm
Zerstören Sie die angegebene VM. Dabei bleibt der mit der VM verbundene Speicher intakt. Um auch den 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...]
Fügen Sie den angegebenen VMs eine Festplatte hinzu. Wählen Sie den Parameter device aus dem Wert des Parameters allowed-VBD-devices der VMs.
Der Parameter disk-size kann in Bytes oder unter Verwendung der IEC-Standard-Suffixe 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 beliebig viele der VM-Parameter sein, die am Anfang dieses Abschnitts aufgeführt sind.

vm-disk-list

xe vm-disk-list [vbd-params] [vdi-params] [vm-selector=vm_selector_value...]
Listet die an die angegebenen VMs angehängten Festplatten 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 beliebig viele der VM-Parameter sein, die am Anfang dieses Abschnitts aufgeführt sind.

vm-disk-remove

xe vm-disk-remove device=integer_label_of_disk [vm-selector=vm_selector_value...]
Entfernen Sie eine Festplatte von den angegebenen VMs und zerstören Sie sie.
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 beliebig viele der VM-Parameter sein, die am Anfang dieses Abschnitts aufgeführt sind.

vm-export

xe vm-export filename=export_filename [metadata=true|false] [vm-selector=vm_selector_value...]
Exportieren Sie die angegebenen VMs (einschließlich Festplatten-Images) in eine Datei auf dem lokalen Computer. Geben Sie den Dateinamen, in den die VM exportiert werden soll, mit dem Parameter filename an. Konventionell hat der Dateiname die Erweiterung .xva.
Wenn der Parameter metadata true ist, werden die Festplatten 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 die VM-Informationen neu erstellt werden können. 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 beliebig viele der VM-Parameter sein, die am Anfang dieses Abschnitts aufgeführt sind.

vm-import

xe vm-import filename=export_filename [metadata=true|false] [preserve=true|false][sr-uuid=destination_sr_uuid]
Importieren Sie eine VM aus einer zuvor exportierten Datei. Wenn preserve auf true gesetzt ist, wird die MAC-Adresse der ursprünglichen VM beibehalten. sr-uuid bestimmt den Ziel-SR, in den die VM importiert werden soll. Wird dieser Parameter nicht angegeben, wird der Standard-SR verwendet.
Wenn metadata true ist, können Sie einen zuvor exportierten Satz von Metadaten ohne die zugehörigen Disk-Blöcke importieren. Der reine Metadaten-Import schlägt fehl, wenn VDIs nicht gefunden werden können (benannt nach SR und VDI.location), es sei denn, die Option --force ist angegeben; in diesem Fall wird der Import unabhängig davon fortgesetzt. Wenn Datenträger gespiegelt oder Out-of-Band verschoben werden können, ist der Metadaten-Import/-Export eine schnelle Methode, VMs zwischen getrennten 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]
Installieren oder klonen Sie eine VM aus einer Vorlage. Geben Sie den Vorlagennamen entweder mit dem Argument template-uuid oder template an. Geben Sie einen SR entweder mit dem Argument sr-uuid oder sr-name-label an. Geben Sie an, BIOS-gesperrte Medien mit dem Argument copy-bios-strings-from zu installieren.
Hinweis:
Beim Installieren von einer Vorlage mit vorhandenen Datenträgern werden neue Datenträger standardmäßig im selben SR wie diese vorhandenen Datenträger erstellt. Sofern der SR dies unterstützt, handelt es sich bei diesen Datenträgern um schnelle Kopien. Wird in der Befehlszeile ein anderer SR angegeben, werden die neuen Datenträger dort erstellt. In diesem Fall ist eine schnelle Kopie nicht möglich, und die Datenträger sind vollständige Kopien.
Beim Installieren von einer Vorlage, die keine vorhandenen Datenträger hat, werden neue Datenträger im angegebenen SR oder im Standard-SR des Pools erstellt, wenn kein SR angegeben ist.

vm-is-bios-customized

xe vm-is-bios-customized
Gibt an, ob die BIOS-Zeichenfolgen der VM angepasst wurden.

vm-memory-dynamic-range-set

xe vm-memory-dynamic-range-set min=min max=max
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 ist. Der dynamische Bereich muss in den statischen Bereich passen.

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
Konfigurieren Sie die Speicherlimits einer VM.

vm-memory-set

xe vm-memory-set memory=memory
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]
Legen Sie den Shadow-Memory-Multiplikator für die angegebene VM fest.
Dies ist eine erweiterte Option, die die Menge des Shadow-Speichers ändert, der einer hardwaregestützten VM zugewiesen ist.
Bei einigen spezialisierten Anwendungsworkloads, wie z. B. Citrix Virtual Apps™, ist zusätzlicher Shadow-Speicher erforderlich, um die volle Leistung zu erzielen.
Dieser Speicher wird als Overhead betrachtet. Er ist von den normalen Speicherberechnungen für die Speicherzuweisung an eine VM getrennt. Wenn dieser Befehl aufgerufen wird, verringert sich die Menge des freien Hostspeichers entsprechend dem Multiplikator, und das Feld HVM_shadow_multiplier wird mit dem Wert aktualisiert, den Xen der VM zugewiesen hat. Wenn nicht genügend freier XenServer-Hostspeicher vorhanden ist, wird ein Fehler zurückgegeben.
Die VMs, auf denen dieser Vorgang ausgeführt werden soll, werden über den 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
Konfigurieren Sie den statischen Speicherbereich einer VM. Der statische Speicherbereich definiert feste Unter- und Obergrenzen für den Speicher einer VM. Es ist nur möglich, diese Felder zu ändern, wenn eine VM angehalten ist. Der statische Bereich muss den dynamischen Bereich umfassen.

vm-memory-target-set

xe vm-memory-target-set target=target
Legen Sie das Speicherziel für eine angehaltene oder laufende VM fest. 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 [compress=true|false] [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]
Dieser Befehl migriert die angegebenen VMs zwischen physischen Hosts.
Der Parameter compress überschreibt den Pool-Parameter migration-compression für xe pool-param-set.
Der host Parameter im vm-migrate Befehl kann entweder der Name oder die UUID des XenServer-Hosts sein. Zum Beispiel, um die VM zu einem anderen Host im Pool zu migrieren, wobei die VM-Festplatten auf einem von beiden Hosts gemeinsam genutzten Speicher liegen:
xe vm-migrate uuid=vm_uuid host-uuid=destination_host_uuid
Um VMs zwischen Hosts im selben Pool zu verschieben, die keinen Speicher gemeinsam nutzen (Speicher-Live-Migration):
xe vm-migrate uuid=vm_uuid host-uuid=destination_host_uuid \
    remote-master=192.0.2.35 remote-username=username remote-password=password
Für die Speicher-Live-Migration müssen Sie den Hostnamen oder die IP-Adresse, den Benutzernamen und das Kennwort für den Pool-Koordinator angeben, selbst wenn Sie innerhalb desselben Pools migrieren.
Sie können den SR auswählen, in dem jede 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
Zusätzlich können Sie auswählen, an welches Netzwerk die VM nach der Migration angehängt werden 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:source_vif_uuid=destination_network_uuid
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
Weitere Informationen zur Speicher-Live-Migration, Live-Migration und Live-VDI-Migration finden Sie unter VMs migrieren.
Hinweis:
Wenn Sie von einer älteren Version von XenServer oder Citrix Hypervisor™ aktualisieren, müssen Sie möglicherweise alle VMs nach der Migration herunterfahren und neu starten, um sicherzustellen, dass neue Virtualisierungsfunktionen übernommen werden.
Standardmäßig wird die VM angehalten, migriert und auf dem anderen Host fortgesetzt. Der live Parameter wählt die Live-Migration aus. Die Live-Migration hält die VM während der Migration am Laufen und minimiert so die VM-Ausfallzeit. Unter bestimmten Umständen, wie z. B. bei extrem speicherintensiven Workloads in der VM, fällt die Live-Migration in den Standardmodus zurück und hält 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 VM-Parameter sein, die am Anfang dieses Abschnitts aufgeführt sind.

vm-pause

xe vm-pause
Eine laufende VM anhalten. Beachten Sie, dass dieser Vorgang den zugeordneten Speicher nicht freigibt (siehe vm-suspend).

vm-reboot

xe vm-reboot [vm-selector=vm_selector_value...] [force=true]
Die angegebenen VMs neu starten.
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 VM-Parameter sein, die am Anfang dieses Abschnitts aufgeführt sind.
Verwenden Sie das Argument force, um einen unsauberen Neustart zu erzwingen. Dabei ist das Herunterfahren vergleichbar mit dem Ziehen des Steckers bei einem physischen Server.

vm-recover

xe vm-recover vm-uuid [database] [vdi-uuid] [force]
Stellt eine VM aus der in der bereitgestellten VDI enthaltenen Datenbank wieder her.

vm-reset-powerstate

xe vm-reset-powerstate [vm-selector=vm_selector_value...] {force=true}
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 VM-Parameter sein, die am Anfang dieses Abschnitts aufgeführt sind.
Dies ist ein erweiterter Befehl, der nur verwendet werden sollte, wenn ein Mitgliedshost in einem Pool ausfällt. Sie können diesen Befehl verwenden, um den Pool-Koordinator zu zwingen, den Energiestatus der VMs auf halted zurückzusetzen. Im Wesentlichen erzwingt dieser Befehl die Sperre der VM und ihrer Festplatten, sodass sie als Nächstes auf einem anderen Pool-Host gestartet werden kann. Dieser Aufruf erfordert die Angabe des Force-Flags und schlägt fehl, wenn es nicht in der Befehlszeile vorhanden ist.

vm-restart-device-models

xe vm-restart-device-models [vm-selector=vm_selector_value...]
Starten Sie das Gerätemodell für diese VM auf dem Host neu. Während das Gerätemodell neu gestartet wird, können Sie die VM nicht anhalten, starten oder migrieren. Der Endbenutzer der VM könnte eine leichte Pause und Wiederaufnahme in seiner Sitzung bemerken.
Hinweis:
Damit die Aktion zum Neustart des Gerätemodells auf einer Windows-VM unterstützt wird, muss die VM die XenServer VM Tools für Windows installiert haben.

vm-resume

xe vm-resume [vm-selector=vm_selector_value...] [force=true|false] [on=host_uuid]
Setzen Sie 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 VM-Parameter sein, die am Anfang dieses Abschnitts aufgeführt sind.
Wenn sich die VM auf einem freigegebenen SR in einem Host-Pool befindet, verwenden Sie das Argument on, um anzugeben, auf welchem Pool-Mitglied sie gestartet werden soll. Standardmäßig ermittelt das System einen geeigneten Host, der jedes der Mitglieder des Pools sein kann.

vm-retrieve-wlb-recommendations

xe vm-retrieve-wlb-recommendations
Rufen Sie die Empfehlungen zur Workload-Balance für die ausgewählte VM ab.

vm-shutdown

xe vm-shutdown [vm-selector=vm_selector_value...] [force=true|false]
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 VM-Parameter sein, die am Anfang dieses Abschnitts aufgeführt sind.
Verwenden Sie das Argument force, um ein unsauberes Herunterfahren zu erzwingen, ähnlich dem Ziehen des Steckers bei einem physischen Server.

vm-snapshot

xe vm-snapshot new-name-label=name_label [new-name-description+name_description]
Erstellen Sie einen Snapshot einer vorhandenen VM, wobei, falls verfügbar, eine schnelle Datenträger-Snapshot-Operation auf Speicherebene verwendet wird.

vm-start

xe vm-start [vm-selector=vm_selector_value...] [force=true|false] [on=host_uuid] [--multiple]
Starten Sie 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 VM-Parameter sein, die am Anfang dieses Abschnitts aufgeführt sind.
Wenn sich die VMs auf einem freigegebenen SR in einem Host-Pool befinden, verwenden Sie das Argument on, um anzugeben, auf welchem Pool-Mitglied die VMs gestartet werden sollen. Standardmäßig bestimmt das System einen geeigneten Host, der jedes der Mitglieder des Pools sein kann.

vm-suspend

xe vm-suspend [vm-selector=vm_selector_value...]
Halten Sie die angegebene VM 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 VM-Parameter sein, die am Anfang dieses Abschnitts aufgeführt sind.

vm-uninstall

xe vm-uninstall [vm-selector=vm_selector_value...] [force=true|false]
Deinstallieren Sie eine VM und zerstören Sie deren Datenträger (die VDIs, die als RW markiert und nur mit dieser VM verbunden sind) zusätzlich zu ihrem Metadaten-Eintrag. Um nur die VM-Metadaten zu zerstören, 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 VM-Parameter sein, die am Anfang dieses Abschnitts aufgeführt sind.

vm-unpause

xe vm-unpause
Eine angehaltene VM fortsetzen.

vm-vcpu-hotplug

xe vm-vcpu-hotplug new-vcpus=new_total_vcpu_count [vm-selector=vm_selector_value...]
Passen Sie die Anzahl der vCPUs, die einer laufenden Linux-VM zur Verfügung stehen, dynamisch an. Die Anzahl der vCPUs wird durch den Parameter VCPUs-max begrenzt. Windows-VMs laufen immer mit der auf VCPUs-max eingestellten Anzahl von vCPUs und müssen neu gestartet werden, um diesen Wert zu ändern.
Verwenden Sie den Parameter new-vcpus, um die neue Gesamtanzahl der vCPUs zu definieren, die Sie nach 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 über den Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl der VM-Parameter sein, die am Anfang dieses Abschnitts aufgeführt sind.
Hinweis:
Wenn Sie Linux-VMs ohne installierte XenServer VM Tools ausführen, führen Sie den folgenden Befehl auf der VM als root aus, um sicherzustellen, dass die neu Hot-Plug-fähigen 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...]
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-Einträgen und nicht mit den VIF-Werten. Optionale Argumente können eine beliebige Anzahl der VM-Parameter sein, die am Anfang dieses Abschnitts aufgeführt sind.

Geplante Snapshots

Befehle zur Steuerung von geplanten VM-Snapshots und deren Attributen.
Die vmss-Objekte können mit dem Standardbefehl zur Objektlistung (xe vmss-list) aufgelistet und die Parameter mit den Standard-Parameterbefehlen manipuliert werden. Weitere Informationen finden Sie unter Low-level parameter commands

vmss-create

xe vmss-create enabled=true/false name-label=name type=type frequency=frequency retained-snapshots=value name-description=description schedule:schedule
Erstellt einen Snapshot-Zeitplan im Pool.
Zum 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
Snapshot-Zeitpläne haben die folgenden Parameter:
Parametername Beschreibung Typ
name-label Name des Snapshot-Zeitplans. Lesen/Schreiben
name-description Beschreibung des Snapshot-Zeitplans. Lesen/Schreiben
type Festplatten-Snapshot oder Speicher-Snapshot. Lesen/Schreiben
frequency Stündlich; Täglich; Wöchentlich Lesen/Schreiben
retained-snapshots Beizubehaltende Snapshots. Bereich: 1-10. Lesen/Schreiben
schedule schedule:days (Montag bis Sonntag), schedule:hours (0 bis 23), schedule:minutes (0, 15, 30, 45) Lesen/Schreiben

vmss-destroy

xe vmss-destroy uuid=uuid
Zerstört einen Snapshot-Zeitplan im Pool.

USB-Passthrough

USB-Passthrough wird für die folgenden USB-Versionen unterstützt: 1.1, 2.0 und 3.0.

USB-Passthrough aktivieren/deaktivieren

xe pusb-param-set uuid=pusb_uuid passthrough-enabled=true/false
USB-Passthrough aktivieren/deaktivieren.

pusb-scan

xe pusb-scan host-uuid=host_uuid
PUSB scannen und aktualisieren.

vusb-create

xe vusb-create usb-group-uuid=usb_group_uuid vm-uuid=vm_uuid
Erstellt einen virtuellen USB im Pool. Starten Sie die VM, um den USB an die VM weiterzuleiten.

vusb-unplug

xe vusb-unplug uuid=vusb_uuid
Trennt USB von der VM.

vusb-destroy

xe vusb-destroy uuid=vusb_uuid
Entfernt die virtuelle USB-Liste von der VM.

VM-Gruppenbefehle

Befehle zur Steuerung von VM-Gruppen und deren Attributen.

VM-Gruppenparameter

  • uuid (schreibgeschützt) der eindeutige Bezeichner/Objektreferenz für die VM
  • name-label (read/write) der Name der VM
  • name-description (read/write) die Beschreibung der VM
  • placement (read only) der Typ der Platzierungsregeln, die auf VMs in der Gruppe angewendet werden sollen. Die verfügbaren Werte sind anti-affinity und normal.

vm-group-list

xe vm-group-list
Listet alle VM-Gruppen in diesem Pool auf.

vm-group-create

xe vm-group-create placement=anti-affinity|normal name-label=<name-label> [name-description=<name-description>]
Erstellt eine VM-Gruppe.

vm-group-destroy

xe vm-group-destroy uuid=<vm-group-uuid>
Löscht diese VM-Gruppe. Wenn Sie eine VM-Gruppe löschen, die VMs enthält, sind die VMs keiner Gruppe mehr zugeordnet, bleiben aber ansonsten unbeeinflusst.