Befehlszeilenschnittstelle
Mit der xe- CLI können Sie Systemadministrationsaufgaben skriptieren und automatisieren. Verwenden Sie die CLI, um in eine vorhandene IT-Infrastruktur zu integrieren.
Die xe-Befehlszeilenschnittstelle wird standardmäßig auf Hosts installiert und ist im Lieferumfang enthalten . Eine eigenständige Remote-CLI ist auch für Linux verfügbar.
Unter Windows wird derxe.exe
Befehl zusammen mit installiert .
Um denxe.exe
Befehl zu verwenden, öffnen Sie eine Windows-Eingabeaufforderung, und ändern Sie Verzeichnisse in das Verzeichnis, in dem sich diexe.exe
Datei befindet (normalerweiseC:\Program Files\\
). Wenn Sie dem Systempfad denxe.exe
Installationsort hinzufügen, können Sie den Befehl verwenden, ohne in das Verzeichnis wechseln zu müssen.
Auf RPM-basierten Distributionen (wie Red Hat) können Sie den eigenständigen xe-Befehl von der RPM installieren, diexe-cli-6.00-BUILD.i386.rpm
auf der Haupt- Installations-ISO genannt ist. Verwenden Sie den folgenden Befehl:
rpm -ivh xe-cli-6.00-build.i386.rpm
Grundlegende Hilfe ist für CLI-Befehle auf dem Host verfügbar, indem Sie Folgendes eingeben:
xe-Hilfebefehl
Eine Liste der am häufigsten verwendeten xe-Befehle wird angezeigt, wenn Sie Folgendes eingeben:
xe-Hilfe
Oder eine Liste aller xe-Befehle wird angezeigt, wenn Sie Folgendes eingeben:
xe Hilfe — alle
Grundlegende Xe-Syntax
Die grundlegende Syn tax aller xe-CLI-Befehle lautet:
XE-Befehls-Name-Argument = Wert Argument = Wert
Jeder spezifische Befehl enthält einen eigenen Satz von Argumenten, die die Form habenargument=value
. 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 Befehl xe remote ausgeführt wird, werden zusätzliche Argumente verwendet, um eine Verbindung herzustellen und zu authentifizieren. Diese Argumente haben auch die Formargument=argument_value
.
Dasserver
Argument wird verwendet, um den Hostnamen oder die IP-Adresse anzugeben. Dieusername
Argumentepassword
und werden verwendet, um Anmeldeinformationen anzugeben. Einpassword-file
Argument kann anstelle des Kennworts direkt angegeben werden. In diesem Fall versucht der Befehl xe, 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 das Angeben des Kennworts direkt in der Befehlszeile.
Das optionaleport
Argument kann verwendet werden, um den Agent-Port auf dem Remote- Host anzugeben (standardmäßig 443).
Beispiel: Auf dem lokalen Host:
xe-vm-Liste
Beispiel: Auf dem Remote- Host:
xe vm-list -user username -password password -server hostname
Die Kurzschriftensyntax ist auch für Remote-Verbindungsargumente verfügbar:
-
-u
Benutzername -
-pw
Passwort -
-pwf
Passwortdatei -
-p
Hafenanschluss -
-s
Server
Beispiel: Auf einem Remote- Host:
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 Remote host 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 die Remote- Host-Parameter in jedem von Ihnen ausgeführten xe-Befehl angeben.
Die Verwendung der Umgebungsvariable XE_EXTRA_ARGS ermöglicht auch die Tabulatorvervollständigung von xe-Befehlen, wenn sie für einen Remote- Host ausgegeben werden, der standardmäßig deaktiviert ist.
Sonderzeichen und Syntax
Um Argument/Wert -Paare in derxe
Befehlszeile anzugeben, schreiben Sie:
Argument = Wert
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 = „Wert mit Leerzeichen“
Wenn Sie die CLI auf Ihrem Host verwenden, verfügen Befehle über eine Tab-Vervollständigungsfunktion, die der Funktion in der Standard-Linux-Bash-Shell ähnelt. Wenn Sie beispielsweise die TAB-TASTE eingebenxe vm-l
und dann die TAB-TASTE drücken, wird der Rest des Befehls angezeigt. Wenn mehr als ein Befehl mit beginntvm-l
, führt das Drücken von TABein zweites Mal die Möglichkeiten auf. Diese Funktion ist nützlich, wenn Objekt-UUIDs in Befehlen angegeben werden.
Hinweis:
Die Tabulatorvervollständigung funktioniert normalerweise nicht, wenn Befehle auf einem Remote- Host 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 Basic xe syntax.
Befehlstypen
Die CLI-Befehle können in zwei Hälften geteilt werden. Low-Level-Befehle befassen sich mit der Auflistung und Parametermanipulation von API-Objekten. Befehle auf höherer Ebene werden verwendet, um mit VMs oder Hosts auf einer abstrakteren Ebene zu interagieren.
Die Low-Level-Befehle lauten:
-
Klasse-Liste
-
class-param-get
-
Klasse-param-set
-
Klasse-param-list
-
Klasse-param-add
-
Klasse-param-remove
-
Klasse-param-clear
Wo Klasse ist einer 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-Aktions befehlen. Einige Werte der Klasse haben einen kleineren Satz von Befehlen.
Parametertypen
Die Objekte, die mit den xe-Befehlen angesprochen werden, verfügen über Parametersätze, die sie identifizieren und deren Zustände definieren.
Die meisten Parameter nehmen einen einzelnen Wert. Dername-label
Parameter einer VM enthält beispielsweise einen einzelnen Zeichenfolgenwert. In der Ausgabe von Parameterlistenbefehlenxe vm-param-list
, z. B. gibt ein Wert in Klammern an, ob Parameter schreibgeschützt (RW) oder schreibgeschützt (RO) sind.
Die Ausgabe vonxe vm-param-list
auf einer bestimmten VM kann folgende Zeilen aufweisen:
Benutzerversion (RW): 1
is-control-domain (RO): false
Der erste Parameter,user-version
, ist beschreibbar und hat den Wert 1. Das zweiteis-control-domain
,, ist schreibgeschützt und hat den Wert false.
Die beiden anderen Typen von Parametern sind mehrwertig. Ein set -Parameter enthält eine Liste von Werten. Ein Karten parameter ist ein Satz von Schlüssel/Wert -Paaren. Sehen Sie sich als Beispiel den folgenden Teil der Beispielausgabe desxe vm-param-list
auf einer bestimmten VM an:
Plattform (MRW): acpi: true; apic: true; pae: true; nx: false
allowed-operations (SRO): Pause; clean_shutdown; clean_reboot; \
hard_shutdown; hard_reboot; suspendieren
Derplatform
Parameter enthält eine Liste von Elementen, die Schlüssel/Wert -Paare darstellen. Den Schlüsselnamen folgt ein Doppelpunkt (:). Jedes Schlüssel/Wert -Paar wird durch ein Semikolon (;) vom nächsten getrennt. Das M vor dem RW zeigt an, dass dieser Parameter ein Kartenparameter ist und lesbar und beschreibbar ist. Derallowed-operations
Parameter verfügt über eine Liste, aus der eine Reihe von Elementen besteht. Das S vor dem RO zeigt an, dass dies ein eingestellter Parameter ist und lesbar, aber nicht beschreibbar ist.
Um einen Kartenparameter zu filtern oder einen Kartenparameter festzulegen, verwenden Sie einen Doppelpunkt (:), um den Namen des Kartenparameters und das Schlüssel/Wert -Paar zu trennen. Um beispielsweise den Wert desfoo
Schlüssels desother-config
Parameters einer VM auf festzulegenbaa
, würde der Befehl
xe vm-param-set uuid = VM uuid other-config: foo = baa
Hinweis:
In früheren Versionen wurde das Bindestrichzeichen (-) verwendet, um Kartenparameter anzugeben. Diese Syntax funktioniert weiterhin, 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 benötigt einenuuid
Parameter, um das jeweilige Objekt anzugeben. Da diese Befehle als Low-Level-Befehle angesehen 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 Kartenparameter ruft die Angabe des param-Schlüssels den Wert ab, der diesem Schlüssel in der Karte zugeordnet ist. Wenn param-key nicht angegeben ist oder wenn der Parameter eine Menge ist, gibt der Befehl eine Zeichenfolgendarstellung des Satzes oder der Karte 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 einer Karte oder einem Set-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 Schlüsselsyntax param-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-Listenbefehle
Der Befehl class-list listet die Objekte des Typs 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 ausgedruckten Parameter können geändert werden.
Um die gedruckten Parameter zu ändern, geben Sie die Argument parameter als kommagetrennte Liste der erforderlichen Parameter an. Zum 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 = alle
Der Befehl list zeigt einige Parameter nicht an, die teuer zu berechnen sind. Diese Parameter werden wie zum Beispiel angezeigt:
< expensive field >Allowed-VBD-Geräte (SRO):
Um diese Felder zu erhalten, verwenden Sie entweder die Befehls klasse-param-list oder class-param-get
Um die Liste zu filtern, gleicht die CLI Parameterwerte mit den in der Befehlszeile angegebenen Werten ab. Dabei werden nur Objekte gedruckt, die allen angegebenen Einschränkungen entsprechen. Zum Beispiel:
xe vm-list hVM-Boot-policy = „BIOS-Reihenfolge“ power-state = angehalten
Dieser Befehl listet nur die VMs auf, für die *sowohlpower-state* das Feld als auch das Feld die *BIOS-Reihenfolge aufHVM-boot-policy
weist.*
Sie können die Liste auch nach dem Wert der Schlüssel in Karten oder nach dem Vorhandensein von Werten in einem Satz filtern. Die Syntax für die Filterung basierend auf Schlüsseln in Karten istmap-name:key=value
. Die Syntax für die Filterung basierend auf Werten, die in einem Satz vorhanden sind, lautetset-name:contains=value
.
Beim Skripting wird eine nützliche Technik in--minimal
der Befehlszeile übergeben, wodurchxe
nur das erste Feld in einer durch Kommas getrennten Liste gedruckt wird. Beispielsweise gibt der Befehlxe 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
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.
Einheitsparameter
Appliance-Befehle haben die folgenden Parameter:
Parametername | Beschreibung | Typ |
---|---|---|
uuid |
Die Appliance uuid | Erforderlich |
name-description |
Die Appliance-Beschreibung | Optional |
paused |
Optional | |
force |
Abschaltung erzwingen | Optional |
appliance-assert-can-be-recovered
appliance-assert-can-be-recovered uid = appliance-uuid database: vdi-uuid = vdi-uuuid
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. Zum Beispiel:
xe Appliance-create name-label = my_appliance
Hinzufügen von VMs zur Appliance:
xe vm-param-set uuid = VM-UUID Appliance = Appliance-uuuid \
xe vm-param-set uuid = VM-UUID Appliance = Appliance-uuuid
appliance-destroy
Appliance-destroy uid = Appliance-uuuid
Zerstört eine Appliance/VApp. Zum Beispiel:
xe appliance-destroy uuid = appliance-uuid
appliance-recover
appliance-recover uuid = appliance-uuid database: vdi-uuuid = vdi-uuuid \[paused = true | false]
Stellen Sie eine VM-Appliance/VApp aus der in der bereitgestellten VDI enthaltenen Datenbank wieder her.
appliance-shutdown
appliance-shutdown uuid = appliance-uuid \[force = true | false]
Schaltet alle VMs in einer Appliance/VApp herunter. Zum Beispiel:
xe Appliance-shutdown uuid = appliance-uuid
appliance-start
appliance-start uuid = appliance-uuid \[pausiert = true | false]
Startet eine Appliance/VApp. Zum Beispiel:
xe Appliance-start uuuid = Appliance-uuid
Überwachungsbefehle
Überwachungsbefehle laden alle verfügbaren Datensätze der RBAC-Überwachungsdatei im Pool herunter. Wenn der optionale Parameter vorhandensince
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 Dateiname | Erforderlich |
since |
Spezifischer Datum/Zeitpunkt | Optional |
audit-log-get
audit-log-get [since = timestamp] Dateiname = Dateiname
Führen Sie beispielsweise den folgenden Befehl aus, um Überwachungsdatensätze des Pools seit einem präzisen Zeitstempel in Millisekunden abzurufen:
Führen Sie den folgenden Befehl aus:
xe audit-log-get since = 2009-09-24T 17:56:20 .530Z Dateiname = / tmp/auditlog -pool-actions.out
Bondbefehle
Befehle zum Arbeiten mit Netzwerkanleihen, zur Ausfallsicherheit bei physischem Schnittstellen-Failover. Weitere Informationen finden Sie unter Netzwerk.
Das Bondobjekt ist ein Referenzobjekt, das Master - und Member- PIFs zusammenklebt. Der Master PIF ist die Bindungsschnittstelle, die als Gesamt-PIF verwendet werden muss, um sich auf die Bindung zu beziehen. Die Mitglieds-PIFs sind ein Satz von zwei oder mehr physikalischen Schnittstellen, die zu der High-Level-gebundenen Schnittstelle zusammengefasst wurden.
Bondparameter
Anleihen haben folgende Parameter:
Parametername | Beschreibung | Typ |
---|---|---|
uuid |
Eindeutige Bezeichnung/Objektreferenz für die Bindung | Nur lesen |
master |
UUID für die Master-Anleihe PIF | Nur lesen |
members |
Satz von UUIDs für die zugrunde liegenden gebundenen PIFs | Nur lesen |
bond-create
bond-create network-uuid = network_uuid pif-uuids = pif_uid_1, pif_uuid_2,...
Erstellen Sie eine gebundene Netzwerkschnittstelle im Netzwerk, das aus einer Liste vorhandener PIF-Objekte angegeben ist. Der Befehl schlägt in einem der folgenden Fälle fehl:
- Wenn PIF bereits in einer anderen Anleihe sind
- Wenn für ein Mitglied ein VLAN-Tag festgelegt ist
- Wenn sich die referenzierten PIFs nicht auf demselben Host befinden
- Wenn weniger als 2 PIF 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_uid mode = bond_mode
Ändern Sie den Bond-Modus.
CD-Befehle
Befehle zum Arbeiten mit physischen CD/DVD -Laufwerken auf Hosts.
CD-Parameter
CDs haben folgende Parameter:
Parametername | Beschreibung | Typ |
---|---|---|
uuid |
Eindeutige Bezeichnung/Objektreferenz für die CD | Nur lesen |
name-label |
Name der CD | Lesen/Schreiben |
name-description |
Beschreibungstext für die CD | Lesen/Schreiben |
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 Bezeichnung/Objektreferenz für die SR dieser CD ist Teil von | Nur lesen |
sr-name-label |
Der Name für die SR, die diese CD ist Teil von | Nur lesen |
vbd-uuids |
Eine Liste der eindeutigen Bezeichner für die VBDs auf VMs, die mit dieser CD verbunden sind | 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 VMs erscheint (in Bytes) | Nur lesen |
physical-utilisation |
Menge des physischen Speicherplatzes, den das CD-Image auf der SR belegt (in Bytes) | Nur lesen |
type |
Auf Benutzer für CDs festlegen | Nur lesen |
sharable |
Ob das CD-Laufwerk teilbar ist oder nicht. Der Standardwert istfalse . |
Nur lesen |
read-only |
Gibt an, ob die CD schreibgeschützt istfalse , wenn das Gerät beschreibbar ist. Immer für CDs wahr. |
Nur lesen |
storage-lock |
Wert isttrue , wenn dieser Datenträger auf Speicherebene gesperrt ist. |
Nur lesen |
parent |
Verweis auf die übergeordnete Festplatte, wenn diese CD Teil einer Kette ist. | Nur lesen |
missing |
Wert isttrue , wenn der SR-Scanvorgang diese CD als nicht auf der Festplatte vorhanden gemeldet hat |
Nur lesen |
other-config |
Eine Liste von Schlüssel/Wert -Paaren, die zusätzliche Konfigurationsparameter für die CD angeben | Zuordnungsparameter Lese-/Schreibzugriff |
location |
Der Pfad, auf dem das Gerät eingehängt ist | Nur lesen |
managed |
Wert isttrue , wenn das Gerät verwaltet wird |
Nur lesen |
xenstore-data |
Daten, die in den Xenstore-Baum eingefügt werden sollen | Schreibgeschützte Zuordnungsparameter |
sm-config |
Namen und Beschreibungen der Speichermanager-Gerätekonfigurationsschlüssel | Schreibgeschützte Zuordnungsparameter |
is-a-snapshot |
Wert isttrue , wenn es sich bei dieser Vorlage um einen CD-Snapshot handelt |
Nur lesen |
snapshot_of |
Die UUID der CD, für die diese Vorlage ein Snapshot von | Nur lesen |
snapshots |
Die UUIDs aller Snapshots, die von dieser CD aufgenommen wurden | Nur lesen |
snapshot_time |
Der Zeitstempel des Snapshot-Vorgangs | Nur lesen |
cd-list
cd-list [params = param1, param2,...] [Parameter = Parameter_Wert]
Listen Sie die CDs und ISOs (CD-Imagedateien) auf dem Host oder Pool auf und filtern Sie nach dem optionalen Argumentparams
.
Wenn das optionale Argument verwendetparams
wird, ist der Wert von params eine Zeichenfolge, die eine Liste der Parameter dieses Objekts enthält, die angezeigt werden soll. Alternativ können Sie das Schlüsselwort verwendenall
, um alle Parameter anzuzeigen. Wennparams
nicht verwendet wird, zeigt die zurückgegebene Liste eine Standarduntermenge aller verfügbaren Parameter an.
Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts#cd-parameters()aufgeführten [CD-Parameter]sein.
Cluster-Befehle
Befehle zum Arbeiten mit Clusterpools.
Clustered Pools sind Ressourcenpools, für die das Clustering-Feature aktiviert ist. Verwenden Sie diese Pools mit GFS2 SRs. Weitere Informationen finden Sie unter Clustered Pools
Die Cluster- und Cluster-Host-Objekte können mit den Standardobjektauflistungsbefehlen (xe cluster-list
undxe cluster-host-list
) aufgelistet werden, und die Parameter, die mit den Standardparameterbefehlen bearbeitet werden. Weitere Informationen finden Sie unter Low-Level-Parameterbefehle.
Befehle zum Arbeiten mit Clusterpools.
Clusterparameter
Cluster haben die folgenden Parameter:
Parametername | Beschreibung | Typ |
---|---|---|
uuid |
Die eindeutige Bezeichnung/Objektreferenz für den Cluster | Nur lesen |
cluster-hosts |
Eine Liste der eindeutigen Bezeichner/Objektreferenzen für die Hosts im Cluster | Schreibgeschützte Parameter festlegen |
cluster-token |
Der geheime Schlüssel, der von xapi-clusterd verwendet wird, wenn er auf anderen Hosts mit sich selbst spricht | Nur lesen |
cluster-stack |
Der Technologie-Stack, der die Clustering-Funktionen bereitstellt. Mögliche Werte sindcorosync . |
Nur lesen |
allowed-operations |
Listet die in diesem Zustand zulässigen Vorgänge auf. Diese Liste ist nur empfehlend, 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 empfehlend, und der Clusterstatus hat sich möglicherweise geändert, wenn ein Client dieses Feld liest. | Schreibgeschützte Parameter festlegen |
token-timeout |
Das Timeout des corosync-Token in Sekunden | Nur lesen |
token-timeout-coefficient |
Der Timeout-Koeffizient des corosync-Token in Sekunden | Nur lesen |
pool-auto-join |
True, wenn automatisch neue Poolmitglieder mit dem Cluster verbunden werden. Dies ist auf eingestellttrue . |
Nur lesen |
cluster-config |
Eine Liste von Schlüssel/Wert -Paaren, die zusätzliche Konfigurationsparameter für den Cluster angeben. | Schreibgeschützte Zuordnungsparameter |
other-config |
Eine Liste von Schlüssel/Wert -Paaren, die zusätzliche Konfigurationsparameter für den Cluster angeben. | Zuordnungsparameter Lese-/Schreibzugriff |
cluster-host-create
cluster-host-create cluster-uuuid = cluster_uuid host-uuid = host_uuid pif-uuid = pif_uuid
Hinzufügen eines Hosts zu einem vorhandenen Cluster.
cluster-host-destroy
cluster-host-destroy uuid = host_uuid
Zerstören Sie einen Clusterhost und verlassen Sie effektiv den Cluster.
cluster-host-disable
cluster-host-disable uuid = cluster_uuid
Deaktivieren der Clustermitgliedschaft 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
Löscht ein Clusterhostobjekt zwangsweise, wodurch der Cluster effektiv verlassen wird.
cluster-pool-create
cluster-pool-create network-uuid = network_uid [cluster-stack = cluster_stack] [token-timeout = token_timeout] [token-timeout-coefficient = token_timeout_coefficient]
Erstellen eines Pool-weiten Clusters.
cluster-pool-destroy
cluster-pool-destroy cluster-uuuid = cluster_uuid
Löscht Pool-weiten Cluster. Der Pool ist weiterhin vorhanden, er ist jedoch nicht mehr gruppiert und kann keine GFS2-SRs mehr verwenden.
cluster-pool-force-destroy
cluster-pool-force-destroy cluster-uuuid = cluster_uuid
Erzwingen Sie den Pool-weiten Cluster.
cluster-pool-resync
cluster-pool-resync cluster-uuuid = cluster_uuid
Synchronisieren Sie einen Cluster über einen Pool.
Konsolenbefehle
Befehle zum Arbeiten mit Konsolen.
Die Konsolenobjekte können mit dem Standardobjektauflistungsbefehl (xe console-list
) aufgelistet und die Parameter werden mit den Standardparameterbefehlen bearbeitet. Weitere Informationen finden Sie unter Low-Level-Parameterbefehle.
Konsolenparameter
Konsolen haben die folgenden Parameter:
Parametername | Beschreibung | Typ |
---|---|---|
uuid |
Die eindeutige Bezeichnung/Objektreferenz für die Konsole | Nur lesen |
vm-uuid |
Die eindeutige Bezeichnung/Objektreferenz der VM, auf der diese Konsole geöffnet ist | Nur lesen |
vm-name-label |
Der Name der VM, auf der diese Konsole geöffnet ist | Nur lesen |
protocol |
Protokoll, das von dieser Konsole verwendet wird. Mögliche Werte sindvt100 : VT100-Terminal,rfb : Remote Framebuffer Protocol (wie in VNC verwendet) oderrdp : Remote Desktop Protocol |
Nur lesen |
location |
URI für den Konsolendienst | Nur lesen |
other-config |
Eine Liste von Schlüssel/Wert -Paaren, die zusätzliche Konfigurationsparameter für die Konsole angeben. | Zuordnungsparameter Lese-/Schreibzugriff |
console
trösten
An eine bestimmte Konsole anschließen.
Diagnosebefehle
Befehle zum Sammeln von Diagnoseinformationen von .
diagnostic-compact
diagnostisch-kompakt
Führen Sie eine große GC-Sammlung und Heap-Verdichtung durch.
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-statistik
Datenbankstatistiken drucken.
diagnostic-gc-stats
diagnostisch-gc-statistik
GC-Statistiken drucken.
diagnostic-license-status
Diagnose-Lizenzstatus
Helfen Sie bei der Diagnose von Pool-weiten Lizenzierungsproblemen.
diagnostic-net-stats
diagnostic-net-stats [uri = uri] [method = method] [params = param1, param2...]
Drucken von Netzwerkstatistiken.
diagnostic-timing-stats
Diagnostik-Timing-Stats
Druckzeitstatistiken.
diagnostic-vdi-status
diagnostisch-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 Freigaben/Sperren -Status aller VBDs.
Disaster Recovery-Befehle
Befehle zum Wiederherstellen von VMs nach einem Notfall
drtask-create
drtask-create type = type sr-whitelist = sr-white-list device-config = device-config
Erstellt eine Disaster Recovery-Aufgabe. So stellen Sie beispielsweise eine Verbindung zu einer iSCSI-SR in Vorbereitung auf die Notfallwiederherstellung her:
xe drtask-create type = lvmoiscsi device-config: target = target-ip-address \
device-config: TargetIQn = TargetIQn Gerätekonfig: scsiId = scSIID \
sr-whitelist = sr-uuid-list
Hinweis:
Der Befehl
sr-whitelist
listet SR-UUIDs auf. Derdrtask-create
Befehl führt nur eine SR ein und stellt eine Verbindung her, die eine der weißen UUIDs hat.
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 uid = vm-uuid Datenbank: 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 uid = appliance-uuid database: vdi-uuid = vdi-uuuid
Überprüft, ob der Speicher (mit dem S/vApp -Datenträger der Appliance) sichtbar ist.
appliance-recover
Appliance-recover uid = Appliance-uuid Datenbank: vdi-uuuid = vdi-uuuid \[force = true | false]
Stellen Sie eine Appliance/VApp aus der in der bereitgestellten VDI enthaltenen Datenbank wieder her.
vm-recover
vm-recover uuid = vm-uuid Datenbank: vdi-uuuid = vdi-uuuid \[force = true | false]
Stellt eine VM aus der im bereitgestellten VDI enthaltenen Datenbank wieder her.
sr-enable-database-replication
sr-enable-database-replikation uuuid = sr_uuid
Aktiviert die XAPI-Datenbankreplikation auf die angegebene (gemeinsam genutzte) SR. Zum Beispiel:
xe sr-enable-database-replikation uuuid = sr-uuid
sr-disable-database-replication
sr-disable-database-replikation uuuid = sr_uuid
Deaktiviert die XAPI-Datenbankreplikation auf die angegebene SR. Zum Beispiel:
xe sr-enable-database-replikation uuuid = sr-uuid
Beispielverwendung
Das folgende Beispiel zeigt die DR-CLI-Befehle im Kontext:
Aktivieren Sie am primären Standort die Datenbankreplikation:
xe sr-database-replikation uuuid = sr = uuid
Stellen Sie nach einer Katastrophe am sekundären Standort eine Verbindung zur SR her. Derdevice-config
Befehl hat die gleichen Felder wiesr-probe
.
xe drtask-create type = lvmoiscsi \
device-config: target = Ziel-IP-Adresse \
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 = Metadaten
Fragen Sie einen Datenbank-VDI für vorhandene VMs ab:
xe vm-list-Datenbank: vdi-uuuid = vdi-uuuid
Wiederherstellen einer VM:
xe vm-recover uid = vm-uuid Datenbank: vdi-uuuid = vdi-uuuid
Zerstören Sie die Notfall-Aufgabe. Alle SRs, die von der Notfall-Aufgabe eingeführt und von VMs nicht 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 Festplattenabbild |
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 vorhanden ist, das die in der Befehlszeile angegebenen Bedingungen erfüllt. Das Argumentx=y
bedeutet „warten, bis Feld x Wert y nimmt“ undx=/=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 = läuft
Blockiert andere Befehle, bis eine VM aufgerufenmyvm
ist in derpower-state
“läuft. „
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 jede der [Ereignisklassen]sein, die am Anfang dieses Abschnitts#event-classes()aufgeführt sind. Die Parameter können jeder der Parameter sein, die in der CLI-Befehls klasse-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 Standardobjektauflistungsbefehlen aufgeführt werden:xe pgpu-list
,xe gpu-group-list
, undxe vgpu-list
. Die Parameter können mit den Standardparameterbefehlen bearbeitet werden. Weitere Informationen finden Sie unter Low-Level-Parameterbefehle.
Physische GPU-Parameter
Physische GPUs (PGPUs) haben die folgenden Parameter:
Parametername | Beschreibung | Typ |
---|---|---|
uuid |
Die eindeutige Bezeichnung/Objektreferenz für die PGPU | Nur lesen |
vendor-name |
Der Herstellername der PGPU | Nur lesen |
device-name |
Der Name, der dem Anbieter diesem PgPU-Modell zugewiesen wurde | Nur lesen |
gpu-group-uuid |
Die eindeutige Bezeichnung/Objektreferenz für die GPU-Gruppe, der diese PGPU automatisch zugewiesen wurde . Identische PGPUs über Hosts in einem Pool sind gruppiert | Nur lesen |
gpu-group-name-label |
Der Name der GPU-Gruppe, der die PGPU zugewiesen ist | Nur lesen |
host-uuid |
Die eindeutige Bezeichnung/Objektreferenz für den Host, mit dem die PGPU verbunden ist | Nur lesen |
host-name-label |
Der Name des Hosts, mit dem die PGPU verbunden ist | Nur lesen |
pci-id |
PCI-Kennung | Nur lesen |
dependencies |
Listet die abhängigen PCI-Geräte auf, die an dieselbe VM weitergeleitet werden | Zuordnungsparameter Lese-/Schreibzugriff |
other-config |
Eine Liste von Schlüssel/Wert -Paaren, die zusätzliche Konfigurationsparameter für die PGPU angeben | Zuordnungsparameter Lese-/Schreibzugriff |
supported-VGPU-types |
Liste der virtuellen GPU-Typen, die von der zugrunde liegenden Hardware unterstützt werden | Nur lesen |
enabled-VGPU-types |
Liste der virtuellen GPU-Typen, die für diese PGPU aktiviert wurden | Lesen/Schreiben |
resident-VGPUs |
Liste der vGPUs, die auf dieser PGPU ausgeführt werden | Nur lesen |
pgpu-disable-dom0-access
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 |
Die eindeutige Bezeichnung/Objektreferenz für die GPU-Gruppe | Nur lesen |
name-label |
Der Name der GPU-Gruppe | Lesen/Schreiben |
name-description |
Der beschreibende Text der GPU-Gruppe | Lesen/Schreiben |
VGPU-uuids |
Listet die eindeutigen Bezeichner/Objektreferenzen für die virtuellen GPUs in der GPU-Gruppe auf | 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 | Zuordnungsparameter Lese-/Schreibzugriff |
supported-VGPU-types |
Vereinigung aller virtuellen GPU-Typen, die von der zugrunde liegenden Hardware unterstützt werden | Nur lesen |
enabled-VGPU-types |
Vereinigung aller virtuellen GPU-Typen, die auf den zugrunde liegenden PGPUs aktiviert wurden | Nur lesen |
allocation-algorithm |
Depth-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-uuuid = 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 uuuid = uuid\_of\_group allocation-algorithm = breadth-first | depth-first
Ändert den Algorithmus, den die GPU-Gruppe verwendet, um virtuelle GPUs PGPUs zuzuweisen.
gpu-group-param-get-uuid
gpu-group-param-get-uuid uuid = uuid\_of\_group param-name = Unterstützte VGPU-Typen | Enabled-VGPU-Typen
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 Bezeichnung/Objektreferenz für die virtuelle GPU | Nur lesen |
vm-uuid |
Die eindeutige Bezeichnung/Objektreferenz für die VM, der die virtuelle GPU zugewiesen ist | Nur lesen |
vm-name-label |
Der Name der VM, der die virtuelle GPU zugewiesen ist | Nur lesen |
gpu-group-uuid |
Die eindeutige Bezeichnung/Objektreferenz für die GPU-Gruppe, in der die virtuelle GPU enthalten ist | Nur lesen |
gpu-group-name-label |
Der Name der GPU-Gruppe, in der die virtuelle GPU enthalten ist | Nur lesen |
currently-attached |
True, wenn eine VM mit GPU-Pass-Through ausgeführt wird, andernfalls false | Nur lesen |
other-config |
Eine Liste von Schlüssel/Wert -Paaren, die zusätzliche Konfigurationsparameter für die virtuelle GPU angeben | Zuordnungsparameter Lese-/Schreibzugriff |
type-uuid |
Die eindeutige Bezeichnung/Objektreferenz für den virtuellen GPU-Typ dieser virtuellen GPU | Zuordnungsparameter Lese-/Schreibzugriff |
type-model-name |
Modellname, der dem virtuellen GPU-Typ zugeordnet ist | Nur lesen |
Virtuelle GPU-Typparameter
Hinweis:
GPU-Passthrough und virtuelle GPUs sind nicht kompatibel mit Storage oder VM Suspend , 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 , Speicher- und VM-Aussetzung finden Sie unter [Grafik/en-us/xenserver/current-release/graphics.html()].
Virtuelle GPU-Typen haben die folgenden Parameter:
Parametername | Beschreibung | Typ |
---|---|---|
uuid |
Die eindeutige Bezeichnung/Objektreferenz für den virtuellen GPU-Typ | Nur lesen |
vendor-name |
Name des virtuellen GPU-Anbieters | Nur lesen |
model-name |
Modellname, der dem virtuellen GPU-Typ zugeordnet ist | Nur lesen |
freeze-frame |
Framebuffer-Größe des virtuellen GPU-Typs, in Byte | Nur lesen |
max-heads |
Maximale Anzahl von Bildschirmen, die vom virtuellen GPU-Typ unterstützt werden | Nur lesen |
supported-on-PGPUs |
Liste der PGPUs, die diesen virtuellen GPU-Typ unterstützen | Nur lesen |
enabled-on-PGPUs |
Liste der PGPUs, die diesen virtuellen GPU-Typ aktiviert haben | Nur lesen |
VGPU-uuids |
Liste der virtuellen GPUs dieses Typs | Nur lesen |
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. Dieser Befehl fügt die VM an die angegebene GPU-Gruppe an und gibt optional den virtuellen GPU-Typ an. Wenn kein virtueller GPU-Typ angegeben wird, wird der Typ ‘Pass-Through’ 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.
Mitfalse
wird die VNC-Konsole für eine VM deaktiviert, während sie zum Anzeigeemulatordisablevnc=1
gelangt. Standardmäßig ist VNC aktiviert.
Host-Befehle
Befehle für die Interaktion mit Host.
-@@ Hosts sind die physischen Server, auf denen Software ausgeführt wird. Sie verfügen über VMs, die unter der Kontrolle einer speziellen privilegierten virtuellen Maschine ausgeführt werden, die als Steuerdomäne oder Domäne 0 bezeichnet wird.
Die Hostobjekte können mit den Standardobjektauflistungsbefehlen aufgeführt werden:xe host-listxe host-cpu-list````,, undxe host-crashdump-list``). Die Parameter können mit den Standardparameterbefehlen bearbeitet werden. Weitere Informationen finden Sie unter Low-Level-Parameterbefehle.
Host-Selektoren
Einige der hier aufgeführten Befehle haben einen gemeinsamen Mechanismus zum Auswählen eines oder mehrerer Hosts, auf denen der Vorgang ausgeführt werden soll. Am einfachsten ist es, das Argument anzugebenhost=uuid_or_name_label
. Sie können auch angeben, indem Sie die vollständige Liste der Hosts nach den Werten der Felder filtern. Wenn Sie beispielsweise angeben, enabled=true
werden alle Hosts ausgewählt, derenenabled
Feld gleich isttrue
. Wenn mehrere Hosts übereinstimmen und der Vorgang auf mehreren Hosts ausgeführt werden kann, müssen Sie angeben,--multiple
dass der Vorgang ausgeführt werden soll. Die vollständige Liste der Parameter, die abgeglichen werden können, wird am Anfang dieses Abschnitts beschrieben. Sie können diese Liste der Befehle erhalten, indem Sie den Befehl ausführenxe host-list params=all
. Wenn keine Parameter zur Auswahl von Hosts angegeben sind, wird der Vorgang auf allen Hosts ausgeführt.
Host-Parameter
-@@ Hosts haben die folgenden Parameter:
Parametername | Beschreibung | Typ |
---|---|---|
uuid |
Die eindeutige Bezeichnung/Objektreferenz für den Host | Nur lesen |
name-label |
Der Name des Hosts | Lesen/Schreiben |
name-description |
Die Beschreibungszeichenfolge des Hosts | Nur lesen |
enabled |
Wert istfalse , wenn deaktiviert. Dadurch wird verhindert, dass neue VMs auf den Hosts gestartet werden, und die Hosts werden heruntergefahren oder neu gestartet. Wert isttrue , wenn der Host aktiviert ist |
Nur lesen |
API-version-major |
Hauptversionsnummer | Nur lesen |
API-version-minor |
Nebenversionsnummer | Nur lesen |
API-version-vendor |
Identifizierung des API-Anbieters | Nur lesen |
API-version-vendor-implementation |
Details zur Implementierung des Anbieters | Schreibgeschützte Zuordnungsparameter |
logging |
Protokollierungskonfiguration | Zuordnungsparameter Lese-/Schreibzugriff |
suspend-image-sr-uuid |
Die eindeutige Bezeichnung/Objektreferenz für die SR, in der suspendierte Bilder platziert werden | Lesen/Schreiben |
crash-dump-sr-uuid |
Die eindeutige Bezeichnung/Objektreferenz für die SR, in der Absturzabbilder platziert werden | Lesen/Schreiben |
software-version |
Liste der Versionierungsparameter und deren Werte | Schreibgeschützte Zuordnungsparameter |
capabilities |
Liste der Xen-Versionen, die der Host ausführen kann | Schreibgeschützte Parameter festlegen |
other-config |
Eine Liste von Schlüssel/Wert -Paaren, die zusätzliche Konfigurationsparameter für den Host angeben | Zuordnungsparameter Lese-/Schreibzugriff |
chipset-info |
Eine Liste von Schlüssel/Wert -Paaren, die Informationen über den Chipsatz angeben | Schreibgeschützte Zuordnungsparameter |
hostname |
Hostname | Nur lesen |
address |
Host-IP-Adresse | Nur lesen |
license-server |
Eine Liste von Schlüssel/Wert -Paaren, die Informationen zum Lizenzserver angeben. | Schreibgeschützte Zuordnungsparameter |
supported-bootloaders |
Liste der Bootloader, die der Host unterstützt, zum Beispiel pygrub, eliloader | Schreibgeschützte Parameter festlegen |
memory-total |
Gesamtmenge des physischen Arbeitsspeichers auf dem Host, in Byte | Nur lesen |
memory-free |
Gesamtmenge des verbleibenden physischen Arbeitsspeichers, der VMs zugewiesen werden kann, in Byte | Nur lesen |
host-metrics-live |
True, wenn der Host betriebsbereit ist | Nur lesen |
logging |
Dersyslog_destination Schlüssel kann auf den Hostnamen eines Remote-Syslog-Dienstes festgelegt werden. |
Zuordnungsparameter Lese-/Schreibzugriff |
allowed-operations |
Listet die in diesem Zustand zulässigen Vorgänge auf. Diese Liste ist nur empfehlend, 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 empfehlend, 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 | Nur lesen |
memory-free-computed |
Eine konservative Schätzung der maximalen Speicherkapazität auf einem Host | Nur lesen |
ha-statefiles |
Die UUIDs aller HA-Statusdateien | Nur lesen |
ha-network-peers |
Die UUIDs aller Hosts, die die VMs auf diesem Host hosten können, wenn ein Fehler auftritt | Nur lesen |
external-auth-type |
Art der externen Authentifizierung, z. B. Active Directory. | Nur lesen |
external-auth-service-name |
Der Name des externen Authentifizierungsdiensts | Nur lesen |
external-auth-configuration |
Konfigurationsinformationen für den externen Authentifizierungsdienst. | Schreibgeschützte Zuordnungsparameter |
-@@ Hosts enthalten einige andere Objekte, die auch Parameterlisten enthalten.
CPUs auf Hosts haben die folgenden Parameter:
Parametername | Beschreibung | Typ |
---|---|---|
uuid |
Die eindeutige Bezeichnung/Objektreferenz für die CPU | Nur lesen |
number |
Die Nummer des physischen CPU-Kerns innerhalb des Hosts | Nur lesen |
vendor |
Die Herstellerzeichenfolge für den CPU-Namen | Nur lesen |
speed |
Die CPU-Takt in Hz | Nur lesen |
modelname |
Die Herstellerzeichenfolge für das CPU-Modell, z. B. „Intel (R) Xeon (TM) CPU 3.00 GHz“ | Nur lesen |
stepping |
Die CPU-Revisionsnummer | Nur lesen |
flags |
Die Flags der physischen CPU (eine dekodierte Version des Featus-Feldes) | Nur lesen |
Utilisation |
Die aktuelle CPU-Auslastung | Nur lesen |
host-uuid |
Die UUID, wenn der Host, in dem sich die CPU befindet | Nur lesen |
model |
Die Modellnummer der physischen CPU | Nur lesen |
family |
Die Nummer der physischen CPU-Familie | Nur lesen |
Absturzabbilder auf Hosts haben die folgenden Parameter:
Parametername | Beschreibung | Typ |
---|---|---|
uuid |
Die eindeutige Bezeichnung/Objektreferenz für den Absturzdump | Nur lesen |
host |
-Host entspricht, entspricht der crashdump | Nur lesen |
timestamp |
Zeitstempel des Datums und der Uhrzeit, zu der der Absturz aufgetreten ist, in der Formyyyymmdd-hhmmss-ABC , wobei ABCder Zeitzonenindikator ist, z. B. GMT |
Nur lesen |
size |
Größe des crashdump, in Bytes | Nur lesen |
host-all-editions
Host-All-Editionen
Eine Liste aller verfügbaren Editionen abrufen
host-apply-edition
host-apply-edition [host-uuid = host_uuid] [edition = xenserver_edition = „free“ "pro socket" "„xendesktop“]
Weist die Lizenz einem Hostserver zu. Wenn Sie eine Lizenz zuweisen, kontaktiert den Lizenzserver und fordert den angegebenen Lizenztyp an. Wenn eine Lizenz verfügbar ist, wird sie dann vom Lizenzserver ausgecheckt.
Verwenden
Informationen zur Erstlizenzierung finden Sie unter auchlicense-server-address
undlicense-server-port
.
host-backup
host-backup file-name = backup_filename host = host_name
Laden Sie eine Sicherung der Steuerdomäne des angegebenen Hosts auf den Computer herunter, von dem der Befehl aufgerufen wird. Speichern Sie es dort als Datei mit dem Namenfile-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 angegeben), verwenden Sie ihn nicht auf diese Weise. Dadurch würde die Kontrolldomänenpartition mit der Sicherungsdatei gefüllt. Verwenden Sie nur den Befehl von einem externen externen Computer, auf dem Sie Speicherplatz für die Sicherungsdatei 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, mit allen optionalen Dateien) und laden Sie sie auf die Support-FTP-Site oder einen anderen Speicherort hoch.
Die Hosts, auf denen diese Operation ausgeführt werden soll, werden mit dem Standardauswahlmechanismus ausgewählt (siehe Host-Selektorenoben). Optionale Argumente können beliebig viele [Hostparameter]sein, die am Anfang dieses Abschnitts#host-parameters()aufgeführt sind.
Optionale Parameter sindhttp-proxy
: Verwenden Sie den angegebenen HTTP-Proxy undurl
: upload zu dieser Ziel-URL. Wenn optionale Parameter nicht 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_uid plugin = plugin fn = function [args = args]
Ruft die Funktion innerhalb des Plugins auf dem angegebenen Host mit optionalen Argumenten auf.
host-compute-free-memory
Host-Computer-freier Speicher
Berechnet die Menge des freien Speichers auf dem Host.
host-compute-memory-overhead
Host-Computer-Speicher-Overhead
Berechnet den Virtualisierungsspeicher-Overhead eines Hosts.
host-cpu-info
host-cpu-info [uuid = uuid]
Listet Informationen über die 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 Host.
host-crashdump-upload
host-crashdump-upload uuid = crashdump_uuid [url = destination_url] [http-proxy = http_proxy_name]
Laden Sie einen Absturz auf die Support-FTP-Site oder einen anderen Speicherort hoch. Wenn optionale Parameter nicht verwendet werden, wird kein Proxyserver identifiziert und das Ziel ist die standardmäßige Support-FTP-Site. Optionale Parameter sindhttp-proxy
: Verwenden Sie den angegebenen HTTP-Proxy undurl
: upload zu dieser Ziel-URL.
host-declare-dead
host-declare-dead uuid = host_uuid
Erklären Sie, dass der Host tot ist, ohne ihn explizit zu kontaktieren.
Achtung:
Dieser Aufruf ist gefährlich und kann zu Datenverlusten führen, wenn der Host nicht tatsächlich tot ist.
host-disable
host-disable [host-selector = host_selector_value...]
Deaktiviert die angegebenen Hosts, wodurch verhindert wird, dass neue VMs auf ihnen gestartet werden. Diese Aktion bereitet die Hosts zum Herunterfahren oder Neustart vor.
Die Hosts, auf denen diese Operation ausgeführt werden soll, werden über den Standardauswahlmechanismus ausgewählt (siehe Host-Selektoren). Optionale Argumente können beliebig viele [Hostparameter]sein, die am Anfang dieses Abschnitts#host-parameters()aufgeführt sind.
host-disable-display
host-disable-display uuuid = host_uuid
Deaktivieren Sie die Anzeige für den Host.
host-disable-local-storage-caching
host-disable-local-storage-caching
Deaktivieren Sie das lokale Speicher-Caching auf dem angegebenen Host.
host-dmesg
host-dmesg [host-selector = host_selector_value...]
Holen Sie sich ein Xendmesg
(die Ausgabe des Kernelringpuffers) von angegebenen Hosts.
Die Hosts, auf denen diese Operation ausgeführt werden soll, werden mit dem Standardauswahlmechanismus ausgewählt (siehe Host-Selektorenoben). Optionale Argumente können beliebig viele [Hostparameter]sein, die am Anfang dieses Abschnitts#host-parameters()aufgeführt sind.
host-emergency-ha-disable
host-notfall-ha-disable [— force]
Deaktivieren Sie HA auf dem lokalen Host. Nur zur Wiederherstellung eines Pools mit einem defekten HA-Setup verwendet werden.
host-emergency-management-reconfigure
host-emergency-management-reconfigure interface = uuid_of_management_interface_pif
Konfigurieren Sie die Verwaltungsschnittstelle dieses Hosts neu. Verwenden Sie diesen Befehl nur, wenn sich der Host im Notfallmodus befindet. Der Notfallmodus bedeutet, dass der Host ein Mitglied in einem Ressourcenpool ist, dessen Master aus dem Netzwerk verschwunden ist und nach mehreren Wiederholungen nicht kontaktiert werden kann.
host-enable
host-enable [host-selector = host_selector_value...]
Aktiviert die angegebenen Hosts, wodurch neue VMs auf ihnen gestartet werden können.
Die Hosts, auf denen diese Operation ausgeführt werden soll, werden mit dem Standardauswahlmechanismus ausgewählt (siehe Host-Selektorenoben). Optionale Argumente können beliebig viele [Hostparameter]sein, die am Anfang dieses Abschnitts#host-parameters()aufgeführt sind.
host-enable-display
host-enable-display uuuid = host_uuid
Aktivieren Sie die Anzeige für den Host.
host-enable-local-storage-caching
host-enable-local-storage-caching sr-uuid = sr_uuid
Aktivieren Sie das Caching des lokalen Speichers auf dem angegebenen Host.
host-evacuate
host-evakuieren [host-selector = host_selector_value...]
Live migriert alle laufenden VMs zu anderen geeigneten Hosts in einem Pool. Zuerst disbale den Host mithilfe deshost-disable
Befehls.
Wenn der evakuierte Host der Poolmaster ist, muss ein anderer Host als Poolmaster ausgewählt werden. Verwenden Sie denpool-designate-new-master
Befehl, um den Poolmaster mit deaktiviertem HA zu ändern. Weitere Informationen finden Sie unter pool-designate-new-master.
Wenn HA aktiviert ist, besteht die einzige Option darin, den Server herunterzufahren, wodurch HA zufällig einen neuen Master auswählt. Weitere Informationen finden Sie unter host-shutdown.
Die Hosts, auf denen diese Operation ausgeführt werden soll, werden mit dem Standardauswahlmechanismus ausgewählt (siehe Host-Selektorenoben). Optionale Argumente können beliebig viele [Hostparameter]sein, die am Anfang dieses Abschnitts#host-parameters()aufgeführt sind.
host-forget
host-forget uuid = host_uuid
Der XAPI-Agent vergisst den angegebenen Host, ohne ihn explizit zu kontaktieren.
Verwenden Sie den--force
Parameter, um zu vermeiden, dass Sie aufgefordert werden, zu bestätigen, dass Sie diesen Vorgang wirklich ausführen möchten.
Achtung:
Verwenden Sie diesen Befehl nicht, wenn HA für den Pool aktiviert ist. Deaktivieren Sie zuerst HA, und aktivieren Sie sie dann erneut, nachdem Sie den Host vergessen haben.
Tipp:
Dieser Befehl ist nützlich, wenn der zu vergessenende Host tot ist. Wenn der Host jedoch live ist 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-Zertifikat
Holen Sie sich das installierte SSL-Zertifikat des Servers.
host-get-sm-diagnostics
host-get-sm-diagnostics uuuid = uuid
Zeigt SM-Diagnoseinformationen pro Host an.
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 Systemstatusinformationen in die angegebene Datei herunter. Der optionale Parameterentries
ist eine durch Kommas getrennte Liste von Systemstatuseinträgen, die aus dem XML-Fragment Capabilities stammt, das vomhost-get-system-status-capabilities
Befehl zurückgegeben wird. Weitere Informationen finden Sie unter host-get-system-status-capabilities. Wenn nicht angegeben, werden alle Systemstatusinformationen in der Datei gespeichert. Der Parameteroutput
kann tar.bz2 (Standardeinstellung) oder zip sein. Wenn dieser Parameter nicht angegeben wird, wird die Datei intar.bz2
Form gespeichert.
Die Hosts, auf denen diese Operation ausgeführt werden soll, werden mit dem Standardauswahlmechanismus ausgewählt (siehe Host-Selektorenoben).
host-get-system-status-capabilities
host-get-system-status-capabilities [host-selector = host_selector_value...]
Abrufen von Systemstatusfunktionen für die angegebenen Hosts. Die Capabilities werden als XML-Fragment zurückgegeben, das dem folgenden Beispiel ähnlich ist:
Jede Prozessfähigkeitsentität kann die folgenden Attribute aufweisen.
-
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 darstellen 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 dieses Eintrags in Byte 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 benötigt wird, um diesen Eintrag zu sammeln. -1 zeigt an, dass die Zeit unwichtig ist. -
pii
Persönlich identifizierbare Informationen. Gibt an, ob der Eintrag Informationen enthält, die den Systembesitzer oder Details zu seiner Netzwerktopologie identifizieren können. Das Attribut kann einen der folgenden Werte haben:-
no
: keine PII ist in diesen Einträgen enthalten -
yes
: PII ist wahrscheinlich oder sicher in diesen Einträgen -
maybe
: Sie können diese Einträge auf PII prüfen -
if_customized
wenn die Dateien unverändert sind, enthalten sie keine PII. Da wir jedoch die Bearbeitung dieser Dateien ermutigen, könnten PII durch eine solche Anpassung eingeführt worden sein. Dieser Wert wird insbesondere für die Netzwerkskripte in der Steuerungsdomäne verwendet.
Passwörter dürfen in keinem Fehlerbericht enthalten sein, unabhängig von einer PII-Deklaration.
-
Die Hosts, auf denen diese Operation ausgeführt werden soll, werden mit dem Standardauswahlmechanismus ausgewählt (siehe Host-Selektorenoben).
host-get-thread-diagnostics
host-get-thread-diagnostics uuuid = uuid
Zeigt Pro-Host-Thread-Diagnoseinformationen an.
host-get-vms-which-prevent-evacuation
host-get-vms-which-prevent-evakuation uuuid = uuid
Gibt eine Liste von VMs zurück, die die Evakuierung eines bestimmten Hosts verhindern, und zeigt Gründe für jeden Host an.
host-is-in-emergency-mode
Host-is-in-Notfall-Modus
Gibt zurücktrue
, wenn sich der Host, mit dem die CLI spricht,false
im Notfallmodus befindet. Dieser CLI-Befehl funktioniert direkt auf Slave-Hosts, auch wenn kein Master-Host vorhanden ist.
host-license-add
host-license-add [license-file = pfad/license_filename] [host-uuid = host_uuid]
Verwenden Sie für (kostenlose Edition), um eine lokale Lizenzdatei zu analysieren und sie dem angegebenen Host hinzuzufügen.
host-license-remove
host-Lizenzen-remove [host-uuid = host_uuid]
Entfernen Sie alle Lizenzierungen, die auf einen Host angewendet werden.
host-license-view
Host-Lizenz-Ansicht [host-uuid = host_uuid]
Zeigt den Inhalt der Hostlizenz an.
host-logs-download
host-logs-download [file-name = logfile_name] [host-selector = host_selector_value...]
Laden Sie eine Kopie der Protokolle der angegebenen Hosts herunter. Die Kopie wird standardmäßig in einer Zeitstempeldatei mit dem Namen gespeicherthostname-yyyy-mm-dd T hh:mm:ssZ.tar.gz
. Sie können einen anderen Dateinamen mit dem optionalen Parameter file-nameangeben.
Die Hosts, auf denen diese Operation ausgeführt werden soll, werden mit dem Standardauswahlmechanismus ausgewählt (siehe Host-Selektorenoben). Optionale Argumente können beliebig viele [Hostparameter]sein, die am Anfang dieses Abschnitts#host-parameters()aufgeführt sind.
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 angegeben), verwenden Sie ihn nicht auf diese Weise. Dadurch wird die Steuerdomänenpartition mit der Kopie der Protokolle überladet. Der Befehl sollte nur von einem externen externen Computer verwendet werden, auf dem Sie Speicherplatz für die Kopie der Protokolle haben.
host-management-disable
Host-Management-Deaktivieren
Deaktiviert den Host-Agent, der auf eine externe Verwaltungsnetzwerkschnittstelle wartet, und trennt alle verbundenen API-Clients (z. B. die ). Dieser Befehl funktioniert direkt auf dem Host, mit dem die CLI verbunden ist. Der Befehl wird nicht an den Poolmaster weitergeleitet, wenn er auf einen Mitglieds host angewendet wird.
Achtung:
Seien Sie vorsichtig, wenn Sie diesen CLI-Befehl off-host verwenden. Nachdem dieser Befehl ausgeführt wurde, können Sie keine Remoteverbindung mit der Steuerungsdomäne über das Netzwerk herstellen, um den Host-Agent wieder zu aktivieren.
host-management-reconfigure
host-Management-reconfigure [interface = device] [pif-uuid = uuid]
Konfiguriert den Host so, dass die angegebene Netzwerkschnittstelle als Verwaltungsschnittstelle verwendet wird. Dies ist die Schnittstelle, die für die Verbindung mit dem verwendet wird . Der Befehl schreibt den MANAGEMENT_INTERFACE Schlüssel in um/etc/xensource-inventory
.
Wenn der Gerätename einer Schnittstelle (die eine IP-Adresse haben muss) angegeben wird, wird der Host sofort neu bindet. Dieser Befehl funktioniert sowohl im normalen als auch im Notfallmodus.
Wenn die UUID eines PIF-Objekts angegeben wird, bestimmt der Host, welche IP-Adresse an sich selbst gebunden werden soll. Er darf sich nicht im Notfallmodus befinden, wenn dieser Befehl ausgeführt wird.
Achtung:
Seien Sie vorsichtig, wenn Sie diesen CLI-Befehl außerhalb des Hosts verwenden, und stellen Sie sicher, dass Sie über eine Netzwerkverbindung auf der neuen Schnittstelle verfügen. Verwenden Sie
xe pif-reconfigure
, um zuerst einen einzurichten. Andernfalls erreichen nachfolgende CLI-Befehle den Host.
host-power-on
host-power-on [host = host_uuid]
Schaltet Hosts mit aktivierter Funktion zum Einschalten des Hosts ein. Bevor Sie diesen Befehl verwenden, aktivieren host-set-power-on
Sie auf dem Host.
host-reboot
host-reboot [host-selector = host_selector_value...]
Starten Sie die angegebenen Hosts neu. Die angegebenen Hosts müssen zuerst mit demxe host-disable
Befehl deaktiviert werden, andernfalls wird eineHOST_IN_USE
Fehlermeldung angezeigt.
Die Hosts, auf denen diese Operation ausgeführt werden soll, werden mit dem Standardauswahlmechanismus ausgewählt (siehe Host-Selektorenoben). Optionale Argumente können beliebig viele [Hostparameter]sein, die am Anfang dieses Abschnitts#host-parameters()aufgeführt sind.
Wenn die angegebenen Hosts Mitglieder eines Pools sind, wird der Verlust der Konnektivität beim Herunterfahren behandelt und der Pool wird wiederhergestellt, wenn die Hosts 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:
- Sie machen eines der Mitglieder in den Master
-
Der ursprüngliche Master wird neu gestartet und wieder online.
Wenn der Master wieder online ist, stellen sich die Mitglieder erneut eine Verbindung her und synchronisieren sie mit dem Master.
host-restore
host-restore [Dateiname = backup_filename] [host-selector = host_selector_value...]
Stellen Sie eine Sicherung mit dem Namenfile-name
der Hoststeuerungssoftware wieder her. Die Verwendung des Wortes „Restore“ bedeutet hier nicht eine vollständige Wiederherstellung im üblichen Sinne, sondern lediglich, dass die komprimierte Sicherungsdatei unkomprimiert und auf die sekundäre Partition entpackt wurde. Nachdem Sie eine abgeschlossen habenxe host-restore
, müssen Sie die Installations-CD starten und die Option „Aus Sicherung wiederherstellen“ verwenden.
Die Hosts, auf denen diese Operation ausgeführt werden soll, werden mit dem Standardauswahlmechanismus ausgewählt (siehe Host-Selektorenoben). Optionale Argumente können beliebig viele [Hostparameter]sein, die am Anfang dieses Abschnitts#host-parameters()aufgeführt sind.
host-send-debug-keys
host-send-debug-keys host-uuid = host_uuid Schlüssel = Schlüssel
Senden Sie die angegebenen Hypervisor-Debug-Schlüssel an den angegebenen Host.
host-set-hostname-live
host-set-hostname host-uuid = uuid_of_host hostname = new_hostname
Ändern Sie den Hostnamen des durch angegebenen Hostshost-uuid
. Dieser Befehl legt sowohl den Hostnamen in der Steuerelementdomänendatenbank als auch den tatsächlichen Linux-Hostnamen des Hosts fest. Der Wert von hostname entspricht nicht dem Wert des Feldes name_label .
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“ "„power_on_user“ "„power_on_password_secret“]}
Verwenden Sie diese Option, um die *Host-Einschaltfunktion auf * Hosts zu aktivieren, die mit Remote-Stromversorgungslösungen kompatibel sind. Wenn Sie denhost-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 Passworts zu verwenden"power_on_password_secret"
.
host-shutdown
host-shutdown [host-selector = host_selector_value...]
Fahren Sie die angegebenen Hosts herunter. Die angegebenen Hosts müssen zuerst mit demxe host-disable
Befehl deaktiviert werden, andernfalls wird eineHOST_IN_USE
Fehlermeldung angezeigt.
Die Hosts, auf denen diese Operation ausgeführt werden soll, werden mit dem Standardauswahlmechanismus ausgewählt (siehe Host-Selektorenoben). Optionale Argumente können beliebig viele [Hostparameter]sein, die am Anfang dieses Abschnitts#host-parameters()aufgeführt sind.
Wenn die angegebenen Hosts Mitglieder eines Pools sind, wird der Verlust der Konnektivität beim Herunterfahren behandelt und der Pool wird wiederhergestellt, wenn die Hosts 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:
- Sie machen eines der Mitglieder in den Master
-
Der ursprüngliche Master wird neu gestartet und wieder online.
Wenn der Master wieder online ist, stellen sich die Mitglieder erneut eine Verbindung her und synchronisieren sie mit dem Master.
Wenn HA für den Pool aktiviert ist, wird eines der Elemente automatisch zu einem Master gemacht. Wenn HA deaktiviert ist, müssen Sie den gewünschten Server mit dempool-designate-new-master
Befehl 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]
Versuchen Sie, einen Speicherdatapath auf einem Host zu zerstören und zu bereinigen. Wenn angegebenallow-leak=true
ist, werden alle Datensätze des Datenpfad gelöscht, auch wenn er nicht sauber heruntergefahren werden konnte.
host-sync-data
Host-Sync-Daten
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 densyslog
Daemon auf den angegebenen Hosts neu. Dieser Befehl wendet die Konfigurationsinformationen an, die im Host-logging
Parameter definiert sind.
Die Hosts, auf denen diese Operation ausgeführt werden soll, werden mit dem Standardauswahlmechanismus ausgewählt (siehe Host-Selektorenoben). Optionale Argumente können beliebig viele [Hostparameter]sein, die am Anfang dieses Abschnitts#host-parameters()aufgeführt sind.
host-data-source-list
host-data-source-list [host-selectors = Host-Selektor-Wert...]
Listen Sie die Datenquellen auf, die für einen Host aufgezeichnet werden können.
Wählen Sie mithilfe des Standardauswahlmechanismus die Hosts aus, auf denen dieser Vorgang ausgeführt werden soll (siehe Host-Selektoren). Optionale Argumente können beliebig viele [Hostparameter]sein, die am Anfang dieses Abschnitts#host-parameters()aufgeführt sind. Wenn keine Parameter zur Auswahl von Hosts angegeben sind, wird der Vorgang auf allen Hosts ausgeführt.
Datenquellen haben zwei Parameter —standard
undenabled
. Dieser Befehl gibt die Werte der Parameter aus:
- Wenn eine Datenquelle auf
enabled
festgelegt isttrue
, werden die Metriken derzeit in der Performance-Datenbank aufgezeichnet. - Wenn eine Datenquelle auf
standard
festgelegt isttrue
, werden die Metriken standardmäßig in der Performance-Datenbank aufgezeichnet. Der Wert vonenabled
wird auchtrue
für diese Datenquelle auf festgelegt. - Wenn eine Datenquelle auf
standard
festgelegt istfalse
, werden die Metriken standardmäßig nicht in der Performance-Datenbank aufgezeichnet. Der Wert vonenabled
wird auchfalse
für diese Datenquelle auf festgelegt.
Führen Sie denhost-data-source-record
Befehl aus, um die Aufzeichnung von Datenquellenmetriken in der Performance-Datenbank zu starten. Dieser Befehl setztenabled
auftrue
. Um zu stoppen, führen Sie die aushost-data-source-forget
. Dieser Befehl setztenabled
auffalse
.
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 persistente Performance-Metrik-Datenbank der angegebenen Hosts. Aus Leistungsgründen unterscheidet sich diese Datenbank von der normalen Agentendatenbank.
Wählen Sie mithilfe des Standardauswahlmechanismus die Hosts aus, auf denen dieser Vorgang ausgeführt werden soll (siehe Host-Selektoren). Optionale Argumente können beliebig viele [Hostparameter]sein, die am Anfang dieses Abschnitts#host-parameters()aufgeführt sind. Wenn keine Parameter zur 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 mithilfe des Standardauswahlmechanismus die Hosts aus, auf denen dieser Vorgang ausgeführt werden soll (siehe Host-Selektoren). Optionale Argumente können beliebig viele [Hostparameter]sein, die am Anfang dieses Abschnitts#host-parameters()aufgeführt sind. Wenn keine Parameter zur 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 mithilfe des Standardauswahlmechanismus die Hosts aus, auf denen dieser Vorgang ausgeführt werden soll (siehe Host-Selektoren). Optionale Argumente können beliebig viele [Hostparameter]sein, die am Anfang dieses Abschnitts#host-parameters()aufgeführt sind. Wenn keine Parameter zur Auswahl von Hosts angegeben sind, wird der Vorgang auf allen Hosts ausgeführt.
Protokollbefehle
Befehle zum Arbeiten mit Protokollen.
log-get
Log-Get
Gibt das aktuell im String-Logger gespeicherte Protokoll zurück.
log-get-keys
Logget-Schlüssel
Listen Sie die vom Logger bekannten Schlüssel auf.
log-reopen
Anmelden erneut öffnen
Öffnen Sie alle Logger erneut (verwenden Sie dies zum Drehen von Dateien).
log-set-output
log-set-output output = output [key = key] [level = level]
Setzen Sie alle Logger auf die angegebene Ausgabe (nil, stderr, string, file:filename, syslog:something).
Nachrichtenbefehle
Befehle zum Arbeiten mit Nachrichten. Nachrichten werden erstellt, um Benutzer über wichtige Ereignisse zu informieren und werden in als Warnungen angezeigt.
Die Nachrichtenobjekte können mit dem Standardobjektlistenbefehl (xe message-list
) aufgelistet und die Parameter werden mit den Standardparameterbefehlen bearbeitet. Weitere Informationen finden Sie unter Low-Level-Parameterbefehle
Message-Parameter
Parametername | Beschreibung | Typ |
---|---|---|
uuid |
Die eindeutige Bezeichnung/Objektreferenz für die Nachricht | Nur lesen |
name |
Der eindeutige Name der Nachricht | Nur lesen |
priority |
Die Nachrichtenpriorität. Höhere Zahlen weisen auf höhere Priorität hin | Nur lesen |
class |
Die Nachrichtenklasse, z. B. VM. | Nur lesen |
obj-uuid |
Die UUID des betroffenen Objekts. | Nur lesen |
timestamp |
Die Zeit, zu der die Nachricht generiert wurde. | Nur lesen |
body |
Der Nachrichteninhalt. | Nur lesen |
message-create
message-create name = message_name body = message_text [[host-uuid = uuid_of_host] | [sr-uuid = uuid_of_sr} | [vm-uuid = uuuid_of_vm] | [pool-uuid = uuuid_of_pool]]
Erstellt eine Nachricht.
message-destroy
message-destroy [uuid = message_uuid]
Löscht eine vorhandene Nachricht. Sie können ein Skript erstellen, um alle Nachrichten zu zerstören. Zum Beispiel:
# Alle Warnungen \ schließen IFS = „,“; für m in $(xe message-list params = uuid — minimal); do \
xe message-destroy uuid = $m \
erledigt
Netzwerkbefehle
Befehle zum Arbeiten mit Netzwerken.
Die Netzwerkobjekte können mit dem Standardobjektlistenbefehl (xe network-list
) aufgelistet und die Parameter werden mit den Standardparameterbefehlen bearbeitet. Weitere Informationen finden Sie unter Low-Level-Parameterbefehle
Netzwerkparameter
Netzwerke haben folgende Parameter:
Parametername | Beschreibung | Typ |
---|---|---|
uuid |
Die eindeutige Bezeichnung/Objektreferenz für das Netzwerk | Nur lesen |
name-label |
Der Name des Netzwerks | Lesen/Schreiben |
name-description |
Der Beschreibungstext des Netzwerks | Lesen/Schreiben |
VIF-uuids |
Eine Liste der eindeutigen Bezeichner der VIFs (Virtual Network Interfaces), die von VMs an dieses Netzwerk angeschlossen sind | Schreibgeschützte Parameter festlegen |
PIF-uuids |
Eine Liste der eindeutigen Bezeichner der PIFs (physikalische Netzwerkschnittstellen), die von Hosts an dieses Netzwerk angeschlossen sind | Schreibgeschützte Parameter festlegen |
bridge |
Name der Brücke, die diesem Netzwerk auf dem lokalen Host entspricht | Nur lesen |
default-locking-mode |
Ein Netzwerkobjekt, das mit VIF-Objekten für die ARP-Filterung verwendet wird. Setzen Sie aufunlocked , um alle mit der VIF verknüpften Filterregeln zu entfernen. Diese Einstellung istdisabled so eingestellt, dass die VIF den gesamten Datenverkehr ablegt. |
Lesen/Schreiben |
purpose |
Satz von Zwecken, für die der Host dieses Netzwerk verwendet. Setzen Sie aufnbd , um das Netzwerk zum Herstellen von Verbindungen am NBD zu verwenden. |
Lesen/Schreiben |
other-config:staticroutes |
Kommagetrennte Liste von Subnetz/Netzmaske/Gatewayformatierten Einträgen, die die Gateway-Adresse angeben, über die Subnetze weitergeleitet werden sollen. Wenn Sie beispielsweiseother-config:static-routes auf 172.16.0.0/15/192 .168.0.3, 172.18.0.0/16/192 .168.0.4 setzen, wird Datenverkehr auf 172.16.0.0/15 über 192.168.0.3 und Datenverkehr auf 172.18.0.0/16 über 192.168.0.4 weitergeleitet. |
Lesen/Schreiben |
other-config:ethtoolautoneg |
Setzen Sie auf Nein, um die automatische Aushandlung der physischen Schnittstelle oder Brücke zu deaktivieren. Der Standardwert ist ja. | Lesen/Schreiben |
other-config:ethtool-rx |
Setzen Sie auf ein, um Empfangsprüfsumme zu aktivieren, aus, um zu deaktivieren | Lesen/Schreiben |
other-config:ethtool-tx |
Setzen Sie auf ein, um die Transmit-Prüfsumme zu aktivieren, aus, um zu deaktivieren | Lesen/Schreiben |
other-config:ethtool-sg |
Setzen Sie auf ein, um Scatter sammeln zu aktivieren, aus, um zu deaktivieren | Lesen/Schreiben |
other-config:ethtool-tso |
Setzen Sie auf ein, um die TCP Segmentierung Offload zu aktivieren, aus, um zu deaktivieren | Lesen/Schreiben |
other-config:ethtool-ufo |
Setzen Sie auf ein, um UDP-Fragmentabladungen zu aktivieren, aus, um zu deaktivieren | Lesen/Schreiben |
other-config:ethtool-gso |
Setzen Sie auf ein, um generische Segmentierungseffload zu aktivieren, aus, um zu deaktivieren | Lesen/Schreiben |
blobs |
Binärer Datenspeicher | Nur lesen |
network-create
network-create name-label = name_for_network [name-description = descriptive_text]
Erstellt ein Netzwerk.
network-destroy
netzwerk-destroy uuid = network_uuid
Löscht ein vorhandenes Netzwerk.
SR-IOV-Befehle
Befehle zum Arbeiten mit SR-IOV.
Die Netzwerk-sriov-Objekte können mit dem Standardobjekt-Listing-Befehl (xe network-sriov-list
) aufgelistet werden, und die Parameter werden mit den Standardparameterbefehlen bearbeitet. Weitere Informationen finden Sie unter Low-Level-Parameterbefehle
SR-IOV-Parameter
SR-IOV hat die folgenden Parameter:
Parametername | Beschreibung | Typ |
---|---|---|
physical-PIF |
Der PIF zum Aktivieren von SR-IOV. | Nur lesen |
logical-PIF |
Eine logische SR-IOV PIF. Benutzer können diesen Parameter verwenden, um ein SR-IOV-VLAN-Netzwerk zu erstellen. | Nur lesen |
requires-reboot |
Wenn auf True gesetzt, wird der Host neu gestartet, um SR-IOV-Aktivierung in Kraft zu setzen. | Nur lesen |
remaining-capacity |
Anzahl der verbleibenden VFs. | Nur lesen |
network-sriov-create
xe Netzwerk-sriov-create network-uuid = network_uuid pif-uuid = physical_pif_uuid
Erstellt ein SR-IOV-Netzwerkobjekt für eine gegebene physische PIF und aktiviert SR-IOV auf dem physischen PIF.
network-sriov-destroy
xe Netzwerk-sriov-destroy uuid = network_sriov_uuid
Entfernt ein Netzwerk-SR-IOV-Objekt und deaktiviert SR-IOV auf seinem physischen PIF.
Zuweisen einer SR-IOV VF
xe vif-create device = device_index mac = vf_mac_address network-uuid = sriov_network vm-uuid = vm_uid
Weist einer VM eine VF von einem SR-IOV-Netzwerk zu.
SDN-Controller-Befehle
Befehle zum Arbeiten mit dem SDN-Controller.
sdn-controller-forget
sdn-controller-einführen [Adresse = Adresse] [Protokoll = Protokoll] [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 Patch-Datei.
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 Patch-Datei auf allen Hosts im Pool.
patch-precheck
patch-precheck uuid = uuid host-uuid = host_uuid
Führen Sie die Prechecks aus, die in dem Patch enthalten sind, der zuvor auf den angegebenen Host hochgeladen wurde.
patch-upload
patch-upload file-name = file_name
Laden Sie eine Patch-Datei auf den Server hoch.
PBD-Befehle
Befehle zum Arbeiten mit PBDs (Physical Block Devices). PBDs sind die Softwareobjekte, über die der Host auf Speicher-Repositories (SRs) zugreift.
Die PBD-Objekte können mit dem Standardobjektauflistungsbefehl (xe pbd-list
) aufgelistet und die Parameter werden mit den Standardparameterbefehlen bearbeitet. Weitere Informationen finden Sie unter Low-Level-Parameterbefehle
PBD-Parameter
PBDs haben die folgenden Parameter:
Parametername | Beschreibung | Typ |
---|---|---|
uuid |
Die eindeutige Bezeichnung/Objektreferenz für die PBD. | Nur lesen |
sr-uuid |
Das Speicher-Repository, auf das die PBD verweist | Nur lesen |
device-config |
Zusätzliche Konfigurationsinformationen, die dem SR-Backend-Treiber eines Hosts zur Verfügung gestellt werden | Schreibgeschützte Zuordnungsparameter |
currently-attached |
True, wenn der SR auf diesem Host angehängt ist, andernfalls False | Nur lesen |
host-uuid |
UUID der physischen Maschine, auf der die PBD verfügbar ist | Nur lesen |
host |
Das Hostfeld ist veraltet. Verwenden Sie stattdessen host_uuid. | Nur lesen |
other-config |
Zusätzliche Konfigurationsinformationen. | Zuordnungsparameter Lese-/Schreibzugriff |
pbd-create
pbd-create host-uuid = uuid_of_host sr-uuid = uuid_of_sr [device-config: key = korrespondierender_value]
Erstellen Sie eine PBD auf Ihrem Host. Der schreibgeschütztedevice-config
Parameter kann nur beim Erstellen festgelegt werden.
Um eine Zuordnung von ‘path’ zu ‘/ tmp’ hinzuzufügen, sollte die Befehlszeile das Argumentdevice-config:path=/tmp
Eine vollständige Liste der unterstützten Schlüssel/Wert -Paare für die einzelnen SR-Typen finden Sie unter Speicher.
pbd-destroy
pbd-destroy uuid = uuid_of_pbd
Zerstört die angegebene PBD.
pbd-plug
pbd-plug uuid = uuid_of_pbd
Versucht, die PBD an den Host anzuschließen. Wenn dieser Befehl erfolgreich ist, sollten die referenzierte SR (und die darin enthaltenen VDIs) für den Host sichtbar werden.
pbd-unplug
pbd-unplug uuid = uuid_of_pbd
Versuchen Sie, die PBD vom Host zu trennen.
PIF-Befehle
Befehle zum Arbeiten mit PIFs (Objekte, die die physischen Netzwerkschnittstellen darstellen).
Die PIF-Objekte können mit dem Standardobjektauflistungsbefehl (xe pif-list
) aufgelistet und die Parameter werden mit den Standardparameterbefehlen bearbeitet. Weitere Informationen finden Sie unter Low-Level-Parameterbefehle
PIF-Parameter
PIF haben die folgenden Parameter:
Parametername | Beschreibung | Typ |
---|---|---|
uuid |
Die eindeutige Bezeichnung/Objektreferenz für die PIF | Nur lesen |
device machine-readable |
Name der Schnittstelle (z.B. eth0) | Nur lesen |
MAC |
Die MAC-Adresse des PIF | Nur lesen |
other-config |
Zusätzliche PIF-Konfigurationname:value spaare. |
Zuordnungsparameter Lese-/Schreibzugriff |
physical |
Wenn true, zeigt der PIF auf eine tatsächliche physische Netzwerkschnittstelle | Nur lesen |
currently-attached |
Ist die PIF derzeit auf diesem Host angeschlossen? true oderfalse
|
Nur lesen |
MTU |
Maximale Übertragungseinheit des PIF in Bytes. | Nur lesen |
VLAN |
VLAN-Tag für den gesamten Datenverkehr, der über diese Schnittstelle verläuft. -1 gibt an, dass kein VLAN-Tag zugewiesen ist | Nur lesen |
bond-master-of |
Die UUID der Bindung, die diese PIF ist der Master von (falls vorhanden) | Nur lesen |
bond-slave-of |
Die UUID der Bindung, die diese PIF ist der Slave von (falls vorhanden) | Nur lesen |
management |
Ist dieser PIF als Verwaltungsschnittstelle für die Steuerdomäne bestimmt | Nur lesen |
network-uuid |
Die eindeutige Bezeichnung/Objektreferenz des virtuellen Netzwerks, mit dem diese PIF verbunden ist | Nur lesen |
network-name-label |
Der Name des virtuellen Netzwerks, mit dem dieser PIF verbunden ist | Nur lesen |
host-uuid |
Die eindeutige Bezeichnung/Objektreferenz des Hosts, mit dem dieser PIF verbunden ist | Nur lesen |
host-name-label |
Der Name des Hosts, mit dem dieser PIF verbunden ist | Nur lesen |
IP-configuration-mode |
Typ der verwendeten Netzwerkadresskonfiguration; DHCP oder statisch | Nur lesen |
IP |
IP-Adresse der PIF. Hier definiert, wenn der IP-Konfigurationsmodus statisch ist; nicht definiert, wenn DHCP | Nur lesen |
netmask |
Netzmaske des PIF. Hier definiert, wenn der IP-Konfigurationsmodus statisch ist; nicht definiert, wenn er von DHCP bereitgestellt wird | Nur lesen |
gateway |
Gateway-Adresse des PIF. Hier definiert, wenn der IP-Konfigurationsmodus statisch ist; nicht definiert, wenn er von DHCP bereitgestellt wird | Nur lesen |
DNS |
DNS-Adresse des PIF. Hier definiert, wenn der IP-Konfigurationsmodus statisch ist; nicht definiert, wenn er von DHCP bereitgestellt wird | Nur lesen |
io_read_kbs |
Durchschnittliche Leserate in KB/s für das Gerät | Nur lesen |
io_write_kbs |
Durchschnittliche Schreibrate in KB/s für das Gerät | Nur lesen |
carrier |
Verbindungsstatus für dieses Gerät | Nur lesen |
vendor-id |
Die ID, die dem Anbieter der Netzwerkkarte zugewiesen wurde | Nur lesen |
vendor-name |
Name des NIC-Anbieters | Nur lesen |
device-id |
Die vom Hersteller diesem NIC-Modell zugewiesene ID | Nur lesen |
device-name |
Der Name, der dem Anbieter diesem NIC-Modell zugewiesen wurde | Nur lesen |
speed |
Datenübertragungsrate der NIC | Nur lesen |
duplex |
Duplex-Modus der NIC; voll oder halb | Nur lesen |
pci-bus-path |
PCI-Bus-Pfadadresse | Nur lesen |
other-config:ethtoolspeed |
Legt die Verbindungsgeschwindigkeit in Mbps fest | Lesen/Schreiben |
other-config:ethtoolautoneg |
Setzen Sie auf Nein, um die automatische Aushandlung der physischen Schnittstelle oder Brücke zu deaktivieren. Der Standardwert ist ja. | Lesen/Schreiben |
other-config:ethtoolduplex |
Legt die Duplex-Funktion des PIF fest, entweder voll oder halb. | Lesen/Schreiben |
other-config:ethtool-rx |
Setzen Sie auf ein, um Empfangsprüfsumme zu aktivieren, aus, um zu deaktivieren | Lesen/Schreiben |
other-config:ethtool-tx |
Setzen Sie auf ein, um die Transmit-Prüfsumme zu aktivieren, aus, um zu deaktivieren | Lesen/Schreiben |
other-config:ethtool-sg |
Setzen Sie auf ein, um Scatter sammeln zu aktivieren, aus, um zu deaktivieren | Lesen/Schreiben |
other-config:ethtool-tso |
Setzen Sie auf ein, um die TCP Segmentierung Offload zu aktivieren, aus, um zu deaktivieren | Lesen/Schreiben |
other-config:ethtool-ufo |
Setzen Sie auf on, um udp Fragment Offload zu aktivieren, aus, um zu deaktivieren | Lesen/Schreiben |
other-config:ethtool-gso |
Setzen Sie auf ein, um generische Segmentierungseffload zu aktivieren, aus, um zu deaktivieren | Lesen/Schreiben |
other-config:domain |
Durch Kommas getrennte Liste zum Festlegen des DNS-Suchpfads | Lesen/Schreiben |
other-config:bondmiimon |
Intervall zwischen Link-Lebenhausprüfungen, in Millisekunden | Lesen/Schreiben |
other-config:bonddowndelay |
Anzahl der Millisekunden zu warten, nachdem der Link verloren gegangen ist, bevor der Link wirklich verschwunden ist. Dieser Parameter ermöglicht einen vorübergehenden Verbindungsverlust | Lesen/Schreiben |
other-config:bondupdelay |
Anzahl der Millisekunden, die warten müssen, nachdem der Link auftaucht, bevor er wirklich darüber nachdenkt. Ermöglicht das Aufklappen von Links. Standardmäßig ist31s es, dass Switches Zeit für die Weiterleitung des Datenverkehrs einräumen. |
Lesen/Schreiben |
disallow-unplug |
True, wenn diese PIF eine dedizierte Speicher-NIC ist, andernfalls false | Lesen/Schreiben |
Hinweis:
Änderungen an den
other-config
Feldern eines PIF werden erst nach einem Neustart wirksam. Alternativ 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ört 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 Host darstellt.
pif-plug
pif-plug uuid = uuid_of_pif
Versuchen Sie, die angegebene physische Schnittstelle aufzurufen.
pif-reconfigure-ip
pif-reconfigure-ip uuuid = 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 denmode Parameter aufstatic
, mitgatewayIP
```` , undnetmask`` -Parameter auf die entsprechenden Werte festgelegt. Um DHCP zu verwenden, setzen Sie denmode
Parameter aufDHCP
und lassen Sie die statischen Parameter nicht definiert.
Hinweis:
Die Verwendung statischer IP-Adressen auf physischen Netzwerkschnittstellen, die mit einem Port eines Switches verbunden sind, wobei das Spanning Tree Protocol mit ausgeschalteter (oder nicht unterstützter) STP Fast Link verwendet wird, führt zu einem Zeitraum, in dem kein Datenverkehr vorliegt.
pif-reconfigure-ipv6
pif-reconfigure-ipv6 uuuid = 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 nach neuen physischen Schnittstellen auf Ihrem Host.
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 physikalische Schnittstelle herunterzufahren.
Pool-Befehle
Befehle zum Arbeiten mit Pools. Ein Pool ist ein Aggregat aus einem oder mehreren Hosts. Ein Pool verwendet mindestens ein freigegebenes Speicher-Repositorys, 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 läuft, ohne dass sie heruntergefahren und wieder hochgefahren werden muss. Jeder Host ist wirklich ein Pool, der standardmäßig aus einem einzelnen Mitglied besteht. Wenn Ihr Host mit einem Pool verbunden ist, wird er als Mitglied bezeichnet, und der Pool, dem er beigetreten ist, wird zum Master für den Pool.
Das Singleton-Poolobjekt kann mit dem Standardobjekt-Listing-Befehl (xe pool-list
) aufgelistet werden. Seine Parameter können mit den Standardparameter-Befehlen manipuliert werden. Weitere Informationen finden Sie unter Low-Level-Parameterbefehle
Pool-Parameter
Pools haben folgende Parameter:
Parametername | Beschreibung | Typ |
---|---|---|
uuid |
Die eindeutige Bezeichnung/Objektreferenz für den Pool | Nur lesen |
name-label |
Der Name des Pools | Lesen/Schreiben |
name-description |
Die Beschreibungszeichenfolge des Pools | Lesen/Schreiben |
master |
Die eindeutige Bezeichnung/Objektreferenz des Hosts, der als Master des Pools bezeichnet wird | Nur lesen |
default-SR |
Die eindeutige Bezeichnung/Objektreferenz der Standard-SR für den Pool | Lesen/Schreiben |
crash-dump-SR |
Die eindeutige Bezeichnung/Objektreferenz der SR, in der Absturzabbilder für Poolmitglieder gespeichert werden | Lesen/Schreiben |
metadata-vdis |
Alle bekannten Metadaten-VDIs für den Pool | Nur lesen |
suspend-image-SR |
Die eindeutige Bezeichnung/Objektreferenz der SR, in der angehaltene VMs auf Poolmitgliedern gespeichert werden | Lesen/Schreiben |
other-config |
Eine Liste von Schlüssel/Wert -Paaren, die zusätzliche Konfigurationsparameter für den Pool angeben | Zuordnungsparameter Lese-/Schreibzugriff |
supported-sr-types |
SR-Typen, die dieser Pool verwenden kann | Nur lesen |
ha-enabled |
True, wenn HA für den Pool aktiviert ist, andernfalls false | Nur lesen |
ha-configuration |
Für die zukünftige Verwendung reserviert. | Nur lesen |
ha-statefiles |
Listet die UUIDs der VDIs auf, die von HA zum Bestimmen des Speicherzustands verwendet werden | Nur lesen |
ha-host-failures-to-tolerate |
Die Anzahl der Hostausfälle, die vor dem Senden einer Systemwarnung toleriert werden sollen | Lesen/Schreiben |
ha-plan-exists-for |
Die Anzahl der Hosts Fehler, die tatsächlich behandelt werden können, gemäß den Berechnungen des HA-Algorithmus | Nur lesen |
ha-allow-overcommit |
True, wenn der Pool überschrieben werden darf, andernfalls False | Lesen/Schreiben |
ha-overcommitted |
True, wenn der Pool zu viel festgeschrieben ist | Nur lesen |
blobs |
Binärer Datenspeicher | Nur lesen |
live-patching-disabled |
Setzen Sie auf False, um Live-Patching zu aktivieren. Setzen Sie auf True, um Live-Patching zu deaktivieren. | Lesen/Schreiben |
igmp-snooping-enabled |
Auf True setzen, um IGMP Snooping zu aktivieren. Setzen Sie auf False, um IGMP Snooping zu deaktivieren. | Lesen/Schreiben |
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 = Dateiname
Installieren Sie ein SSL-Zertifikat, poolweit.
pool-certificate-list
Pool-Zertifikatliste
Listet alle installierten SSL-Zertifikate auf.
pool-certificate-sync
Pool-Zertifikat-Synchronisierung
Synchronisieren Sie SSL-Zertifikate und Zertifikatsperrlisten vom Master zu Slaves.
pool-certificate-uninstall
pool-Zertifikat-Deinstallationsname = Name
Deinstallieren Sie ein SSL-Zertifikat.
pool-crl-install
pool-crl-install Dateiname = Dateiname
Installieren Sie eine SSL-Zertifikatsperrliste im Poolbereich.
pool-crl-list
Pool-crl-Liste
Listet alle installierten SSL-Zertifikatsperrlisten auf.
pool-crl-uninstall
pool-crl-uninstall name = name
Deinstallieren Sie eine SSL-Zertifikatsperrliste.
pool-deconfigure-wlb
pool-deconfigure-wlb
Entfernen Sie die Konfiguration für den Arbeitslastenausgleich dauerhaft.
pool-designate-new-master
pool-designate-new-master host-uuid = uuid_of_new_master
Weisen Sie den angegebenen Mitglieds host 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 Notfallmodus-Befehle.
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 uuuid = uuid
Deaktivieren Sie das lokale Speicher-Caching im gesamten Pool.
pool-disable-redo-log
Pool-disable-Redo-Log
Deaktivieren Sie das Redo Log bei Verwendung, es sei denn, HA ist aktiviert.
pool-disable-ssl-legacy
pool-disable-ssl-legacy [uuid = uuid]
Setzen Sie ssl-legacy auf False auf jedem Host.
pool-dump-database
pool-dump-database file-name = filename_to_dump_database_into_( on_client)
Laden Sie eine Kopie der gesamten Pooldatenbank herunter und legen Sie sie in eine Datei auf dem Client ab.
pool-enable-external-auth
pool-enable-external-auth auth-type = auth_type service-name = service_name [uuid = uuuid] [config: = config]
Aktiviert die externe Authentifizierung auf allen Hosts in einem Pool. Beachten Sie, dass einige Werte von auth-type bestimmte config: values erfordern.
pool-enable-local-storage-caching
pool-enable-local-storage-caching uuuid = uuid
Aktivieren Sie das Caching lokaler Speicher im gesamten Pool.
pool-enable-redo-log
pool-ensable-redo-log sr-uuid = sr_uuid
Aktivieren Sie das Redo Log auf dem angegebenen SR, wenn es verwendet wird, es sei denn, HA ist aktiviert.
pool-enable-ssl-legacy
pool-enable-ssl-legacy [uuid = uuid]
Setzen Sie ssl-legacy auf True auf jedem Host. „
pool-eject
pool-eject host-uuid = uuid_of_host_to_eject
Weisen Sie den angegebenen Host an, einen vorhandenen Pool zu verlassen.
pool-emergency-reset-master
pool-emergency-reset-master master-address = address_of_pool_master
Weisen Sie einen Slave-Mitglieder host an, seine Master-Adresse auf den neuen Wert zurückzusetzen und zu versuchen, eine Verbindung zu ihm herzustellen. Führen Sie diesen Befehl nicht auf Master-Hosts aus.
pool-emergency-transition-to-master
Pool-Notfall-Übergangs-zu-Master
Weisen Sie einen Mitglieds host an, der Poolmaster zu werden. Der Host akzeptiert diesen Befehl erst, nachdem der Host in den Notfallmodus übergegangen ist. Der Notfallmodus bedeutet, dass er Mitglied eines Pools ist, dessen Master aus dem Netzwerk verschwunden ist und nach einigen 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 die hohe Verfügbarkeit im Ressourcenpool, indem Sie die angegebene SR-UUID als zentrales Speicher-Heartbeat-Repository verwenden.
pool-ha-disable
Pool-ha-Deaktivieren
Deaktiviert die Hochverfügbarkeitsfunktion 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-hypothetisch-max-host-failures-to-tolerate [vm-uuid = vm_uuid] [restart-priority = restart_priority]
Berechnen Sie die maximale Anzahl von Hostfehlern, 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 des Arbeitslastenausgleichs 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 Ihren Host an, einem vorhandenen Pool beizutreten.
pool-management-reconfigure
pool-Management-reconfigure [network-uuid = network-uuid]
Konfiguriert die Verwaltungsschnittstelle aller Hosts im Pool so, dass die angegebene Netzwerkschnittstelle verwendet wird, d. h. die Schnittstelle, die zum Herstellen einer Verbindung mit dem verwendet wird . Der Befehl schreibt den Schlüssel MANAGEMENT_INTERFACE/etc/xensource-inventory
für alle Hosts im Pool neu.
Wenn der Gerätename einer Schnittstelle (die eine IP-Adresse haben muss) angegeben wird, wird der Master-Host sofort neu bindet. Dieser Befehl funktioniert sowohl im normalen als auch im Notfallmodus.
Aus der angegebenen Netzwerk-UUID wird die UUID des PIF-Objekts identifiziert und dem Host zugeordnet, der bestimmt, welche IP-Adresse an sich selbst gebunden werden soll. Er darf sich nicht im Notfallmodus befinden, wenn dieser Befehl ausgeführt wird.
Achtung:
Seien Sie vorsichtig, wenn Sie diesen CLI-Befehl außerhalb des Hosts verwenden, und stellen Sie sicher, dass Sie über eine Netzwerkverbindung auf der neuen Schnittstelle verfügen. Verwenden Sie
xe pif-reconfigure
, um zuerst einen einzurichten. Andernfalls erreichen nachfolgende CLI-Befehle den Host nicht.
pool-recover-slaves
Pool-Wiederherstellungs-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 normalerweise verwendet,pool-emergency-transition-to-master
nachdem eines der Elemente als neuen Master festgelegt wurde.
pool-restore-database
pool-restore-database file-name = filename_to_restore_from_on_client [dry-run = true | false]
Laden Sie eine Datenbanksicherung (erstellt mitpool-dump-database
) in einen Pool hoch. Beim Empfang 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 Pooldatenbank wiederhergestellt werden kann, ohne den Vorgang tatsächlich auszuführen. Standardmäßigdry-run
ist false festgelegt.
pool-retrieve-wlb-configuration
pool-retrieve-wlb-konfiguration
Ruft die Kriterien für die Pooloptimierung vom Workload Balancing-Server ab.
pool-retrieve-wlb-diagnostics
pool-retrieve-wlb-diagnostics [Dateiname = Dateiname]
Ruft Diagnosen vom Workload Balancing-Server 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 [Dateiname = Dateiname]
Ruft Berichte vom Workload Balancing-Server 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 der SSL-Schicht verwendet.
pool-send-wlb-configuration
pool-send-wlb-configuration [config: = config]
Legt die Kriterien für die Pooloptimierung für den Workload Balancing-Server fest.
pool-sync-database
Pool-Sync-Datenbank
Erzwingen Sie, dass die Pooldatenbank über alle Hosts im Ressourcenpool synchronisiert wird. Dieser Befehl ist im normalen Betrieb nicht erforderlich, da die Datenbank regelmäßig automatisch repliziert wird. Allerdings kann der Befehl nützlich sein, um sicherzustellen, dass Änderungen schnell repliziert werden, nachdem eine signifikante Gruppe von CLI-Operationen durchgeführt wurde.
Set Pooligmp-snooping
pool-param-set [uuid = pool-uuid] [igmp-snooping-enabled = true | false]
Aktiviert oder deaktiviert IGMP Snooping in einem Pool.
PVS-Beschleunigerbefehle
Befehle zum Arbeiten 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 einen VM/VIF, um einen PVS-Proxy zu verwenden.
pvs-proxy-destroy
pvs-proxy-destroy uuid = uuid
Entfernen (oder deaktivieren) Sie einen PVS-Proxy für diese VIF/VM.
pvs-server-forget
pvs-server-forget uuid = uuid
Vergessen Sie einen PVS-Server.
pvs-server-introduce
pvs-server-einführen adressen = adressen first port = first_port last-port = last_port pvs-site-uuid = pvs_site_uuid
Einführung des neuen PVS-Servers.
pvs-site-forget
pvs-site-vergessen uuid = uuid
Vergiss eine PVS-Website.
pvs-site-introduce
pvs-site-einführen name-label = name_label [name-description = name_description] [pvs-uuid = pvs_uuid]
Einführung neuer PVS-Website.
Storage Manager-Befehle
Befehle zum Steuern von Storage Manager-Plugins.
Die Speicher-Manager-Objekte können mit dem Standard-Objekt-Listing-Befehl (xe sm-list
) aufgelistet werden. Die Parameter können mit den Standardparameterbefehlen bearbeitet werden. Weitere Informationen finden Sie unter Low-Level-Parameterbefehle
SM-Parameter
SMs haben folgende Parameter:
Parametername | Beschreibung | Typ |
---|---|---|
uuid |
Die eindeutige Bezeichnung/Objektreferenz für das SM-Plugin | Nur lesen |
name-label |
Der Name des SM-Plugins | Nur lesen |
name-description |
Die Beschreibungszeichenfolge des SM-Plugins | Nur lesen |
type |
Der SR-Typ, mit dem dieses Plugin eine Verbindung herstellt | Nur lesen |
vendor |
Name des Herstellers, der dieses Plugin erstellt hat | Nur lesen |
copyright |
Copyright-Erklärung für dieses SM-Plugin | Nur lesen |
required-api-version |
Minimale SM-API-Version auf dem Host erforderlich | Nur lesen |
configuration |
Namen und Beschreibungen der Gerätekonfigurationsschlüssel | Nur lesen |
capabilities |
Funktionen des SM-Plugins | Nur lesen |
driver-filename |
Der Dateiname des SR-Treibers. | Nur lesen |
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, indem Sie einen vorhandenen Snapshot unter Verwendung des schnellen Festplatten-Clone-Vorgangs auf Speicherebene (sofern verfügbar) klonen.
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, ohne den schnellen Festplatten-Clone-Vorgang auf Speicherebene zu verwenden (auch wenn dies verfügbar ist). Die Disk-Images der kopierten VM sind garantiert ‘vollständige Images’ - d.h. nicht Teil einer CoW-Kette.
snapshot-destroy
snapshot-destroy [uuid = uuid] [snapshot-uuid = snapshot_uuid]
Löscht einen Schnappschuss. Dadurch bleibt der Speicher, der dem Snapshot zugeordnet ist, intakt. Verwenden Sie zum Löschen des Speichers die Snapshot-Deinstallation.
snapshot-disk-list
snapshot-disk-list [uuid = uuid] [snapshot-uuid = snapshot_uuid] [vbd-params = vbd_params] [vdi-params = vdi_params]
Listen Sie die Festplatten auf den ausgewählten VM auf.
snapshot-export-to-template
snapshot-export-to-template Dateiname = Dateiname snapshot-uuid = snapshot_uuid [preserve-power-state = true | false]
Exportieren eines Snapshots in den Dateinamen.
snapshot-reset-powerstate
snapshot-reset-powerstate [uuid = uuid] [snapshot-uuid = snapshot_uuid] [— force]
Erzwingen Sie, dass der VM Powerstate 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 Speicherbild nicht mehr benötigen (dh Sie können Ihren Schnappschuss nicht mehr fortsetzen).
snapshot-revert
snapshot-revert [uuid = uuid] [snapshot-uuid = snapshot_uuid]
Setzen Sie eine vorhandene VM in einen vorherigen Checkpointed oder Snapshoted-Status zurück.
snapshot-uninstall
snapshot-uninstall [uuid = uuid] [snapshot-uuid = snapshot_uuid] [— force]
Deinstallieren Sie einen Snapshot. Dieser Vorgang zerstört die VDIs, die als RW markiert und nur mit diesem Snapshot verbunden sind. Um den VM-Eintrag einfach zu zerstören, verwenden Sie snapshot-destroy.
SR-Befehle
Befehle zur Steuerung von SRs (Speicher-Repositories).
Die SR-Objekte können mit dem Standardobjektauflistungsbefehl (xe sr-list
) aufgelistet und die Parameter werden mit den Standardparameterbefehlen bearbeitet. Weitere Informationen finden Sie unter Low-Level-Parameterbefehle
SR-Parameter
SRs haben die folgenden Parameter:
Parametername | Beschreibung | Typ |
---|---|---|
uuid |
Die eindeutige Bezeichnung/Objektreferenz für die SR | Nur lesen |
name-label |
Der Name des SR | Lesen/Schreiben |
name-description |
Die Beschreibungszeichenfolge der SR | Lesen/Schreiben |
allowed-operations |
Liste der Operationen, die auf der SR in diesem Zustand erlaubt sind | Schreibgeschützte Parameter festlegen |
current-operations |
Liste der Vorgänge, die derzeit auf dieser SR ausgeführt werden | Schreibgeschützte Parameter festlegen |
VDIs |
Eindeutige Bezeichnung/Objektreferenz für die virtuellen Laufwerke in diesem SR | Schreibgeschützte Parameter festlegen |
PBDs |
Eindeutige Bezeichnung/Objektreferenz für die PBDs, die dieser SR zugeordnet sind | Schreibgeschützte Parameter festlegen |
physical-utilisation |
Physischer Speicherplatz, der derzeit auf diesem SR in Bytes verwendet wird. Bei Thin Provisioned Disk Formate kann die physische Auslastung geringer sein als die virtuelle Zuweisung | Nur lesen |
physical-size |
Gesamte physische Größe des SR, in Bytes | Nur lesen |
type |
Typ des SR, der verwendet wird, um den zu verwendenden SR-Back-End-Treiber anzugeben | Nur lesen |
introduced-by |
Die drtask (falls vorhanden), die die SR | Nur lesen |
content-type |
Der Typ des SR-Inhalts. Wird verwendet, um ISO-Bibliotheken von anderen SRs zu unterscheiden. Für Speicher-Repositories, die eine Bibliothek von ISOs speichern, muss der Inhaltstyp auf iso festgelegt werden. In anderen Fällen wird empfohlen, dass Sie diesen Parameter entweder auf leer oder den Zeichenfolgenbenutzer setzen. | Nur lesen |
shared |
True, wenn diese SR zwischen mehreren Hosts geteilt werden kann; andernfalls False | Lesen/Schreiben |
other-config |
Liste der Schlüssel/Wert -Paare, die zusätzliche Konfigurationsparameter für die SR angeben | Zuordnungsparameter Lese-/Schreibzugriff |
host |
Der Hostname des Speicher-Repositorys | Nur lesen |
virtual-allocation |
Summe der Werte der virtuellen Größe aller VDIs in diesem Speicher-Repository (in Byte) | Nur lesen |
sm-config |
SM-abhängige Daten | Schreibgeschützte Zuordnungsparameter |
blobs |
Binärer Datenspeicher | Nur lesen |
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 der Festplatte, führt sie in die Datenbank ein und erstellt eine PBD, die den SR an den Host anfügt. Wenn auf festgelegtshared
isttrue
, wird für jeden Host im Pool eine PBD erstellt. Wenn nicht angegeben oder auf festgelegtshared
istfalse
, wird nur für den mit angegebenen Host eine PBD erstellthost-uuid
.
Die genauendevice-config
Parameter unterscheiden sich je nach Gerättype
. Weitere Informationen 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 eine SR, und vergessen Sie alle aufgezeichneten Daten.
sr-data-source-list
sr-data-source-list „
Listen Sie 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 eine SR auf.
sr-destroy
sr-destroy uuid = sr_uuid
Zerstört die angegebene SR auf dem Host.
sr-enable-database-replication
sr-enable-database-replikation uuuid = sr_uuid
Aktiviert die XAPI-Datenbankreplikation auf die angegebene (gemeinsam genutzte) SR. Zum Beispiel:
xe sr-enable-database-replikation uuuid = sr-uuid
sr-disable-database-replication
sr-disable-database-replikation uuuid = sr_uuid
Deaktiviert die XAPI-Datenbankreplikation auf die angegebene SR. Zum Beispiel:
xe sr-enable-database-replikation uuuid = sr-uuid
sr-forget
sr-forget uuid = sr_uuid
Der XAPI-Agent vergisst eine angegebene SR auf dem Host. Wenn der XAPI-Agent einen SR vergisst, wird der SR getrennt und Sie können nicht auf VDIs 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-Eintrag in die Datenbank. Verwenden Sie diese Option,device-config
um zusätzliche Parameter in der Form anzugebendevice-config:parameter_key=parameter_value
, zum Beispiel:
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 nach der Erstellung als freigegeben neu konfiguriert werden muss oder um bei der Wiederherstellung aus verschiedenen Fehlerszenarien zu helfen.
sr-probe
sr-probe type = type [host-uuid = host_uuid] [device-config: config_name = value]
Führt einen backend-spezifischen Scan mit den bereitgestelltendevice-config
Schlüsseln durch. Wenn die für das SR-Back-End abgeschlossendevice-config
ist, gibt dieser Befehl eine Liste der SRs zurück, die auf dem Gerät vorhanden sind, falls vorhanden. Wenn diedevice-config
Parameter nur partiell sind, wird ein Backend-spezifischer Scan durchgeführt, der Ergebnisse zurückgibt, die Sie bei der Verbesserung der verbleibendendevice-config
Parameter leiten. Die Scanergebnisse werden als backend-spezifisches XML zurückgegeben, das auf der CLI gedruckt wird.
Die genauendevice-config
Parameter unterscheiden sich je nach Gerättype
. Weitere Informationen 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 eine Speichersonde 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 für jeden SR-Typ im gleichen für Menschen lesbaren Format zurück.
sr-scan
sr-scan uuid = sr_uuid
Erzwingen Sie einen SR-Scan, indem Sie die XAPI-Datenbank mit VDIs synchronisieren, die im zugrunde liegenden Speichersubstrat vorhanden sind.
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.
Betreffbefehle
Befehle zum Arbeiten mit Themen.
session-subject-identifier-list
Sitzungssubjekt-Bezeichner-Liste
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
Sitzungssubjekt-Bezeichner-Abmelde-alle
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, einen 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 = Wert
Schaffen Sie ein Geheimnis.
secret-destroy
secret-destroy uuid = uuid
Zerstöre ein Geheimnis.
Task-Befehle
Befehle zum Arbeiten mit asynchronen Tasks mit langer Laufzeit. 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 Aufgabenobjekte können mit dem Standardobjektauflistungsbefehl (xe task-list
) aufgelistet und die Parameter werden mit den Standardparameterbefehlen bearbeitet. Weitere Informationen finden Sie unter Low-Level-Parameterbefehle
Task-Parameter
Aufgaben haben die folgenden Parameter:
Parametername | Beschreibung | Typ |
---|---|---|
uuid |
Die eindeutige Bezeichnung/Objektreferenz für den Task | Nur lesen |
name-label |
Der Name der Aufgabe | Nur lesen |
name-description |
Die Beschreibungszeichenfolge der Aufgabe | Nur lesen |
resident-on |
Die eindeutige Bezeichnung/Objektreferenz des Hosts, auf dem die Aufgabe ausgeführt wird | Nur lesen |
status |
Status der Aufgabe | Nur lesen |
progress |
Wenn der Vorgang noch aussteht, enthält dieses Feld den geschätzten Prozentsatz abgeschlossen (von 0 bis 1). Wenn die Aufgabe erfolgreich oder erfolglos abgeschlossen wurde, ist der Wert 1. | Nur lesen |
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 im Ergebnisfeld ist. Andernfalls ist der Wert dieses Parameters nicht definiert | Nur lesen |
result |
Wenn die Aufgabe erfolgreich abgeschlossen wurde, enthält dieses Feld den Ergebniswert, entweder ungültig oder eine Objektreferenz. Andernfalls ist der Wert dieses Parameters nicht definiert | Nur lesen |
error_info |
Wenn der Task fehlgeschlagen ist, enthält dieser Parameter den Satz der zugehörigen Fehlerzeichenfolgen. Andernfalls ist der Wert dieses Parameters nicht definiert | Nur lesen |
allowed_operations |
Liste der in diesem Zustand zulässigen Vorgänge | Nur lesen |
created |
Zeitpunkt der Erstellung des Tasks | Nur lesen |
finished |
Zeitaufgabe beendet (d. h. erfolgreich oder fehlgeschlagen). Wenn der Vorgangsstatus ausstehend ist, hat der Wert dieses Feldes keine Bedeutung | Nur lesen |
subtask_of |
Enthält die UUID der Aufgaben, die diese Aufgabe eine Teilaufgabe von | Nur lesen |
subtasks |
Enthält die UUIDs aller Teilaufgaben dieser Aufgabe | Nur lesen |
task-cancel
task-cancel [uuid = task_uuid]
Leiten Sie die angegebene Aufgabe zu stornieren und zurückzugeben.
Vorlagenbefehle
Befehle zum Arbeiten mit VM-Vorlagen.
Vorlagen sind im Wesentlichen VMs, derenis-a-template
Parameter auf festgelegt sindtrue
. Eine Vorlage ist ein „Gold-Image“, das alle verschiedenen Konfigurationseinstellungen enthält, um eine bestimmte VM zu instanziieren. wird mit einem Basissatz von Vorlagen geliefert, bei denen es sich um generische „rohe“ VMs handelt, die eine Installations-CD des Betriebssystemherstellers 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 als Vorlagen für die zukünftige Verwendung in der VM-Bereitstellung speichern.
Die Vorlagenobjekte können mit dem Standardobjektauflistungsbefehl (xe template-list
) aufgelistet und die Parameter werden mit den Standardparameterbefehlen bearbeitet. Weitere Informationen finden Sie unter Low-Level-Parameterbefehle
Hinweis:
Vorlagen können nicht direkt in VMs konvertiert werden, indem der
is-a-template
Parameter auf festgelegt wirdfalse
. Das Festlegen desis-a-template
Parameters auffalse
wird nicht unterstützt und führt zu einer VM, die nicht gestartet werden kann.
VM-Vorlagenparameter
Vorlagen haben die folgenden Parameter:
-
uuid
( schreibgeschützt) die eindeutige Bezeichnung/Objektreferenz für die Vorlage -
name-label
( Lesen/Schreiben) der Name der Vorlage -
name-description
( Lese-/Schreibzugriff) die Beschreibungszeichenfolge der Vorlage -
user-version
( Lese-/Schreibzugriff) -Zeichenfolge für Ersteller von VMs und Vorlagen, um Versionsinformationen zu setzen -
is-a-template
( Lese-/Schreibzugriff) true, wenn diese VM eine Vorlage ist. Template-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. Vorlagenvirtuosen können mit diesem Parameter nicht in VMs konvertiert werden. -
is-control-domain
( schreibgeschützt) true, wenn dies eine Steuerdomäne ist (Domäne 0 oder Treiberdomäne) -
power-state
( schreibgeschützt) aktueller Leistungszustand. Der Wert wird für eine Vorlage immer angehalten -
memory-dynamic-max
( schreibgeschützt) dynamischer maximaler Speicher in Bytes.Derzeit nicht verwendet, aber wenn geändert wird, muss die folgende Einschränkung befolgt werden:memory_static_max>=memory_dynamic_max>=
````memory_dynamic_min>=memory_static_min
` .` -
memory-dynamic-min
( Lese-/Schreibzugriff) dynamischer minimaler Speicher in Bytes. Derzeit nicht verwendet, aber wenn geändert,memory-dynamic-max
müssen die gleichen Einschränkungen für befolgt werden. -
memory-static-max
( Lesen/Schreiben) 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
( Lesen/Schreiben) statisch (absoluter) minimaler Speicher in Bytes gesetzt. Dieses Feld stellt den absoluten Mindestspeicher dar undmemory-static-min
muss kleiner als seinmemory-static-max
. Dieser Wert wird im normalen Betrieb nicht verwendet, aber die vorherige Einschränkung muss befolgt werden. -
suspend-VDI-uuid
( schreibgeschützt) der VDI, auf dem ein Suspend-Image gespeichert ist (hat keine Bedeutung für eine Vorlage) -
VCPUs-params
( Zuordnungsparameter mit Lese-/Schreibzugriff) für die ausgewählte vCPU-Richtlinie.Sie können das Anheften einer vCPU optimieren mit:
xe template-param-set uuuid = < template_uuid > vcpus-params: mask = 1,2,3
Eine aus dieser Vorlage erstellte VM wird nur auf physischen CPUs 1, 2 und 3.
Sie können auch die vCPU-Priorität (Xen-Scheduling) mit den Parametern cap und weight einstellen. Zum Beispiel:
xe template-param-set uuuid = < template_uuid > vcpus-params: weight = 512 xe template-param-set uuuid = < template_uuid > vcpus-params: cap = 100
Eine auf dieser Vorlage basierende VM mit einem Gewicht von 512 erhält doppelt so viel CPU wie eine Domäne mit einer Gewichtung von 256 auf einem kontendierten Host. Legale Gewichtungen reichen von 1 bis 65535 und der Standardwert ist 256.
Die Obergrenze behebt optional die maximale Menge an CPU, die eine VM auf der Grundlage dieser Vorlage verwenden kann, selbst wenn der Host über Leerlauf-CPU-Zyklen verfügt. Die Kappe wird in Prozent einer physischen CPU ausgedrückt: 100 ist 1 physische CPU, 50 ist eine halbe CPU, 400 sind 4 CPUs usw. Der Standardwert 0 bedeutet, dass keine obere Kappe vorhanden ist.
-
VCPUs-max
( Lese-/Schreibzugriff) maximale Anzahl von vCPUs -
VCPUs-at-startup
( Lese-/Schreibzugriff) Startnummer der vCPUs - Aktion
actions-after-crash
(Lese-/Schreibzugriff), die ausgeführt werden soll, wenn eine VM, die auf dieser Vorlage basiert, abstürzt -
console-uuids
( schreibgeschützter Parameter) virtuelle Konsolengeräte -
Plattformspezifische Konfiguration
platform
(Lese-/Schreibzugriff)So 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 = keine
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-Controllers und eines USB-Tablet-Geräts für HVM-Gäste:
xe vm-param-set uuid = < vm_uuid > platform: usb = false xe vm-param-set uuid = < vm_uuid > platform: usb_tablet = false
So verwenden Sie qemu-upstream für USB-Passthrough:
xe vm-param-set uuid = < vm_uuid > platform: device-model = qemu-upstream-compat
-
allowed-operations
( schreibgeschützter Parameter) Liste der in diesem Zustand zulässigen Operationen -
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 VBD-Bezeichner, die verwendet werden können, dargestellt durch ganze Zahlen des Bereichs 0 — 15. Diese Liste ist nur informativ, und andere Geräte können verwendet werden (aber möglicherweise nicht funktionieren). -
allowed-VIF-devices
( schreibgeschützter Parameter) Liste der zur Verwendung verfügbaren VIF-Bezeichner, dargestellt durch ganze Zahlen des Bereichs 0 — 15. Diese Liste ist nur informativ, und andere Geräte können verwendet werden (aber möglicherweise nicht funktionieren). -
HVM-boot-policy
( Lese-/Schreibzugriff) die Startrichtlinie für HVM-Gäste. Entweder die BIOS-Reihenfolge oder eine leere Zeichenfolge. -
HVM-boot-params
( Zuordnungsparameter mit Lese-/Schreibzugriff) steuert der Orderschlüssel die HVM-Gaststartreihenfolge, die als Zeichenfolge dargestellt wird, wobei jedes Zeichen eine Startmethode ist: d für die CD/DVD, c für die Stammdiskette und n für Netzwerk-PXE-Start. Der Standardwert ist dc. -
PV-kernel
( Lese-/Schreibzugriff) Pfad zum Kernel -
PV-ramdisk
( Lese-/Schreibzugriff) Pfad zum initrd -
PV-args
( Lese-/Schreibzugriff) String der Kernel-Befehlszeilenargumente -
PV-legacy-args
( Lese-/Schreibzugriff) Zeichenfolge von Argumenten, um Legacy-VMs basierend auf diesem Vorlagen-Boot zu machen -
PV-bootloader
( Lese-/Schreibzugriff) Name oder Pfad zum Bootloader -
PV-bootloader-args
( Lese-/Schreibzugriff) String verschiedener Argumente für den Bootloader -
last-boot-CPU-flags
( schreibgeschützt) beschreibt die CPU-Flags, auf denen eine VM, die auf dieser Vorlage basiert, zuletzt gestartet wurde; nicht für eine Vorlage aufgefüllt -
resident-on
( schreibgeschützt) der Host, auf dem sich eine VM, die auf dieser Vorlage basiert, befindet. Erscheint wienot in database
für eine Vorlage -
affinity
( Lese-/Schreibzugriff) der Host, auf dem eine VM basierend auf dieser Vorlage die Vorliebe für die Ausführung hat. Wird vomxe vm-start
Befehl verwendet, um zu entscheiden, wo die VM ausgeführt werden soll -
other-config
( Lese-/Schreibzuordnungsparameter) 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, an dem die Metriken für eine VM basierend auf dieser Vorlage gelesen wurden, in der FormyyyymmddThh:mm:ss z
, wobei z der einbuchstabige militärische Zeitzonenindikator ist, z. B. Z für UTC (GMT). Auf1 Jan 1970 Z
(Anfang der UNIX/POSIX -Epoche) für eine Vorlage setzen -
install-time
( schreibgeschützt) Zeitstempel des Datums und der Uhrzeit, an dem die Metriken für eine VM basierend auf dieser Vorlage gelesen wurden, in der FormyyyymmddThh:mm:ss z
, wobei z der einbuchstabige militärische Zeitzonenindikator ist, z. B. Z für UTC (GMT). Auf1 Jan 1970 Z
(Anfang der UNIX/POSIX -Epoche) für eine Vorlage setzen -
memory-actual
( schreibgeschützt) der tatsächliche Speicher, der von einer VM auf der Grundlage 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
( Read Only Map Parameter) Liste der virtuellen CPUs und deren Gewicht Lese-Only-Map-Parameter os-Version die Version des Betriebssystems für eine VM basierend auf dieser Vorlage. Erscheint wienot in database
für eine Vorlage -
PV-drivers-version
( schreibgeschützter Kartenparameter) die Versionen der paravirtualisierten Treiber für eine VM basierend auf dieser Vorlage. Erscheint wienot in database
für eine Vorlage -
PV-drivers-detected
( schreibgeschützt) Flag für die neueste Version der paravirtualisierten Treiber für eine VM basierend auf dieser Vorlage. Erscheint wienot in database
für eine Vorlage -
memory
( schreibgeschützter Kartenparameter), die vom Agenten auf einer VM basierend auf dieser Vorlage gemeldet werden. Erscheint wienot in database
für eine Vorlage -
disks
( schreibgeschützter Zuordnungsparameter) Datenträgermetriken, die vom Agenten auf einer VM basierend auf dieser Vorlage gemeldet werden. Erscheint wienot in database
für eine Vorlage -
networks
( schreibgeschützter Kartenparameter) Netzwerkmetriken, die vom Agenten auf einer VM basierend auf dieser Vorlage gemeldet werden. Erscheint wienot in database
für eine Vorlage -
other
( schreibgeschützter Kartenparameter) andere Metriken, die der Agent auf einer VM basierend auf dieser Vorlage gemeldet hat. Erscheint wienot in database
für eine Vorlage -
guest-metrics-last-updated
( schreibgeschützt) Zeitstempel, wenn der Gast-Agent den letzten Schreibvorgang in diese Felder ausgeführt hat. In der FormyyyymmddThh:mm:ss z
, wobei z der einbuchstabige militärische Zeitzonenindikator ist, z. B. Z für UTC (GMT) -
actions-after-shutdown
( Lese-/Schreibzugriff) -Aktion, die nach dem Herunterfahren der VM ausgeführt werden soll -
actions-after-reboot
( Lese-/Schreibzugriff) -Aktion, die nach dem Neustart der VM ausgeführt werden soll -
possible-hosts
( schreibgeschützt) Liste der Hosts, die die VM möglicherweise hosten könnten -
HVM-shadow-multiplier
( Lese-/Schreibzugriff) Multiplikator, der auf die Schattenmenge angewendet wird, die dem Gast zur Verfügung gestellt wird -
dom-id
( schreibgeschützt) Domain-ID (falls verfügbar, andernfalls -1) -
recommendations
( schreibgeschützt) XML-Spezifikation der empfohlenen Werte und Bereiche für Eigenschaften dieser VM -
xenstore-data
( Lese-/Schreibzuordnungsparameter), die nach der Erstellung der VM in den Xenstore-Baum (/ local/domain/domid /vmdata) eingefügt werden sollen. -
is-a-snapshot
( schreibgeschützt) True, wenn es sich bei dieser Vorlage um einen virtuellen Snapshot handelt -
snapshot_of
( schreibgeschützt) die UUID der VM, 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 letzten virtuellen Snapshots -
memory-target
( schreibgeschützt) die Zielmenge des Arbeitsspeichers für diese Vorlage -
blocked-operations
( Kartenparameter Lese-/Schreibzugriff) listet die Vorgänge 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 auftritt, auf dem sie sich befindet. Dieser Parameter ist jetzt veraltet. Verwenden Sie stattdessen denha-restartpriority
Parameter. -
ha-restart-priority
( schreibgeschützt) Neustart oder Best-Effort-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. Dieser Vorgang zerstört die VDIs, die von dieser Vorlage als „Eigentum“ gekennzeichnet sind.
Update-Befehle
Der folgende Abschnitt enthält Host-Update-Befehle.
Die Aktualisierungsobjekte können mit dem Standardobjektauflistungsbefehl (xe update-list
) aufgelistet und die Parameter werden mit den Standardparameterbefehlen bearbeitet. Weitere Informationen finden Sie unter Low-Level-Parameterbefehle
Aktualisierungsparameter
Host-Updates haben die folgenden Parameter:
Parametername | Beschreibung | Typ |
---|---|---|
uuid |
Die eindeutige Bezeichnung/Objektreferenz für die Aktualisierung | Nur lesen |
host |
Die Liste der Hosts, auf die dieses Update angewendet wird | Nur lesen |
host-uuid |
Der eindeutige Bezeichner für den abzufragenden Host | Nur lesen |
name-label |
Der Name des Updates | Nur lesen |
name-description |
Die Beschreibungszeichenfolge des Updates | Nur lesen |
applied |
Gibt an, ob das Update angewendet wurde; true oder false | Nur lesen |
installation-size |
Die Größe des Updates in Bytes | Nur lesen |
after-apply-guidance |
Ob der XAPI-Toolstack oder der Host einen Neustart erfordert | Nur lesen |
version |
Die Version des Updates | Nur lesen |
update-upload
update-upload file-name = update_filename
Laden Sie eine angegebene Update-Datei auf den Host hoch. Dieser Befehl bereitet ein Update vor, das angewendet werden soll. Bei Erfolg wird die UUID des hochgeladenen Updates gedruckt. Wenn das Update zuvor hochgeladen wurde, wird stattdessen einUPDATE_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 Vorprüfungen auf dem angegebenen Host aus.
update-destroy
update-destroy uuid = update_file_uuid
Löscht eine Aktualisierungsdatei, 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 Hosts im Pool an.
update-introduce
update-einführen vdi-uuid = vdi_uuid
Update VDI einführen.
update-pool-clean
update-pool-clean uuid = uuid
Entfernt die Dateien des Updates von allen Hosts im Pool.
Benutzerbefehle
user-password-change
user-passwort-change old = old_password new = new_password
Ändert das Kennwort des angemeldeten Benutzers. Das alte Kennwortfeld wird nicht überprüft, da Sie Supervisorrechte benötigen, um diesen Befehl verwenden zu können.
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 die VDI an die VM binden (ist sie bootfähig, ihre Lese-/Schreibmetriken usw.). Der VDI enthält die 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 Standardobjektlistenbefehl (xe vbd-list
) aufgelistet und die Parameter werden mit den Standardparameterbefehlen bearbeitet. Weitere Informationen finden Sie unter Low-Level-Parameterbefehle
VBD-Parameter
VBDs haben die folgenden Parameter:
Parametername | Beschreibung | Typ |
---|---|---|
uuid |
Die eindeutige Bezeichnung/Objektreferenz für die VBD | Nur lesen |
vm-uuid |
Die eindeutige Bezeichnung/Objektreferenz für die VM, an die diese VBD angehängt ist | Nur lesen |
vm-name-label |
Der Name der VM, der diese VBD angehängt ist | Nur lesen |
vdi-uuid |
Die eindeutige Bezeichnung/Objektreferenz für die VDI, die dieser VBD zugeordnet ist | Nur lesen |
vdi-name-label |
Der Name des VDI, der dieser VBD zugeordnet ist | Nur lesen |
empty |
Wenntrue diese VBD ein leeres Laufwerk darstellt |
Nur lesen |
device |
Das Gerät, das vom Gast gesehen wird, zum Beispielhda
|
Nur lesen |
userdevice |
Gerätenummervbd-create , die durch den Geräteparameter angegeben wird, z. B. 0 für hda, 1 für hdb usw |
Lesen/Schreiben |
bootable |
True, wenn diese VBD bootfähig ist | Lesen/Schreiben |
mode |
Der Modus der VBD sollte mit | Lesen/Schreiben |
type |
Wie die VBD auf der VM angezeigt wird, z. B. Festplatte oder CD | Lesen/Schreiben |
currently-attached |
True, wenn die VBD auf diesem Host angehängt ist, andernfalls false | Nur lesen |
storage-lock |
True, wenn eine Sperre auf Speicherebene erworben wurde | Nur lesen |
status-code |
Fehler/Erfolgscode, der mit der letzten Attach-Operation verknüpft ist | Nur lesen |
status-detail |
Fehler-/Erfolgsinformationen, die mit dem Status der letzten Attach-Operation verknüpft sind | Nur lesen |
qos_algorithm_type |
Der zu verwendende QoS-Algorithmus | Lesen/Schreiben |
qos_algorithm_params |
Parameter für den gewählten QoS-Algorithmus | Zuordnungsparameter 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 | Nur lesen |
io_write_kbs |
Durchschnittliche Schreibrate in kB pro Sekunde für diese VBD | Nur lesen |
allowed-operations |
Liste der in diesem Zustand zulässigen Vorgänge. Diese Liste ist nur empfehlend, 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 laufenden Aufgaben, die dieses Objekt verwenden (durch Verweis), mit einer aktuellen_operation-Enumeration, die die Art der Aufgabe beschreibt. | Schreibgeschützte Parameter festlegen |
unpluggable |
True, wenn diese VBD Hot Unplug unterstützt | Lesen/Schreiben |
attachable |
True, wenn das Gerät angeschlossen werden kann | Nur lesen |
other-config |
Zusätzliche Konfiguration | Zuordnungsparameter 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 = Festplatte | CD] [mode = RW | RO]
Erstellen Sie eine VBD auf einer VM.
Die zulässigen Werte für dasdevice
Feld sind ganze Zahlen 0 — 15, und die Zahl muss für jede VM eindeutig sein. Die aktuellen zulässigen Werte sind imallowed-VBD-devices
Parameter auf der angegebenen VM zu sehen. Dies wird wieuserdevice
in denvbd
Parametern gesehen.
Wenn dertype
istDisk
,vdi-uuid
ist erforderlich. Modus kannRO
oderRW
für einen Datenträger sein.
Wenn dertype
istCD
,vdi-uuid
ist optional. Wenn kein VDI angegeben ist, wird für die CD eine leere VBD angelegt. Der Modus mussRO
für eine CD verwendet werden.
vbd-destroy
vbd-destroy uuid = uuid_of_vbd
Zerstört die angegebene VBD.
Wenn der VBD seinenother-config:owner
Parameter auf gesetzt hattrue
, 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 das Medium einen Wechseldatentyp hat (eine physische CD oder eine ISO). AndernfallsVBD_NOT_REMOVABLE_MEDIA
wird eine Fehlermeldung zurückgegeben.
vbd-insert
vbd-insert uuid = uuid_of_vbd vdi-uuid = uuuid_of_vdi_containing_media
Legen Sie neue Medien in das Laufwerk ein, das durch eine VBD dargestellt wird. Dieser Befehl funktioniert nur, wenn das Medium einen Wechseldatentyp hat (eine physische CD oder eine ISO). AndernfallsVBD_NOT_REMOVABLE_MEDIA
wird eine Fehlermeldung 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, das von einer VM gesehen wird. Dies unterscheidet sich von der VBD, die ein Objekt ist, das eine VM mit dem VDI verbindet. Der VDI enthält die 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 weist die Attribute auf, die die VDI an die VM binden (ist sie bootfähig, ihre Lese-/Schreibmetriken usw.).
Die VDI-Objekte können mit dem Standardobjektlistenbefehl (xe vdi-list
) aufgelistet und die Parameter werden mit den Standardparameterbefehlen bearbeitet. Weitere Informationen finden Sie unter Low-Level-Parameterbefehle
VDI-Parameter
VDIs haben folgende Parameter:
Parametername | Beschreibung | Typ |
---|---|---|
uuid |
Die eindeutige Bezeichnung/Objektreferenz für den VDI | Nur lesen |
name-label |
Der Name des VDI | Lesen/Schreiben |
name-description |
Die Beschreibungszeichenfolge des VDI | Lesen/Schreiben |
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 | Nur lesen |
vbd-uuids |
Eine Liste der VBDs, die sich auf diesen VDI beziehen | Schreibgeschützte Parameter festlegen |
crashdump-uuids |
Liste der Absturzabbilder, die sich auf diesen VDI beziehen | Schreibgeschützte Parameter festlegen |
virtual-size |
Größe der Festplatte, wie sie der VM präsentiert wird, in Bytes. Je nach Speicher-Back-End-Typ wird die Größe möglicherweise nicht genau eingehalten | Nur lesen |
physical-utilisation |
Menge des physischen Speicherplatzes, den der VDI auf dem SR belegt, in Bytes | Nur lesen |
type |
Typ des VDI, z.B. System oder Benutzer | Nur lesen |
sharable |
True, wenn dieser VDI freigegeben werden kann | Nur lesen |
read-only |
True, wenn dieser VDI nur schreibgeschützt eingehängt werden kann | Nur lesen |
storage-lock |
True, wenn dieser VDI auf Speicherebene gesperrt ist | Nur lesen |
parent |
Verweist auf den übergeordneten VDI, wenn dieser VDI Teil einer Kette ist | Nur lesen |
missing |
True, wenn der SR-Scanvorgang diesen VDI als nicht vorhanden gemeldet hat | Nur lesen |
other-config |
Zusätzliche Konfigurationsinformationen für diesen VDI | Zuordnungsparameter Lese-/Schreibzugriff |
sr-name-label |
Name des enthaltenden Speicher-Repositorys | Nur lesen |
location |
Standortinformationen | Nur lesen |
managed |
True, wenn der VDI verwaltet wird | Nur lesen |
xenstore-data |
Daten, die in den xenstore-Baum (/ local/domain/0/backend/ vbd/domid/device-id**/smdata) eingefügt werden sollen, nachdem der VDI angehängt wurde. Die SM-Backends setzen dieses Feld normalerweise einvdi_attach . |
Schreibgeschützte Zuordnungsparameter |
sm-config |
SM-abhängige Daten | Schreibgeschützte Zuordnungsparameter |
is-a-snapshot |
True, wenn dieser VDI ein VM-Speicher-Snapshot ist | Nur lesen |
snapshot_of |
Die UUID des Speichers dieser VDI ist ein Snapshot von | Nur lesen |
snapshots |
Die UUIDs aller Snapshots dieses VDI | Nur lesen |
snapshot_time |
Der Zeitstempel des Snapshot-Vorgangs, der diese VDI erstellt hat | Nur lesen |
metadata-of-pool |
Die UUID des Pools, der diese Metadaten VDI erstellt hat | Nur lesen |
metadata-latest |
Flag, das angibt, ob der VDI die neuesten bekannten Metadaten für diesen Pool enthält | Nur lesen |
cbt-enabled |
Flag, das angibt, ob geänderte Blockverfolgung für den VDI aktiviert ist | Lesen/Schreiben |
vdi-clone
vdi-clone uuid = uuid_of_the_vdi [Treiber-Parameter: Schlüssel = Wert]
Erstellen Sie eine neue, beschreibbare Kopie des angegebenen VDI, die direkt verwendet werden kann. Es ist eine Variantevdi-copy
, die High-Speed-Image-Clone-Einrichtungen verfügbar machen kann, wo sie existieren.
Verwenden Sie den optionalen Zudriver-params
ordnungsparameter, um zusätzliche anbieterspezifische Konfigurationsinformationen an den Back-End-Speichertreiber zu übergeben, auf dem der VDI basiert. Weitere Informationen finden Sie in der Treiberdokumentation des Speicheranbieters.
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_auf 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.
Dervirtual-size
Parameter kann in Bytes oder mit den IEC-Standardsuffixe KiB, MiB, GiB und TiB angegeben werden.
Hinweis:
SR-Typen, die die Thin Provisioning von Datenträgern (z. B. lokale VHD und NFS) unterstützen, erzwingen keine virtuelle Zuweisung von Festplatten. Achten Sie bei der übermäßigen Zuweisung virtueller Festplattenspeicher auf einer SR auf große Vorsicht. Wenn eine überlastete SR voll wird, muss der Speicherplatz entweder auf dem SR-Zielsubstrat oder durch Löschen ungenutzter VDIs im SR zur Verfügung gestellt werden.
Hinweis:
Einige SR-Typen runden den
virtual-size
Wert möglicherweise auf, 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 geänderten Blockverfolgungsmetadaten bei.
Hinweis:
Wenn Sie die geänderte Blockverfolgung verwenden, um inkrementelle Sicherungen des VDI zu erstellen, stellen Sie sicher, dass Sie den
vdi-data-destroy
Befehl verwenden, um Snapshots zu löschen, aber die Metadaten beizubehalten. Verwenden Sie nicht fürvdi-destroy
Snapshots von VDIs, die die Blockverfolgung aktiviert haben.
vdi-destroy
vdi-destroy uuid = uuid_of_vdi
Zerstört den angegebenen VDI.
Hinweis:
Wenn Sie die geänderte Blockverfolgung verwenden, um inkrementelle Sicherungen des VDI zu erstellen, stellen Sie sicher, dass Sie den
vdi-data-destroy
Befehl verwenden, um Snapshots zu löschen, aber die Metadaten beizubehalten. Verwenden Sie nicht fürvdi-destroy
Snapshots von VDIs, die die Blockverfolgung aktiviert haben.Hinweis:
Bei lokalen VHD- und NFS-SR-Typen wird Speicherplatz nicht sofort auf freigegeben
vdi-destroy
, sondern in regelmäßigen Abständen während eines Speicher-Repository-Scanvorgangs. Wenn Sie die Bereitstellung gelöschter Festplattenspeicher erzwingen müssen, rufen Sie [sr-scan
] (#sr -scan) manuell auf.
vdi-disable-cbt
vdi-disable-cbt uuid = uuid_of_vdi
Deaktivieren Sie die geänderte Blockverfolgung für den VDI.
vdi-enable-cbt
vdi-enable-cbt uuid = uuid_of_vdi
Aktivieren Sie die geänderte Blockverfolgung für den VDI.
Hinweis:
Sie können das geänderte Block-Tracking nur für lizenzierte Instanzen von 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 dünnsein. Wenn sich innerhalb des VDI nicht zugewiesene Blöcke befinden, werden diese Blöcke möglicherweise aus der VHD-Datei weggelassen, wodurch die VHD-Datei verkleinert wird. Sie können aus allen unterstützten VHD-basierten Speichertypen (EXT, NFS) in das VHD-Format exportieren.
Wenn Sie denbase
Parameter 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-Eintrag 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 = uuuid_of_sr name-label = name_of_new_vdi type = system | user | suspend | crashdump location = device_location_( variiert_by_storage_type) [name-description = description_of_vdi] [sharable = ja | nein] [read-only = yes | nein] 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 tatsächlich einen Speicher zu ändern oder zu erstellen. Dieser Befehl wird hauptsächlich intern verwendet, um Hot-Plug-Speichergeräte automatisch einzuführen.
vdi-list-changed-blocks
vdi-list-changed-blocks vdi-from-uuid = erste vdi-uuid vdi-to-uuid = zweites vdi-uuid
Vergleichen Sie zwei VDIs und geben Sie die Liste der Blöcke zurück, die zwischen den beiden Blöcken geändert wurden, als Base64-codierte Zeichenfolge. Dieser Befehl funktioniert nur für VDIs, die die Blockverfolgung aktiviert haben.
Weitere Informationen finden Sie unter Ge änderte Blockverfolgung.
vdi-pool-migrate
vdi-pool-migrate uuid = VDI_uuid sr-uuid = Ziel-sr-uuid
Migrieren Sie eine VDI zu einem angegebenen SR, während der VDI an einen laufenden Gast angeschlossen ist. (Lagerung )
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 durch UUID angegebenen VDI.
vdi-snapshot
vdi-snapshot uuid = uuid_of_the_vdi [Treiberparams = Parameter]
Erzeugt eine Lese-/Schreibversion eines VDI, die als Referenz für Sicherungs- oder Vorlagenerstellungszwecke oder beides verwendet werden kann. Verwenden Sie den Snapshot, um eine Sicherung durchzuführen, anstatt Backup-Software innerhalb der VM zu installieren und auszuführen. Die VM wird weiterhin ausgeführt, während externe Sicherungssoftware den Inhalt des Snapshots auf das Sicherungsmedium streamt. Ebenso kann ein Schnappschuss als „Goldbild“ verwendet werden, auf dem eine Vorlage basiert. Eine Vorlage kann mit beliebigen VDIs erstellt werden.
Verwenden Sie den optionalen Zudriver-params
ordnungsparameter, um zusätzliche anbieterspezifische Konfigurationsinformationen an den Back-End-Speichertreiber zu übergeben, auf dem der VDI basiert. Weitere Informationen finden Sie in der Treiberdokumentation des Speicheranbieters.
Ein Klon eines Snapshots 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 übergebenforce=true
wird, erzwingt er die Entsperroperation.
vdi-update
vdi-update uuid = uuid
Aktualisieren Sie die Felder des VDI-Objekts in der Datenbank.
VIF-Befehle
Befehle zum Arbeiten mit VIFs (Virtual Network Interfaces).
Die VIF-Objekte können mit dem Standardobjektlistenbefehl (xe vif-list
) aufgelistet und die Parameter werden mit den Standardparameterbefehlen bearbeitet. Weitere Informationen finden Sie unter Low-Level-Parameterbefehle
VIF-Parameter
VIFs haben die folgenden Parameter:
-
uuid
( schreibgeschützt) die eindeutige Bezeichnung/Objektreferenz für die VIF -
vm-uuid
( schreibgeschützt) die eindeutige Bezeichnung/Objektreferenz für die VM, auf der sich diese VIF befindet -
vm-name-label
( schreibgeschützt) der Name 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ützt) MAC-Adresse von VIF, wie sie der VM angezeigt wird -
MTU
( schreibgeschützt) Maximale Übertragungseinheit des VIF in Bytes.Dieser Parameter ist schreibgeschützt, Sie können jedoch die MTU-Einstellung mit dem
mtu
Schlüssel überschreiben, indem Sie den Parameterother-config
map verwenden. Um beispielsweise die MTU auf einer virtuellen Netzwerkkarte zurückzusetzen, um Jumbo-Frames zu verwenden:xe vif-param-Set \ < vif_uuid >UUID = \ other-config:mtu=9000
-
currently-attached
( schreibgeschützt) true, wenn das Gerät angeschlossen ist -
qos_algorithm_type
( Lesen/Schreiben) QoS-Algorithmus zu verwenden -
qos_algorithm_params
( Lese-/Schreibzuordnungsparameter) für den ausgewählten QoS-Algorithmus -
qos_supported_algorithms
( schreibgeschützter Parameter) unterstützte QoS-Algorithmen für diese VIF -
MAC-autogenerated
( schreibgeschützt) True, wenn die MAC-Adresse der VIF automatisch generiert wurde -
other-config
( Lese-/Schreibzuordnungsparameter) zusätzliche Konfigurationkey:value
spaare -
other-config:ethtoolrx
( Lese-/Schreibzugriff) auf on gesetzt, um die Empfangsprüfsumme zu aktivieren, aus, um zu deaktivieren -
other-config:ethtooltx
( Lese-/Schreibzugriff) auf ein gesetzt, um die Transmit-Prüfsumme zu aktivieren, aus, um zu deaktivieren -
other-config:ethtoolsg
( Lesen/Schreiben) auf on gesetzt, um Scatter sammeln zu aktivieren, aus, um zu deaktivieren -
other-config:ethtooltso
( Lese-/Schreibzugriff) auf on gesetzt, um die TCP-Segmentierung Offload zu aktivieren, aus, um zu deaktivieren -
other-config:ethtoolufo
( Lesen/Schreiben) auf on gesetzt, um udp Fragment Offload zu aktivieren, aus, um zu deaktivieren -
other-config:ethtoolgso
( Lese-/Schreibzugriff) auf on gesetzt, um die generische Segmentierung Offload zu aktivieren, aus, um zu deaktivieren -
other-config:promiscuous
( Lesen/Schreiben) true zu einer VIF, um auf der Brücke promiskuös zu sein, so dass sie den gesamten Verkehr über die Brücke sieht. Nützlich für die Ausführung eines Intrusion Detection Systems (IDS) oder ähnlichem in einer VM. -
network-uuid
( schreibgeschützt) die eindeutige Bezeichnung/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 diese VIF -
io_write_kbs
( schreibgeschützt) durchschnittliche Schreibrate in KB/s für diese VIF -
locking_mode
( Lesen/Schreiben) Beeinflusst die VIFS-Fähigkeit, Datenverkehr zu/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 eine Filterregel an, damit der VIF keinen Datenverkehr senden oder empfangen kann. Wenn der Standardsperrmodus auf festgelegt istunlocked
, werden alle Filterregeln entfernt, die der VIF zugeordnet sind. Weitere Informationen finden Sie unter Netzwerkbefehle. -
locking_mode:locked
( Lese-/Schreibzugriff) Nur Datenverkehr, der an die angegebenen MAC-Adressen und IP-Adressen gesendet wird, ist auf der VIF zulässig. Wenn keine IP-Adressen angegeben sind, ist kein Datenverkehr zulässig. -
locking_mode:unlocked
( Lese-/Schreibzugriff) Es werden keine Filter auf Datenverkehr angewendet, die zum oder von der VIF gehen. -
locking_mode:disabled
( Lese-/Schreibzugriff) wendet eine Filterregel an, so dass die VIF den gesamten Datenverkehr ablegt.
vif-create
vif-create vm-uuid = uuid_of_the_vm device = siehe unten network-uuid = uuid_of_network_to_connect_to [mac = mac_address]
Erstellen Sie eine VIF auf einer VM.
Die entsprechenden Werte für dasdevice
Feld werden im Parameterallowed-VIF-devices
auf der angegebenen VM aufgelistet. Bevor dort VIFs existieren, sind die zulässigen Werte ganze Zahlen von 0-15.
Dermac
Parameter ist die Standard-MAC-Adresse im Formularaa:bb:cc:dd:ee:ff
. Wenn Sie es nicht angegeben lassen, wird eine entsprechende zufällige MAC-Adresse erstellt. Sie können auch explizit eine zufällige MAC-Adresse festlegen, indem Sie angebenmac=random
.
vif-destroy
vif-destroy uuid = uuid_of_vif
Zerstöre eine 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 uuuid = uuid_of_vif mode = statische Adresse = CIDR_address gateway = gateway_address
Zum Beispiel:
VIF.configure_ipv4 (VifObject, „statisch“, „192.168.1.10/24“, "192.168.1.1")
Säubern Sie IPv4-Einstellungen wie folgt:
vif-configure-ipv4 uuuid = uuid_of_vif mode = keine
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 = statische Adresse = IP_address gateway = gateway_address
Zum Beispiel:
VIF.configure_ipv6 (vifObject, „statisch“, „fd 06:7768: b9e 5:8 b00:: 5001/64“, "fd 06:7768: b9e 5:8 b00:: 1")
Säubern Sie IPv6-Einstellungen wie folgt:
vif-configure-ipv6 uuid = uuid_of_vif mode = keine
VLAN-Befehle
Befehle zum Arbeiten mit VLANs (virtuelle Netzwerke). Informationen zum Auflisten und Bearbeiten virtueller Schnittstellen finden Sie in den PIF-Befehlen, die über einen VLAN-Parameter verfügen, der signalisiert, dass ihnen ein virtuelles Netzwerk zugeordnet ist. Weitere Informationen finden Sie unter PIF-Befehle. Wenn Sie beispielsweise VLANs auflisten möchten, verwenden Siexe pif-list
.
vlan-create
vlan-create pif-uuid = uuid_of_pif vlan = vlan_number network-uuid = uuid_of_network
Erstellen Sie ein VLAN auf Ihrem Host.
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 bestimmen, auf welcher Schnittstelle (z. B.eth0
) sich das angegebene Netzwerk befindet (auf jedem Host) und ein neues PIF-Objekt je Host erstellen und anschließen.
vlan-destroy
vlan-destroy uuid = uuid_of_pif_mapped_to_vlan
Zerstöre 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 anzugebenvm=name_or_uuid
. Eine einfache Möglichkeit, die Uuid einer tatsächlichen VM zu erhalten, besteht beispielsweise darin, auszuführenxe vm-list power-state=running
. ( Rufen Sie die vollständige Liste der Felder ab, die mit dem Befehl übereinstimmen könnenxe vm-list params=all
.) Wenn Sie z. B. angeben, werden VMspower-state=halted
ausgewählt, derenpower-state
Parameter halted.
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 Standardobjektauflistungsbefehl (xe vm-list
) aufgelistet und die Parameter werden mit den Standardparameterbefehlen bearbeitet. 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
( Lesen/Schreiben) die Appliance/VApp, zu der die VM gehört -
uuid
( schreibgeschützt) die eindeutige Bezeichnung/Objektreferenz für die VM -
name-label
( Lese-/Schreibzugriff) der Name der VM -
name-description
( Lese-/Schreibzugriff) die Beschreibungszeichenfolge der VM -
order start order
( Lese-/Schreibzugriff) für vApp-Start/Herunterfahren 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-/Schreibzugriff) -Zeichenfolge 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. Vorlagenvirtuosen können nie gestartet werden, sie werden nur zum Klonen anderer VMs verwendet. Nachdem dieser Wert auf true festgelegt wurde, kann er nicht auf false zurückgesetzt werden. Vorlagenvirtuosen 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 Leistungszustand -
start-delay
( Lesen/Schreiben) die Warteverzögerung, bevor ein Aufruf zum Starten der VM zurückgibt -
shutdown-delay
( Lese-/Schreibzugriff) die Warteverzögerung, bevor ein Aufruf zum Herunterfahren der VM zurückgibt -
memory-dynamic-max
( Lese-/Schreibzugriff) dynamisches Maximum in Bytes -
memory-dynamic-min
( Lese-/Schreibzugriff) dynamisches Minimum in Bytes -
memory-static-max
( Lesen/Schreiben) statisch (absolutes) Maximum in Bytes gesetzt. Wenn Sie diesen Wert ändern möchten, muss die VM heruntergefahren werden. -
memory-static-min
( Lesen/Schreiben) statisch (absolut) Minimum in Bytes gesetzt. Wenn Sie diesen Wert ändern möchten, muss die VM heruntergefahren werden. -
suspend-VDI-uuid
( schreibgeschützt) der VDI, auf dem ein Suspend-Image gespeichert ist -
VCPUs-params
( Zuordnungsparameter mit Lese-/Schreibzugriff) für die ausgewählte vCPU-Richtlinie.Sie können das Anheften einer vCPU mit
xe vm-param-set uuid = < vm_uuid > vcpus-Parameter: 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. Zum 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 einem Gewicht von 512 erhält doppelt so viel CPU wie eine Domäne mit einer Gewichtung von 256 auf einem kontendierten Host. Legale Gewichtungen reichen von 1 bis 65535 und der Standardwert ist 256. Die Cap fixiert optional die maximale Menge an CPU, die eine VM verbrauchen kann, selbst wenn der Host über Leerlaufzyklen verfügt. Die Kappe wird in Prozent einer physischen CPU ausgedrückt: 100 ist 1 physische CPU, 50 ist eine halbe CPU, 400 sind 4 CPUs usw. Der Standardwert 0 bedeutet, dass keine obere Kappe vorhanden ist.
-
VCPUs-max
( Lese-/Schreibzugriff) maximale Anzahl virtueller CPUs. - Boot-Nummer virtueller CPUs
VCPUs-at-startup
(Lese-/Schreibzugriff) -
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
( Notieren Sie ein Coredump und starten Sie VM neu) -
coredump_and_destroy
( Notieren Sie ein Coredump und lassen Sie VM angehalten) -
restart
( kein Coredump und VM neu starten) -
destroy
( kein Coredump und VM angehalten lassen)
-
-
console-uuids
( schreibgeschützter Parameter) virtuelle Konsolengeräte -
platform
( Lese-/Schreibzuordnungsparameter) plattformspezifische KonfigurationSo deaktivieren Sie Virtual Desktop Agent (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 = plattform param-key = acpi_laptop_slate
-
allowed-operations
( schreibgeschützter Parameter) Liste der in diesem Zustand zulässigen Operationen -
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 VBD-Bezeichner, die verwendet werden können, dargestellt durch ganze Zahlen des Bereichs 0 — 15. Diese Liste ist nur informativ, und andere Geräte können verwendet werden (aber möglicherweise nicht funktionieren). -
allowed-VIF-devices
( schreibgeschützter Parameter) Liste der zur Verwendung verfügbaren VIF-Bezeichner, dargestellt durch ganze Zahlen des Bereichs 0 — 15. Diese Liste ist nur informativ, und andere Geräte können verwendet werden (aber möglicherweise nicht funktionieren). -
HVM-boot-policy
( Lese-/Schreibzugriff) die Startrichtlinie für HVM-Gäste. Entweder die BIOS-Reihenfolge oder eine leere Zeichenfolge. -
HVM-boot-params
( Zuordnungsparameter mit Lese-/Schreibzugriff) steuert der Orderschlüssel die HVM-Gaststartreihenfolge, die als Zeichenfolge dargestellt wird, wobei jedes Zeichen eine Startmethode ist: d für die CD/DVD, c für die Stammdiskette und n für Netzwerk-PXE-Start. Der Standardwert ist dc. -
HVM-shadow-multiplier
( Lese-/Schreibzugriff) Gleitkommawert, der die Menge des Schattenspeichers steuert, um der VM zu erteilen. Der Standardwert 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) String der Kernel-Befehlszeilenargumente -
PV-legacy-args
( Lese-/Schreibzugriff) Zeichenfolge von Argumenten, um ältere VMs zu starten -
PV-bootloader
( Lese-/Schreibzugriff) Name oder Pfad zum Bootloader -
PV-bootloader-args
( Lese-/Schreibzugriff) String verschiedener Argumente für den Bootloader -
last-boot-CPU-flags
( schreibgeschützt) beschreibt die CPU-Flags, auf denen die VM zuletzt gestartet wurde -
resident-on
( schreibgeschützt) der Host, auf dem sich eine VM befindet -
affinity
( Lese-/Schreibzugriff) Der Host, auf dem die VM die Vorliebe für die Ausführung hat. Wird vomxe vm-start
Befehl verwendet, um zu entscheiden, wo die VM ausgeführt werden soll -
other-config
( Kartenparameter mit 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 Starten des Hosts gestartet, wenn derother-config
Parameter das Schlüssel/Wert -Paarauto_poweron: true
enthält -
start-time
( schreibgeschützt) Zeitstempel des Datums und der Uhrzeit, an dem die Metriken für die VM gelesen wurden. Dieser Zeitstempel hat die FormyyyymmddThh:mm:ss z
, wobei z der einzelbuchstabige militärische Zeitzonenindikator ist, z. B. Z für UTC (GMT) -
install-time
( schreibgeschützt) Zeitstempel des Datums und der Uhrzeit, an dem die Metriken für die VM gelesen wurden. Dieser Zeitstempel hat die FormyyyymmddThh:mm:ss z
, wobei z der einzelbuchstabige 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 PV (paravirtual) oder HVM (Hardware Virtual Machine) Linux-VM zugewiesen sind. Diese Zahl kann abweichenVCPUS-max
und kann geändert werden, ohne die VM mit demvm-vcpu-hotplug
Befehl neu zu starten. Weitere Informationen finden Sie unter [vm-vcpu-hotplug
] (#vm -vcpu-hotplug). Windows-VMs werden immer mit der Anzahl der vCPUs ausgeführtVCPUsmax
und müssen neu gestartet werden, um diesen Wert zu ändern. Die Leistung sinkt stark, wenn SieVCPUs-number
auf einen Wert festlegen, der größer als die Anzahl der physischen CPUs auf dem Host ist. -
VCPUs-Utilization
( schreibgeschützter Kartenparameter) eine Liste der virtuellen CPUs und deren Gewicht -
os-version
( schreibgeschützter Kartenparameter) die Version des Betriebssystems für die VM -
PV-drivers-version
( schreibgeschützter Kartenparameter) die Versionen der paravirtualisierten Treiber für die VM -
PV-drivers-detected
( schreibgeschützt) Flag für die neueste Version der paravirtualisierten Treiber für die VM -
memory
( schreibgeschützter Zuordnungsparameter) vom Agenten auf der VM gemeldete Speichermetriken -
disks
( schreibgeschützter Zuordnungsparameter) Festplattenmetriken, die vom Agenten auf der VM gemeldet werden -
networks
( schreibgeschützter Kartenparameter) Netzwerkmetriken, die vom Agenten auf der VM gemeldet werden -
other
( schreibgeschützter Kartenparameter) 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 ausgeführt hat. Der Zeitstempel ist in der FormyyyymmddThh:mm:ss z
, wobei z der einzelbuchstabige militärische Zeitzonenindikator ist, z. B. Z für UTC (GMT) -
actions-after-shutdown
( Lese-/Schreibzugriff) -Aktion, die nach dem Herunterfahren der VM ausgeführt werden soll -
actions-after-reboot
( Lese-/Schreibzugriff) -Aktion, die nach dem Neustart der VM ausgeführt werden soll -
possible-hosts
potenzielle Hosts dieser VM schreibgeschützt -
dom-id
( schreibgeschützt) Domain-ID (falls verfügbar, andernfalls -1) -
recommendations
( schreibgeschützt) XML-Spezifikation der empfohlenen Werte und Bereiche für Eigenschaften dieser VM -
xenstore-data
( Lese-/Schreibzuordnungsparameter) Daten, die in den Xenstore-Baum (/ local/domain/domid /vm-data) eingefügt werden sollen, nachdem die VM erstellt wurde -
is-a-snapshot
( schreibgeschützt) True, wenn diese VM ein Snapshot ist -
snapshot_of
( schreibgeschützt) die UUID der VM, von der dieser Snapshot ist -
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 Arbeitsspeichers für diese VM -
blocked-operations
( Kartenparameter Lese-/Schreibzugriff) 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 auftritt, auf dem sie sich befindet. Dieser Parameter ist jetzt veraltet. Verwenden Sie stattdessen denha-restart-priority
Parameter. -
ha-restart-priority
( Lesen/Schreiben) Neustart oder Best-Aufwand -
blobs
( schreibgeschützt) 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 uid [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 Plugins auf der angegebenen vm mit optionalen Argumenten auf (args: key = value). Um eine „value“ -Zeichenfolge mit Sonderzeichen zu übergeben (z.B. neue Zeile), kann eine alternative Syntax args: key: file = local_file verwendet werden, wo 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. Derdevice
Parameter sollte aus dem Wert desallowed-VBD-devices
Parameters der VM ausgewählt werden.
Die VM oder VMs, auf denen dieser Vorgang ausgeführt wird, werden mit dem Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Auswahl. Optionale Argumente können eine beliebige Anzahl der [VM-Parameter]sein, die am Anfang dieses Abschnitts#vm-parameters()aufgeführt sind.
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 Befehlxe vbd-eject
und geben Sie die UUID der VBD an.
Die VM oder VMs, auf denen dieser Vorgang ausgeführt wird, werden mit dem Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Auswahl. Optionale Argumente können eine beliebige Anzahl der [VM-Parameter]sein, die am Anfang dieses Abschnitts#vm-parameters()aufgeführt sind.
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 denxe vbd-insert
Befehl und geben Sie die UUIDs der VBD und des VDI an, die eingefügt werden sollen.
Die VM oder VMs, auf denen dieser Vorgang ausgeführt wird, werden mit dem Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Auswahl. Optionale Argumente können eine beliebige Anzahl der [VM-Parameter]sein, die am Anfang dieses Abschnitts#vm-parameters()aufgeführt sind.
vm-cd-list
vm-cd-list [vbd-params] [vdi-params] [vm-selector = vm_selector_value...]
Listet CDs auf, die an die angegebenen VMs angeschlossen sind.
Die VM oder VMs, auf denen dieser Vorgang ausgeführt wird, werden mit dem Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Auswahl. Optionale Argumente können eine beliebige Anzahl der [VM-Parameter]sein, die am Anfang dieses Abschnitts#vm-parameters()aufgeführt sind.
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 mit dem Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Auswahl. Optionale Argumente können eine beliebige Anzahl der [VM-Parameter]sein, die am Anfang dieses Abschnitts#vm-parameters()aufgeführt sind.
vm-checkpoint
vm-checkpoint new-name-label = name_label [new-name-description = description]
Überprüfen Sie eine vorhandene VM und verwenden Sie den schnellen Festplatten-Snapshot-Vorgang auf Speicherebene, sofern verfügbar.
vm-clone
vm-clone new-name-label = name_for_clone [new-name-description = description_for_clone] [vm-selector = vm_selector_value...]
Klonen Sie eine vorhandene VM unter Verwendung des schnellen Festplatten-Clone-Vorgangs auf Speicherebene, sofern verfügbar. Geben Sie den Namen und die optionale Beschreibung für die resultierende geklonte VM mit dennew-name-label
Argumentennew-name-description
und an.
Die VM oder VMs, auf denen dieser Vorgang ausgeführt wird, werden mit dem Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Auswahl. Optionale Argumente können eine beliebige Anzahl der [VM-Parameter]sein, die am Anfang dieses Abschnitts#vm-parameters()aufgeführt sind.
vm-compute-maximum-memory
vm-compute-maximum-memory total = amount_of_available_physical_ram_in_bytes [approximate = Overhead-Speicher für zusätzliche vCPUs hinzufügen? 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 Arbeitsspeichers als Obergrenze verwendet wird. Der optionale Parameterapproximate
reserviert genügend zusätzlichen Speicher in der Berechnung, um später zusätzliche vCPUs in die VM hinzuzufügen.
Zum Beispiel:
xe vm-compute-maximum-memory vm = testvm total = `xe host-list params = speicherfrei — minimal`
Dieser Befehl verwendet den Wert desmemory-free
Parameters, der vomxe host-list
Befehl zurückgegeben wird, um den maximalen Speicher der benannten VM festzulegentestvm
.
Die VM oder VMs, auf denen dieser Vorgang ausgeführt wird, werden mit dem Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Auswahl. Optionale Argumente können eine beliebige Anzahl der [VM-Parameter]sein, die am Anfang dieses Abschnitts#vm-parameters()aufgeführt sind.
vm-compute-memory-overhead
vm-compute-speicher-Overhead
Berechnet den Virtualisierungsspeicher-Overhead 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 Festplatten-Clone-Vorgang auf Speicherebene zu verwenden (selbst wenn diese Option verfügbar ist). Die Disk-Images der kopierten VM sind garantiert vollständige Images, d. h. nicht Teil einer CoW-Kette (Copy-on-Write).
Geben Sie den Namen und die optionale Beschreibung für die resultierende kopierte VM mit dennew-name-label
Argumentennew-name-description
und an.
Geben Sie die Ziel-SR für die resultierende kopierte VM mit dem ansr-uuid
. Wenn dieser Parameter nicht angegeben wird, ist das Ziel dieselbe SR, in der sich die ursprüngliche VM befindet.
Die VM oder VMs, auf denen dieser Vorgang ausgeführt wird, werden mit dem Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Auswahl. Optionale Argumente können eine beliebige Anzahl der [VM-Parameter]sein, die am Anfang dieses Abschnitts#vm-parameters()aufgeführt sind.
vm-copy-bios-strings
vm-copy-bios-strings host-uuid = host_uuid
Kopieren Sie die BIOS-Zeichenfolgen des angegebenen Hosts auf die VM.
vm-crashdump-list
vm-crashdump-list [vm-selector = vm-selector-Wert...]
Listen Sie Absturzabbilder auf, die den angegebenen VMs zugeordnet sind.
Wenn Sie das optionale Argument verwendenparams
, ist der Wert von params eine Zeichenfolge, die eine Liste der Parameter dieses Objekts enthält, die angezeigt werden soll. Alternativ können Sie das Schlüsselwort verwendenall
, um alle Parameter anzuzeigen. Wennparams
nicht verwendet wird, zeigt die zurückgegebene Liste eine Standarduntermenge aller verfügbaren Parameter an.
Die VM oder VMs, auf denen dieser Vorgang ausgeführt wird, werden mit dem Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Auswahl. Optionale Argumente können eine beliebige Anzahl der [VM-Parameter]sein, die am Anfang dieses Abschnitts#vm-parameters()aufgeführt sind.
vm-data-source-list
vm-data-source-list [vm-selector = vm Selektorwert...]
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-Auswahl. Optionale Argumente können eine beliebige Anzahl der [VM-Parameter]sein, die am Anfang dieses Abschnitts#vm-parameters()aufgeführt sind. Wenn keine Parameter zur Auswahl von Hosts angegeben sind, wird der Vorgang auf allen VMs ausgeführt.
Datenquellen haben zwei Parameter —standard
undenabled
—, die Sie in der Ausgabe dieses Befehls sehen können. Wenn eine Datenquelle aufenabled
festgelegt isttrue
, werden die Metriken derzeit in der Performance-Datenbank aufgezeichnet. Wenn eine Datenquelle aufstandard
festgelegt isttrue
, werden die Metriken standardmäßig in der Performance-Datenbank aufgezeichnet (undenabled
ist auch auftrue
für diese Datenquelle). Wenn eine Datenquelle aufstandard
festgelegt istfalse
, werden die Metriken standardmäßig *nicht* in der Performance-Datenbank aufgezeichnet (undenabled
ist auch auf falsefür diese Datenquelle).
Führen Sie denvm-data-source-record
Befehl aus, um die Aufzeichnung von Datenquellenmetriken in der Performance-Datenbank zu starten. Dieser Befehl setztenabled
auftrue
. Um zu stoppen, führen Sie die ausvm-data-source-forget
. Dieser Befehl setztenabled
auffalse
.
vm-data-source-record
vm-data-source-record data-source = name_description_of_data-source [vm-selector = vm-selector-Wert...]
Zeichnen Sie die angegebene Datenquelle für eine VM auf.
Dieser Vorgang schreibt die Informationen aus der Datenquelle in die Datenbank für persistente Performance-Metriken der angegebenen VMs. Aus Leistungsgrü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-Auswahl. Optionale Argumente können eine beliebige Anzahl der [VM-Parameter]sein, die am Anfang dieses Abschnitts#vm-parameters()aufgeführt sind. Wenn keine Parameter zur 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-Wert...]
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-Auswahl. Optionale Argumente können eine beliebige Anzahl der [VM-Parameter]sein, die am Anfang dieses Abschnitts#vm-parameters()aufgeführt sind. Wenn keine Parameter zur 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-Auswahl. Optionale Argumente können eine beliebige Anzahl der [VM-Parameter]sein, die am Anfang dieses Abschnitts#vm-parameters()aufgeführt sind. Wenn keine Parameter zur 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 mit der VM verknüpfte Speicher intakt. Um auch Speicher zu löschen, verwenden Siexe 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 dendevice
Parameter aus dem Wert desallowed-VBD-devices
Parameters der VMs aus.
Derdisk-size
Parameter 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 mit dem Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Auswahl. Optionale Argumente können eine beliebige Anzahl der [VM-Parameter]sein, die am Anfang dieses Abschnitts#vm-parameters()aufgeführt sind.
vm-disk-list
vm-disk-list [vbd-params] [vdi-params] [vm-selector = vm_selector_value...]
Listet Datenträger auf, die an die angegebenen VMs angeschlossen sind. Dievbd-params
Parametervdi-params
und steuern die Felder der jeweiligen auszugabenden Objekte. Geben Sie die Parameter als kommagetrennte Liste oder den speziellen Schlüsselall
für die vollständige Liste an.
Die VM oder VMs, auf denen dieser Vorgang ausgeführt wird, werden mit dem Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Auswahl. Optionale Argumente können eine beliebige Anzahl der [VM-Parameter]sein, die am Anfang dieses Abschnitts#vm-parameters()aufgeführt sind.
vm-disk-remove
vm-disk-remove device = integer_label_of_disk [vm-selector = vm_selector_value...]
Entfernen Sie einen Datenträger von den angegebenen VMs und löschen Sie ihn.
Die VM oder VMs, auf denen dieser Vorgang ausgeführt wird, werden mit dem Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Auswahl. Optionale Argumente können eine beliebige Anzahl der [VM-Parameter]sein, die am Anfang dieses Abschnitts#vm-parameters()aufgeführt sind.
vm-export
vm-export Dateiname = export_filename [metadata = true | false] [vm-selector = vm_selector_value...]
Exportieren Sie die angegebenen VMs (einschließlich Disk-Images) in eine Datei auf dem lokalen Computer. Geben Sie den Dateinamen an, in den die VM mit demfilename
Parameter exportiert werden soll. Nach Konvention sollte der Dateiname eine.xva
Erweiterung haben.
Wenn dermetadata
Parameter angegeben isttrue
, werden die Festplatten nicht exportiert. Nur die VM-Metadaten werden in die Ausgabedatei geschrieben. Verwenden Sie diesen Parameter, wenn der zugrunde liegende Speicher über andere Mechanismen übertragen wird und die VM-Informationen neu erstellt werden können. Weitere Informationen finden Sie unter vm-import.
Die VM oder VMs, auf denen dieser Vorgang ausgeführt wird, werden mit dem Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Auswahl. Optionale Argumente können eine beliebige Anzahl der [VM-Parameter]sein, die am Anfang dieses Abschnitts#vm-parameters()aufgeführt sind.
vm-import
vm-import Dateiname = export_filename [metadata = true | false] [preserve = true | false] [sr-uuid = destination_sr_uuid]
Importieren Sie eine VM aus einer zuvor exportierten Datei. Wenn auf festgelegtpreserve
isttrue
, wird die MAC-Adresse der ursprünglichen VM beibehalten. Dersr-uuid
bestimmt die Ziel-SR, in die die VM importiert werden soll. Wenn dieser Parameter nicht angegeben wird, wird der Standard-SR verwendet.
Derfilename
Parameter kann auch auf eine VM im XVA-Format verweisen, bei der es sich um das Legacy-Exportformat von 3.2 handelt. Dieses Format wird von einigen Drittanbietern verwendet, um virtuelle Appliances bereitzustellen. Das XVA-Format verwendet ein Verzeichnis, um die VM-Datenfilename
zu speichern. Setzen Sie daher auf das Stammverzeichnis des XVA-Exports und nicht auf eine tatsächliche Datei. Nachfolgende Exporte des importierten Legacy-Gastes werden automatisch auf das neue dateinamebasierte Format aktualisiert, in dem viel mehr Daten zur Konfiguration der VM gespeichert werden.
Hinweis:
Das ältere verzeichnisbasierte XVA-Format behält nicht alle VM-Attribute vollständig bei. Insbesondere sind importierte VMs standardmäßig keine virtuellen Netzwerkschnittstellen angefügt. Wenn ein Netzwerk erforderlich ist, erstellen Sie eine mit
vif-create
undvif-plug
.
Wenn dies der Fallmetadata
isttrue
, können Sie einen zuvor exportierten Satz von Metadaten ohne die zugehörigen Datenträgerblöcke importieren. Der reine Metadaten-Import schlägt fehl, wenn keine VDIs (benannt durch SR undVDI.location
) gefunden werden können, es sei denn, die--force
Option ist angegeben. In diesem Fall wird der Import unabhängig durchgeführt. Wenn Festplatten gespiegelt oder Out-of-Band-verschoben werden können, ist der Import/Export von Metadaten eine schnelle Möglichkeit, VMs zwischen disjunkten Pools zu verschieben. Zum Beispiel als Teil eines Notfallwiederherstellungsplans.
Hinweis:
Mehrere VM-Importe werden schneller seriell als parallel ausgeführt.
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 demtemplate-uuid
Argumenttemplate
oder an. Geben Sie eine SR entweder mit demsr-uuid
Argumentsr-name-label
oder an. Geben Sie an, dass BIOS-gesperrte Medien mit demcopy-bios-strings-from
Argument installiert werden sollen.
Hinweis:
Bei der Installation von einer Vorlage, die über vorhandene Datenträger verfügt, werden standardmäßig neue Datenträger in derselben SR wie diese vorhandenen Datenträger erstellt. Wo die SR es unterstützt, sind diese Festplatten schnelle Kopien. Wenn in der Befehlszeile ein anderer SR angegeben wird, werden dort die neuen Datenträger angelegt. 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 neue Datenträger in der angegebenen SR erstellt, oder die standardmäßige SR des Pools, wenn keine SR angegeben ist.
vm-is-bios-customized
vm-ist-Bios-angepasste
Gibt an, ob die BIOS-Zeichenfolgen der VM angepasst wurden.
vm-memory-balloon
vm-memory-ballon-Ziel = Ziel
Legen Sie das Speicherziel für eine laufende 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-speicher-dynamisch-bereich-set min = min max = max
Konfigurieren Sie den dynamischen Speicherbereich einer VM. Der dynamische Speicherbereich definiert weiche Unter- und Obergrenzen für den Speicher einer virtuellen Maschine. 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 Speichergrenzen einer VM.
vm-memory-set
vm-memory-set memory = speicher
Konfigurieren Sie die Speicherzuweisung einer VM.
vm-memory-shadow-multiplier-set
vm-memory-shadow-multiplier-set [vm-selector = vm_selector_value...] [multiplikator = float_memory_multiplier]
Legen Sie den Schattenspeichermultiplikator für die angegebene VM fest.
Dies ist eine erweiterte Option, die die Menge des Schattenspeichers modifiziert, der einer hardwareunterstützten VM zugewiesen ist.
Dieser Speicher wird als Overhead angesehen. Es ist von den normalen Speicherberechnungen für die Abrechnung von Speicher auf eine VM getrennt. Wenn dieser Befehl aufgerufen wird, nimmt die Menge des freien Hostspeichers entsprechend dem Multiplikator ab und dasHVM_shadow_multiplier
Feld wird mit dem Wert aktualisiert, den Xen der VM zugewiesen hat. Wenn nicht genügend Hostspeicher frei ist, wird ein Fehler zurückgegeben.
Die VMs, auf denen dieser Vorgang ausgeführt werden soll, werden mit dem Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Auswahl.
vm-memory-static-range-set
vm-memory-static-bereich-set min = min max = max
Konfigurieren Sie den statischen Speicherbereich einer VM. Der statische Speicherbereich definiert harte Unter- und Obergrenzen für den Speicher einer virtuellen Maschine. Es ist möglich, diese Felder nur zu ändern, wenn eine VM angehalten wird. Der statische Bereich muss den Dynamikbereich umfassen.
vm-memory-target-set
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-speicher-target-wait
Warten Sie, bis eine laufende VM ihr aktuelles Speicherziel erreicht hat.
vm-migrate
vm-migrate [copy = true | false] [host-uuid = destination_host_uuid] [host = name_oder_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_uid] [vdi = vdi_uuid]
Mit diesem Befehl werden die angegebenen VMs zwischen physischen Hosts migriert. Derhost
Parameter kann entweder der Name oder die UUID des Hosts sein. Um beispielsweise die VM auf einen anderen Host im Pool zu migrieren, auf dem sich die VM-Festplatten auf Speicher befinden, die von beiden Hosts gemeinsam genutzt werden:
xe vm-migrate uid = vm_uuid host-uuid = host_uuid
So verschieben Sie VMs zwischen Hosts im selben Pool, die keinen Speicher gemeinsam nutzen (Speicher ):
xe vm-migrieren uuid = vm_uuid remote-master = 12.34.56.78 \
remote-username = Benutzername Remote-Passwort = Passwort \
host-uuid = desination_host_uuid vdi = vdi_uuid
Sie können die SR auswählen, in der jeder VDI gespeichert wird:
xe vm-migrate uuid = vm_uuid host-uuid = destination_host_uuid \
vdi1: vdi_1_uuid = Ziel_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 anhängt:
xe vm-migrieren uuid = vm_uuid \
vdi1: vdi_1_uuid = Ziel_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-migrieren uuid = vm_uuid remote-master = 12.34.56.78
remote-username = Benutzername Remote-Passwort = Passwort \
host-uuid = desination_host_uuid vdi = vdi_uuid
Weitere Informationen zu Speicher und Live-VDI-Migration finden Sie unter [Migrieren von VMs mit und Speicher /en-us/xenserver/current-release/vms/migrate.html()].
Standardmäßig wird die VM auf dem anderen Host angehalten, migriert und fortgesetzt. Derlive
Parameter wird ausgewählt . sorgt dafür, dass die VM während der Migration ausgeführt wird, wodurch die Ausfallzeiten der VM auf weniger als eine Sekunde reduziert werden. Unter bestimmten Umständen, z. B. extrem speicherintensive Arbeitslasten in der VM, fällt zurück in den Standardmodus und hält die VM für kurze Zeit an, bevor die Speicherübertragung abgeschlossen wird.
Die VM oder VMs, auf denen dieser Vorgang ausgeführt wird, werden mit dem Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Auswahl. Optionale Argumente können eine beliebige Anzahl der [VM-Parameter]sein, die am Anfang dieses Abschnitts#vm-parameters()aufgeführt sind.
vm-pause
vm-Pause
Unterbrechen einer ausgeführten VM. Beachten Sie, dass dieser Vorgang den zugeordneten Speicher nicht freigibt (siehevm-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...] [Kraft = wahr]
Starten Sie die angegebenen VMs neu.
Die VM oder VMs, auf denen dieser Vorgang ausgeführt wird, werden mit dem Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Auswahl. Optionale Argumente können eine beliebige Anzahl der [VM-Parameter]sein, die am Anfang dieses Abschnitts#vm-parameters()aufgeführt sind.
Verwenden Sie dasforce
Argument, um einen ungraceful Neustart zu verursachen. Wo das Herunterfahren ähnelt dem Ziehen des Steckers auf einem physischen Server.
vm-recover
vm-recover vm-uuid [Datenbank] [vdi-uuid] [erzwingen]
Stellt eine VM aus der im bereitgestellten VDI enthaltenen Datenbank wieder her.
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 mit dem Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Auswahl. Optionale Argumente können eine beliebige Anzahl der [VM-Parameter]sein, die am Anfang dieses Abschnitts#vm-parameters()aufgeführt sind.
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 zwingen, den Energiezustand der VMs zurückzusetzenhalted
. Im Wesentlichen erzwingt dieser Befehl die Sperre der VM und ihrer Festplatten, damit sie als nächstes auf einem anderen Pool-Host gestartet werden kann. Dieser Aufruf erfordert, dass das Er zwangsflag 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]
Setzen Sie die angegebenen VMs fort.
Die VM oder VMs, auf denen dieser Vorgang ausgeführt wird, werden mit dem Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Auswahl. Optionale Argumente können eine beliebige Anzahl der [VM-Parameter]sein, die am Anfang dieses Abschnitts#vm-parameters()aufgeführt sind.
Wenn sich die VM auf einer gemeinsam genutzten SR in einem Hostpool befindet, geben Sie mit demon
Argument an, auf welchem Poolmitglied sie gestartet werden soll. Standardmäßig bestimmt das System einen geeigneten Host, der eines der Mitglieder des Pools sein kann.
vm-retrieve-wlb-recommendations
vm-retrieve-wlb-recommendations
Rufen Sie die Empfehlungen für den Workload Balancing 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 mit dem Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Auswahl. Optionale Argumente können eine beliebige Anzahl der [VM-Parameter]sein, die am Anfang dieses Abschnitts#vm-parameters()aufgeführt sind.
Verwenden Sie dasforce
Argument, um ein ungraceful Herunterfahren zu verursachen, ähnlich dem Ziehen des Plugs auf einem physischen Server.
vm-snapshot
vm-snapshot new-name-label = name_label [new-name-description + name_description]
Snapshot einer vorhandenen VM unter Verwendung des schnellen Festplatten-Snapshot-Vorgangs auf Speicherebene, sofern verfügbar.
vm-snapshot-with-quiesce
vm-snapshot-with-quiesce new-name-label = name_label [new-name-description + name_description]
Erstellen Sie einen Snapshot einer vorhandenen VM mit Stillstand und verwenden Sie den schnellen Festplatten-Snapshot-Vorgang auf Speicherebene, sofern verfügbar.
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 mit dem Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Auswahl. Optionale Argumente können eine beliebige Anzahl der [VM-Parameter]sein, die am Anfang dieses Abschnitts#vm-parameters()aufgeführt sind.
Wenn sich die VMs auf einer freigegebenen SR in einem Hostpool befinden, geben Sie mit demon
Argument an, auf welchem Poolmitglied die VMs gestartet werden sollen. Standardmäßig bestimmt das System einen geeigneten Host, der eines der Mitglieder des Pools sein 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 mit dem Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Auswahl. Optionale Argumente können eine beliebige Anzahl der [VM-Parameter]sein, die am Anfang dieses Abschnitts#vm-parameters()aufgeführt sind.
vm-uninstall
vm-uninstall [vm-selector = vm_selector_value...] [force = true | false]
Deinstallieren Sie eine VM, indem Sie ihre Festplatten (die VDIs, die als RW markiert und nur mit dieser VM verbunden sind) sowie ihren Metadateneintrag löschen. Um nur die VM-Metadaten zu zerstören, verwenden Siexe vm-destroy
.
Die VM oder VMs, auf denen dieser Vorgang ausgeführt wird, werden mit dem Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Auswahl. Optionale Argumente können eine beliebige Anzahl der [VM-Parameter]sein, die am Anfang dieses Abschnitts#vm-parameters()aufgeführt sind.
vm-unpause
vm-unpause
Heben Sie die Unterbrechung 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 für eine laufende PV oder HVM Linux-VM verfügbar sind. Die Anzahl der vCPUs wird durch den Parameter begrenztVCPUs-max
. Windows-VMs werden immer mit der Anzahl der vCPUs ausgeführtVCPUs-max
und müssen neu gestartet werden, um diesen Wert zu ändern.
Die PV oder HVM Linux VM oder VMs, auf denen dieser Vorgang ausgeführt wird, werden mit dem Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Auswahl. Optionale Argumente können eine beliebige Anzahl der [VM-Parameter]sein, die am Anfang dieses Abschnitts#vm-parameters()aufgeführt sind.
Hinweis:
Führen Sie beim Ausführen von Linux-VMs ohne Installation den folgenden Befehl auf der VM aus,
root
um sicherzustellen, dass die neu angefügten 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 mit dem Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Auswahl. Die Selektoren arbeiten beim Filtern auf den VM-Datensätzen und nicht auf den VIF-Werten. Optionale Argumente können eine beliebige Anzahl der [VM-Parameter]sein, die am Anfang dieses Abschnitts#vm-parameters()aufgeführt sind.
Geplante Snapshots
Befehle zum Steuern von VM shceduled Snapshots und deren Attribute.
Die vmss-Objekte können mit dem Standardobjektauflistungsbefehl (xe vmss-list
) aufgelistet werden, und die Parameter werden mit den Standardparameterbefehlen bearbeitet. Weitere Informationen finden Sie unter Low-Level-Parameterbefehle
vmss-create
vmss-create enabled = True/False name-label = name type = type frequency = frequency beibehalten snapshots = value name-description = Beschreibung Zeitplan: Zeitplan
Erstellt einen Snapshot-Zeitplan im Pool.
Zum Beispiel:
xe vmss-create retained-snapshots = 9 aktiviert = true frequency = täglich \
name-description = Beispielname-label = Beispielrichtlinientyp = Snapshot \
Zeitplan: Stunde = 10 Zeitplan: min = 30
Snapshot-Zeitpläne haben die folgenden Parameter:
Parametername | Beschreibung | Typ |
---|---|---|
name-label |
Name des Snapshot-Zeitplans. | Lesen/Schreiben |
name-description |
Beschreibung des Snapshot-Zeitplans. | Lesen/Schreiben |
type |
Festplatten-Snapshot; Speicher-Snapshot; Stillgeuhter Snapshot | Lesen/Schreiben |
frequency |
Stündlich; Täglich; Wöchentlich | Lesen/Schreiben |
retained-snapshots |
Snapshots, die beibehalten werden sollen. Reichweite: 1-10 | Lesen/Schreiben |
schedule |
schedule:days ( Montag bis Sonntag),schedule:hours (0 bis 23),schedule:minutes (0, 15, 30, 45) |
Lesen/Schreiben |
vmss-destroy
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-Pass-Through aktivieren/deaktivieren.
pusb-scan
pusb-scan host-uuid = host_uuid
PUSB scannen und aktualisieren.
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
Entsteckt USB von VM.
vusb-destroy
vusb-destroy uuid = vusb_uuid
Entfernt die virtuelle USB-Liste von VM. ```
In diesem Artikel
- Grundlegende Xe-Syntax
- Sonderzeichen und Syntax
- Befehlstypen
- xe-Befehlsreferenz
- Appliance-Befehle
- Überwachungsbefehle
- Bondbefehle
- CD-Befehle
- Cluster-Befehle
- Konsolenbefehle
- Diagnosebefehle
- Disaster Recovery-Befehle
- Ereignisbefehle
- GPU-Befehle
- Host-Befehle
- Protokollbefehle
- Nachrichtenbefehle
- Netzwerkbefehle
- SDN-Controller-Befehle
- Tunnelbefehle
- Patch-Befehle
- PBD-Befehle
- PIF-Befehle
- Pool-Befehle
- PVS-Beschleunigerbefehle
- Storage Manager-Befehle
- Snapshot-Befehle
- SR-Befehle
- Betreffbefehle
- Task-Befehle
- Vorlagenbefehle
- Update-Befehle
- Benutzerbefehle
- VBD-Befehle
- VDI-Befehle
- VIF-Befehle
- VLAN-Befehle
- VM-Befehle