Befehlszeilenoberfläche
Das Xe Mit der CLI können Sie Skripte erstellen und Systemverwaltungsaufgaben automatisieren. Verwenden Sie die CLI, um XenServer in eine bestehende IT-Infrastruktur zu integrieren.
Erste Schritte mit der xe CLI
Die xe-Befehlszeilenschnittstelle ist standardmäßig auf allen XenServer-Hosts installiert. Eine Remote-Windows-Version ist in XenCenter enthalten. Für Linux ist auch eine eigenständige Remote-CLI verfügbar.
Auf Ihrem XenServer-Host
Die xe-Befehlszeilenschnittstelle ist standardmäßig auf Ihrem Host installiert. Sie können xe CLI-Befehle in der dom0-Konsole ausführen. Greifen Sie auf eine der folgenden Arten auf die dom0-Konsole zu:
- Gehen Sie in XenCenter zum Konsole für den Host, auf dem Sie den Befehl ausführen möchten.
- Verbinden Sie sich per SSH mit dem Host, auf dem Sie den Befehl ausführen möchten.
Unter Windows
Unter Windows wird die xe.exe
wird zusammen mit XenCenter installiert.
Um die Funktion xe.exe
, öffnen Sie eine Windows-Eingabeaufforderung und wechseln Sie in das Verzeichnis, in dem die xe.exe
Datei befindet sich (in der Regel C:\Programme (x86)\XenServer\XenZentrum
). Wenn Sie die Option xe.exe
Installationsort zu Ihrem Systempfad hinzufügen, können Sie den Befehl verwenden, ohne in das Verzeichnis wechseln zu müssen.
Unter Linux
Auf RPM-basierten Distributionen (z. B. Red Hat) können Sie den eigenständigen Befehl xe aus dem RPM mit dem Namen client_install/xapi-xe-BUILD.x86_64.rpm
auf der Haupt-ISO der XenServer-Installation.
Verwenden Sie den folgenden Befehl, um von der RPM zu installieren:
rpm -ivh xapi-xe-BUILD.x86_64.rpm
<!--NeedCopy-->
Sie können Parameter in der Befehlszeile verwenden, um den XenServer-Host, den Benutzernamen und das Kennwort zu definieren, die beim Ausführen von xe-Befehlen verwendet werden sollen. Sie haben jedoch auch die Möglichkeit, diese Informationen als Umgebungsvariable festzulegen. Beispiel:
export XE_EXTRA_ARGS="server=<host name>,username=<user name>,password=<password>"
<!--NeedCopy-->
Hinweis:
Die Remote-xe-CLI unter Linux kann hängen, wenn versucht wird, Befehle über eine sichere Verbindung auszuführen, und diese Befehle beinhalten eine Dateiübertragung. Wenn ja, können Sie die Schaltfläche
--kein-ssl
-Parameter, um den Befehl über eine unsichere Verbindung zum XenServer-Host auszuführen.
Hilfe zu xe-Befehlen erhalten
Grundlegende Hilfe ist für CLI-Befehle auf dem Host verfügbar, indem Sie Folgendes eingeben:
xe help command
<!--NeedCopy-->
Eine Liste der am häufigsten verwendeten xe-Befehle wird angezeigt, wenn Sie Folgendes eingeben:
xe help
<!--NeedCopy-->
Oder eine Liste aller xe-Befehle wird angezeigt, wenn Sie Folgendes eingeben:
xe help --all
<!--NeedCopy-->
Grundlegende xe-Syntax
Die grundlegende Syntax aller XenServer xe CLI-Befehle lautet:
xe command-name argument=value argument=value
<!--NeedCopy-->
Jeder spezifische Befehl enthält einen eigenen Satz von Argumenten, die in der Form argument=Wert
. Einige Befehle verfügen über erforderliche Argumente, und die meisten verfügen über einen Satz optionaler Argumente. In der Regel nimmt ein Befehl Standardwerte für einige der optionalen Argumente an, wenn er ohne diese Argumente aufgerufen wird.
Wenn der Befehl xe remote ausgeführt wird, werden zusätzliche Argumente für die Verbindung und Authentifizierung verwendet. Diese Argumente haben auch die Form Argument=argument_value
.
Das Server
wird verwendet, um den Hostnamen oder die IP-Adresse anzugeben. Das Nutzername
und Passwort
Argumente werden verwendet, um Anmeldeinformationen anzugeben.
Ein Passwort-Datei
kann anstelle des Passworts direkt angegeben werden. In diesem Fall versucht der Befehl xe, das Kennwort aus der angegebenen Datei zu lesen, und verwendet dieses Kennwort für die Verbindung. (Alle nachfolgenden CRs und LFs am Ende der Datei werden entfernt.) Diese Methode ist sicherer als die direkte Angabe des Kennworts in der Befehlszeile.
Die optionale Hafen
-Argument kann verwendet werden, um den Agent-Port auf dem Remote-XenServer-Host anzugeben (Standardwert ist 443).
Beispiel: Auf dem lokalen XenServer-Host:
xe vm-list
<!--NeedCopy-->
Beispiel: Auf einem Remote-XenServer-Host:
xe vm-list username=username password=password server=hostname
<!--NeedCopy-->
Die Kurzsyntax ist auch für Argumente für Remoteverbindungen verfügbar:
-
-u
Benutzername -
-Kriegsgefangener
Passwort -
-pwf
Passwort-Datei -
-p
Hafen -
-s
Server
Beispiel: Auf einem Remote-XenServer-Host:
xe vm-list -u myuser -pw mypassword -s hostname
<!--NeedCopy-->
Argumente werden auch aus der Umgebungsvariablen XE_EXTRA_ARGS in Form von kommagetrennten Schlüssel-Wert-Paaren entnommen. Um beispielsweise Befehle einzugeben, die auf einem Remote-XenServer-Host ausgeführt werden, führen Sie zuerst den folgenden Befehl aus:
export XE_EXTRA_ARGS="server=jeffbeck,port=443,username=root,password=pass"
<!--NeedCopy-->
Nachdem Sie diesen Befehl ausgeführt haben, müssen Sie die Parameter des Remote-XenServer-Hosts nicht mehr in jedem xe-Befehl angeben, den Sie ausführen.
Die Verwendung der Umgebungsvariablen XE_EXTRA_ARGS ermöglicht auch die Tabulatorvervollständigung von xe-Befehlen, wenn sie für einen Remote-XenServer-Host ausgegeben werden, der standardmäßig deaktiviert ist.
Sonderzeichen und Syntax
Um Argument-Wert-Paare auf der Registerkarte Xe
Befehlszeile, schreiben: argument=Wert
Verwenden Sie keine Anführungszeichen, es sei denn, der Wert enthält Leerzeichen. Fügen Sie keine Leerzeichen zwischen dem Argumentnamen, dem Gleichheitszeichen (=) und dem Wert ein. Jedes Argument, das nicht diesem Format entspricht, wird ignoriert.
Für Werte, die Leerzeichen enthalten, schreiben Sie: argument="Wert mit Leerzeichen"
Wenn Sie die CLI auf Ihrem XenServer-Host verwenden, verfügen Befehle über eine Tab-Vervollständigungsfunktion, die der Funktion in der standardmäßigen Linux-Bash-Shell ähnelt. Wenn Sie z. B. XE VM-L
und drücken Sie dann die Taste REGISTERKARTE wird der Rest des Befehls angezeigt. Wenn mehr als ein Befehl mit vm-l
dringend REGISTERKARTE Ein zweites Mal listet die Möglichkeiten auf. Diese Funktion ist nützlich, wenn Objekt-UUIDs in Befehlen angegeben werden.
Hinweis:
Die Tab-Vervollständigung funktioniert normalerweise nicht, wenn Befehle auf einem Remote-XenServer-Host ausgeführt werden. Wenn Sie jedoch die Variable XE_EXTRA_ARGS auf dem Computer festlegen, auf dem Sie die Befehle eingeben, ist die Tab-Vervollständigung aktiviert. Weitere Informationen finden Sie unter Grundlegende xe-Syntax.
Arten von Befehlen
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 sind:
-
Klasse-Liste
-
Klasse-param-get
-
Klasse-param-set
-
Klasse-param-liste
-
Klasse-param-hinzufügen
-
Klasse-param-entfernen
-
Klasse-param-klar
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 von Klasse verfügt über den vollständigen Satz von Klasse-Param-Aktion Befehle. Einige Werte von Klasse verfügen über einen kleineren Satz von Befehlen.
Parameter-Typen
Die Objekte, die mit den xe-Befehlen angesprochen werden, verfügen über Parametersätze, die sie identifizieren und ihren Status definieren.
Die meisten Parameter nehmen einen einzelnen Wert an. Zum Beispiel wird die Namensschild
-Parameter einer VM enthält einen einzelnen Zeichenfolgenwert. In der Ausgabe aus Parameterliste werden Befehle, z. B. xe vm-param-liste
, gibt ein Wert in Klammern an, ob die Parameter Lese-/Schreibzugriff (RW) oder schreibgeschützt (RO) sind. Die Ausgabe von xe vm-param-liste
auf einer angegebenen VM kann die folgenden Zeilen aufweisen:
user-version ( RW): 1
is-control-domain ( RO): false
Der erste Parameter, Benutzer-Version
, ist beschreibbar und hat den Wert 1. Die zweite, ist-kontrolle-domäne
, ist schreibgeschützt und hat den Wert false.
Die beiden anderen Parametertypen sind mehrwertig. Ein Garnitur enthält eine Liste von Werten. Ein Landkarte -Parameter ist ein Satz von Schlüssel-Wert-Paaren. Schauen Sie sich als Beispiel die folgende Beispielausgabe der xe vm-param-liste
auf einer angegebenen VM:
platform (MRW): acpi: true; apic: true; pae: true; nx: false
allowed-operations (SRO): pause; clean_shutdown; clean_reboot; \
hard_shutdown; hard_reboot; suspend
Das Bahnsteig
verfügt über eine Liste von Elementen, die Schlüssel-Wert-Paare darstellen. Auf die Schlüsselnamen folgt ein Doppelpunkt (:). Jedes Schlüssel-Wert-Paar wird durch ein Semikolon (;)) vom nächsten getrennt. Das M vor dem RW gibt an, dass es sich bei diesem Parameter um einen Map-Parameter handelt, der lesbar und beschreibbar ist. Das allowed-operations
verfügt über eine Liste, die aus einer Gruppe von Elementen besteht. Das S vor dem RO gibt an, dass es sich um einen eingestellten Parameter handelt, der lesbar, aber nicht beschreibbar ist.
Um nach einem Zuordnungsparameter zu filtern oder einen Zuordnungsparameter festzulegen, verwenden Sie einen Doppelpunkt (:), um den Namen des Zuordnungsparameters und das Schlüssel-Wert-Paar zu trennen. Um beispielsweise den Wert der Foo
des Schlüssels andere-konfiguration
Parameter einer VM auf blöken
, würde der Befehl lauten:
xe vm-param-set uuid=VM uuid other-config:foo=baa
<!--NeedCopy-->
Parameterbefehle auf niedriger Ebene
Es gibt mehrere Befehle, um mit den Parametern von Objekten zu arbeiten: Klasse-param-get, Klasse-param-set, Klasse-param-add, Klasse-param-entfernen, Klasse-param-clear und Klasse-param-list. Jeder dieser Befehle benötigt einen UUID
, um das jeweilige Objekt anzugeben. Da diese Befehle als Befehle auf niedriger Ebene betrachtet werden, müssen sie die UUID und nicht die VM-Namensbezeichnung verwenden.
-
xe class-param-list uuid=uuid
Listet alle Parameter und die zugehörigen Werte auf. Im Gegensatz zum Klasse-list Befehl, dieser Befehl listet die Werte von “teuren” Feldern auf.
-
xe class-param-get uuid=uuid param-name=parameter param-key=key
Gibt den Wert eines bestimmten Parameters zurück. Bei einem Zuordnungsparameter wird durch die Angabe des param-key der Wert abgerufen, der diesem Schlüssel in der Zuordnung zugeordnet ist. Wenn param-key nicht angegeben ist oder wenn es sich bei dem Parameter um einen Satz handelt, gibt der Befehl eine Zeichenfolgendarstellung des Satzes oder der Zuordnung zurück.
-
xe class-param-set uuid=uuid param=value
Legt den Wert eines oder mehrerer Parameter fest.
-
xe class-param-add uuid=uuid param-name=parameter key=value param-key=key
Fügt entweder eine Map oder einen Set-Parameter hinzu. Fügen Sie für einen Zuordnungsparameter Schlüssel-Wert-Paare hinzu, indem Sie die Schlüssel=Wert-Syntax verwenden. Wenn es sich bei dem Parameter um einen Satz handelt, fügen Sie Schlüssel mit der Syntax param-key=key hinzu.
-
xe class-param-remove uuid=uuid param-name=parameter param-key=key
Entfernt entweder ein Schlüssel-Wert-Paar aus einer Zuordnung oder einen Schlüssel aus einem Satz.
-
xe class-param-clear uuid=uuid param-name=parameter
Löscht ein Set oder eine Map vollständig.
Listenbefehle auf niedriger Ebene
Das Klasse-list listet die Objekte vom Typ Klasse. Standardmäßig listet dieser Befehlstyp alle Objekte auf und gibt eine Teilmenge der Parameter aus. Dieses Verhalten kann auf folgende Weise geändert werden:
- Es kann die Objekte so filtern, dass es nur eine Teilmenge ausgibt
- Die Parameter, die gedruckt werden, können geändert werden.
Um die Parameter zu ändern, die gedruckt werden, geben Sie das Argument Parameter als kommagetrennte Liste der erforderlichen Parameter. Beispiel:
xe vm-list params=name-label,other-config
<!--NeedCopy-->
Alternativ können Sie die Syntax verwenden, um alle Parameter aufzulisten:
xe vm-list params=all
<!--NeedCopy-->
Der Befehl list zeigt einige Parameter nicht an, deren Berechnung teuer ist. Diese Parameter werden z. B. wie folgt angezeigt:
allowed-VBD-devices (SRO): <expensive field>
<!--NeedCopy-->
Um diese Felder zu erhalten, verwenden Sie entweder den Befehl Klasse-param-list oder Klasse-param-get
Um die Liste zu filtern, gleicht die CLI Parameterwerte mit den in der Befehlszeile angegebenen Werten ab und druckt nur Objekte, die allen angegebenen Einschränkungen entsprechen. Beispiel:
xe vm-list HVM-boot-policy="BIOS order" power-state=halted
<!--NeedCopy-->
Dieser Befehl listet nur die VMs auf, für die beide Das Feld Energie-Zustand
hat den Wert gestoppt und das Feld HVM-boot-Richtlinie
hat den Wert BIOS-Bestellung.
Sie können die Liste auch nach dem Wert von Schlüsseln in Zuordnungen oder nach dem Vorhandensein von Werten in einem Satz filtern. Die Syntax zum Filtern basierend auf Schlüsseln in Maps lautet map-name:key=Wert
. Die Syntax zum Filtern basierend auf Werten, die in einer Menge vorhanden sind, lautet set-name:contains=Wert
.
Beim Skripting ist das Übergeben von --minimal
auf der Befehlszeile, was dazu führt, dass Xe
, um nur das erste Feld in einer kommagetrennten Liste zu drucken. Der Befehl xe vm-list --minimal
auf einem Host mit drei installierten VMs gibt die drei UUIDs der VMs an:
a85d6717-7264-d00e-069b-3b1d19d56ad9,aaa3eec5-9499-bcf3-4c03-af10baea96b7, \
42c044de-df69-4b30-89d9-2c199564581d
<!--NeedCopy-->
Geheimnisse
XenServer bietet einen Geheimnismechanismus, um zu verhindern, dass Passwörter im Klartext im Befehlszeilenverlauf oder in API-Objekten gespeichert werden. XenCenter verwendet diese Funktion automatisch und kann auch über die xe CLI für jeden Befehl verwendet werden, für den ein Kennwort erforderlich ist.
Hinweis:
Kennwortgeheimnisse können nicht verwendet werden, um sich von einer Remoteinstanz der xe CLI aus bei einem XenServer-Host zu authentifizieren.
Um ein geheimes Objekt zu erstellen, führen Sie den folgenden Befehl auf Ihrem XenServer-Host aus.
xe secret-create value=my-password
<!--NeedCopy-->
Ein Geheimnis wird auf dem XenServer-Host erstellt und gespeichert. Der Befehl gibt die UUID des geheimen Objekts aus. Zum Beispiel 99945d96-5890-de2a-3899-8c04ef2521db
. Anfügen _geheim
an den Namen des Passwort-Arguments, um diese UUID an jeden Befehl zu übergeben, der ein Kennwort erfordert.
Beispiel: Auf dem XenServer-Host, auf dem Sie das Geheimnis erstellt haben, können Sie den folgenden Befehl ausführen:
xe sr-create device-config:location=sr_address device-config:type=cifs device-config:username=cifs_username \
device-config:cifspassword_secret=secret_uuid name-label="CIFS ISO SR" type="iso" content-type="iso" shared="true"
<!--NeedCopy-->
Verlauf des Befehls
Einige xe-Befehle, z. B. xe vm-migrate
oder xe pool-enable-external-auth
, nehmen Sie Geheimnisse wie Passwörter als Parameter. Diese können in der Shell-Historie landen und sind während der Ausführung des Befehls in der Prozesstabelle sichtbar. Es ist daher wichtig, diese Befehle nur in vertrauenswürdigen Umgebungen auszuführen.
Für die Bash-Shell können Sie die HISTCONTROL
, um zu steuern, welche Befehle in der Shell-Historie gespeichert werden.
XE-Befehlsreferenz
In diesem Abschnitt werden die Befehle nach den Objekten gruppiert, die der Befehl adressiert. Diese Objekte sind alphabetisch aufgelistet.
Befehle der Appliance
Befehle zum Erstellen und Ändern von VM-Appliances (auch als vApps bezeichnet). Weitere Informationen finden Sie unter vApps.
Parameter der Appliance
Appliance-Befehle haben die folgenden Parameter:
Parametername | Beschreibung | Typ |
---|---|---|
uuid |
Die UUID der Appliance | Erforderlich |
name-description |
Die Beschreibung der Appliance | Optional |
paused |
Optional | |
force |
Herunterfahren erzwingen | Optional |
appliance-assert-can-be-recovered
xe appliance-assert-can-be-recovered uuid=appliance-uuid database:vdi-uuid=vdi-uuid
<!--NeedCopy-->
Testet, ob Speicher für die Wiederherstellung dieser VM-Appliance/vApp verfügbar ist.
appliance-create
xe appliance-create name-label=name-label [name-description=name-description]
<!--NeedCopy-->
Erstellt eine Appliance/vApp. Beispiel:
xe appliance-create name-label=my_appliance
<!--NeedCopy-->
Fügen Sie der Appliance VMs hinzu:
xe vm-param-set uuid=VM-UUID appliance=appliance-uuid
<!--NeedCopy-->
appliance-destroy
xe appliance-destroy uuid=appliance-uuid
<!--NeedCopy-->
Zerstört eine Appliance/vApp. Beispiel:
xe appliance-destroy uuid=appliance-uuid
<!--NeedCopy-->
appliance-recover
xe appliance-recover uuid=appliance-uuid database:vdi-uuid=vdi-uuid [paused=true|false]
<!--NeedCopy-->
Stellen Sie eine VM-Appliance/vApp aus der Datenbank wieder her, die im bereitgestellten VDI enthalten ist.
appliance-shutdown
xe appliance-shutdown uuid=appliance-uuid [force=true|false]
<!--NeedCopy-->
Fährt alle VMs in einer Appliance/vApp herunter. Beispiel:
xe appliance-shutdown uuid=appliance-uuid
<!--NeedCopy-->
appliance-start
xe appliance-start uuid=appliance-uuid [paused=true|false]
<!--NeedCopy-->
Startet eine Appliance/vApp. Beispiel:
xe appliance-start uuid=appliance-uuid
<!--NeedCopy-->
Audit-Befehle
Überwachungsbefehle laden alle verfügbaren Datensätze der RBAC-Überwachungsdatei im Pool herunter. Wenn der optionale Parameter seit
vorhanden ist, werden nur die Datensätze von diesem bestimmten Zeitpunkt heruntergeladen.
audit-log-get
Parameter
audit-log-get
hat die folgenden Parameter
Parametername | Beschreibung | Typ |
---|---|---|
filename |
Schreiben Sie das Überwachungsprotokoll des Pools in Dateiname | Erforderlich |
since |
Bestimmtes Datum/Uhrzeit | Optional |
audit-log-get
xe audit-log-get [since=timestamp] filename=filename
<!--NeedCopy-->
Führen Sie z. B. den folgenden Befehl aus, um Überwachungsdatensätze des Pools seit einem genauen Zeitstempel von einer Millisekunde abzurufen:
Führen Sie den folgenden Befehl aus:
xe audit-log-get since=2009-09-24T17:56:20.530Z filename=/tmp/auditlog-pool-actions.out
<!--NeedCopy-->
Bonding-Befehle
Befehle für die Arbeit mit Netzwerkbindungen, für Ausfallsicherheit bei Failover physischer Schnittstellen. Weitere Informationen finden Sie unter Vernetzung.
Das Bindungsobjekt ist ein Referenzobjekt, das zusammenklebt Meister und Mitglied PIFs. Der Master-PIF ist die Bonding-Schnittstelle, die als Gesamt-PIF verwendet werden muss, um auf die Bindung zu verweisen. Bei den Member-PIFs handelt es sich um einen Satz von zwei oder mehr physischen Schnittstellen, die in der gebundenen High-Level-Schnittstelle kombiniert wurden.
Parameter der Anleihe
Anleihen haben die folgenden Parameter:
Parametername | Beschreibung | Typ |
---|---|---|
uuid |
Eindeutiger Identifikator/Objektreferenz für die Anleihe | Lesezugriff |
master |
UUID für die Hauptanleihe PIF | Lesezugriff |
members |
Satz von UUIDs für die zugrunde liegenden gebundenen PIFs | Lesezugriff |
bond-create
xe bond-create network-uuid=network_uuid pif-uuids=pif_uuid_1,pif_uuid_2,...
<!--NeedCopy-->
Erstellen Sie eine gebundene Netzwerkschnittstelle in dem Netzwerk, das aus einer Liste vorhandener PIF-Objekte angegeben wird. Der Befehl schlägt in einem der folgenden Fälle fehl:
- Wenn sich PIFs bereits in einer anderen Anleihe befinden
- Wenn für ein Mitglied ein VLAN-Tag-Set festgelegt ist
- Wenn sich die referenzierten PIFs nicht auf demselben XenServer-Host befinden
- Wenn weniger als 2 PIFs geliefert werden
bond-destroy
xe bond-destroy uuid=bond_uuid
<!--NeedCopy-->
Löscht eine gebundene Schnittstelle, die durch ihre UUID von einem Host angegeben wird.
bond-set-mode
xe bond-set-mode uuid=bond_uuid mode=bond_mode
<!--NeedCopy-->
Ändern Sie den Bindungsmodus.
CD-Befehle
Befehle für die Arbeit mit physischen CD/DVD-Laufwerken auf XenServer-Hosts.
CD-Parameter
CDs haben die folgenden Parameter:
Parametername | Beschreibung | Typ |
---|---|---|
uuid |
Eindeutiger Identifikator/Objektreferenz für die CD | Lesezugriff |
name-label |
Name für die CD | Lesen/Schreiben |
name-description |
Beschreibungstext für die CD | Lesen/Schreiben |
allowed-operations |
Eine Liste der Operationen, die auf dieser CD ausgeführt werden können | Schreibgeschützter Parameter setzen |
current-operations |
Eine Liste der Vorgänge, die derzeit auf dieser CD ausgeführt werden | Schreibgeschützter Parameter setzen |
sr-uuid |
Die eindeutige Kennung/Objektreferenz für die SR, zu der diese CD gehört | Lesezugriff |
sr-name-label |
Der Name für die SR, zu der diese CD gehört | Lesezugriff |
vbd-uuids |
Eine Liste der eindeutigen Bezeichner für die VBDs auf VMs, die eine Verbindung mit dieser CD herstellen | Schreibgeschützter Parameter setzen |
crashdump-uuids |
Nicht auf CDs verwendet. Da Crashdumps nicht auf CDs geschrieben werden können | Schreibgeschützter Parameter setzen |
virtual-size |
Größe der CD, wie sie VMs angezeigt wird (in Bytes) | Lesezugriff |
physical-utilisation |
Menge an physischem Speicherplatz, die das CD-Image auf der SR einnimmt (in Bytes) | Lesezugriff |
type |
Für CDs auf Benutzer festlegen | Lesezugriff |
sharable |
Gibt an, ob das CD-Laufwerk gemeinsam genutzt werden kann. Der Standardwert ist FALSCH . |
Lesezugriff |
read-only |
Gibt an, ob die CD schreibgeschützt ist, wenn FALSCH , ist das Gerät beschreibbar. Gilt immer für CDs. |
Lesezugriff |
storage-lock |
Wert ist STIMMT Wenn dieser Datenträger auf Speicherebene gesperrt ist. |
Lesezugriff |
parent |
Verweis auf die übergeordnete Disk, wenn diese CD Teil einer Kette ist. | Lesezugriff |
missing |
Wert ist STIMMT wenn der SR-Scanvorgang diese CD als nicht auf der Festplatte vorhanden gemeldet hat |
Lesezugriff |
other-config |
Eine Liste von Schlüssel-Wert-Paaren, die zusätzliche Konfigurationsparameter für die CD angeben | Map-Parameter mit Lese-/Schreibzugriff |
location |
Der Pfad, auf dem das Gerät gemountet wird | Lesezugriff |
managed |
Wert ist STIMMT Wenn das Gerät verwaltet wird |
Lesezugriff |
xenstore-data |
Daten, die in die Xenstore Baum |
Schreibgeschützter Map-Parameter |
sm-config |
Namen und Beschreibungen der Konfigurationsschlüssel für Speicher-Manager-Geräte | Schreibgeschützter Map-Parameter |
is-a-snapshot |
Wert ist STIMMT wenn es sich bei dieser Vorlage um einen CD-Snapshot handelt |
Lesezugriff |
snapshot_of |
Die UUID der CD, von der diese Vorlage ein Snapshot ist | Lesezugriff |
snapshots |
Die UUIDs aller Snapshots, die von dieser CD erstellt wurden | Lesezugriff |
snapshot_time |
Der Zeitstempel des Momentaufnahmevorgangs | Lesezugriff |
cd-list
xe cd-list [params=param1,param2,...] [parameter=parameter_value]
<!--NeedCopy-->
Listen Sie die CDs und ISOs (CD-Image-Dateien) auf dem XenServer-Host oder -Pool auf und filtern Sie nach dem optionalen Argument Parameter
.
Wenn das optionale Argument Parameter
verwendet wird, ist der Wert von params ein String, der eine Liste von Parametern dieses Objekts enthält, die Sie anzeigen möchten. Alternativ können Sie das Schlüsselwort alle
, um alle Parameter anzuzeigen. Wann Parameter
nicht verwendet wird, zeigt die zurückgegebene Liste eine Standardteilmenge aller verfügbaren Parameter an.
Optionale Argumente können eine beliebige Anzahl von CD-Parameter am Anfang dieses Abschnitts aufgeführt.
Cluster-Befehle
Befehle für die Arbeit mit Clusterpools.
Clusterpools sind Ressourcenpools, für die die Clusteringfunktion aktiviert ist. Verwenden Sie diese Pools mit GFS2-SRs. Weitere Informationen finden Sie unter Gruppierte Pools
Die Cluster- und Cluster-Host-Objekte können mit den Standardbefehlen für die Objektauflistung (xe cluster-liste
und xe cluster-host-liste
) und die Parameter, die mit den Standardparameterbefehlen bearbeitet wurden. Weitere Informationen finden Sie unter Parameterbefehle auf niedriger Ebene. Befehle für die Arbeit mit Clusterpools.
Cluster-Parameter
Cluster verfügen über die folgenden Parameter:
Parametername | Beschreibung | Typ |
---|---|---|
uuid |
Die eindeutige Kennung/Objektreferenz für den Cluster | Lesezugriff |
cluster-hosts |
Eine Liste der eindeutigen Bezeichner/Objektreferenzen für die Hosts im Cluster | Schreibgeschützter Parameter setzen |
cluster-token |
Der geheime Schlüssel, der von xapi-clusterd wenn es auf anderen Hosts mit sich selbst spricht |
Lesezugriff |
cluster-stack |
Der Technologie-Stack, der die Clustering-Funktionen bereitstellt. Mögliche Werte sind: Corosync . |
Lesezugriff |
allowed-operations |
Listet die Vorgänge auf, die in diesem Zustand zulässig sind. Diese Liste ist nur eine Empfehlung, und der Clusterstatus hat sich möglicherweise geändert, wenn ein Client dieses Feld liest. | Schreibgeschützter Parameter setzen |
current-operations |
Listet die Vorgänge auf, die derzeit ausgeführt werden. Diese Liste ist nur eine Empfehlung, und der Clusterstatus hat sich möglicherweise geändert, wenn ein Client dieses Feld liest. | Schreibgeschützter Parameter setzen |
token-timeout |
Das Corosync Token-Timeout in Sekunden |
Lesezugriff |
token-timeout-coefficient |
Das Corosync Token-Timeout-Koeffizient in Sekunden |
Lesezugriff |
pool-auto-join |
True, wenn neue Poolmitglieder automatisch mit dem Cluster verbunden werden. Dies ist auf STIMMT . |
Lesezugriff |
cluster-config |
Eine Liste von Schlüssel-Wert-Paaren, die zusätzliche Konfigurationsparameter für den Cluster angeben. | Schreibgeschützter Map-Parameter |
other-config |
Eine Liste von Schlüssel-Wert-Paaren, die zusätzliche Konfigurationsparameter für den Cluster angeben. | Map-Parameter mit Lese-/Schreibzugriff |
cluster-host-destroy
xe cluster-host-destroy uuid=host_uuid
<!--NeedCopy-->
Zerstören Sie einen Cluster-Host, und verlassen Sie den Cluster.
cluster-host-disable
xe cluster-host-disable uuid=cluster_uuid
<!--NeedCopy-->
Deaktivieren Sie die Clustermitgliedschaft für einen aktivierten Clusterhost.
cluster-host-enable
xe cluster-host-enable uuid=cluster_uuid
<!--NeedCopy-->
Aktivieren Sie die Clustermitgliedschaft für einen deaktivierten Clusterhost.
cluster-host-force-destroy
xe cluster-host-force-destroy uuid=cluster_host
<!--NeedCopy-->
Zerstören Sie ein Clusterhostobjekt zwangsweise und verlassen Sie den Cluster effektiv.
cluster-pool-create
xe cluster-pool-create network-uuid=network_uuid [cluster-stack=cluster_stack] [token-timeout=token_timeout] [token-timeout-coefficient=token_timeout_coefficient]
<!--NeedCopy-->
Erstellen eines poolweiten Clusters.
cluster-pool-destroy
xe cluster-pool-destroy cluster-uuid=cluster_uuid
<!--NeedCopy-->
Zerstören Sie den poolweiten Cluster. Der Pool ist weiterhin vorhanden, aber er ist nicht mehr gruppiert und kann keine GFS2-SRs mehr verwenden.
cluster-pool-force-destroy
xe cluster-pool-force-destroy cluster-uuid=cluster_uuid
<!--NeedCopy-->
Erzwingen Sie die Zerstörung des poolweiten Clusters.
cluster-pool-resync
xe cluster-pool-resync cluster-uuid=cluster_uuid
<!--NeedCopy-->
Synchronisieren Sie einen Cluster in einem Pool erneut.
Konsolen-Befehle
Befehle für die Arbeit mit Konsolen.
Die Konsolenobjekte können mit dem Standardbefehl für die Objektauflistung (xe console-liste
) und die Parameter, die mit den Standardparameterbefehlen bearbeitet wurden. Weitere Informationen finden Sie unter Parameterbefehle auf niedriger Ebene.
Konsolen-Parameter
Konsolen verfügen über die folgenden Parameter:
Parametername | Beschreibung | Typ |
---|---|---|
uuid |
Die eindeutige Kennung/Objektreferenz für die Konsole | Lesezugriff |
vm-uuid |
Die eindeutige Kennung/Objektreferenz der VM, auf der diese Konsole geöffnet ist | Lesezugriff |
vm-name-label |
Der Name der VM, auf der diese Konsole geöffnet ist | Lesezugriff |
protocol |
Protokoll, das von dieser Konsole verwendet wird. Mögliche Werte sind: VT100 : VT100-Klemme, Ausschreibung : Remote Framebuffer Protocol (wie es in VNC verwendet wird) oder rdp : Remote-Desktop-Protokoll |
Lesezugriff |
location |
URI für den Konsolendienst | Lesezugriff |
other-config |
Eine Liste von Schlüssel-Wert-Paaren, die zusätzliche Konfigurationsparameter für die Konsole angeben. | Map-Parameter mit Lese-/Schreibzugriff |
console
xe console
<!--NeedCopy-->
An eine bestimmte Konsole anfügen.
Diagnose-Befehle
Befehle zum Sammeln von Diagnoseinformationen von XenServer.
diagnostic-compact
xe diagnostic-compact
<!--NeedCopy-->
Führen Sie eine umfassende GC-Sammlung und Heapkomprimierung durch.
diagnostic-db-stats
xe diagnostic-db-stats
<!--NeedCopy-->
Drucken von Datenbankstatistiken.
diagnostic-gc-stats
xe diagnostic-gc-stats
<!--NeedCopy-->
Drucken Sie GC-Statistiken.
diagnostic-license-status
xe diagnostic-license-status
<!--NeedCopy-->
Helfen Sie bei der Diagnose von Lizenzierungsproblemen im gesamten Pool.
diagnostic-net-stats
xe diagnostic-net-stats [uri=uri] [method=method] [params=param1,param2...]
<!--NeedCopy-->
Drucken Sie Netzwerkstatistiken.
diagnostic-timing-stats
xe diagnostic-timing-stats
<!--NeedCopy-->
Drucken von Timing-Statistiken.
diagnostic-vdi-status
xe diagnostic-vdi-status uuid=vdi_uuid
<!--NeedCopy-->
Fragen Sie den Sperr- und Freigabestatus eines VDI ab.
diagnostic-vm-status
xe diagnostic-vm-status uuid=vm_uuid
<!--NeedCopy-->
Fragen Sie die Hosts ab, auf denen die VM gestartet werden kann, und überprüfen Sie den Freigabe-/Sperrstatus aller VBDs.
Befehle zur Notfallwiederherstellung
Befehle zum Wiederherstellen von VMs nach einer Katastrophe
drtask-create
xe drtask-create type=type sr-whitelist=sr-white-list device-config=device-config
<!--NeedCopy-->
Erstellt eine Disaster Recovery-Aufgabe. So stellen Sie beispielsweise eine Verbindung zu einer iSCSI-SR her, um die Notfallwiederherstellung vorzubereiten:
xe drtask-create type=lvmoiscsi device-config:target=target-ip-address \
device-config:targetIQN=targetIQN device-config:SCSIid=SCSIid \
sr-whitelist=sr-uuid-list
<!--NeedCopy-->
Hinweis:
Der Befehl
sr-whitelist
listet SR-UUIDs auf, die zulässig sind. Dasdrtask-erstellen
führt nur eine SR ein und verbindet sich mit diesem, der eine der erlaubten UUIDs hat
drtask-destroy
xe drtask-destroy uuid=dr-task-uuid
<!--NeedCopy-->
Zerstört eine Disaster Recovery-Aufgabe und vergisst die eingeführte SR.
vm-assert-can-be-recovered
xe vm-assert-can-be-recovered uuid=vm-uuid database:vdi-uuid=vdi-uuid
<!--NeedCopy-->
Überprüft, ob Speicher für die Wiederherstellung dieser VM verfügbar ist.
appliance-assert-can-be-recovered
xe appliance-assert-can-be-recovered uuid=appliance-uuid database:vdi-uuid=vdi-uuid
<!--NeedCopy-->
Überprüft, ob der Speicher (mit der Festplatte der Appliance/vAPP) sichtbar ist.
appliance-recover
xe appliance-recover uuid=appliance-uuid database:vdi-uuid=vdi-uuid [force=true|false]
<!--NeedCopy-->
Stellen Sie eine Appliance/vAPP aus der Datenbank wieder her, die im bereitgestellten VDI enthalten ist.
vm-recover
xe vm-recover uuid=vm-uuid database:vdi-uuid=vdi-uuid [force=true|false]
<!--NeedCopy-->
Stellt eine VM aus der Datenbank wieder her, die in der bereitgestellten VDI enthalten ist.
sr-enable-database-replication
xe sr-enable-database-replication uuid=sr_uuid
<!--NeedCopy-->
Aktiviert die XAPI-Datenbankreplikation auf die angegebene (freigegebene) SR.
sr-disable-database-replication
xe sr-disable-database-replication uuid=sr_uuid
<!--NeedCopy-->
Deaktiviert die XAPI-Datenbankreplikation auf die angegebene SR.
Anwendungsbeispiel
Das folgende Beispiel zeigt die DR CLI-Befehle im Kontext:
Aktivieren Sie am primären Standort die Datenbankreplikation:
xe sr-database-replication uuid=sr=uuid
<!--NeedCopy-->
Stellen Sie nach einem Notfall am sekundären Standort eine Verbindung mit der SR her. Das Gerät-Konfiguration
hat die gleichen Felder wie SR-Sonde
.
xe drtask-create type=lvmoiscsi \
device-config:target=target ip address \
device-config:targetIQN=target-iqn \
device-config:SCSIid=scsi-id \
sr-whitelist=sr-uuid
<!--NeedCopy-->
Suchen Sie auf der SR nach Datenbank-VDIs:
xe vdi-list sr-uuid=sr-uuid type=Metadata
<!--NeedCopy-->
Fragen Sie eine Datenbank-VDI nach vorhandenen VMs ab:
xe vm-list database:vdi-uuid=vdi-uuid
<!--NeedCopy-->
Wiederherstellen einer VM:
xe vm-recover uuid=vm-uuid database:vdi-uuid=vdi-uuid
<!--NeedCopy-->
Zerstören Sie die DR-Aufgabe. Alle SRs, die von der DR-Aufgabe eingeführt wurden und von VMs nicht benötigt werden, werden zerstört:
xe drtask-destroy uuid=drtask-uuid
<!--NeedCopy-->
Ereignis-Befehle
Befehle zum Arbeiten mit Ereignissen.
Event-Klassen
Ereignisklassen sind in der folgenden Tabelle aufgeführt:
Name der Klasse | Beschreibung |
---|---|
pool |
Ein Pool physischer Hosts |
vm |
Eine virtuelle Maschine |
host |
Ein physischer Host |
network |
Ein virtuelles Netzwerk |
vif |
Eine virtuelle Netzwerkschnittstelle |
pif |
Eine physische Netzwerkschnittstelle (separate VLANs werden als mehrere PIFs dargestellt) |
sr |
Ein Speicher-Repository |
vdi |
Ein virtuelles Disk-Image |
vbd |
Ein virtuelles Blockgerät |
pbd |
Die physischen Blockgeräte, über die Hosts auf SRs zugreifen |
event-wait
xe event-wait class=class_name [param-name=param_value] [param-name=/=param_value]
<!--NeedCopy-->
Blockiert die Ausführung anderer Befehle, bis ein Objekt vorhanden ist, das die in der Befehlszeile angegebenen Bedingungen erfüllt. Das Argument x=y
bedeutet “warten, bis Feld x den Wert y annimmt” und x=/=y
bedeutet “Warten, bis Feld X einen anderen Wert als y annimmt”.
Beispiel: Warten Sie, bis eine bestimmte VM ausgeführt wird.
xe event-wait class=vm name-label=myvm power-state=running
<!--NeedCopy-->
Blockiert andere Befehle, bis eine VM aufgerufen wird myvm
befindet sich in der Energie-Zustand
“Laufen.”
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)
<!--NeedCopy-->
Blockiert andere Befehle, bis eine VM mit UUID $VM Neustarts. Der Befehl verwendet den Wert von Startzeit
, um zu entscheiden, wann die VM neu gestartet wird.
Der Klassenname kann einer der folgenden sein: Event-Klassen am Anfang dieses Abschnitts aufgeführt. Bei den Parametern kann es sich um einen der Parameter handeln, die im CLI-Befehl aufgeführt sind Klasse-param-list.
GPU-Befehle
Befehle für die Arbeit mit physischen GPUs, GPU-Gruppen und virtuellen GPUs.
Die GPU-Objekte können mit den Standardbefehlen für die Objektauflistung aufgelistet werden: xe pgpu-liste
, xe gpu-gruppe-liste
und xe vgpu-liste
. Die Parameter können mit den Standard-Parameterbefehlen manipuliert werden. Weitere Informationen finden Sie unter Parameterbefehle auf niedriger Ebene.
Physikalische GPU-Parameter
Physische GPUs (pGPUs) haben die folgenden Parameter:
Parametername | Beschreibung | Typ |
---|---|---|
uuid |
Die eindeutige Kennung/Objektreferenz für die pGPU | Lesezugriff |
vendor-name |
Der Name des Herstellers der pGPU | Lesezugriff |
device-name |
Der Name, den der Anbieter diesem pGPU-Modell zugewiesen hat | Lesezugriff |
gpu-group-uuid |
Die eindeutige Kennung/Objektreferenz für die GPU-Gruppe, der diese pGPU automatisch von XenServer zugewiesen wurde. Identische pGPUs auf allen Hosts in einem Pool werden gruppiert | Lesezugriff |
gpu-group-name-label |
Der Name der GPU-Gruppe, der die pGPU zugewiesen ist | Lesezugriff |
host-uuid |
Die eindeutige Kennung/Objektreferenz für den XenServer-Host, mit dem die pGPU verbunden ist | Lesezugriff |
host-name-label |
Der Name des XenServer-Hosts, mit dem die pGPU verbunden ist | Lesezugriff |
pci-id |
PCI-Kennung | Lesezugriff |
dependencies |
Listet die abhängigen PCI-Geräte auf, die an dieselbe VM übergeben wurden | Map-Parameter mit Lese-/Schreibzugriff |
other-config |
Eine Liste von Schlüssel-Wert-Paaren, die zusätzliche Konfigurationsparameter für die pGPU angeben | Map-Parameter mit Lese-/Schreibzugriff |
supported-VGPU-types |
Liste der virtuellen GPU-Typen, die von der zugrunde liegenden Hardware unterstützt werden | Lesezugriff |
enabled-VGPU-types |
Liste der virtuellen GPU-Typen, die für diese pGPU aktiviert wurden | Lesen/Schreiben |
resident-VGPUs |
Liste der vGPUs, die auf dieser pGPU ausgeführt werden | Lesezugriff |
pgpu-disable-dom0-access
xe pgpu-disable-dom0-access uuid=uuid
<!--NeedCopy-->
Deaktivieren Sie den PGPU-Zugriff auf dom0.
pgpu-enable-dom0-access
xe pgpu-enable-dom0-access uuid=uuid
<!--NeedCopy-->
Aktivieren Sie den PGPU-Zugriff auf dom0.
Parameter der GPU-Gruppe
GPU-Gruppen haben die folgenden Parameter:
Parametername | Beschreibung | Typ |
---|---|---|
uuid |
Die eindeutige Kennung/Objektreferenz für die GPU-Gruppe | Lesezugriff |
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ützter Parameter setzen |
PGPU-uuids |
Listet die eindeutigen Bezeichner/Objektreferenzen für die pGPUs in der GPU-Gruppe auf. | Schreibgeschützter Parameter setzen |
other-config |
Eine Liste von Schlüssel-Wert-Paaren, die zusätzliche Konfigurationsparameter für die GPU-Gruppe angeben | Map-Parameter mit Lese-/Schreibzugriff |
supported-VGPU-types |
Vereinigung aller virtuellen GPU-Typen, die von der zugrunde liegenden Hardware unterstützt werden | Lesezugriff |
enabled-VGPU-types |
Vereinigung aller virtuellen GPU-Typen, die auf den zugrunde liegenden pGPUs aktiviert wurden | Lesezugriff |
allocation-algorithm |
Einstellung “Depth-first/Width-first” für die Zuweisung virtueller GPUs auf pGPUs innerhalb der Gruppe | Enumerationsparameter mit Lese-/Schreibzugriff |
Vorgänge für GPU-Gruppen
Befehle für die Arbeit mit GPU-Gruppen
gpu-group-create
xe gpu-group-create name-label=name_for_group [name-description=description]
<!--NeedCopy-->
Erstellt eine neue (leere) GPU-Gruppe, in die pGPUs verschoben werden können.
gpu-group-destroy
xe gpu-group-destroy uuid=uuid_of_group
<!--NeedCopy-->
Zerstört die GPU-Gruppe. Nur für leere Gruppen zulässig.
gpu-group-get-remaining-capacity
xe gpu-group-get-remaining-capacity uuid=uuid_of_group vgpu-type-uuid=uuid_of_vgpu_type
<!--NeedCopy-->
Gibt zurück, wie viele weitere virtuelle GPUs des angegebenen Typs in dieser GPU-Gruppe instanziiert werden können.
gpu-group-param-set
xe gpu-group-param-set uuid=uuid_of_group allocation-algorithm=breadth-first|depth-first
<!--NeedCopy-->
Ändert den Algorithmus, den die GPU-Gruppe zum Zuordnen virtueller GPUs zu pGPUs verwendet.
Parameter der virtuellen GPU
Virtuelle GPUs verfügen über die folgenden Parameter:
Parametername | Beschreibung | Typ |
---|---|---|
uuid |
Die eindeutige Kennung/Objektreferenz für die virtuelle GPU | Lesezugriff |
vm-uuid |
Die eindeutige Kennung/Objektreferenz für die VM, der die virtuelle GPU zugewiesen ist | Lesezugriff |
vm-name-label |
Der Name der VM, der die virtuelle GPU zugewiesen ist | Lesezugriff |
gpu-group-uuid |
Die eindeutige Kennung/Objektreferenz für die GPU-Gruppe, in der die virtuelle GPU enthalten ist | Lesezugriff |
gpu-group-name-label |
Der Name der GPU-Gruppe, in der die virtuelle GPU enthalten ist | Lesezugriff |
currently-attached |
True, wenn eine VM mit GPU-Passthrough ausgeführt wird, andernfalls false | Lesezugriff |
other-config |
Eine Liste von Schlüssel-Wert-Paaren, die zusätzliche Konfigurationsparameter für die virtuelle GPU angeben | Map-Parameter mit Lese-/Schreibzugriff |
type-uuid |
Die eindeutige Kennung/Objektreferenz für den virtuellen GPU-Typ dieser virtuellen GPU | Map-Parameter mit Lese-/Schreibzugriff |
type-model-name |
Modellname, der dem virtuellen GPU-Typ zugeordnet ist | Lesezugriff |
Parameter für den Typ der virtuellen GPU
Hinweis:
GPU-Passthrough und virtuelle GPUs sind nicht mit der Livemigration, der Speicher-Livemigration oder dem VM-Suspend kompatibel, es sei denn, es sind unterstützte Software und Grafikkarten von GPU-Anbietern vorhanden. VMs ohne diese Unterstützung können nicht migriert werden, um Ausfallzeiten zu vermeiden. Weitere Informationen zur Kompatibilität von NVIDIA vGPU mit Live-Migration, Speicher-Livemigration und VM-Suspend finden Sie unter Graphik.
Virtuelle GPU-Typen verfügen über die folgenden Parameter:
Parametername | Beschreibung | Typ |
---|---|---|
uuid |
Die eindeutige Kennung/Objektreferenz für den virtuellen GPU-Typ | Lesezugriff |
vendor-name |
Name des Anbieters der virtuellen GPU | Lesezugriff |
model-name |
Modellname, der dem virtuellen GPU-Typ zugeordnet ist | Lesezugriff |
freeze-frame |
Größe des Frame-Puffers des virtuellen GPU-Typs in Byte | Lesezugriff |
max-heads |
Maximale Anzahl von Displays, die vom Typ der virtuellen GPU unterstützt werden | Lesezugriff |
supported-on-PGPUs |
Liste der pGPUs, die diesen virtuellen GPU-Typ unterstützen | Lesezugriff |
enabled-on-PGPUs |
Liste der pGPUs, für die dieser virtuelle GPU-Typ aktiviert ist | Lesezugriff |
VGPU-uuids |
Liste der virtuellen GPUs dieses Typs | Lesezugriff |
Virtuelle GPU-Operationen
vgpu-create
xe vgpu-create vm-uuid=uuid_of_vm gpu_group_uuid=uuid_of_gpu_group [vgpu-type-uuid=uuid_of_vgpu-type]
<!--NeedCopy-->
Erstellt eine virtuelle GPU. Mit diesem Befehl wird die VM an die angegebene GPU-Gruppe angefügt und optional der virtuelle GPU-Typ angegeben. Wenn kein virtueller GPU-Typ angegeben ist, wird der “Pass-Through”-Typ angenommen.
vgpu-destroy
xe vgpu-destroy uuid=uuid_of_vgpu
<!--NeedCopy-->
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
<!--NeedCopy-->
Benutzend FALSCH
Deaktiviert die VNC-Konsole für eine VM, wenn sie disablevnc=1
bis zum Anzeigeemulator. Standardmäßig ist VNC aktiviert.
Host-Befehle
Befehle für die Interaktion mit dem XenServer-Host.
XenServer-Hosts sind die physischen Server, auf denen die XenServer-Software ausgeführt wird. Sie verfügen über VMs, die unter der Kontrolle eines speziellen privilegierten virtuellen Computers ausgeführt werden, der als Steuerdomäne oder Domäne 0 bezeichnet wird.
Die XenServer-Hostobjekte können mit den Standardbefehlen für die Objektauflistung aufgelistet werden: xe host-liste
, xe host-cpu-liste
und xe host-crashdump-liste
). Die Parameter können mit den Standard-Parameterbefehlen manipuliert werden. Weitere Informationen finden Sie unter Parameterbefehle auf niedriger Ebene.
Host-Selektoren
Mehrere der hier aufgeführten Befehle verfügen über einen gemeinsamen Mechanismus zum Auswählen eines oder mehrerer XenServer-Hosts, auf denen der Vorgang ausgeführt werden soll. Am einfachsten ist es, das Argument anzugeben host=uuid_or_name_label
. Sie können XenServer auch angeben, indem Sie die vollständige Liste der Hosts nach den Werten von Feldern filtern. Wenn Sie z. B. aktiviert=wahr
wählt alle XenServer-Hosts aus, deren ermöglichte
Feld ist gleich STIMMT
. Wenn mehrere XenServer-Hosts übereinstimmen und der Vorgang auf mehreren XenServer-Hosts ausgeführt werden kann, müssen Sie angeben --mehrfach
, um den Vorgang auszuführen. Die vollständige Liste der Parameter, die abgeglichen werden können, wird am Anfang dieses Abschnitts beschrieben. Sie können diese Liste von Befehlen abrufen, indem Sie den Befehl xe host-list params=alle
. Wenn keine Parameter zum Auswählen von XenServer-Hosts angegeben werden, wird der Vorgang auf allen XenServer-Hosts ausgeführt.
Host-Parameter
XenServer-Hosts haben die folgenden Parameter:
Parametername | Beschreibung | Typ |
---|---|---|
uuid |
Die eindeutige Kennung/Objektreferenz für den XenServer-Host | Lesezugriff |
name-label |
Der Name des XenServer-Hosts | Lesen/Schreiben |
name-description |
Die Beschreibungszeichenfolge des XenServer-Hosts | Lesezugriff |
enabled |
Wert ist FALSCH wenn deaktiviert. Dadurch wird verhindert, dass neue VMs auf den Hosts gestartet werden, und die Hosts werden auf das Herunterfahren oder Neustarten vorbereitet. Wert ist STIMMT Wenn der Host aktiviert ist |
Lesezugriff |
API-version-major |
Nummer der Hauptversion | Lesezugriff |
API-version-minor |
Kleinere Versionsnummer | Lesezugriff |
API-version-vendor |
Identifizierung des API-Anbieters | Lesezugriff |
API-version-vendor-implementation |
Details zur Implementierung des Anbieters | Schreibgeschützter Map-Parameter |
logging |
Protokollierungskonfiguration | Map-Parameter mit Lese-/Schreibzugriff |
suspend-image-sr-uuid |
Die eindeutige Kennung/Objektreferenz für die SR, in der angehaltene Bilder abgelegt werden | Lesen/Schreiben |
crash-dump-sr-uuid |
Die eindeutige Kennung/Objektreferenz für die SR, in der Absturzabbilder abgelegt werden | Lesen/Schreiben |
software-version |
Liste der Versionierungsparameter und ihrer Werte | Schreibgeschützter Map-Parameter |
capabilities |
Liste der Xen-Versionen, die der XenServer-Host ausführen kann | Schreibgeschützter Parameter setzen |
other-config |
Eine Liste von Schlüssel-Wert-Paaren, die zusätzliche Konfigurationsparameter für den XenServer-Host angeben | Map-Parameter mit Lese-/Schreibzugriff |
chipset-info |
Eine Liste von Schlüssel-Wert-Paaren, die Informationen über den Chipsatz angeben | Schreibgeschützter Map-Parameter |
hostname |
Hostname des XenServer-Hosts | Lesezugriff |
address |
IP-Adresse des XenServer-Hosts | Lesezugriff |
license-server |
Eine Liste von Schlüssel-Wert-Paaren, die Informationen über den Lizenzserver angeben. Der Standardport für die Kommunikation mit Citrix-Produkten ist 27000. Informationen zum Ändern von Portnummern aufgrund von Konflikten finden Sie unter Portnummern ändern | Schreibgeschützter Map-Parameter |
supported-bootloaders |
Liste der Bootloader, die der XenServer-Host unterstützt, z. B. Pygrub , Elilader
|
Schreibgeschützter Parameter setzen |
memory-total |
Gesamtmenge an physischem RAM auf dem XenServer-Host in Byte | Lesezugriff |
memory-free |
Gesamtmenge des verbleibenden physischen RAM, der VMs zugewiesen werden kann, in Byte | Lesezugriff |
host-metrics-live |
True, wenn der Host betriebsbereit ist | Lesezugriff |
logging |
Das syslog_destination key kann auf den Hostnamen eines remote lauschenden Syslog-Dienstes festgelegt werden. |
Map-Parameter mit Lese-/Schreibzugriff |
allowed-operations |
Listet die Vorgänge auf, die in diesem Zustand zulässig sind. Diese Liste ist nur eine Empfehlung, und der Hoststatus kann sich geändert haben, wenn ein Client dieses Feld liest. | Schreibgeschützter Parameter setzen |
current-operations |
Listet die Vorgänge auf, die derzeit ausgeführt werden. Diese Liste ist nur eine Empfehlung, und der Hoststatus kann sich geändert haben, wenn ein Client dieses Feld liest. | Schreibgeschützter Parameter setzen |
patches |
Satz von Host-Patches | Schreibgeschützter Parameter setzen |
blobs |
Binärer Datenspeicher | Lesezugriff |
memory-free-computed |
Eine konservative Schätzung der maximal freien Speichermenge auf einem Host | Lesezugriff |
ha-statefiles |
Die UUIDs aller HA-Statusdateien | Lesezugriff |
ha-network-peers |
Die UUIDs aller Hosts, die die VMs auf diesem Host hosten können, wenn ein Fehler auftritt | Lesezugriff |
external-auth-type |
Typ der externen Authentifizierung, z. B. Active Directory. | Lesezugriff |
external-auth-service-name |
Der Name des externen Authentifizierungsdienstes | Lesezugriff |
external-auth-configuration |
Konfigurationsinformationen für den externen Authentifizierungsdienst. | Schreibgeschützter Map-Parameter |
XenServer-Hosts enthalten einige andere Objekte, die ebenfalls über Parameterlisten verfügen.
CPUs auf XenServer-Hosts haben die folgenden Parameter:
Parametername | Beschreibung | Typ |
---|---|---|
uuid |
Die eindeutige Kennung/Objektreferenz für die CPU | Lesezugriff |
number |
Die Anzahl der physischen CPU-Kerne innerhalb des XenServer-Hosts | Lesezugriff |
vendor |
Die Herstellerzeichenfolge für den CPU-Namen | Lesezugriff |
speed |
Die CPU-Taktfrequenz in Hz | Lesezugriff |
modelname |
Die Herstellerzeichenfolge für das CPU-Modell, z. B. “Intel(R) Xeon(TM) CPU 3,00 GHz” | Lesezugriff |
stepping |
Die CPU-Revisionsnummer | Lesezugriff |
flags |
Die Flags der physischen CPU (eine dekodierte Version des Funktionsfelds) | Lesezugriff |
Utilisation |
Die aktuelle CPU-Auslastung | Lesezugriff |
host-uuid |
Die UUID, wenn es sich um den Host handelt, auf dem sich die CPU befindet | Lesezugriff |
model |
Die Modellnummer der physischen CPU | Lesezugriff |
family |
Die Nummer der physischen CPU-Familie | Lesezugriff |
Absturzabbilder auf XenServer-Hosts haben die folgenden Parameter:
Parametername | Beschreibung | Typ |
---|---|---|
uuid |
Die eindeutige Kennung/Objektreferenz für den Crashdump | Lesezugriff |
host |
XenServer-Host, dem der Crashdump entspricht | Lesezugriff |
timestamp |
Zeitstempel des Datums und der Uhrzeit, zu der das Crashdump aufgetreten ist, in der Form yyyymmdd-hhmmss-ABC wo ABC ist der Zeitzonenindikator, z. B. GMT |
Lesezugriff |
size |
Größe des Absturzabbilds in Byte | Lesezugriff |
host-all-editions
xe host-all-editions
<!--NeedCopy-->
Abrufen einer Liste aller verfügbaren Editionen
host-apply-edition
xe host-apply-edition [host-uuid=host_uuid] [edition=xenserver_edition="free" "per-socket" "xendesktop"]
<!--NeedCopy-->
Weist die XenServer-Lizenz einem Hostserver zu. Wenn Sie eine Lizenz zuweisen, kontaktiert XenServer den Lizenzserver und fordert den angegebenen Lizenztyp an. Wenn eine Lizenz verfügbar ist, wird diese vom Lizenzserver ausgecheckt.
Für die Erstkonfiguration der Lizenzierung siehe auch license-server-adresse
und license-server-port
.
host-backup
xe host-backup file-name=backup_filename host=host_name
<!--NeedCopy-->
Laden Sie eine Sicherung der Steuerdomäne des angegebenen XenServer-Hosts auf die Maschine herunter, von der aus der Befehl aufgerufen wird. Speichern Sie es dort als Datei mit dem Namen Dateiname
.
Wichtig:
Während die
xe host-backup
Der Befehl funktioniert, wenn er auf dem lokalen Host ausgeführt wird (d. h. ohne Angabe eines bestimmten Hostnamens), verwenden Sie ihn nicht auf diese Weise. Dadurch wird die Partition der Steuerdomäne mit der Sicherungsdatei gefüllt. Verwenden Sie den Befehl nur von einem Remote-Computer außerhalb des Hosts, auf dem Sie über Speicherplatz für die Sicherungsdatei verfügen.
host-bugreport-upload
xe host-bugreport-upload [host-selector=host_selector_value...] [url=destination_url http-proxy=http_proxy_name]
<!--NeedCopy-->
Generieren Sie einen neuen Fehlerbericht (mit xen-bugtool
, mit allen optionalen Dateien) und laden Sie sie auf die Support-FTP-Site oder an einen anderen Ort hoch.
Die Hosts, auf denen diese Operation ausgeführt werden soll, werden mit dem Standard-Selektionsmechanismus ausgewählt (siehe Host-Selektoren oben). Optionale Argumente können eine beliebige Anzahl von Host-Parameter am Anfang dieses Abschnitts aufgeführt.
Optionale Parameter sind http-proxy
: den angegebenen HTTP-Proxy verwenden und URL (Englisch)
: Hochladen auf diese 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
xe host-call-plugin host-uuid=host_uuid plugin=plugin fn=function [args=args]
<!--NeedCopy-->
Ruft die Funktion innerhalb des Plug-ins auf dem angegebenen Host mit optionalen Argumenten auf.
host-compute-free-memory
xe host-compute-free-memory
<!--NeedCopy-->
Berechnet die Menge des freien Arbeitsspeichers auf dem Host.
host-compute-memory-overhead
xe host-compute-memory-overhead
<!--NeedCopy-->
Berechnet den Virtualisierungsspeicher-Overhead eines Hosts.
host-cpu-info
xe host-cpu-info [uuid=uuid]
<!--NeedCopy-->
Listet Informationen zu den physischen CPUs des Hosts auf.
host-crashdump-destroy
xe host-crashdump-destroy uuid=crashdump_uuid
<!--NeedCopy-->
Löschen Sie einen Host-Crashdump, der durch seine UUID angegeben ist, vom XenServer-Host.
host-crashdump-upload
xe host-crashdump-upload uuid=crashdump_uuid [url=destination_url] [http-proxy=http_proxy_name]
<!--NeedCopy-->
Laden Sie einen Crashdump auf die FTP-Support-Site oder an einen anderen Speicherort hoch. Wenn optionale Parameter nicht verwendet werden, wird kein Proxyserver identifiziert, und das Ziel ist die standardmäßige Support-FTP-Site. Optionale Parameter sind http-proxy
: den angegebenen HTTP-Proxy verwenden und URL (Englisch)
: Hochladen auf diese Ziel-URL.
host-declare-dead
xe host-declare-dead uuid=host_uuid
<!--NeedCopy-->
Deklarieren Sie, dass der Host tot ist, ohne ihn explizit zu kontaktieren.
Warnung:
Dieser Aufruf ist gefährlich und kann zu Datenverlust führen, wenn der Host nicht wirklich tot ist.
host-disable
xe host-disable [host-selector=host_selector_value...]
<!--NeedCopy-->
Deaktiviert die angegebenen XenServer-Hosts, wodurch verhindert wird, dass neue VMs auf ihnen gestartet werden. Diese Aktion bereitet das Herunterfahren oder Neustarten der XenServer-Hosts vor. Wenn nach dem Neustart des Hosts alle Bedingungen für die Aktivierung erfüllt sind (z. B. Speicher ist verfügbar), wird der Host automatisch wieder aktiviert.
Die Hosts, auf denen diese Operation ausgeführt werden soll, werden mit dem Standard-Selektionsmechanismus ausgewählt (siehe Host-Selektoren). Optionale Argumente können eine beliebige Anzahl von Host-Parameter am Anfang dieses Abschnitts aufgeführt.
host-disable-display
xe host-disable-display uuid=host_uuid
<!--NeedCopy-->
Deaktivieren Sie die Anzeige für den Host.
host-disable-local-storage-caching
xe host-disable-local-storage-caching
<!--NeedCopy-->
Deaktivieren Sie das Caching des lokalen Speichers auf dem angegebenen Host.
host-dmesg
xe host-dmesg [host-selector=host_selector_value...]
<!--NeedCopy-->
Holen Sie sich einen Xen dmesg
(die Ausgabe des Kernel-Ringpuffers) von angegebenen XenServer-Hosts.
Die Hosts, auf denen diese Operation ausgeführt werden soll, werden mit dem Standard-Selektionsmechanismus ausgewählt (siehe Host-Selektoren oben). Optionale Argumente können eine beliebige Anzahl von Host-Parameter am Anfang dieses Abschnitts aufgeführt.
host-emergency-ha-disable
xe host-emergency-ha-disable [--force]
<!--NeedCopy-->
Deaktivieren Sie HA auf dem lokalen Host. Nur zur Wiederherstellung eines Pools mit einem fehlerhaften HA-Setup.
host-emergency-management-reconfigure
xe host-emergency-management-reconfigure interface=uuid_of_management_interface_pif
<!--NeedCopy-->
Konfigurieren Sie die Verwaltungsschnittstelle dieses XenServer-Hosts neu. Verwenden Sie diesen Befehl nur, wenn sich der XenServer-Host im Notfallmodus befindet. Der Notfallmodus bedeutet, dass der Host Mitglied in einem Ressourcenpool ist, dessen Poolkoordinator aus dem Netzwerk verschwunden ist und nach einer Reihe von Wiederholungen nicht kontaktiert werden kann.
host-emergency-reset-server-certificate
xe host-emergency-reset-server-certificate
<!--NeedCopy-->
Installiert ein selbstsigniertes Zertifikat auf dem XenServer-Host, auf dem der Befehl ausgeführt wird.
host-enable
xe host-enable [host-selector=host_selector_value...]
<!--NeedCopy-->
Aktiviert die angegebenen XenServer-Hosts, sodass neue VMs auf ihnen gestartet werden können.
Die Hosts, auf denen diese Operation ausgeführt werden soll, werden mit dem Standard-Selektionsmechanismus ausgewählt (siehe Host-Selektoren oben). Optionale Argumente können eine beliebige Anzahl von Host-Parameter am Anfang dieses Abschnitts aufgeführt.
host-enable-display
xe host-enable-display uuid=host_uuid
<!--NeedCopy-->
Aktivieren Sie die Anzeige für den Host.
host-enable-local-storage-caching
xe host-enable-local-storage-caching sr-uuid=sr_uuid
<!--NeedCopy-->
Aktivieren Sie das Caching des lokalen Speichers auf dem angegebenen Host.
host-evacuate
xe host-evacuate [host-selector=host_selector_value...]
<!--NeedCopy-->
Live migriert alle ausgeführten VMs zu anderen geeigneten Hosts in einem Pool. Deaktivieren Sie zunächst den Host, indem Sie die host-deaktivieren
Befehl.
Wenn der evakuierte Host der Pool-Koordinator ist, muss ein anderer Host als Pool-Koordinator ausgewählt werden. Um den Poolkoordinator mit deaktivierter HA zu ändern, verwenden Sie die Schaltfläche pool-designat-new-master
Befehl. Weitere Informationen finden Sie unter pool-designat-new-master.
Wenn HA aktiviert ist, besteht Ihre einzige Möglichkeit darin, den XenServer-Host herunterzufahren, was dazu führt, dass HA nach dem Zufallsprinzip einen neuen Poolkoordinator auswählt. Weitere Informationen finden Sie unter Herunterfahren des Hosts.
Die Hosts, auf denen diese Operation ausgeführt werden soll, werden mit dem Standard-Selektionsmechanismus ausgewählt (siehe Host-Selektoren oben). Optionale Argumente können eine beliebige Anzahl von Host-Parameter am Anfang dieses Abschnitts aufgeführt.
host-forget
xe host-forget uuid=host_uuid
<!--NeedCopy-->
Der XAPI-Agent vergisst den angegebenen XenServer-Host, ohne ihn explizit zu kontaktieren.
Verwenden Sie die Schaltfläche --Kraft
, um zu vermeiden, dass Sie aufgefordert werden, zu bestätigen, dass Sie diesen Vorgang wirklich ausführen möchten.
Warnung:
Verwenden Sie diesen Befehl nicht, wenn HA für den Pool aktiviert ist. Deaktivieren Sie zuerst HA und aktivieren Sie es wieder, nachdem Sie den Host vergessen haben.
Dieser Befehl ist nützlich, wenn der XenServer-Host zum “Vergessen” tot ist. Wenn der XenServer-Host jedoch aktiv und Teil des Pools ist, verwenden Sie xe pool-eject
stattdessen.
host-get-server-certificate
xe host-get-server-certificate
<!--NeedCopy-->
Rufen Sie das installierte TLS-Zertifikat des Servers ab.
host-get-sm-diagnostics
xe host-get-sm-diagnostics uuid=uuid
<!--NeedCopy-->
Zeigen Sie SM-Diagnoseinformationen pro Host an.
host-get-system-status
xe host-get-system-status filename=name_for_status_file [entries=comma_separated_list] [output=tar.bz2|zip] [host-selector=host_selector_value...]
<!--NeedCopy-->
Laden Sie Systemstatusinformationen in die angegebene Datei herunter. Der optionale Parameter Einträge
ist eine durch Kommas getrennte Liste von Systemstatuseinträgen, die aus dem capabilities-XML-Fragment entnommen werden, das vom host-get-systemstatus-capabilities
Befehl. Weitere Informationen finden Sie unter host-get-systemstatus-capabilities. Wenn nicht angegeben, werden alle Informationen zum Systemstatus in der Datei gespeichert. Der Parameter Ausgabe
Kann sein tar.bz2 (die Standardeinstellung) oder schwirren. Wenn dieser Parameter nicht angegeben ist, wird die Datei in tar.bz2
Form.
Die Hosts, auf denen diese Operation ausgeführt werden soll, werden mit dem Standard-Selektionsmechanismus ausgewählt (siehe Host-Selektoren oben).
host-get-system-status-capabilities
xe host-get-system-status-capabilities [host-selector=host_selector_value...]
<!--NeedCopy-->
Abrufen von Systemstatusfunktionen für die angegebenen Hosts. Die Funktionen werden als XML-Fragment zurückgegeben, das dem folgenden Beispiel ähnelt:
<?xml version="1.0" ?>
<system-status-capabilities>
<capability content-type="text/plain" default-checked="yes" key="xenserver-logs" \
max-size="150425200" max-time="-1" min-size="150425200" min-time="-1" \
pii="maybe"/>
<capability content-type="text/plain" default-checked="yes" \
key="xenserver-install" max-size="51200" max-time="-1" min-size="10240" \
min-time="-1" pii="maybe"/>
...
</system-status-capabilities>
<!--NeedCopy-->
Jede Funktionsentität kann über die folgenden Attribute verfügen.
-
Schlüssel
Ein eindeutiger Bezeichner für die Funktion. -
Inhaltstyp
Kann entweder Text/Plain oder Anwendung/Daten sein. Gibt an, ob eine Benutzeroberfläche die Einträge für den menschlichen Gebrauch rendern kann. -
Default-geprüft
Kann entweder ja oder nein sein. Gibt an, ob dieser Eintrag standardmäßig von einer Benutzeroberfläche ausgewählt wird. -
min-Größe
,max. Größe
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-Zeit
,Max-Zeit
Geben Sie einen ungefähren Bereich für die Zeit in Sekunden an, die zum Erfassen dieses Eintrags benötigt wurde. -1 gibt an, dass die Zeit unwichtig ist. -
PII
Persönlich identifizierbare Informationen. Gibt an, ob der Eintrag Informationen zur Identifizierung des Systembesitzers oder Details zur Netzwerk-Topologie enthält. Das Attribut kann einen der folgenden Werte annehmen:-
Nein
: In diesen Einträgen sind keine personenbezogenen Daten enthalten. -
ja
: PII sind wahrscheinlich oder sicher in diesen Einträgen enthalten -
vielleicht
: Möglicherweise möchten Sie diese Einträge auf personenbezogene Daten überprüfen. -
if_customized
Wenn die Dateien unverändert sind, enthalten sie keine personenbezogenen Daten. Da wir jedoch die Bearbeitung dieser Dateien empfehlen, könnten personenbezogene Daten 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 niemals in einen Fehlerbericht aufgenommen werden, unabhängig von einer PII-Deklaration.
-
Die Hosts, auf denen diese Operation ausgeführt werden soll, werden mit dem Standard-Selektionsmechanismus ausgewählt (siehe Host-Selektoren oben).
host-get-thread-diagnostics
xe host-get-thread-diagnostics uuid=uuid
<!--NeedCopy-->
Zeigen Sie Diagnoseinformationen pro Hostthread an.
host-get-vms-which-prevent-evacuation
xe host-get-vms-which-prevent-evacuation uuid=uuid
<!--NeedCopy-->
Gibt eine Liste der VMs zurück, die die Evakuierung eines bestimmten Hosts verhindern, und zeigt die Gründe für jeden Host an.
host-is-in-emergency-mode
xe host-is-in-emergency-mode
<!--NeedCopy-->
Ertrag STIMMT
Wenn sich der Host, mit dem die CLI kommuniziert, im Notfallmodus befindet, FALSCH
sonst. Dieser CLI-Befehl funktioniert direkt auf Poolmitgliedshosts, auch wenn kein Poolkoordinator vorhanden ist.
host-license-view
xe host-license-view [host-uuid=host_uuid]
<!--NeedCopy-->
Zeigt den Inhalt der XenServer-Hostlizenz an.
host-logs-download
xe host-logs-download [file-name=logfile_name] [host-selector=host_selector_value...]
<!--NeedCopy-->
Laden Sie eine Kopie der Protokolle der angegebenen XenServer-Hosts herunter. Die Kopie wird standardmäßig in einer Datei mit Zeitstempel gespeichert, die hostname-yyyy-mm-dd T hh:mm:ssZ.tar.gz
. Sie können einen anderen Dateinamen angeben, indem Sie den optionalen Parameter Dateiname.
Die Hosts, auf denen diese Operation ausgeführt werden soll, werden mit dem Standard-Selektionsmechanismus ausgewählt (siehe Host-Selektoren oben). Optionale Argumente können eine beliebige Anzahl von Host-Parameter am Anfang dieses Abschnitts aufgeführt.
Wichtig:
Während die
xe host-logs-download
Der Befehl funktioniert, wenn er auf dem lokalen Host ausgeführt wird (d. h. ohne Angabe eines bestimmten Hostnamens), do nicht Verwenden Sie es auf diese Weise. Dadurch wird die Partition der Steuerdomäne mit der Kopie der Protokolle überladen. Verwenden Sie den Befehl nur von einem Remote-Computer außerhalb des Hosts, auf dem Sie über Speicherplatz für die Kopie der Protokolle verfügen.
host-management-disable
xe host-management-disable
<!--NeedCopy-->
Deaktiviert den Host-Agenten, der auf einer externen Verwaltungsnetzwerkschnittstelle lauscht, und trennt alle verbundenen API-Clients (z. B. XenCenter). Dieser Befehl wird direkt auf dem XenServer-Host ausgeführt, mit dem die CLI verbunden ist. Der Befehl wird nicht an den Pool-Koordinator weitergeleitet, wenn er auf einen XenServer-Mitgliedshost angewendet wird.
Warnung:
Seien Sie vorsichtig, wenn Sie diesen CLI-Befehl außerhalb des Hosts verwenden. Nachdem dieser Befehl ausgeführt wurde, können Sie keine Remoteverbindung mit der Steuerungsdomäne über das Netzwerk herstellen, um den Host-Agent wieder zu aktivieren.
host-management-reconfigure
xe host-management-reconfigure [interface=device] [pif-uuid=uuid]
<!--NeedCopy-->
Konfiguriert den XenServer-Host neu, um die angegebene Netzwerkschnittstelle als Verwaltungsschnittstelle zu verwenden, bei der es sich um die Schnittstelle handelt, die für die Verbindung mit dem XenCenter verwendet wird. Der Befehl schreibt den MANAGEMENT_INTERFACE Schlüssel in /etc/xensource-inventar
.
Wenn der Gerätename einer Schnittstelle (die eine IP-Adresse haben muss) angegeben wird, bindet der XenServer-Host sofort erneut. Dieser Befehl funktioniert sowohl im normalen als auch im Notfallmodus.
Wenn die UUID eines PIF-Objekts angegeben ist, bestimmt der XenServer-Host, an welche IP-Adresse erneut gebunden werden soll. Er darf sich nicht im Notfallmodus befinden, wenn dieser Befehl ausgeführt wird.
Warnung:
Seien Sie vorsichtig, wenn Sie diesen CLI-Befehl außerhalb des Hosts verwenden, und stellen Sie sicher, dass Sie über eine Netzwerkverbindung auf der neuen Schnittstelle verfügen. Gebrauchen
xe pif-reconfigure
, um zuerst eines einzurichten. Andernfalls können nachfolgende CLI-Befehle den XenServer-Host nicht erreichen.
host-power-on
xe host-power-on [host=host_uuid]
<!--NeedCopy-->
Schaltet das Einschalten von XenServer-Hosts mit der Einschalten des Hosts aktiviert. Bevor Sie diesen Befehl verwenden, aktivieren Sie host-set-einschalten
auf dem Host.
host-reboot
xe host-reboot [host-selector=host_selector_value...]
<!--NeedCopy-->
Starten Sie die angegebenen XenServer-Hosts neu. Die angegebenen Hosts müssen zuerst mit dem Befehl xe host-deaktivieren
Befehl, andernfalls wird ein HOST_IN_USE
Fehlermeldung wird angezeigt.
Die Hosts, auf denen diese Operation ausgeführt werden soll, werden mit dem Standard-Selektionsmechanismus ausgewählt (siehe Host-Selektoren oben). Optionale Argumente können eine beliebige Anzahl von Host-Parameter am Anfang dieses Abschnitts aufgeführt.
Wenn die angegebenen XenServer-Hosts Mitglieder eines Pools sind, wird der Verbindungsverlust beim Herunterfahren behandelt und der Pool wird wiederhergestellt, wenn die XenServer-Hosts zurückgegeben werden. Die anderen Mitglieder und der Poolkoordinator funktionieren weiterhin.
Wenn Sie den Poolkoordinator herunterfahren, ist der Pool außer Betrieb, bis eine der folgenden Aktionen eintritt:
- Sie machen eines der Mitglieder zum Pool-Koordinator
-
Der ursprüngliche Pool-Koordinator wird neu gestartet und ist wieder online.
Wenn der Poolkoordinator wieder online ist, stellen die Mitglieder die Verbindung wieder her und synchronisieren sich mit dem Poolkoordinator.
host-restore
xe host-restore [file-name=backup_filename] [host-selector=host_selector_value...]
<!--NeedCopy-->
Wiederherstellen einer Sicherung mit dem Namen Dateiname
der XenServer-Hoststeuerungssoftware. Die Verwendung des Wortes “Restore” bedeutet hier nicht eine vollständige Wiederherstellung im üblichen Sinne, sondern lediglich, dass die komprimierte Backup-Datei entpackt und auf die sekundäre Partition entpackt wurde. Nachdem Sie eine xe host-restore
, müssen Sie die Installations-CD booten und die Option “Aus Backup wiederherstellen” verwenden.
Die Hosts, auf denen diese Operation ausgeführt werden soll, werden mit dem Standard-Selektionsmechanismus ausgewählt (siehe Host-Selektoren oben). Optionale Argumente können eine beliebige Anzahl von Host-Parameter am Anfang dieses Abschnitts aufgeführt.
host-send-debug-keys
xe host-send-debug-keys host-uuid=host_uuid keys=keys
<!--NeedCopy-->
Senden Sie die angegebenen Hypervisor-Debugschlüssel an den angegebenen Host.
host-server-certificate-install
xe host-server-certificate-install certificate=path_to_certificate_file private-key=path_to_private_key [certificate-chain=path_to_chain_file] [host=host_name | uuid=host_uuid]
<!--NeedCopy-->
Installieren Sie ein TLS-Zertifikat auf einem XenServer-Host.
host-set-hostname-live
xe host-set-hostname-live host-uuid=uuid_of_host host-name=new_hostname
<!--NeedCopy-->
Ändern Sie den Hostnamen des XenServer-Hosts, der durch host-uuid
. Dieser Befehl legt sowohl den Hostnamen in der Steuerungsdomänendatenbank als auch den tatsächlichen Linux-Hostnamen des XenServer-Hosts persistent fest. Der Wert von Name des Hosts
ist nicht entspricht dem Wert der name_label
Feld.
host-set-power-on-mode
xe host-set-power-on-mode host=host_uuid power-on-mode={"" | "wake-on-lan" | "IPMI" | "custom"} \
[ power-on-config:power_on_ip=ip-address power-on-config:power_on_user=user power-on-config:power_on_password_secret=secret-uuid ]
<!--NeedCopy-->
Verwenden Sie diese Option, um die Option Einschalten des Hosts auf XenServer-Hosts, die mit Remote-Stromversorgungslösungen kompatibel sind. Wenn Sie die Funktion host-set-einschalten
müssen Sie den Typ der Energieverwaltungslösung auf dem Host angeben (d. h. den Einschaltmodus). Geben Sie dann Konfigurationsoptionen mit dem power-on-config-Argument und den zugehörigen Schlüssel-Wert-Paaren an.
Um die Funktion “Geheimnisse” zum Speichern Ihres Kennworts zu verwenden, geben Sie den Schlüssel "power_on_password_secret"
. Weitere Informationen finden Sie unter Geheimnisse.
host-shutdown
xe host-shutdown [host-selector=host_selector_value...]
<!--NeedCopy-->
Fahren Sie die angegebenen XenServer-Hosts herunter. Die angegebenen XenServer-Hosts müssen zuerst mit dem Befehl xe host-deaktivieren
Befehl, andernfalls wird ein HOST_IN_USE
Fehlermeldung wird angezeigt.
Die Hosts, auf denen diese Operation ausgeführt werden soll, werden mit dem Standard-Selektionsmechanismus ausgewählt (siehe Host-Selektoren oben). Optionale Argumente können eine beliebige Anzahl von Host-Parameter am Anfang dieses Abschnitts aufgeführt.
Wenn die angegebenen XenServer-Hosts Mitglieder eines Pools sind, wird der Verbindungsverlust beim Herunterfahren behandelt und der Pool wird wiederhergestellt, wenn die XenServer-Hosts zurückgegeben werden. Die anderen Mitglieder und der Poolkoordinator funktionieren weiterhin.
Wenn Sie den Poolkoordinator herunterfahren, ist der Pool außer Betrieb, bis eine der folgenden Aktionen eintritt:
- Sie machen eines der Mitglieder zum Pool-Koordinator
-
Der ursprüngliche Pool-Koordinator wird neu gestartet und ist wieder online.
Wenn der Poolkoordinator wieder online ist, stellen die Mitglieder die Verbindung wieder her und synchronisieren sich mit dem Poolkoordinator.
Wenn HA für den Pool aktiviert ist, wird eines der Mitglieder automatisch zum Pool-Koordinator. Wenn HA deaktiviert ist, müssen Sie den gewünschten XenServer-Host manuell als Pool-Koordinator mit dem pool-designat-new-master
Befehl. Weitere Informationen finden Sie unter pool-designat-new-master.
host-sm-dp-destroy
xe host-sm-dp-destroy uuid=uuid dp=dp [allow-leak=true|false]
<!--NeedCopy-->
Versuchen Sie, einen Speicherdatenpfad auf einem Host zu löschen und zu bereinigen. Wenn allow-leak=wahr
bereitgestellt wird, löscht er alle Datensätze des Datenpfads, auch wenn er nicht sauber heruntergefahren wird.
host-sync-data
xe host-sync-data
<!--NeedCopy-->
Synchronisieren Sie die auf dem Pool-Koordinator gespeicherten Daten mit dem benannten Host. Die Datenbankdaten sind hiervon ausgenommen).
host-syslog-reconfigure
xe host-syslog-reconfigure [host-selector=host_selector_value...]
<!--NeedCopy-->
Konfigurieren Sie die Syslog (Englisch)
Daemon auf den angegebenen XenServer-Hosts. Dieser Befehl wendet die Konfigurationsinformationen an, die auf dem Host definiert sind Protokollierung
Parameter.
Die Hosts, auf denen diese Operation ausgeführt werden soll, werden mit dem Standard-Selektionsmechanismus ausgewählt (siehe Host-Selektoren oben). Optionale Argumente können eine beliebige Anzahl von Host-Parameter am Anfang dieses Abschnitts aufgeführt.
host-data-source-list
xe host-data-source-list [host-selectors=host selector value...]
<!--NeedCopy-->
Listen Sie die Datenquellen auf, die für einen Host aufgezeichnet werden können.
Wählen Sie die Hosts aus, auf denen diese Operation ausgeführt werden soll, indem Sie den Standard-Auswahlmechanismus verwenden (siehe Host-Selektoren). Optionale Argumente können eine beliebige Anzahl von Host-Parameter am Anfang dieses Abschnitts aufgeführt. Wenn keine Parameter zum Auswählen von Hosts angegeben sind, wird der Vorgang auf allen Hosts ausgeführt.
Datenquellen haben zwei Parameter: Norm
und ermöglichte
. Dieser Befehl gibt die Werte der Parameter aus:
- Wenn eine Datenquelle
ermöglichte
aufSTIMMT
, werden die Metriken derzeit in der Performance-Datenbank aufgezeichnet. - Wenn eine Datenquelle
Norm
aufSTIMMT
klicken, werden die Metriken in der Performance-Datenbank aufgezeichnet standardmäßig. Der Wert vonermöglichte
ist auch aufSTIMMT
für diese Datenquelle. - Wenn eine Datenquelle
Norm
aufFALSCH
, sind die Metriken nicht Standardmäßig in der Leistungsdatenbank aufgezeichnet. Der Wert vonermöglichte
ist auch aufFALSCH
für diese Datenquelle.
Um mit der Aufzeichnung von Datenquellenmetriken in der Leistungsdatenbank zu beginnen, führen Sie die host-datenquelle-datensatz
Befehl. Mit diesem Befehl wird ermöglichte
An STIMMT
. Um den Vorgang zu beenden, führen Sie die host-datenquelle-vergessen
. Mit diesem Befehl wird ermöglichte
An FALSCH
.
host-data-source-record
xe host-data-source-record data-source=name_description_of_data_source [host-selectors=host_selector_value...]
<!--NeedCopy-->
Notieren Sie die angegebene Datenquelle für einen Host.
Dieser Vorgang schreibt die Informationen aus der Datenquelle in die Datenbank für persistente Leistungsmetriken der angegebenen Hosts. Aus Leistungsgründen unterscheidet sich diese Datenbank von der normalen Agentendatenbank.
Wählen Sie die Hosts aus, auf denen diese Operation ausgeführt werden soll, indem Sie den Standard-Auswahlmechanismus verwenden (siehe Host-Selektoren). Optionale Argumente können eine beliebige Anzahl von Host-Parameter am Anfang dieses Abschnitts aufgeführt. Wenn keine Parameter zum Auswählen von Hosts angegeben sind, wird der Vorgang auf allen Hosts ausgeführt.
host-data-source-forget
xe host-data-source-forget data-source=name_description_of_data_source [host-selectors=host_selector_value...]
<!--NeedCopy-->
Beenden Sie die Aufzeichnung der angegebenen Datenquelle für einen Host, und vergessen Sie alle aufgezeichneten Daten.
Wählen Sie die Hosts aus, auf denen diese Operation ausgeführt werden soll, indem Sie den Standard-Auswahlmechanismus verwenden (siehe Host-Selektoren). Optionale Argumente können eine beliebige Anzahl von Host-Parameter am Anfang dieses Abschnitts aufgeführt. Wenn keine Parameter zum Auswählen von Hosts angegeben sind, wird der Vorgang auf allen Hosts ausgeführt.
host-data-source-query
xe host-data-source-query data-source=name_description_of_data_source [host-selectors=host_selector_value...]
<!--NeedCopy-->
Zeigt die angegebene Datenquelle für einen Host an.
Wählen Sie die Hosts aus, auf denen diese Operation ausgeführt werden soll, indem Sie den Standard-Auswahlmechanismus verwenden (siehe Host-Selektoren). Optionale Argumente können eine beliebige Anzahl von Host-Parameter am Anfang dieses Abschnitts aufgeführt. Wenn keine Parameter zum Auswählen von Hosts angegeben sind, wird der Vorgang auf allen Hosts ausgeführt.
Befehle für Nachrichten
Befehle zum Arbeiten mit Nachrichten. Nachrichten werden erstellt, um Benutzer über wichtige Ereignisse zu informieren, und werden in XenCenter als Warnungen angezeigt.
Die Message-Objekte können mit dem Standardbefehl für die Objektauflistung (xe Nachrichten-Liste
) und die Parameter, die mit den Standardparameterbefehlen bearbeitet wurden. Weitere Informationen finden Sie unter Parameterbefehle auf niedriger Ebene
Parameter für Nachrichten
Parametername | Beschreibung | Typ |
---|---|---|
uuid |
Die eindeutige Kennung/Objektreferenz für die Nachricht | Lesezugriff |
name |
Der eindeutige Name der Nachricht | Lesezugriff |
priority |
Die Priorität der Nachricht. Höhere Zahlen bedeuten höhere Priorität | Lesezugriff |
class |
Die Nachrichtenklasse, z. B. VM. | Lesezugriff |
obj-uuid |
Die UUID des betroffenen Objekts. | Lesezugriff |
timestamp |
Der Zeitpunkt, zu dem die Nachricht generiert wurde. | Lesezugriff |
body |
Der Inhalt der Nachricht. | Lesezugriff |
message-create
xe message-create name=message_name body=message_text [[host-uuid=uuid_of_host] | [sr-uuid=uuid_of_sr] | [vm-uuid=uuid_of_vm] | [pool-uuid=uuid_of_pool]]
<!--NeedCopy-->
Erstellt eine Nachricht.
message-destroy
xe message-destroy [uuid=message_uuid]
<!--NeedCopy-->
Zerstört eine vorhandene Nachricht. Sie können ein Skript erstellen, um alle Nachrichten zu löschen. Beispiel:
# Dismiss all alerts \
IFS=","; for m in $(xe message-list params=uuid --minimal); do \
xe message-destroy uuid=$m \
done
<!--NeedCopy-->
Netzwerk-Befehle
Befehle für die Arbeit mit Netzwerken.
Die Netzwerkobjekte können mit dem Standardbefehl für die Objektauflistung (xe network-liste
) und die Parameter, die mit den Standardparameterbefehlen bearbeitet wurden. Weitere Informationen finden Sie unter Parameterbefehle auf niedriger Ebene
Netzwerk-Parameter
Netzwerke haben die folgenden Parameter:
Parametername | Beschreibung | Typ |
---|---|---|
uuid |
Die eindeutige Kennung/Objektreferenz für das Netzwerk | Lesezugriff |
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 angehängt sind | Schreibgeschützter Parameter setzen |
PIF-uuids |
Eine Liste der eindeutigen Identifikatoren der PIFs (Physical Network Interfaces), die von XenServer-Hosts an dieses Netzwerk angeschlossen sind | Schreibgeschützter Parameter setzen |
bridge |
Name der Bridge, die diesem Netzwerk auf dem lokalen XenServer-Host entspricht | Lesezugriff |
default-locking-mode |
Ein Netzwerkobjekt, das mit VIF-Objekten für die ARP-Filterung verwendet wird. Legen Sie fest auf unverschlossen , um alle Filterregeln zu entfernen, die mit dem VIF verknüpft sind. Legen Sie fest auf arbeitsunfähig Die VIF verwirft also den gesamten Datenverkehr. |
Lesen/Schreiben |
purpose |
Eine Reihe von Zwecken, für die der XenServer-Host dieses Netzwerk verwendet. Legen Sie fest auf nbd , um das Netzwerk zum Herstellen von NBD-Verbindungen zu verwenden. |
Lesen/Schreiben |
other-config:staticroutes |
Kommagetrennte Liste von Subnetz/Netzmaske/Tor Formatierte Einträge, die die Gateway-Adresse angeben, über die Subnetze weitergeleitet werden sollen. Wenn Sie z. B. andere-konfiguration:statische-routen zu 172.16.0.0/15/192.168.0.3,172.18.0.0/16/192.168.0.4 führt dazu, dass der Datenverkehr auf 172.16.0.0/15 über 192.168.0.3 und der Datenverkehr auf 172.18.0.0/16 über 192.168.0.4 geleitet wird. |
Lesen/Schreiben |
other-config:ethtoolautoneg |
Legen Sie diesen Wert auf no fest, um die automatische Aushandlung der physischen Schnittstelle oder Bridge zu deaktivieren. Der Standardwert ist yes. | Lesen/Schreiben |
other-config:ethtool-rx |
Setzen Sie auf on, um den Empfang der Prüfsumme zu aktivieren, off, um zu deaktivieren | Lesen/Schreiben |
other-config:ethtool-tx |
Auf on setzen, um die Sendeprüfsumme zu aktivieren, off, um zu deaktivieren | Lesen/Schreiben |
other-config:ethtool-sg |
Auf ein setzen, um das Scatter-Sammeln zu aktivieren, auf aus, um zu deaktivieren | Lesen/Schreiben |
other-config:ethtool-tso |
Legen Sie diese Option auf ein fest, um die TCP-Segmentierungsauslagerung zu aktivieren, und auf aus, um sie zu deaktivieren | Lesen/Schreiben |
other-config:ethtool-ufo |
Legen Sie diese Option auf “ein” fest, um das Entladen von UDP-Fragmenten zu aktivieren, “aus”, um sie zu deaktivieren | Lesen/Schreiben |
other-config:ethtool-gso |
Legen Sie diese Option auf “on” fest, um die generische Segmentierungsauslagerung zu aktivieren, “off”, um sie zu deaktivieren. | Lesen/Schreiben |
blobs |
Binärer Datenspeicher | Lesezugriff |
network-create
xe network-create name-label=name_for_network [name-description=descriptive_text]
<!--NeedCopy-->
Erstellt ein Netzwerk.
network-destroy
xe network-destroy uuid=network_uuid
<!--NeedCopy-->
Zerstört ein vorhandenes Netzwerk.
SR-IOV-Befehle
Befehle für die Arbeit mit SR-IOV.
Das network-sriov
Objekte können mit dem Standardbefehl Objektauflistung (xe network-sriov-liste
) und die Parameter, die mit den Standardparameterbefehlen bearbeitet wurden. Weitere Informationen finden Sie unter Parameterbefehle auf niedriger Ebene
SR-IOV-Parameter
SR-IOV hat die folgenden Parameter:
Parametername | Beschreibung | Typ |
---|---|---|
physical-PIF |
Der PIF zum Aktivieren von SR-IOV. | Lesezugriff |
logical-PIF |
Ein logischer SR-IOV-PIF. Benutzer können diesen Parameter verwenden, um ein SR-IOV-VLAN-Netzwerk zu erstellen. | Lesezugriff |
requires-reboot |
Wenn auf True gesetzt, wird es verwendet, um den Host neu zu starten, um die SR-IOV-Aktivierung wirksam zu machen. | Lesezugriff |
remaining-capacity |
Anzahl der verbleibenden verfügbaren VFs. | Lesezugriff |
network-sriov-create
xe network-sriov-create network-uuid=network_uuid pif-uuid=physical_pif_uuid
<!--NeedCopy-->
Erstellt ein SR-IOV-Netzwerkobjekt für einen bestimmten physischen PIF und aktiviert SR-IOV für den physischen PIF.
network-sriov-destroy
xe network-sriov-destroy uuid=network_sriov_uuid
<!--NeedCopy-->
Entfernt ein SR-IOV-Netzwerkobjekt und deaktiviert SR-IOV auf seinem physischen PIF.
Zuweisen eines SR-IOV VF
xe vif-create device=device_index mac=vf_mac_address network-uuid=sriov_network vm-uuid=vm_uuid
<!--NeedCopy-->
Weist einer VM einen VF aus einem SR-IOV-Netzwerk zu.
SDN-Controller-Befehle
Befehle für die Arbeit mit dem SDN-Controller.
sdn-controller-forget
xe sdn-controller-introduce [address=address] [protocol=protocol] [tcp-port=tcp_port]
<!--NeedCopy-->
Führen Sie einen SDN-Controller ein.
sdn-controller-introduce
xe sdn-controller-forget uuid=uuid
<!--NeedCopy-->
Entfernen Sie einen SDN-Controller.
Tunnel-Befehle
Befehle für die Arbeit mit Tunneln.
tunnel-create
xe tunnel-create pif-uuid=pif_uuid network-uuid=network_uuid
<!--NeedCopy-->
Erstellen Sie einen neuen Tunnel auf einem Host.
tunnel-destroy
xe tunnel-destroy uuid=uuid
<!--NeedCopy-->
Zerstöre einen Tunnel.
Patch-Befehle
Befehle für die Arbeit mit Patches.
patch-apply
xe patch-apply uuid=patch_uuid host-uuid=host_uuid
<!--NeedCopy-->
Wenden Sie den zuvor hochgeladenen Patch auf den angegebenen Host an.
patch-clean
xe patch-clean uuid=uuid
<!--NeedCopy-->
Löschen Sie eine zuvor hochgeladene Patch-Datei.
patch-destroy
xe patch-destroy uuid=uuid
<!--NeedCopy-->
Entfernen Sie einen nicht angewendeten Patch-Eintrag und Dateien vom Host.
patch-pool-apply
xe patch-pool-apply uuid=uuid
<!--NeedCopy-->
Wenden Sie den zuvor hochgeladenen Patch auf alle Hosts im Pool an.
patch-pool-clean
xe patch-pool-clean uuid=uuid
<!--NeedCopy-->
Löschen Sie eine zuvor hochgeladene Patch-Datei auf allen Hosts im Pool.
patch-precheck
xe patch-precheck uuid=uuid host-uuid=host_uuid
<!--NeedCopy-->
Führen Sie die Prechecks aus, die in dem Patch enthalten sind, der zuvor auf den angegebenen Host hochgeladen wurde.
patch-upload
xe patch-upload file-name=file_name
<!--NeedCopy-->
Laden Sie eine Patch-Datei auf den Host hoch.
PBD-Befehle
Befehle für die Arbeit mit PBDs (Physical Block Devices). PBDs sind die Softwareobjekte, über die der XenServer-Host auf Storage Repositories (SRs) zugreift.
Die PBD-Objekte können mit dem Standardbefehl für die Objektauflistung (XE PBD-Liste
) und die Parameter, die mit den Standardparameterbefehlen bearbeitet wurden. Weitere Informationen finden Sie unter Parameterbefehle auf niedriger Ebene
PBD-Parameter
PBDs haben die folgenden Parameter:
Parametername | Beschreibung | Typ |
---|---|---|
uuid |
Die eindeutige Kennung/Objektreferenz für die PBD. | Lesezugriff |
sr-uuid |
Das Speicher-Repository, auf das die PBD verweist | Lesezugriff |
device-config |
Zusätzliche Konfigurationsinformationen, die dem SR-backend-driver eines Hosts zur Verfügung gestellt werden | Schreibgeschützter Map-Parameter |
currently-attached |
True, wenn der SR auf diesem Host angehängt ist, andernfalls False | Lesezugriff |
host-uuid |
UUID der physischen Maschine, auf der die PBD verfügbar ist | Lesezugriff |
host |
Das Host-Feld ist veraltet. Verwenden Sie stattdessen host_uuid. | Lesezugriff |
other-config |
Zusätzliche Konfigurationsinformationen. | Map-Parameter mit Lese-/Schreibzugriff |
pbd-create
xe pbd-create host-uuid=uuid_of_host sr-uuid=uuid_of_sr [device-config:key=corresponding_value]
<!--NeedCopy-->
Erstellen Sie eine PBD auf Ihrem XenServer-Host. Die schreibgeschützte Gerät-Konfiguration
kann nur bei der Erstellung gesetzt werden.
Um eine Zuordnung von ‘path’ zu ‘/tmp’ hinzuzufügen, stellen Sie sicher, dass die Befehlszeile das Argument enthält device-config:pfad=/tmp
Eine vollständige Liste der unterstützten Gerätekonfigurations-Schlüssel-Wert-Paare für jeden SR-Typ finden Sie unter Lagerung.
pbd-destroy
xe pbd-destroy uuid=uuid_of_pbd
<!--NeedCopy-->
Zerstören Sie die angegebene PBD.
pbd-plug
xe pbd-plug uuid=uuid_of_pbd
<!--NeedCopy-->
Versucht, die PBD an den XenServer-Host anzuschließen. Wenn dieser Befehl erfolgreich ausgeführt wird, wird die referenzierte SR (und die darin enthaltenen VDIs) für den XenServer-Host sichtbar.
pbd-unplug
xe pbd-unplug uuid=uuid_of_pbd
<!--NeedCopy-->
Versuchen Sie, die PBD vom XenServer-Host zu trennen.
PIF-Befehle
Befehle für die Arbeit mit PIFs (Objekte, die die physischen Netzwerkschnittstellen darstellen).
Die PIF-Objekte können mit dem Standardbefehl für die Objektauflistung (xe pif-list
) und die Parameter, die mit den Standardparameterbefehlen bearbeitet wurden. Weitere Informationen finden Sie unter Parameterbefehle auf niedriger Ebene
PIF-Parameter
PIFs haben die folgenden Parameter:
Parametername | Beschreibung | Typ |
---|---|---|
uuid |
Die eindeutige Kennung/Objektreferenz für den PIF | Lesezugriff |
device machine-readable |
Name der Schnittstelle (z. B. eth0) | Lesezugriff |
MAC |
Die MAC-Adresse des PIF | Lesezugriff |
other-config |
Zusätzliche PIF-Konfiguration name:Wert Paare. |
Map-Parameter mit Lese-/Schreibzugriff |
physical |
Wenn true, verweist der PIF auf eine tatsächliche physische Netzwerkschnittstelle | Lesezugriff |
currently-attached |
Ist der PIF derzeit an diesen Host angehängt? STIMMT oder FALSCH
|
Lesezugriff |
MTU |
Maximale Übertragungseinheit des PIF in Bytes. | Lesezugriff |
VLAN |
VLAN-Tag für den gesamten Datenverkehr, der über diese Schnittstelle geleitet wird. -1 gibt an, dass kein VLAN-Tag zugewiesen ist | Lesezugriff |
bond-master-of |
Die UUID der Anleihe, deren Hauptschnittstelle dieser PIF ist (falls vorhanden) | Lesezugriff |
bond-slave-of |
Die UUID der Anleihe, zu der dieser PIF gehört (falls vorhanden) | Lesezugriff |
management |
Ist dieser PIF als Verwaltungsschnittstelle für die Steuerdomäne vorgesehen? | Lesezugriff |
network-uuid |
Die eindeutige Kennung/Objektreferenz des virtuellen Netzwerks, mit dem dieser PIF verbunden ist | Lesezugriff |
network-name-label |
Der Name des virtuellen Netzwerks, mit dem dieser PIF verbunden ist | Lesezugriff |
host-uuid |
Die eindeutige Kennung/Objektreferenz des XenServer-Hosts, mit dem dieser PIF verbunden ist | Lesezugriff |
host-name-label |
Der Name des XenServer-Hosts, mit dem dieser PIF verbunden ist | Lesezugriff |
IP-configuration-mode |
Art der verwendeten Netzwerkadresskonfiguration; DHCP oder statisch | Lesezugriff |
IP |
IP-Adresse des PIF. Wird hier definiert, wenn der IP-Konfigurationsmodus statisch ist; undefiniert, wenn DHCP | Lesezugriff |
netmask |
Netzmaske des PIF. Wird hier definiert, wenn der IP-Konfigurationsmodus statisch ist; undefiniert, wenn es über DHCP bereitgestellt wird | Lesezugriff |
gateway |
Gateway-Adresse des PIF. Wird hier definiert, wenn der IP-Konfigurationsmodus statisch ist; undefiniert, wenn es über DHCP bereitgestellt wird | Lesezugriff |
DNS |
DNS-Adresse des PIF. Wird hier definiert, wenn der IP-Konfigurationsmodus statisch ist; undefiniert, wenn es über DHCP bereitgestellt wird | Lesezugriff |
io_read_kbs |
Durchschnittliche Leserate in kB/s für das Gerät | Lesezugriff |
io_write_kbs |
Durchschnittliche Schreibrate in kB/s für das Gerät | Lesezugriff |
carrier |
Verbindungsstatus für dieses Gerät | Lesezugriff |
vendor-id |
Die ID, die dem Anbieter der Netzwerkkarte zugewiesen ist | Lesezugriff |
vendor-name |
Der Name des NIC-Anbieters | Lesezugriff |
device-id |
Die ID, die diesem NIC-Modell vom Anbieter zugewiesen wurde | Lesezugriff |
device-name |
Der Name, den der Anbieter diesem NIC-Modell zugewiesen hat | Lesezugriff |
speed |
Datenübertragungsrate der Netzwerkkarte | Lesezugriff |
duplex |
Duplex-Modus der Netzwerkkarte; voll oder halb | Lesezugriff |
pci-bus-path |
Adresse des PCI-Buspfads | Lesezugriff |
other-config:ethtoolspeed |
Legt die Verbindungsgeschwindigkeit in Mbit/s fest | Lesen/Schreiben |
other-config:ethtoolautoneg |
Legen Sie diesen Wert auf no fest, um die automatische Aushandlung der physischen Schnittstelle oder Bridge zu deaktivieren. Der Standardwert ist yes. | Lesen/Schreiben |
other-config:ethtoolduplex |
Legt die Duplexfunktion des PIF fest, entweder vollständig oder halb. | Lesen/Schreiben |
other-config:ethtool-rx |
Setzen Sie auf on, um den Empfang der Prüfsumme zu aktivieren, off, um zu deaktivieren | Lesen/Schreiben |
other-config:ethtool-tx |
Auf on setzen, um die Sendeprüfsumme zu aktivieren, off, um zu deaktivieren | Lesen/Schreiben |
other-config:ethtool-sg |
Auf ein setzen, um das Scatter-Sammeln zu aktivieren, auf aus, um zu deaktivieren | Lesen/Schreiben |
other-config:ethtool-tso |
Legen Sie diese Option auf ein fest, um die TCP-Segmentierungsauslagerung zu aktivieren, und auf aus, um sie zu deaktivieren | Lesen/Schreiben |
other-config:ethtool-ufo |
Legen Sie diese Option auf “ein” fest, um das Entladen von UDP-Fragmenten zu aktivieren, “aus”, um sie zu deaktivieren | Lesen/Schreiben |
other-config:ethtool-gso |
Legen Sie diese Option auf “on” fest, um die generische Segmentierungsauslagerung zu aktivieren, “off”, um sie zu deaktivieren. | Lesen/Schreiben |
other-config:domain |
Kommagetrennte Liste, die zum Festlegen des DNS-Suchpfads verwendet wird | Lesen/Schreiben |
other-config:bondmiimon |
Intervall zwischen den Live-Prüfungen der Verbindung, in Millisekunden | Lesen/Schreiben |
other-config:bonddowndelay |
Die Anzahl der Millisekunden, die nach dem Verlust der Verbindung gewartet werden sollen, bevor die Verbindung wirklich als verschwunden betrachtet wird. Dieser Parameter ermöglicht einen vorübergehenden Verbindungsverlust | Lesen/Schreiben |
other-config:bondupdelay |
Die Anzahl der Millisekunden, die gewartet werden soll, nachdem der Link aktiviert wurde, bevor er wirklich in Betracht gezogen wird. Ermöglicht das Hochflattern von Links. Der Standardwert ist 31 Sek. , um den Switches Zeit zu geben, mit der Weiterleitung des Datenverkehrs zu beginnen. |
Lesen/Schreiben |
disallow-unplug |
True, wenn es sich bei diesem PIF um eine dedizierte Speicher-NIC handelt, andernfalls false | Lesen/Schreiben |
Hinweis:
Änderungen, die an der
andere-konfiguration
Felder eines PIF werden erst nach einem Neustart wirksam. Alternativ können Sie die Schaltflächexe pif-unplug
undXE PIF-Stecker
-Befehle, um zu veranlassen, dass die PIF-Konfiguration neu geschrieben wird.
pif-forget
xe pif-forget uuid=uuid_of_pif
<!--NeedCopy-->
Zerstört das angegebene PIF-Objekt auf einem bestimmten Host.
pif-introduce
xe pif-introduce host-uuid=host_uuid mac=mac_address_for_pif device=interface_name
<!--NeedCopy-->
Erstellen Sie ein PIF-Objekt, das eine physische Schnittstelle auf dem angegebenen XenServer-Host darstellt.
pif-plug
xe pif-plug uuid=uuid_of_pif
<!--NeedCopy-->
Versuchen Sie, die angegebene physische Schnittstelle aufzurufen.
pif-reconfigure-ip
xe pif-reconfigure-ip uuid=uuid_of_pif [mode=dhcp|mode=static] gateway=network_gateway_address IP=static_ip_for_this_pif netmask=netmask_for_this_pif [DNS=dns_address]
<!--NeedCopy-->
Ändern Sie die IP-Adresse des PIF. Für die statische IP-Konfiguration legen Sie die Modus
Parameter auf statisch
, mit dem Symbol Tor
, IP
und Netzmaske
Parameter, die auf die entsprechenden Werte eingestellt sind. Um DHCP zu verwenden, legen Sie die Modus
Parameter auf DHCP (Englisch)
und lassen Sie die statischen Parameter undefiniert.
Hinweis:
Die Verwendung statischer IP-Adressen an physischen Netzwerkschnittstellen, die mit einem Port auf einem Switch verbunden sind, der das Spanning Tree-Protokoll verwendet, bei ausgeschaltetem (oder nicht unterstütztem) STP-Fast-Link führt zu einem Zeitraum, in dem kein Datenverkehr vorhanden ist.
pif-reconfigure-ipv6
xe pif-reconfigure-ipv6 uuid=uuid_of_pif mode=mode [gateway=network_gateway_address] [IPv6=static_ip_for_this_pif] [DNS=dns_address]
<!--NeedCopy-->
Konfigurieren Sie die IPv6-Adresseinstellungen für eine PIF neu.
pif-scan
xe pif-scan host-uuid=host_uuid
<!--NeedCopy-->
Suchen Sie auf Ihrem XenServer-Host nach neuen physischen Schnittstellen.
pif-set-primary-address-type
xe pif-set-primary-address-type uuid=uuid primary_address_type=address_type
<!--NeedCopy-->
Ändern Sie den primären Adresstyp, der von dieser PIF verwendet wird.
pif-unplug
xe pif-unplug uuid=uuid_of_pif
<!--NeedCopy-->
Versuchen Sie, die angegebene physische Schnittstelle herunterzufahren.
Pool-Befehle
Befehle für die Arbeit mit Pools. Ein Tümpel ist ein Aggregat aus einem oder mehreren XenServer-Hosts. Ein Pool verwendet ein oder mehrere Repositorys für freigegebenen Speicher, sodass die VMs, die auf einem Host im Pool ausgeführt werden, nahezu in Echtzeit zu einem anderen Host im Pool migriert werden können. Diese Migration erfolgt, während die VM noch ausgeführt wird, ohne dass sie heruntergefahren und wieder hochgefahren werden muss.
Jeder XenServer-Host ist eigentlich ein Pool, der standardmäßig aus einem einzigen Mitglied besteht. Wenn Ihr XenServer-Host einem Pool beigetreten ist, wird er als Mitglied festgelegt. Wenn der Pool, mit dem der Host verbunden ist, aus einem einzelnen Mitglied besteht, wird dieses Mitglied zum Poolkoordinator. Wenn der Pool, dem der Host beigetreten ist, bereits über mehrere Mitglieder verfügt, ist eines dieser Mitglieder bereits der Poolkoordinator und bleibt es auch, wenn der neue Host dem Pool beitritt.
Das Singleton-Pool-Objekt kann mit dem Standardbefehl für die Objektauflistung (xe pool-liste
). Seine Parameter können mit den Standardparameterbefehlen manipuliert werden. Weitere Informationen finden Sie unter Parameterbefehle auf niedriger Ebene
Pool-Parameter
Pools verfügen über die folgenden Parameter:
Parametername | Beschreibung | Typ |
---|---|---|
uuid |
Die eindeutige Kennung/Objektreferenz für den Pool | Lesezugriff |
name-label |
Der Name des Pools | Lesen/Schreiben |
name-description |
Die Beschreibungszeichenfolge des Pools | Lesen/Schreiben |
master |
Die eindeutige Kennung/Objektreferenz des XenServer-Hosts, der als Koordinator des Pools festgelegt ist | Lesezugriff |
default-SR |
Die eindeutige Kennung/Objektreferenz der Standard-SR für den Pool | Lesen/Schreiben |
crash-dump-SR |
Die eindeutige Kennung/Objektreferenz der SR, in der alle Absturzabbilder für Poolmitglieder gespeichert werden | Lesen/Schreiben |
metadata-vdis |
Alle bekannten Metadaten-VDIs für den Pool | Lesezugriff |
suspend-image-SR |
Die eindeutige Kennung/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 | Map-Parameter mit Lese-/Schreibzugriff |
other-config:default_ha_timeout |
Timeout für hohe Verfügbarkeit in Sekunden. | Lesen/Schreiben |
supported-sr-types |
SR-Typen, die dieser Pool verwenden kann | Lesezugriff |
ha-enabled |
True, wenn HA für den Pool aktiviert ist, andernfalls false | Lesezugriff |
ha-configuration |
Reserviert für die zukünftige Verwendung. | Lesezugriff |
ha-statefiles |
Listet die UUIDs der VDIs auf, die von HA zur Bestimmung des Speicherzustands verwendet werden | Lesezugriff |
ha-host-failures-to-tolerate |
Die Anzahl der Hostfehler, die toleriert werden sollen, bevor eine Systemwarnung gesendet wird | Lesen/Schreiben |
ha-plan-exists-for |
Die Anzahl der Host-Ausfälle, die gemäß den Berechnungen des HA-Algorithmus tatsächlich behandelt werden können | Lesezugriff |
ha-allow-overcommit |
True, wenn der Pool überlastet werden darf, andernfalls False | Lesen/Schreiben |
ha-overcommitted |
True, wenn der Pool überlastet ist | Lesezugriff |
blobs |
Binärer Datenspeicher | Lesezugriff |
live-patching-disabled |
Legen Sie diesen Wert auf “False” fest, um das Live-Patching zu aktivieren. Legen Sie diesen Wert auf True fest, um das Live-Patching zu deaktivieren. | Lesen/Schreiben |
igmp-snooping-enabled |
Legen Sie diesen Wert auf True fest, um IGMP-Snooping zu aktivieren. Legen Sie diesen Wert auf False fest, um IGMP-Snooping zu deaktivieren. | Lesen/Schreiben |
https-only |
Legen Sie diese Option auf False fest, damit externe Clients, die die Verwaltungs-API verwenden, eine Verbindung zu XenServer über HTTPS über Port 443 oder HTTP über Port 80 herstellen können. Legen Sie diesen Wert auf True fest, um Port 80 zu blockieren und Clients zu verpflichten, eine Verbindung ausschließlich über HTTPS über Port 443 herzustellen. | Lesen/Schreiben |
migration-compression |
Legen Sie diesen Wert auf True fest, um die Komprimierung des Migrationsdatenstroms für Ihren XenServer-Pool zu aktivieren. Legen Sie diesen Wert auf False fest, um die Komprimierung des Migrationsdatenstroms zu deaktivieren. Der Standardwert ist False. Kann überschrieben werden durch vm-migrieren Befehls komprimieren Parameter. |
Lesen/Schreiben |
pool-apply-edition
xe pool-apply-edition edition=edition [uuid=uuid] [license-server-address=address] [license-server-port=port]
<!--NeedCopy-->
Wenden Sie eine Edition auf den gesamten Pool an.
pool-certificate-install
xe pool-certificate-install filename=file_name
<!--NeedCopy-->
Installieren Sie ein TLS-Zertifikat für den gesamten Pool.
pool-certificate-list
xe pool-certificate-list
<!--NeedCopy-->
Listen Sie alle installierten TLS-Zertifikate in einem Pool auf.
pool-certificate-sync
xe pool-certificate-sync
<!--NeedCopy-->
Synchronisieren Sie TLS-Zertifikate und Zertifikatsperrlisten vom Poolkoordinator mit den anderen Poolmitgliedern.
pool-certificate-uninstall
xe pool-certificate-uninstall name=name
<!--NeedCopy-->
Deinstallieren Sie ein TLS-Zertifikat.
pool-crl-install
xe pool-crl-install filename=file_name
<!--NeedCopy-->
Installieren Sie eine Liste zum Sperren von TLS-Zertifikaten für den gesamten Pool.
pool-crl-list
xe pool-crl-list
<!--NeedCopy-->
Listet alle installierten Listen zum Widerrufen von TLS-Zertifikaten auf.
pool-crl-uninstall
xe pool-crl-uninstall name=name
<!--NeedCopy-->
Deinstallieren Sie eine Liste zum Widerrufen von TLS-Zertifikaten.
pool-deconfigure-wlb
xe pool-deconfigure-wlb
<!--NeedCopy-->
Entfernen Sie die Konfiguration für den Arbeitslastausgleich dauerhaft.
pool-designate-new-master
xe pool-designate-new-master host-uuid=uuid_of_new_master
<!--NeedCopy-->
Weisen Sie den angegebenen XenServer-Host an, der Koordinator (früher “Master” genannt) eines vorhandenen Pools zu werden. Dieser Befehl führt eine geordnete Übergabe der Rolle des Pool-Koordinators an einen anderen Host im Ressourcen-Pool durch. Dieser Befehl funktioniert nur, wenn der aktuelle Poolkoordinator online ist. Es ist kein Ersatz für die unten aufgeführten Befehle im Notfallmodus.
pool-disable-external-auth
xe pool-disable-external-auth [uuid=uuid] [config=config]
<!--NeedCopy-->
Deaktiviert die externe Authentifizierung auf allen Hosts in einem Pool.
pool-disable-local-storage-caching
xe pool-disable-local-storage-caching uuid=uuid
<!--NeedCopy-->
Deaktivieren Sie das Caching des lokalen Speichers im gesamten Pool.
pool-disable-redo-log
xe pool-disable-redo-log
<!--NeedCopy-->
Deaktivieren Sie das Wiederholungsprotokoll, wenn es verwendet wird, es sei denn, HA ist aktiviert.
pool-dump-database
xe pool-dump-database file-name=filename_to_dump_database_into_(on_client)
<!--NeedCopy-->
Laden Sie eine Kopie der gesamten Pooldatenbank herunter, und legen Sie sie in einer Datei auf dem Client ab.
pool-enable-external-auth
xe pool-enable-external-auth auth-type=auth_type service-name=service_name [uuid=uuid] [config:=config]
<!--NeedCopy-->
Aktiviert die externe Authentifizierung auf allen Hosts in einem Pool. Beachten Sie, dass einige Werte von auth-type
wird eine besondere Konfiguration:
Werte.
pool-enable-local-storage-caching
xe pool-enable-local-storage-caching uuid=uuid
<!--NeedCopy-->
Aktivieren Sie das Caching des lokalen Speichers im gesamten Pool.
pool-enable-redo-log
xe pool-ensable-redo-log sr-uuid=sr_uuid
<!--NeedCopy-->
Aktivieren Sie das Wiederholungsprotokoll für die angegebene SR, wenn sie verwendet wird, es sei denn, HA ist aktiviert.
pool-eject
xe pool-eject host-uuid=uuid_of_host_to_eject
<!--NeedCopy-->
Weisen Sie den angegebenen XenServer-Host an, einen vorhandenen Pool zu verlassen.
pool-emergency-reset-master
xe pool-emergency-reset-master master-address=address_of_pool_master
<!--NeedCopy-->
Weisen Sie einen Host eines Poolmitglieds an, die Adresse des Poolkoordinators auf den neuen Wert zurückzusetzen und zu versuchen, eine Verbindung zu ihm herzustellen. Führen Sie diesen Befehl nicht für Poolkoordinatoren aus.
pool-emergency-transition-to-master
xe pool-emergency-transition-to-master
<!--NeedCopy-->
Weisen Sie einen XenServer-Mitgliedshost an, der Pool-Koordinator zu werden (früher als “Pool-Master” bezeichnet). Der XenServer-Host akzeptiert diesen Befehl erst, nachdem der Host in den Notfallmodus übergegangen ist. Der Notfallmodus bedeutet, dass es sich um ein Mitglied eines Pools handelt, dessen Koordinator aus dem Netzwerk verschwunden ist und nach einer bestimmten Anzahl von Wiederholungen nicht kontaktiert werden kann.
Wenn das Hostkennwort geändert wurde, seit der Host dem Pool beigetreten ist, kann dieser Befehl dazu führen, dass das Kennwort des Hosts zurückgesetzt wird. Weitere Informationen finden Sie unter (Benutzerbefehle).
pool-ha-enable
xe pool-ha-enable heartbeat-sr-uuids=uuid_of_heartbeat_sr
<!--NeedCopy-->
Aktivieren Sie die Hochverfügbarkeit im Ressourcenpool, indem Sie die angegebene SR-UUID als zentrales Speicher-Heartbeat-Repository verwenden.
pool-ha-disable
xe pool-ha-disable
<!--NeedCopy-->
Deaktiviert die Hochverfügbarkeitsfunktion für den 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
xe pool-ha-compute-hypothetical-max-host-failures-to-tolerate [vm-uuid=vm_uuid] [restart-priority=restart_priority]
<!--NeedCopy-->
Berechnen Sie die maximale Anzahl von Hostfehlern, die mit den bereitgestellten, vorgeschlagenen geschützten VMs toleriert werden sollen.
pool-initialize-wlb
xe pool-initialize-wlb wlb_url=url wlb_username=wlb_username wlb_password=wlb_password xenserver_username=username xenserver_password=password
<!--NeedCopy-->
Initialisieren Sie den Arbeitslastausgleich für den aktuellen Pool mit dem Zielserver für den Arbeitslastausgleich.
pool-join
xe pool-join master-address=address master-username=username master-password=password
<!--NeedCopy-->
Weisen Sie Ihren XenServer-Host an, einem vorhandenen Pool beizutreten.
pool-management-reconfigure
xe pool-management-reconfigure [network-uuid=network-uuid]
<!--NeedCopy-->
Konfiguriert die Verwaltungsschnittstelle aller Hosts im Pool neu, um die angegebene Netzwerkschnittstelle zu verwenden, bei der es sich um die Schnittstelle handelt, die zum Herstellen einer Verbindung mit XenCenter verwendet wird. Der Befehl schreibt den MANAGEMENT_INTERFACE Schlüssel in /etc/xensource-inventar
für alle Hosts im Pool.
Wenn der Gerätename einer Schnittstelle (die über eine IP-Adresse verfügen muss) angegeben wird, bindet der XenServer-Poolkoordinator sofort erneut. Dieser Befehl funktioniert sowohl im normalen als auch im Notfallmodus.
Von der angegebenen Netzwerk-UUID wird die UUID des PIF-Objekts identifiziert und dem XenServer-Host zugeordnet, der bestimmt, welche IP-Adresse erneut an sich selbst gebunden werden soll. Er darf sich nicht im Notfallmodus befinden, wenn dieser Befehl ausgeführt wird.
Warnung:
Seien Sie vorsichtig, wenn Sie diesen CLI-Befehl außerhalb des Hosts verwenden, und stellen Sie sicher, dass Sie über eine Netzwerkverbindung auf der neuen Schnittstelle verfügen. Gebrauchen
xe pif-reconfigure
, um zuerst eines einzurichten. Andernfalls können nachfolgende CLI-Befehle den XenServer-Host nicht erreichen.
pool-recover-slaves
xe pool-recover-slaves
<!--NeedCopy-->
Weisen Sie den Poolkoordinator an, zu versuchen, die Adresse aller Mitglieder zurückzusetzen, die derzeit im Notfallmodus ausgeführt werden. Dieser Befehl wird in der Regel nach pool-notfall-übergang-zu-master
wurde verwendet, um eines der Mitglieder als neuen Pool-Koordinator festzulegen.
pool-restore-database
xe pool-restore-database file-name=filename_to_restore_from_on_client [dry-run=true|false]
<!--NeedCopy-->
Laden Sie eine Datenbanksicherung hoch (erstellt mit pool-dump-datenbank
) in einen Pool um. Nach Erhalt des Uploads startet sich der Poolkoordinator mit der neuen Datenbank neu.
Es gibt auch eine Probelauf , mit der Sie überprüfen können, ob die Pooldatenbank wiederhergestellt werden kann, ohne den Vorgang tatsächlich auszuführen. Standardmäßig Trockenlauf
ist auf false festgelegt.
pool-retrieve-wlb-configuration
xe pool-retrieve-wlb-configuration
<!--NeedCopy-->
Ruft die Pool-Optimierungskriterien vom Workload Balancing-Server ab.
pool-retrieve-wlb-diagnostics
xe pool-retrieve-wlb-diagnostics [filename=file_name]
<!--NeedCopy-->
Ruft Diagnosen vom Workload Balancing-Server ab.
pool-retrieve-wlb-recommendations
xe pool-retrieve-wlb-recommendations
<!--NeedCopy-->
Ruft Empfehlungen für die VM-Migration für den Pool vom Workload Balancing-Server ab.
pool-retrieve-wlb-report
xe pool-retrieve-wlb-report report=report [filename=file_name]
<!--NeedCopy-->
Ruft Berichte vom Workload Balancing-Server ab.
pool-secret-rotate
xe pool-secret-rotate
<!--NeedCopy-->
Drehen Sie den geheimen Poolschlüssel.
Das Poolgeheimnis ist ein Geheimnis, das von den XenServer-Hosts in einem Pool gemeinsam genutzt wird und es dem Host ermöglicht, seine Mitgliedschaft in einem Pool nachzuweisen. Benutzer mit der Rolle “Pooladministrator” können dieses Geheimnis anzeigen, wenn sie über SSH eine Verbindung mit dem Host herstellen. Rotieren Sie den geheimen Poolschlüssel, wenn einer dieser Benutzer Ihre Organisation verlässt oder seine Rolle als Pooladministrator verliert.
pool-send-test-post
xe pool-send-test-post dest-host=destination_host dest-port=destination_port body=post_body
<!--NeedCopy-->
Senden Sie den angegebenen Text über HTTPS an den angegebenen Host und Port und geben Sie die Antwort aus. Dies wird zum Debuggen der TLS-Schicht verwendet.
pool-send-wlb-configuration
xe pool-send-wlb-configuration [config:=config]
<!--NeedCopy-->
Legt die Pool-Optimierungskriterien für den Workload Balancing-Server fest.
pool-sync-database
xe pool-sync-database
<!--NeedCopy-->
Erzwingen Sie, dass die Pooldatenbank auf allen Hosts im Ressourcenpool synchronisiert wird. Dieser Befehl ist im normalen Betrieb nicht erforderlich, da die Datenbank regelmäßig automatisch repliziert wird. Der Befehl kann jedoch nützlich sein, um sicherzustellen, dass Änderungen nach dem Ausführen einer Vielzahl von CLI-Vorgängen schnell repliziert werden.
Garnitur Nur https
xe pool-param-set [uuid=pool-uuid] [https-only=true|false]
<!--NeedCopy-->
Aktiviert oder deaktiviert das Blockieren von Port 80 auf der Verwaltungsschnittstelle von XenServer-Hosts.
PVS Accelerator-Befehle
Befehle für die Arbeit mit dem PVS Accelerator.
pvs-cache-storage-create
xe pvs-cache-storage-create sr-uuid=sr_uuid pvs-site-uuid=pvs_site_uuid size=size
<!--NeedCopy-->
Konfigurieren Sie einen PVS-Cache auf einer bestimmten SR für einen bestimmten Host.
pvs-cache-storage-destroy
xe pvs-cache-storage-destroy uuid=uuid
<!--NeedCopy-->
Entfernen Sie einen PVS-Cache.
pvs-proxy-create
xe pvs-proxy-create pvs-site-uuid=pvs_site_uuid vif-uuid=vif_uuid
<!--NeedCopy-->
Konfigurieren Sie eine VM/VIF für die Verwendung eines PVS-Proxys.
pvs-proxy-destroy
xe pvs-proxy-destroy uuid=uuid
<!--NeedCopy-->
Entfernen (oder deaktivieren) Sie einen PVS-Proxy für diese VIF/VM.
pvs-server-forget
xe pvs-server-forget uuid=uuid
<!--NeedCopy-->
Vergessen Sie einen PVS-Server.
pvs-server-introduce
xe pvs-server-introduce addresses=adresses first-port=first_port last-port=last_port pvs-site-uuid=pvs_site_uuid
<!--NeedCopy-->
Einführung eines neuen PVS-Servers.
pvs-site-forget
xe pvs-site-forget uuid=uuid
<!--NeedCopy-->
Vergessen Sie eine PVS-Site.
pvs-site-introduce
xe pvs-site-introduce name-label=name_label [name-description=name_description] [pvs-uuid=pvs_uuid]
<!--NeedCopy-->
Einführung einer neuen PVS-Site.
Storage Manager-Befehle
Befehle zum Steuern von Storage Manager-Plug-Ins.
Die Objekte des Speichermanagers können mit dem Standardbefehl für die Objektauflistung (XE SM-Liste
). Die Parameter können mit den Standard-Parameterbefehlen manipuliert werden. Weitere Informationen finden Sie unter Parameterbefehle auf niedriger Ebene
SM-Parameter
SMs haben die folgenden Parameter:
Parametername | Beschreibung | Typ |
---|---|---|
uuid |
Die eindeutige Kennung/Objektreferenz für das SM-Plug-In | Lesezugriff |
name-label |
Der Name des SM-Plug-Ins | Lesezugriff |
name-description |
Der Beschreibungsstring des SM-Plug-Ins | Lesezugriff |
type |
Der SR-Typ, mit dem dieses Plug-In eine Verbindung herstellt | Lesezugriff |
vendor |
Name des Herstellers, der dieses Plug-in erstellt hat | Lesezugriff |
copyright |
Copyright-Erklärung für dieses SM-Plug-in | Lesezugriff |
required-api-version |
Minimale SM-API-Version auf dem XenServer-Host erforderlich | Lesezugriff |
configuration |
Namen und Beschreibungen der Gerätekonfigurationsschlüssel | Lesezugriff |
capabilities |
Funktionen des SM-Plug-Ins | Lesezugriff |
driver-filename |
Der Dateiname des SR-Treibers. | Lesezugriff |
Snapshot-Befehle
Befehle zum Arbeiten mit Snapshots.
snapshot-clone
xe snapshot-clone new-name-label=name_label [uuid=uuid] [new-name-description=description]
<!--NeedCopy-->
Erstellen Sie eine neue Vorlage, indem Sie einen vorhandenen Snapshot klonen, wobei Sie den schnellen Festplattenklonvorgang auf Speicherebene verwenden, sofern verfügbar.
snapshot-copy
xe snapshot-copy new-name-label=name_label [uuid=uuid] [new-name-description=name_description] [sr-uuid=sr_uuid]
<!--NeedCopy-->
Erstellen Sie eine neue Vorlage, indem Sie eine vorhandene VM kopieren, jedoch ohne den schnellen Datenträgerklonvorgang auf Speicherebene zu verwenden (auch wenn dieser verfügbar ist). Die Disk-Images der kopierten VM sind garantiert “vollständige Images”, d. h. nicht Teil einer CoW-Kette.
snapshot-destroy
xe snapshot-destroy [uuid=uuid] [snapshot-uuid=snapshot_uuid]
<!--NeedCopy-->
Löschen Sie einen Snapshot. Dadurch bleibt der mit dem Snapshot verknüpfte Speicher intakt. Um auch Speicher zu löschen, verwenden Sie snapshot-uninstall.
snapshot-disk-list
xe snapshot-disk-list [uuid=uuid] [snapshot-uuid=snapshot_uuid] [vbd-params=vbd_params] [vdi-params=vdi_params]
<!--NeedCopy-->
Listen Sie die Datenträger auf den ausgewählten VMs auf.
snapshot-export-to-template
xe snapshot-export-to-template filename=file_name snapshot-uuid=snapshot_uuid [preserve-power-state=true|false]
<!--NeedCopy-->
Exportieren eines Snapshots nach Dateiname.
snapshot-reset-powerstate
xe snapshot-reset-powerstate [uuid=uuid] [snapshot-uuid=snapshot_uuid] [--force]
<!--NeedCopy-->
Erzwingen Sie, dass der Betriebszustand der VM nur in der Management-Toolstack-Datenbank angehalten wird. Dieser Befehl wird verwendet, um einen Snapshot wiederherzustellen, der als “angehalten” markiert ist. Dies ist ein potenziell gefährlicher Vorgang: Sie müssen sicherstellen, dass Sie das Speicherabbild nicht mehr benötigen. Sie können Ihren Snapshot nicht mehr fortsetzen.
snapshot-revert
xe snapshot-revert [uuid=uuid] [snapshot-uuid=snapshot_uuid]
<!--NeedCopy-->
Setzen Sie eine vorhandene VM auf einen vorherigen Prüfpunkt- oder Momentaufnahmestatus zurück.
snapshot-uninstall
xe snapshot-uninstall [uuid=uuid] [snapshot-uuid=snapshot_uuid] [--force]
<!--NeedCopy-->
Deinstallieren Sie einen Snapshot. Dieser Vorgang zerstört die VDIs, die als RW gekennzeichnet und nur mit diesem Snapshot verbunden sind. Um den VM-Datensatz einfach zu löschen, verwenden Sie snapshot-destroy.
SR-Befehle
Befehle zur Steuerung von SRs (Storage Repositories).
Die SR-Objekte können mit dem Standardbefehl für die Objektauflistung (XE SR-Liste
) und die Parameter, die mit den Standardparameterbefehlen bearbeitet wurden. Weitere Informationen finden Sie unter Parameterbefehle auf niedriger Ebene
SR-Parameter
SRs haben die folgenden Parameter:
Parametername | Beschreibung | Typ |
---|---|---|
uuid |
Die eindeutige Kennung/Objektreferenz für die SR | Lesezugriff |
name-label |
Der Name der Slowakischen Republik | Lesen/Schreiben |
name-description |
Die Beschreibungszeichenfolge der SR | Lesen/Schreiben |
host |
Der Hostname des Speicher-Repositorys | Lesezugriff |
allowed-operations |
Liste der Vorgänge, die in diesem Status auf der SR zulässig sind | Schreibgeschützter Parameter setzen |
current-operations |
Liste der Vorgänge, die derzeit in dieser Empfehlungserklärung ausgeführt werden | Schreibgeschützter Parameter setzen |
VDIs |
Eindeutiger Bezeichner/Objektreferenz für die virtuellen Laufwerke in dieser SR | Schreibgeschützter Parameter setzen |
PBDs |
Eindeutiger Identifikator/Objektreferenz für die PBDs, die an diesen SR angehängt sind | Schreibgeschützter Parameter setzen |
virtual-allocation |
Summe der Werte für die virtuelle Größe aller VDIs in diesem Speicher-Repository (in Bytes) | Lesezugriff |
physical-utilisation |
Physischer Speicherplatz, der derzeit auf dieser SR verwendet wird, in Bytes. Bei Thin Provisioning-Festplattenformaten kann die physische Auslastung geringer sein als die virtuelle Zuordnung. | Lesezugriff |
physical-size |
Physische Gesamtgröße der SR in Byte | Lesezugriff |
type |
Typ der SR, der zum Angeben des zu verwendenden SR-Backend-Treibers verwendet wird | Lesezugriff |
content-type |
Der Typ des Inhalts des SR. Wird verwendet, um ISO-Bibliotheken von anderen SRs zu unterscheiden. Für Speicher-Repositories, die eine Bibliothek von ISOs speichern, wird die Inhaltstyp muss auf ISO . In anderen Fällen wird empfohlen, diesen Parameter entweder auf empty oder auf die Zeichenfolge user festzulegen. |
Lesezugriff |
shared |
True, wenn dieser SR von mehreren Hosts gemeinsam genutzt werden kann. Andernfalls falsch. | Lesen/Schreiben |
introduced-by |
Das drtask (falls vorhanden), mit der die Slowakische Empfehlung |
Lesezugriff |
is-tools-sr |
True, wenn es sich um die SR handelt, die die ISO-VDIs der Tools enthält. Andernfalls falsch. | Lesezugriff |
other-config |
Liste der Schlüssel-Wert-Paare, die zusätzliche Konfigurationsparameter für die SR angeben | Map-Parameter mit Lese-/Schreibzugriff |
sm-config |
SM-abhängige Daten | Schreibgeschützter Map-Parameter |
blobs |
Binärer Datenspeicher | Lesezugriff |
local-cache-enabled |
True, wenn dieser SR als lokaler Cache für den Host zugewiesen ist. Andernfalls falsch. | Lesezugriff |
tags |
Benutzerdefinierte Tags für Kategorisierungszwecke | Lesen/Schreiben von eingestellten Parametern |
clustered |
Es stimmt, dass die SR aggregierten lokalen Speicher verwendet. Andernfalls falsch. | Lesezugriff |
sr-create
xe sr-create name-label=name physical-size=size type=type content-type=content_type device-config:config_name=value [host-uuid=host_uuid] [shared=true|false]
<!--NeedCopy-->
Erstellt eine SR auf der Festplatte, führt sie in die Datenbank ein und erstellt eine PBD, die die SR an den XenServer-Host anhängt. Wenn geteilt
ist auf STIMMT
wird für jeden XenServer-Host im Pool eine PBD erstellt. Wenn geteilt
nicht angegeben oder auf FALSCH
wird eine PBD nur für den XenServer-Host erstellt, der mit host-uuid
.
Die genaue Gerät-Konfiguration
Parameter unterscheiden sich je nach Gerät Art
. Weitere Informationen zu diesen Parametern in den verschiedenen Speicher-Back-Ends finden Sie unter Erstellen einer SR.
sr-data-source-forget
xe sr-data-source-forget data-source=data_source
<!--NeedCopy-->
Beenden Sie die Aufzeichnung der angegebenen Datenquelle für eine SR, und vergessen Sie alle aufgezeichneten Daten.
sr-data-source-list
xe sr-data-source-list
<!--NeedCopy-->
Listen Sie die Datenquellen auf, die für eine SR aufgezeichnet werden können.
sr-data-source-query
xe sr-data-source-query data-source=data_source
<!--NeedCopy-->
Abfrage des letzten Werts, der aus einer SR-Datenquelle gelesen wurde.
sr-data-source-record
xe sr-data-source-record data-source=data_source
<!--NeedCopy-->
Notieren Sie die angegebene Datenquelle für eine SR.
sr-destroy
xe sr-destroy uuid=sr_uuid
<!--NeedCopy-->
Zerstört die angegebene SR auf dem XenServer-Host.
sr-enable-database-replication
xe sr-enable-database-replication uuid=sr_uuid
<!--NeedCopy-->
Aktiviert die XAPI-Datenbankreplikation auf die angegebene (freigegebene) SR.
sr-disable-database-replication
xe sr-disable-database-replication uuid=sr_uuid
<!--NeedCopy-->
Deaktiviert die XAPI-Datenbankreplikation auf die angegebene SR.
sr-forget
xe sr-forget uuid=sr_uuid
<!--NeedCopy-->
Der XAPI-Agent vergisst eine angegebene SR auf dem XenServer-Host. Wenn der XAPI-Agent eine SR vergisst, wird die SR getrennt, und Sie können nicht auf VDIs darauf zugreifen, aber sie bleibt auf dem Quellmedium intakt (die Daten gehen nicht verloren).
sr-introduce
xe sr-introduce name-label=name physical-size=physical_size type=type content-type=content_type uuid=sr_uuid
<!--NeedCopy-->
Legt einfach einen SR-Eintrag in der Datenbank ab. Gebrauchen Gerät-Konfiguration
, um zusätzliche Parameter im Formular anzugeben device-config:parameter_key=parameter_value
Zum Beispiel:
xe sr-introduce device-config:device=/dev/sdb1
<!--NeedCopy-->
Hinweis:
Dieser Befehl wird im normalen Betrieb nie verwendet. Dieser erweiterte Vorgang kann nützlich sein, wenn eine SR nach der Erstellung als freigegeben neu konfiguriert werden muss, oder um die Wiederherstellung nach verschiedenen Fehlerszenarien zu unterstützen.
sr-probe
xe sr-probe type=type [host-uuid=host_uuid] [device-config:config_name=value]
<!--NeedCopy-->
Führt einen Scan des Backends mit dem bereitgestellten Gerät-Konfiguration
Tasten. Wenn die Option Gerät-Konfiguration
für das SR-Backend vollständig ist, gibt dieser Befehl eine Liste der auf dem Gerät vorhandenen SRs zurück, falls vorhanden. Wenn die Option Gerät-Konfiguration
Die Parameter sind nur teilweise, es wird ein Backend-spezifischer Scan durchgeführt, der Ergebnisse liefert, die Sie bei der Verbesserung der verbleibenden Parameter unterstützen. Gerät-Konfiguration
Parameter. Die Scan-Ergebnisse werden als Back-End-spezifisches XML zurückgegeben und auf der CLI ausgegeben.
Die genaue Gerät-Konfiguration
Parameter unterscheiden sich je nach Gerät Art
. Weitere Informationen zu diesen Parametern in den verschiedenen Speicher-Back-Ends finden Sie unter Lagerung.
sr-probe-ext
xe sr-probe-ext type=type [host-uuid=host_uuid] [device-config:=config] [sm-config:-sm_config]
<!--NeedCopy-->
Führen Sie einen Speichertest durch. Die device-config-Parameter können zum Beispiel durch device-config:devs=/dev/sdb1 angegeben werden. Im Gegensatz zu sr-probe gibt dieser Befehl für jeden SR-Typ Ergebnisse im gleichen lesbaren Format zurück.
sr-scan
xe sr-scan uuid=sr_uuid
<!--NeedCopy-->
Erzwingen Sie einen SR-Scan, bei dem die XAPI-Datenbank mit VDIs synchronisiert wird, die auf dem zugrunde liegenden Speichersubstrat vorhanden sind.
sr-update
xe sr-update uuid=uuid
<!--NeedCopy-->
Aktualisieren Sie die Felder des SR-Objekts in der Datenbank.
lvhd-enable-thin-provisioning
xe lvhd-enable-thin-provisioning sr-uuid=sr_uuid initial-allocation=initial_allocation allocation-quantum=allocation_quantum
<!--NeedCopy-->
Aktivieren Sie Thin-Provisioning auf einer LVHD-SR.
Betreff-Befehle
Befehle für die Arbeit mit Motiven.
session-subject-identifier-list
xe session-subject-identifier-list
<!--NeedCopy-->
Gibt eine Liste aller Benutzerantragsteller-IDs aller extern authentifizierten vorhandenen Sitzungen zurück.
session-subject-identifier-logout
xe session-subject-identifier-logout subject-identifier=subject_identifier
<!--NeedCopy-->
Melden Sie sich von allen extern authentifizierten Sitzungen ab, die einer Benutzerantragsteller-ID zugeordnet sind.
session-subject-identifier-logout-all
xe session-subject-identifier-logout-all
<!--NeedCopy-->
Melden Sie sich von allen extern authentifizierten Sitzungen ab.
subject-add
xe subject-add subject-name=subject_name
<!--NeedCopy-->
Fügen Sie der Liste der Betreffe, die auf den Pool zugreifen können, einen Betreff hinzu.
subject-remove
xe subject-remove subject-uuid=subject_uuid
<!--NeedCopy-->
Entfernen Sie einen Betreff aus der Liste der Betreffe, die auf den Pool zugreifen können.
subject-role-add
xe subject-role-add uuid=uuid [role-name=role_name] [role-uuid=role_uuid]
<!--NeedCopy-->
Fügen Sie einem Betreff eine Rolle hinzu.
subject-role-remove
xe subject-role-remove uuid=uuid [role-name=role_name] [role-uuid=role_uuid]
<!--NeedCopy-->
Entfernen einer Rolle aus einem Betreff.
secret-create
xe secret-create value=value
<!--NeedCopy-->
Erstellen Sie ein Geheimnis.
secret-destroy
xe secret-destroy uuid=uuid
<!--NeedCopy-->
Zerstöre ein Geheimnis.
Aufgaben-Befehle
Befehle für die Arbeit mit asynchronen Aufgaben mit langer Ausführungszeit. Bei diesen Befehlen handelt es sich um Aufgaben wie das Starten, Beenden und Anhalten einer virtuellen Maschine. Die Aufgaben bestehen in der Regel aus einer Reihe anderer atomarer Unteraufgaben, die zusammen den angeforderten Vorgang ausführen.
Die Aufgabenobjekte können mit dem Standardbefehl für die Objektauflistung (XE-Aufgabenliste
) und die Parameter, die mit den Standardparameterbefehlen bearbeitet wurden. Weitere Informationen finden Sie unter Parameterbefehle auf niedriger Ebene
Aufgaben-Parameter
Aufgaben haben die folgenden Parameter:
Parametername | Beschreibung | Typ |
---|---|---|
uuid |
Die eindeutige Kennung/Objektreferenz für die Aufgabe | Lesezugriff |
name-label |
Der Name der Aufgabe | Lesezugriff |
name-description |
Die Beschreibungszeichenfolge der Aufgabe | Lesezugriff |
resident-on |
Die eindeutige Kennung/Objektreferenz des Hosts, auf dem die Aufgabe ausgeführt wird | Lesezugriff |
status |
Status der Aufgabe | Lesezugriff |
progress |
Wenn die Aufgabe noch aussteht, enthält dieses Feld den geschätzten Prozentsatz der Fertigstellung von 0 bis 1. Wenn die Aufgabe erfolgreich oder nicht erfolgreich abgeschlossen wurde, ist der Wert 1. | Lesezugriff |
type |
Wenn die Aufgabe erfolgreich abgeschlossen wurde, enthält dieser Parameter den Typ des codierten Ergebnisses. Der Typ ist der Name der Klasse, deren Verweis sich im Ergebnisfeld befindet. Andernfalls ist der Wert dieses Parameters nicht definiert | Lesezugriff |
result |
Wenn die Aufgabe erfolgreich abgeschlossen wurde, enthält dieses Feld den Ergebniswert, entweder Void oder eine Objektreferenz. Andernfalls ist der Wert dieses Parameters nicht definiert | Lesezugriff |
error_info |
Wenn die Aufgabe fehlgeschlagen ist, enthält dieser Parameter den Satz der zugeordneten Fehlerzeichenfolgen. Andernfalls ist der Wert dieses Parameters nicht definiert | Lesezugriff |
allowed_operations |
Liste der Vorgänge, die in diesem Zustand zulässig sind | Lesezugriff |
created |
Zeitpunkt, zu dem die Aufgabe erstellt wurde | Lesezugriff |
finished |
Zeitaufgabe beendet (d. h. erfolgreich oder fehlgeschlagen). Wenn task-status pending ist, hat der Wert dieses Feldes keine Bedeutung | Lesezugriff |
subtask_of |
Enthält die UUID der Aufgaben, von denen diese Aufgabe eine Unteraufgabe ist | Lesezugriff |
subtasks |
Enthält die UUIDs aller Unteraufgaben dieser Aufgabe | Lesezugriff |
task-cancel
xe task-cancel [uuid=task_uuid]
<!--NeedCopy-->
Weisen Sie die angegebene Aufgabe an, abzubrechen und zurückzukehren.
Vorlagen-Befehle
Befehle für die Arbeit mit VM-Vorlagen.
Vorlagen sind im Wesentlichen VMs mit dem ist-eine-Vorlage
Parameter auf STIMMT
. Eine Vorlage ist ein “goldenes Image”, das alle verschiedenen Konfigurationseinstellungen zum Instanziieren einer bestimmten VM enthält. XenServer wird mit einem Basissatz von Vorlagen ausgeliefert, bei denen es sich um generische “rohe” VMs handelt, die eine Installations-CD des Betriebssystemanbieters (z. B. RHEL, CentOS, SLES, Windows) booten können. Sie können VMs erstellen, sie in Standardformularen für Ihre speziellen Anforderungen konfigurieren und eine Kopie davon als Vorlagen für die zukünftige Verwendung in der VM-Bereitstellung speichern.
Die Vorlagenobjekte können mit dem Standardbefehl für die Objektauflistung (xe template-liste
) und die Parameter, die mit den Standardparameterbefehlen bearbeitet wurden. Weitere Informationen finden Sie unter Parameterbefehle auf niedriger Ebene
Hinweis:
Vorlagen können nicht direkt in VMs konvertiert werden, indem das Kennzeichen
ist-eine-Vorlage
Parameter aufFALSCH
. Einstellungist-eine-Vorlage
Parameter aufFALSCH
wird nicht unterstützt und führt zu einer VM, die nicht gestartet werden kann.
Parameter für VM-Vorlagen
Vorlagen haben die folgenden Parameter:
-
UUID
(schreibgeschützt) die eindeutige Kennung/Objektreferenz für die Vorlage -
Namensschild
(Lesen/Schreiben) den Namen der Vorlage -
name-beschreibung
(Lese-/Schreibzugriff) die Beschreibungszeichenfolge des Templates -
Benutzer-Version
(Lese-/Schreibzugriff) Zeichenkette für Ersteller von VMs und Vorlagen zum Einfügen von Versionsinformationen -
ist-eine-Vorlage
(Lese-/Schreibzugriff) true, wenn es sich bei dieser VM um eine Vorlage handelt. Vorlagen-VMs können nie gestartet werden, sie werden nur zum Klonen anderer VMs verwendet. Nachdem dieser Wert auf “true” festgelegt wurde, kann er nicht mehr auf “false” zurückgesetzt werden. Vorlagen-VMs können mit diesem Parameter nicht in VMs konvertiert werden.Sie können eine VM in eine Vorlage konvertieren mit:
xe vm-param-set uuid=<vm uuid> is-a-template=true <!--NeedCopy-->
-
ist-kontrolle-domäne
(schreibgeschützt) true, wenn es sich um eine Steuerdomäne handelt (Domäne 0 oder Treiberdomäne) -
Energie-Zustand
(schreibgeschützt) aktueller Energiezustand. Der Wert wird für eine Vorlage immer angehalten -
memory-dynamic-max
(schreibgeschützt) dynamischer maximaler Speicher in Bytes. Derzeit nicht verwendet, aber wenn sie geändert wird, muss die folgende Einschränkung eingehalten werden:memory_static_max
>=
memory_dynamic_max
>=
memory_dynamic_min
>=
memory_static_min
. -
memory-dynamic-min
(Lesen/Schreiben) Dynamischer Mindestspeicher in Bytes. Derzeit nicht verwendet, aber wenn geändert, gelten die gleichen Einschränkungen fürmemory-dynamic-max
muss befolgt werden. -
speicher-statisch-max
(Lesen/Schreiben) statisch gesetzter (absoluter) maximaler Speicher in Bytes. Dieses Feld ist der Hauptwert, der verwendet wird, um die Menge an Arbeitsspeicher zu bestimmen, die einer VM zugewiesen ist. -
speicher-statisch-min
(Lesen/Schreiben) statisch gesetzter (absoluter) Mindestspeicher in Bytes. Dieses Feld stellt das absolute Minimum an Arbeitsspeicher dar, undspeicher-statisch-min
muss kleiner sein alsspeicher-statisch-max
. Dieser Wert wird im Normalbetrieb nicht verwendet, aber die vorherige Beschränkung muss eingehalten werden. -
suspend-VDI-uuid
(schreibgeschützt) der VDI, auf dem ein Suspend-Image gespeichert ist (hat keine Bedeutung für eine Vorlage) -
VCPUs-params
(Zuordnungsparameter mit Lese-/Schreibzugriff) für die ausgewählte vCPU-Richtlinie.Sie können das Pinning einer vCPU wie folgt optimieren:
xe template-param-set uuid=<template_uuid> vCPUs-params:mask=1,2,3 <!--NeedCopy-->
Eine VM, die aus dieser Vorlage erstellt wurde, kann nur auf den physischen CPUs 1, 2 und 3 ausgeführt werden.
Sie können auch die vCPU-Priorität (Xen-Planung) mit den Parametern cap und weight optimieren. Beispiel:
xe template-param-set uuid=<template_uuid> VCPUs-params:weight=512 xe template-param-set uuid=<template_uuid> VCPUs-params:cap=100 <!--NeedCopy-->
Eine VM, die auf dieser Vorlage basiert, mit einer Gewichtung von 512 erhält doppelt so viel CPU wie eine Domäne mit einer Gewichtung von 256 auf einem konkurrierenden Host. Zulässige Gewichtungen liegen zwischen 1 und 65535, und der Standardwert ist 256.
Die Obergrenze legt optional die maximale CPU-Menge fest, die eine auf dieser Vorlage basierende VM verbrauchen kann, selbst wenn der XenServer-Host CPU-Zyklen im Leerlauf hat. Die Obergrenze wird in Prozent einer physischen CPU ausgedrückt: 100 ist 1 physische CPU, 50 ist eine halbe CPU, 400 sind 4 CPUs und so weiter. Der Standardwert 0 bedeutet, dass es keine Obergrenze gibt.
-
VCPUs-max
(Lesen/Schreiben) Maximale Anzahl von vCPUs -
VCPUs-at-startup
(Lesen/Schreiben) Boot-Nummer von vCPUs -
Aktionen-nach-dem Absturz
(Lese-/Schreib-) Aktion, die ausgeführt werden soll, wenn eine auf dieser Vorlage basierende VM abstürzt -
console-uuids
(schreibgeschützter Parameter setzen) Virtuelle Konsolengeräte -
Bahnsteig
(Map-Parameter mit Lese-/Schreibzugriff) Plattformspezifische KonfigurationSo deaktivieren Sie die Emulation eines parallelen Ports für Gäste:
xe vm-param-set uuid=<vm_uuid> platform:parallel=none <!--NeedCopy-->
So deaktivieren Sie die Emulation einer seriellen Schnittstelle:
xe vm-param-set uuid=<vm_uuid> platform:hvm_serial=none <!--NeedCopy-->
So deaktivieren Sie die Emulation eines USB-Controllers und eines USB-Tablet-Geräts:
xe vm-param-set uuid=<vm_uuid> platform:usb=false xe vm-param-set uuid=<vm_uuid> platform:usb_tablet=false <!--NeedCopy-->
-
allowed-operations
(schreibgeschützter Parameter setzen) Liste der Operationen, die in diesem Zustand zulässig sind -
aktuelle-operationen
(schreibgeschützter Parameter setzen) Liste der Operationen, die derzeit in dieser Vorlage ausgeführt werden -
allowed-VBD-Geräte
(schreibgeschützter Set-Parameter) Liste der verfügbaren VBD-Bezeichner, dargestellt durch ganze Zahlen im Bereich von 0 bis 15. Diese Liste dient nur zu Informationszwecken, und andere Geräte können verwendet werden (funktionieren aber möglicherweise nicht). -
allowed-VIF-Geräte
(schreibgeschützter Set-Parameter) Liste der zur Verwendung verfügbaren VIF-Bezeichner, dargestellt durch Ganzzahlen im Bereich von 0 bis 15. Diese Liste dient nur zu Informationszwecken, und andere Geräte können verwendet werden (funktionieren aber möglicherweise nicht). -
HVM-boot-Richtlinie
(Lese-/Schreibzugriff) die Boot-Richtlinie für Gäste. Entweder BIOS-Reihenfolge oder eine leere Zeichenfolge. -
HVM-boot-params
(Zuordnungsparameter mit Lese-/Schreibzugriff) Der Schlüssel order steuert die Startreihenfolge des Gasts, die als Zeichenfolge dargestellt wird, wobei jedes Zeichen eine Startmethode ist: d für die CD/DVD, c für den Stammdatenträger und n für den Netzwerk-PXE-Start. Der Standardwert ist dc. -
PV-Kern
(Lese-/Schreib-) Pfad zum Kernel -
PV-RAM-Disk
(Lese-/Schreib-) Pfad zuminitrd
-
PV-Args
(Lese-/Schreibzugriff) Zeichenfolge von Kernel-Befehlszeilenargumenten -
PV-legacy-args
(Lese-/Schreibzugriff) Zeichenfolge von Argumenten, um Legacy-VMs, die auf dieser Vorlage basieren, booten zu lassen -
PV-Bootloader
(Lese-/Schreib-) Name oder Pfad zum Bootloader -
PV-bootloader-args
(Lesen/Schreiben) String mit verschiedenen Argumenten für den Bootloader -
last-boot-CPU-Flags
(schreibgeschützt) beschreibt die CPU-Flags, auf denen eine auf dieser Vorlage basierende VM zuletzt gebootet wurde. Nicht ausgefüllt für eine Vorlage -
wohnhaft auf
(schreibgeschützt) der XenServer-Host, auf dem sich eine auf dieser Vorlage basierende VM befindet. Erscheint alsNicht in der Datenbank
für eine Vorlage -
Affinität
(Lese-/Schreibzugriff) den XenServer-Host, auf dem eine auf dieser Vorlage basierende VM bevorzugt ausgeführt wird. Wird von derxe vm-start
, um zu entscheiden, wo die VM ausgeführt werden soll. Wird auch als Homeserver bezeichnet. -
Gruppen
(Lese-/Schreibzugriff) die VM-Gruppe, zu der diese VM gehört. Eine VM-Gruppe definiert, wo XenServer versucht, die VM zu starten oder zu evakuieren. -
andere-konfiguration
(Zuordnungsparameter mit Lese-/Schreibzugriff) Liste von Schlüssel-Wert-Paaren, die zusätzliche Konfigurationsparameter für die Vorlage angeben -
Startzeit
(schreibgeschützt) Zeitstempel des Datums und der Uhrzeit, zu der die Metriken für eine auf dieser Vorlage basierende VM gelesen wurden, in der FormyyyymmddThh:mm:ss z
, wobei z der einbuchstabige Indikator für die militärische Zeitzone ist, z. B. Z für UTC(GMT). Legen Sie fest auf1. Januar 1970 Z
(Beginn der Unix/POSIX-Epoche) für eine Vorlage -
installationszeit
(schreibgeschützt) Zeitstempel des Datums und der Uhrzeit, zu der die Metriken für eine auf dieser Vorlage basierende VM gelesen wurden, in der FormyyyymmddThh:mm:ss z
, wobei z der aus einem einzelnen Buchstaben bestehende militärische Zeitzonenindikator ist, z. B. Z für UTC (GMT). Legen Sie fest auf1. Januar 1970 Z
(Beginn der Unix/POSIX-Epoche) für eine Vorlage -
memory-actual
(schreibgeschützt) der tatsächliche Arbeitsspeicher, der von einer VM basierend auf dieser Vorlage verwendet wird; 0 für eine Vorlage -
VCPUs-Nummer
(schreibgeschützt) die Anzahl der virtuellen CPUs, die einer VM basierend auf dieser Vorlage zugewiesen wurden; 0 für eine Vorlage -
VCPUs-Auslastung
(schreibgeschützter Map-Parameter) Liste der virtuellen CPUs und ihrer Gewichtung, schreibgeschützter Map-ParameterOS-Version
die Version des Betriebssystems für eine VM, die auf dieser Vorlage basiert. Erscheint alsNicht in der Datenbank
für eine Vorlage -
PV-Treiber-Version
(schreibgeschützter Map-Parameter) die Versionen der paravirtualisierten Treiber für eine VM, die auf dieser Vorlage basiert. Erscheint alsNicht in der Datenbank
für eine Vorlage -
PV-Treiber erkannt
(schreibgeschützt) Flag für die neueste Version der paravirtualisierten Treiber für eine VM, die auf dieser Vorlage basiert. Erscheint alsNicht in der Datenbank
für eine Vorlage -
Gedächtnis
(schreibgeschützter Zuordnungsparameter) Speichermetriken, die vom Agent auf einer VM basierend auf dieser Vorlage gemeldet werden. Erscheint alsNicht in der Datenbank
für eine Vorlage -
Disketten
(schreibgeschützter Zuordnungsparameter) Datenträgermetriken, die vom Agent auf einer VM basierend auf dieser Vorlage gemeldet werden. Erscheint alsNicht in der Datenbank
für eine Vorlage -
Netzwerke
(schreibgeschützter Zuordnungsparameter) Netzwerkmetriken, die vom Agenten auf einer VM basierend auf dieser Vorlage gemeldet werden. Erscheint alsNicht in der Datenbank
für eine Vorlage -
andere
(schreibgeschützter Zuordnungsparameter) andere Metriken, die vom Agenten auf einer VM basierend auf dieser Vorlage gemeldet werden. Erscheint alsNicht in der Datenbank
für eine Vorlage -
guest-metrics-last-updated
(schreibgeschützt) Zeitstempel, zu dem der Gastagent den letzten Schreibvorgang in diese Felder ausgeführt hat. In der FormyyyymmddThh:mm:ss z
, wobei z der aus einem einzelnen Buchstaben bestehende militärische Zeitzonenindikator ist, z. B. Z für UTC (GMT) -
Aktionen nach dem Herunterfahren
(Lese-/Schreib-) Aktion, die nach dem Herunterfahren der VM ausgeführt werden soll -
Aktionen nach dem Neustart
(Lese-/Schreib-) Aktion, die nach dem Neustart der VM ausgeführt werden soll -
mögliche-hosts
(schreibgeschützt) Liste der Hosts, die die VM potenziell hosten können -
HVM-Schatten-Multiplikator
(Lese-/Schreib-) Multiplikator, der auf die Menge an Schatten angewendet wird, die dem Gast zur Verfügung gestellt wird -
DOM-Kennung
(schreibgeschützt) Domain-ID (falls vorhanden, -1 sonst) -
Empfehlungen
(schreibgeschützt) XML-Spezifikation von empfohlenen Werten und Bereichen für Eigenschaften dieser VM -
xenstore-daten
(Map-Parameter mit Lese-/Schreibzugriff) Daten, die in denXenstore
Baum (/local/domain/*domid*/vmdata
), nachdem die VM erstellt wurde. -
ist-ein-schnappschuss
(schreibgeschützt) True, wenn es sich bei dieser Vorlage um einen VM-Snapshot handelt -
snapshot_of
(schreibgeschützt) die UUID des virtuellen Computers, von dem diese Vorlage ein Snapshot ist -
Schnappschüsse
(schreibgeschützt) die UUIDs aller Snapshots, die von dieser Vorlage erstellt wurden -
snapshot_time
(schreibgeschützt) der Zeitstempel des letzten erstellten VM-Snapshots -
speicher-ziel
(schreibgeschützt) die Zielmenge an Arbeitsspeicher, die für diese Vorlage festgelegt ist -
blockierte Operationen
(Map-Parameter mit Lese-/Schreibzugriff) listet die Vorgänge auf, die für diese Vorlage nicht ausgeführt werden können -
Last-Boot-Datensatz
(schreibgeschützt) Aufzeichnung der letzten Boot-Parameter für dieses Template im XML-Format -
ha-immer-laufen
(Lesen/Schreiben) True, wenn eine Instanz dieser Vorlage immer auf einem anderen Host neu gestartet wird, wenn der Host, auf dem sie sich befindet, ausfällt. Dieser Parameter ist jetzt veraltet. Verwenden Sie die Schaltflächeha-restartpriority
-Parameter. -
ha-restart-priorität
(schreibgeschützt) Neustart oder Best-Effort-Lese-/Schreibzugriff für Blobs Binärdatenspeicher -
leben
(schreibgeschützt) nur für eine laufende VM relevant.
template-export
xe template-export template-uuid=uuid_of_existing_template filename=filename_for_new_template
<!--NeedCopy-->
Exportiert eine Kopie einer angegebenen Vorlage in eine Datei mit dem angegebenen neuen Dateinamen.
template-uninstall
xe template-uninstall template-uuid=template_uuid [--force]
<!--NeedCopy-->
Deinstallieren Sie eine benutzerdefinierte Vorlage. Dieser Vorgang zerstört die VDIs, die von dieser Vorlage als “im Besitz” markiert sind.
Update-Befehle
Der folgende Abschnitt enthält Befehle zum Aktualisieren des XenServer-Hosts.
Die Aktualisierungsobjekte können mit dem Standardbefehl für die Objektauflistung (xe update-liste
) und die Parameter, die mit den Standardparameterbefehlen bearbeitet wurden. Weitere Informationen finden Sie unter Parameterbefehle auf niedriger Ebene
Update-Parameter
XenServer-Hostupdates haben die folgenden Parameter:
Parametername | Beschreibung | Typ |
---|---|---|
uuid |
Die eindeutige Kennung/Objektreferenz für die Aktualisierung | Lesezugriff |
host |
Die Liste der Hosts, auf die dieses Update angewendet wird | Lesezugriff |
host-uuid |
Die eindeutige Kennung für den abzufragenden XenServer-Host | Lesezugriff |
name-label |
Der Name des Updates | Lesezugriff |
name-description |
Die Beschreibungszeichenfolge des Updates | Lesezugriff |
applied |
Gibt an, ob das Update angewendet wurde oder nicht; Wahr oder Falsch | Lesezugriff |
installation-size |
Die Größe des Updates in Byte | Lesezugriff |
after-apply-guidance |
Ob der XAPI-Toolstack oder der Host einen Neustart erfordert | Lesezugriff |
version |
Die Version des Updates | Lesezugriff |
update-upload
xe update-upload file-name=update_filename
<!--NeedCopy-->
Laden Sie eine angegebene Update-Datei auf den XenServer-Host hoch. Mit diesem Befehl wird ein Update vorbereitet, das angewendet werden soll. Bei Erfolg wird die UUID des hochgeladenen Updates gedruckt. Wenn das Update bereits hochgeladen wurde, UPDATE_ALREADY_EXISTS
Stattdessen wird ein Fehler zurückgegeben und der Patch wird nicht erneut hochgeladen.
update-precheck
xe update-precheck uuid=update_uuid host-uuid=host_uuid
<!--NeedCopy-->
Führen Sie die im angegebenen Update enthaltenen Vorabüberprüfungen auf dem angegebenen XenServer-Host aus.
update-destroy
xe update-destroy uuid=update_file_uuid
<!--NeedCopy-->
Löscht eine Aktualisierungsdatei, die nicht aus dem Pool angewendet wurde. Kann verwendet werden, um eine Aktualisierungsdatei zu löschen, die nicht auf die Hosts angewendet werden kann.
update-apply
xe update-apply host-uuid=host_uuid uuid=update_file_uuid
<!--NeedCopy-->
Wenden Sie die angegebene Update-Datei an.
update-pool-apply
xe update-pool-apply uuid=update_uuid
<!--NeedCopy-->
Wenden Sie das angegebene Update auf alle XenServer-Hosts im Pool an.
update-introduce
xe update-introduce vdi-uuid=vdi_uuid
<!--NeedCopy-->
Führen Sie das Update VDI ein.
update-pool-clean
xe update-pool-clean uuid=uuid
<!--NeedCopy-->
Entfernt die Dateien des Updates von allen Hosts im Pool.
Benutzerbefehle
user-password-change
xe user-password-change old=old_password new=new_password
<!--NeedCopy-->
Ändert das Passwort des angemeldeten Benutzers. Das alte Kennwortfeld wird nicht überprüft, da Sie für die Verwendung dieses Befehls die Berechtigung eines Supervisors benötigen.
VBD-Befehle
Befehle für die Arbeit mit VBDs (Virtual Block Devices).
Ein VBD ist ein Softwareobjekt, das eine VM mit dem VDI verbindet, der den Inhalt des virtuellen Datenträgers darstellt. Die VBD verfügt über die Attribute, die den VDI an die VM binden (ist sie bootfähig, ihre Lese-/Schreibmetriken usw.). Der VDI verfügt über Informationen zu den physischen Attributen des virtuellen Laufwerks (welcher SR-Typ, ob das Laufwerk gemeinsam genutzt werden kann, ob das Medium Lese-/Schreibzugriff oder schreibgeschützt ist usw.).
Die VBD-Objekte können mit dem Standardbefehl für die Objektauflistung (XE VBD-Liste
) und die Parameter, die mit den Standardparameterbefehlen bearbeitet wurden. Weitere Informationen finden Sie unter Parameterbefehle auf niedriger Ebene
VBD-Parameter
VBDs haben die folgenden Parameter:
Parametername | Beschreibung | Typ |
---|---|---|
uuid |
Die eindeutige Kennung/Objektreferenz für die VBD | Lesezugriff |
vm-uuid |
Die eindeutige Kennung/Objektreferenz für die VM, an die diese VBD angehängt ist | Lesezugriff |
vm-name-label |
Der Name der VM, an die diese VBD angehängt ist | Lesezugriff |
vdi-uuid |
Die eindeutige Kennung/Objektreferenz für den VDI, dem diese VBD zugeordnet ist | Lesezugriff |
vdi-name-label |
Der Name des VDI, dem diese VBD zugeordnet ist | Lesezugriff |
empty |
Wenn STIMMT , stellt diese VBD ein leeres Laufwerk dar |
Lesezugriff |
device |
Das Gerät, das der Gast sieht, z. B. hatte
|
Lesezugriff |
userdevice |
Gerätenummer, die durch den Geräteparameter während vbd-create , z. B. 0 für hatte , 1 für HDB Und so weiter |
Lesen/Schreiben |
bootable |
True, wenn diese VBD bootfähig ist | Lesen/Schreiben |
mode |
Der Modus, in dem die VBD gemountet wird | 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, sonst false | Lesezugriff |
storage-lock |
True, wenn eine Sperre auf Lagerebene erworben wurde | Lesezugriff |
status-code |
Fehler-/Erfolgscode, der dem letzten Anfügevorgang zugeordnet ist | Lesezugriff |
status-detail |
Fehler-/Erfolgsinformationen, die dem Status des letzten Anfügevorgangs zugeordnet sind | Lesezugriff |
qos_algorithm_type |
Der zu verwendende Priorisierungsalgorithmus | Lesen/Schreiben |
qos_algorithm_params |
Parameter für den gewählten Priorisierungsalgorithmus | Map-Parameter mit Lese-/Schreibzugriff |
qos_supported_algorithms |
Unterstützte Priorisierungsalgorithmen für diese VBD | Schreibgeschützter Parameter setzen |
io_read_kbs |
Durchschnittliche Leserate in kB pro Sekunde für diese VBD | Lesezugriff |
io_write_kbs |
Durchschnittliche Schreibrate in kB pro Sekunde für diese VBD | Lesezugriff |
allowed-operations |
Liste der Vorgänge, die in diesem Status zulässig sind. Diese Liste ist nur eine Empfehlung, und der Serverstatus hat sich möglicherweise geändert, wenn dieses Feld von einem Client gelesen wird. | Schreibgeschützter Parameter setzen |
current-operations |
Verknüpft jede der ausgeführten Aufgaben, die dieses Objekt verwenden (als Referenz), mit einer current_operation Enumeration, die die Art der Aufgabe beschreibt. | Schreibgeschützter Parameter setzen |
unpluggable |
True, wenn diese VBD das Hot-Unplug unterstützt | Lesen/Schreiben |
attachable |
True, wenn das Gerät angeschlossen werden kann | Lesezugriff |
other-config |
Zusätzliche Konfiguration | Map-Parameter mit Lese-/Schreibzugriff |
vbd-create
xe vbd-create vm-uuid=uuid_of_the_vm device=device_value vdi-uuid=uuid_of_vdi_to_connect_to [bootable=true] [type=Disk|CD] [mode=RW|RO]
<!--NeedCopy-->
Erstellen Sie eine VBD auf einer VM.
Die zulässigen Werte für die Gerät
sind ganze Zahlen von 0 bis 15, und die Zahl muss für jede VM eindeutig sein. Die aktuell zulässigen Werte sind in der allowed-VBD-Geräte
auf der angegebenen VM. Dies wird als BenutzerGerät
im VBD
Parameter.
Wenn die Option Art
ist Scheibe
, VDI-UUID
ist erforderlich. Der Modus kann sein RO
oder RW
für eine Festplatte.
Wenn die Option Art
ist CD
, VDI-UUID
ist optional. Wenn kein VDI angegeben ist, wird eine leere VBD für die CD erstellt. Der Modus muss RO
für eine CD.
vbd-destroy
xe vbd-destroy uuid=uuid_of_vbd
<!--NeedCopy-->
Zerstört die angegebene VBD.
Wenn die VBD über ihre other-config:Eigentümer
Parameter auf STIMMT
, wird auch der zugehörige VDI zerstört.
vbd-eject
xe vbd-eject uuid=uuid_of_vbd
<!--NeedCopy-->
Entfernen Sie das Medium von dem Laufwerk, das durch eine VBD dargestellt wird. Dieser Befehl funktioniert nur, wenn es sich bei dem Medium um einen Wechseldatenträger handelt (eine physische CD oder eine ISO-Datei). Andernfalls wird eine Fehlermeldung angezeigt VBD_NOT_REMOVABLE_MEDIA
zurückgegeben wird.
vbd-insert
xe vbd-insert uuid=uuid_of_vbd vdi-uuid=uuid_of_vdi_containing_media
<!--NeedCopy-->
Legen Sie neue Medien in das Laufwerk ein, das durch ein VBD dargestellt wird. Dieser Befehl funktioniert nur, wenn es sich bei dem Medium um einen Wechseldatenträger handelt (eine physische CD oder eine ISO-Datei). Andernfalls wird eine Fehlermeldung angezeigt VBD_NOT_REMOVABLE_MEDIA
zurückgegeben wird.
vbd-plug
xe vbd-plug uuid=uuid_of_vbd
<!--NeedCopy-->
Versuchen Sie, die VBD anzufügen, während sich die VM im Ausführungszustand befindet.
vbd-unplug
xe vbd-unplug uuid=uuid_of_vbd
<!--NeedCopy-->
Versucht, die VBD von der VM zu trennen, während sie sich im Ausführungszustand befindet.
VDI-Befehle
Befehle für die Arbeit mit VDIs (Virtual Disk Images).
Ein VDI ist ein Softwareobjekt, das den Inhalt des virtuellen Laufwerks darstellt, das von einer VM angezeigt wird. Dies unterscheidet sich von der VBD, bei der es sich um ein Objekt handelt, das eine VM an den VDI bindet. Der VDI verfügt über Informationen zu den physischen Attributen des virtuellen Laufwerks (welcher SR-Typ, ob das Laufwerk gemeinsam genutzt werden kann, ob das Medium Lese-/Schreibzugriff oder schreibgeschützt ist usw.). Die VBD verfügt über die Attribute, die die VDI an die VM binden (ist sie startbar, ihre Lese-/Schreibmetriken usw.).
Die VDI-Objekte können mit dem Standardbefehl für die Objektauflistung (XE VDI-Liste
) und die Parameter, die mit den Standardparameterbefehlen bearbeitet wurden. Weitere Informationen finden Sie unter Parameterbefehle auf niedriger Ebene
VDI-Parameter
VDIs haben die folgenden Parameter:
Parametername | Beschreibung | Typ |
---|---|---|
uuid |
Die eindeutige Kennung/Objektreferenz für den VDI | Lesezugriff |
name-label |
Der Name des VDI | Lesen/Schreiben |
name-description |
Die Beschreibungszeichenfolge des VDI | Lesen/Schreiben |
allowed-operations |
Eine Liste der Vorgänge, die in diesem Zustand zulässig sind | Schreibgeschützter Parameter setzen |
current-operations |
Eine Liste der Vorgänge, die derzeit auf diesem VDI ausgeführt werden | Schreibgeschützter Parameter setzen |
sr-uuid |
SR, in dem sich der VDI befindet | Lesezugriff |
vbd-uuids |
Eine Liste der VBDs, die auf diesen VDI verweisen | Schreibgeschützter Parameter setzen |
crashdump-uuids |
Liste der Absturzabbilder, die sich auf diesen VDI beziehen | Schreibgeschützter Parameter setzen |
virtual-size |
Größe des Datenträgers, wie er der VM angezeigt wird, in Bytes. Je nach Art des Speicher-Backends kann es sein, dass die Größe nicht genau eingehalten wird | Lesezugriff |
physical-utilisation |
Menge an physischem Speicherplatz, die die VDI auf der SR belegt, in Byte | Lesezugriff |
type |
Typ des VDI, z. B. System oder Benutzer | Lesezugriff |
sharable |
True, wenn dieser VDI freigegeben werden kann | Lesezugriff |
read-only |
True, wenn dieser VDI nur schreibgeschützt gemountet werden kann | Lesezugriff |
storage-lock |
True, wenn dieser VDI auf Speicherebene gesperrt ist | Lesezugriff |
parent |
Verweist auf den übergeordneten VDI, wenn dieser VDI Teil einer Kette ist | Lesezugriff |
missing |
True, wenn der SR-Scanvorgang diesen VDI als nicht vorhanden gemeldet hat | Lesezugriff |
other-config |
Zusätzliche Konfigurationsinformationen für diesen VDI | Map-Parameter mit Lese-/Schreibzugriff |
sr-name-label |
Name des enthaltenden Speicher-Repositorys | Lesezugriff |
location |
Standortinformationen | Lesezugriff |
managed |
True, wenn die VDI verwaltet wird | Lesezugriff |
xenstore-data |
Daten, die in die Xenstore Baum (/local/domain/0/backend/ vbd/domid/Geräte-ID/smdata), nachdem der VDI angehängt wurde. Die SM-Backends setzen dieses Feld normalerweise auf vdi_attach . |
Schreibgeschützter Map-Parameter |
sm-config |
SM-abhängige Daten | Schreibgeschützter Map-Parameter |
is-a-snapshot |
True, wenn es sich bei diesem VDI um einen VM-Speicher-Snapshot handelt | Lesezugriff |
snapshot_of |
Die UUID des Speichers, von dem dieser VDI ein Snapshot ist | Lesezugriff |
snapshots |
Die UUIDs aller Snapshots dieser VDI | Lesezugriff |
snapshot_time |
Der Zeitstempel des Snapshot-Vorgangs, der diesen VDI erstellt hat | Lesezugriff |
metadata-of-pool |
Die UUID des Pools, der diese Metadaten erstellt hat VDI | Lesezugriff |
metadata-latest |
Flag, das angibt, ob der VDI die neuesten bekannten Metadaten für diesen Pool enthält | Lesezugriff |
cbt-enabled |
Flag, das angibt, ob die Nachverfolgung geänderter Blöcke für den VDI aktiviert ist | Lesen/Schreiben |
vdi-clone
xe vdi-clone uuid=uuid_of_the_vdi [driver-params:key=value]
<!--NeedCopy-->
Erstellen Sie eine neue, beschreibbare Kopie der angegebenen VDI, die direkt verwendet werden kann. Es ist eine Variante von VDI-Kopie
Das heißt, kann Hochgeschwindigkeits-Image-Clone-Funktionen verfügbar machen, wo sie vorhanden sind.
Verwenden Sie die optionale driver-params
map-Parameter, um zusätzliche herstellerspezifische Konfigurationsinformationen an den Back-End-Speichertreiber zu übergeben, auf dem die VDI basiert. Weitere Informationen finden Sie in der Dokumentation zu Treibern des Speicheranbieters.
vdi-copy
xe vdi-copy uuid=uuid_of_the_vdi sr-uuid=uuid_of_the_destination_sr
<!--NeedCopy-->
Kopieren Sie eine VDI in eine angegebene SR.
vdi-create
xe vdi-create sr-uuid=uuid_of_sr_to_create_vdi_on name-label=name_for_the_vdi type=system|user|suspend|crashdump virtual-size=size_of_virtual_disk sm-config-\*=storage_specific_configuration_data
<!--NeedCopy-->
Erstellen Sie einen VDI.
Das virtuelle Größe
kann in Bytes oder mit den IEC-Standard-Suffixen KiB, MiB, GiB und TiB angegeben werden.
Hinweis:
SR-Typen, die Thin Provisioning von Datenträgern unterstützen (z. B. lokale VHD und NFS), erzwingen keine virtuelle Zuordnung von Datenträgern. Seien Sie sehr vorsichtig, wenn Sie virtuellen Festplattenspeicher auf einer SR übermäßig belegen. Wenn eine überlastete SR voll wird, muss Speicherplatz entweder auf dem SR-Zielsubstrat oder durch Löschen nicht verwendeter VDIs in der SR zur Verfügung gestellt werden.
Einige SR-Typen können die
virtuelle Größe
value, um ihn durch eine konfigurierte Blockgröße teilbar zu machen.
vdi-data-destroy
xe vdi-data-destroy uuid=uuid_of_vdi
<!--NeedCopy-->
Zerstören Sie die Daten, die dem angegebenen VDI zugeordnet sind, behalten Sie jedoch die geänderten Metadaten zur Blocknachverfolgung bei.
Hinweis:
Wenn Sie die Nachverfolgung geänderter Blöcke verwenden, um inkrementelle Sicherungen des VDI zu erstellen, stellen Sie sicher, dass Sie die
vdi-datenvernichtung
, um Snapshots zu löschen, aber die Metadaten beizubehalten. Nicht verwendenvdi-zerstören
auf Snapshots von VDIs, für die die Blocknachverfolgung für Änderungen aktiviert ist.
vdi-destroy
xe vdi-destroy uuid=uuid_of_vdi
<!--NeedCopy-->
Zerstören Sie den angegebenen VDI.
Hinweis:
Wenn Sie die Nachverfolgung geänderter Blöcke verwenden, um inkrementelle Sicherungen des VDI zu erstellen, stellen Sie sicher, dass Sie die
vdi-datenvernichtung
, um Snapshots zu löschen, aber die Metadaten beizubehalten. Nicht verwendenvdi-zerstören
auf Snapshots von VDIs, für die die Blocknachverfolgung für Änderungen aktiviert ist.Bei lokalen VHD- und NFS-SR-Typen wird der Speicherplatz nicht sofort freigegeben
vdi-zerstören
, jedoch in regelmäßigen Abständen während eines Speicher-Repository-Scanvorgangs. Wenn Sie erzwingen müssen, dass gelöschter Speicherplatz verfügbar gemacht wird, rufen Siesr-scan
manuell.
vdi-disable-cbt
xe vdi-disable-cbt uuid=uuid_of_vdi
<!--NeedCopy-->
Deaktivieren Sie die Nachverfolgung geänderter Blöcke für den VDI.
vdi-enable-cbt
xe vdi-enable-cbt uuid=uuid_of_vdi
<!--NeedCopy-->
Aktivieren Sie die Nachverfolgung geänderter Blöcke für den VDI.
Hinweis:
Sie können die Nachverfolgung geänderter Blöcke nur für lizenzierte Instanzen von XenServer Premium Edition aktivieren.
vdi-export
xe vdi-export uuid=uuid_of_vdi filename=filename_to_export_to [format=format] [base=uuid_of_base_vdi] [--progress]
<!--NeedCopy-->
Exportieren Sie eine VDI in den angegebenen Dateinamen. Sie können eine VDI in einem der folgenden Formate exportieren:
raw
vhd
Das VHD-Format kann spärlich. Wenn in der VDI nicht zugeordnete Blöcke vorhanden sind, werden diese Blöcke möglicherweise in der VHD-Datei weggelassen, wodurch die VHD-Datei verkleinert wird. Sie können von allen unterstützten VHD-basierten Speichertypen (EXT3/EXT4, NFS) in das VHD-Format exportieren.
Wenn Sie die Option Basis
exportiert dieser Befehl nur die Blöcke, die sich zwischen dem exportierten VDI und dem Basis-VDI geändert haben.
vdi-forget
xe vdi-forget uuid=uuid_of_vdi
<!--NeedCopy-->
Entfernt einen VDI-Datensatz bedingungslos aus der Datenbank, ohne das Speicher-Backend zu berühren. Verwenden Sie im Normalbetrieb vdi-zerstören
stattdessen.
vdi-import
xe vdi-import uuid=uuid_of_vdi filename=filename_to_import_from [format=format] [--progress]
<!--NeedCopy-->
Importieren Sie eine VDI. Sie können eine VDI in einem der folgenden Formate importieren:
raw
vhd
vdi-introduce
xe vdi-introduce uuid=uuid_of_vdi sr-uuid=uuid_of_sr name-label=name_of_new_vdi type=system|user|suspend|crashdump location=device_location_(varies_by_storage_type) [name-description=description_of_vdi] [sharable=yes|no] [read-only=yes|no] [other-config=map_to_store_misc_user_specific_data] [xenstore-data=map_to_of_additional_xenstore_keys] [sm-config=storage_specific_configuration_data]
<!--NeedCopy-->
Erstellen Sie ein VDI-Objekt, das ein vorhandenes Speichergerät darstellt, ohne den Speicher tatsächlich zu ändern oder zu erstellen. Dieser Befehl wird hauptsächlich intern verwendet, um Hot-Plugged-Speichergeräte automatisch einzuführen.
vdi-list-changed-blocks
xe vdi-list-changed-blocks vdi-from-uuid=first-vdi-uuid vdi-to-uuid=second-vdi-uuid
<!--NeedCopy-->
Vergleichen Sie zwei VDIs, und geben Sie die Liste der Blöcke, die sich zwischen den beiden geändert haben, als base64-codierte Zeichenfolge zurück. Dieser Befehl funktioniert nur für VDIs, für die die Änderungsblockverfolgung aktiviert ist.
Weitere Informationen finden Sie unter Geänderte Blockverfolgung.
vdi-pool-migrate
xe vdi-pool-migrate uuid=VDI_uuid sr-uuid=destination-sr-uuid
<!--NeedCopy-->
Migrieren Sie eine VDI zu einer angegebenen SR, während die VDI an einen ausgeführten Gast angehängt ist. (Live-Migration des Speichers)
Weitere Informationen finden Sie unter Migrieren von VMs.
vdi-resize
xe vdi-resize uuid=vdi_uuid disk-size=new_size_for_disk
<!--NeedCopy-->
Ändern Sie die Größe der von der UUID angegebenen VDI.
vdi-snapshot
xe vdi-snapshot uuid=uuid_of_the_vdi [driver-params=params]
<!--NeedCopy-->
Erstellt eine Lese-/Schreibversion einer VDI, die als Referenz für Sicherungs- oder Vorlagenerstellungszwecke oder beides verwendet werden kann. Verwenden Sie den Snapshot, um eine Sicherung durchzuführen, anstatt Sicherungssoftware auf 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. In ähnlicher Weise kann ein Schnappschuss als “goldenes Bild” verwendet werden, auf dem eine Vorlage basiert. Eine Vorlage kann mit beliebigen VDIs erstellt werden.
Verwenden Sie die optionale driver-params
map-Parameter, um zusätzliche herstellerspezifische Konfigurationsinformationen an den Back-End-Speichertreiber zu übergeben, auf dem die VDI basiert. Weitere Informationen finden Sie in der Dokumentation zu Treibern des Speicheranbieters.
Ein Klon eines Snapshots erzeugt immer einen beschreibbaren VDI.
vdi-unlock
xe vdi-unlock uuid=uuid_of_vdi_to_unlock [force=true]
<!--NeedCopy-->
Versucht, die angegebenen VDIs zu entsperren. Wenn Kraft=wahr
an den Befehl übergeben wird, erzwingt er den Entsperrvorgang.
vdi-update
xe vdi-update uuid=uuid
<!--NeedCopy-->
Aktualisieren Sie die Felder des VDI-Objekts in der Datenbank.
VIF-Befehle
Befehle für die Arbeit mit VIFs (Virtual Network Interfaces).
Die VIF-Objekte können mit dem Standardbefehl für die Objektauflistung (xe vif-liste
) und die Parameter, die mit den Standardparameterbefehlen bearbeitet wurden. Weitere Informationen finden Sie unter Parameterbefehle auf niedriger Ebene
VIF-Parameter
VIFs haben die folgenden Parameter:
-
UUID
(schreibgeschützt) die eindeutige Kennung/Objektreferenz für die VIF -
vm-uuid
(schreibgeschützt) die eindeutige Kennung/Objektreferenz für die VM, auf der sich diese VIF befindet -
vm-name-beschriftung
(schreibgeschützt) der Name der VM, auf der sich diese VIF befindet -
allowed-operations
(schreibgeschützter Parameter setzen) eine Liste der Operationen, die in diesem Zustand zulässig sind -
aktuelle-operationen
(schreibgeschützter Parameter setzen) eine Liste der Operationen, die derzeit auf dieser VIF ausgeführt werden -
Gerät
(schreibgeschützt) ganzzahliges Label dieses VIF, das die Reihenfolge angibt, in der VIF-Backends erstellt wurden -
MAC
(schreibgeschützt) MAC-Adresse der VIF, wie sie für die VM verfügbar gemacht wird -
MTU
(schreibgeschützt) Maximale Übertragungseinheit der VIF in Bytes.Dieser Parameter ist schreibgeschützt, aber Sie können die MTU-Einstellung mit dem
Mtu
mit der Tasteandere-konfiguration
map-Parameter. So setzen Sie z. B. die MTU auf einer virtuellen Netzwerkkarte zurück, um Jumbo-Frames zu verwenden:xe vif-param-set \ uuid=<vif_uuid> \ other-config:mtu=9000 <!--NeedCopy-->
-
Aktuell angehängt
(schreibgeschützt) true, wenn das Gerät angeschlossen ist -
qos_algorithm_type
(Lesen/Schreiben) Zu verwendender QoS-Algorithmus -
qos_algorithm_params
(Map-Parameter mit Lese-/Schreibzugriff) für den ausgewählten QoS-Algorithmus -
qos_supported_algorithms
(schreibgeschützter Parameter setzen) unterstützte QoS-Algorithmen für diese VIF -
MAC-automatisch generiert
(schreibgeschützt) True, wenn die MAC-Adresse der VIF automatisch generiert wurde -
andere-konfiguration
(Map-Parameter lesen/schreiben) zusätzliche KonfigurationSchlüssel:Wert
Paare -
andere-konfiguration:ethtoolrx
(Lesen/Schreiben) auf “Ein” gesetzt, um den Empfang der Prüfsumme zu aktivieren, “Aus” zum Deaktivieren -
andere-konfiguration:ethtooltx
(Lesen/Schreiben) auf Ein setzen, um die Sendeprüfsumme zu aktivieren, Aus, um zu deaktivieren -
other-config:ethtoolsg
(Lesen/Schreiben) auf Ein setzen, um Scatter Gather zu aktivieren, Aus zum Deaktivieren -
other-config:ethtooltso
(Lese-/Schreibzugriff) auf “Ein” gesetzt, um die TCP-Segmentierungsauslagerung zu aktivieren, auf “Aus”, um die Funktion zu deaktivieren -
andere-konfiguration:ethtoolufo
(Lese-/Schreibzugriff) auf “Ein” gesetzt, um das Auslagern von UDP-Fragmenten zu aktivieren, auf “Aus” zum Deaktivieren -
andere-konfiguration:ethtoolgso
(Lese-/Schreibzugriff) auf Ein setzen, um die generische Segmentierungsauslagerung zu aktivieren, Aus auf Deaktivieren -
andere-konfiguration:promiskuitiv
(Lese-/Schreibzugriff) getreu einer VIF, um auf der Brücke promiskuitiv zu sein, so dass sie den gesamten Datenverkehr über die Brücke sieht. Nützlich für die Ausführung eines Intrusion Detection Systems (IDS) oder Ähnliches in einer VM. -
network-uuid
(schreibgeschützt) die eindeutige Kennung/Objektreferenz des virtuellen Netzwerks, mit dem diese VIF verbunden ist -
Netzwerk-Namensbezeichnung
(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) Wirkt sich auf die Fähigkeit der VIFs aus, Datenverkehr zu/von einer Liste von MAC- und IP-Adressen zu filtern. Erfordert zusätzliche Parameter. -
locking_mode:default
(Lesen/Schreiben) Variiert je nach dem Standardsperrmodus für das VIF-Netzwerk.Wenn der default-locking-mode auf
arbeitsunfähig
wendet XenServer eine Filterregel an, sodass die VIF keinen Datenverkehr senden oder empfangen kann. Wenn default-lockingmode aufunverschlossen
entfernt XenServer alle Filterregeln, die dem VIF zugeordnet sind. Weitere Informationen finden Sie unter Netzwerk-Befehle. -
locking_mode:gesperrt
(Lesen/Schreiben) Nur Datenverkehr, der an die angegebenen MAC- und IP-Adressen gesendet oder von diesen gesendet wird, ist auf dem VIF zulässig. Wenn keine IP-Adressen angegeben sind, ist kein Datenverkehr zulässig. -
locking_mode:entsperrt
(Lesen/Schreiben) Es werden keine Filter auf den Datenverkehr angewendet, der zum oder vom VIF geht. -
locking_mode:deaktiviert
(Lesen/Schreiben) XenServer wendet eine Filterregel an, die angewendet wird, sodass die VIF den gesamten Datenverkehr verwirft.
vif-create
xe vif-create vm-uuid=uuid_of_the_vm device=see below network-uuid=uuid_of_network_to_connect_to [mac=mac_address]
<!--NeedCopy-->
Erstellen Sie eine VIF auf einer VM.
Geeignete Werte für die Gerät
sind im Parameter allowed-VIF-Geräte
auf der angegebenen VM. Bevor dort VIFs vorhanden sind, sind Ganzzahlen von 0 bis 15 zulässig.
Das mac
ist die Standard-MAC-Adresse in der Form aa:bb:cc:dd:ee:ff
. Wenn Sie sie nicht angeben, wird eine entsprechende zufällige MAC-Adresse erstellt. Sie können auch explizit eine zufällige MAC-Adresse festlegen, indem Sie mac=zufällig
.
vif-destroy
xe vif-destroy uuid=uuid_of_vif
<!--NeedCopy-->
Zerstöre einen VIF.
vif-move
xe vif-move uuid=uuid network-uuid=network_uuid
<!--NeedCopy-->
Verschieben Sie die VIF in ein anderes Netzwerk.
vif-plug
xe vif-plug uuid=uuid_of_vif
<!--NeedCopy-->
Versuchen Sie, die VIF anzufügen, während sich die VM im Ausführungszustand befindet.
vif-unplug
xe vif-unplug uuid=uuid_of_vif
<!--NeedCopy-->
Versucht, die VIF von der VM zu trennen, während sie ausgeführt wird.
vif-configure-ipv4
Konfigurieren Sie die IPv4-Einstellungen für diese virtuelle Schnittstelle. Legen Sie die IPv4-Einstellungen wie folgt fest:
xe vif-configure-ipv4 uuid=uuid_of_vif mode=static address=CIDR_address gateway=gateway_address
<!--NeedCopy-->
Beispiel:
VIF.configure_ipv4(vifObject,"static", " 192.168.1.10/24", " 192.168.1.1")
<!--NeedCopy-->
Bereinigen Sie die IPv4-Einstellungen wie folgt:
xe vif-configure-ipv4 uuid=uuid_of_vif mode=none
<!--NeedCopy-->
vif-configure-ipv6
Konfigurieren Sie die IPv6-Einstellungen für diese virtuelle Schnittstelle. Legen Sie die IPv6-Einstellungen wie folgt fest:
xe vif-configure-ipv6 uuid=uuid_of_vif mode=static address=IP_address gateway=gateway_address
<!--NeedCopy-->
Beispiel:
VIF.configure_ipv6(vifObject,"static", "fd06:7768:b9e5:8b00::5001/64", "fd06:7768:b9e5:8b00::1")
<!--NeedCopy-->
Bereinigen Sie die IPv6-Einstellungen wie folgt:
xe vif-configure-ipv6 uuid=uuid_of_vif mode=none
<!--NeedCopy-->
VLAN-Befehle
Befehle für die Arbeit mit VLANs (virtuellen Netzwerken). Informationen zum Auflisten und Bearbeiten virtueller Schnittstellen finden Sie in den PIF-Befehlen, die über einen VLAN-Parameter verfügen, um zu signalisieren, dass ihnen ein virtuelles Netzwerk zugeordnet ist. Weitere Informationen finden Sie unter PIF-Befehle. Um beispielsweise VLANs aufzulisten, verwenden Sie xe pif-list
.
vlan-create
xe vlan-create pif-uuid=uuid_of_pif vlan=vlan_number network-uuid=uuid_of_network
<!--NeedCopy-->
Erstellen Sie ein VLAN auf Ihrem XenServer-Host.
pool-vlan-create
xe pool-vlan-create pif-uuid=uuid_of_pif vlan=vlan_number network-uuid=uuid_of_network
<!--NeedCopy-->
Erstellen Sie ein VLAN auf allen Hosts in einem Pool, indem Sie bestimmen, welche Schnittstelle (z. B. ETH0
) das angegebene Netzwerk eingeschaltet ist (auf jedem Host) und ein neues PIF-Objekt auf jedem Host entsprechend erstellt und eingesteckt wird.
vlan-destroy
xe vlan-destroy uuid=uuid_of_pif_mapped_to_vlan
<!--NeedCopy-->
Zerstören Sie ein VLAN. Erfordert die UUID des PIF, der das VLAN darstellt.
VM-Befehle
Befehle zum Steuern von VMs und deren Attributen.
VM-Selektoren
Einige der hier aufgeführten Befehle verfügen über einen gemeinsamen Mechanismus zum Auswählen einer oder mehrerer VMs, auf denen der Vorgang ausgeführt werden soll. Der einfachste Weg besteht darin, das Argument anzugeben vm=name_or_uuid
. Eine einfache Möglichkeit, die UUID einer tatsächlichen VM abzurufen, besteht z. B. darin, xe vm-list power-state=laufend
. (Rufen Sie die vollständige Liste der Felder ab, die mit dem Befehl xe vm-list params=alle
. ) Wenn Sie z. B. power-state=gestoppt
wählt VMs aus, deren Energie-Zustand
Parameter ist gleich gestoppt
. Wenn mehrere VMs übereinstimmen, geben Sie die Option --mehrfach
, um den Vorgang auszuführen. Die vollständige Liste der Parameter, die abgeglichen werden können, wird am Anfang dieses Abschnitts beschrieben.
Die VM-Objekte können mit dem Standardbefehl für die Objektauflistung (xe vm-list
) und die Parameter, die mit den Standardparameterbefehlen bearbeitet wurden. Weitere Informationen finden Sie unter Parameterbefehle auf niedriger Ebene
VM-Parameter
VMs verfügen über die folgenden Parameter:
Hinweis:
Alle beschreibbaren VM-Parameterwerte können geändert werden, während die VM ausgeführt wird, aber neue Parameter werden nicht wird dynamisch angewendet und kann erst angewendet werden, wenn die VM neu gestartet wird.
-
Gerät
(Lese-/Schreibzugriff) der Appliance/vApp, zu der die VM gehört -
UUID
(schreibgeschützt) die eindeutige Kennung/Objektreferenz für die VM -
Namensschild
(Lese-/Schreibzugriff) den Namen der VM -
name-beschreibung
(Lese-/Schreibzugriff) die Beschreibungszeichenfolge der VM -
Bestellung
(Lese-/Schreibzugriff) für das Starten/Herunterfahren von vApps und für den Start nach einem HA-Failover. Zuerst werden VMs mit einem Bestellwert von 0 (Null) gestartet, dann VMs mit einem Bestellwert von 1 usw. -
Version
(schreibgeschützt) Die Häufigkeit, mit der diese VM wiederhergestellt wurde. Wenn Sie eine neue VM mit einer älteren Version überschreiben möchten, rufen Sievm-recover
-
Benutzer-Version
(Lese-/Schreibzugriff) Zeichenkette für Ersteller von VMs und Vorlagen zum Einfügen von Versionsinformationen -
ist-eine-Vorlage
(Lesen/Schreiben) False, es sei denn, es handelt sich bei dieser VM um eine Vorlage. Vorlagen-VMs können nie gestartet werden, sie werden nur zum Klonen anderer VMs verwendet. Nachdem dieser Wert auf true gesetzt wurde, kann er nicht mehr auf false zurückgesetzt werden. Vorlagen-VMs können mit diesem Parameter nicht in VMs konvertiert werden.Sie können eine VM in eine Vorlage konvertieren mit:
xe vm-param-set uuid=<vm uuid> is-a-template=true <!--NeedCopy-->
-
ist-kontrolle-domäne
(schreibgeschützt) True, wenn es sich um eine Steuerdomäne handelt (Domäne 0 oder Treiberdomäne) -
Energie-Zustand
(schreibgeschützt) aktueller Energiezustand -
Start-Verzögerung
(Lese-/Schreibzugriff) Die Verzögerung, die gewartet werden soll, bevor ein Aufruf zum Starten der VM zurückgegeben wird, in Sekunden -
Abschaltverzögerung
(Lese-/Schreibzugriff) Die Verzögerung, die gewartet werden soll, bevor ein Aufruf zum Herunterfahren der VM zurückgegeben wird, in Sekunden -
memory-dynamic-max
(Lesen/Schreiben) dynamisches Maximum in Bytes -
memory-dynamic-min
(Lesen/Schreiben) dynamisches Minimum in Bytes -
speicher-statisch-max
(Lesen/Schreiben) statisch gesetztes (absolutes) Maximum in Bytes. Wenn Sie diesen Wert ändern möchten, muss die VM heruntergefahren werden. -
speicher-statisch-min
(Lesen/Schreiben) statisch gesetztes (absolutes) Minimum in Bytes. 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 Pinning einer vCPU mit
xe vm-param-set uuid=<vm_uuid> VCPUs-params:mask=1,2,3 <!--NeedCopy-->
Die ausgewählte VM wird dann nur auf den physischen CPUs 1, 2 und 3 ausgeführt. Sie können auch die vCPU-Priorität (Xen-Planung) mit den Parametern cap und weight optimieren. Beispiel:
xe vm-param-set uuid=<vm_uuid> VCPUs-params:weight=512 xe vm-param-set uuid=<vm_uuid> VCPUs-params:cap=100 <!--NeedCopy-->
Eine VM mit einer Gewichtung von 512 erhält doppelt so viel CPU wie eine Domäne mit einer Gewichtung von 256 auf einem umstrittenen XenServer-Host. Zulässige Gewichtungen liegen zwischen 1 und 65535, und der Standardwert ist 256. Die Obergrenze legt optional die maximale CPU-Menge fest, die eine VM verbrauchen kann, auch wenn der XenServer-Host CPU-Zyklen im Leerlauf hat. Die Obergrenze wird in Prozent einer physischen CPU ausgedrückt: 100 ist 1 physische CPU, 50 ist eine halbe CPU, 400 sind 4 CPUs und so weiter. Der Standardwert 0 bedeutet, dass es keine Obergrenze gibt.
-
VCPUs-max
(Lesen/Schreiben) Maximale Anzahl virtueller CPUs. -
VCPUs-at-startup
(Lesen/Schreiben) Boot-Nummer der virtuellen CPUs -
actions-after-crash
(read/write) action to take if the VM crashes. For PV guests, valid parameters are:-
erhalten
(nur zur Analyse) -
coredump_and_restart
(Aufzeichnen eines Coredumps und Neustarten der VM) -
coredump_and_destroy
(Zeichnen Sie einen Coredump auf und lassen Sie die VM angehalten) -
neustarten
(kein Coredump und VM neu starten) -
zerstören
(kein Coredump und VM angehalten)
-
-
console-uuids
(schreibgeschützter Parameter setzen) Virtuelle Konsolengeräte -
Bahnsteig
(Map-Parameter mit Lese-/Schreibzugriff) Plattformspezifische KonfigurationSo deaktivieren Sie den VDA, um Windows 10 in den Tablet-Modus zu versetzen:
xe vm-param-set uuid=<vm_uuid> platform:acpi_laptop_slate=0 <!--NeedCopy-->
So aktivieren Sie den VDA, um Windows 10 in den Tablet-Modus zu versetzen:
xe vm-param-set uuid=<vm_uuid> platform:acpi_laptop_slate=1 <!--NeedCopy-->
So überprüfen Sie den aktuellen Status:
xe vm-param-get uuid=<vm_uuid> param-name=platform param-key=acpi_laptop_slate <!--NeedCopy-->
-
allowed-operations
(schreibgeschützter Parameter setzen) Liste der Operationen, die in diesem Zustand zulässig sind -
aktuelle-operationen
(schreibgeschützter Parameter festlegen) eine Liste der Vorgänge, die derzeit auf der VM ausgeführt werden -
allowed-VBD-Geräte
(schreibgeschützter Set-Parameter) Liste der verfügbaren VBD-Bezeichner, dargestellt durch ganze Zahlen im Bereich von 0 bis 15. Diese Liste dient nur zu Informationszwecken, und es können auch andere Geräte verwendet werden (die jedoch möglicherweise nicht funktionieren). -
allowed-VIF-Geräte
(schreibgeschützter Set-Parameter) Liste der zur Verwendung verfügbaren VIF-Bezeichner, dargestellt durch Ganzzahlen im Bereich von 0 bis 15. Diese Liste dient nur zu Informationszwecken, und es können auch andere Geräte verwendet werden (die jedoch möglicherweise nicht funktionieren). -
HVM-boot-Richtlinie
(Lese-/Schreibzugriff) die Boot-Richtlinie für Gäste. Entweder BIOS-Reihenfolge oder eine leere Zeichenfolge. -
HVM-boot-params
(Zuordnungsparameter mit Lese-/Schreibzugriff) Der Schlüssel order steuert die Startreihenfolge des Gasts, die als Zeichenfolge dargestellt wird, wobei jedes Zeichen eine Startmethode ist: d für die CD/DVD, c für den Stammdatenträger und n für den Netzwerk-PXE-Start. Der Standardwert ist dc. -
HVM-Schatten-Multiplikator
(Lesen/Schreiben) Gleitkommawert, der die Menge des Schattenspeicher-Overheads steuert, der der VM gewährt wird. Der Standardwert ist 1,0 (der Mindestwert) und kann nur geändert werden, wenn Sie ein fortgeschrittener Benutzer sind. -
PV-Kern
(Lese-/Schreib-) Pfad zum Kernel -
PV-RAM-Disk
(Lese-/Schreib-) Pfad zuminitrd
-
PV-Args
(Lese-/Schreibzugriff) Zeichenfolge von Kernel-Befehlszeilenargumenten -
PV-legacy-args
(Lese-/Schreibzugriff) Zeichenfolge von Argumenten, um Legacy-VMs booten zu lassen -
PV-Bootloader
(Lese-/Schreib-) Name oder Pfad zum Bootloader -
PV-bootloader-args
(Lesen/Schreiben) String mit verschiedenen Argumenten für den Bootloader -
last-boot-CPU-Flags
(schreibgeschützt) beschreibt die CPU-Flags, auf denen die VM zuletzt gebootet wurde -
wohnhaft auf
(schreibgeschützt) der XenServer-Host, auf dem sich eine VM befindet -
Affinität
(Lesen/Schreiben) Der XenServer-Host, auf dem die VM bevorzugt ausgeführt wird. Wird von derxe vm-start
, um zu entscheiden, wo die VM ausgeführt werden soll. Wird auch als Homeserver bezeichnet. -
Gruppen
(Lese-/Schreibzugriff) die VM-Gruppe, zu der diese VM gehört. Eine VM-Gruppe definiert, wo XenServer versucht, die VM zu starten oder zu evakuieren. -
andere-konfiguration
(Map-Parameter lesen/schreiben) Eine Liste von Schlüssel-Wert-Paaren, die zusätzliche Konfigurationsparameter für die VM angeben.Zum Beispiel wird die
andere-konfiguration
Schlüssel-Wert-Paarauto_poweron: wahr
Fordert an, die VM automatisch zu starten, nachdem ein Host im Pool gestartet wurde. Sie müssen diesen Parameter auch in der Dateiandere-konfiguration
. Diese Parameter sind jetzt veraltet. Verwenden Sie die Schaltflächeha-restart-priorität
-Parameter. -
Startzeit
(schreibgeschützt) Zeitstempel des Datums und der Uhrzeit, zu der die Metriken für die VM gelesen wurden. Dieser Zeitstempel hat die FormyyyymmddThh:mm:ss z
, wobei z der einbuchstabige Indikator für die militärische Zeitzone ist, z. B. Z für UTC (GMT) -
installationszeit
(schreibgeschützt) Zeitstempel des Datums und der Uhrzeit, zu der die Metriken für die VM gelesen wurden. Dieser Zeitstempel hat die FormyyyymmddThh:mm:ss z
, wobei z der einbuchstabige Indikator für die militärische Zeitzone ist, z. B. Z für UTC (GMT) -
memory-actual
(schreibgeschützt) der tatsächliche Arbeitsspeicher, der von einer VM verwendet wird -
VCPUs-Nummer
(schreibgeschützt) Die Anzahl der virtuellen CPUs, die der VM für eine Linux-VM zugewiesen sind. Diese Zahl kann abweichen vonVCPUS-max
und kann ohne Neustart der VM mit der Optionvm-vcpu-hotplug
Befehl. Weitere Informationen finden Sie untervm-vcpu-hotplug
. Windows-VMs werden immer mit der Anzahl der vCPUs ausgeführt, die aufVCPUsmax
und muss neu gestartet werden, um diesen Wert zu ändern. Die Leistung sinkt stark, wenn SieVCPUs-Nummer
auf einen Wert, der größer ist als die Anzahl der physischen CPUs auf dem XenServer-Host. -
VCPUs-Auslastung
(schreibgeschützter Map-Parameter) eine Liste der virtuellen CPUs und deren Gewicht -
OS-Version
(schreibgeschützter Map-Parameter) die Version des Betriebssystems für die VM -
PV-Treiber-Version
(schreibgeschützter Map-Parameter) die Versionen der paravirtualisierten Treiber für die VM -
PV-Treiber erkannt
(schreibgeschützt) Flag für die neueste Version der paravirtualisierten Treiber für die VM -
Gedächtnis
(schreibgeschützter Zuordnungsparameter) Speichermetriken, die vom Agenten auf der VM gemeldet werden -
Disketten
(schreibgeschützter Zuordnungsparameter) Datenträgermetriken, die vom Agent auf der VM gemeldet werden -
Netzwerke
(schreibgeschützter Zuordnungsparameter) Netzwerkmetriken, die vom Agenten auf der VM gemeldet werden -
andere
(schreibgeschützter Zuordnungsparameter) andere Metriken, die vom Agenten auf der VM gemeldet werden -
guest-metrics-lastupdated
(schreibgeschützt) Zeitstempel, zu dem der Gastagent den letzten Schreibvorgang in diese Felder ausgeführt hat. Der Zeitstempel hat die FormyyyymmddThh:mm:ss z
, wobei z der einbuchstabige Indikator für die militärische Zeitzone ist, z. B. Z für UTC (GMT) -
Aktionen nach dem Herunterfahren
(Lese-/Schreib-) Aktion, die nach dem Herunterfahren der VM ausgeführt werden soll -
Aktionen nach dem Neustart
(Lese-/Schreib-) Aktion, die nach dem Neustart der VM ausgeführt werden soll -
mögliche-hosts
Potenzielle Hosts dieser VM schreibgeschützt -
DOM-Kennung
(schreibgeschützt) Domain-ID (falls vorhanden, -1 sonst) -
Empfehlungen
(schreibgeschützt) XML-Spezifikation von empfohlenen Werten und Bereichen für Eigenschaften dieser VM -
xenstore-daten
(Map-Parameter mit Lese-/Schreibzugriff) Daten, die in denXenstore
Baum (/lokale/domäne/*domid*/vm-daten
), nachdem die VM erstellt wurde -
ist-ein-schnappschuss
(schreibgeschützt) True, wenn es sich bei dieser VM um einen Snapshot handelt -
snapshot_of
(schreibgeschützt) die UUID der VM, von der dieser Snapshot stammt -
Schnappschüsse
(schreibgeschützt) die UUIDs aller Snapshots dieser VM -
snapshot_time
(schreibgeschützt) Der Zeitstempel des Momentaufnahmevorgangs, mit dem dieser VM-Snapshot erstellt wurde -
speicher-ziel
(schreibgeschützt) die Zielmenge an Arbeitsspeicher, die für diese VM festgelegt ist -
blockierte Operationen
(Zuordnungsparameter mit Lese-/Schreibzugriff) listet die Vorgänge auf, die auf dieser VM nicht ausgeführt werden können -
Last-Boot-Datensatz
(schreibgeschützt) Aufzeichnung der letzten Boot-Parameter für dieses Template im XML-Format -
ha-immer-laufen
(Lesen/Schreiben) True, wenn diese VM immer auf einem anderen Host neu gestartet wird, wenn der Host, auf dem sie sich befindet, ausfällt. Dieser Parameter ist jetzt veraltet. Verwenden Sie die Schaltflächeha-restart-priorität
-Parameter. -
ha-restart-priorität
(Lesen/Schreiben) Neustart oder Best-Effort -
Blobs
(schreibgeschützter) binärer Datenspeicher -
leben
(schreibgeschützt) True, wenn die VM ausgeführt wird. False, wenn die Hochverfügbarkeit den Verdacht hat, dass die VM nicht ausgeführt wird.
vm-assert-can-be-recovered
xe vm-assert-can-be-recovered uuid [database] vdi-uuid
<!--NeedCopy-->
Überprüft, ob Speicher für die Wiederherstellung dieser VM verfügbar ist.
vm-call-plugin
xe vm-call-plugin vm-uuid=vm_uuid plugin=plugin fn=function [args:key=value]
<!--NeedCopy-->
Ruft die Funktion innerhalb des Plug-Ins auf der angegebenen VM mit optionalen Argumenten (args:key=value) auf. Um einen "value"-String mit Sonderzeichen darin 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 "key" als Ganzes zugewiesen wird.
vm-cd-add
xe vm-cd-add cd-name=name_of_new_cd device=integer_value_of_an_available_vbd [vm-selector=vm_selector_value...]
<!--NeedCopy-->
Fügen Sie der ausgewählten VM eine neue virtuelle CD hinzu. Wählen Sie die Schaltfläche Gerät
aus dem Wert des allowed-VBD-Geräte
Parameter der VM.
Die VM(s), auf denen dieser Vorgang ausgeführt wird, werden mithilfe des Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl von VM-Parameter am Anfang dieses Abschnitts aufgeführt.
vm-cd-eject
xe vm-cd-eject [vm-selector=vm_selector_value...]
<!--NeedCopy-->
Werfen Sie eine CD aus dem virtuellen CD-Laufwerk aus. Dieser Befehl funktioniert nur, wenn genau eine CD an die VM angefügt ist. Wenn zwei oder mehr CDs vorhanden sind, verwenden Sie den Befehl xe vbd-eject
und geben Sie die UUID der VBD an.
Die VM(s), auf denen dieser Vorgang ausgeführt wird, werden mithilfe des Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl von VM-Parameter am Anfang dieses Abschnitts aufgeführt.
vm-cd-insert
xe vm-cd-insert cd-name=name_of_cd [vm-selector=vm_selector_value...]
<!--NeedCopy-->
Legen Sie eine CD in das virtuelle CD-Laufwerk ein. Dieser Befehl funktioniert nur, wenn genau ein leeres CD-Laufwerk an die VM angefügt ist. Wenn zwei oder mehr leere CD-Geräte vorhanden sind, verwenden Sie die Schaltfläche XE VBD-INSERT
und geben Sie die einzufügenden UUIDs der VBD und des VDI an.
Die VM(s), auf denen dieser Vorgang ausgeführt wird, werden mithilfe des Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl von VM-Parameter am Anfang dieses Abschnitts aufgeführt.
vm-cd-list
xe vm-cd-list [vbd-params] [vdi-params] [vm-selector=vm_selector_value...]
<!--NeedCopy-->
Listet CDs auf, die an die angegebenen VMs angefügt sind.
Die VM(s), auf denen dieser Vorgang ausgeführt wird, werden mithilfe des Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl von VM-Parameter am Anfang dieses Abschnitts aufgeführt.
Sie können auch auswählen, welche VBD- und VDI-Parameter aufgelistet werden sollen.
vm-cd-remove
xe vm-cd-remove cd-name=name_of_cd [vm-selector=vm_selector_value...]
<!--NeedCopy-->
Entfernen Sie eine virtuelle CD von den angegebenen VMs.
Die VM(s), auf denen dieser Vorgang ausgeführt wird, werden mithilfe des Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl von VM-Parameter am Anfang dieses Abschnitts aufgeführt.
vm-checkpoint
xe vm-checkpoint new-name-label=name_label [new-name-description=description]
<!--NeedCopy-->
Setzen Sie einen Prüfpunkt für eine vorhandene VM unter Verwendung eines schnellen Datenträgersnapshot-Vorgangs auf Speicherebene, sofern verfügbar.
vm-clone
xe vm-clone new-name-label=name_for_clone [new-name-description=description_for_clone] [vm-selector=vm_selector_value...]
<!--NeedCopy-->
Klonen Sie eine vorhandene VM mit einem schnellen Festplattenklonvorgang auf Speicherebene, sofern verfügbar. Geben Sie den Namen und die optionale Beschreibung für die resultierende geklonte VM an, indem Sie die neues-name-label
und neuer_name-beschreibung
Argumente.
Die VM(s), auf denen dieser Vorgang ausgeführt wird, werden mithilfe des Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl von VM-Parameter am Anfang dieses Abschnitts aufgeführt.
vm-compute-maximum-memory
xe vm-compute-maximum-memory total=amount_of_available_physical_ram_in_bytes [approximate=add overhead memory for additional vCPUS? true|false] [vm_selector=vm_selector_value...]
<!--NeedCopy-->
Berechnen Sie die maximale Menge an statischem Arbeitsspeicher, die einer vorhandenen VM zugewiesen werden kann, wobei die Gesamtmenge an physischem RAM als Obergrenze verwendet wird. Der optionale Parameter ungefähr
Reserviert ausreichend zusätzlichen Arbeitsspeicher in der Berechnung, um das spätere Hinzufügen zusätzlicher vCPUs zur VM zu berücksichtigen.
Beispiel:
xe vm-compute-maximum-memory vm=testvm total=`xe host-list params=memory-free --minimal`
<!--NeedCopy-->
Dieser Befehl verwendet den Wert des ohne Speicher
Parameter, der vom Parameter xe host-liste
, um den maximalen Arbeitsspeicher der VM mit dem Namen testvm
.
Die VM(s), auf denen dieser Vorgang ausgeführt wird, werden mithilfe des Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl von VM-Parameter am Anfang dieses Abschnitts aufgeführt.
vm-compute-memory-overhead
xe vm-compute-memory-overhead
<!--NeedCopy-->
Berechnet den Virtualisierungsspeicher-Overhead einer VM.
vm-copy
xe vm-copy new-name-label=name_for_copy [new-name-description=description_for_copy] [sr-uuid=uuid_of_sr] [vm-selector=vm_selector_value...]
<!--NeedCopy-->
Kopieren Sie eine vorhandene VM, ohne jedoch den schnellen Festplattenklonvorgang auf Speicherebene zu verwenden (auch wenn diese Option verfügbar ist). Die Disk-Images der kopierten VM sind garantiert Vollständige Bilder, d. h. sie ist nicht Teil einer CoW-Kette (Copy-on-Write).
Geben Sie den Namen und die optionale Beschreibung für die resultierende kopierte VM an, indem Sie die neues-name-label
und neuer_name-beschreibung
Argumente.
Geben Sie die Ziel-SR für die resultierende kopierte VM an, indem Sie die sr-uuid
. Wenn dieser Parameter nicht angegeben ist, ist das Ziel dieselbe SR, in der sich die ursprüngliche VM befindet.
Die VM(s), auf denen dieser Vorgang ausgeführt wird, werden mithilfe des Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl von VM-Parameter am Anfang dieses Abschnitts aufgeführt.
vm-copy-bios-strings
xe vm-copy-bios-strings host-uuid=host_uuid
<!--NeedCopy-->
Kopieren Sie die BIOS-Zeichenfolgen des angegebenen Hosts auf die VM.
Hinweis:
Nachdem Sie eine VM zum ersten Mal gestartet haben, können Sie ihre BIOS-Zeichenfolgen nicht mehr ändern. Stellen Sie sicher, dass die BIOS-Zeichenfolgen korrekt sind, bevor Sie die VM zum ersten Mal starten.
vm-crashdump-list
xe vm-crashdump-list [vm-selector=vm selector value...]
<!--NeedCopy-->
Listet Absturzabbilder auf, die den angegebenen VMs zugeordnet sind.
Wenn Sie das optionale Argument Parameter
, ist der Wert von params ein String, der eine Liste von Parametern dieses Objekts enthält, die Sie anzeigen möchten. Alternativ können Sie das Schlüsselwort alle
, um alle Parameter anzuzeigen. Wenn Parameter
nicht verwendet wird, zeigt die zurückgegebene Liste eine Standardteilmenge aller verfügbaren Parameter an.
Die VM(s), auf denen dieser Vorgang ausgeführt wird, werden mithilfe des Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl von VM-Parameter am Anfang dieses Abschnitts aufgeführt.
vm-data-source-list
xe vm-data-source-list [vm-selector=vm selector value...]
<!--NeedCopy-->
Listen Sie die Datenquellen auf, die für einen virtuellen Computer aufgezeichnet werden können.
Wählen Sie die VMs aus, auf denen dieser Vorgang ausgeführt werden soll, indem Sie den Standardauswahlmechanismus verwenden. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl von VM-Parameter am Anfang dieses Abschnitts aufgeführt. Wenn keine Parameter zum Auswählen von Hosts angegeben werden, wird der Vorgang auf allen VMs ausgeführt.
Datenquellen haben zwei Parameter: Norm
und ermöglichte
– was Sie in der Ausgabe dieses Befehls sehen können. Wenn eine Datenquelle ermöglichte
auf STIMMT
, werden die Metriken derzeit in der Performance-Datenbank aufgezeichnet. Wenn eine Datenquelle Norm
auf STIMMT
, werden die Metriken standardmäßig in der Leistungsdatenbank aufgezeichnet (und ermöglichte
ist auch auf STIMMT
für diese Datenquelle). Wenn eine Datenquelle Norm
auf FALSCH
, sind die Metriken nicht standardmäßig in der Leistungsdatenbank aufgezeichnet (und ermöglichte
ist auch auf FALSCH
für diese Datenquelle).
Um mit der Aufzeichnung von Datenquellenmetriken in der Leistungsdatenbank zu beginnen, führen Sie die vm-datenquelle-datensatz
Befehl. Mit diesem Befehl wird ermöglichte
An STIMMT
. Um den Vorgang zu beenden, führen Sie die vm-datenquelle-vergessen
. Mit diesem Befehl wird ermöglichte
An FALSCH
.
vm-data-source-record
xe vm-data-source-record data-source=name_description_of_data-source [vm-selector=vm selector value...]
<!--NeedCopy-->
Notieren Sie sich die angegebene Datenquelle für einen virtuellen Computer.
Dieser Vorgang schreibt die Informationen aus der Datenquelle in die Datenbank für persistente Leistungsmetriken der angegebenen VMs. Aus Leistungsgründen unterscheidet sich diese Datenbank von der normalen Agentendatenbank.
Wählen Sie die VMs aus, auf denen dieser Vorgang ausgeführt werden soll, indem Sie den Standardauswahlmechanismus verwenden. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl von VM-Parameter am Anfang dieses Abschnitts aufgeführt. Wenn keine Parameter zum Auswählen von Hosts angegeben werden, wird der Vorgang auf allen VMs ausgeführt.
vm-data-source-forget
xe vm-data-source-forget data-source=name_description_of_data-source [vm-selector=vm selector value...]
<!--NeedCopy-->
Beenden Sie die Aufzeichnung der angegebenen Datenquelle für eine VM, und vergessen Sie alle aufgezeichneten Daten.
Wählen Sie die VMs aus, auf denen dieser Vorgang ausgeführt werden soll, indem Sie den Standardauswahlmechanismus verwenden. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl von VM-Parameter am Anfang dieses Abschnitts aufgeführt. Wenn keine Parameter zum Auswählen von Hosts angegeben werden, wird der Vorgang auf allen VMs ausgeführt.
vm-data-source-query
xe vm-data-source-query data-source=name_description_of_data-source [vm-selector=vm_selector_value...]
<!--NeedCopy-->
Zeigen Sie die angegebene Datenquelle für eine VM an.
Wählen Sie die VMs aus, auf denen dieser Vorgang ausgeführt werden soll, indem Sie den Standardauswahlmechanismus verwenden. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl von VM-Parameter am Anfang dieses Abschnitts aufgeführt. Wenn keine Parameter zum Auswählen von Hosts angegeben werden, wird der Vorgang auf allen VMs ausgeführt.
vm-destroy
xe vm-destroy uuid=uuid_of_vm
<!--NeedCopy-->
Zerstören Sie die angegebene VM. Dadurch bleibt der mit der VM verknüpfte Speicher intakt. Um auch Speicher zu löschen, verwenden Sie xe vm-uninstall
.
vm-disk-add
xe vm-disk-add disk-size=size_of_disk_to_add device=uuid_of_device [vm-selector=vm_selector_value...]
<!--NeedCopy-->
Fügen Sie den angegebenen VMs einen Datenträger hinzu. Wählen Sie die Schaltfläche Gerät
aus dem Wert des allowed-VBD-Geräte
-Parameter der VMs.
Das disk-size
kann in Bytes oder mit den IEC-Standard-Suffixen KiB, MiB, GiB und TiB angegeben werden.
Die VM(s), auf denen dieser Vorgang ausgeführt wird, werden mithilfe des Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl von VM-Parameter am Anfang dieses Abschnitts aufgeführt.
vm-disk-list
xe vm-disk-list [vbd-params] [vdi-params] [vm-selector=vm_selector_value...]
<!--NeedCopy-->
Listet Datenträger auf, die an die angegebenen VMs angefügt sind. Das vbd-params
und VDI-PARAMS
Parameter steuern die Felder der jeweiligen Objekte, die ausgegeben werden sollen. Geben Sie die Parameter als kommagetrennte Liste oder den Sonderschlüssel alle
für die vollständige Liste.
Die VM(s), auf denen dieser Vorgang ausgeführt wird, werden mithilfe des Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl von VM-Parameter am Anfang dieses Abschnitts aufgeführt.
vm-disk-remove
xe vm-disk-remove device=integer_label_of_disk [vm-selector=vm_selector_value...]
<!--NeedCopy-->
Entfernen Sie einen Datenträger von den angegebenen VMs, und löschen Sie ihn.
Die VM(s), auf denen dieser Vorgang ausgeführt wird, werden mithilfe des Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl von VM-Parameter am Anfang dieses Abschnitts aufgeführt.
vm-export
xe vm-export filename=export_filename [metadata=true|false] [vm-selector=vm_selector_value...]
<!--NeedCopy-->
Exportieren Sie die angegebenen VMs (einschließlich Datenträgerimages) in eine Datei auf dem lokalen Computer. Geben Sie den Dateinamen an, in den die VM exportiert werden soll, indem Sie die Dateiname
Parameter. Gemäß der Konvention hat der Dateiname einen .xva
Erweiterung.
Wenn die Option Metadaten
ist STIMMT
klicken, werden die Datenträger nicht exportiert. Nur die VM-Metadaten werden in die Ausgabedatei geschrieben. Verwenden Sie diesen Parameter, wenn der zugrunde liegende Speicher über andere Mechanismen übertragen wird, und ermöglicht die Neuerstellung der VM-Informationen. Weitere Informationen finden Sie unter vm-import
.
Die VM(s), auf denen dieser Vorgang ausgeführt wird, werden mithilfe des Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl von VM-Parameter am Anfang dieses Abschnitts aufgeführt.
vm-import
xe vm-import filename=export_filename [metadata=true|false] [preserve=true|false][sr-uuid=destination_sr_uuid]
<!--NeedCopy-->
Importieren Sie eine VM aus einer zuvor exportierten Datei. Wenn erhalten
ist auf STIMMT
, wird die MAC-Adresse der ursprünglichen VM beibehalten. Das sr-uuid
Bestimmt die Ziel-SR, in die die VM importiert werden soll. Wenn dieser Parameter nicht angegeben ist, wird die Standard-SR verwendet.
Wenn die Option Metadaten
ist STIMMT
können Sie einen zuvor exportierten Satz von Metadaten ohne die zugehörigen Festplattenblöcke importieren. Der Import von reinen Metadaten schlägt fehl, wenn keine VDIs gefunden werden können (benannt durch SR und VDI.location
), es sei denn, die --Kraft
Option angegeben ist, wird der Import unabhängig davon fortgesetzt. Wenn Datenträger gespiegelt oder out-of-band verschoben werden können, ist der Metadatenimport/-export eine schnelle Möglichkeit, VMs zwischen nicht zusammenhängenden Pools zu verschieben. Zum Beispiel als Teil eines Notfallwiederherstellungsplans.
Hinweis:
Mehrere VM-Importe werden seriell schneller ausgeführt als parallel.
vm-install
xe vm-install new-name-label=name [template-uuid=uuid_of_desired_template] [template=template_uuid_or_name] [sr-uuid=sr_uuid | sr-name-label=name_of_sr][copy-bios-strings-from=host_uuid]
<!--NeedCopy-->
Installieren oder Klonen einer VM aus einer Vorlage. Geben Sie den Vorlagennamen an, indem Sie entweder die Schaltfläche template-uuid
oder Schablone
Argument. Geben Sie eine SR an, indem Sie entweder die Schaltfläche sr-uuid
oder sr-name-etikett
Argument. Geben Sie an, dass BIOS-gesperrte Medien mit dem Befehl kopieren-bios-strings-von
Argument.
Hinweis:
Bei der Installation aus einer Vorlage, die über vorhandene Festplatten verfügt, werden standardmäßig neue Festplatten in derselben SR wie diese vorhandenen Festplatten erstellt. Wenn der SR dies unterstützt, handelt es sich bei diesen Festplatten um schnelle Kopien. Wenn in der Befehlszeile eine andere SR angegeben wird, werden die neuen Festplatten dort erstellt. In diesem Fall ist eine schnelle Kopie nicht möglich und die Disketten sind Vollkopien.
Bei der Installation von einer Vorlage, die nicht über vorhandene Datenträger verfügt, werden alle neuen Datenträger in der angegebenen SR oder in der Standard-SR des Pools erstellt, wenn keine SR angegeben ist.
vm-is-bios-customized
xe vm-is-bios-customized
<!--NeedCopy-->
Gibt an, ob die BIOS-Zeichenfolgen der VM angepasst wurden.
vm-memory-dynamic-range-set
xe vm-memory-dynamic-range-set min=min max=max
<!--NeedCopy-->
Konfigurieren Sie den dynamischen Arbeitsspeicherbereich einer VM. Der dynamische Arbeitsspeicherbereich definiert weiche untere und obere Grenzwerte für den Arbeitsspeicher einer VM. Es ist möglich, diese Felder zu ändern, wenn eine VM ausgeführt oder angehalten wird. Der Dynamikbereich muss innerhalb des statischen Bereichs liegen.
vm-memory-limits-set
xe vm-memory-limits-set static-min=static_min static-max=static_max dynamic-min=dynamic_min dynamic-max=dynamic_max
<!--NeedCopy-->
Konfigurieren Sie die Arbeitsspeichergrenzwerte einer VM.
vm-memory-set
xe vm-memory-set memory=memory
<!--NeedCopy-->
Konfigurieren Sie die Arbeitsspeicherzuweisung einer VM.
vm-memory-shadow-multiplier-set
xe vm-memory-shadow-multiplier-set [vm-selector=vm_selector_value...] [multiplier=float_memory_multiplier]
<!--NeedCopy-->
Legen Sie den Schattenspeichermultiplikator für die angegebene VM fest.
Dies ist eine erweiterte Option, die die Menge an Schatten-Gedächtnis einer hardwaregestützten VM zugewiesen ist.
In einigen spezialisierten Anwendungsworkloads, wie z. B. Citrix Virtual Apps, ist zusätzlicher Schattenspeicher erforderlich, um die volle Leistung zu erzielen.
Dieser Speicher wird als Overhead betrachtet. Er ist von den normalen Speicherberechnungen für die Abrechnung des Arbeitsspeichers auf eine VM getrennt. Wenn dieser Befehl aufgerufen wird, verringert sich die Menge des freien Hostspeichers entsprechend dem Multiplikator und dem HVM_shadow_multiplier
wird mit dem Wert aktualisiert, den Xen der VM zugewiesen hat. Wenn nicht genügend freier XenServer-Hostspeicher vorhanden ist, wird ein Fehler zurückgegeben.
Die VMs, auf denen dieser Vorgang ausgeführt werden soll, werden mithilfe des Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Selektoren.
vm-memory-static-range-set
xe vm-memory-static-range-set min=min max=max
<!--NeedCopy-->
Konfigurieren Sie den statischen Speicherbereich einer VM. Der Bereich für statischen Arbeitsspeicher definiert harte untere und obere Grenzwerte für den Arbeitsspeicher einer VM. Es ist nur möglich, diese Felder zu ändern, wenn eine VM angehalten wird. Der statische Bereich muss den Dynamikbereich umfassen.
vm-memory-target-set
xe vm-memory-target-set target=target
<!--NeedCopy-->
Legen Sie das Arbeitsspeicherziel für eine angehaltene oder ausgeführte VM fest. Der angegebene Wert muss innerhalb des Bereichs liegen, der durch die memory_static_min- und memory_static_max Werte der VM definiert ist.
vm-migrate
xe vm-migrate [compress=true|false] [copy=true|false] [host-uuid=destination_host_uuid] [host=name_or_ uuid_of_destination_host] [force=true|false] [live=true|false] [vm-selector=vm_selector_value...] [remote-master=destination_pool_master_uuid] [remote-username=destination_pool_username] [remote-password=destination_pool_password] [remote-network=destination_pool_network_uuid ][vif:source_vif_uuid=destination_network_uuid] [vdi:vdi_uuid=destination_sr_uuid]
<!--NeedCopy-->
Mit diesem Befehl werden die angegebenen VMs zwischen physischen Hosts migriert.
Das komprimieren
überschreibt den Parameter migration-komprimierung
pool-Parameter für xe pool-param-set
.
Das Gastgeber
im Parameter vm-migrieren
kann entweder der Name oder die UUID des XenServer-Hosts sein. So migrieren Sie die VM beispielsweise zu einem anderen Host im Pool, bei dem sich die VM-Datenträger auf einem Speicher befinden, der von beiden Hosts gemeinsam genutzt wird:
xe vm-migrate uuid=vm_uuid host-uuid=destination_host_uuid
<!--NeedCopy-->
So verschieben Sie VMs zwischen Hosts im selben Pool, die keinen Speicher freigeben (Speicher-Livemigration):
xe vm-migrate uuid=vm_uuid host-uuid=destination_host_uuid \
remote-master=192.0.2.35 remote-username=username remote-password=password
<!--NeedCopy-->
Für die Livemigration des Speichers müssen Sie den Hostnamen oder die IP-Adresse, den Benutzernamen und das Kennwort für den Poolkoordinator angeben, auch wenn Sie innerhalb desselben Pools migrieren.
Sie können die SR auswählen, in der jeder VDI gespeichert wird:
xe vm-migrate uuid=vm_uuid remote-master=192.0.2.35 remote-username=username remote-password=password host-uuid=destination_host_uuid \
vdi:vdi_1=destination_sr1_uuid \
vdi:vdi_2=destination_sr2_uuid \
vdi:vdi_3=destination_sr3_uuid
<!--NeedCopy-->
Darüber hinaus können Sie auswählen, an welches Netzwerk die VM nach der Migration angefügt werden soll:
xe vm-migrate uuid=vm_uuid \
vdi1:vdi_1_uuid=destination_sr1_uuid \
vdi2:vdi_2_uuid=destination_sr2_uuid \
vdi3:vdi_3_uuid=destination_sr3_uuid \
vif:source_vif_uuid=destination_network_uuid
<!--NeedCopy-->
Für die poolübergreifende Migration:
xe vm-migrate uuid=vm_uuid remote-master=192.0.2.35 \
remote-username=username remote-password=password \
host-uuid=destination_host_uuid \
vif:source_vif_uuid=destination_network_uuid \
vdi:vdi_uuid=destination_sr_uuid
<!--NeedCopy-->
Weitere Informationen zur Livemigration von Speicher, zur Livemigration und zur Live-VDIMIGRATION finden Sie unter Migrieren von VMs.
Hinweis:
Wenn Sie ein Upgrade von einer älteren Version von XenServer oder Citrix Hypervisor durchführen, müssen Sie nach der Migration Ihrer VMs möglicherweise alle VMs herunterfahren und starten, um sicherzustellen, dass neue Virtualisierungsfunktionen übernommen werden.
Standardmäßig wird die VM auf dem anderen Host angehalten, migriert und fortgesetzt. Das leben
wählt die Live-Migration aus. Die Livemigration sorgt dafür, dass die VM während der Migration ausgeführt wird, wodurch die Ausfallzeiten der VM minimiert werden. Unter bestimmten Umständen, z. B. bei extrem arbeitsspeicherintensiven Workloads auf der VM, fällt die Livemigration auf den Standardmodus zurück und hält die VM für kurze Zeit an, bevor die Speicherübertragung abgeschlossen wird.
Die VM(s), auf denen dieser Vorgang ausgeführt wird, werden mithilfe des Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl von VM-Parameter am Anfang dieses Abschnitts aufgeführt.
vm-pause
xe vm-pause
<!--NeedCopy-->
Halten Sie eine ausgeführte VM an. Beachten Sie, dass dieser Vorgang den zugeordneten Speicher nicht freigibt (siehe vm-suspend
).
vm-reboot
xe vm-reboot [vm-selector=vm_selector_value...] [force=true]
<!--NeedCopy-->
Starten Sie die angegebenen VMs neu.
Die VM(s), auf denen dieser Vorgang ausgeführt wird, werden mithilfe des Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl von VM-Parameter am Anfang dieses Abschnitts aufgeführt.
Verwenden Sie die Schaltfläche Kraft
-Argument aus, um einen fehlerhaften Neustart zu verursachen. Das Herunterfahren ist vergleichbar mit dem Ziehen des Steckers bei einem physischen Server.
vm-recover
xe vm-recover vm-uuid [database] [vdi-uuid] [force]
<!--NeedCopy-->
Stellt eine VM aus der Datenbank wieder her, die in der bereitgestellten VDI enthalten ist.
vm-reset-powerstate
xe vm-reset-powerstate [vm-selector=vm_selector_value...] {force=true}
<!--NeedCopy-->
Die VM(s), auf denen dieser Vorgang ausgeführt wird, werden mithilfe des Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl von VM-Parameter am Anfang dieses Abschnitts aufgeführt.
Dies ist ein fortgeschritten Befehl, der nur verwendet wird, wenn ein Mitgliedshost in einem Pool ausfällt. Mit diesem Befehl können Sie den Poolkoordinator zwingen, den Energiestatus der VMs auf gestoppt
. Im Wesentlichen erzwingt dieser Befehl die Sperre für die VM und ihre Datenträger, damit sie als Nächstes auf einem anderen Poolhost gestartet werden kann. Diese Ausschreibung erfordert Das Force-Flag muss angegeben werden, und schlägt fehl, wenn es sich nicht auf der Befehlszeile befindet.
vm-restart-device-models
xe vm-restart-device-models [vm-selector=vm_selector_value...]
<!--NeedCopy-->
Starten Sie das Gerätemodell für diese VM auf dem Host neu. Während das Gerätemodell neu gestartet wird, können Sie den virtuellen Computer nicht beenden, starten oder migrieren. Für den Endbenutzer des virtuellen Computers wird möglicherweise eine leichte Pause angezeigt und die Sitzung fortgesetzt.
Hinweis:
Damit die Aktion zum Neustart des Gerätemodells auf einer Windows-VM unterstützt werden kann, müssen auf der VM die XenServer VM Tools für Windows installiert sein.
vm-resume
xe vm-resume [vm-selector=vm_selector_value...] [force=true|false] [on=host_uuid]
<!--NeedCopy-->
Setzen Sie die angegebenen VMs fort.
Die VM(s), auf denen dieser Vorgang ausgeführt wird, werden mithilfe des Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl von VM-Parameter am Anfang dieses Abschnitts aufgeführt.
Wenn sich die VM auf einer freigegebenen SR in einem Pool von Hosts befindet, verwenden Sie die auf
-Argument, um anzugeben, für welches Poolmitglied es gestartet werden soll. Standardmäßig bestimmt das System einen geeigneten Host, bei dem es sich um ein beliebiges Mitglied des Pools handeln kann.
vm-retrieve-wlb-recommendations
xe vm-retrieve-wlb-recommendations
<!--NeedCopy-->
Rufen Sie die Empfehlungen für den Lastenausgleich für die ausgewählte VM ab.
vm-shutdown
xe vm-shutdown [vm-selector=vm_selector_value...] [force=true|false]
<!--NeedCopy-->
Fahren Sie die angegebene VM herunter.
Die VM(s), auf denen dieser Vorgang ausgeführt wird, werden mithilfe des Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl von VM-Parameter am Anfang dieses Abschnitts aufgeführt.
Verwenden Sie die Schaltfläche Kraft
-Argument aus, um ein unzulässiges Herunterfahren zu verursachen, ähnlich wie beim Ziehen des Steckers bei einem physischen Server.
vm-snapshot
xe vm-snapshot new-name-label=name_label [new-name-description+name_description]
<!--NeedCopy-->
Erstellen Sie einen Snapshot einer vorhandenen VM mit einem schnellen Disk-Snapshot-Vorgang auf Speicherebene, sofern verfügbar.
vm-start
xe vm-start [vm-selector=vm_selector_value...] [force=true|false] [on=host_uuid] [--multiple]
<!--NeedCopy-->
Starten Sie die angegebenen VMs.
Die VM(s), auf denen dieser Vorgang ausgeführt wird, werden mithilfe des Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl von VM-Parameter am Anfang dieses Abschnitts aufgeführt.
Wenn sich die VMs auf einer freigegebenen SR in einem Pool von Hosts befinden, verwenden Sie die auf
-Argument, um anzugeben, auf welchem Poolmitglied die VMs gestartet werden sollen. Standardmäßig bestimmt das System einen geeigneten Host, bei dem es sich um ein beliebiges Mitglied des Pools handeln kann.
vm-suspend
xe vm-suspend [vm-selector=vm_selector_value...]
<!--NeedCopy-->
Halten Sie die angegebene VM an.
Die VM(s), auf denen dieser Vorgang ausgeführt wird, werden mithilfe des Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl von VM-Parameter am Anfang dieses Abschnitts aufgeführt.
vm-uninstall
xe vm-uninstall [vm-selector=vm_selector_value...] [force=true|false]
<!--NeedCopy-->
Deinstallieren Sie eine VM und löschen Sie zusätzlich zu ihrem Metadatensatz ihre Festplatten (die VDIs, die als RW gekennzeichnet und nur mit dieser VM verbunden sind). Um nur die VM-Metadaten zu löschen, verwenden Sie xe vm-destroy
.
Die VM(s), auf denen dieser Vorgang ausgeführt wird, werden mithilfe des Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl von VM-Parameter am Anfang dieses Abschnitts aufgeführt.
vm-unpause
xe vm-unpause
<!--NeedCopy-->
Heben Sie die Anhaltung einer angehaltenen VM auf.
vm-vcpu-hotplug
xe vm-vcpu-hotplug new-vcpus=new_total_vcpu_count [vm-selector=vm_selector_value...]
<!--NeedCopy-->
Passen Sie die Anzahl der vCPUs, die für eine ausgeführte Linux-VM verfügbar sind, dynamisch an. Die Anzahl der vCPUs wird durch den Parameter VCPUs-max
. Windows-VMs werden immer mit der Anzahl der vCPUs ausgeführt, die auf VCPUs-max
und muss neu gestartet werden, um diesen Wert zu ändern.
Verwenden Sie die Schaltfläche neue-vCPUs
, um den neuen Parameter zu definieren gesamt Anzahl der vCPUs, die Sie nach dem Ausführen dieses Befehls haben möchten. Verwenden Sie diesen Parameter nicht, um die Anzahl der vCPUs zu übergeben, die Sie hinzufügen möchten. Wenn Sie z. B. über zwei vorhandene vCPUs auf Ihrer VM verfügen und zwei weitere vCPUs hinzufügen möchten, geben Sie new-vcpus=4
.
Die Linux-VM oder Windows-VMs, auf denen dieser Vorgang ausgeführt wird, werden mithilfe des Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl von VM-Parameter am Anfang dieses Abschnitts aufgeführt.
Hinweis:
Wenn Sie Linux-VMs ausführen, auf denen XenServer VM Tools nicht installiert sind, führen Sie den folgenden Befehl auf der VM aus wie
wurzel
So stellen Sie sicher, dass die neu Hot-Plug-fähigen vCPUs verwendet werden:# für i in /sys/devices/system/cpu/cpu[1-9]*/online; do if [ "$(Katze) $i)" = 0 ]; dann Echo 1 > $i; Fi; fertig
vm-vif-list
xe vm-vif-list [vm-selector=vm_selector_value...]
<!--NeedCopy-->
Listet die VIFs der angegebenen VMs auf.
Die VM(s), auf denen dieser Vorgang ausgeführt wird, werden mithilfe des Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Selektoren. Die Selektoren werden beim Filtern auf die VM-Datensätze angewendet, und nicht auf die VIF-Werte. Optionale Argumente können eine beliebige Anzahl von VM-Parameter am Anfang dieses Abschnitts aufgeführt.
Geplante Snapshots
Befehle zum Steuern von geplanten VM-Snapshots und deren Attributen.
Das VMSS
Objekte können mit dem Standardbefehl Objektauflistung (xe vmss-list
) und die Parameter, die mit den Standardparameterbefehlen bearbeitet wurden. Weitere Informationen finden Sie unter Parameterbefehle auf niedriger Ebene
vmss-create
xe vmss-create enabled=True/False name-label=name type=type frequency=frequency retained-snapshots=value name-description=description schedule:schedule
<!--NeedCopy-->
Erstellt einen Snapshot-Zeitplan im Pool.
Beispiel:
xe vmss-create retained-snapshots=9 enabled=true frequency=daily \
name-description=sample name-label=samplepolicy type=snapshot \
schedule:hour=10 schedule:min=30
<!--NeedCopy-->
Snapshot-Zeitpläne haben die folgenden Parameter:
Parametername | Beschreibung | Typ |
---|---|---|
name-label |
Name des Snapshot-Zeitplans. | Lesen/Schreiben |
name-description |
Beschreibung des Snapshot-Zeitplans. | Lesen/Schreiben |
type |
Festplatten-Snapshot oder Speicher-Snapshot. | Lesen/Schreiben |
frequency |
Stündlich; Täglich; Wöchentlich | Lesen/Schreiben |
retained-snapshots |
Snapshots, die aufbewahrt werden sollen. Bereich: 1-10. | Lesen/Schreiben |
schedule |
Zeitplan:Tage (Montag bis Sonntag), Zeitplan:Stunden (0 bis 23), Zeitplan:Minuten (0, 15, 30, 45) |
Lesen/Schreiben |
vmss-destroy
xe vmss-destroy uuid=uuid
<!--NeedCopy-->
Zerstört einen Snapshot-Zeitplan im Pool.
USB-Durchleitung
USB-Passthrough wird für die folgenden USB-Versionen unterstützt: 1.1, 2.0 und 3.0.
USB-Passthrough aktivieren/deaktivieren
xe pusb-param-set uuid=pusb_uuid passthrough-enabled=true/false
<!--NeedCopy-->
Aktivieren/Deaktivieren von USB-Passthrough.
pusb-scan
xe pusb-scan host-uuid=host_uuid
<!--NeedCopy-->
PUSB scannen und aktualisieren.
vusb-create
xe vusb-create usb-group-uuid=usb_group_uuid vm-uuid=vm_uuid
<!--NeedCopy-->
Erstellt einen virtuellen USB-Stick im Pool. Starten Sie die VM, um sie über den USB-Stick an die VM zu übergeben.
vusb-unplug
xe vusb-unplug uuid=vusb_uuid
<!--NeedCopy-->
Trennt den USB-Anschluss von der VM.
vusb-destroy
xe vusb-destroy uuid=vusb_uuid
<!--NeedCopy-->
Entfernt die virtuelle USB-Liste von der VM.
Befehle für VM-Gruppen
Befehle zum Steuern von VM-Gruppen und deren Attributen.
Parameter für VM-Gruppen
-
UUID
(schreibgeschützt) die eindeutige Kennung/Objektreferenz für die VM -
Namensschild
(Lese-/Schreibzugriff) den Namen der VM -
name-beschreibung
(Lese-/Schreibzugriff) die Beschreibungszeichenfolge der VM -
Platzierung
(schreibgeschützt) Der Typ der Platzierungsregeln, die auf VMs in der Gruppe angewendet werden sollen. Die verfügbaren Werte sindAnti-Affinität
undnormal
.
vm-gruppe-liste
xe vm-group-list
<!--NeedCopy-->
Listet alle VM-Gruppen in diesem Pool auf.
vm-gruppe-erstellen
xe vm-group-create placement=anti-affinity|normal name-label=<name-label> [name-description=<name-description>]
<!--NeedCopy-->
Erstellt eine VM-Gruppe.
vm-gruppe-zerstören
xe vm-group-destroy uuid=<vm-group-uuid>
<!--NeedCopy-->
Löscht diese VM-Gruppe. Wenn Sie eine VM-Gruppe löschen, die VMs enthält, sind die VMs nicht mehr mit einer Gruppe verknüpft, aber nicht anderweitig betroffen.
In diesem Artikel
- Erste Schritte mit der xe CLI
- Hilfe zu xe-Befehlen erhalten
- Grundlegende xe-Syntax
- Sonderzeichen und Syntax
- Arten von Befehlen
- Geheimnisse
- Verlauf des Befehls
- XE-Befehlsreferenz
- Befehle der Appliance
- Audit-Befehle
- Bonding-Befehle
- CD-Befehle
- Cluster-Befehle
- Konsolen-Befehle
- Diagnose-Befehle
- Befehle zur Notfallwiederherstellung
- Ereignis-Befehle
- GPU-Befehle
- Host-Befehle
- Befehle für Nachrichten
- Netzwerk-Befehle
- SDN-Controller-Befehle
- Tunnel-Befehle
- Patch-Befehle
- PBD-Befehle
- PIF-Befehle
- Pool-Befehle
- PVS Accelerator-Befehle
- Storage Manager-Befehle
- Snapshot-Befehle
- SR-Befehle
- Betreff-Befehle
- Aufgaben-Befehle
- Vorlagen-Befehle
- Update-Befehle
- Benutzerbefehle
- VBD-Befehle
- VDI-Befehle
- VIF-Befehle
- VLAN-Befehle
- VM-Befehle
- Befehle für VM-Gruppen