Befehlszeilenoberfläche
Mit der xe CLI können Sie Systemadministrationsaufgaben über Skripts ausführen und automatisieren. Verwenden Sie die Befehlszeilenschnittstelle, um Citrix Hypervisor in eine vorhandene IT-Infrastruktur zu integrieren.
Installieren der xe CLI
Die Xe-Befehlszeilenschnittstelle ist standardmäßig auf allen Citrix Hypervisor-Servern installiert und in XenCenter enthalten. Eine eigenständige Remote-Befehlszeilenschnittstelle ist auch für Linux verfügbar.
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 ändern Sie die Verzeichnisse in das Verzeichnis, in dem die Datei xe.exe
ist (in der Regel C:\Program Files\Citrix\XenCenter
). Wenn Sie den Installationspfad von xe.exe
zu Ihrem Systempfad hinzufügen, können Sie den Befehl verwenden, ohne in das Verzeichnis wechseln zu müssen.
Unter Linux
Auf RPM-basierten Distributionen (z. B. Red Hat) können Sie den eigenständigen xe-Befehl aus dem RPM installieren, der client_install/xapi-xe-BUILD.x86_64.rpm
auf dem Citrix Hypervisor Hauptinstallations-ISO benannt ist.
Um vom 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 Citrix Hypervisor-Server, den Benutzernamen und das Kennwort für die Ausführung von xe-Befehlen zu definieren. Sie haben jedoch auch die Möglichkeit, diese Informationen als Umgebungsvariable festzulegen. Beispiel:
export XE_EXTRA_ARGS="server=<host name>,username=<user name>,password=<password>"
Hinweis:
Die Remote xe CLI unter Linux hängt möglicherweise ab, wenn Sie versuchen, Befehle über eine sichere Verbindung auszuführen, und diese Befehle beinhalten eine Dateiübertragung. In diesem Fall können Sie den Befehl mit dem Parameter
--no-ssl
über eine unsichere Verbindung zum Citrix Hypervisor-Server ausführen.
Hilfe mit xe-Befehlen erhalten
Grundlegende Hilfe ist für CLI-Befehle auf dem Host verfügbar, indem Sie Folgendes eingeben:
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 Citrix Hypervisor xe CLI-Befehle lautet:
xe command-name argument=value argument=value
Jeder spezifische Befehl enthält einen eigenen Satz von Argumenten, die das Format argument=value
haben. Einige Befehle verfügen über erforderliche Argumente, und die meisten haben einige optionale Argumente. Normalerweise nimmt ein Befehl Standardwerte für einige der optionalen Argumente an, wenn er ohne sie aufgerufen wird.
Wenn der xe-Befehl remote ausgeführt wird, werden zusätzliche Argumente verwendet, um sich zu verbinden und zu authentifizieren. Diese Argumente haben auch die Form argument=argument_value
.
Das server
Argument wird verwendet, um den Hostnamen oder die IP-Adresse anzugeben. Die username
Argumente password
und werden verwendet, um Anmeldeinformationen anzugeben.
Anstelle des Kennworts kann direkt ein password-file
Argument angegeben werden. In diesem Fall versucht der xe-Befehl, das Kennwort aus der angegebenen Datei zu lesen und verwendet dieses Kennwort, um eine Verbindung herzustellen. (Alle nachgestellten CRs und LFs am Ende der Datei werden entfernt.) Diese Methode ist sicherer als die Angabe des Kennworts direkt in der Befehlszeile.
Das optionale port
Argument kann verwendet werden, um den Agent-Port auf dem Citrix Hypervisor -Remote-Server anzugeben (standardmäßig 443).
Beispiel: Auf dem lokalen Citrix Hypervisor-Server:
xe vm-list
Beispiel: Auf dem Citrix Hypervisor -Remote-Server:
xe vm-list -user username -password password -server hostname
Die Shorthand Syntax ist auch für Remoteverbindungsargumente verfügbar:
-
-u
Benutzername -
-pw
Kennwort -
-pwf
Kennwortdatei -
-p
Port -
-s
Server
Beispiel: Auf einem Citrix Hypervisor -Remote-Server:
xe vm-list -u myuser -pw mypassword -s hostname
Argumente werden auch aus der Umgebungsvariablen XE_EXTRA_ARGS in Form von durch Kommas getrennten Schlüssel/Wert-Paaren entnommen. Um beispielsweise Befehle einzugeben, die auf einem Citrix Hypervisor -Remote-Server ausgeführt werden, führen Sie zuerst den folgenden Befehl aus:
export XE_EXTRA_ARGS="server=jeffbeck,port=443,username=root,password=pass"
Nachdem Sie diesen Befehl ausgeführt haben, müssen Sie nicht mehr in jedem von Ihnen ausgeführten xe-Befehl die Parameter des Citrix Hypervisor-Servers angeben.
Die Verwendung der Umgebungsvariablen XE_EXTRA_ARGS ermöglicht auch die Tabulatorvervollständigung von xe-Befehlen, wenn sie für einen Citrix Hypervisor -Remote-Server ausgegeben werden, der standardmäßig deaktiviert ist.
Sonderzeichen und Syntax
Um Argument-/Wert-Paare in der xe
-Befehlszeile anzugeben, schreiben Sie: argument=value
Verwenden Sie keine Anführungszeichen, es sei denn, der Wert enthält Leerzeichen. Zwischen dem Argumentnamen, dem Gleichheitszeichen (=) und dem Wert sollte kein Leerzeichen vorhanden sein. Alle Argumente, die diesem Format nicht entsprechen, werden ignoriert.
Für Werte, die Leerzeichen enthalten, schreiben Sie: argument="value with spaces"
Wenn Sie die Befehlszeilenschnittstelle auf dem Citrix Hypervisor-Server verwenden, verfügen Befehle über eine Tabulatorvervollständigung, die der Funktion in der Standard-Linux-Bash-Shell ähnelt. Wenn Sie beispielsweise xe vm-l
eingeben und dann die TAB-TASTE drücken, wird der Rest des Befehls angezeigt. Wenn mehr als ein Befehl mit vm-l
beginnt, werden die Möglichkeiten aufgelistet, wenn Sie ein zweites Mal die TAB drücken. Diese Funktion ist nützlich, wenn Objekt-UUIDs in Befehlen angegeben werden.
Hinweis:
Die Tabulatorvervollständigung funktioniert normalerweise nicht, wenn Befehle auf einem Citrix Hypervisor -Remote-Server ausgeführt werden. Wenn Sie jedoch die Variable XE_EXTRA_ARGS auf dem Computer festlegen, auf dem Sie die Befehle eingeben, ist die Tabulatorvervollständigung aktiviert. Weitere Informationen finden Sie unter Grundlegende xe-Syntax.
Befehlstypen
Die CLI-Befehle können in zwei Hälften geteilt werden. Low-Level-Befehle befassen sich mit dem Auflisten und der Parameter-Manipulation von API-Objekten. Befehle auf höherer Ebene werden verwendet, um mit VMs oder Hosts in einer abstrakteren Ebene zu interagieren.
Die Low-Level-Befehle lauten:
-
Klasse-Liste
-
Klasse-param-get
-
Klasse-param-set
-
Klasse-param-list
-
Klasse-param-add
-
Klasse-param-remove
-
Klasse-param-clear
Wo Klasse ist eine von:
-
bond
-
console
-
host
-
host-crashdump
-
host-cpu
-
network
-
patch
-
pbd
-
pif
-
pool
-
sm
-
sr
-
task
-
template
-
vbd
-
vdi
-
vif
-
vlan
-
vm
Nicht jeder Wert der Klasse hat den vollständigen Satz von Klassen-param-**Aktionsbefehlen. Einige Werte der Klasse haben einen kleineren Satz von Befehlen.
Parameter-Typen
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 einzigen Wert. Beispielsweise enthält der Parameter name-label
einer VM einen einzelnen Zeichenfolgenwert. In der Ausgabe von Parameterlistenbefehlen, z. B. xe vm-param-list
, gibt ein Wert in Klammern an, ob Parameter schreibgeschützt (RW) oder schreibgeschützt (RO) sind.
Die Ausgabe von xe vm-param-list
auf einer angegebenen VM hat möglicherweise die folgenden Zeilen:
user-version ( RW): 1
is-control-domain (RO): false
Der erste Parameter, user-version
, ist beschreibbar und hat den Wert 1. Die zweite, is-control-domain
, ist schreibgeschützt und hat den Wert false.
Die beiden anderen Parametertypen sind mehrwertig. Ein eingestellter Parameter enthält eine Liste von Werten. Ein Map-Parameter ist ein Satz von Schlüssel/Wert-Paaren. Sehen Sie sich beispielsweise die folgende Beispielausgabe des xe vm-param-list
auf einer angegebenen VM an:
Plattform (MRW): acpi: true; apic: true; pae: true; nx: false
Allowed-Operations (SRO): pausieren; clean_shutdown; clean_reboot; \
hard_shutdown; hard_reboot; suspendieren
Der Parameter platform
enthält eine Liste von Elementen, die Schlüssel/Wert-Paare darstellen. Den Schlüsselnamen folgt ein Doppelpunkt (:). Jedes Schlüssel/Wert-Paar wird vom nächsten durch ein Semikolon (;) getrennt. Das M vor dem RW gibt an, dass dieser Parameter ein Map-Parameter ist und lesbar und beschreibbar ist. Der Parameter allowed-operations
verfügt über eine Liste, aus der sich eine Reihe von Elementen zusammensetzt. Das S vor dem RO zeigt an, dass es sich um einen eingestellten Parameter handelt und lesbar ist, aber nicht beschreibbar ist.
Um nach einem Map-Parameter zu filtern oder einen Map-Parameter festzulegen, verwenden Sie einen Doppelpunkt (:), um den Map-Parameternamen und das Schlüssel-Wert-Paar zu trennen. Um beispielsweise den Wert des Schlüssels foo
des Parameters other-config
einer VM auf baa
festzulegen, lautet der Befehl
xe vm-param-set uuid=VM uuid other-config:foo=baa
Hinweis:
In früheren Versionen wurde das Bindestrich (-) verwendet, um Map-Parameter anzugeben. Diese Syntax funktioniert immer noch, ist aber veraltet.
Low-Level-Parameterbefehle
Es gibt mehrere Befehle für die Bedienung von Parametern von Objekten: class-param-get, class-param-set, class-param-add, class-param-remove, class-param-clear und class-param-list. Jeder dieser Befehle verwendet einen Parameter uuid
, um das jeweilige Objekt anzugeben. Da diese Befehle als Low-Level-Befehle betrachtet werden, müssen sie die UUID und nicht das VM-Namenslabel verwenden.
-
class-param-list uuid=uuid
Listet alle Parameter und die zugehörigen Werte auf. Im Gegensatz zum Befehl class-list listet dieser Befehl die Werte von “teuren” Feldern auf.
-
class-param-get uuid=uuid param-name=parameter param-key=key
Gibt den Wert eines bestimmten Parameters zurück. Bei einem Map-Parameter erhält die Angabe des Paramschlüssels den Wert, der diesem Schlüssel in der Karte zugeordnet ist. Wenn param-key nicht angegeben ist oder wenn der Parameter ein Satz ist, gibt der Befehl eine Zeichenfolgendarstellung des Satzes oder der Map zurück.
-
class-param-set uuid=uuid param=value
Legt den Wert eines oder mehrerer Parameter fest.
-
class-param-add uuid=uuid param-name=parameter key=value param-key=key
Fügt entweder zu einer Karte oder einem eingestellten Parameter hinzu. Fügen Sie für einen Map-Parameter Schlüssel/Wert-Paare hinzu, indem Sie die key=value Syntax verwenden. Wenn der Parameter ein Satz ist, fügen Sie Schlüssel mit der Syntax param-key=key hinzu.
-
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.
-
class-param-clear uuid=uuid param-name=parameter
Löscht einen Satz oder eine Karte vollständig.
Low-Level-Listen-Befehle
Der Befehl class-list listet die Objekte vom Typ classauf. Standardmäßig listet dieser Befehlstyp alle Objekte auf, wobei eine Teilmenge der Parameter gedruckt wird. Dieses Verhalten kann auf folgende Weise geändert werden:
- Es kann die Objekte so filtern, dass es nur eine Teilmenge ausgibt
- Die Parameter, die gedruckt werden, können geändert werden.
Um die gedruckten Parameter zu ändern, geben Sie die Argumentparameter als kommagetrennte Liste der erforderlichen Parameter an. Beispiel:
xe vm-list params=name-label,other-config
Alternativ können Sie alle Parameter auflisten, indem Sie die Syntax verwenden:
xe vm-list params=all
Der Befehl list zeigt einige Parameter nicht an, die teuer zu berechnen sind. Diese Parameter werden wie folgt dargestellt:
allowed-VBD-devices (SRO): <expensive field>
Um diese Felder zu erhalten, verwenden Sie entweder die Befehlsklasse-param-list oder die Klasse-param-get
Zum Filtern der Liste stimmt die CLI Parameterwerte mit den in der Befehlszeile angegebenen Werten überein. Es werden nur Objekte gedruckt, die allen angegebenen Einschränkungen entsprechen. Beispiel:
xe vm-list HVM-boot-policy="BIOS order" power-state=halted
Dieser Befehl listet nur die VMs auf, für die sowohl das Feld power-state
den Wert angehalten hat als auch das Feld HVM-boot-policy
den Wert für die BIOS-Reihenfolgeaufweist.
Sie können die Liste auch nach dem Wert von Schlüsseln in Karten oder nach dem Vorhandensein von Werten in einem Satz filtern. Die Syntax für die Filterung basierend auf Schlüsseln in Maps lautet map-name:key=value
. Die Syntax für die Filterung basierend auf Werten, die in einem Satz vorhanden sind, lautet set-name:contains=value
.
Bei der Skripterstellung wird eine nützliche Technik --minimal
über die Befehlszeile übergeben, die xe
dazu führt, dass nur das erste Feld in einer durch Kommas getrennten Liste gedruckt wird. Beispielsweise gibt der Befehl xe vm-list --minimal
auf einem Host mit drei installierten VMs die drei UUIDs der VMs an:
a85d6717-7264-d00e-069b-3b1d19d56ad9,aaa3eec5-9499-bcf3-4c03-af10baea96b7, \
42c044de-df69-4b30-89d9-2c199564581d
Geheimnisse
Citrix Hypervisor bietet einen Geheimmechanismus, um zu vermeiden, dass Kennwörter im Befehlszeilenverlauf oder in API-Objekten im Klartext gespeichert werden. XenCenter verwendet diese Funktion automatisch und kann auch von der xe CLI für alle Befehle verwendet werden, die ein Kennwort erfordern.
Hinweis:
Kennwortgeheimnisse können nicht für die Authentifizierung mit einem Citrix Hypervisor Host von einer Remoteinstanz der xe CLI verwendet werden.
Führen Sie den folgenden Befehl auf dem Citrix Hypervisor Host aus, um ein geheimes Objekt zu erstellen.
xe secret-create value=my-password
Auf dem Citrix Hypervisor Host wird ein geheimer Schlüssel erstellt und gespeichert. Der Befehl gibt die UUID des geheimen Objekts aus. Beispiel: 99945d96-5890-de2a-3899-8c04ef2521db
. Fügen _secret
Sie den Namen des Kennwortarguments an, um diese UUID an einen Befehl zu übergeben, der ein Kennwort erfordert.
Beispiel: Auf dem Citrix Hypervisor Host, auf dem Sie den geheimen Schlüssel 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"
Befehlshistorie
Einige xe-Befehle, zum Beispiel xe vm-migrate
oder xe pool-enable-external-auth
, nehmen Geheimnisse wie Passwörter als Parameter. Diese können in der Shell-Historie enden und während der Ausführung des Befehls sind in der Prozesstabelle sichtbar. Daher ist es wichtig, diese Befehle nur in vertrauenswürdigen Umgebungen auszuführen.
Für die Bash-Shell können Sie die HISTCONTROL
Variable verwenden, um zu steuern, welche Befehle in der Shell-Historie gespeichert werden.
Xe-Befehlsreferenz
In diesem Abschnitt werden die Befehle nach den Objekten gruppiert, die der Befehl adressiert. Diese Objekte werden alphabetisch aufgelistet.
Appliance-Befehle
Befehle zum Erstellen und Ändern von VM-Appliances (auch als vApps bezeichnet). Weitere Informationen finden Sie unter vApps.
Appliance-Parameter
Appliance-Befehle haben die folgenden Parameter:
Parametername | Beschreibung | Typ |
---|---|---|
uuid |
Die Appliance-UUID | Erforderlich |
name-description |
Beschreibung der Appliance | Optional |
paused |
Optional | |
force |
Herunterfahren erzwingen | Optional |
appliance-assert-can-be-recovered
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
appliance-create name-label=name-label [name-description=name-description]
Erstellt eine Appliance/vApp. Beispiel:
xe appliance-create name-label=my_appliance
Fügen Sie VMs zur Appliance hinzu:
xe vm-param-set uuid=VM-UUID appliance=appliance-uuid
appliance-destroy
appliance-destroy uuid=appliance-uuid
Zerstört eine Appliance/VApp. Beispiel:
xe appliance-destroy uuid=appliance-uuid
appliance-recover
appliance-recover uuid=appliance-uuid database:vdi-uuid=vdi-uuid [paused=true|false]
Stellen Sie eine VM-Appliance/vApp aus der Datenbank wieder her, die im bereitgestellten VDI enthalten ist.
appliance-shutdown
appliance-shutdown uuid=appliance-uuid [force=true|false]
Beenden Sie alle VMs in einer Appliance/vApp. Beispiel:
xe appliance-shutdown uuid=appliance-uuid
appliance-start
appliance-start uuid=appliance-uuid [paused=true|false]
Startet eine Appliance/vApp. Beispiel:
xe appliance-start uuid=appliance-uuid
Audit-Befehle
Überwachungsbefehle laden alle verfügbaren Datensätze der RBAC-Überwachungsdatei im Pool herunter. Wenn der optionale Parameter since
vorhanden ist, werden nur die Datensätze von diesem bestimmten Zeitpunkt heruntergeladen.
audit-log-get
Parameter
audit-log-get
hat die folgenden Parameter
Parametername | Beschreibung | Typ |
---|---|---|
filename |
Schreiben Sie das Überwachungsprotokoll des Pools in den Dateinamen | Erforderlich |
since |
Spezifischer Datums-/Uhrzeitpunkt | Optional |
audit-log-get
audit-log-get [since=timestamp] filename=filename
Um beispielsweise Überwachungsdatensätze des Pools seit einem genauen Millisekundenzeitstempel zu erhalten, 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 Netzwerkverbindungen, für die Ausfallsicherheit mit physikalischem Schnittstellen-Failover. Weitere Informationen finden Sie unter Netzwerke.
Das Bond-Objekt ist ein Referenzobjekt, das Master- und Element-PIFs zusammenklebt. Der Master PIF ist die Bonding-Schnittstelle, die als Gesamt-PIF verwendet werden muss, um sich auf die Bindung zu beziehen. Die Member-PIFs sind ein Satz von zwei oder mehr physikalischen Schnittstellen, die in der High-Level-Bonded Interface kombiniert wurden.
Bindungsparameter
Bindungen haben folgende Parameter:
Parametername | Beschreibung | Typ |
---|---|---|
uuid |
Eindeutige Identifikator/Objektreferenz für die Bindung | Lesezugriff |
master |
UUID für die Masterbindungs-PIF | Lesezugriff |
members |
Satz von UUIDs für die zugrunde liegenden gebundenen PIFs | Lesezugriff |
bond-create
bond-create network-uuid=network_uuid pif-uuids=pif_uuid_1,pif_uuid_2,...
Erstellen Sie eine gebundene Netzwerkschnittstelle im Netzwerk, das aus einer Liste vorhandener PIF-Objekte angegeben wird. Der Befehl schlägt in einem der folgenden Fälle fehl:
- Wenn PIFs bereits in einer anderen Bindung sind
- Wenn ein Mitglied ein VLAN-Tag festgelegt hat
- Wenn sich die referenzierten PIFs nicht auf demselben Citrix Hypervisor-Server befinden
- Wenn weniger als 2 PIFs geliefert werden
bond-destroy
bond-destroy uuid=bond_uuid
Löscht eine gebundene Schnittstelle, die durch ihre UUID angegeben wird, von einem Host.
bond-set-mode
bond-set-mode uuid=bond_uuid mode=bond_mode
Ändern Sie den Bindungsmodus.
CD-Befehle
Befehle zum Arbeiten mit physischen CD/DVD-Laufwerken auf Citrix Hypervisor-Servern.
CD-Parameter
CDs haben folgende Parameter:
Parametername | Beschreibung | Typ |
---|---|---|
uuid |
Eindeutige Kennung/Objektreferenz für die CD | Lesezugriff |
name-label |
Name für die CD | Lese-/Schreibrechte |
name-description |
Beschreibungstext für die CD | Lese-/Schreibrechte |
allowed-operations |
Eine Liste der Vorgänge, die auf dieser CD ausgeführt werden können | Schreibgeschützte Parameter festlegen |
current-operations |
Eine Liste der Vorgänge, die derzeit auf dieser CD ausgeführt werden | Schreibgeschützte Parameter festlegen |
sr-uuid |
Die eindeutige Identifikator/Objektreferenz für die SR, die diese CD Teil von | Lesezugriff |
sr-name-label |
Der Name für die SR dieser CD ist Teil von | Lesezugriff |
vbd-uuids |
Eine Liste der eindeutigen Bezeichner für die VBDs auf VMs, die eine Verbindung zu dieser CD herstellen | Schreibgeschützte Parameter festlegen |
crashdump-uuids |
Nicht auf CDs verwendet. Da Crashdumps nicht auf CDs geschrieben werden können | Schreibgeschützte Parameter festlegen |
virtual-size |
Größe der CD, wie sie für VMs angezeigt wird (in Bytes) | Lesezugriff |
physical-utilisation |
Menge des physischen Speicherplatzes, den das CD-Image auf dem SR belegt (in Bytes) | Lesezugriff |
type |
Auf Benutzer für CDs festlegen | Lesezugriff |
sharable |
Gibt an, ob das CD-Laufwerk freigebbar ist oder nicht. Die Standardeinstellung ist false . |
Lesezugriff |
read-only |
Gibt an, ob die CD schreibgeschützt ist false , wenn das Gerät beschreibbar ist. Immer wahr für CDs. |
Lesezugriff |
storage-lock |
Der Wert ist true , wenn dieser Datenträger auf Speicherebene gesperrt ist. |
Lesezugriff |
parent |
Verweis auf die übergeordnete Festplatte, wenn diese CD Teil einer Kette ist. | Lesezugriff |
missing |
Der Wert ist true , wenn der SR-Scanvorgang gemeldet hat, dass diese CD nicht auf der Festplatte vorhanden ist. |
Lesezugriff |
other-config |
Eine Liste von Schlüssel/Wert-Paaren, die zusätzliche Konfigurationsparameter für die CD angeben | Map-Parameter mit Lese-/Schreibzugriff |
location |
Der Pfad, auf dem das Gerät eingehängt ist | Lesezugriff |
managed |
Wert ist true , wenn das Gerät verwaltet wird |
Lesezugriff |
xenstore-data |
Daten, die in den xenstore Baum eingefügt werden sollen |
Schreibgeschützte Map-Parameter |
sm-config |
Namen und Beschreibungen von Speichermanager-Gerätekonfigurationsschlüsseln | Schreibgeschützte Map-Parameter |
is-a-snapshot |
Wert ist true , wenn diese Vorlage ein CD-Snapshot ist |
Lesezugriff |
snapshot_of |
Die UUID der CD, bei der diese Vorlage ein Snapshot von | Lesezugriff |
snapshots |
Die UUIDs aller Snapshots, die von dieser CD aufgenommen wurden | Lesezugriff |
snapshot_time |
Der Zeitstempel des Snapshot-Vorgangs | Lesezugriff |
cd-list
cd-list [params=param1,param2,...] [parameter=parameter_value]
Führen Sie die CDs und ISOs (CD-Imagedateien) auf dem Citrix Hypervisor-Server oder -Pool auf, wobei das optionale Argument gefiltert wird 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 Standard-Teilmenge aller verfügbaren Parameter an.
Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten CD-Parameter sein.
Cluster-Befehle
Befehle zum Arbeiten mit gruppierten Pools.
Clustered Pools sind Ressourcenpools, für die die Clustering-Funktion aktiviert ist. Verwenden Sie diese Pools mit GFS2 SRs. Weitere Informationen finden Sie unter Clusterpools
Die Cluster- und Cluster-Host-Objekte können mit den Standard-Objektauflistungsbefehlen (xe cluster-list
und xe cluster-host-list
) und mit den Standardparameter-Befehlen manipulierten Parametern aufgelistet werden. Weitere Informationen finden Sie unter Low-Level-Parameterbefehle.
Befehle zum Arbeiten mit gruppierten Pools.
Cluster-Parameter
Cluster haben die folgenden Parameter:
Parametername | Beschreibung | Typ |
---|---|---|
uuid |
Der eindeutige Bezeichner/Objektreferenz für den Cluster | Lesezugriff |
cluster-hosts |
Eine Liste eindeutiger Bezeichner/Objektreferenzen für die Hosts im Cluster | Schreibgeschützte Parameter festlegen |
cluster-token |
Der geheime Schlüssel, der verwendet wird xapi-clusterd , wenn er mit sich selbst auf anderen Hosts spricht |
Lesezugriff |
cluster-stack |
Der Technologie-Stack, der die Clustering-Funktionen bereitstellt. Mögliche Werte sind corosync . |
Lesezugriff |
allowed-operations |
Listet die Vorgänge auf, die in diesem Status zulässig sind. Diese Liste ist nur beratend, und der Clusterstatus hat sich möglicherweise geändert, wenn ein Client dieses Feld liest. | Schreibgeschützte Parameter festlegen |
current-operations |
Listet die derzeit in Bearbeitung befindlichen Vorgänge auf. Diese Liste ist nur beratend, und der Clusterstatus hat sich möglicherweise geändert, wenn ein Client dieses Feld liest. | Schreibgeschützte Parameter festlegen |
token-timeout |
Das corosync Token-Timeout in Sekunden |
Lesezugriff |
token-timeout-coefficient |
Der corosync Token-Timeout-Koeffizient in Sekunden |
Lesezugriff |
pool-auto-join |
True, wenn neue Poolmitglieder automatisch mit dem Cluster verbunden werden. Dies ist auf eingestellt true . |
Lesezugriff |
cluster-config |
Eine Liste von Schlüssel/Wert-Paaren, die zusätzliche Konfigurationsparameter für den Cluster angeben. | Schreibgeschützte Map-Parameter |
other-config |
Eine Liste von Schlüssel/Wert-Paaren, die zusätzliche Konfigurationsparameter für den Cluster angeben. | Map-Parameter mit Lese-/Schreibzugriff |
cluster-host-create
cluster-host-create cluster-uuid=cluster_uuid host-uuid=host_uuid pif-uuid=pif_uuid
Fügen Sie einem vorhandenen Cluster einen Host hinzu.
cluster-host-destroy
cluster-host-destroy uuid=host_uuid
Zerstören Sie einen Clusterhost und verlassen Sie den Cluster effektiv.
cluster-host-disable
cluster-host-disable uuid=cluster_uuid
Deaktivieren Sie die Cluster-Mitgliedschaft für einen aktivierten Clusterhost.
cluster-host-enable
cluster-host-enable uuid=cluster_uuid
Aktivieren der Clustermitgliedschaft für einen deaktivierten Clusterhost.
cluster-host-force-destroy
cluster-host-force-destroy uuid=cluster_host
Zerstören Sie ein Cluster-Host-Objekt mit Nachdruck und verlassen Sie den Cluster effektiv.
cluster-pool-create
cluster-pool-create network-uuid=network_uuid [cluster-stack=cluster_stack] [token-timeout=token_timeout] [token-timeout-coefficient=token_timeout_coefficient]
Erstellen Sie einen poolweiten Cluster.
cluster-pool-destroy
cluster-pool-destroy cluster-uuid=cluster_uuid
Zerstören Sie den poolweiten Cluster. Der Pool existiert weiterhin, ist jedoch nicht mehr gruppiert und kann keine GFS2-SRs mehr verwenden.
cluster-pool-force-destroy
cluster-pool-force-destroy cluster-uuid=cluster_uuid
Erzwingt das Löschen des poolweiten Clusters.
cluster-pool-resync
cluster-pool-resync cluster-uuid=cluster_uuid
Synchronisieren Sie einen Cluster über einen Pool hinweg.
Konsolen-Befehle
Befehle zum Arbeiten mit Konsolen.
Die Konsolenobjekte können mit dem Standard-Objektlistenbefehl (xe console-list
) aufgelistet und mit den Standardparameterbefehlen manipuliert werden. Weitere Informationen finden Sie unter Low-Level-Parameterbefehle.
Konsolen-Parameter
Konsolen haben die folgenden Parameter:
Parametername | Beschreibung | Typ |
---|---|---|
uuid |
Die eindeutige Identifikator/Objektreferenz für die Konsole | Lesezugriff |
vm-uuid |
Die eindeutige Kennung/Objektreferenz der VM, auf der diese Konsole geöffnet ist | Lesezugriff |
vm-name-label |
Der Name der VM, auf der diese Konsole geöffnet ist | Lesezugriff |
protocol |
Protokoll, das diese Konsole verwendet. Mögliche Werte sind vt100 : VT100-Terminal, rfb : Remote Framebuffer Protocol (wie in VNC verwendet) oder rdp : Remote Desktop Protocol |
Lesezugriff |
location |
URI für den Konsolendienst | Lesezugriff |
other-config |
Eine Liste von Schlüssel/Wert-Paaren, die zusätzliche Konfigurationsparameter für die Konsole angeben. | Map-Parameter mit Lese-/Schreibzugriff |
console
console
An eine bestimmte Konsole anhängen.
Diagnosebefehle
Befehle zum Sammeln von Diagnoseinformationen von Citrix Hypervisor.
diagnostic-compact
diagnostic-compact
Führen Sie eine große GC-Sammlung und Heap-Komprimierung durch.
VERALTET: diagnostic-db-log
diagnostic-db-log
Starten Sie die Protokollierung der Datenbankvorgänge. Warnung: Einmal gestartet, kann dies nicht gestoppt werden.
diagnostic-db-stats
diagnostic-db-stats
Datenbankstatistiken drucken.
diagnostic-gc-stats
diagnostic-gc-stats
GC-Statistiken drucken.
diagnostic-license-status
diagnostic-license-status
Hilfe bei der Diagnose von Pool-weiten Lizenzierungsproblemen.
diagnostic-net-stats
diagnostic-net-stats [uri=uri] [method=method] [params=param1,param2...]
Drucken Sie Netzwerkstatistiken.
diagnostic-timing-stats
diagnostic-timing-stats
Zeitstatistiken drucken.
diagnostic-vdi-status
diagnostic-vdi-status uuid=vdi_uuid
Fragen Sie den Sperr- und Freigabestatus eines VDI ab.
diagnostic-vm-status
diagnostic-vm-status uuid=vm_uuid
Fragen Sie die Hosts ab, auf denen die VM booten kann, und überprüfen Sie den Freigabe/Sperrstatus aller VBDs.
Befehle zur Notfallwiederherstellung
Befehle zum Wiederherstellen von VMs nach einem Notfall
drtask-create
drtask-create type=type sr-whitelist=sr-white-list device-config=device-config
Erstellt einen Notfall-Wiederherstellungs-Task. Zum Beispiel, um eine Verbindung zu einem iSCSI-SR in Vorbereitung auf die Notfallwiederherstellung herzustellen:
xe drtask-create type=lvmoiscsi device-config:target=target-ip-address \
device-config:targetIQN=targetIQN device-config:SCSIid=SCSIid \
sr-whitelist=sr-uuid-list
Hinweis:
Der Befehl
sr-whitelist
listet zulässige SR-UUIDs auf. Derdrtask-create
Befehl führt nur eine SR ein und stellt eine Verbindung mit einer der zulässigen UUIDs her.
drtask-destroy
drtask-destroy uuid=dr-task-uuid
Zerstört eine Disaster Recovery-Aufgabe und vergisst die eingeführte SR.
vm-assert-can-be-recovered
vm-assert-can-be-recovered uuid=vm-uuid database:vdi-uuid=vdi-uuid
Prüft, ob Speicher zur Wiederherstellung dieser VM verfügbar ist.
appliance-assert-can-be-recovered
appliance-assert-can-be-recovered uuid=appliance-uuid database:vdi-uuid=vdi-uuid
Überprüft, ob der Speicher (der die Appliance/vApp-Festplatte enthält) sichtbar ist.
appliance-recover
appliance-recover uuid=appliance-uuid database:vdi-uuid=vdi-uuid [force=true|false]
Stellen Sie eine Appliance/vApp aus der Datenbank wieder her, die im bereitgestellten VDI enthalten ist.
vm-recover
vm-recover uuid=vm-uuid database:vdi-uuid=vdi-uuid [force=true|false]
Stellt eine VM aus der Datenbank wieder her, die im bereitgestellten VDI enthalten ist.
sr-enable-database-replication
sr-enable-database-replication uuid=sr_uuid
Aktiviert die XAPI-Datenbankreplikation auf die angegebene (gemeinsam genutzte) SR.
sr-disable-database-replication
sr-disable-database-replication uuid=sr_uuid
Deaktiviert die XAPI-Datenbankreplikation auf die angegebene SR.
Beispiel für die Verwendung
Das folgende Beispiel zeigt die DR-CLI-Befehle im Kontext:
Aktivieren Sie am primären Standort die Datenbankreplikation:
xe sr-database-replication uuid=sr=uuid
Stellen Sie nach einem Notfall am sekundären Standort eine Verbindung mit der SR her. Der device-config
Befehl 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 der SR:
xe vdi-list sr-uuid=sr-uuid type=Metadata
Abfrage eines Datenbank-VDI für vorhandene VMs:
xe vm-list database:vdi-uuid=vdi-uuid
Wiederherstellen einer VM:
xe vm-recover uuid=vm-uuid database:vdi-uuid=vdi-uuid
Zerstören Sie die Notfallaufgabe. Alle von der DR-Task eingeführten SRs, die nicht von VMs benötigt werden, werden zerstört:
xe drtask-destroy uuid=drtask-uuid
Ereignisbefehle
Befehle zum Arbeiten mit Ereignissen.
Event-Klassen
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
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 Wert y nimmt” und x=/=y
bedeutet “warten, bis Feld x einen anderen Wert als y nimmt.”
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 aufgerufene VM myvm
für power-state
den Status “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 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 ein beliebiger der am Anfang dieses Abschnitts Ereignis-Klassen aufgeführten sein. Bei den Parametern kann es sich um einen der Parameter handeln, die in der CLI-Befehlsklasse-param-list aufgeführt sind.
GPU-Befehle
Befehle zum Arbeiten mit physischen GPUs, GPU-Gruppen und virtuellen GPUs.
Die GPU-Objekte können mit den standardmäßigen Befehlen der Objektliste aufgelistet werden: xe pgpu-list
, xe gpu-group-list
, und xe vgpu-list
. Die Parameter können mit den Standardparameter-Befehlen bearbeitet werden. Weitere Informationen finden Sie unter Low-Level-Parameterbefehle.
Physikalische GPU-Parameter
Physikalische GPUs (PGPUs) haben folgende Parameter:
Parametername | Beschreibung | Typ |
---|---|---|
uuid |
Die eindeutige Identifikator/Objektreferenz für die PGPU | Lesezugriff |
vendor-name |
Der Herstellername der PGPU | Lesezugriff |
device-name |
Der vom Hersteller diesem PGPU-Modell zugewiesene Name | Lesezugriff |
gpu-group-uuid |
Der eindeutige Bezeichner/Objektreferenz für die GPU-Gruppe, der diese PGPU automatisch von Citrix Hypervisor zugewiesen wurde. Identische PGPUs über Hosts in einem Pool hinweg werden gruppiert | Lesezugriff |
gpu-group-name-label |
Der Name der GPU-Gruppe, der die PGPU zugewiesen ist | Lesezugriff |
host-uuid |
Die eindeutige Kennung/Objektreferenz für den Citrix Hypervisor-Server, mit dem die PGPU verbunden ist | Lesezugriff |
host-name-label |
Der Name des Citrix Hypervisor-Servers, mit dem die PGPU verbunden ist | Lesezugriff |
pci-id |
PCI-Kennung | Lesezugriff |
dependencies |
Listet die abhängigen PCI-Geräte auf, die an dieselbe VM weitergeleitet wurden | Map-Parameter mit Lese-/Schreibzugriff |
other-config |
Eine Liste von Schlüssel/Wert-Paaren, die zusätzliche Konfigurationsparameter für die PGPU angeben | Map-Parameter mit Lese-/Schreibzugriff |
supported-VGPU-types |
Liste der virtuellen GPU-Typen, die von der zugrunde liegenden Hardware unterstützt werden | Lesezugriff |
enabled-VGPU-types |
Liste der virtuellen GPU-Typen, die für diese PGPU aktiviert wurden | Lesen/Schreiben |
resident-VGPUs |
Liste der VGPUs, die auf dieser PGPU ausgeführt werden | Lesezugriff |
pgpu-disable-dom0-access
pgpu-disable-dom0-access uuid=uuid
Deaktivieren Sie den PGPU-Zugriff auf dom0.
pgpu-enable-dom0-access
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 | Lesezugriff |
name-label |
Der Name der GPU-Gruppe | Lese-/Schreibrechte |
name-description |
Der beschreibende Text der GPU-Gruppe | Lese-/Schreibrechte |
VGPU-uuids |
Listet die eindeutigen Bezeichner/Objektreferenzen für die virtuellen GPUs in der GPU-Gruppe auf | Schreibgeschützte Parameter festlegen |
PGPU-uuids |
Listet die eindeutigen Bezeichner/Objektreferenzen für die PGPUs in der GPU-Gruppe auf | Schreibgeschützte Parameter festlegen |
other-config |
Eine Liste von Schlüssel/Wert-Paaren, die zusätzliche Konfigurationsparameter für die GPU-Gruppe angeben | Map-Parameter mit Lese-/Schreibzugriff |
supported-VGPU-types |
Vereinigung aller virtuellen GPU-Typen, die von der zugrunde liegenden Hardware unterstützt werden | Lesezugriff |
enabled-VGPU-types |
Vereinigung aller virtuellen GPU-Typen, die auf den zugrunde liegenden PGPUs aktiviert wurden | Lesezugriff |
allocation-algorithm |
Tiefe-First/Breadth-First-Einstellung für die Zuweisung virtueller GPUs auf PGPUs innerhalb der Gruppe | Enum-Parameter mit Lese-/Schreibzugriff |
GPU-Gruppenoperationen
Befehle zum Arbeiten mit GPU-Gruppen
gpu-group-create
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
gpu-group-destroy uuid=uuid_of_group
Zerstört die GPU-Gruppe; nur für leere Gruppen zulässig.
gpu-group-get-remaining-capacity
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
gpu-group-param-set uuid=uuid_of_group allocation-algorithm=breadth-first|depth-first
Ändert den Algorithmus, den die GPU-Gruppe zum Zuweisen virtueller GPUs zu PGPUs verwendet.
gpu-group-param-get-uuid
gpu-group-param-get-uuid uuid=uuid_of_group param-name=supported-vGPU-types|enabled-vGPU-types
Gibt die unterstützten oder aktivierten Typen für diese GPU-Gruppe zurück.
Virtuelle GPU-Parameter
Virtuelle GPUs haben die folgenden Parameter:
Parametername | Beschreibung | Typ |
---|---|---|
uuid |
Die eindeutige Identifikator/Objektreferenz für die virtuelle GPU | Lesezugriff |
vm-uuid |
Der eindeutige Bezeichner/Objektreferenz für die VM, der die virtuelle GPU zugewiesen ist | Lesezugriff |
vm-name-label |
Der Name der VM, der die virtuelle GPU zugewiesen ist | Lesezugriff |
gpu-group-uuid |
Die eindeutige Identifikator/Objektreferenz für die GPU-Gruppe, in der die virtuelle GPU enthalten ist | Lesezugriff |
gpu-group-name-label |
Der Name der GPU-Gruppe, in der die virtuelle GPU enthalten ist | Lesezugriff |
currently-attached |
True, wenn eine VM mit GPU-Passthrough ausgeführt wird, andernfalls false | Lesezugriff |
other-config |
Eine Liste von Schlüssel/Wert-Paaren, die zusätzliche Konfigurationsparameter für die virtuelle GPU angeben | Map-Parameter mit Lese-/Schreibzugriff |
type-uuid |
Die eindeutige Identifikator/Objektreferenz für den virtuellen GPU-Typ dieser virtuellen GPU | Map-Parameter mit Lese-/Schreibzugriff |
type-model-name |
Modellname, der dem virtuellen GPU-Typ zugeordnet ist | Lesezugriff |
Parameter des virtuellen GPU-Typs
Hinweis:
GPU-Passthrough und virtuelle GPUs sind nicht mit Livemigration, Speicher-Livemigration oder VM-Suspend kompatibel, es sei denn, unterstützte Software und Grafikkarten von GPU-Anbietern sind vorhanden. VMs ohne diese Unterstützung können nicht migriert werden, um Ausfallzeiten zu vermeiden. Weitere Informationen zur NVIDIA vGPU Kompatibilität mit Livemigration, Speicher-Livemigration und VM-Aussetzen finden Sie unter Grafiken.
Virtuelle GPU-Typen haben die folgenden Parameter:
Parametername | Beschreibung | Typ |
---|---|---|
uuid |
Der eindeutige Bezeichner/Objektreferenz für den virtuellen GPU-Typ | Lesezugriff |
vendor-name |
Name des virtuellen GPU-Anbieters | Lesezugriff |
model-name |
Modellname, der dem virtuellen GPU-Typ zugeordnet ist | Lesezugriff |
freeze-frame |
Frame-Puffergröße des virtuellen GPU-Typs, in Bytes | Lesezugriff |
max-heads |
Maximale Anzahl von Bildschirmen, die vom virtuellen GPU-Typ unterstützt werden | Lesezugriff |
supported-on-PGPUs |
Liste der PGPUs, die diesen virtuellen GPU-Typ unterstützen | Lesezugriff |
enabled-on-PGPUs |
Liste der PGPUs, für die dieser virtuelle GPU-Typ aktiviert ist | Lesezugriff |
VGPU-uuids |
Liste der virtuellen GPUs dieses Typs | Lesezugriff |
Virtuelle GPU-Vorgänge
vgpu-create
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. Mit diesem Befehl wird die VM an die angegebene GPU-Gruppe angehängt und optional den virtuellen GPU-Typ angegeben. Wenn kein virtueller GPU-Typ angegeben wird, wird der “Passthrough-Typ” angenommen.
vgpu-destroy
vgpu-destroy uuid=uuid_of_vgpu
Zerstören Sie 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
Mit false
deaktiviert die VNC-Konsole für eine VM, die an disablevnc=1
den Anzeigeemulator weitergeleitet wird. Standardmäßig ist VNC aktiviert.
Host-Befehle
Befehle für die Interaktion mit dem Citrix Hypervisor-Server.
Citrix Hypervisor-Server sind die physischen Server, auf denen die Citrix Hypervisor -Software ausgeführt wird. Auf ihnen laufen VMs unter der Kontrolle einer speziellen privilegierten virtuellen Maschine, die als Steuerdomäne oder Domäne 0 bezeichnet wird.
Die Citrix Hypervisor-Serverobjekte können mit den standardmäßigen Befehlen der Objektliste aufgeführt werden: xe host-list
xe host-cpu-list``,, und xe host-crashdump-list
). Die Parameter können mit den Standardparameter-Befehlen bearbeitet werden. Weitere Informationen finden Sie unter Low-Level-Parameterbefehle.
Host-Selektoren
Einige der hier aufgeführten Befehle verfügen über einen gemeinsamen Mechanismus zum Auswählen eines oder mehrerer Citrix Hypervisor-Server, auf denen der Vorgang ausgeführt werden soll. Am einfachsten ist es, das Argument anzugeben host=uuid_or_name_label
. Sie können Citrix Hypervisor auch angeben, indem Sie die vollständige Liste der Hosts nach den Werten der Felder filtern. Wenn Sie beispielsweise angeben, werden alle Citrix Hypervisor-Server enabled=true
ausgewählt, deren enabled
Feld gleich ist true
. Wenn mehrere Citrix Hypervisor-Server übereinstimmen und der Vorgang auf mehreren Citrix Hypervisor-Servern ausgeführt werden kann, müssen Sie angeben, ob der Vorgang ausgeführt werden --multiple
soll. Die vollständige Liste der Parameter, die abgeglichen werden können, wird am Anfang dieses Abschnitts beschrieben. Sie können diese Liste von Befehlen abrufen, indem Sie den Befehl ausführen xe host-list params=all
. Wenn keine Parameter für die Auswahl von Citrix Hypervisor-Servern angegeben sind, wird der Vorgang auf allen Citrix Hypervisor-Servern ausgeführt.
Host-Parameter
Citrix Hypervisor-Server haben die folgenden Parameter:
Parametername | Beschreibung | Typ |
---|---|---|
uuid |
Die eindeutige Identifikator/Objektreferenz für den Citrix Hypervisor-Server | Lesezugriff |
name-label |
Der Name des Citrix Hypervisor-Servers | Lese-/Schreibrechte |
name-description |
Die Beschreibungszeichenfolge des Citrix Hypervisor-Servers | Lesezugriff |
enabled |
Wert ist false , wenn deaktiviert. Dies verhindert, dass neue VMs auf den Hosts gestartet werden, und bereitet die Hosts darauf vor, heruntergefahren oder neu gestartet zu werden. Wert ist true , wenn der Host aktiviert ist |
Lesezugriff |
API-version-major |
Hauptversionsnummer | Lesezugriff |
API-version-minor |
Nebenversionsnummer | Lesezugriff |
API-version-vendor |
Identifizierung des API-Anbieters | Lesezugriff |
API-version-vendor-implementation |
Details zur Implementierung des Anbieters | Schreibgeschützte Map-Parameter |
logging |
Protokollierungskonfiguration | Map-Parameter mit Lese-/Schreibzugriff |
suspend-image-sr-uuid |
Die eindeutige Identifikator/Objektreferenz für die SR, in der suspendierte Images platziert werden | Lese-/Schreibrechte |
crash-dump-sr-uuid |
Der eindeutige Bezeichner/Objektreferenz für den SR, in dem Crash-Dumps platziert werden | Lese-/Schreibrechte |
software-version |
Liste der Versionsparameter und deren Werte | Schreibgeschützte Map-Parameter |
capabilities |
Liste der Xen Versionen, die auf dem Citrix Hypervisor-Server ausgeführt werden können | Schreibgeschützte Parameter festlegen |
other-config |
Eine Liste von Schlüssel/Wert-Paaren, die zusätzliche Konfigurationsparameter für den Citrix Hypervisor-Server angeben | Map-Parameter mit Lese-/Schreibzugriff |
chipset-info |
Eine Liste von Schlüssel/Wert-Paaren, die Informationen über den Chipsatz angeben | Schreibgeschützte Map-Parameter |
hostname |
Hostname des Citrix Hypervisor-Servers | Lesezugriff |
address |
IP-Adresse des Citrix Hypervisor-Servers | Lesezugriff |
license-server |
Eine Liste von Schlüssel/Wert-Paaren, die Informationen über den Lizenzserver angeben. Der Standardport für die Kommunikation mit Citrix Produkten ist 27000. Informationen zum Ändern von Portnummern aufgrund von Konflikten finden Sie unter Ändern der Portnummern | Schreibgeschützte Map-Parameter |
supported-bootloaders |
Liste der Bootloader, die vom Citrix Hypervisor-Server unterstützt werden pygrub , z. B. eliloader
|
Schreibgeschützte Parameter festlegen |
memory-total |
Gesamtmenge des physischen RAM auf dem Citrix Hypervisor-Server (in Bytes) | Lesezugriff |
memory-free |
Gesamtbetrag des verbleibenden physischen RAM, der VMs zugewiesen werden kann, in Bytes | Lesezugriff |
host-metrics-live |
True, wenn der Host betriebsbereit ist | Lesezugriff |
logging |
Der syslog_destination Schlüssel kann auf den Hostnamen eines Remote-Listening-Syslog-Dienstes gesetzt werden. |
Map-Parameter mit Lese-/Schreibzugriff |
allowed-operations |
Listet die Vorgänge auf, die in diesem Status zulässig sind. Diese Liste ist nur beratend, und der Serverstatus hat sich möglicherweise geändert, wenn ein Client dieses Feld liest. | Schreibgeschützte Parameter festlegen |
current-operations |
Listet die derzeit in Bearbeitung befindlichen Vorgänge auf. Diese Liste ist nur beratend, und der Serverstatus hat sich möglicherweise geändert, wenn ein Client dieses Feld liest. | Schreibgeschützte Parameter festlegen |
patches |
Satz von Host-Patches | Schreibgeschützte Parameter festlegen |
blobs |
Binärer Datenspeicher | Lesezugriff |
memory-free-computed |
Eine konservative Schätzung der maximalen Speichermenge auf einem Host | Lesezugriff |
ha-statefiles |
Die UUIDs aller HA-Statusdateien | Lesezugriff |
ha-network-peers |
Die UUIDs aller Hosts, die die VMs auf diesem Host hosten können, wenn ein Fehler auftritt | Lesezugriff |
external-auth-type |
Typ der externen Authentifizierung, z. B. Active Directory. | Lesezugriff |
external-auth-service-name |
Der Name des externen Authentifizierungsdienstes | Lesezugriff |
external-auth-configuration |
Konfigurationsinformationen für den externen Authentifizierungsdienst. | Schreibgeschützte Map-Parameter |
Citrix Hypervisor-Server enthalten einige andere Objekte, die auch Parameterlisten enthalten.
CPUs auf Citrix Hypervisor-Servern haben die folgenden Parameter:
Parametername | Beschreibung | Typ |
---|---|---|
uuid |
Der eindeutige Bezeichner/Objektreferenz für die CPU | Lesezugriff |
number |
Die Nummer des physischen CPU-Kerns innerhalb des Citrix Hypervisor-Servers | Lesezugriff |
vendor |
Die Lieferantenzeichenfolge für den CPU-Namen | Lesezugriff |
speed |
Die CPU-Taktgeschwindigkeit, in Hz | Lesezugriff |
modelname |
Die Lieferantenzeichenfolge für das CPU-Modell, z. B. “Intel (R) Xeon (TM) CPU 3,00 GHz” | Lesezugriff |
stepping |
Die CPU-Revisionsnummer | Lesezugriff |
flags |
Die Flags der physischen CPU (eine dekodierte Version des Feature-Feldes) | Lesezugriff |
Utilisation |
Die aktuelle CPU-Auslastung | Lesezugriff |
host-uuid |
Die UUID, wenn sich der Host, in dem sich die CPU befindet | Lesezugriff |
model |
Die Modellnummer der physischen CPU | Lesezugriff |
family |
Die Nummer der physischen CPU-Familie | Lesezugriff |
Absturzabbilder auf Citrix Hypervisor-Servern haben die folgenden Parameter:
Parametername | Beschreibung | Typ |
---|---|---|
uuid |
Der eindeutige Bezeichner/Objektreferenz für den Crashdump | Lesezugriff |
host |
Citrix Hypervisor-Server entspricht der Absturzabbild | Lesezugriff |
timestamp |
Zeitstempel des Datums und der Uhrzeit, zu der der Absturz aufgetreten ist, in der Form yyyymmdd-hhmmss-ABC , wobei ABC der Zeitzonenindikator ist, z. B. GMT |
Lesezugriff |
size |
Größe des Crashdumps, in Bytes | Lesezugriff |
host-all-editions
host-all-editions
Eine Liste aller verfügbaren Editionen abrufen
host-apply-edition
host-apply-edition [host-uuid=host_uuid] [edition=xenserver_edition="free" "per-socket" "xendesktop"]
Weist die Citrix Hypervisor -Lizenz einem Hostserver zu. Wenn Sie eine Lizenz zuweisen, kontaktiert Citrix Hypervisor den Lizenzserver und fordert den angegebenen Lizenztyp an. Wenn eine Lizenz verfügbar ist, wird sie dann vom Lizenzserver ausgecheckt.
Verwenden Sie für Citrix Hypervisor für Citrix Virtual Desktops Editionen "xendesktop"
.
Informationen zur ersten Lizenzierungskonfiguration finden Sie unter auch license-server-address
und license-server-port
.
host-backup
host-backup file-name=backup_filename host=host_name
Laden Sie ein Backup der Steuerdomäne des angegebenen Citrix Hypervisor-Servers auf den Computer herunter, von dem der Befehl aufgerufen wird. Speichern Sie es dort als Datei mit dem Namen file-name
.
Wichtig:
Während der
xe host-backup
Befehl funktioniert, wenn er auf dem lokalen Host ausgeführt wird (d. h. ohne einen bestimmten Hostnamen), verwenden Sie ihn nicht auf diese Weise. Dies würde die Steuerdomänenpartition mit der Backupdatei füllen. Verwenden Sie nur den Befehl von einem externen Rechner auf einem anderen Host, auf dem Sie Speicherplatz für die Backupdatei haben.
host-bugreport-upload
host-bugreport-upload [host-selector=host_selector_value...] [url=destination_url http-proxy=http_proxy_name]
Generieren Sie einen neuen Fehlerbericht (mit xen-bugtool
allen optionalen Dateien enthalten) und laden Sie sie auf die Support-FTP-Site oder einen anderen Speicherort hoch.
Die Hosts, auf denen dieser Vorgang ausgeführt werden soll, werden mit dem Standardauswahlmechanismus ausgewählt (siehe Host-Selektoren oben). Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten Host-Parameter sein.
Optionale Parameter sind http-proxy
: angegebenen HTTP-Proxy verwenden und url
: auf diese Ziel-URL hochladen. Wenn keine optionalen Parameter verwendet werden, wird kein Proxyserver identifiziert und das Ziel ist die standardmäßige Support-FTP-Site.
host-call-plugin
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
host-compute-free-memory
Berechnet die Menge des freien Speichers auf dem Host.
host-compute-memory-overhead
host-compute-memory-overhead
Berechnet den Virtualisierungsspeicheraufwand eines Hosts.
host-cpu-info
host-cpu-info [uuid=uuid]
Listet Informationen zu den physischen CPUs des Hosts auf.
host-crashdump-destroy
host-crashdump-destroy uuid=crashdump_uuid
Löschen Sie einen Host-Absturz, der durch seine UUID angegeben wird, vom Citrix Hypervisor-Server.
host-crashdump-upload
host-crashdump-upload uuid=crashdump_uuid [url=destination_url] [http-proxy=http_proxy_name]
Laden Sie einen Crashdump auf die Support-FTP-Site oder einen anderen Speicherort hoch. Wenn keine optionalen Parameter verwendet werden, wird kein Proxyserver identifiziert und das Ziel ist die standardmäßige Support-FTP-Site. Optionale Parameter sind http-proxy
: angegebenen HTTP-Proxy verwenden und url
: auf diese Ziel-URL hochladen.
host-declare-dead
host-declare-dead uuid=host_uuid
Erklären Sie, dass der Host tot ist, ohne ihn explizit zu kontaktieren.
Warnung:
Dieser Anruf ist gefährlich und kann zu Datenverlust führen, wenn der Host nicht tatsächlich tot ist.
host-disable
host-disable [host-selector=host_selector_value...]
Deaktiviert die angegebenen Citrix Hypervisor-Server, wodurch verhindert wird, dass neue VMs auf ihnen gestartet werden. Mit dieser Aktion werden die Citrix Hypervisor-Server zum Herunterfahren oder Neustart vorbereitet.
Die Hosts, auf denen dieser Vorgang ausgeführt werden soll, werden mit dem Standardauswahlmechanismus ausgewählt (siehe Host-Selektoren). Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten Host-Parameter sein.
host-disable-display
host-disable-display uuid=host_uuid
Deaktivieren Sie die Anzeige für den Host.
host-disable-local-storage-caching
host-disable-local-storage-caching
Deaktivieren Sie das lokale Speicherzwischenspeichern auf dem angegebenen Host.
host-dmesg
host-dmesg [host-selector=host_selector_value...]
Rufen Sie ein Xen dmesg
(die Ausgabe des Kernelringpuffers) von angegebenen Citrix Hypervisor-Servern ab.
Die Hosts, auf denen dieser Vorgang ausgeführt werden soll, werden mit dem Standardauswahlmechanismus ausgewählt (siehe Host-Selektoren oben). Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten Host-Parameter sein.
host-emergency-ha-disable
host-emergency-ha-disable [--force]
Deaktivieren Sie HA auf dem lokalen Host. Nur zur Wiederherstellung eines Pools mit einem defekten HA-Setup.
host-emergency-management-reconfigure
host-emergency-management-reconfigure interface=uuid_of_management_interface_pif
Konfigurieren Sie die Verwaltungsschnittstelle dieses Citrix Hypervisor-Servers neu. Verwenden Sie diesen Befehl nur, wenn sich der Citrix Hypervisor-Server im Notfallmodus befindet. Der Notfallmodus bedeutet, dass der Host Mitglied in einem Ressourcenpool ist, dessen Master aus dem Netzwerk verschwunden ist und nach einer Reihe von Wiederholungen nicht mehr kontaktiert werden kann.
host-emergency-reset-server-certificate
host-emergency-reset-server-certificate
Installiert ein selbstsigniertes Zertifikat auf dem Citrix Hypervisor-Server, auf dem der Befehl ausgeführt wird.
host-enable
host-enable [host-selector=host_selector_value...]
Aktiviert die angegebenen Citrix Hypervisor-Server, wodurch neue VMs auf ihnen gestartet werden können.
Die Hosts, auf denen dieser Vorgang ausgeführt werden soll, werden mit dem Standardauswahlmechanismus ausgewählt (siehe Host-Selektoren oben). Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten Host-Parameter sein.
host-enable-display
host-enable-display uuid=host_uuid
Anzeige für den Host aktivieren.
host-enable-local-storage-caching
host-enable-local-storage-caching sr-uuid=sr_uuid
Aktivieren Sie das lokale Speicherzwischenspeichern auf dem angegebenen Host.
host-evacuate
host-evacuate [host-selector=host_selector_value...]
Live migriert alle ausgeführten VMs zu anderen geeigneten Hosts in einem Pool. Deaktivieren Sie zunächst den Host mithilfe des host-disable
Befehls.
Wenn der evakuierte Host der Poolmaster ist, muss ein anderer Host als Poolmaster ausgewählt werden. Um den Poolmaster mit deaktivierter HA zu ändern, verwenden Sie den pool-designate-new-master
Befehl. Weitere Informationen finden Sie unter pool-designate-neue-master.
Wenn HA aktiviert ist, besteht die einzige Möglichkeit, den Server herunterzufahren, wodurch HA zufällig einen neuen Master wählt. Weitere Informationen finden Sie unter Host-Herunterfahren.
Die Hosts, auf denen dieser Vorgang ausgeführt werden soll, werden mit dem Standardauswahlmechanismus ausgewählt (siehe Host-Selektoren oben). Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten Host-Parameter sein.
host-forget
host-forget uuid=host_uuid
Der XAPI-Agent vergisst den angegebenen Citrix Hypervisor-Server, ohne ihn explizit zu kontaktieren.
Verwenden Sie den Parameter --force
, um zu vermeiden, dass Sie aufgefordert werden, zu bestätigen, dass Sie diesen Vorgang wirklich ausführen möchten.
Warnung:
Verwenden Sie diesen Befehl nicht, wenn HA im Pool aktiviert ist. Deaktivieren Sie zuerst HA und aktivieren Sie es dann erneut, nachdem Sie den Host vergessen haben.
Dieser Befehl ist nützlich, wenn der zu vergessene Citrix Hypervisor-Server nicht mehr vorhanden ist. Wenn der Citrix Hypervisor-Server jedoch live und Teil des Pools ist, verwenden Sie xe pool-eject
stattdessen.
host-get-cpu-features
host-get-cpu-features {features=pool_master_cpu_features} [uuid=host_uuid]
Druckt eine hexadezimale Darstellung der physikalischen CPU-Features des Hosts.
host-get-server-certificate
host-get-server-certificate
Rufen Sie das TLS-Zertifikat des installierten Servers ab.
host-get-sm-diagnostics
host-get-sm-diagnostics uuid=uuid
Anzeige von SM-Diagnoseinformationen pro Host.
host-get-system-status
host-get-system-status filename=name_for_status_file [entries=comma_separated_list] [output=tar.bz2|zip] [host-selector=host_selector_value...]
Laden Sie die 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 Capabilities entnommen werden, das vom host-get-system-status-capabilities
Befehl zurückgegeben wird. Weitere Informationen finden Sie unter host-get-system-status-funktionen. Wenn nicht angegeben, werden alle Systemstatusinformationen in der Datei gespeichert. Der Parameter output
kann tar.bz2 (Standardeinstellung) oder zipsein. 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 mit dem Standardauswahlmechanismus ausgewählt (siehe Host-Selektoren oben).
host-get-system-status-capabilities
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 ähnlich ist:
<?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 Prozessfähigkeits-Entität kann die folgenden Attribute haben.
-
key
Ein eindeutiger Bezeichner für die Funktion. -
content-type
Kann entweder Text/Plain oder Anwendung/Daten sein. Gibt an, ob eine Benutzeroberfläche die Einträge für den menschlichen Verzehr rendern kann. -
default-checked
Kann entweder ja oder nein sein. Gibt an, ob eine Benutzeroberfläche diesen Eintrag standardmäßig auswählen soll. -
min-size
,max-size
Gibt einen ungefähren Bereich für die Größe (in Byte) dieses Eintrags an. -1 gibt an, dass die Größe unwichtig ist. -
min-time
,max-time
Geben Sie einen ungefähren Bereich für die Zeit (in Sekunden) an, die zum Sammeln dieses Eintrags benötigt wird. -1 gibt an, dass die Zeit unwichtig ist. -
pii
Persönlich identifizierbare Informationen. Gibt an, ob der Eintrag Informationen enthält, die den Systembesitzer identifizieren können, oder Details zu seiner Netzwerktopologie. Das Attribut kann einen der folgenden Werte haben:-
no
: keine PII ist in diesen Einträgen enthalten -
yes
: PII wahrscheinlich oder sicher ist in diesen Einträgen -
maybe
: Sie sollten diese Einträge für PII überprüfen -
if_customized
wenn die Dateien unverändert sind, enthalten sie keine PII. Da wir jedoch die Bearbeitung dieser Dateien empfehlen, könnte PII durch eine solche Anpassung eingeführt worden sein. Dieser Wert wird insbesondere für die Netzwerkskripte in der Steuerdomäne verwendet.
Passwörter dürfen niemals in einen Fehlerbericht aufgenommen werden, unabhängig von einer PII Deklaration.
-
Die Hosts, auf denen dieser Vorgang ausgeführt werden soll, werden mit dem Standardauswahlmechanismus ausgewählt (siehe Host-Selektoren oben).
host-get-thread-diagnostics
host-get-thread-diagnostics uuid=uuid
Anzeigen von Diagnoseinformationen pro Host Thread.
host-get-vms-which-prevent-evacuation
host-get-vms-which-prevent-evacuation uuid=uuid
Gibt eine Liste von VMs zurück, die die Evakuierung eines bestimmten Hosts verhindern und die Gründe für jeden Host anzeigen.
host-is-in-emergency-mode
host-is-in-emergency-mode
Gibt zurück true
, wenn sich der Host, mit dem die CLI spricht, im Notfallmodus false
befindet. Dieser CLI-Befehl funktioniert direkt auf Poolmitgliedservern, auch wenn kein Masterserver vorhanden ist.
host-license-add
host-license-add [license-file=path/license_filename] [host-uuid=host_uuid]
Verwenden Sie für Citrix Hypervisor (kostenlose Edition), um eine lokale Lizenzdatei zu analysieren und sie dem angegebenen Citrix Hypervisor-Server hinzuzufügen.
host-license-remove
host-license-remove [host-uuid=host_uuid]
Entfernen Sie alle Lizenzierungen, die auf einen Host angewendet wurden.
host-license-view
host-license-view [host-uuid=host_uuid]
Zeigt den Inhalt der Citrix Hypervisor-Serverlizenz an.
host-logs-download
host-logs-download [file-name=logfile_name] [host-selector=host_selector_value...]
Laden Sie eine Kopie der Protokolle der angegebenen Citrix Hypervisor-Server herunter. Die Kopie wird standardmäßig in einer Zeitstempeldatei namens gespeichert hostname-yyyy-mm-dd T hh:mm:ssZ.tar.gz
. Mit dem optionalen Parameter file-name können Sie einen anderen Dateinamen angeben.
Die Hosts, auf denen dieser Vorgang ausgeführt werden soll, werden mit dem Standardauswahlmechanismus ausgewählt (siehe Host-Selektoren oben). Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten Host-Parameter sein.
Wichtig:
Während der
xe host-logs-download
Befehl funktioniert, wenn er auf dem lokalen Host ausgeführt wird (d. h. ohne einen bestimmten Hostnamen), verwenden Sie ihn nicht auf diese Weise. Dadurch wird die Steuerdomänenpartition mit der Kopie der Protokolle überladet. Der Befehl sollte nur von einer externen Maschine auf einem anderen Host verwendet werden, auf der Sie Speicherplatz für die Kopie der Protokolle haben.
host-management-disable
host-management-disable
Deaktiviert den Host-Agent, der eine externe Verwaltungsnetzwerkschnittstelle abhört, und trennt alle verbundenen API-Clients (z. B. XenCenter). Dieser Befehl funktioniert direkt auf dem Citrix Hypervisor-Server, mit dem die CLI verbunden ist. Der Befehl wird nicht an den Poolmaster weitergeleitet, wenn er auf einen Citrix Hypervisor-Server angewendet wird.
Warnung:
Seien Sie vorsichtig, wenn Sie diesen CLI-Befehl off-host verwenden. Nachdem dieser Befehl ausgeführt wurde, können Sie keine Remoteverbindung mit der Steuerdomäne über das Netzwerk herstellen, um den Host-Agent erneut zu aktivieren.
host-management-reconfigure
host-management-reconfigure [interface=device] [pif-uuid=uuid]
Konfiguriert den Citrix Hypervisor-Server neu, um die angegebene Netzwerkschnittstelle als Verwaltungsschnittstelle zu verwenden, d. h. die Schnittstelle, die für die Verbindung mit XenCenter verwendet wird. Der Befehl schreibt den Schlüssel MANAGEMENT_INTERFACE in /etc/xensource-inventory
.
Wenn der Gerätename einer Schnittstelle (die über eine IP-Adresse verfügen muss) angegeben wird, bindet der Citrix Hypervisor-Server sofort neu. Dieser Befehl funktioniert sowohl im Normal- als auch im Notfallmodus.
Wenn die UUID eines PIF-Objekts angegeben wird, bestimmt der Citrix Hypervisor-Server, welche IP-Adresse erneut an sich 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 über Netzwerkkonnektivität auf der neuen Schnittstelle verfügen. Verwenden Sie
xe pif-reconfigure
, um eine zuerst einzurichten. Andernfalls können nachfolgende CLI-Befehle den Citrix Hypervisor-Server nicht erreichen.
host-power-on
host-power-on [host=host_uuid]
Aktiviert Citrix Hypervisor-Server mit aktivierter Host-Einschaltfunktion. Bevor Sie diesen Befehl verwenden, aktivieren Sie die Option host-set-power-on
auf dem Host.
host-reboot
host-reboot [host-selector=host_selector_value...]
Starten Sie die angegebenen Citrix Hypervisor-Server neu. Die angegebenen Hosts müssen zuerst mit dem Befehlxe host-disable
deaktiviert werden, andernfalls wird eine HOST_IN_USE
Fehlermeldung angezeigt.
Die Hosts, auf denen dieser Vorgang ausgeführt werden soll, werden mit dem Standardauswahlmechanismus ausgewählt (siehe Host-Selektoren oben). Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten Host-Parameter sein.
Wenn die angegebenen Citrix Hypervisor-Server Mitglieder eines Pools sind, wird der Verbindungsverlust beim Herunterfahren gehandhabt, und der Pool wird wiederhergestellt, wenn die Citrix Hypervisor-Server zurückkehren. Die anderen Mitglieder und der Master funktionieren weiterhin.
Wenn Sie den Master herunterfahren, ist der Pool außer Betrieb, bis eine der folgenden Aktionen ausgeführt wird:
- Du machst eines der Mitglieder in den Master
-
Der ursprüngliche Master wird neu gestartet und wieder online.
Wenn der Master wieder online ist, stellen die Mitglieder die Verbindung wieder her und synchronisieren sie mit dem Master.
host-restore
host-restore [file-name=backup_filename] [host-selector=host_selector_value...]
Stellen Sie ein Backup mit dem Namen file-name
der Citrix Hypervisor-Serversteuerungssoftware wieder her. Die Verwendung des Wortes “wiederherstellen” bedeutet hier nicht eine vollständige Wiederherstellung im üblichen Sinne, sondern lediglich, dass die komprimierte Backupdatei dekomprimiert und auf die sekundäre Partition entpackt wurde. Nachdem Sie ein xe host-restore
abgeschlossen haben, müssen Sie die Installations-CD starten und die Option Wiederherstellen von Backup verwenden.
Die Hosts, auf denen dieser Vorgang ausgeführt werden soll, werden mit dem Standardauswahlmechanismus ausgewählt (siehe Host-Selektoren oben). Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten Host-Parameter sein.
host-send-debug-keys
host-send-debug-keys host-uuid=host_uuid keys=keys
Sendet angegebene Hypervisor Debug-Schlüssel an den angegebenen Host.
host-server-certificate-install
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 Citrix Hypervisor-Server.
host-set-hostname-live
host-set-hostname host-uuid=uuid_of_host hostname=new_hostname
Ändern Sie den Hostnamen des von angegebenen Citrix Hypervisor-Servers host-uuid
. Mit diesem Befehl werden sowohl der Hostname in der Steuerdomänendatenbank als auch der tatsächliche Linux-Hostname des Citrix Hypervisor-Servers dauerhaft festgelegt. Der Wert von hostname
ist nicht identisch mit dem Wert des name_label
Feldes.
host-set-power-on-mode
host-set-power-on-mode host=host_uuid power-on-mode={"" | "wake-on-lan" | "iLO" | "DRAC" | "custom"} \
[ power-on-config:power_on_ip=ip-address power-on-config:power_on_user=user power-on-config:power_on_password_secret=secret-uuid ]
Verwenden Sie diese Option, um die Host-Einschaltfunktion auf Citrix Hypervisor Hosts zu aktivieren, die mit Remote-Energielösungen kompatibel sind. Wenn Sie den host-set-power-on
Befehl verwenden, müssen Sie den Typ der Energieverwaltungslösung auf dem Host angeben (d. h. den Einschaltmodus). Geben Sie dann Konfigurationsoptionen mit dem Argument power-on-config und den zugehörigen Schlüssel-Wert-Paaren an.
Geben Sie den Schlüssel an, um die Funktion “Geheimnisse” zum Speichern Ihres Kennworts zu verwenden "power_on_password_secret"
. Weitere Informationen finden Sie unter Geheimnisse.
host-shutdown
host-shutdown [host-selector=host_selector_value...]
Fahren Sie die angegebenen Citrix Hypervisor-Server herunter. Die angegebenen Citrix Hypervisor-Server müssen zuerst mit dem Befehlxe host-disable
deaktiviert werden, andernfalls wird eine HOST_IN_USE
Fehlermeldung angezeigt.
Die Hosts, auf denen dieser Vorgang ausgeführt werden soll, werden mit dem Standardauswahlmechanismus ausgewählt (siehe Host-Selektoren oben). Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten Host-Parameter sein.
Wenn die angegebenen Citrix Hypervisor-Server Mitglieder eines Pools sind, wird der Verbindungsverlust beim Herunterfahren gehandhabt, und der Pool wird wiederhergestellt, wenn die Citrix Hypervisor-Server zurückkehren. Die anderen Mitglieder und der Master funktionieren weiterhin.
Wenn Sie den Master herunterfahren, ist der Pool außer Betrieb, bis eine der folgenden Aktionen ausgeführt wird:
- Du machst eines der Mitglieder in den Master
-
Der ursprüngliche Master wird neu gestartet und wieder online.
Wenn der Master wieder online ist, stellen die Mitglieder die Verbindung wieder her und synchronisieren sie mit dem Master.
Wenn HA für den Pool aktiviert ist, wird eines der Mitglieder automatisch zu einem Master gemacht. Wenn HA deaktiviert ist, müssen Sie den gewünschten Server mit dem Befehlpool-designate-new-master
manuell als Master festlegen. Weitere Informationen finden Sie unter pool-designate-new-master.
host-sm-dp-destroy
host-sm-dp-destroy uuid=uuid dp=dp [allow-leak=true|false]
Versuch, einen Speicherdatenpfad auf einem Host zu zerstören und zu bereinigen. Wenn bereitgestellt allow-leak=true
wird, werden alle Datensätze des Datenpfads gelöscht, auch wenn er nicht sauber heruntergefahren wird.
host-sync-data
host-sync-data
Synchronisieren Sie die nicht Datenbankdaten, die auf dem Poolmaster gespeichert sind, mit dem benannten Host.
host-syslog-reconfigure
host-syslog-reconfigure [host-selector=host_selector_value...]
Konfigurieren Sie den syslog
Daemon auf den angegebenen Citrix Hypervisor-Servern neu. Mit diesem Befehl werden die Konfigurationsinformationen angewendet, die im logging
-Hostparameter definiert sind.
Die Hosts, auf denen dieser Vorgang ausgeführt werden soll, werden mit dem Standardauswahlmechanismus ausgewählt (siehe Host-Selektoren oben). Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten Host-Parameter sein.
host-data-source-list
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, auf denen dieser Vorgang ausgeführt werden soll, über den Standardauswahlmechanismus (siehe Host-Selektoren). Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten Host-Parameter sein. Wenn keine Parameter für die Auswahl von Hosts angegeben sind, wird der Vorgang auf allen Hosts ausgeführt.
Datenquellen haben zwei Parameter — standard
und enabled
. Dieser Befehl gibt die Werte der Parameter aus:
- Wenn in einer Datenquelle
enabled
auftrue
festgelegt ist, werden die Metriken derzeit in der Performance-Datenbank aufgezeichnet. - Wenn eine Datenquelle auf
standard
festgelegt isttrue
, werden die Metriken standardmäßigin der Performance-Datenbank aufgezeichnet. Der Wert vonenabled
wird auch für diese Datenquelle auftrue
festgelegt. - Wenn eine Datenquelle auf
standard
festgelegt istfalse
, werden die Metriken standardmäßig nicht in der Performance-Datenbank aufgezeichnet. Der Wert vonenabled
wird auch für diese Datenquelle auffalse
festgelegt.
Führen Sie den Befehl host-data-source-record
aus, um Datenquellen-Metriken in der Performance-Datenbank aufzuzeichnen. Dieser Befehl legt enabled
auf true
fest. Um zu stoppen, führen Sie host-data-source-forget
aus. Dieser Befehl legt enabled
auf false
fest.
host-data-source-record
host-data-source-record data-source=name_description_of_data_source [host-selectors=host_selector_value...]
Zeichnen Sie die angegebene Datenquelle für einen Host auf.
Dieser Vorgang schreibt die Informationen aus der Datenquelle in die Datenbank der persistenten Performance-Metriken der angegebenen Hosts. Aus Performance-Gründen unterscheidet sich diese Datenbank von der normalen Agentendatenbank.
Wählen Sie die Hosts, auf denen dieser Vorgang ausgeführt werden soll, über den Standardauswahlmechanismus (siehe Host-Selektoren). Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten Host-Parameter sein. Wenn keine Parameter für die Auswahl von Hosts angegeben sind, wird der Vorgang auf allen Hosts ausgeführt.
host-data-source-forget
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 vergessen Sie alle aufgezeichneten Daten.
Wählen Sie die Hosts, auf denen dieser Vorgang ausgeführt werden soll, über den Standardauswahlmechanismus (siehe Host-Selektoren). Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten Host-Parameter sein. Wenn keine Parameter für die Auswahl von Hosts angegeben sind, wird der Vorgang auf allen Hosts ausgeführt.
host-data-source-query
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, auf denen dieser Vorgang ausgeführt werden soll, über den Standardauswahlmechanismus (siehe Host-Selektoren). Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten Host-Parameter sein. Wenn keine Parameter für die Auswahl von Hosts angegeben sind, wird der Vorgang auf allen Hosts ausgeführt.
VERALTET: Protokollbefehle
Befehle zum Arbeiten mit Protokollen.
VERALTET: log-get
log-get
Gibt das Protokoll zurück, das derzeit im String-Logger gespeichert ist.
VERALTET: log-get-keys
log-get-keys
Listet die Schlüssel auf, die der Logger kennt.
VERALTET: log-reopen
log-reopen
Öffnen Sie alle Logger erneut (verwenden Sie dies zum Drehen von Dateien).
VERALTET: log-set-output
log-set-output output=output [key=key] [level=level]
Setzen Sie alle Logger auf die angegebene Ausgabe (nil, stderr, string, file:file name, syslog:something).
Nachrichtenbefehle
Befehle zum Arbeiten mit Nachrichten. Nachrichten werden erstellt, um Benutzer über wichtige Ereignisse zu benachrichtigen und in XenCenter als Warnungen angezeigt.
Die Meldungsobjekte können mit dem Standard-Objektlistenbefehl (xe message-list
) aufgelistet und mit den Standardparameterbefehlen manipuliert werden. Weitere Informationen finden Sie unter Low-Level-Parameterbefehle
Message-Parameter
Parametername | Beschreibung | Typ |
---|---|---|
uuid |
Der eindeutige Bezeichner/Objektreferenz für die Nachricht | Lesezugriff |
name |
Der eindeutige Name der Nachricht | Lesezugriff |
priority |
Die Nachrichtenpriorität. Höhere Zahlen geben eine höhere Priorität an | Lesezugriff |
class |
Die Nachrichtenklasse, zum Beispiel VM. | Lesezugriff |
obj-uuid |
Die UUID des betroffenen Objekts. | Lesezugriff |
timestamp |
Die Zeit, zu der die Nachricht generiert wurde. | Lesezugriff |
body |
Der Nachrichteninhalt. | Lesezugriff |
message-create
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
message-destroy [uuid=message_uuid]
Zerstört eine vorhandene Nachricht. Sie können ein Skript erstellen, um alle Nachrichten zu zerstören. Beispiel:
# Dismiss all alerts \
IFS=","; for m in $(xe message-list params=uuid --minimal); do \
xe message-destroy uuid=$m \
done
Netzwerk-Befehle
Befehle zum Arbeiten mit Netzwerken.
Die Netzwerkobjekte können mit dem Standard-Objektlistenbefehl (xe network-list
) aufgelistet und mit den Standardparameterbefehlen manipuliert werden. Weitere Informationen finden Sie unter Low-Level-Parameterbefehle
Netzwerk-Parameter
Netzwerke haben die folgenden Parameter:
Parametername | Beschreibung | Typ |
---|---|---|
uuid |
Die eindeutige Identifikator/Objektreferenz für das Netzwerk | Lesezugriff |
name-label |
Der Name des Netzwerks | Lese-/Schreibrechte |
name-description |
Der Beschreibungstext des Netzwerks | Lese-/Schreibrechte |
VIF-uuids |
Eine Liste eindeutiger Bezeichner der VIFs (virtuelle Netzwerkschnittstellen), die von VMs an dieses Netzwerk angeschlossen sind | Schreibgeschützte Parameter festlegen |
PIF-uuids |
Eine Liste eindeutiger Bezeichner der PIFs (physikalische Netzwerkschnittstellen), die von Citrix Hypervisor-Servern an dieses Netzwerk angeschlossen sind | Schreibgeschützte Parameter festlegen |
bridge |
Name der Brücke, die diesem Netzwerk auf dem lokalen Citrix Hypervisor-Server entspricht | Lesezugriff |
default-locking-mode |
Ein Netzwerkobjekt, das mit VIF-Objekten für die ARP-Filterung verwendet wird. Legen Sie fest unlocked , um alle Filterregeln zu entfernen, die der VIF zugeordnet sind. Auf einstellen, disabled so dass die VIF den gesamten Datenverkehr verfällt. |
Lese-/Schreibrechte |
purpose |
Satz von Zwecken, für die der Citrix Hypervisor-Server dieses Netzwerk verwendet. Legen Sie fest nbd , dass das Netzwerk zum Herstellen von NBD-Verbindungen verwendet wird. |
Lese-/Schreibrechte |
other-config:staticroutes |
Kommagetrennte Liste von Subnetz/Netzmasken/Gateway Einträgen, die die Gateway-Adresse angeben, über die Subnetze weitergeleitet 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 festlegen, wird der Datenverkehr auf 172.16.0.0/15 über 192.168.0.3 geleitet und der Datenverkehr auf 172.18.0.0/16 über 192.168.0.4 weitergeleitet. |
Lese-/Schreibrechte |
other-config:ethtoolautoneg |
Auf no gesetzt, um die automatische Aushandlung der physischen Schnittstelle oder Brücke zu deaktivieren. Der Standardwert ist ja. | Lese-/Schreibrechte |
other-config:ethtool-rx |
On, um Empfangsprüfsumme zu aktivieren, Off zum Deaktivieren | Lese-/Schreibrechte |
other-config:ethtool-tx |
On, um die Übertragungs-Prüfsumme zu aktivieren, Off, um zu deaktivieren | Lese-/Schreibrechte |
other-config:ethtool-sg |
On, um Scatter Gather zu aktivieren, Off, um zu deaktivieren | Lese-/Schreibrechte |
other-config:ethtool-tso |
On, um TCP Segmentierung Offload zu aktivieren, Off, um zu deaktivieren | Lese-/Schreibrechte |
other-config:ethtool-ufo |
On, um UDP-Fragmentabladung zu aktivieren, Off, um zu deaktivieren | Lese-/Schreibrechte |
other-config:ethtool-gso |
On, um generische Segmentierung Offload zu aktivieren, Off, um zu deaktivieren | Lese-/Schreibrechte |
blobs |
Binärer Datenspeicher | Lesezugriff |
network-create
network-create name-label=name_for_network [name-description=descriptive_text]
Erstellt ein Netzwerk.
network-destroy
network-destroy uuid=network_uuid
Zerstört ein vorhandenes Netzwerk.
SR-IOV-Befehle
Befehle für die Arbeit mit SR-IOV.
Die Netzwerk-sriov-Objekte können mit dem Standard-Objektlistenbefehl (xe network-sriov-list
) aufgelistet und mit den Standardparameterbefehlen manipuliert werden. Weitere Informationen finden Sie unter Low-Level-Parameterbefehle
SR-IOV-Parameter
SR-IOV hat die folgenden Parameter:
Parametername | Beschreibung | Typ |
---|---|---|
physical-PIF |
Der PIF, um SR-IOV zu aktivieren. | Lesezugriff |
logical-PIF |
Eine logische SR-IOV-PIF. Benutzer können diesen Parameter verwenden, um ein SR-IOV-VLAN-Netzwerk zu erstellen. | Lesezugriff |
requires-reboot |
Wenn der Wert auf True festgelegt ist, wird der Host neu gestartet, um die SR-IOV-Aktivierung in Kraft zu setzen. | Lesezugriff |
remaining-capacity |
Anzahl der verbleibenden verfügbaren VFs. | Lesezugriff |
network-sriov-create
network-sriov-create network-uuid=network_uuid pif-uuid=physical_pif_uuid
Erstellt ein SR-IOV-Netzwerkobjekt für eine bestimmte physische PIF und aktiviert SR-IOV auf dem physischen PIF.
network-sriov-destroy
network-sriov-destroy uuid=network_sriov_uuid
Entfernt ein SR-IOV-Netzwerkobjekt und deaktiviert SR-IOV für seine physische PIF.
Zuweisen eines SR-IOV-VF
xe vif-create device=device_index mac=vf_mac_address network-uuid=sriov_network vm-uuid=vm_uuid
Weist einer VM eine VF aus einem SR-IOV-Netzwerk zu.
SDN-Controller-Befehle
Befehle zum Arbeiten mit dem SDN-Controller.
sdn-controller-forget
sdn-controller-introduce [address=address] [protocol=protocol] [tcp-port=tcp_port]
Führen Sie einen SDN-Controller ein.
sdn-controller-introduce
sdn-controller-forget uuid=uuid
Entfernen Sie einen SDN-Controller.
Tunnelbefehle
Befehle zum Arbeiten mit Tunneln.
tunnel-create
tunnel-create pif-uuid=pif_uuid network-uuid=network_uuid
Erstellen Sie einen neuen Tunnel auf einem Host.
tunnel-destroy
tunnel-destroy uuid=uuid
Zerstöre einen Tunnel.
Patch-Befehle
Befehle zum Arbeiten mit Patches.
patch-apply
patch-apply uuid=patch_uuid host-uuid=host_uuid
Wenden Sie den zuvor hochgeladenen Patch auf den angegebenen Host an.
patch-clean
patch-clean uuid=uuid
Löschen Sie eine zuvor hochgeladene Patchdatei.
patch-destroy
patch-destroy uuid=uuid
Entfernen Sie einen nicht angewendeten Patchdatensatz und Dateien vom Server.
patch-pool-apply
patch-pool-apply uuid=uuid
Wenden Sie den zuvor hochgeladenen Patch auf alle Hosts im Pool an.
patch-pool-clean
patch-pool-clean uuid=uuid
Löschen Sie eine zuvor hochgeladene Patchdatei auf allen Hosts im Pool.
patch-precheck
patch-precheck uuid=uuid host-uuid=host_uuid
Führen Sie die Vorabprüfungen aus, die im Patch enthalten sind, der zuvor auf den angegebenen Host hochgeladen wurde.
patch-upload
patch-upload file-name=file_name
Laden Sie eine Patchdatei auf den Server hoch.
PBD-Befehle
Befehle zum Arbeiten mit PBDs (Physical Block Devices). PBDs sind die Software-Objekte, über die der Citrix Hypervisor-Server auf Speicherrepositorys (SRs) zugreift.
Die PBD-Objekte können mit dem Standard-Objektlistenbefehl (xe pbd-list
) aufgelistet und mit den Standardparameterbefehlen manipuliert werden. Weitere Informationen finden Sie unter Low-Level-Parameterbefehle
PBD-Parameter
PBDs haben die folgenden Parameter:
Parametername | Beschreibung | Typ |
---|---|---|
uuid |
Der eindeutige Bezeichner/Objektreferenz für die PBD. | Lesezugriff |
sr-uuid |
Das Speicher-Repository, auf das die PBD verweist | Lesezugriff |
device-config |
Zusätzliche Konfigurationsinformationen, die dem SR-Backend-Treiber eines Hosts zur Verfügung gestellt werden | Schreibgeschützte Map-Parameter |
currently-attached |
True, wenn die SR auf diesem Host angehängt ist, andernfalls False | Lesezugriff |
host-uuid |
UUID der physischen Maschine, auf der die PBD verfügbar ist | Lesezugriff |
host |
Das Hostfeld ist veraltet. Verwenden Sie stattdessen host_uuid. | Lesezugriff |
other-config |
Zusätzliche Konfigurationsinformationen. | Map-Parameter mit Lese-/Schreibzugriff |
pbd-create
pbd-create host-uuid=uuid_of_host sr-uuid=uuid_of_sr [device-config:key=corresponding_value]
Erstellen Sie eine PBD auf dem Citrix Hypervisor-Server. Der schreibgeschützte Parameter device-config
kann nur beim Erstellen festgelegt werden.
Um eine Zuordnung von ‘path’ zu ‘/tmp’ hinzuzufügen, sollte die Befehlszeile das Argument device-config:path=/tmp
Eine vollständige Liste der unterstützten Geräte-Konfigurations-Schlüssel/Wert-Paare für jeden SR-Typ finden Sie unter Speicher.
pbd-destroy
pbd-destroy uuid=uuid_of_pbd
Zerstören Sie die angegebene PBD.
pbd-plug
pbd-plug uuid=uuid_of_pbd
Versucht, die PBD an den Citrix Hypervisor-Server anzuschließen. Wenn dieser Befehl erfolgreich ist, sollten die referenzierte SR (und die in enthaltenen VDIs) für den Citrix Hypervisor-Server sichtbar werden.
pbd-unplug
pbd-unplug uuid=uuid_of_pbd
Versuchen Sie, die PBD vom Citrix Hypervisor-Server zu trennen.
PIF-Befehle
Befehle zum Arbeiten mit PIFs (Objekte, die die physischen Netzwerkschnittstellen darstellen).
Die PIF-Objekte können mit dem Standard-Objektlistenbefehl (xe pif-list
) aufgelistet und mit den Standardparameterbefehlen manipuliert werden. Weitere Informationen finden Sie unter Low-Level-Parameterbefehle
PIF-Parameter
PIF haben die folgenden Parameter:
Parametername | Beschreibung | Typ |
---|---|---|
uuid |
Die eindeutige Identifikator/Objektreferenz für den PIF | Lesezugriff |
device machine-readable |
Name der Schnittstelle (z. B. eth0) | Lesezugriff |
MAC |
Die MAC-Adresse des PIF | Lesezugriff |
other-config |
Zusätzliche name:value PIF-Konfigurationspaare. |
Map-Parameter mit Lese-/Schreibzugriff |
physical |
Wenn wahr, zeigt der PIF auf eine tatsächliche physische Netzwerkschnittstelle | Lesezugriff |
currently-attached |
Ist der PIF derzeit auf diesem Host angehängt? true oder false
|
Lesezugriff |
MTU |
Maximale Übertragungseinheit des PIF in Bytes. | Lesezugriff |
VLAN |
VLAN-Tag für den gesamten Datenverkehr, der durch diese Schnittstelle fließt. -1 gibt an, dass kein VLAN-Tag zugewiesen ist | Lesezugriff |
bond-master-of |
Die UUID der Bindung, von der dieser PIF der Master ist (falls vorhanden) | Lesezugriff |
bond-slave-of |
Die UUID der Bindung, zu der dieser PIF gehört (falls vorhanden) | Lesezugriff |
management |
Ist dieser PIF als Verwaltungsschnittstelle für die Kontrolldomäne bestimmt | Lesezugriff |
network-uuid |
Die eindeutige Identifikator/Objektreferenz des virtuellen Netzwerks, mit dem dieser PIF verbunden ist | Lesezugriff |
network-name-label |
Der Name des virtuellen Netzwerks, mit dem dieser PIF verbunden ist | Lesezugriff |
host-uuid |
Die eindeutige Kennung/Objektreferenz des Citrix Hypervisor-Servers, mit dem dieser PIF verbunden ist | Lesezugriff |
host-name-label |
Der Name des Citrix Hypervisor-Servers, mit dem dieser PIF verbunden ist | Lesezugriff |
IP-configuration-mode |
Typ der verwendeten Netzwerkadressenkonfiguration; DHCP oder statisch | Lesezugriff |
IP |
IP-Adresse des PIF. Hier definiert, wenn IP-Konfigurations-Modus statisch ist; nicht definiert, wenn DHCP | Lesezugriff |
netmask |
Netzmaske des PIF. Hier definiert, wenn IP-Konfigurations-Modus statisch ist; nicht definiert, wenn von DHCP bereitgestellt wird | Lesezugriff |
gateway |
Gateway-Adresse des PIF. Hier definiert, wenn IP-Konfigurations-Modus statisch ist; nicht definiert, wenn von DHCP bereitgestellt wird | Lesezugriff |
DNS |
DNS-Adresse des PIF. Hier definiert, wenn IP-Konfigurations-Modus statisch ist; nicht definiert, wenn von DHCP bereitgestellt wird | Lesezugriff |
io_read_kbs |
Durchschnittliche Leserate in KB/s für das Gerät | Lesezugriff |
io_write_kbs |
Durchschnittliche Schreibrate in KB/s für das Gerät | Lesezugriff |
carrier |
Verbindungsstatus für dieses Gerät | Lesezugriff |
vendor-id |
Die ID, die dem Hersteller der NIC zugewiesen ist | Lesezugriff |
vendor-name |
Name des NIC-Anbieters | Lesezugriff |
device-id |
Die ID, die der Hersteller diesem NIC-Modell zugewiesen hat | Lesezugriff |
device-name |
Der vom Hersteller diesem NIC-Modell zugewiesene Name | Lesezugriff |
speed |
Datenübertragungsrate der NIC | Lesezugriff |
duplex |
Duplexmodus der NIC; Voll- oder Halbmodus | Lesezugriff |
pci-bus-path |
PCI-Buspfadadresse | Lesezugriff |
other-config:ethtoolspeed |
Legt die Geschwindigkeit der Verbindung in Mbit/s fest | Lese-/Schreibrechte |
other-config:ethtoolautoneg |
Auf no gesetzt, um die automatische Aushandlung der physischen Schnittstelle oder Brücke zu deaktivieren. Der Standardwert ist ja. | Lese-/Schreibrechte |
other-config:ethtoolduplex |
Legt die Duplexfunktion des PIF fest, entweder voll oder halb. | Lese-/Schreibrechte |
other-config:ethtool-rx |
On, um Empfangsprüfsumme zu aktivieren, Off zum Deaktivieren | Lese-/Schreibrechte |
other-config:ethtool-tx |
On, um die Übertragungs-Prüfsumme zu aktivieren, Off, um zu deaktivieren | Lese-/Schreibrechte |
other-config:ethtool-sg |
On, um Scatter Gather zu aktivieren, Off, um zu deaktivieren | Lese-/Schreibrechte |
other-config:ethtool-tso |
On, um TCP Segmentierung Offload zu aktivieren, Off, um zu deaktivieren | Lese-/Schreibrechte |
other-config:ethtool-ufo |
On, um UDP-Fragmentabladung zu aktivieren, Off, um zu deaktivieren | Lese-/Schreibrechte |
other-config:ethtool-gso |
On, um generische Segmentierung Offload zu aktivieren, Off, um zu deaktivieren | Lese-/Schreibrechte |
other-config:domain |
Kommagetrennte Liste, die zum Festlegen des DNS-Suchpfads verwendet wird | Lese-/Schreibrechte |
other-config:bondmiimon |
Intervall zwischen Link-Live-Prüfungen, in Millisekunden | Lese-/Schreibrechte |
other-config:bonddowndelay |
Anzahl der Millisekunden, die gewartet werden müssen, nachdem der Link verloren gegangen ist, bevor er wirklich in Erwägung zieht, dass der Link verschwunden ist. Dieser Parameter ermöglicht einen vorübergehenden Verbindungsverlust | Lese-/Schreibrechte |
other-config:bondupdelay |
Anzahl der Millisekunden, die gewartet werden müssen, nachdem der Link auftaucht, bevor er es wirklich in Betracht zieht. Ermöglicht das Aufklappen von Links. Die Standardeinstellung ist 31s , dass Switches Zeit für die Weiterleitung des Datenverkehrs zulassen. |
Lese-/Schreibrechte |
disallow-unplug |
True, wenn es sich bei diesem PIF um eine dedizierte Speicher-NIC handelt, andernfalls false | Lese-/Schreibrechte |
Hinweis:
Änderungen an den
other-config
Feldern eines PIF werden erst nach einem Neustart wirksam. Alternativ können Sie diexe pif-unplug
Befehlexe pif-plug
und verwenden, um die PIF-Konfiguration neu zu schreiben.
pif-forget
pif-forget uuid=uuid_of_pif
Zerstören Sie das angegebene PIF-Objekt auf einem bestimmten Host.
pif-introduce
pif-introduce host-uuid=host_uuid mac=mac_address_for_pif device=interface_name
Erstellen Sie ein PIF-Objekt, das eine physische Schnittstelle auf dem angegebenen Citrix Hypervisor-Server darstellt.
pif-plug
pif-plug uuid=uuid_of_pif
Versuchen Sie, die angegebene physische Schnittstelle aufzurufen.
pif-reconfigure-ip
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. Setzen Sie für statische IP-Konfiguration den Parameter mode
auf static
mit den Parametern gateway
, IP
und netmask
auf den entsprechenden Werten. 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 auf einem Switch verbunden sind, indem das Spanning Tree Protocol mit ausgeschaltetem (oder nicht unterstütztem) STP Fast Link verwendet wird, führt zu einem Zeitraum, in dem kein Datenverkehr vorliegt.
pif-reconfigure-ipv6
pif-reconfigure-ipv6 uuid=uuid_of_pif mode=mode [gateway=network_gateway_address] [IPv6=static_ip_for_this_pif] [DNS=dns_address]
Konfigurieren Sie die IPv6-Adresseinstellungen auf einem PIF neu.
pif-scan
pif-scan host-uuid=host_uuid
Suchen Sie auf dem Citrix Hypervisor-Server nach neuen physischen Schnittstellen.
pif-set-primary-address-type
pif-set-primary-address-type uuid=uuid primary_address_type=address_type
Ändern Sie den primären Adresstyp, der von diesem PIF verwendet wird.
pif-unplug
pif-unplug uuid=uuid_of_pif
Versuchen Sie, die angegebene physische Schnittstelle herunterzufahren.
Pool-Befehle
Befehle zum Arbeiten mit Pools. Ein Pool ist ein Aggregat von einem oder mehreren Citrix Hypervisor-Servern. Ein Pool verwendet ein oder mehrere freigegebene Speicherrepositorys, sodass die VMs, die auf einem Host im Pool ausgeführt werden, nahezu in Echtzeit auf einen anderen Host im Pool migriert werden können. Diese Migration erfolgt, während die VM noch ausgeführt wird, ohne dass sie heruntergefahren und wieder hochgefahren werden muss. Jeder Citrix Hypervisor-Server ist wirklich ein Pool, der standardmäßig aus einem einzelnen Mitglied besteht. Wenn der Citrix Hypervisor-Server mit einem Pool verbunden ist, wird er als Mitglied festgelegt, und der Pool, dem er beigetreten ist, wird zum Master für den Pool.
Das Singleton-Pool-Objekt kann mit dem Standard-Objektlistenbefehl (xe pool-list
) aufgelistet werden. Seine Parameter können mit den Standardparameter-Befehlen bearbeitet werden. Weitere Informationen finden Sie unter Low-Level-Parameterbefehle
Pool-Parameter
Pools haben die folgenden Parameter:
Parametername | Beschreibung | Typ |
---|---|---|
uuid |
Der eindeutige Bezeichner/Objektreferenz für den Pool | Lesezugriff |
name-label |
Der Name des Pools | Lese-/Schreibrechte |
name-description |
Die Beschreibungszeichenfolge des Pools | Lese-/Schreibrechte |
master |
Die eindeutige Kennung/Objektreferenz des Citrix Hypervisor-Servers, der als Master des Pools bezeichnet wird | Lesezugriff |
default-SR |
Die eindeutige Bezeichner/Objektreferenz des Standard-SR für den Pool | Lese-/Schreibrechte |
crash-dump-SR |
Der eindeutige Bezeichner/Objektreferenz des SR, in dem alle Absturzabbilder für Poolmitglieder gespeichert werden | Lese-/Schreibrechte |
metadata-vdis |
Alle bekannten Metadaten-VDIs für den Pool | Lesezugriff |
suspend-image-SR |
Die eindeutige Kennung/Objektreferenz des SR, in der angehaltene VMs auf Poolmitgliedern gespeichert werden | Lese-/Schreibrechte |
other-config |
Eine Liste von Schlüssel/Wert-Paaren, die zusätzliche Konfigurationsparameter für den Pool angeben | Map-Parameter mit Lese-/Schreibzugriff |
supported-sr-types |
SR-Typen, die dieser Pool verwenden kann | Lesezugriff |
ha-enabled |
True, wenn HA für den Pool aktiviert ist, andernfalls false | Lesezugriff |
ha-configuration |
Reserviert für zukünftige Nutzung. | Lesezugriff |
ha-statefiles |
Listet die UUIDs der VDIs auf, die von HA zum Bestimmen des Speicherzustands verwendet werden | Lesezugriff |
ha-host-failures-to-tolerate |
Die Anzahl der Host-Ausfälle, die vor dem Senden einer Systemwarnung toleriert werden sollen | Lese-/Schreibrechte |
ha-plan-exists-for |
Die Anzahl der Hostausfälle, die gemäß den Berechnungen des HA-Algorithmus tatsächlich behandelt werden können | Lesezugriff |
ha-allow-overcommit |
True, wenn der Pool überschrieben werden darf, andernfalls False | Lese-/Schreibrechte |
ha-overcommitted |
True, wenn der Pool überschrieben ist | Lesezugriff |
blobs |
Binärer Datenspeicher | Lesezugriff |
live-patching-disabled |
Wird auf False gesetzt, um Live-Patches zu aktivieren. Legen Sie auf True fest, um Live-Patches zu deaktivieren. | Lese-/Schreibrechte |
igmp-snooping-enabled |
Legen Sie auf True fest, um IGMP-Snooping zu aktivieren. Setzen Sie auf False, um IGMP-Snooping zu deaktivieren. | Lese-/Schreibrechte |
pool-apply-edition
pool-apply-edition edition=edition [uuid=uuid] [license-server-address=address] [license-server-port=port]
Wenden Sie eine Edition über den Pool an.
pool-certificate-install
pool-certificate-install filename=file_name
Installieren Sie ein TLS-Zertifikat, poolweit.
pool-certificate-list
pool-certificate-list
Listet alle installierten TLS-Zertifikate in einem Pool auf.
pool-certificate-sync
pool-certificate-sync
Synchronisieren von TLS-Zertifikaten und Zertifikatsperrlisten vom Poolmaster mit den anderen Poolmitgliedern.
pool-certificate-uninstall
pool-certificate-uninstall name=name
Deinstallieren Sie ein TLS-Zertifikat.
pool-crl-install
pool-crl-install filename=file_name
Installieren Sie eine TLS-Zertifikatsperrliste, poolweit.
pool-crl-list
pool-crl-list
Listet alle installierten TLS-Zertifikatsperrlisten auf.
pool-crl-uninstall
pool-crl-uninstall name=name
Deinstallieren Sie eine TLS-Zertifikatsperrliste.
pool-deconfigure-wlb
pool-deconfigure-wlb
Entfernen Sie die Konfiguration für den Arbeitslastausgleich dauerhaft.
pool-designate-new-master
pool-designate-new-master host-uuid=uuid_of_new_master
Weisen Sie den angegebenen Citrix Hypervisor-Server an, der Master eines vorhandenen Pools zu werden. Dieser Befehl führt eine geordnete Übergabe der Rolle des Master-Hosts an einen anderen Host im Ressourcenpool durch. Dieser Befehl funktioniert nur, wenn der aktuelle Master online ist. Es ist kein Ersatz für die unten aufgeführten Notfallmodusbefehle.
pool-disable-external-auth
pool-disable-external-auth [uuid=uuid] [config=config]
Deaktiviert die externe Authentifizierung auf allen Hosts in einem Pool.
pool-disable-local-storage-caching
pool-disable-local-storage-caching uuid=uuid
Deaktivieren Sie das lokale Speicherzwischenspeichern im Pool.
pool-disable-redo-log
pool-disable-redo-log
Deaktivieren Sie das Redo Log, wenn es verwendet wird, es sei denn, HA ist aktiviert.
pool-dump-database
pool-dump-database file-name=filename_to_dump_database_into_(on_client)
Laden Sie eine Kopie der gesamten Pooldatenbank herunter und laden Sie sie in eine Datei auf dem Client ein.
pool-enable-external-auth
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 des auth-Typs bestimmte config: -Werte erfordern.
pool-enable-local-storage-caching
pool-enable-local-storage-caching uuid=uuid
Aktivieren Sie das lokale Speicherzwischenspeichern im Pool.
pool-enable-redo-log
pool-ensable-redo-log sr-uuid=sr_uuid
Aktivieren Sie das Redo Log für die angegebene SR, wenn sie verwendet wird, es sei denn, HA ist aktiviert.
pool-eject
pool-eject host-uuid=uuid_of_host_to_eject
Weisen Sie den angegebenen Citrix Hypervisor-Server an, einen vorhandenen Pool zu verlassen.
pool-emergency-reset-master
pool-emergency-reset-master master-address=address_of_pool_master
Weisen Sie einen Poolmitgliedserver an, seine Masterserveradresse auf den neuen Wert zurückzusetzen und zu versuchen, eine Verbindung zu ihm herzustellen. Führen Sie diesen Befehl nicht auf Masterservern aus.
pool-emergency-transition-to-master
pool-emergency-transition-to-master
Weisen Sie einen Citrix Hypervisor-Server an, der Poolmaster zu werden. Der Citrix Hypervisor-Server akzeptiert diesen Befehl erst, nachdem der Host in den Notfallmodus umgestellt hat. Der Notfallmodus bedeutet, dass er Mitglied eines Pools ist, dessen Master aus dem Netzwerk verschwunden ist und nach einer gewissen Anzahl von Wiederholungen nicht kontaktiert werden kann.
Wenn das Hostkennwort seit dem Beitritt des Hosts zum Pool geändert wurde, kann dieser Befehl dazu führen, dass das Kennwort des Hosts zurückgesetzt wird. Weitere Informationen finden Sie unter (Benutzerbefehle).
pool-ha-enable
pool-ha-enable heartbeat-sr-uuids=uuid_of_heartbeat_sr
Aktivieren Sie Hochverfügbarkeit für den Ressourcenpool, wobei die angegebene SR-UUID als zentrales Speicher-Heartbeat-Repository verwendet wird.
pool-ha-disable
pool-ha-disable
Deaktiviert die Funktion für hohe Verfügbarkeit im Ressourcenpool.
pool-ha-compute-hypothetical-max-host-failures-to-tolerate
Berechnen Sie die maximale Anzahl von Hostfehlern, die unter der aktuellen Poolkonfiguration toleriert werden sollen.
pool-ha-compute-max-host-failures-to-tolerate
pool-ha-compute-hypothetical-max-host-failures-to-tolerate [vm-uuid=vm_uuid] [restart-priority=restart_priority]
Berechnen Sie die maximale Anzahl von Hostausfällen, die mit den bereitgestellten, vorgeschlagenen geschützten VMs toleriert werden sollen.
pool-initialize-wlb
pool-initialize-wlb wlb_url=url wlb_username=wlb_username wlb_password=wlb_password xenserver_username=username xenserver_password=password
Initialisieren Sie den Workloadausgleich für den aktuellen Pool mit dem Ziel-WLB-Server.
pool-join
pool-join master-address=address master-username=username master-password=password
Weisen Sie den Citrix Hypervisor-Server an, einem vorhandenen Pool beizutreten.
pool-management-reconfigure
pool-management-reconfigure [network-uuid=network-uuid]
Konfiguriert die Verwaltungsschnittstelle aller Hosts im Pool für die Verwendung der angegebenen Netzwerkschnittstelle, d. h. der Schnittstelle, die für die Verbindung mit XenCenter verwendet wird. Der Befehl schreibt den Schlüssel MANAGEMENT_INTERFACE /etc/xensource-inventory
für alle Hosts im Pool um.
Wenn der Gerätename einer Schnittstelle (die über eine IP-Adresse verfügen muss) angegeben wird, bindet der Citrix Hypervisor Master-Host sofort neu. Dieser Befehl funktioniert sowohl im Normal- als auch im Notfallmodus.
Von der angegebenen Netzwerk-UUID wird die UUID des PIF-Objekts identifiziert und dem Citrix Hypervisor-Server zugeordnet, der bestimmt, welche IP-Adresse an sich selbst neu gebunden werden soll. Es darf sich nicht im Notfallmodus befinden, wenn dieser Befehl ausgeführt wird.
Warnung:
Seien Sie vorsichtig, wenn Sie diesen CLI-Befehl außerhalb des Hosts verwenden, und stellen Sie sicher, dass Sie über Netzwerkkonnektivität auf der neuen Schnittstelle verfügen. Verwenden Sie
xe pif-reconfigure
, um eine zuerst einzurichten. Andernfalls können nachfolgende CLI-Befehle den Citrix Hypervisor-Server nicht erreichen.
pool-recover-slaves
pool-recover-slaves
Weisen Sie den Poolmaster an, zu versuchen, die Master-Adresse aller Mitglieder zurückzusetzen, die derzeit im Notfallmodus ausgeführt werden. Dieser Befehl wird in der Regel verwendet, nachdem er verwendet pool-emergency-transition-to-master
wurde, um eines der Elemente als neuen Master festzulegen.
pool-restore-database
pool-restore-database file-name=filename_to_restore_from_on_client [dry-run=true|false]
Laden Sie ein Datenbankbackup (erstellt mit pool-dump-database
) in einen Pool hoch. Nach Erhalt des Uploads startet sich der Master mit der neuen Datenbank neu.
Es gibt auch eine 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 dry-run
ist der Wert false festgelegt.
pool-retrieve-wlb-configuration
pool-retrieve-wlb-configuration
Ruft die Pooloptimierungskriterien vom Workload Balancing-Server ab.
pool-retrieve-wlb-diagnostics
pool-retrieve-wlb-diagnostics [filename=file_name]
Ruft Diagnosen vom Arbeitslastausgleichsserver ab.
pool-retrieve-wlb-recommendations
pool-retrieve-wlb-recommendations
Ruft VM-Migrationsempfehlungen für den Pool vom Workload Balancing-Server ab.
pool-retrieve-wlb-report
pool-retrieve-wlb-report report=report [filename=file_name]
Ruft Berichte vom Arbeitslastausgleichsserver ab.
pool-send-test-post
pool-send-test-post dest-host=destination_host dest-port=destination_port body=post_body
Senden Sie den angegebenen Text mit HTTPS an den angegebenen Host und Port und drucken Sie die Antwort aus. Dies wird zum Debuggen des TLS-Layers verwendet.
pool-send-wlb-configuration
pool-send-wlb-configuration [config:=config]
Legt die Pooloptimierungskriterien für den Workload Balancing-Server fest.
pool-sync-database
pool-sync-database
Erzwingen Sie, dass die Pooldatenbank auf allen Hosts im Ressourcenpool synchronisiert wird. Dieser Befehl ist im normalen Betrieb nicht erforderlich, da die Datenbank regelmäßig automatisch repliziert wird. Der Befehl kann jedoch nützlich sein, um sicherzustellen, dass Änderungen nach einer erheblichen Reihe von CLI-Operationen schnell repliziert werden.
Pool festlegen igmp-snooping
pool-param-set [uuid=pool-uuid] [igmp-snooping-enabled=true|false]
Aktiviert oder deaktiviert IGMP-Snooping in einem Citrix Hypervisor -Pool.
PVS-Beschleuniger-Befehle
Befehle für die Arbeit mit dem PVS Accelerator.
pvs-cache-storage-create
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
pvs-cache-storage-destroy uuid=uuid
Entfernen Sie einen PVS-Cache.
pvs-proxy-create
pvs-proxy-create pvs-site-uuid=pvs_site_uuid vif-uuid=vif_uuid
Konfigurieren Sie eine VM/VIF für die Verwendung eines PVS-Proxys.
pvs-proxy-destroy
pvs-proxy-destroy uuid=uuid
Entfernen (oder Ausschalten) eines PVS-Proxys für diese VIF/VM.
pvs-server-forget
pvs-server-forget uuid=uuid
Vergessen Sie einen PVS-Server.
pvs-server-introduce
pvs-server-introduce addresses=adresses first-port=first_port last-port=last_port pvs-site-uuid=pvs_site_uuid
Einführung eines neuen PVS-Servers.
pvs-site-forget
pvs-site-forget uuid=uuid
Vergessen Sie eine PVS-Website.
pvs-site-introduce
pvs-site-introduce name-label=name_label [name-description=name_description] [pvs-uuid=pvs_uuid]
Einführung einer neuen PVS-Website.
Storage Manager-Befehle
Befehle zum Steuern von Storage Manager-Plug-Ins.
Die Speichermanager-Objekte können mit dem Standard-Objektlistenbefehl (xe sm-list
) aufgelistet werden. Die Parameter können mit den Standardparameter-Befehlen bearbeitet werden. Weitere Informationen finden Sie unter Low-Level-Parameterbefehle
SM-Parameter
SMs haben folgende Parameter:
Parametername | Beschreibung | Typ |
---|---|---|
uuid |
Die eindeutige Kennung/Objektreferenz für das SM-Plug-In | Lesezugriff |
name-label |
Der Name des SM-Plug-ins | Lesezugriff |
name-description |
Die Beschreibungszeichenfolge des SM-Plug-ins | Lesezugriff |
type |
Der SR-Typ, mit dem dieses Plug-In eine Verbindung hergestellt wird | Lesezugriff |
vendor |
Name des Anbieters, der dieses Plug-In erstellt hat | Lesezugriff |
copyright |
Copyright-Erklärung für dieses SM-Plug-in | Lesezugriff |
required-api-version |
Minimale SM-API-Version auf dem Citrix Hypervisor-Server erforderlich | Lesezugriff |
configuration |
Namen und Beschreibungen der Gerätekonfigurationsschlüssel | Lesezugriff |
capabilities |
Funktionen des SM-Plug-ins | Lesezugriff |
driver-filename |
Der Dateiname des SR-Treibers. | Lesezugriff |
Snapshot-Befehle
Befehle zum Arbeiten mit Snapshots.
snapshot-clone
snapshot-clone new-name-label=name_label [uuid=uuid] [new-name-description=description]
Erstellen Sie eine neue Vorlage durch Klonen eines vorhandenen Snapshots, wobei der schnelle Festplattenklonvorgang auf Speicherebene, sofern verfügbar, verwendet wird.
snapshot-copy
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 schnellen Festplattenklonvorgang auf Speicherebene (auch wenn diese verfügbar ist). Die Datenträgerimages der kopierten VM sind garantiert “vollständige Images” - also nicht Teil einer CoW-Kette.
snapshot-destroy
snapshot-destroy [uuid=uuid] [snapshot-uuid=snapshot_uuid]
Zerstöre einen Schnappschuss. Dadurch bleibt der dem Snapshot zugeordnete Speicher intakt. Um den Speicher auch zu löschen, verwenden Sie snapshot-uninstall.
snapshot-disk-list
snapshot-disk-list [uuid=uuid] [snapshot-uuid=snapshot_uuid] [vbd-params=vbd_params] [vdi-params=vdi_params]
Listet die Datenträger auf den ausgewählten VM (n) auf.
snapshot-export-to-template
snapshot-export-to-template filename=file_name snapshot-uuid=snapshot_uuid [preserve-power-state=true|false]
Exportieren Sie einen Snapshot in den Dateinamen.
snapshot-reset-powerstate
snapshot-reset-powerstate [uuid=uuid] [snapshot-uuid=snapshot_uuid] [--force]
Erzwingen Sie, dass der VM-Energiezustand nur in der Management-Toolstack-Datenbank angehalten wird. Dieser Befehl wird verwendet, um einen Snapshot wiederherzustellen, der als “suspendiert” markiert ist. Dies ist eine potenziell gefährliche Operation: Sie müssen sicherstellen, dass Sie das Speicherimage nicht mehr benötigen. Sie können Ihren Snapshot nicht mehr fortsetzen.
snapshot-revert
snapshot-revert [uuid=uuid] [snapshot-uuid=snapshot_uuid]
Setzen Sie eine vorhandene VM auf einen vorherigen Checkpoint- oder Snapshot-Status zurück.
snapshot-uninstall
snapshot-uninstall [uuid=uuid] [snapshot-uuid=snapshot_uuid] [--force]
Deinstallieren Sie einen Snapshot. Durch diesen Vorgang werden die VDIs gelöscht, die als RW markiert sind und nur mit diesem Snapshot verbunden sind. Um den VM-Datensatz einfach zu zerstören, verwenden Sie snapshot-destroy.
SR-Befehle
Befehle zum Steuern von SRs (Speicher-Repositories).
Die SR-Objekte können mit dem Standard-Objektlistenbefehl (xe sr-list
) aufgelistet und mit den Standardparameterbefehlen manipuliert werden. Weitere Informationen finden Sie unter Low-Level-Parameterbefehle
SR-Parameter
SRs haben die folgenden Parameter:
Parametername | Beschreibung | Typ |
---|---|---|
uuid |
Die eindeutige Identifikator/Objektreferenz für die SR | Lesezugriff |
name-label |
Der Name der SR | Lese-/Schreibrechte |
name-description |
Die Beschreibungszeichenfolge des SR | Lese-/Schreibrechte |
allowed-operations |
Liste der Operationen, die auf der SR in diesem Zustand erlaubt sind | Schreibgeschützte Parameter festlegen |
current-operations |
Liste der Operationen, die derzeit auf dieser SR ausgeführt werden | Schreibgeschützte Parameter festlegen |
VDIs |
Eindeutige Kennung/Objektreferenz für die virtuellen Laufwerke in diesem SR | Schreibgeschützte Parameter festlegen |
PBDs |
Eindeutige Kennung/Objektreferenz für die an diese SR angehängten PBDs | Schreibgeschützte Parameter festlegen |
physical-utilisation |
Physischer Speicherplatz, der derzeit auf diesem SR genutzt wird, in Bytes. Bei Thin Provisioned Datenträgerformaten kann die physische Auslastung geringer sein als die virtuelle Zuweisung | Lesezugriff |
physical-size |
Physische Gesamtgröße des SR in Bytes | Lesezugriff |
type |
Typ des SR, der zum Angeben des zu verwendenden SR-Backend-Treibers verwendet wird | Lesezugriff |
introduced-by |
Die drtask (falls vorhanden), die die SR eingeführt hat | Lesezugriff |
content-type |
Der Typ des SR-Inhalts. Wird verwendet, um ISO-Bibliotheken von anderen SRs zu unterscheiden. Für Speicher-Repositories, die eine ISO-Bibliothek speichern, muss der Inhaltstyp auf iso gesetzt werden. In anderen Fällen wird empfohlen, diesen Parameter entweder auf leer oder den Zeichenfolgenbenutzer zu setzen. | Lesezugriff |
shared |
True, wenn diese SR von mehreren Citrix Hypervisor-Servern gemeinsam genutzt werden kann; andernfalls False | Lese-/Schreibrechte |
other-config |
Liste der Schlüssel/Wert-Paare, die zusätzliche Konfigurationsparameter für die SR angeben | Map-Parameter mit Lese-/Schreibzugriff |
host |
Der Host-Name des Speicher-Repositorys | Lesezugriff |
virtual-allocation |
Summe der Werte der virtuellen Größe aller VDIs in diesem Speicher-Repository (in Byte) | Lesezugriff |
sm-config |
SM-abhängige Daten | Schreibgeschützte Map-Parameter |
blobs |
Binärer Datenspeicher | Lesezugriff |
sr-create
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 eine SR auf dem Datenträger, führt sie in die Datenbank ein und erstellt eine PBD, die die SR mit dem Citrix Hypervisor-Server verbindet. Wenn auf festgelegt shared
ist true
, wird für jeden Citrix Hypervisor-Server im Pool eine PBD erstellt. Wenn nicht angegeben oder auf festgelegt shared
ist false
, wird eine PBD nur für den mit angegebenen Citrix Hypervisor-Server erstellt host-uuid
.
Die genauen Parameter device-config
unterscheiden sich je nach type
für das Gerät. Einzelheiten zu diesen Parametern für die verschiedenen Speicher-Back-Ends finden Sie unter Speicher.
sr-data-source-forget
sr-data-source-forget data-source=data_source
Beenden Sie die Aufzeichnung der angegebenen Datenquelle für einen SR, und vergessen Sie alle aufgezeichneten Daten.
sr-data-source-list
sr-data-source-list"
Listet die Datenquellen auf, die für eine SR aufgezeichnet werden können.
sr-data-source-query
sr-data-source-query data-source=data_source
Fragen Sie den zuletzt gelesenen Wert aus einer SR-Datenquelle ab.
sr-data-source-record
sr-data-source-record data-source=data_source
Zeichnen Sie die angegebene Datenquelle für einen SR auf.
sr-destroy
sr-destroy uuid=sr_uuid
Löscht die angegebene SR auf dem Citrix Hypervisor-Server.
sr-enable-database-replication
sr-enable-database-replication uuid=sr_uuid
Aktiviert die XAPI-Datenbankreplikation auf die angegebene (gemeinsam genutzte) SR.
sr-disable-database-replication
sr-disable-database-replication uuid=sr_uuid
Deaktiviert die XAPI-Datenbankreplikation auf die angegebene SR.
sr-forget
sr-forget uuid=sr_uuid
Der XAPI-Agent vergisst eine angegebene SR auf dem Citrix Hypervisor-Server. 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
sr-introduce name-label=name physical-size=physical_size type=type content-type=content_type uuid=sr_uuid
Platziert einfach einen SR-Datensatz in die Datenbank. Verwenden Sie device-config
, um zusätzliche Parameter im Format device-config:parameter_key=parameter_value
anzugeben, z. B.:
xe sr-introduce device-config:device=/dev/sdb1
Hinweis:
Dieser Befehl wird nie im normalen Betrieb verwendet. Dieser erweiterte Vorgang kann nützlich sein, wenn eine SR neu konfiguriert werden muss, nachdem sie erstellt wurde, oder um die Wiederherstellung von verschiedenen Fehlerszenarien zu erleichtern.
sr-probe
sr-probe type=type [host-uuid=host_uuid] [device-config:config_name=value]
Führt einen Backend-spezifischen Scan mit den bereitgestellten device-config
Schlüsseln durch. Wenn die für das SR-Back-End abgeschlossen device-config
ist, gibt dieser Befehl gegebenenfalls eine Liste der SRs zurück, die auf dem Gerät vorhanden sind. Wenn die Parameter device-config
nur teilweise sind, wird ein Back-End-spezifischer Scan durchgeführt, der Ergebnisse liefert, die Sie bei der Verbesserung der verbleibenden Parameter device-config
anleiten. Die Scanergebnisse werden als Backend-spezifisches XML zurückgegeben, das auf der CLI gedruckt wird.
Die genauen Parameter device-config
unterscheiden sich je nach type
für das Gerät. Einzelheiten zu diesen Parametern für die verschiedenen Speicher-Back-Ends finden Sie unter Speicher.
sr-probe-ext
sr-probe-ext type=type [host-uuid=host_uuid] [device-config:=config] [sm-config:-sm_config]
Führen Sie einen Speicher-Sonde aus. Die Parameter device-config können z.B. durch device-config:devs=/dev/sdb1 angegeben werden. Im Gegensatz zu sr-probe gibt dieser Befehl Ergebnisse in demselben menschenlesbaren Format für jeden SR-Typ zurück.
sr-scan
sr-scan uuid=sr_uuid
Erzwingen Sie einen SR-Scan, indem Sie die XAPI-Datenbank mit VDIs im zugrunde liegenden Speichersubstrat synchronisieren.
sr-update
sr-update uuid=uuid
Aktualisieren Sie die Felder des SR-Objekts in der Datenbank.
lvhd-enable-thin-provisioning
lvhd-enable-thin-provisioning sr-uuid=sr_uuid initial-allocation=initial_allocation allocation-quantum=allocation_quantum
Aktivieren Sie Thin-Provisioning auf einer LVHD-SR.
Betreff Befehle
Befehle für die Arbeit mit Themen.
session-subject-identifier-list
session-subject-identifier-list
Gibt eine Liste aller Benutzer-Betreff-IDs aller extern authentifizierten vorhandenen Sitzungen zurück.
session-subject-identifier-logout
session-subject-identifier-logout subject-identifier=subject_identifier
Melden Sie sich alle extern authentifizierten Sitzungen ab, die einer Benutzer-Betreff-ID zugeordnet sind.
session-subject-identifier-logout-all
session-subject-identifier-logout-all
Melden Sie sich alle extern authentifizierten Sitzungen ab.
subject-add
subject-add subject-name=subject_name
Fügen Sie der Liste der Themen, die auf den Pool zugreifen können, ein Betreff hinzu.
subject-remove
subject-remove subject-uuid=subject_uuid
Entfernen Sie einen Betreff aus der Liste der Themen, die auf den Pool zugreifen können.
subject-role-add
subject-role-add uuid=uuid [role-name=role_name] [role-uuid=role_uuid]
Hinzufügen einer Rolle zu einem Betreff.
subject-role-remove
subject-role-remove uuid=uuid [role-name=role_name] [role-uuid=role_uuid]
Entfernen einer Rolle aus einem Betreff.
secret-create
secret-create value=value
Schaffen Sie ein Geheimnis.
secret-destroy
secret-destroy uuid=uuid
Zerstöre ein Geheimnis.
Task-Befehle
Befehle zum Arbeiten mit langwierigen asynchronen Aufgaben. Bei diesen Befehlen handelt es sich um Aufgaben wie Starten, Beenden und Anhalten einer virtuellen Maschine. Die Aufgaben bestehen in der Regel aus einer Reihe anderer atomarer Teilaufgaben, die zusammen den angeforderten Vorgang ausführen.
Die Task-Objekte können mit dem Standard-Objektlistenbefehl (xe task-list
) aufgelistet und mit den Standardparameterbefehlen manipuliert werden. Weitere Informationen finden Sie unter Low-Level-Parameterbefehle
Task-Parameter
Aufgaben haben die folgenden Parameter:
Parametername | Beschreibung | Typ |
---|---|---|
uuid |
Der eindeutige Bezeichner/Objektreferenz für den Task | Lesezugriff |
name-label |
Der Name der Aufgabe | Lesezugriff |
name-description |
Die Beschreibungszeichenfolge des Tasks | Lesezugriff |
resident-on |
Der eindeutige Bezeichner/Objektreferenz des Hosts, auf dem der Task ausgeführt wird | Lesezugriff |
status |
Status der Aufgabe | Lesezugriff |
progress |
Wenn der Vorgang noch ausstehend ist, enthält dieses Feld den geschätzten Prozentsatz, der abgeschlossen ist, von 0 bis 1. Wenn der Task erfolgreich oder nicht erfolgreich abgeschlossen wurde, ist der Wert 1. | Lesezugriff |
type |
Wenn der Task 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 nicht definiert | Lesezugriff |
result |
Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält dieses Feld den Ergebniswert, entweder “Void” oder eine Objektreferenz. Andernfalls ist der Wert dieses Parameters nicht definiert. | Lesezugriff |
error_info |
Wenn der Task fehlgeschlagen ist, enthält dieser Parameter den Satz der zugeordneten Fehlerzeichenfolgen. Andernfalls ist der Wert dieses Parameters nicht definiert | Lesezugriff |
allowed_operations |
Liste der in diesem Zustand zulässigen Operationen | Lesezugriff |
created |
Zeit, zu der die Aufgabe erstellt wurde | Lesezugriff |
finished |
Zeitaufgabe beendet (d. h. erfolgreich oder fehlgeschlagen). Wenn der Aufgaben-Status ausstehend ist, hat der Wert dieses Feldes keine Bedeutung | Lesezugriff |
subtask_of |
Enthält die UUID der Aufgaben, die dieser Task eine Teilaufgabe von | Lesezugriff |
subtasks |
Enthält die UUIDs aller Teilaufgaben dieser Aufgabe | Lesezugriff |
task-cancel
task-cancel [uuid=task_uuid]
Verweisen Sie die angegebene Aufgabe, abzubrechen und zurückzukehren.
Vorlagenbefehle
Befehle zum Arbeiten mit VM-Vorlagen.
Vorlagen sind im Wesentlichen VMs, bei denen der Parameter is-a-template
auf true
festgelegt ist. Eine Vorlage ist ein “Gold-Image”, das alle verschiedenen Konfigurationseinstellungen enthält, um eine bestimmte VM zu instanziieren. Citrix Hypervisor wird mit einem Basissatz von Vorlagen geliefert, bei denen es sich um generische “rohe” VMs handelt, die eine Installations-CD des Betriebssystemanbieters starten können (z. B. RHEL, CentOS, SLES, Windows). Sie können VMs erstellen, sie in Standardformularen für Ihre speziellen Anforderungen konfigurieren und eine Kopie von ihnen als Vorlagen für die zukünftige Verwendung in der VM-Bereitstellung speichern.
Die Vorlagenobjekte können mit dem Standard-Objektlistenbefehl (xe template-list
) aufgelistet und mit den Standardparameterbefehlen manipuliert werden. Weitere Informationen finden Sie unter Low-Level-Parameterbefehle
Hinweis:
Vorlagen können nicht direkt in VMs konvertiert werden, indem Sie den Parameter
is-a-template
auffalse
festlegen. Das Festlegen des Parametersis-a-template
auffalse
wird nicht unterstützt und führt zu einer VM, die nicht gestartet werden kann.
Parameter der VM-Vorlage
Vorlagen haben die folgenden Parameter:
-
uuid
( schreibgeschützt) den eindeutigen Bezeichner/Objektreferenz für die Vorlage -
name-label
( Lesen/Schreiben) den Namen der Vorlage -
name-description
( Lese-/Schreibzugriff) die Beschreibungszeichenfolge der Vorlage -
user-version
( Lese-/Schreibzeichenfolge) für Ersteller von VMs und Vorlagen, um Versionsinformationen zu setzen -
is-a-template
( Lese-/Schreibzugriff) true, wenn diese VM eine Vorlage ist. Vorlagen-VMs können nie gestartet werden, sie werden nur zum Klonen anderer VMs verwendet. Nachdem dieser Wert auf true gesetzt wurde, kann er nicht auf false zurückgesetzt werden. Vorlagen-VMs können mit diesem Parameter nicht in VMs konvertiert werden. -
is-control-domain
( schreibgeschützt) true, wenn es sich um eine Kontrolldomäne handelt (Domäne 0 oder Treiberdomäne) -
power-state
( schreibgeschützt) aktueller Energiezustand. Der Wert wird für eine Vorlage immer angehalten -
memory-dynamic-max
( schreibgeschützt) dynamischer maximaler Speicher in Bytes. Derzeit ungenutzt, aber wenn geändert, 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 wenn geändert,memory-dynamic-max
müssen die gleichen Einschränkungen für beachtet werden. -
memory-static-max
( Lese-/Schreibzugriff) statisch (absoluter) maximaler Speicher in Bytes gesetzt. Dieses Feld ist der Hauptwert, der verwendet wird, um die Speichermenge zu bestimmen, die einer VM zugewiesen ist. -
memory-static-min
( Lese-/Schreibzugriff) statisch festgesetzter (absoluter) minimaler Speicher in Bytes. Dieses Feld stellt den absoluten Mindestspeicher dar undmemory-static-min
muss kleiner sein alsmemory-static-max
. Dieser Wert wird im normalen Betrieb nicht verwendet, aber die vorherige Einschränkung muss beachtet werden. -
suspend-VDI-uuid
( schreibgeschützt) den VDI, auf dem ein Suspend-Image gespeichert ist (hat keine Bedeutung für eine Vorlage) -
VCPUs-params
(Lese-/Schreibzuordnungsparameter) Konfigurationsparameter für die ausgewählte vCPU-Richtlinie.Sie können das Pinning einer vCPU mit folgenden Einstellungen abstimmen:
xe template-param-set uuid=<template_uuid> vCPUs-params:mask=1,2,3
Eine aus dieser Vorlage erstellte VM wird nur auf physischen CPUs 1, 2 und 3 ausgeführt.
Sie können auch die vCPU-Priorität (xen-Scheduling) mit den Parametern “cap” und “weight” einstellen. Beispiel:
xe template-param-set uuid=<template_uuid> VCPUs-params:weight=512 xe template-param-set uuid=<template_uuid> VCPUs-params:cap=100
Eine auf dieser Vorlage basierende VM mit einer Gewichtung von 512 erhält doppelt so viel CPU wie eine Domäne mit einer Gewichtung von 256 auf einem umstrittenen Host. Die zulässigen Gewichtungen liegen zwischen 1 und 65535 und der Standardwert ist 256.
Die Obergrenze fixiert optional die maximale CPU-Anzahl, die eine VM auf dieser Vorlage verwenden kann, selbst wenn der Citrix Hypervisor-Server über CPU-Zyklen im Leerlauf verfügt. Die Obergrenze wird in Prozent einer physischen CPU ausgedrückt: 100 ist 1 physische CPU, 50 ist eine halbe CPU, 400 ist 4 CPUs usw. Der Standardwert 0 bedeutet, dass keine obere Kappe vorhanden ist.
-
VCPUs-max
( Lese-/Schreibzugriff) maximale Anzahl von vCPUs -
VCPUs-at-startup
( Lese-/Schreibzugriff) Boot-Nummer 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 Parameter) virtuelle Konsolengeräte -
platform
( Lese-/Schreibzuordnungsparameter) plattformspezifische KonfigurationSo deaktivieren Sie die Emulation eines parallelen Ports für HVM-Gäste (z. B. Windows-Gäste):
xe vm-param-set uuid=<vm_uuid> platform:parallel=none
So deaktivieren Sie die Emulation eines seriellen Ports für HVM-Gäste:
xe vm-param-set uuid=<vm_uuid> platform:hvm_serial=none
So deaktivieren Sie die Emulation eines USB-Controller und eines USB-Tablet-Geräts für HVM-Gäste:
xe vm-param-set uuid=<vm_uuid> platform:usb=false xe vm-param-set uuid=<vm_uuid> platform:usb_tablet=false
-
allowed-operations
(schreibgeschützter Parameter) Liste der zulässigen Operationen für diesem Status -
current-operations
( schreibgeschützter Parameter) Liste der Vorgänge, die derzeit in dieser Vorlage ausgeführt werden -
allowed-VBD-devices
( schreibgeschützter Parameter) Liste der zur Verwendung verfügbaren VBD-Bezeichner, dargestellt durch Ganzzahlen des Bereichs 0—15. Diese Liste ist nur informativ, und andere Geräte können verwendet werden (funktioniert aber möglicherweise nicht). -
allowed-VIF-devices
( schreibgeschützter Parameter) Liste der verfügbaren VIF-Bezeichner, dargestellt durch Ganzzahlen des Bereichs 0—15. Diese Liste ist nur informativ, und andere Geräte können verwendet werden (funktioniert aber möglicherweise nicht). -
HVM-boot-policy
( Lese-/Schreibzugriff) die Boot-Richtlinie für HVM-Gäste. Entweder BIOS-Reihenfolge oder eine leere Zeichenfolge. -
HVM-boot-params
( Parameter für Lese-/Schreibzuordnung) steuert der Order Key die HVM-Gast-Boot-Reihenfolge, die als Zeichenfolge dargestellt wird, wobei jedes Zeichen eine Boot-Methode ist: d für die CD/DVD, c für den Stammdatenträger und n für Netzwerk-PXE-Boot. Der Standardwert ist dc. -
PV-kernel
( Lese-/Schreibzugriff) Pfad zum Kernel -
PV-ramdisk
( Lese-/Schreibzugriff) -Pfad zum initrd -
PV-args
( Lese-/Schreibzugriff) Zeichenfolge von Kernel-Befehlszeilenargumenten -
PV-legacy-args
( Lese-/Schreibzugriff) Zeichenfolge von Argumenten, um Legacy-VMs basierend auf dieser Vorlage zu starten -
PV-bootloader
( Lese-/Schreibzugriff) Name oder Pfad zum Bootloader -
PV-bootloader-args
( Lese-/Schreibzugriff) Zeichenfolge verschiedener Argumente für den Bootloader -
last-boot-CPU-flags
( schreibgeschützt) beschreibt die CPU-Flags, auf denen eine auf dieser Vorlage basierende VM zuletzt gebootet wurde; nicht für eine Vorlage aufgefüllt -
resident-on
( schreibgeschützt) den Citrix Hypervisor-Server, auf dem sich eine auf dieser Vorlage basierende VM befindet. Erscheint alsnot in database
für eine Vorlage -
affinity
( Lese-/Schreibzugriff) den Citrix Hypervisor-Server, auf dem eine auf dieser Vorlage basierende VM die Voreinstellung für die Ausführung hat. Wird vom Befehlxe vm-start
verwendet, um zu entscheiden, wo die VM ausgeführt werden soll. -
other-config
( Map-Parameter mit Lese-/Schreibzugriff) Liste der Schlüssel/Wert-Paare, die zusätzliche Konfigurationsparameter für die Vorlage angeben -
start-time
( schreibgeschützt) Zeitstempel des Datums und der Uhrzeit, zu der die Metriken für eine VM, die auf dieser Vorlage basieren, gelesen wurdenyyyymmddThh:mm:ss z
, wobei z der militärische Zeitzonenindikator mit einem Buchstaben ist, z. B. Z für UTC (GMT). Legen Sie für eine Vorlage auf1 Jan 1970 Z
(Anfang der Unix/POSIX-Epoche) fest -
install-time
( schreibgeschützt) Zeitstempel des Datums und der Uhrzeit, zu der die Metriken für eine VM, die auf dieser Vorlage basieren, gelesen wurdenyyyymmddThh:mm:ss z
, wobei z der militärische Zeitzonenindikator mit einem Buchstaben ist, z. B. Z für UTC (GMT). Legen Sie für eine Vorlage auf1 Jan 1970 Z
(Anfang der Unix/POSIX-Epoche) fest -
memory-actual
( schreibgeschützt) der tatsächliche Speicher, der von einer VM basierend auf dieser Vorlage verwendet wird; 0 für eine Vorlage -
VCPUs-number
( schreibgeschützt) die Anzahl der virtuellen CPUs, die einer VM basierend auf dieser Vorlage zugewiesen sind; 0 für eine Vorlage -
VCPUs-Utilization
( Nur-Lese-Map-Parameter) Liste der virtuellen CPUs und deren Gewichtung schreibgeschützter Map-Parameter os-Version die Version des Betriebssystems für eine VM basierend auf dieser Vorlage. Erscheint alsnot in database
für eine Vorlage -
PV-drivers-version
( schreibgeschützter Zuordnungsparameter) die Versionen der paravirtualisierten Treiber für eine VM basierend auf dieser Vorlage. Erscheint alsnot in database
für eine Vorlage -
PV-drivers-detected
( schreibgeschützt) für die neueste Version der paravirtualisierten Treiber für eine VM basierend auf dieser Vorlage. Erscheint alsnot in database
für eine Vorlage -
memory
( schreibgeschützte Zuordnungsparameter) -Speichermetriken, die vom Agent auf einer VM basierend auf dieser Vorlage gemeldet werden. Erscheint alsnot in database
für eine Vorlage -
disks
( schreibgeschützte Zuordnungsparameter) Datenträgermetriken, die vom Agent auf einer VM basierend auf dieser Vorlage gemeldet werden. Erscheint alsnot in database
für eine Vorlage -
networks
( schreibgeschützte Zuordnungsparameter) -Netzwerkmetriken, die vom Agent auf einer VM basierend auf dieser Vorlage gemeldet werden. Erscheint alsnot in database
für eine Vorlage -
other
( schreibgeschützter Zuordnungsparameter) andere Metriken, die der Agent auf einer VM basierend auf dieser Vorlage gemeldet hat. Erscheint alsnot in database
für eine Vorlage -
guest-metrics-last-updated
( schreibgeschützt) Zeitstempel, wenn der Gast-Agent den letzten Schreibvorgang in diese Felder durchgeführt hat. In der FormyyyymmddThh: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 ausgeführt werden soll, nachdem die VM heruntergefahren wurde -
actions-after-reboot
( Lese-/Schreibzugriff) -Aktion, die ausgeführt werden soll, nachdem die VM neu gestartet wurde -
possible-hosts
( schreibgeschützte) Liste von Hosts, die die VM möglicherweise hosten können -
HVM-shadow-multiplier
( Lese-/Schreib-Multiplikator), der auf die Menge an Schatten angewendet wird, die dem Gast zur Verfügung gestellt wird -
dom-id
( schreibgeschützte) Domain-ID (falls vorhanden, andernfalls -1) -
recommendations
( schreibgeschützt) XML-Spezifikation der empfohlenen Werte und Bereiche für Eigenschaften dieser VM -
xenstore-data
( Read/Write Map-Parameter) -Daten, die nach dem Erstellen der VM in die Strukturxenstore
(/local/domain/*domid*/vmdata
) eingefügt werden. -
is-a-snapshot
( schreibgeschützt) True, wenn es sich bei dieser Vorlage um einen VM-Snapshot handelt -
snapshot_of
( schreibgeschützt) die UUID der VM, für die diese Vorlage ein Snapshot von -
snapshots
( schreibgeschützt) die UUIDs aller Snapshots, die von dieser Vorlage erstellt wurden -
snapshot_time
( schreibgeschützt) der Zeitstempel des zuletzt aufgenommenen VM-Snapshots -
memory-target
( schreibgeschützt) die Zielmenge des Speichers, der für diese Vorlage festgelegt wurde -
blocked-operations
( Map-Parameter Lese-/Schreibzugriff) listet die Operationen auf, die für diese Vorlage nicht ausgeführt werden können -
last-boot-record
( schreibgeschützt) Datensatz der letzten Boot-Parameter für diese Vorlage im XML-Format -
ha-always-run
( Lese-/Schreibzugriff) True, wenn eine Instanz dieser Vorlage immer auf einem anderen Host neu gestartet wird, wenn ein Fehler des Hosts vorliegt, auf dem sie sich befindet. Dieser Parameter ist jetzt veraltet. Verwenden Sie stattdessen den Parameterha-restartpriority
. -
ha-restart-priority
( schreibgeschützt) Neustart oder Best-Mühe Lese-/Schreib-Blobs binärer Datenspeicher -
live
( schreibgeschützt) nur für eine laufende VM relevant.
template-export
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
template-uninstall template-uuid=template_uuid [--force]
Deinstallieren Sie eine benutzerdefinierte Vorlage. Durch diesen Vorgang werden die VDIs gelöscht, die von dieser Vorlage als “Eigentümer” gekennzeichnet sind.
Aktualisierungsbefehle
Der folgende Abschnitt enthält Aktualisierungsbefehle für Citrix Hypervisor Server.
Die Aktualisierungsobjekte können mit dem Standard-Objektauflistungsbefehl (xe update-list
) aufgelistet und mit den Standardparameter-Befehlen manipuliert werden. Weitere Informationen finden Sie unter Low-Level-Parameterbefehle
Parameter aktualisieren
Citrix Hypervisor-Server-Updates haben die folgenden Parameter:
Parametername | Beschreibung | Typ |
---|---|---|
uuid |
Der eindeutige Bezeichner/Objektreferenz für das Update | Lesezugriff |
host |
Die Liste der Hosts, auf die dieses Update angewendet wird | Lesezugriff |
host-uuid |
Der eindeutige Bezeichner für den Citrix Hypervisor-Server, der abgefragt werden soll | Lesezugriff |
name-label |
Der Name des Updates | Lesezugriff |
name-description |
Die Beschreibungszeichenfolge des Updates | Lesezugriff |
applied |
Gibt an, ob das Update angewendet wurde oder nicht; true oder false | Lesezugriff |
installation-size |
Die Größe des Updates in Bytes | Lesezugriff |
after-apply-guidance |
Ob der XAPI-Toolstack oder der Host einen Neustart erfordert | Lesezugriff |
version |
Die Version des Updates | Lesezugriff |
update-upload
update-upload file-name=update_filename
Laden Sie eine angegebene Update-Datei auf den Citrix Hypervisor-Server hoch. Mit diesem Befehl wird ein Update vorbereitet, das angewendet werden soll. Bei Erfolg wird die UUID des hochgeladenen Updates gedruckt. Wenn das Update zuvor hochgeladen wurde, wird stattdessen ein UPDATE_ALREADY_EXISTS
Fehler zurückgegeben und der Patch wird nicht erneut hochgeladen.
update-precheck
update-precheck uuid=update_uuid host-uuid=host_uuid
Führen Sie die im angegebenen Update enthaltenen Vorabprüfungen auf dem angegebenen Citrix Hypervisor-Server aus.
update-destroy
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
update-apply host-uuid=host_uuid uuid=update_file_uuid
Wenden Sie die angegebene Update-Datei an.
update-pool-apply
update-pool-apply uuid=update_uuid
Wenden Sie das angegebene Update auf alle Citrix Hypervisor-Server im Pool an.
update-introduce
update-introduce vdi-uuid=vdi_uuid
Einführung des Update-VDI.
update-pool-clean
update-pool-clean uuid=uuid
Entfernt die Dateien des Updates von allen Hosts im Pool.
Benutzerbefehle
user-password-change
user-password-change old=old_password new=new_password
Ändert das Kennwort des angemeldeten Benutzers. Das alte Kennwortfeld ist nicht aktiviert, da Sie Supervisor-Privileg benötigen, um diesen Befehl zu verwenden.
VBD-Befehle
Befehle zum Arbeiten mit VBDs (Virtual Block Devices).
Eine VBD ist ein Softwareobjekt, das eine VM mit dem VDI verbindet, der den Inhalt des virtuellen Laufwerks darstellt. Die VBD hat die Attribute, die den VDI an die VM binden (ist es bootfähig, seine Lese-/Schreib-Metriken usw.). Der VDI enthält Informationen zu den physischen Attributen des virtuellen Laufwerks (welcher Typ von SR, ob der Datenträger freigegeben werden kann, ob das Medium schreibgeschützt oder schreibgeschützt ist usw.).
Die VBD-Objekte können mit dem Standard-Objektlistenbefehl (xe vbd-list
) aufgelistet und mit den Standardparameterbefehlen manipuliert werden. Weitere Informationen finden Sie unter Low-Level-Parameterbefehle
VBD-Parameter
VBDs haben die folgenden Parameter:
Parametername | Beschreibung | Typ |
---|---|---|
uuid |
Der eindeutige Bezeichner/Objektreferenz für die VBD | Lesezugriff |
vm-uuid |
Der eindeutige Bezeichner/Objektreferenz für die VM, an die diese VBD angehängt ist | Lesezugriff |
vm-name-label |
Der Name der VM, an die diese VBD angehängt ist | Lesezugriff |
vdi-uuid |
Der eindeutige Bezeichner/Objektreferenz für den VDI, dem diese VBD zugeordnet ist | Lesezugriff |
vdi-name-label |
Der Name des VDI, dem diese VBD zugeordnet ist | Lesezugriff |
empty |
Wenn true diese VBD ein leeres Laufwerk darstellt |
Lesezugriff |
device |
Das Gerät, das vom Gast gesehen wird, zum Beispiel hda
|
Lesezugriff |
userdevice |
Gerätenummer vbd-create , die durch den Geräteparameter angegeben wird, z. B. 0 für hda , 1 für hdb usw. |
Lese-/Schreibrechte |
bootable |
True, wenn diese VBD bootfähig ist | Lese-/Schreibrechte |
mode |
Der Modus, in dem der VBD mit | Lese-/Schreibrechte |
type |
Wie die VBD der VM angezeigt wird, z. B. Festplatte oder CD | Lese-/Schreibrechte |
currently-attached |
True, wenn die VBD auf diesem Host angehängt ist, andernfalls false | Lesezugriff |
storage-lock |
True, wenn eine Sperre auf Speicherebene erworben wurde | Lesezugriff |
status-code |
Fehler-/Erfolgscode, der mit der letzten Anfügeoperation verknüpft ist | Lesezugriff |
status-detail |
Fehler-/Erfolgsinformationen, die mit dem Status des letzten Anfügevorgangs verknüpft sind | Lesezugriff |
qos_algorithm_type |
Der zu verwendende QoS-Algorithmus | Lese-/Schreibrechte |
qos_algorithm_params |
Parameter für den gewählten QoS-Algorithmus | Map-Parameter mit Lese-/Schreibzugriff |
qos_supported_algorithms |
Unterstützte QoS-Algorithmen für diese VBD | Schreibgeschützte Parameter festlegen |
io_read_kbs |
Durchschnittliche Leserate in kB pro Sekunde für diese VBD | Lesezugriff |
io_write_kbs |
Durchschnittliche Schreibrate in kB pro Sekunde für diese VBD | Lesezugriff |
allowed-operations |
Liste der in diesem Zustand zulässigen Vorgänge. Diese Liste ist nur beratend, und der Serverstatus hat sich möglicherweise geändert, wenn dieses Feld von einem Client gelesen wird. | Schreibgeschützte Parameter festlegen |
current-operations |
Verknüpft jede der ausgeführten Aufgaben, die dieses Objekt verwenden (als Referenz), mit einer current_operation -Enumeration, die die Art der Aufgabe beschreibt. | Schreibgeschützte Parameter festlegen |
unpluggable |
True, wenn diese VBD Hot Unplug unterstützt | Lese-/Schreibrechte |
attachable |
True, wenn das Gerät angeschlossen werden kann | Lesezugriff |
other-config |
Zusätzliche Konfiguration | Map-Parameter mit Lese-/Schreibzugriff |
vbd-create
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 device
Feld sind Ganzzahlen 0—15, und die Zahl muss für jede VM eindeutig sein. Die aktuell zulässigen Werte sind im Parameter allowed-VBD-devices
auf der angegebenen VM zu sehen. Dies wird wie userdevice
in den Parametern vbd
gesehen.
Wenn das type
ist Disk
, vdi-uuid
ist erforderlich. Der Modus kann RO
oder RW
für einen Datenträger sein.
Wenn das type
ist CD
, vdi-uuid
ist optional. Wenn kein VDI angegeben ist, wird eine leere VBD für die CD erstellt. Der Modus muss RO
für eine CD sein.
vbd-destroy
vbd-destroy uuid=uuid_of_vbd
Zerstören Sie die angegebene VBD.
Wenn der Parameter other-config:owner
für die VBD auf true
festgelegt ist, wird auch der zugehörige VDI zerstört.
vbd-eject
vbd-eject uuid=uuid_of_vbd
Entfernen Sie das Medium aus dem Laufwerk, das durch eine VBD dargestellt wird. Dieser Befehl funktioniert nur, wenn es sich um einen Wechseldatenträger handelt (eine physische CD oder ein ISO). Andernfalls wird eine Fehlermeldung VBD_NOT_REMOVABLE_MEDIA
zurückgegeben.
vbd-insert
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 es sich um einen Wechseldatenträger handelt (eine physische CD oder ein ISO). Andernfalls wird eine Fehlermeldung VBD_NOT_REMOVABLE_MEDIA
zurückgegeben.
vbd-plug
vbd-plug uuid=uuid_of_vbd
Versuchen Sie, die VBD anzuhängen, während sich die VM im laufenden Zustand befindet.
vbd-unplug
vbd-unplug uuid=uuid_of_vbd
Versucht, die VBD von der VM zu trennen, während sie sich im laufenden Zustand befindet.
VDI-Befehle
Befehle zum Arbeiten mit VDIs (Virtual Disk Images).
Ein VDI ist ein Softwareobjekt, das den Inhalt des virtuellen Laufwerks darstellt, der von einer VM angezeigt wird. Dies unterscheidet sich von der VBD, bei der es sich um ein Objekt handelt, das eine VM mit dem VDI verbindet. Der VDI enthält Informationen zu den physischen Attributen des virtuellen Laufwerks (welcher Typ von SR, ob der Datenträger freigegeben werden kann, ob das Medium schreibgeschützt oder schreibgeschützt ist usw.). Die VBD hat die Attribute, die den VDI an die VM binden (ist es bootfähig, seine Lese-/Schreib-Metriken usw.).
Die VDI-Objekte können mit dem Standard-Objektlistenbefehl (xe vdi-list
) aufgelistet und mit den Standardparameterbefehlen manipuliert werden. Weitere Informationen finden Sie unter Low-Level-Parameterbefehle
VDI-Parameter
VDIs haben folgende Parameter:
Parametername | Beschreibung | Typ |
---|---|---|
uuid |
Die eindeutige Identifikator/Objektreferenz für den VDI | Lesezugriff |
name-label |
Der Name des VDI | Lese-/Schreibrechte |
name-description |
Die Beschreibungszeichenfolge des VDI | Lese-/Schreibrechte |
allowed-operations |
Eine Liste der in diesem Zustand zulässigen Vorgänge | Schreibgeschützte Parameter festlegen |
current-operations |
Eine Liste der Vorgänge, die derzeit auf diesem VDI ausgeführt werden | Schreibgeschützte Parameter festlegen |
sr-uuid |
SR, in dem sich der VDI befindet | Lesezugriff |
vbd-uuids |
Eine Liste der VBDs, die auf diesen VDI verweisen | Schreibgeschützte Parameter festlegen |
crashdump-uuids |
Liste der Absturzdumps, die auf diesen VDI verweisen | Schreibgeschützte Parameter festlegen |
virtual-size |
Größe des Datenträgers, wie der VM dargestellt, in Byte. Je nach Speicher-Back-End-Typ kann die Größe nicht genau eingehalten werden | Lesezugriff |
physical-utilisation |
Menge des physischen Speicherplatzes, den der VDI auf dem SR belegt, in Bytes | Lesezugriff |
type |
Typ des VDI, z. B. System oder Benutzer | Lesezugriff |
sharable |
True, wenn dieser VDI freigegeben werden kann | Lesezugriff |
read-only |
True, wenn dieser VDI nur schreibgeschützt bereitgestellt werden kann | Lesezugriff |
storage-lock |
True, wenn dieser VDI auf Speicherebene gesperrt ist | Lesezugriff |
parent |
Verweist auf den übergeordneten VDI, wenn dieser VDI Teil einer Kette ist | Lesezugriff |
missing |
True, wenn der SR-Scanvorgang diesen VDI als nicht vorhanden gemeldet hat | Lesezugriff |
other-config |
Zusätzliche Konfigurationsinformationen für diesen VDI | Map-Parameter mit Lese-/Schreibzugriff |
sr-name-label |
Name des enthaltenden Speicher-Repositorys | Lesezugriff |
location |
Standortinformationen | Lesezugriff |
managed |
True, wenn der VDI verwaltet wird | Lesezugriff |
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-Back-Ends setzen dieses Feld in der Regel ein vdi_attach . |
Schreibgeschützte Map-Parameter |
sm-config |
SM-abhängige Daten | Schreibgeschützte Map-Parameter |
is-a-snapshot |
True, wenn es sich bei diesem VDI um einen VM-Speicher-Snapshot handelt | Lesezugriff |
snapshot_of |
Die UUID des Speichers dieses VDI ist ein Snapshot von | Lesezugriff |
snapshots |
Die UUIDs aller Snapshots dieses VDI | Lesezugriff |
snapshot_time |
Der Zeitstempel des Snapshot-Vorgangs, der diesen VDI erstellt hat | Lesezugriff |
metadata-of-pool |
Die UUID des Pools, der diesen Metadaten-VDI erstellt hat | Lesezugriff |
metadata-latest |
Flag, das angibt, ob der VDI die neuesten bekannten Metadaten für diesen Pool enthält | Lesezugriff |
cbt-enabled |
Flag, das angibt, ob Changed Block Tracking für den VDI aktiviert ist | Lese-/Schreibrechte |
vdi-clone
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 vdi-copy
davon ist Hochgeschwindigkeits-Image-Klon-Einrichtungen verfügbar machen, wo sie existieren.
Verwenden Sie den optionalen Zuordnungsparameter driver-params
, um zusätzliche herstellerspezifische Konfigurationsinformationen an den Back-End-Speichertreiber zu übergeben, auf dem der VDI basiert. Weitere Informationen finden Sie in der Dokumentation zum Speicherherstellertreiber.
vdi-copy
vdi-copy uuid=uuid_of_the_vdi sr-uuid=uuid_of_the_destination_sr
Kopieren Sie einen VDI in einen angegebenen SR.
vdi-create
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
Erstellen Sie einen VDI.
Der Parameter virtual-size
kann in Bytes oder mit den IEC-Standardsuffixe KiB, MiB, GiB und TiB angegeben werden.
Hinweis:
SR-Typen, die Thin Provisioning von Datenträgern unterstützen (z. B. lokale virtuelle Festplatte und NFS), erzwingen keine virtuelle Zuweisung von Datenträgern. Achten Sie bei der übermäßigen Zuweisung von virtuellem Festplattenspeicher auf einer SR auf große Sorgfalt. Wenn eine überlastete SR voll ist, muss Speicherplatz entweder auf dem SR-Zielsubstrat oder durch Löschen nicht verwendeter VDIs im SR zur Verfügung gestellt werden.
Einige SR-Typen können den
virtual-size
Wert aufrunden, um ihn durch eine konfigurierte Blockgröße teilbar zu machen.
vdi-data-destroy
vdi-data-destroy uuid=uuid_of_vdi
Löschen Sie die mit dem angegebenen VDI verknüpften Daten, behalten Sie jedoch die Changed Block Tracking-Metadaten bei.
Hinweis:
Wenn Sie Changed Block Tracking verwenden, um inkrementelle Backups des VDI zu erstellen, stellen Sie sicher, dass Sie den Befehl
vdi-data-destroy
verwenden, um Snapshots zu löschen, aber die Metadaten beizubehalten. Verwenden Sie die Optionvdi-destroy
nicht für Snapshots von VDIs, bei denen Changed Block Tracking aktiviert wurde.
vdi-destroy
vdi-destroy uuid=uuid_of_vdi
Zerstören Sie den angegebenen VDI.
Hinweis:
Wenn Sie Changed Block Tracking verwenden, um inkrementelle Backups des VDI zu erstellen, stellen Sie sicher, dass Sie den Befehl
vdi-data-destroy
verwenden, um Snapshots zu löschen, aber die Metadaten beizubehalten. Verwenden Sie die Optionvdi-destroy
nicht für Snapshots von VDIs, bei denen Changed Block Tracking aktiviert wurde.Bei lokalen VHD- und NFS-SR-Typen wird Speicherplatz nicht sofort freigegeben
vdi-destroy
, sondern in regelmäßigen Abständen während eines Speicherrepository-Scans. Wenn Sie erzwingen müssen, dass gelöschter Speicherplatz zur Verfügung gestellt wird, rufen Sie [sr-scan
] (#sr -scan) manuell auf.
vdi-disable-cbt
vdi-disable-cbt uuid=uuid_of_vdi
Deaktivieren Sie Changed Block Tracking für den VDI.
vdi-enable-cbt
vdi-enable-cbt uuid=uuid_of_vdi
Aktivieren Sie Changed Block Tracking für den VDI.
Hinweis:
Sie können Changed Block Tracking nur auf lizenzierten Instanzen von Citrix Hypervisor Premium Edition aktivieren.
vdi-export
vdi-export uuid=uuid_of_vdi filename=filename_to_export_to [format=format] [base=uuid_of_base_vdi] [--progress]
Exportieren Sie einen VDI in den angegebenen Dateinamen. Sie können einen VDI in einem der folgenden Formate exportieren:
raw
vhd
Das VHD-Format kann spärlichsein. Wenn im VDI nicht zugewiesene Blöcke vorhanden sind, werden diese Blöcke möglicherweise aus der VHD-Datei weggelassen, wodurch die VHD-Datei verkleinert wird. Sie können von allen unterstützten VHD-basierten Speichertypen (EXT, NFS) in das VHD-Format exportieren.
Wenn Sie den Parameter base
angeben, exportiert dieser Befehl nur die Blöcke, die sich zwischen dem exportierten VDI und dem Basis-VDI geändert haben.
vdi-forget
vdi-forget uuid=uuid_of_vdi
Entfernt bedingungslos einen VDI-Datensatz aus der Datenbank, ohne das Speicher-Back-End zu berühren. Im normalen Betrieb sollten Sie stattdessen [vdi-destroy
] (#vdi-destroy) verwenden.
vdi-import
vdi-import uuid=uuid_of_vdi filename=filename_to_import_from [format=format] [--progress]
Importieren Sie einen VDI. Sie können einen VDI aus einem der folgenden Formate importieren:
raw
vhd
vdi-introduce
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]
Erstellen Sie ein VDI-Objekt, das ein vorhandenes Speichergerät darstellt, ohne den Speicher tatsächlich zu ändern oder zu erstellen. Dieser Befehl wird hauptsächlich intern verwendet, um Hot-Plug-Speichergeräte automatisch einzuführen.
vdi-list-changed-blocks
vdi-list-changed-blocks vdi-from-uuid=first-vdi-uuid vdi-to-uuid=second-vdi-uuid
Vergleichen Sie zwei VDIs und geben Sie die Liste der Blöcke, die sich zwischen den beiden geändert haben, als base64-codierte Zeichenfolge zurück. Dieser Befehl funktioniert nur für VDIs, bei denen die Changed Block Tracking aktiviert wurde.
Weitere Informationen finden Sie unter Changed Block Tracking.
vdi-pool-migrate
vdi-pool-migrate uuid=VDI_uuid sr-uuid=destination-sr-uuid
Migrieren Sie einen VDI zu einem angegebenen SR, während der VDI an einen laufenden Gast angeschlossen ist. (Speicher-Livemigration)
Weitere Informationen finden Sie unter Migrieren von VMs.
vdi-resize
vdi-resize uuid=vdi_uuid disk-size=new_size_for_disk
Ändern Sie die Größe des VDI, der durch UUID angegeben wird.
vdi-snapshot
vdi-snapshot uuid=uuid_of_the_vdi [driver-params=params]
Erstellt eine Version mit Lese-/Schreibzugriff eines VDI, die als Referenz für Backup- oder Vorlagenerstellungszwecke oder beides verwendet werden kann. Verwenden Sie den Snapshot, um ein Backup durchzuführen, anstatt Backupsoftware innerhalb der VM zu installieren und auszuführen. Die VM wird weiterhin ausgeführt, während externe Backupsoftware den Inhalt des Snapshots auf das Backupmedium streamt. Ebenso 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 Zuordnungsparameter driver-params
, um zusätzliche herstellerspezifische Konfigurationsinformationen an den Back-End-Speichertreiber zu übergeben, auf dem der VDI basiert. Weitere Informationen finden Sie in der Dokumentation zum Speicherherstellertreiber.
Ein Klon eines Snapshots sollte immer einen beschreibbaren VDI erzeugen.
vdi-unlock
vdi-unlock uuid=uuid_of_vdi_to_unlock [force=true]
Versucht, die angegebenen VDIs zu entsperren. Wenn an den Befehl übergeben force=true
wird, erzwingt er den Entsperrvorgang.
vdi-update
vdi-update uuid=uuid
Aktualisieren Sie die Felder des VDI-Objekts in der Datenbank.
VIF-Befehle
Befehle zum Arbeiten mit VIFs (Virtuelle Netzwerkschnittstellen).
Die VIF-Objekte können mit dem Standard-Objektlistenbefehl (xe vif-list
) aufgelistet und mit den Standardparameterbefehlen manipuliert werden. Weitere Informationen finden Sie unter Low-Level-Parameterbefehle
VIF-Parameter
VIFs haben folgende Parameter:
-
uuid
( schreibgeschützt) die eindeutige Identifikator/Objektreferenz für das VIF -
vm-uuid
( schreibgeschützt) die eindeutige Kennung/Objektreferenz für die VM, auf der sich diese VIF befindet -
vm-name-label
( schreibgeschützt) den Namen der VM, auf der sich diese VIF befindet -
allowed-operations
( schreibgeschützter Parameter) eine Liste der in diesem Zustand zulässigen Operationen -
current-operations
( schreibgeschützter Parameter) eine Liste der Vorgänge, die derzeit auf diesem VIF ausgeführt werden -
device
( schreibgeschützt) Ganzzahl-Label dieser VIF, die die Reihenfolge angibt, in der VIF-Back-Ends erstellt wurden -
MAC
( schreibgeschützte) MAC-Adresse von VIF, wie sie der VM ausgesetzt ist -
MTU
( schreibgeschützt) Maximale Übertragungseinheit des VIF in Bytes.Dieser Parameter ist schreibgeschützt, Sie können jedoch die MTU-Einstellung mit dem Schlüssel
mtu
überschreiben mit dem Map-Parameterother-config
. 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) QoS-Algorithmus zu verwenden -
qos_algorithm_params
( Read/Write Map-Parameter) Parameter für den gewählten QoS-Algorithmus -
qos_supported_algorithms
( schreibgeschützter Parameter) unterstützte QoS-Algorithmen für dieses VIF -
MAC-autogenerated
( schreibgeschützt) True, wenn die MAC-Adresse des VIF automatisch generiert wurde -
other-config
( Map-Parameter Lese-/Schreibzugriff) zusätzlichekey:value
-Konfigurationspaare -
other-config:ethtoolrx
( Lesen/Schreiben) auf on gesetzt, um Empfangsprüfsumme zu aktivieren, aus, um zu deaktivieren -
other-config:ethtooltx
( Lesen/Schreiben) auf on gesetzt, um die Übertragungs-Prüfsumme zu aktivieren, aus, um zu deaktivieren -
other-config:ethtoolsg
( Lesen/Schreiben) auf on gesetzt, um Scatter Gather zu aktivieren, aus, um zu deaktivieren -
other-config:ethtooltso
( Lese-/Schreibzugriff) auf on gesetzt, um TCP Segmentierung Offload zu aktivieren, aus, um zu deaktivieren -
other-config:ethtoolufo
( Lese-/Schreibzugriff) auf on gesetzt, um UDP-Fragmentabladung zu aktivieren, aus, um -
other-config:ethtoolgso
( Lesen/Schreiben) auf on gesetzt, um generische Segmentierung Offload zu aktivieren, aus, um zu deaktivieren -
other-config:promiscuous
( Lesen/Schreiben) auf eine VIF zutreffen, um auf der Bridge promiscuous zu sein, so dass der gesamte Datenverkehr über die Bridge angezeigt wird. Nützlich für die Ausführung eines Intrusion Detection Systems (IDS) oder ähnlichem in einer VM. -
network-uuid
( schreibgeschützt) die eindeutige Kennung/Objektreferenz des virtuellen Netzwerks, mit dem diese VIF verbunden ist -
network-name-label
( schreibgeschützt) der beschreibende Name des virtuellen Netzwerks, mit dem diese VIF verbunden ist -
io_read_kbs
( schreibgeschützt) durchschnittliche Leserate in KB/s für dieses VIF -
io_write_kbs
( schreibgeschützt) durchschnittliche Schreibrate in KB/s für dieses VIF -
locking_mode
( Lese-/Schreibzugriff) Beeinflusst die VIF-Fähigkeit, Datenverkehr nach/aus einer Liste von MAC- und IP-Adressen zu filtern. Erfordert zusätzliche Parameter. -
locking_mode:default
( Lese-/Schreibzugriff) Variiert je nach dem Standardsperrmodus für das VIF-Netzwerk.Wenn der Standardsperrmodus auf festgelegt ist
disabled
, wendet Citrix Hypervisor eine Filterregel an, damit die VIF keinen Datenverkehr senden oder empfangen kann. Wenn der Standardsperrmodus auf festgelegt istunlocked
, entfernt Citrix Hypervisor alle Filterregeln, die der VIF zugeordnet sind. Weitere Informationen finden Sie unter Netzwerk-Befehle. -
locking_mode:locked
( Lese-/Schreibzugriff) Nur Datenverkehr, der an die angegebenen MAC- und IP-Adressen gesendet wird, ist auf dem VIF zulässig. Wenn keine IP-Adressen angegeben werden, ist kein Datenverkehr zulässig. -
locking_mode:unlocked
( Lese-/Schreibzugriff) Es werden keine Filter auf Datenverkehr angewendet, der zum oder von der VIF geht. -
locking_mode:disabled
( Lese-/Schreibzugriff) Citrix Hypervisor wendet eine Filterregel an, so dass die VIF den gesamten Datenverkehr löscht.
vif-create
vif-create vm-uuid=uuid_of_the_vm device=see below network-uuid=uuid_of_network_to_connect_to [mac=mac_address]
Erstellen Sie eine VIF auf einer VM.
Die entsprechenden Werte für das device
Feld werden im Parameter allowed-VIF-devices
auf der angegebenen VM aufgeführt. Bevor dort VIFs existieren, sind die zulässigen Werte ganze Zahlen von 0-15.
Der Parameter mac
ist die Standard-MAC-Adresse im Format aa:bb:cc:dd:ee:ff
. Wenn Sie es nicht spezifiziert lassen, wird eine entsprechende zufällige MAC-Adresse erstellt. Sie können auch explizit eine zufällige MAC-Adresse festlegen, indem Sie angeben mac=random
.
vif-destroy
vif-destroy uuid=uuid_of_vif
Zerstöre ein VIF.
vif-move
vif-move uuid=uuid network-uuid=network_uuid
Verschieben Sie die VIF in ein anderes Netzwerk.
vif-plug
vif-plug uuid=uuid_of_vif
Versuchen Sie, die VIF anzuhängen, während sich die VM im laufenden Zustand befindet.
vif-unplug
vif-unplug uuid=uuid_of_vif
Versucht, die VIF von der VM zu trennen, während sie ausgeführt wird.
vif-configure-ipv4
Konfigurieren Sie IPv4-Einstellungen für diese virtuelle Schnittstelle. Legen Sie IPv4-Einstellungen wie folgt fest:
vif-configure-ipv4 uuid=uuid_of_vif mode=static address=CIDR_address gateway=gateway_address
Beispiel:
VIF.configure_ipv4(vifObject,"static", " 192.168.1.10/24", " 192.168.1.1")
Reinigen Sie IPv4-Einstellungen wie folgt:
vif-configure-ipv4 uuid=uuid_of_vif mode=none
vif-configure-ipv6
Konfigurieren Sie IPv6-Einstellungen für diese virtuelle Schnittstelle. Legen Sie IPv6-Einstellungen wie folgt fest:
vif-configure-ipv6 uuid=uuid_of_vif mode=static address=IP_address gateway=gateway_address
Beispiel:
VIF.configure_ipv6(vifObject,"static", "fd06:7768:b9e5:8b00::5001/64", "fd06:7768:b9e5:8b00::1")
Reinigen Sie IPv6-Einstellungen wie folgt:
vif-configure-ipv6 uuid=uuid_of_vif mode=none
VLAN-Befehle
Befehle für die Arbeit mit VLANs (virtuelle Netzwerke). Informationen zum Auflisten und Bearbeiten virtueller Schnittstellen finden Sie in den PIF-Befehlen, die über einen VLAN-Parameter signalisieren, dass sie über ein zugeordnetes virtuelles Netzwerk verfügen. Weitere Informationen finden Sie unter PIF-Befehle. Um beispielsweise VLANs aufzulisten, verwenden Sie xe pif-list
.
vlan-create
vlan-create pif-uuid=uuid_of_pif vlan=vlan_number network-uuid=uuid_of_network
Erstellen Sie ein VLAN auf dem Citrix Hypervisor-Server.
pool-vlan-create
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 festlegen, welche Schnittstelle (z. B. eth0
) sich das angegebene Netzwerk befindet (auf jedem Host) und ein neues PIF-Objekt je Host entsprechend erstellen und anschließen.
vlan-destroy
vlan-destroy uuid=uuid_of_pif_mapped_to_vlan
Zerstören Sie ein VLAN. Erfordert die UUID des PIF, der das VLAN darstellt.
VM-Befehle
Befehle zum Steuern von VMs und deren Attributen.
VM-Selektoren
Einige der hier aufgeführten Befehle verfügen über einen gemeinsamen Mechanismus zum Auswählen einer oder mehrerer VMs, auf denen der Vorgang ausgeführt werden soll. Der einfachste Weg besteht darin, das Argument anzugeben vm=name_or_uuid
. Eine einfache Möglichkeit, die UUID einer tatsächlichen VM zu erhalten, besteht zum Beispiel darin, auszuführen xe vm-list power-state=running
. (Ruft die vollständige Liste der Felder ab, die mit dem Befehl xe vm-list params=all
abgeglichen werden können.) Wenn Sie z. B. power-state=halted
angeben, werden VMs ausgewählt, deren Parameter power-state
gleich halted
ist. Wenn mehrere VMs übereinstimmen, geben Sie die Option --multiple
zum Ausführen des Vorgangs an. Die vollständige Liste der Parameter, die abgeglichen werden können, wird am Anfang dieses Abschnitts beschrieben.
Die VM-Objekte können mit dem Standard-Objektlistenbefehl (xe vm-list
) aufgelistet und mit den Standardparameterbefehlen manipuliert werden. Weitere Informationen finden Sie unter Low-Level-Parameterbefehle
VM-Parameter
VMs haben die folgenden Parameter:
Hinweis:
Alle beschreibbaren VM-Parameterwerte können geändert werden, während die VM ausgeführt wird. Neue Parameter werden jedoch nicht dynamisch angewendet und können erst angewendet werden, wenn die VM neu gestartet wird.
-
appliance
( Lese-/Schreibzugriff) die Appliance/vApp, zu der die VM gehört -
uuid
( schreibgeschützt) den eindeutigen Bezeichner/Objektreferenz für die VM -
name-label
( Lese-/Schreibzugriff) den Namen der VM -
name-description
( Lese-/Schreibzugriff) die Beschreibungszeichenfolge der VM -
order start order
( Lese-/Schreibzugriff) für das Starten/Herunterfahren von vApp und für den Start nach HA-Failover -
version
( schreibgeschützt), wie oft diese VM wiederhergestellt wurde. Wenn Sie eine neue VM mit einer älteren Version überschreiben möchten, rufen Sievm-recover
-
user-version
( Lese-/Schreibzeichenfolge) für Ersteller von VMs und Vorlagen, um Versionsinformationen zu setzen -
is-a-template
( Lese-/Schreibzugriff) False, es sei denn, diese VM ist eine Vorlage. Vorlagen-VMs können nie gestartet werden, sie werden nur zum Klonen anderer VMs verwendet. Nachdem dieser Wert auf “true” gesetzt wurde, kann er nicht auf “false” zurückgesetzt werden. Vorlagen-VMs können mit diesem Parameter nicht in VMs konvertiert werden. -
is-control-domain
( schreibgeschützt) True, wenn es sich um eine Steuerdomäne handelt (Domäne 0 oder Treiberdomäne) -
power-state
( schreibgeschützt) aktueller Stromzustand -
start-delay
( Lese-/Schreibzugriff) die Verzögerung, die vor einem Aufruf zum Starten der VM zu warten ist, gibt -
shutdown-delay
( Lese-/Schreibzugriff) die Wartezeit, 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 (absolutes) Maximum in Bytes gesetzt. Wenn Sie diesen Wert ändern möchten, muss die VM heruntergefahren werden. -
memory-static-min
( Lese-/Schreibzugriff) statisch (absolut) Minimum in Bytes gesetzt. Wenn Sie diesen Wert ändern möchten, muss die VM heruntergefahren werden. -
suspend-VDI-uuid
( schreibgeschützt) den VDI, auf dem ein Suspend-Image gespeichert ist -
VCPUs-params
(Lese-/Schreibzuordnungsparameter) Konfigurationsparameter für die ausgewählte vCPU-Richtlinie.Sie können das Pinning einer vCPU mit
xe vm-param-set uuid=<vm_uuid> VCPUs-params:mask=1,2,3
Die ausgewählte VM wird dann nur auf physischen CPUs 1, 2 und 3 ausgeführt. Sie können auch die vCPU-Priorität (xen-Scheduling) mit den Parametern “cap” und “weight” einstellen. Beispiel:
xe vm-param-set uuid=<vm_uuid> VCPUs-params:weight=512 xe vm-param-set uuid=<vm_uuid> VCPUs-params:cap=100
Eine VM mit einer Gewichtung von 512 erhält doppelt so viel CPU wie eine Domäne mit einer Gewichtung von 256 auf einem umstrittenen Citrix Hypervisor-Server. Die zulässigen Gewichtungen liegen zwischen 1 und 65535 und der Standardwert ist 256. Die Obergrenze fixiert optional die maximale CPU-Anzahl, die eine VM verbrauchen kann, selbst wenn der Citrix Hypervisor-Server über CPU-Zyklen im Leerlauf verfügt. Die Obergrenze wird in Prozent einer physischen CPU ausgedrückt: 100 ist 1 physische CPU, 50 ist eine halbe CPU, 400 ist 4 CPUs usw. Der Standardwert 0 bedeutet, dass keine obere Kappe vorhanden ist.
-
VCPUs-max
( Lese-/Schreibzugriff) maximale Anzahl virtueller CPUs. -
VCPUs-at-startup
( Lese-/Schreibzugriff) Boot-Nummer virtueller CPUs -
actions-after-crash
( Lese-/Schreibzugriff) -Aktion, die ausgeführt werden soll, wenn die VM abstürzt. Für PV-Gäste gelten folgende Parameter:-
preserve
( nur zur Analyse) -
coredump_and_restart
( Coredump aufzeichnen und VM neu starten) -
coredump_and_destroy
( Notieren Sie einen Coredump und lassen Sie die VM angehalten) -
restart
( kein Coredump und Neustart der VM) -
destroy
( kein Coredump und VM angehalten lassen)
-
-
console-uuids
( schreibgeschützter Parameter) virtuelle Konsolengeräte -
platform
( Map-Parameter Lese-/Schreibzugriff) plattformspezifische KonfigurationSo deaktivieren Sie den 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
(schreibgeschützter Parameter) Liste der zulässigen Operationen für diesem Status -
current-operations
( schreibgeschützter Parameter) eine Liste der Vorgänge, die derzeit auf der VM ausgeführt werden -
allowed-VBD-devices
( schreibgeschützter Parameter) Liste der zur Verwendung verfügbaren VBD-Bezeichner, dargestellt durch Ganzzahlen des Bereichs 0—15. Diese Liste ist nur informativ, und andere Geräte können verwendet werden (funktioniert aber möglicherweise nicht). -
allowed-VIF-devices
( schreibgeschützter Parameter) Liste der verfügbaren VIF-Bezeichner, dargestellt durch Ganzzahlen des Bereichs 0—15. Diese Liste ist nur informativ, und andere Geräte können verwendet werden (funktioniert aber möglicherweise nicht). -
HVM-boot-policy
( Lese-/Schreibzugriff) die Boot-Richtlinie für HVM-Gäste. Entweder BIOS-Reihenfolge oder eine leere Zeichenfolge. -
HVM-boot-params
( Parameter für Lese-/Schreibzuordnung) steuert der Order Key die HVM-Gast-Boot-Reihenfolge, die als Zeichenfolge dargestellt wird, wobei jedes Zeichen eine Boot-Methode ist: d für die CD/DVD, c für den Stammdatenträger und n für Netzwerk-PXE-Boot. Der Standardwert ist dc. -
HVM-shadow-multiplier
( Lese-/Schreibzugriff) Gleitkommawert, der die Menge an Schattenspeicheraufwand steuert, um der VM zu gewähren. Standardmäßig ist 1.0 (der Mindestwert), und nur fortgeschrittene Benutzer sollten diesen Wert ändern. -
PV-kernel
( Lese-/Schreibzugriff) Pfad zum Kernel -
PV-ramdisk
( Lese-/Schreibzugriff) -Pfad zum initrd -
PV-args
( Lese-/Schreibzugriff) Zeichenfolge von Kernel-Befehlszeilenargumenten -
PV-legacy-args
( Lese-/Schreibzugriff) Zeichenfolge von Argumenten, um Legacy-VMs zu booten -
PV-bootloader
( Lese-/Schreibzugriff) Name oder Pfad zum Bootloader -
PV-bootloader-args
( Lese-/Schreibzugriff) Zeichenfolge verschiedener Argumente für den Bootloader -
last-boot-CPU-flags
( schreibgeschützt) beschreibt die CPU-Flags, auf denen die VM zuletzt gebootet wurde -
resident-on
( schreibgeschützt) den Citrix Hypervisor-Server, auf dem sich eine VM befindet -
affinity
( Lese-/Schreibzugriff) Der Citrix Hypervisor-Server, auf dem die VM ausgeführt werden soll. Wird vom Befehlxe vm-start
verwendet, um zu entscheiden, wo die VM ausgeführt werden soll. -
other-config
( Zuordnungsparameter Lese-/Schreibzugriff) Eine Liste von Schlüssel-/Wert-Paaren, die zusätzliche Konfigurationsparameter für die VM angeben. Beispielsweise wird eine VM automatisch nach dem Host-Start gestartet, wenn der Parameterother-config
das Schlüssel-Wert-Paarauto_poweron: true
enthält -
start-time
( schreibgeschützt) Zeitstempel des Datums und der Uhrzeit, zu der die Metriken für die VM gelesen wurden. Dieser Zeitstempel hat die FormyyyymmddThh:mm:ss z
, wobei z der einzelne Buchstabe militärische Zeitzonenindikator ist, z. B. Z für UTC (GMT) -
install-time
( schreibgeschützt) Zeitstempel des Datums und der Uhrzeit, zu der die Metriken für die VM gelesen wurden. Dieser Zeitstempel hat die FormyyyymmddThh:mm:ss z
, wobei z der einzelne Buchstabe militärische Zeitzonenindikator ist, z. B. Z für UTC (GMT) -
memory-actual
( schreibgeschützt) der tatsächliche Speicher, der von einer VM verwendet wird -
VCPUs-number
( schreibgeschützt) die Anzahl der virtuellen CPUs, die der VM für eine Linux-VM zugewiesen sind. Diese Nummer kann von der VM abweichenVCPUS-max
und kann geändert werden, ohne die VM mit dem Befehlvm-vcpu-hotplug
neu zu starten. Weitere Informationen finden Sie unter [vm-vcpu-hotplug
] (#vm -vcpu-hotplug). Windows VMs werden immer mit der Anzahl der vCPUs ausgeführt, für dieVCPUsmax
eingestellt ist, und müssen neu gestartet werden, um diesen Wert zu ändern. Die Leistung sinkt stark, wennVCPUs-number
Sie einen Wert festlegen, der größer ist als die Anzahl der physischen CPUs auf dem Citrix Hypervisor-Server. -
VCPUs-Utilization
( schreibgeschützter Map-Parameter) eine Liste virtueller CPUs und deren Gewicht -
os-version
( schreibgeschützter Map-Parameter) die Version des Betriebssystems für die VM -
PV-drivers-version
( schreibgeschützter Map-Parameter) die Versionen der paravirtualisierten Treiber für die VM -
PV-drivers-detected
( schreibgeschützt) Flag für die neueste Version der paravirtualisierten Treiber für die VM -
memory
( schreibgeschützte Zuordnungsparameter) Speichermetriken, die vom Agenten auf der VM gemeldet werden -
disks
( schreibgeschützte Zuordnungsparameter) Datenträgermetriken, die vom Agent auf der VM gemeldet werden -
networks
( schreibgeschützte Zuordnungsparameter) Netzwerkmetriken, die vom Agenten auf der VM gemeldet werden -
other
( schreibgeschützter Zuordnungsparameter) andere Metriken, die vom Agenten auf der VM gemeldet werden -
guest-metrics-lastupdated
( schreibgeschützt) Zeitstempel, wenn der Gast-Agent den letzten Schreibvorgang in diese Felder durchgeführt hat. Der Zeitstempel ist in der FormyyyymmddThh:mm:ss z
, wobei z der militärische Zeitzonenindikator mit einem Buchstaben ist, z. B. Z für UTC (GMT) -
actions-after-shutdown
( Lese-/Schreibzugriff) -Aktion, die ausgeführt werden soll, nachdem die VM heruntergefahren wurde -
actions-after-reboot
( Lese-/Schreibzugriff) -Aktion, die ausgeführt werden soll, nachdem die VM neu gestartet wurde -
possible-hosts
potenzielle Hosts dieser VM schreibgeschützt -
dom-id
( schreibgeschützte) Domain-ID (falls vorhanden, andernfalls -1) -
recommendations
( schreibgeschützt) XML-Spezifikation der empfohlenen Werte und Bereiche für Eigenschaften dieser VM -
xenstore-data
( Read/Write Map-Parameter) Daten, die nach dem Erstellen der VM in der xenstore-Struktur (/local/domain/ domid/vm-data) eingefügt werden sollen -
is-a-snapshot
( schreibgeschützt) True, wenn diese VM ein Snapshot ist -
snapshot_of
( schreibgeschützt) die UUID der VM, zu der dieser Snapshot gehört -
snapshots
( schreibgeschützt) die UUIDs aller Snapshots dieser VM -
snapshot_time
( schreibgeschützt) der Zeitstempel des Snapshot-Vorgangs, der diesen VM-Snapshot erstellt hat -
memory-target
( schreibgeschützt) die Zielmenge des für diese VM festgelegten Speichers -
blocked-operations
( Parameter für Lese-/Schreibzuordnung) listet die Vorgänge auf, die auf dieser VM nicht ausgeführt werden können. -
last-boot-record
( schreibgeschützt) Datensatz der letzten Boot-Parameter für diese Vorlage im XML-Format -
ha-always-run
( Lese-/Schreibzugriff) True, wenn diese VM immer auf einem anderen Host neu gestartet wird, wenn ein Fehler des Hosts vorliegt, auf dem sie sich befindet. Dieser Parameter ist jetzt veraltet. Verwenden Sie stattdessen den Parameterha-restart-priority
. -
ha-restart-priority
( Lesen/Schreiben) Neustart oder Best-Aufwand -
blobs
( schreibgeschützter) binärer Datenspeicher -
live
( schreibgeschützt) True, wenn die VM ausgeführt wird. False, wenn HA vermutet, dass die VM nicht ausgeführt wird.
vm-assert-can-be-recovered
vm-assert-can-be-recovered uuid [database] vdi-uuid
Prüft, ob Speicher zur Wiederherstellung dieser VM verfügbar ist.
vm-call-plugin
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 einen “value” -String mit Sonderzeichen (z. B. neue Zeile) zu übergeben, kann eine alternative Syntax args:key:file=local_file verwendet werden, wobei der Inhalt von local_file abgerufen und dem “key” als Ganzes zugewiesen wird.
vm-cd-add
vm-cd-add cd-name=name_of_new_cd device=integer_value_of_an_available_vbd [vm-selector=vm_selector_value...]
Fügen Sie der ausgewählten VM eine neue virtuelle CD hinzu. Der Parameter device
sollte aus dem Wert des Parameters allowed-VBD-devices
der VM ausgewählt werden.
Die VM oder VMs, auf denen dieser Vorgang ausgeführt wird, werden über den Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten VM-Parameter sein.
vm-cd-eject
vm-cd-eject [vm-selector=vm_selector_value...]
Werfen Sie eine CD aus dem virtuellen CD-Laufwerk aus. Dieser Befehl funktioniert nur, wenn genau eine CD an die VM angeschlossen ist. Wenn zwei oder mehr CDs vorhanden sind, verwenden Sie den Befehl xe vbd-eject
und geben Sie die UUID der VBD an.
Die VM oder VMs, auf denen dieser Vorgang ausgeführt wird, werden über den Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten VM-Parameter sein.
vm-cd-insert
vm-cd-insert cd-name=name_of_cd [vm-selector=vm_selector_value...]
Legen Sie eine CD in das virtuelle CD-Laufwerk ein. Dieser Befehl funktioniert nur, wenn genau ein leeres CD-Gerät an die VM angeschlossen ist. Wenn zwei oder mehr leere CD-Geräte vorhanden sind, verwenden Sie den Befehl xe vbd-insert
und geben Sie die UUIDs der VBD und des einzufügenden VDI an.
Die VM oder VMs, auf denen dieser Vorgang ausgeführt wird, werden über den Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten VM-Parameter sein.
vm-cd-list
vm-cd-list [vbd-params] [vdi-params] [vm-selector=vm_selector_value...]
Listet CDs auf, die an die angegebenen VMs angehängt sind.
Die VM oder VMs, auf denen dieser Vorgang ausgeführt wird, werden über den Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten VM-Parameter sein.
Sie können auch auswählen, welche VBD- und VDI-Parameter aufgelistet werden sollen.
vm-cd-remove
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 eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten VM-Parameter sein.
vm-checkpoint
vm-checkpoint new-name-label=name_label [new-name-description=description]
Überprüfen Sie eine vorhandene VM, wobei Sie, sofern verfügbar, einen schnellen Festplatten-Snapshot-Vorgang auf Speicherebene verwenden.
vm-clone
vm-clone new-name-label=name_for_clone [new-name-description=description_for_clone] [vm-selector=vm_selector_value...]
Klonen einer vorhandenen VM mit schnellem Festplattenklonvorgang auf Speicherebene, sofern verfügbar. Geben Sie den Namen und die optionale Beschreibung für die resultierende geklonte VM mit den new-name-label
Argumenten new-name-description
und an.
Die VM oder VMs, auf denen dieser Vorgang ausgeführt wird, werden über den Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten VM-Parameter sein.
vm-compute-maximum-memory
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, der einer vorhandenen VM zugewiesen werden kann, wobei die Gesamtmenge des physischen RAM als Obergrenze verwendet wird. Der optionale Parameter approximate
reserviert ausreichend zusätzlichen Speicher in der Berechnung, um später zusätzliche vCPUs in die VM hinzuzufügen.
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 eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten VM-Parameter sein.
vm-compute-memory-overhead
vm-compute-memory-overhead
Berechnet den Virtualisierungsspeicheraufwand einer VM.
vm-copy
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, ohne den schnellen Festplattenklonvorgang auf Speicherebene zu verwenden (auch wenn diese Option verfügbar ist). Die Datenträgerimages der kopierten VM sind garantiert vollständige Images, d. h. nicht Teil einer Copy-on-Write (CoW) Kette.
Geben Sie den Namen und die optionale Beschreibung für die resultierende kopierte VM mit den new-name-label
Argumenten new-name-description
und an.
Geben Sie die Ziel-SR für die resultierende kopierte VM mit dem an sr-uuid
. Wenn dieser Parameter nicht angegeben ist, entspricht das Ziel der SR, in der sich die ursprüngliche VM befindet.
Die VM oder VMs, auf denen dieser Vorgang ausgeführt wird, werden über den Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten VM-Parameter sein.
vm-copy-bios-strings
vm-copy-bios-strings host-uuid=host_uuid
Kopieren Sie die BIOS-Strings des angegebenen Hosts auf die VM.
vm-crashdump-list
vm-crashdump-list [vm-selector=vm selector value...]
Listet 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 nicht verwendet params
wird, zeigt die zurückgegebene Liste eine Standard-Teilmenge aller verfügbaren Parameter an.
Die VM oder VMs, auf denen dieser Vorgang ausgeführt wird, werden über den Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten VM-Parameter sein.
vm-data-source-list
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 mithilfe des Standardauswahlmechanismus die VMs aus, auf denen dieser Vorgang ausgeführt werden soll. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten VM-Parameter sein. Wenn keine Parameter für die Auswahl von Hosts angegeben sind, wird der Vorgang auf allen VMs ausgeführt.
Datenquellen haben zwei Parameter — standard
und enabled
—, die Sie in der Ausgabe dieses Befehls sehen können. Wenn in einer Datenquelle enabled
auf true
festgelegt ist, werden die Metriken derzeit in der Performance-Datenbank aufgezeichnet. Wenn eine Datenquelle auf standard
festgelegt ist true
, werden die Metriken standardmäßig in der Performance-Datenbank aufgezeichnet (und enabled
ist auch true
für diese Datenquelle). Wenn eine Datenquelle auf standard
festgelegt ist false
, werden die Metriken standardmäßig nicht in der Performance-Datenbank aufgezeichnet (und enabled
ist auch auf false
für diese Datenquelle).
Führen Sie den Befehl vm-data-source-record
aus, um Datenquellen-Metriken in der Performance-Datenbank aufzuzeichnen. Dieser Befehl legt enabled
auf true
fest. Um zu stoppen, führen Sie vm-data-source-forget
aus. Dieser Befehl legt enabled
auf false
fest.
vm-data-source-record
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.
Bei diesem Vorgang werden die Informationen aus der Datenquelle in die Datenbank der persistenten Performance-Metriken der angegebenen VMs geschrieben. Aus Performance-Gründen unterscheidet sich diese Datenbank von der normalen Agentendatenbank.
Wählen Sie mithilfe des Standardauswahlmechanismus die VMs aus, auf denen dieser Vorgang ausgeführt werden soll. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten VM-Parameter sein. Wenn keine Parameter für die Auswahl von Hosts angegeben sind, wird der Vorgang auf allen VMs ausgeführt.
vm-data-source-forget
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 vergessen Sie alle aufgezeichneten Daten.
Wählen Sie mithilfe des Standardauswahlmechanismus die VMs aus, auf denen dieser Vorgang ausgeführt werden soll. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten VM-Parameter sein. Wenn keine Parameter für die Auswahl von Hosts angegeben sind, wird der Vorgang auf allen VMs ausgeführt.
vm-data-source-query
vm-data-source-query data-source=name_description_of_data-source [vm-selector=vm_selector_value...]
Zeigt die angegebene Datenquelle für eine VM an.
Wählen Sie mithilfe des Standardauswahlmechanismus die VMs aus, auf denen dieser Vorgang ausgeführt werden soll. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten VM-Parameter sein. Wenn keine Parameter für die Auswahl von Hosts angegeben sind, wird der Vorgang auf allen VMs ausgeführt.
vm-destroy
vm-destroy uuid=uuid_of_vm
Zerstören Sie die angegebene VM. Dadurch bleibt der Speicher, der der VM zugeordnet ist, intakt. Um den Speicher auch zu löschen, verwenden Sie xe vm-uninstall
.
vm-disk-add
vm-disk-add disk-size=size_of_disk_to_add device=uuid_of_device [vm-selector=vm_selector_value...]
Fügen Sie einen Datenträger zu den angegebenen VMs hinzu. Wählen Sie den Parameter device
aus dem Wert des Parameters allowed-VBD-devices
der VMs aus.
Der Parameter disk-size
kann in Bytes oder mit den IEC-Standardsuffixe KiB, MiB, GiB und TiB angegeben werden.
Die VM oder VMs, auf denen dieser Vorgang ausgeführt wird, werden über den Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten VM-Parameter sein.
vm-disk-list
vm-disk-list [vbd-params] [vdi-params] [vm-selector=vm_selector_value...]
Listet Festplatten auf, die den angegebenen VMs zugeordnet sind. Die Parameter vbd-params
und vdi-params
steuern die Felder der jeweiligen Objekte, die ausgegeben werden sollen. Geben Sie die Parameter als kommagetrennte Liste oder den speziellen Schlüssel all
für die vollständige Liste an.
Die VM oder VMs, auf denen dieser Vorgang ausgeführt wird, werden über den Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten VM-Parameter sein.
vm-disk-remove
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 eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten VM-Parameter sein.
vm-export
vm-export filename=export_filename [metadata=true|false] [vm-selector=vm_selector_value...]
Exportieren Sie die angegebenen VMs (einschließlich Datenträgerimages) in eine Datei auf dem lokalen Computer. Geben Sie den Dateinamen an, in den die VM exportiert werden soll, indem Sie den Parameter filename
verwenden. Nach Konvention sollte der Dateiname eine .xva
Erweiterung haben.
Wenn der Parameter metadata
true
ist, werden die Datenträger nicht exportiert. Nur die VM-Metadaten werden in die Ausgabedatei geschrieben. Verwenden Sie diesen Parameter, wenn der zugrunde liegende Speicher über andere Mechanismen übertragen wird und 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 eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten VM-Parameter sein.
vm-import
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 auf eingestellt preserve
ist true
, bleibt die MAC-Adresse der ursprünglichen VM erhalten. Die sr-uuid
bestimmt die Ziel-SR, in die die VM importiert werden soll. Wenn dieser Parameter nicht angegeben ist, wird der Standard-SR verwendet.
Wenn dies der Fall metadata
ist true
, können Sie einen zuvor exportierten Satz von Metadaten ohne die zugehörigen Datenträgerblöcke importieren. Nur-Metadaten-Import schlägt fehl, wenn VDIs nicht gefunden werden können (benannt nach SR und VDI.location
), es sei denn, die --force
Option 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 Import/Export von Metadaten eine schnelle Möglichkeit, VMs zwischen separaten Pools zu verschieben. Zum Beispiel im Rahmen eines Notfall-Wiederherstellungsplans.
Hinweis:
Mehrere VM-Importe werden schneller seriell ausgeführt, als parallel.
vm-install
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 template-uuid
Argument template
oder an. Geben Sie eine SR entweder mit dem sr-uuid
Argument sr-name-label
oder an. Geben Sie an, ob BIOS-gesperrte Medien mit dem copy-bios-strings-from
Argument installiert werden sollen.
Hinweis:
Bei der Installation von einer Vorlage mit vorhandenen Datenträgern werden standardmäßig neue Datenträger in derselben SR erstellt wie diese vorhandenen Datenträger. Wo der SR es unterstützt, sind diese Festplatten schnelle Kopien. Wenn in der Befehlszeile ein anderer SR angegeben wird, werden dort die neuen Datenträger erstellt. In diesem Fall ist eine schnelle Kopie nicht möglich und die Festplatten sind vollständige Kopien.
Bei der Installation von einer Vorlage, die keine vorhandenen Datenträger enthält, werden alle neuen Datenträger in der angegebenen SR oder die Pool-Standard-SR erstellt, wenn keine SR angegeben ist.
vm-is-bios-customized
vm-is-bios-customized
Gibt an, ob die BIOS-Strings der VM angepasst wurden.
vm-memory-balloon
vm-memory-balloon target=target
Legen Sie das Speicherziel für eine ausgeführte VM fest. Der angegebene Wert muss innerhalb des Bereichs liegen, der durch die Werte memory_dynamic_min und memory_dynamic_max der VM definiert ist.
vm-memory-dynamic-range-set
vm-memory-dynamic-range-set min=min max=max
Konfigurieren Sie den dynamischen Speicherbereich einer VM. Der dynamische Speicherbereich definiert weiche untere und obere Grenzwerte für den Arbeitsspeicher einer VM. Es ist möglich, diese Felder zu ändern, wenn eine VM ausgeführt oder angehalten wird. Der Dynamikbereich muss in den statischen Bereich passen.
vm-memory-limits-set
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
vm-memory-set memory=memory
Konfigurieren Sie die Speicherzuweisung einer VM.
vm-memory-shadow-multiplier-set
vm-memory-shadow-multiplier-set [vm-selector=vm_selector_value...] [multiplier=float_memory_multiplier]
Legen Sie den Schattenspeichermultiplikator für die angegebene VM fest.
Dies ist eine erweiterte Option, die die Menge des Schattenspeichers ändert, der einer hardwaregestützten VM zugewiesen ist.
Bei einigen spezialisierten Anwendungsarbeitslasten, z. B. Citrix Virtual Apps, ist zusätzlicher Shadow-Speicher erforderlich, um die volle Leistung zu erreichen.
Dieser Speicher wird als Overhead angesehen. Es ist von den normalen Arbeitsspeicherberechnungen für Accounting Memory zu einer 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 Arbeitsspeicher des Citrix Hypervisor or-Servers verfügbar ist, wird ein Fehler zurückgegeben.
Die VMs, auf denen dieser Vorgang ausgeführt werden soll, werden mithilfe des Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Selektoren.
vm-memory-static-range-set
vm-memory-static-range-set min=min max=max
Konfigurieren Sie den statischen Speicherbereich einer VM. Der statische Speicherbereich definiert harte Unter- und Obergrenzen für den Arbeitsspeicher einer VM. Es ist möglich, diese Felder nur zu ändern, wenn eine VM angehalten wird. Der statische Bereich muss den dynamischen Bereich umfassen.
vm-memory-target-set
vm-memory-target-set target=target
Legen Sie das Speicherziel für eine angehalten oder ausgeführte 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-memory-target-wait
vm-memory-target-wait
Warten Sie, bis eine laufende VM ihr aktuelles Speicherziel erreicht.
vm-migrate
vm-migrate [copy=true|false] [host-uuid=destination_host_uuid] [host=name_or_ uuid_of_destination_host] [force=true|false] [live=true|false] [vm-selector=vm_selector_value...] [remote-master=destination_pool_master_uuid] [remote-username=destination_pool_username] [remote-password=destination_pool_password] [remote-network=destination_pool_network_uuid ][vif:=vif_uuid] [vdi=vdi_uuid]
Mit diesem Befehl werden die angegebenen VMs zwischen physischen Hosts migriert. Der Parameter host
kann entweder der Name oder die UUID des Citrix Hypervisor-Servers sein. Zum Beispiel, um die VM auf einen anderen Host im Pool zu migrieren, auf dem sich die VM-Festplatten im Speicher befinden, der von beiden Hosts gemeinsam genutzt wird:
xe vm-migrate uuid=vm_uuid host-uuid=host_uuid
So verschieben Sie VMs zwischen Hosts im selben Pool, die keinen gemeinsamen Speicher verwenden (Speicher-Livemigration):
xe vm-migrate uuid=vm_uuid remote-master=12.34.56.78 \
remote-username=username remote-password=password \
host-uuid=desination_host_uuid vdi=vdi_uuid
Sie können den SR auswählen, in dem jeder VDI gespeichert wird:
xe vm-migrate uuid=vm_uuid host-uuid=destination_host_uuid \
vdi1:vdi_1_uuid=destination_sr_uuid \
vdi2:vdi_2_uuid=destination_sr2_uuid \
vdi3:vdi_3_uuid=destination_sr3_uuid
Darüber hinaus können Sie auswählen, welches Netzwerk die VM nach der Migration angeschlossen werden soll:
xe vm-migrate uuid=vm_uuid \
vdi1:vdi_1_uuid=destination_sr_uuid \
vdi2:vdi_2_uuid=destination_sr2_uuid \
vdi3:vdi_3_uuid=destination_sr3_uuid \
vif:vif_uuid=network_uuid
Für die Pool-übergreifende Migration:
xe vm-migrate uuid=vm_uuid remote-master=12.34.56.78
remote-username=username remote-password=password \
host-uuid=desination_host_uuid vdi=vdi_uuid
Weitere Informationen zur Speicher-Livemigration, Live-Migration und Live-VDI-Migration finden Sie unter Migrieren von VMs.
Standardmäßig wird die VM angehalten, migriert und auf dem anderen Host fortgesetzt. Der Parameter live
wählt die Live-Migration aus. Bei der Live-Migration wird die VM während der Migration ausgeführt, wodurch die Ausfallzeiten der VM auf weniger als eine Sekunde reduziert werden. Unter bestimmten Umständen, z. B. extrem speicherintensive Arbeitslasten in der VM, wird die Live-Migration wieder in den Standardmodus versetzt und die VM für kurze Zeit angehalten, bevor die Speicherübertragung abgeschlossen wird.
Die VM oder VMs, auf denen dieser Vorgang ausgeführt wird, werden über den Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten VM-Parameter sein.
vm-pause
vm-pause
Anhalten einer ausgeführten VM. Beachten Sie, dass dieser Vorgang den zugeordneten Speicher nicht freigibt (siehe vm-suspend
).
vm-query-services
vm-query-services
Fragen Sie die Systemdienste ab, die von den angegebenen VMs angeboten werden.
vm-reboot
vm-reboot [vm-selector=vm_selector_value...] [force=true]
Starten Sie die angegebenen VMs neu.
Die VM oder VMs, auf denen dieser Vorgang ausgeführt wird, werden über den Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten VM-Parameter sein.
Verwenden Sie das force
Argument, um einen nicht ordnungsgemäßen Neustart zu verursachen. Wo das Herunterfahren mit dem Ziehen des Steckers auf einem physischen Server vergleichbar ist.
vm-recover
vm-recover vm-uuid [database] [vdi-uuid] [force]
Stellt eine VM aus der Datenbank wieder her, die im bereitgestellten VDI enthalten ist.
vm-reset-powerstate
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 am Anfang dieses Abschnitts aufgeführten VM-Parameter sein.
Dies ist ein erweiterter Befehl, der nur verwendet werden kann, wenn ein Mitgliedshost in einem Pool ausfällt. Sie können diesen Befehl verwenden, um den Poolmaster zu erzwingen, den Energiezustand der VMs zurückzusetzen halted
. Im Wesentlichen erzwingt dieser Befehl die Sperre der VM und ihrer Festplatten, damit sie auf einem anderen Poolhost als Nächstes gestartet werden kann. Dieser Aufruf erfordert, dass das Force-Flag angegeben wird, und schlägt fehl, wenn es sich nicht in der Befehlszeile befindet.
vm-resume
vm-resume [vm-selector=vm_selector_value...] [force=true|false] [on=host_uuid]
Nehmen Sie die angegebenen VMs wieder 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 eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten VM-Parameter sein.
Wenn sich die VM auf einer gemeinsam genutzten SR in einem Host-Pool befindet, verwenden Sie das on
Argument, um anzugeben, auf welchem Poolmitglied sie gestartet werden soll. Standardmäßig bestimmt das System einen geeigneten Host, bei dem es sich um eines der Mitglieder des Pools handeln kann.
vm-retrieve-wlb-recommendations
vm-retrieve-wlb-recommendations
Rufen Sie die Empfehlungen für den Arbeitslastausgleich für die ausgewählte VM ab.
vm-shutdown
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 am Anfang dieses Abschnitts aufgeführten VM-Parameter sein.
Verwenden Sie das force
Argument, um ein nicht ordnungsgemäßen Herunterfahren zu verursachen, ähnlich dem Ziehen des Steckers auf einem physischen Server.
vm-snapshot
vm-snapshot new-name-label=name_label [new-name-description+name_description]
Snapshot einer vorhandenen VM, wobei der schnelle Snapshot-Vorgang auf Speicherebene, sofern verfügbar, verwendet wird.
vm-start
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 am Anfang dieses Abschnitts aufgeführten VM-Parameter sein.
Wenn sich die VMs auf einer gemeinsam genutzten SR in einem Host-Pool befinden, geben Sie mit dem on
Argument an, auf welchem Poolmitglied die VMs gestartet werden sollen. Standardmäßig bestimmt das System einen geeigneten Host, bei dem es sich um eines der Mitglieder des Pools handeln kann.
vm-suspend
vm-suspend [vm-selector=vm_selector_value...]
Anhalten der angegebenen VM.
Die VM oder VMs, auf denen dieser Vorgang ausgeführt wird, werden über den Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten VM-Parameter sein.
vm-uninstall
vm-uninstall [vm-selector=vm_selector_value...] [force=true|false]
Deinstallieren Sie eine VM und zerstören Sie ihre Festplatten (die VDIs, die als RW markiert sind und nur mit dieser VM verbunden sind) zusätzlich zu ihrem Metadateneintrag. 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 am Anfang dieses Abschnitts aufgeführten VM-Parameter sein.
vm-unpause
vm-unpause
Heben Sie die Pause einer angehaltenen VM auf.
vm-vcpu-hotplug
vm-vcpu-hotplug new-vcpus=new_vcpu_count [vm-selector=vm_selector_value...]
Passen Sie die Anzahl der vCPUs dynamisch an, die einer laufenden Linux-VM zur Verfügung stehen. Die Anzahl der vCPUs wird durch den Parameter VCPUs-max
begrenzt. Windows VMs werden immer mit der Anzahl der vCPUs ausgeführt, für die VCPUs-max
eingestellt ist, und müssen neu gestartet werden, um diesen Wert zu ändern.
Die Linux-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 am Anfang dieses Abschnitts aufgeführten VM-Parameter sein.
Hinweis:
Führen Sie beim Ausführen von Linux-VMs ohne installierte Citrix VM-Tools den folgenden Befehl auf der VM aus,
root
um sicherzustellen, dass die neu Hot-Plug-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
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-Datensätzen und nicht mit den VIF-Werten. Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten VM-Parameter sein.
Geplante Snapshots
Befehle zum Steuern von VM-Snapshots und deren Attribute.
Die vmss-Objekte können mit dem Standard-Objektlistenbefehl (xe vmss-list
) aufgelistet und mit den Standardparameterbefehlen manipuliert werden. Weitere Informationen finden Sie unter Low-Level-Parameterbefehle
vmss-create
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.
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. | Lese-/Schreibrechte |
name-description |
Beschreibung des Snapshot-Zeitplans. | Lese-/Schreibrechte |
type |
Festplatten-Snapshot oder Speicher-Snapshot. | Lese-/Schreibrechte |
frequency |
Stündlich; Täglich; Wöchentlich | Lese-/Schreibrechte |
retained-snapshots |
Momentaufnahmen, die beibehalten werden sollen. Reichweite: 1-10 | Lese-/Schreibrechte |
schedule |
schedule:days ( Montag bis Sonntag), schedule:hours (0 bis 23), schedule:minutes (0, 15, 30, 45) |
Lese-/Schreibrechte |
vmss-destroy
vmss-destroy uuid=uuid
Löscht einen Snapshot-Zeitplan im Pool.
USB-Passthrough
USB-Passthrough aktivieren/deaktivieren
pusb-param-set uuid=pusb_uuid passthrough-enabled=true/false
USB-Passthrough aktivieren/deaktivieren.
pusb-scan
pusb-scan host-uuid=host_uuid
Scannen Sie PUSB und aktualisieren Sie.
vusb-create
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 zu übergeben.
vusb-unplug
vusb-unplug uuid=vusb_uuid
Entfernen Sie USB von der VM.
vusb-destroy
vusb-destroy uuid=vusb_uuid
Entfernt die virtuelle USB-Liste von VM.
In diesem Artikel
- Installieren der xe CLI
- Hilfe mit xe-Befehlen erhalten
- Grundlegende xe-Syntax
- Sonderzeichen und Syntax
- Befehlstypen
- Geheimnisse
- Befehlshistorie
- Xe-Befehlsreferenz
- Appliance-Befehle
- Audit-Befehle
- Bonding (Befehle)
- CD-Befehle
- Cluster-Befehle
- Konsolen-Befehle
- Diagnosebefehle
- Befehle zur Notfallwiederherstellung
- Ereignisbefehle
- GPU-Befehle
- Host-Befehle
- VERALTET: Protokollbefehle
- Nachrichtenbefehle
- Netzwerk-Befehle
- SDN-Controller-Befehle
- Tunnelbefehle
- Patch-Befehle
- PBD-Befehle
- PIF-Befehle
- Pool-Befehle
- PVS-Beschleuniger-Befehle
- Storage Manager-Befehle
- Snapshot-Befehle
- SR-Befehle
- Betreff Befehle
- Task-Befehle
- Vorlagenbefehle
- Aktualisierungsbefehle
- Benutzerbefehle
- VBD-Befehle
- VDI-Befehle
- VIF-Befehle
- VLAN-Befehle
- VM-Befehle