Interface de ligne de commande
L’interface de ligne de commande xe vous permet de script et d’automatiser les tâches d’administration système. Utilisez l’interface de ligne de commande pour s’ intégrer à une infrastructure informatique existante.
L’interface de ligne de commande xe est installée par défaut sur les hôtes et est incluse avec . Une CLI distante autonome est également disponible pour Linux.
Sous Windows, laxe.exe
commande est installée avec .
Pour utiliser laxe.exe
commande, ouvrez une invite de commandes Windows et modifiez les répertoires vers le répertoire où se trouve lexe.exe
fichier (généralementC:\Program Files\\
). Si vous ajoutez l’emplacementxe.exe
d’installation à votre chemin d’accès système, vous pouvez utiliser la commande sans avoir à changer dans le répertoire.
Sur les distributions basées sur RPM (telles que Red Hat), vous pouvez installer la commande xe autonome à partir du RPM nomméxe-cli-6.00-BUILD.i386.rpm
sur l’ISO d’installation principale. Utilisez la commande suivante :
rpm -ivh XE-CLI-6.00-Build.i386.rpm
L’aide de base est disponible pour les commandes CLI sur l’hôte en tapant :
xe help, commande
Une liste des commandes xe les plus couramment utilisées s’affiche si vous tapez :
aide xe
Ou une liste de toutes les commandes xe s’affiche si vous tapez :
xe aide — tous
Syntaxe xe de base
La syntaxe de base de toutes les commandes xe CLI est la suivante :
xe command-name argument = valeur argument = valeur
Chaque commande spécifique contient son propre ensemble d’arguments qui sont de la formeargument=value
. Certaines commandes ont des arguments requis, et la plupart ont un ensemble d’arguments facultatifs. En règle générale, une commande suppose des valeurs par défaut pour certains des arguments optionnels lorsqu’elle est invoquée sans eux.
Si la commande xe est exécutée à distance, des arguments supplémentaires sont utilisés pour se connecter et s’authentifier. Ces arguments prennent également la formeargument=argument_value
.
L’server
argument est utilisé pour spécifier le nom d’hôte ou l’adresse IP. Lesusername
argumentspassword
et sont utilisés pour spécifier les informations d’identification. Unpassword-file
argument peut être spécifié à la place du mot de passe directement. Dans ce cas, la commande xe tente de lire le mot de passe à partir du fichier spécifié et utilise ce mot de passe pour se connecter. (Les CR et les LF à la fin du fichier sont supprimés.) Cette méthode est plus sûre que de spécifier le mot de passe directement sur la ligne de commande.
L’port
argument facultatif peut être utilisé pour spécifier le port de l’agent sur l’ hôte distant (valeur par défaut 443).
Exemple : Sur l’ hôte local :
xe vm-list
Exemple : Sur l’ hôte distant :
xe vm-list -nom d'utilisateur -mot de passe -nom d'hôte du serveur
La syntaxe abrégée est également disponible pour les arguments de connexion distante :
-
-u
nom d’utilisateur -
-pw
mot de passe - fichier
-pwf
de mot de passe -
-p
port -
-s
serveur
Exemple : Sur un hôte distant :
xe vm-list -u myuser -pw monmot de passe -s nom d'hôte
Les arguments sont également tirés de la variable d’environnement XE_EXTRA_ARGS, sous la forme de paires clé/valeur séparées par des virgules. Par exemple, pour entrer des commandes exécutées sur un hôte distant, exécutez d’abord la commande suivante :
export XE_EXTRA_ARGS = « serveur = jeffbeck, port = 443, nom d'utilisateur = root, mot de passe = pass »
Après avoir exécuté cette commande, vous n’avez plus à spécifier les paramètres d’hôte distant dans chaque commande xe que vous exécutez.
L’utilisation de la variable d’environnement XE_EXTRA_ARGS permet également de compléter par tabulation les commandes xe lorsqu’elles sont émises sur un hôte distant, qui est désactivé par défaut.
Caractères spéciaux et syntaxe
Pour spécifier des paires arguments/valeur sur la ligne dexe
commande, écrivez :
argument = valeur
Sauf si la valeur inclut des espaces, n’utilisez pas de guillemets. Il ne doit pas y avoir d’espace entre le nom de l’argument, le signe égal (=) et la valeur. Tout argument non conforme à ce format est ignoré.
Pour les valeurs contenant des espaces, écrivez :
argument = « valeur avec des espaces »
Lorsque vous utilisez l’interface de ligne de commande sur votre hôte, les commandes disposent d’une fonctionnalité de saisie d’onglets similaire à celle du shell bash Linux standard. Par exemple, si vous tapezxe vm-l
puis appuyez sur la touche TAB , le reste de la commande s’affiche. Si plusieurs commandes commencent parvm-l
, appuyez une deuxième fois sur TABrépertorie les possibilités. Cette fonctionnalité est utile lors de la spécification des UUID d’objet dans les commandes.
Note :
L’achèvement des tabulations ne fonctionne normalement pas lors de l’exécution de commandes sur un hôte distant. Toutefois, si vous définissez la variable XE_EXTRA_ARGS sur l’ordinateur où vous entrez les commandes, l’achèvement des tabulations est activé. Pour plus d’informations, reportez-vous à la section Syntaxe xe de base.
Types de commandes
Les commandes CLI peuvent être divisées en deux moitiés. Les commandes de bas niveau sont concernées par la liste et la manipulation des paramètres des objets API. Les commandes de niveau supérieur sont utilisées pour interagir avec des machines virtuelles ou des hôtes dans un niveau plus abstrait.
Les commandes de bas niveau sont les suivantes :
-
classe-list
-
class-param-get
-
classe-param-set
-
class-param-list
-
classe-param-add
-
class-param-remove
-
classe-param-clear
Où classe est l’un des éléments suivants :
-
bond
-
console
-
host
-
host-crashdump
-
host-cpu
-
network
-
patch
-
pbd
-
pif
-
pool
-
sm
-
sr
-
task
-
template
-
vbd
-
vdi
-
vif
-
vlan
-
vm
Toutes les valeurs de class n’ont pas l’ensemble complet des commandes class -param-action . Certaines valeurs de classe ont un plus petit ensemble de commandes.
Types de paramètres
Les objets qui sont adressés avec les commandes xe ont des ensembles de paramètres qui les identifient et définissent leurs états.
La plupart des paramètres prennent une seule valeur. Par exemple, lename-label
paramètre d’une machine virtuelle contient une seule valeur de chaîne. Dans la sortie des commandes de la liste de paramètresxe vm-param-list
, telles que, une valeur entre parenthèses indique si les paramètres sont en lecture-écriture (RW) ou en lecture seule (RO).
La sortie dexe vm-param-list
sur une machine virtuelle spécifiée peut avoir les lignes suivantes :
version utilisateur (RW) : 1
is-control-domain (RO) : false
Le premier paramètre,user-version
, est accessible en écriture et a la valeur 1. Le second,is-control-domain
, est en lecture seule et a la valeur false.
Les deux autres types de paramètres sont à valeurs multiples. Un paramètre set contient une liste de valeurs. Un paramètre de carte est un ensemble de paires clé/valeur. À titre d’exemple, regardez l’échantillon de sortie suivant de laxe vm-param-list
sur une machine virtuelle spécifiée :
plateforme (MRW) : acpi : true ; apic : true ; pae : true ; nx : false
allowed-operations (SRO) : pause ; clean_shutdown ; clean_reboot ; \
hard_shutdown ; hard_reboot ; suspend
Leplatform
paramètre a une liste d’éléments qui représentent des paires clé/valeur. Les noms de clés sont suivis d’un caractère deux-points ( :). Chaque paire clé/valeur est séparée de la suivante par un point-virgule ( ;). Le M précédant le RW indique que ce paramètre est un paramètre de carte et qu’il est lisible et accessible en écriture. Leallowed-operations
paramètre a une liste qui constitue un ensemble d’éléments. Le S précédant le RO indique qu’il s’agit d’un paramètre défini et qu’il est lisible mais non accessible en écriture.
Pour filtrer un paramètre de carte ou définir un paramètre de carte, utilisez deux points ( :) pour séparer le nom du paramètre de carte et la paire clé/valeur. Par exemple, pour définir la valeur de lafoo
clé duother-config
paramètre d’une machine virtuelle surbaa
, la commande sera
xe vm-param-set uuuid = VM uuid other-config : foo = baa
Note :
Dans les versions précédentes, le trait d’union (-) a été utilisé pour spécifier les paramètres de la carte. Cette syntaxe fonctionne toujours mais est obsolète.
Commandes de paramètres de bas niveau
Il existe plusieurs commandes pour fonctionner sur les paramètres des objets : class-param-get, class-param-set, class-param-add, class-param-remove, class-param-clear et class-param-list. Chacune de ces commandes prend unuuid
paramètre pour spécifier l’objet particulier. Comme ces commandes sont considérées comme des commandes de bas niveau, elles doivent utiliser l’UUID et non l’étiquette de nom de machine virtuelle.
-
class-param-list uuid=uuid
Répertorie tous les paramètres et leurs valeurs associées. Contrairement à la commande class-list, cette commande répertorie les valeurs des champs « coûteux ».
-
class-param-get uuid=uuid param-name=parameter param-key=key
Renvoie la valeur d’un paramètre particulier. Pour un paramètre de carte, la spécification de la clé param-obtient la valeur associée à cette clé dans la carte. Si param-key n’est pas spécifié ou si le paramètre est un ensemble, la commande renvoie une représentation sous forme de chaîne du jeu ou de la carte.
-
class-param-set uuid=uuid param=value
Définit la valeur d’un ou plusieurs paramètres.
-
class-param-add uuid=uuid param-name=parameter key=value param-key=key
Ajoute soit à une carte, soit à un paramètre défini. Pour un paramètre de carte, ajoutez des paires clé/valeur à l’aide de la syntaxe clé = valeur. Si le paramètre est un ensemble, ajoutez des clés avec la syntaxe param-key = key.
-
class-param-remove uuid=uuid param-name=parameter param-key=key
Supprime soit une paire clé/valeur d’une carte, soit une clé d’un ensemble.
-
class-param-clear uuid=uuid param-name=parameter
Efface complètement un ensemble ou une carte.
Commandes de liste de bas niveau
La commande class-list répertorie les objets de type class. Par défaut, ce type de commande répertorie tous les objets, en imprimant un sous-ensemble des paramètres. Ce comportement peut être modifié de la manière suivante :
- Il peut filtrer les objets de sorte qu’il ne génère qu’un sous-ensemble
- Les paramètres imprimés peuvent être modifiés.
Pour modifier les paramètres qui sont imprimés, spécifiez les paramètres d’argument sous la forme d’une liste séparée par des virgules des paramètres requis. Par exemple :
xe vm-list params = name-label, other-config
Sinon, pour lister tous les paramètres, utilisez la syntaxe :
xe vm-list params = all
La commande list n’affiche pas certains paramètres coûteux à calculer. Ces paramètres sont présentés comme, par exemple :
< expensive field >Dispositifs VBD Allowed-VBD (SRO) :
Pour obtenir ces champs, utilisez la commande class-param-list ou class-param-get
Pour filtrer la liste, l’interface de ligne de commande fait correspondre les valeurs des paramètres avec celles spécifiées sur la ligne de commande, en imprimant uniquement les objets correspondant à toutes les contraintes spécifiées. Par exemple :
xe vm-list HVM-Boot-policy = "ordre du BIOS'état d'alimentation = arrêt
Cette commande répertorie uniquement les machines virtuelles pour lesquelles la valeur du champpower-state
est arrêtée et le champHVM-boot-policy
a l’ ordre du BIOS de valeur.
Vous pouvez également filtrer la liste par la valeur des clés dans les cartes ou par l’existence de valeurs dans un ensemble. La syntaxe pour le filtrage basé sur les clés dans les cartes estmap-name:key=value
. La syntaxe de filtrage basée sur les valeurs existantes dans un ensemble estset-name:contains=value
.
Lors de l’écriture de scripts, une technique utile est de passer--minimal
sur la ligne de commande, provoxe
quant l’impression uniquement du premier champ d’une liste séparée par des virgules. Par exemple, la commandexe vm-list --minimal
sur un hôte avec trois machines virtuelles installées donne les trois UUID des machines virtuelles :
a85d6717-7264-d00e-069b-3b1d19d56ad9,aaa3eec5-9499-bcf3-4c03-af10baea96b7, \
42c044de-df69-4b30-89d9-2c199564581d
référence de commande xe
Cette section regroupe les commandes par les objets auxquels la commande adresse. Ces objets sont répertoriés par ordre alphabétique.
Commandes de l’appliance
Commandes permettant de créer et de modifier des appliances VM (également appelées VAPP). Pour plus d’informations, consultez VAPP.
Paramètres de l’appliance
Les commandes de l’appliance ont les paramètres suivants :
Nom du paramètre | Description | Tapez |
---|---|---|
uuid |
UUID de l’appliance | Obligatoire |
name-description |
Description de la solution matérielle-logicielle | Facultatif |
paused |
Facultatif | |
force |
Forcer l’arrêt | Facultatif |
appliance-assert-can-be-recovered
appliance-assert-can-be-récupéré uuid = base de données appliance-uuid : vdi-uuid = vdi-uuid
Teste si le stockage est disponible pour récupérer cette machine virtuelle/vApp.
appliance-create
appliance-create nom-label = nom-étiquette [nom-description = nom-description]
Crée une Appliance/VApp. Par exemple :
xe appliance-create nom-label = my_appliance
Ajouter des machines virtuelles à la solution matérielle-logicielle :
xe vm-param-set uuuid = appliance VM-UUID = appliance-uuid \
xe vm-param-set uuuid = appliance VM-UUID = appliance-uuid
appliance-destroy
appliance-destroy uuid = appliance-uuid
Détruit une Appliance/VApp. Par exemple :
xe appliance-destroy uuid = appliance-uuid
appliance-recover
appliance-recover uuid = base de données appliance-uuid : vdi-uuid = vdi-uuid \[pause = true | false]
Récupérez une machine virtuelle/vApp à partir de la base de données contenue dans le VDI fourni.
appliance-shutdown
appliance-shutdown uid = appliance-uuid \[force = true | false]
Arrête toutes les machines virtuelles d’une Appliance/VApp. Par exemple :
xe appliance-shutdown uid = appliance-uuid
appliance-start
appliance-start uuid = appliance-uuid \[pause = true | false]
Démarre une Appliance/VApp. Par exemple :
xe appliance-start uuid = appliance-uuid
Commandes d’audit
Les commandes d’audit téléchargent tous les enregistrements disponibles du fichier d’audit RBAC dans le pool. Si le paramètre optionnelsince
est présent, il ne télécharge que les enregistrements à partir de ce point précis dans le temps.
audit-log-get
paramètres
audit-log-get
a les paramètres suivants
Nom du paramètre | Description | Tapez |
---|---|---|
filename |
Ecrire le journal d’audit du pool dans le nom de fichier | Obligatoire |
since |
Date/heure spécifique | Facultatif |
audit-log-get
audit-log-get [since = timestamp] nom de fichier = nom de fichier
Par exemple, pour obtenir des enregistrements d’audit du pool depuis un horodatage milliseconde précis, exécutez la commande suivante :
Exécutez la commande suivante :
xe audit-log-get since = 2009-09-24T 17:56:20 .530Z nom de fichier = / tmp/auditlog -pool-actions.out
Commandes de liaison
Commandes pour travailler avec des liaisons réseau, pour la résilience avec basculement d’interface physique. Pour plus d’informations, reportez-vous à la section Mise en réseau.
L’objet de liaison est un objet de référence qui colle ensemble les PIF maître et membre . Le PIF principal est l’interface de liaison qui doit être utilisée comme FRP global pour faire référence à la liaison. Les PIF membres sont un ensemble de deux interfaces physiques ou plus qui ont été combinées dans l’interface liée de haut niveau.
Paramètres de liaison
Les obligations ont les paramètres suivants :
Nom du paramètre | Description | Tapez |
---|---|---|
uuid |
Identifiant/référence d’objet unique pour le lien | Lecture seule |
master |
UUID pour le FRP de l’obligation principale | Lecture seule |
members |
Ensemble d’UUID pour les PIF liés sous-jacents | Lecture seule |
bond-create
bond-create network-uuid = network_uuid pif-uuids = pif_uuid_1, pif_uuid_2,...
Créez une interface réseau liée sur le réseau spécifié à partir d’une liste d’objets PIF existants. La commande échoue dans l’un des cas suivants :
- Si les FRP sont déjà dans une autre obligation
- Si un membre a un jeu de balises VLAN
- Si les PIF référencés ne sont pas sur le même hôte
- Si moins de 2 FIP sont fournis
bond-destroy
bond-destroy uuid = bond_uuid
Supprime une interface liée spécifiée par son UUID d’un hôte.
bond-set-mode
bond-set-mode uuid = bond_uuid mode = bond_mode
Changez le mode de liaison.
Commandes CD
Commandes pour travailler avec des lecteurs de CD/DVD physiques sur des hôtes.
Paramètres du CD
Les CD ont les paramètres suivants :
Nom du paramètre | Description | Tapez |
---|---|---|
uuid |
Identifiant/référence d’objet unique pour le CD | Lecture seule |
name-label |
Nom du CD | Lecture/écriture |
name-description |
Texte de description pour le CD | Lecture/écriture |
allowed-operations |
Une liste des opérations qui peuvent être effectuées sur ce CD | Paramètre de jeu en lecture seule |
current-operations |
Une liste des opérations en cours sur cette CD | Paramètre de jeu en lecture seule |
sr-uuid |
La référence identifiant/objet unique pour la SR que ce CD fait partie de | Lecture seule |
sr-name-label |
Le nom de la SR ce CD fait partie de | Lecture seule |
vbd-uuids |
Liste des identifiants uniques pour les VBD sur les machines virtuelles qui se connectent à ce CD | Paramètre de jeu en lecture seule |
crashdump-uuids |
Non utilisé sur les CD. Parce que les crashdumps ne peuvent pas être écrits sur des CD | Paramètre de jeu en lecture seule |
virtual-size |
Taille du CD telle qu’elle apparaît aux machines virtuelles (en octets) | Lecture seule |
physical-utilisation |
Quantité d’espace physique que l’image du CD occupe sur le SR (en octets) | Lecture seule |
type |
Définir sur Utilisateur pour CD | Lecture seule |
sharable |
Indique si le lecteur de CD est partageable ou non. La valeur par défaut estfalse . |
Lecture seule |
read-only |
Si le CD est en lecture seule, sifalse , le périphérique est accessible en écriture. Toujours vrai pour les CD. |
Lecture seule |
storage-lock |
La valeur esttrue si ce disque est verrouillé au niveau du stockage. |
Lecture seule |
parent |
Référence au disque parent, si ce CD fait partie d’une chaîne. | Lecture seule |
missing |
La valeur esttrue si l’opération d’analyse SR a signalé que ce CD n’était pas présent sur le disque |
Lecture seule |
other-config |
Une liste de paires clé/valeur qui spécifient des paramètres de configuration supplémentaires pour le CD | Paramètre de mappage en lecture/écriture |
location |
Chemin d’accès sur lequel le périphérique est installé | Lecture seule |
managed |
La valeur esttrue si le périphérique est géré |
Lecture seule |
xenstore-data |
Données à insérer dans l’arborescence xenstore | Paramètre de mappage en lecture seule |
sm-config |
Noms et descriptions des clés de configuration des périphériques du gestionnaire de stockage | Paramètre de mappage en lecture seule |
is-a-snapshot |
La valeur esttrue si ce modèle est un instantané de CD |
Lecture seule |
snapshot_of |
UUID du CD que ce modèle est un instantané de | Lecture seule |
snapshots |
UUID de tous les instantanés qui ont été pris de ce CD | Lecture seule |
snapshot_time |
Horodatage de l’opération de cliché | Lecture seule |
cd-list
cd-list [params = param1, param2,...] [paramètre = valeur_paramètre]
Répertorier les CD et les ISO (fichiers image CD) sur l’ hôte ou le pool, en filtrant l’argument optionnelparams
.
Si l’argument optionnelparams
est utilisé, la valeur de params est une chaîne contenant une liste de paramètres de cet objet que vous souhaitez afficher. Vous pouvez également utiliser le mot-cléall
pour afficher tous les paramètres. Lorsqu’elle n’params
est pas utilisée, la liste renvoyée affiche un sous-ensemble par défaut de tous les paramètres disponibles.
Les arguments facultatifs peuvent être n’importe quel nombre de paramètres CDrépertoriés au début de cette section.
Commandes de cluster
Commandes pour travailler avec des pools en cluster.
Les pools en cluster sont des pools de ressources dont la fonctionnalité de clustering est activée. Utilisez ces pools avec les SR GFS2. Pour plus d’informations, voir [Pools/en-us/xenserver/current-release/command-line-interface.html()en cluster]
Les objets cluster et cluster-host peuvent être répertoriés avec les commandes de listage d’objets standard (xe cluster-list
etxe cluster-host-list
), et les paramètres manipulés avec les commandes de paramètres standard. Pour plus d’informations, consultez Commandes de paramètres de bas niveau.
Commandes pour travailler avec des pools en cluster.
Paramètres du cluster
Les clusters ont les paramètres suivants :
Nom du paramètre | Description | Tapez |
---|---|---|
uuid |
Identifiant/référence d’objet unique pour le cluster | Lecture seule |
cluster-hosts |
Une liste d’identificateurs/références d’objet uniques pour les hôtes du cluster | Paramètre de jeu en lecture seule |
cluster-token |
La clé secrète utilisée par xapi-clusterd quand il parle à lui-même sur d’autres hôtes | Lecture seule |
cluster-stack |
La pile technologique fournissant les capacités de clustering. Les valeurs possibles sontcorosync . |
Lecture seule |
allowed-operations |
Répertorie les opérations autorisées dans cet état. Cette liste est purement consultative et l’état du cluster peut avoir changé au moment où un client lit ce champ. | Paramètre de jeu en lecture seule |
current-operations |
Répertorie les opérations en cours. Cette liste est purement consultative et l’état du cluster peut avoir changé au moment où un client lit ce champ. | Paramètre de jeu en lecture seule |
token-timeout |
Le délai d’expiration du jeton corosync en secondes | Lecture seule |
token-timeout-coefficient |
Coefficient de délai d’expiration du jeton corosync en secondes | Lecture seule |
pool-auto-join |
Cette propriété a la valeur True si vous joignez automatiquement de nouveaux membres de pool au cluster. Ceci est réglé surtrue . |
Lecture seule |
cluster-config |
Liste de paires clé/valeur qui spécifient des paramètres de configuration supplémentaires pour le cluster. | Paramètre de mappage en lecture seule |
other-config |
Liste de paires clé/valeur qui spécifient des paramètres de configuration supplémentaires pour le cluster. | Paramètre de mappage en lecture/écriture |
cluster-host-create
cluster-host-create cluster-uuid = cluster_uuid host-uid = host_uuid pif-uuid = pif_uuid
Ajouter un hôte à un cluster existant.
cluster-host-destroy
cluster-host-destroy uuid = host_uuid
Détruisez un hôte de cluster, quittant effectivement le cluster.
cluster-host-disable
cluster-host-disable uuid = cluster_uuid
Désactiver l’appartenance au cluster pour un hôte de cluster activé.
cluster-host-enable
cluster-host-enable uuid = cluster_uuid
Activer l’appartenance au cluster pour un hôte de cluster désactivé.
cluster-host-force-destroy
cluster-host-force-destroy uuid = cluster_host
Détruisez un objet hôte de cluster avec force, quittant effectivement le cluster.
cluster-pool-create
cluster-pool-create network-uuid = network_uuid [cluster-stack = cluster_stack] [token-timeout = token_timeout] [token-timeout-coefficient = token_timeout_coefficient]
Créer un cluster à l’échelle du pool.
cluster-pool-destroy
cluster-pool-destroy cluster-uuid = cluster_uuid
Détruisez le cluster à l’échelle du pool. Le pool continue d’exister, mais il n’est plus en cluster et ne peut plus utiliser les SR GFS2.
cluster-pool-force-destroy
cluster-pool-force-destroy cluster-uuid = cluster_uuid
Forcer la destruction de la grappe à l’échelle du pool.
cluster-pool-resync
cluster-pool-resync cluster-uuid = cluster_uuid
Resynchroniser un cluster sur un pool.
Commandes de la console
Commandes pour travailler avec des consoles.
Les objets console peuvent être répertoriés avec la commande de listage d’objets standard (xe console-list
) et les paramètres manipulés avec les commandes de paramètres standard. Pour plus d’informations, consultez Commandes de paramètres de bas niveau.
Paramètres de la console
Les consoles ont les paramètres suivants :
Nom du paramètre | Description | Tapez |
---|---|---|
uuid |
Identifiant/référence d’objet unique pour la console | Lecture seule |
vm-uuid |
La référence identifiant/objet unique de la machine virtuelle que cette console est ouverte sur | Lecture seule |
vm-name-label |
Le nom de la machine virtuelle que cette console est ouverte sur | Lecture seule |
protocol |
Protocole utilisé par cette console. Les valeurs possibles sontvt100 : terminal VT100,rfb : protocole distant Framebuffer (tel qu’il est utilisé dans VNC), ourdp : protocole Bureau à distance |
Lecture seule |
location |
URI pour le service de console | Lecture seule |
other-config |
Liste de paires clé/valeur qui spécifient des paramètres de configuration supplémentaires pour la console. | Paramètre de mappage en lecture/écriture |
console
console
Attachez à une console particulière.
Commandes de diagnostic
Commandes de collecte des informations de diagnostic à partir de .
diagnostic-compact
diagnostic-compact
Effectuez une collection GC majeure et un compactage de tas.
diagnostic-db-log
diagnostic-db-log
Démarrez la journalisation des opérations de base de données. Attention : une fois démarré, cela ne peut pas être arrêté.
diagnostic-db-stats
diagnostic-db-stats
Imprimer les statistiques de base de données.
diagnostic-gc-stats
diagnostic-gc-stats
Imprimer les statistiques du GC.
diagnostic-license-status
diagnostic-licence-statut
Aide à diagnostiquer les problèmes de licence à l’échelle du pool.
diagnostic-net-stats
diagnostic-net-stats [uri = uri] [méthode = méthode] [params = param1, param2...]
Imprimer les statistiques du réseau.
diagnostic-timing-stats
diagnostic-timing-stats
Imprimer les statistiques de chronométrage.
diagnostic-vdi-status
diagnostic-vdi-status uuid = vdi_uuid
Recherchez l’état de verrouillage et de partage d’un VDI.
diagnostic-vm-status
diagnostic-vm-status uuid = vm_uuid
Recherchez les hôtes sur lesquels la machine virtuelle peut démarrer, vérifiez l’état de partage/verrouillage de tous les VBD.
Commandes de reprise après sinistre
Commandes pour récupérer des machines virtuelles après un sinistre
drtask-create
drtask-create type = type sr-whitelist = sr-white-list device-config = device-config
Crée une tâche de reprise après sinistre. Par exemple, pour vous connecter à une SR iSCSI en préparation de la reprise après sinistre :
xe drtask-create type = lvmoiscsi device-config : target = target-ip-address \
device-config : targetIQN = targetIQN device-config : scSIId = ScSIId \
sr-whitelist = sr-uuid-list
Note :
La commande
sr-whitelist
répertorie les UUID SR. Ladrtask-create
commande introduit et se connecte uniquement à un SR qui a l’un des UUID de liste blanche
drtask-destroy
drtask-destroy uuid = dr-task-uid
Détruit une tâche de reprise après sinistre et oublie la SR introduite.
vm-assert-can-be-recovered
vm-assert-can-be-récupéré uuid = base de données vm-uuid : vdi-uuid = vdi-uuid
Teste si le stockage est disponible pour récupérer cette machine virtuelle.
appliance-assert-can-be-recovered
appliance-assert-can-be-récupéré uuid = base de données appliance-uuid : vdi-uuid = vdi-uuid
Vérifie si le stockage (contenant le disque VApp de l’appliance) est visible.
appliance-recover
appliance-recover uuid = base de données appliance-uuid : vdi-uuid = vdi-uuid \[force = true | false]
Récupérez une Appliance/VApp à partir de la base de données contenue dans le VDI fourni.
vm-recover
vm-recover uuid = base de données vm-uuid : vdi-uuid = vdi-uuid \[force = true | false]
Récupère une machine virtuelle à partir de la base de données contenue dans le VDI fourni.
sr-enable-database-replication
sr-enable-database-replication uuuid = sr_uuid
Active la réplication de base de données XAPI vers le SR spécifié (partagé). Par exemple :
xe sr-enable-database-replication uuuid = sr-uuid
sr-disable-database-replication
sr-disable-database-replication uuuid = sr_uuid
Désactive la réplication de base de données XAPI vers le SR spécifié. Par exemple :
xe sr-enable-database-replication uuuid = sr-uuid
Exemple d’utilisation
L’exemple ci-dessous montre les commandes CLI DR dans leur contexte :
Sur le site principal, activez la réplication de base de données :
xe sr-database-replication uuuid = sr = uuid
Après un sinistre, sur le site secondaire, connectez-vous à la SR. Ladevice-config
commande a les mêmes champs quesr-probe
.
xe drtask-create type = lvmoiscsi \
device-config : target = adresse \ IP cible device-config : targetIQN = target-iqn \
device-config : scsiId = scsi-id \
sr-whitelist = sr-uuuid
Recherchez les VDI de base de données sur le SR :
xe vdi-list sr-uuid = type sr-uuid = Métadonnées
Interrogez un VDI de base de données pour les machines virtuelles présentes :
base de données xe vm-list : vdi-uuid = vdi-uuid
Récupérer une machine virtuelle :
xe vm-recover uuid = base de données vm-uuid : vdi-uuid = vdi-uuid
Détruisez la tâche de reprise après sinistre. Tous les SR introduits par la tâche DR et non requis par les machines virtuelles sont détruits :
xe drtask-destroy uuid = drtask-uuid
Commandes d’événement
Commandes pour travailler avec des événements.
Classes d’événements
Les classes d’événements sont répertoriées dans le tableau suivant :
Nom de la classe | Description |
---|---|
pool |
Un pool d’hôtes physiques |
vm |
Une machine virtuelle |
host |
Un hôte physique |
network |
Un réseau virtuel |
vif |
Une interface réseau virtuelle |
pif |
Une interface réseau physique (les VLAN séparés sont représentés sous la forme de plusieurs PIF) |
sr |
Un référentiel de stockage |
vdi |
Une image de disque virtuel |
vbd |
Un périphérique de bloc virtuel |
pbd |
Périphériques de blocs physiques via lesquels les hôtes accèdent aux SR |
event-wait
event-wait class = nom_classe [nom_param-= valeur_param] [nom_param-= / = valeur_param]
Bloque l’exécution d’autres commandes jusqu’à l’existence d’un objet satisfaisant aux conditions données sur la ligne de commande. L’argumentx=y
signifie « attendre que le champ x prenne la valeur y » etx=/=y
signifie « attendre que le champ x prenne toute valeur autre que y”.
Exemple : attendez qu’une machine virtuelle spécifique soit en cours d’exécution.
xe event-wait class = vm name-label = myvm power-state = en cours d'exécution
Bloque d’autres commandes jusqu’à ce qu’une machine virtuelle appelée myvm
est dans le power-state
en cours d’exécution.
Exemple : attendez qu’une machine virtuelle spécifique redémarre :
xe event-wait class = vm uuid = $VM start-time = / = $(xe vm-list uuuid = $VM params = start-time — minimal)
Bloque d’autres commandes jusqu’à ce qu’une machine virtuelle avec UUID $VM redémarre. La commande utilise la valeur destart-time
pour décider quand la machine virtuelle redémarre.
Le nom de la classe peut être l’une des classes d’événementsrépertoriées au début de cette section. Les paramètres peuvent être l’un des paramètres répertoriés dans la classede commande CLI -param-list.
Commandes GPU
Commandes permettant de travailler avec des GPU physiques, des groupes GPU et des GPU virtuels.
Les objets GPU peuvent être répertoriés avec les commandes standard de listage d’objets :xe pgpu-listxe gpu-group-list````, etxe vgpu-list``. Les paramètres peuvent être manipulés avec les commandes de paramètres standard. Pour plus d’informations, consultez Commandes de paramètres de bas niveau.
Paramètres GPU physiques
Les GPU physiques (PGPU) ont les paramètres suivants :
Nom du paramètre | Description | Tapez |
---|---|---|
uuid |
Identifiant/référence d’objet unique pour le PGPU | Lecture seule |
vendor-name |
Nom du fournisseur du PGPU | Lecture seule |
device-name |
Nom attribué par le fournisseur à ce modèle PGPU | Lecture seule |
gpu-group-uuid |
Identifiant/référence d’objet unique pour le groupe GPU auquel ce PGPU a été automatiquement attribué par . Les PGPU identiques sur les hôtes d’un pool sont regroupés | Lecture seule |
gpu-group-name-label |
Nom du groupe GPU auquel le PGPU est affecté | Lecture seule |
host-uuid |
Identifiant/référence d’objet unique pour l’ hôte auquel le PGPU est connecté | Lecture seule |
host-name-label |
Nom de l’ hôte auquel le PGPU est connecté | Lecture seule |
pci-id |
Identificateur PCI | Lecture seule |
dependencies |
Répertorie les périphériques PCI dépendants transmis à la même machine virtuelle | Paramètre de mappage en lecture/écriture |
other-config |
Une liste de paires clé/valeur qui spécifient des paramètres de configuration supplémentaires pour le PGPU | Paramètre de mappage en lecture/écriture |
supported-VGPU-types |
Liste des types de GPU virtuels pris en charge par le matériel sous-jacent | Lecture seule |
enabled-VGPU-types |
Liste des types de GPU virtuels qui ont été activés pour ce PGPU | Lecture/écriture |
resident-VGPUs |
Liste des VGPU fonctionnant sur ce PGPU | Lecture seule |
pgpu-disable-dom0-access
pgpu-disable-dom0-access uuuid = uuid
Désactivez l’accès PGPU à dom0.
pgpu-enable-dom0-access
pgpu-enable-dom0-access uuuid = uuid
Activer l’accès PGPU à dom0.
Paramètres du groupe GPU
Les groupes GPU ont les paramètres suivants :
Nom du paramètre | Description | Tapez |
---|---|---|
uuid |
Identifiant/référence d’objet unique pour le groupe GPU | Lecture seule |
name-label |
Le nom du groupe GPU | Lecture/écriture |
name-description |
Le texte descriptif du groupe GPU | Lecture/écriture |
VGPU-uuids |
Répertorie les références d’identificateur/objet uniques pour les GPU virtuels dans le groupe GPU | Paramètre de jeu en lecture seule |
PGPU-uuids |
Répertorie les références d’identificateur/objet uniques pour les PGPU dans le groupe GPU | Paramètre de jeu en lecture seule |
other-config |
Une liste de paires clé/valeur qui spécifient des paramètres de configuration supplémentaires pour le groupe GPU | Paramètre de mappage en lecture/écriture |
supported-VGPU-types |
Union de tous les types de GPU virtuels pris en charge par le matériel sous-jacent | Lecture seule |
enabled-VGPU-types |
Union de tous les types de GPU virtuels activés sur les PGPU sous-jacents | Lecture seule |
allocation-algorithm |
Depth-First/Breadth -first paramètre pour l’allocation de GPU virtuels sur les PGPU au sein du groupe | Paramètre enum en lecture/écriture |
Opérations du groupe GPU
Commandes pour travailler avec des groupes GPU
gpu-group-create
gpu-group-create nom-label = name_for_group [nom-description = description]
Crée un nouveau groupe GPU (vide) dans lequel les PGPU peuvent être déplacés.
gpu-group-destroy
gpu-group-destroy uuid = uuid_of_group
Détruit le groupe GPU ; autorisé uniquement pour les groupes vides.
gpu-group-get-remaining-capacity
gpu-group-get-remaining-capacity uuid = uuid_of_group vgpu-type-uuid = uuid_of_vgpu_type
Renvoie le nombre de GPU virtuels supplémentaires du type spécifié qui peuvent être instanciés dans ce groupe GPU.
gpu-group-param-set
gpu-group-param-set uuuid = uuid_of_group allocation-algorithm = breadth-first | depth-first
Modifie l’algorithme utilisé par le groupe GPU pour allouer des GPU virtuels aux PGPU.
gpu-group-param-get-uuid
gpu-group-param-get-uuid uuuid = uuid_of_group param-name = Types de vgpu-supportés | Enabled-vgpu-types
Renvoie les types pris en charge ou activés pour ce groupe GPU.
Paramètres GPU virtuels
Les GPU virtuels ont les paramètres suivants :
Nom du paramètre | Description | Tapez |
---|---|---|
uuid |
Identifiant/référence d’objet unique pour le GPU virtuel | Lecture seule |
vm-uuid |
Référence identifiant/objet unique pour la machine virtuelle à laquelle le GPU virtuel est affecté | Lecture seule |
vm-name-label |
Nom de la machine virtuelle à laquelle le GPU virtuel est affecté | Lecture seule |
gpu-group-uuid |
Référence identifiant/objet unique pour le groupe GPU dans lequel le GPU virtuel est contenu | Lecture seule |
gpu-group-name-label |
Nom du groupe GPU dans lequel le GPU virtuel est contenu | Lecture seule |
currently-attached |
True si une machine virtuelle avec GPU Pass-Through est en cours d’exécution, false sinon | Lecture seule |
other-config |
Une liste de paires clé/valeur qui spécifient des paramètres de configuration supplémentaires pour le GPU virtuel | Paramètre de mappage en lecture/écriture |
type-uuid |
Identifiant/référence d’objet unique pour le type de GPU virtuel de ce GPU virtuel | Paramètre de mappage en lecture/écriture |
type-model-name |
Nom du modèle associé au type GPU virtuel | Lecture seule |
Paramètres de type GPU virtuel
Note :
Le GPU Passthrough et les GPU virtuels ne sont pas compatibles avec , Stockage ou VM Suspension, sauf si les logiciels et cartes graphiques pris en charge par les fournisseurs GPU sont présents. Les machines virtuelles sans cette prise en charge ne peuvent pas être migrées pour éviter les temps d’arrêt. Pour plus d’informations sur la compatibilité vGPU NVIDIA avec , Stockage et Suspension de la machine virtuelle, voir [Graphiques/en-us/xenserver/current-release/graphics.html()].
Les types de GPU virtuels ont les paramètres suivants :
Nom du paramètre | Description | Tapez |
---|---|---|
uuid |
Identifiant/référence d’objet unique pour le type de GPU virtuel | Lecture seule |
vendor-name |
Nom du fournisseur de GPU virtuel | Lecture seule |
model-name |
Nom du modèle associé au type GPU virtuel | Lecture seule |
freeze-frame |
Taille de la mémoire tampon du type GPU virtuel, en octets | Lecture seule |
max-heads |
Nombre maximal d’écrans pris en charge par le type GPU virtuel | Lecture seule |
supported-on-PGPUs |
Liste des PGPU qui prennent en charge ce type de GPU virtuel | Lecture seule |
enabled-on-PGPUs |
Liste des PGPU pour lesquels ce type de GPU virtuel est activé | Lecture seule |
VGPU-uuids |
Liste des GPU virtuels de ce type | Lecture seule |
Opérations GPU virtuelles
vgpu-create
vgpu-create vm-uuid = uuid_of_vm gpu_group_uuid = uuid_of_gpu_group [vgpu-type-uid = uuid_of_vgpu-type]
Crée un GPU virtuel. Cette commande attache la machine virtuelle au groupe GPU spécifié et spécifie éventuellement le type de GPU virtuel. Si aucun type GPU virtuel n’est spécifié, le type « pass-through » est supposé.
vgpu-destroy
vgpu-destroy uuid = uuid_of_vgpu
Détruisez le GPU virtuel spécifié.
Désactivation de VNC pour machines virtuelles avec GPU virtuel
xe vm-param-add uuid=uuid_of_vmparam-name=platform vgpu_vnc_enabled=true|false.
L’utilisationfalse
désactive la console VNC d’une machine virtuelle lorsqu’elledisablevnc=1
passe à l’émulateur d’affichage. Par défaut, VNC est activé.
Commandes de l’hôte
Commandes pour interagir avec l’hôte.
sont les serveurs physiques exécutant le logiciel. Ils ont des machines virtuelles s’exécutant sous le contrôle d’une machine virtuelle privilégiée spéciale, appelée domaine de contrôle ou domaine 0.
Les objets hôtes peuvent être répertoriés avec les commandes standard de listage d’objets :xe host-listxe host-cpu-list ````, etxe host-crashdump-list``). Les paramètres peuvent être manipulés avec les commandes de paramètres standard. Pour plus d’informations, consultez Commandes de paramètres de bas niveau.
Sélecteurs d’hôte
Plusieurs des commandes répertoriées ici ont un mécanisme commun pour sélectionner un ou plusieurs hôtes sur lesquels effectuer l’opération. Le plus simple est de fournir l’argumenthost=uuid_or_name_label
. Vous pouvez également spécifier en filtrant la liste complète des hôtes sur les valeurs des champs. Par exemple, la spécificationenabled=true
sélectionne tous les hôtes dontenabled
le champ est égal àtrue
. Lorsque plusieurs hôtes correspondent et que l’opération peut être effectuée sur plusieurs hôtes, vous devez spécifier--multiple
pour effectuer l’opération. La liste complète des paramètres pouvant être mis en correspondance est décrite au début de cette section. Vous pouvez obtenir cette liste de commandes en exécutant la commandexe host-list params=all
. Si aucun paramètre de sélection des hôtes n’est donné, l’opération est effectuée sur tous les hôtes.
Paramètres de l’hôte
ont les paramètres suivants :
Nom du paramètre | Description | Tapez |
---|---|---|
uuid |
Identifiant/référence d’objet unique pour l’ hôte | Lecture seule |
name-label |
Le nom de l’ hôte | Lecture/écriture |
name-description |
La chaîne de description de l’ hôte | Lecture seule |
enabled |
La valeur estfalse si désactivée. Cela empêche les nouvelles machines virtuelles de démarrer sur les hôtes et prépare les hôtes à arrêter ou à redémarrer. La valeur esttrue si l’hôte est activé |
Lecture seule |
API-version-major |
Numéro de version principal | Lecture seule |
API-version-minor |
Numéro de version mineur | Lecture seule |
API-version-vendor |
Identification du fournisseur d’API | Lecture seule |
API-version-vendor-implementation |
Détails de la mise en œuvre du fournisseur | Paramètre de mappage en lecture seule |
logging |
Configuration de journalisation | Paramètre de mappage en lecture/écriture |
suspend-image-sr-uuid |
Référence identifiant/objet unique pour le SR où les images suspendues sont placées | Lecture/écriture |
crash-dump-sr-uuid |
Référence identifiant/objet unique pour le SR où les vidages de plantage sont placés | Lecture/écriture |
software-version |
Liste des paramètres de versioning et de leurs valeurs | Paramètre de mappage en lecture seule |
capabilities |
Liste des versions Xen que l’ hôte peut exécuter | Paramètre de jeu en lecture seule |
other-config |
Une liste de paires clé/valeur qui spécifient des paramètres de configuration supplémentaires pour l’ hôte | Paramètre de mappage en lecture/écriture |
chipset-info |
Une liste de paires clé/valeur qui spécifient des informations sur le chipset | Paramètre de mappage en lecture seule |
hostname |
nom d’ hôte | Lecture seule |
address |
adresse IP de l’ hôte | Lecture seule |
license-server |
Liste de paires clé/valeur qui spécifient des informations sur le serveur de licences. | Paramètre de mappage en lecture seule |
supported-bootloaders |
Liste des chargeurs d’amorçage pris en charge par l’ hôte, par exemple, pygrub, eliloader | Paramètre de jeu en lecture seule |
memory-total |
Quantité totale de RAM physique sur l’ hôte, en octets | Lecture seule |
memory-free |
Quantité totale de RAM physique restante pouvant être allouée aux machines virtuelles, en octets | Lecture seule |
host-metrics-live |
True si l’hôte est opérationnel | Lecture seule |
logging |
Lasyslog_destination clé peut être définie sur le nom d’hôte d’un service syslog à l’écoute distante. |
Paramètre de mappage en lecture/écriture |
allowed-operations |
Répertorie les opérations autorisées dans cet état. Cette liste est purement consultative et l’état du serveur peut avoir changé au moment où un client lit ce champ. | Paramètre de jeu en lecture seule |
current-operations |
Répertorie les opérations en cours. Cette liste est purement consultative et l’état du serveur peut avoir changé au moment où un client lit ce champ. | Paramètre de jeu en lecture seule |
patches |
Ensemble de patchs hôtes | Paramètre de jeu en lecture seule |
blobs |
Magasin de données binaires | Lecture seule |
memory-free-computed |
Estimation prudente de la quantité maximale de mémoire libre sur un hôte | Lecture seule |
ha-statefiles |
UUID de tous les fichiers d’état HA | Lecture seule |
ha-network-peers |
UUID de tous les hôtes pouvant héberger les machines virtuelles sur cet hôte en cas d’échec | Lecture seule |
external-auth-type |
Type d’authentification externe, par exemple, Active Directory. | Lecture seule |
external-auth-service-name |
Nom du service d’authentification externe | Lecture seule |
external-auth-configuration |
Informations de configuration pour le service d’authentification externe. | Paramètre de mappage en lecture seule |
contiennent d’autres objets qui ont également des listes de paramètres.
Les processeurs des hôtes ont les paramètres suivants :
Nom du paramètre | Description | Tapez |
---|---|---|
uuid |
Identifiant/référence d’objet unique pour le processeur | Lecture seule |
number |
Le numéro du cœur physique de l’unité centrale dans l’ hôte | Lecture seule |
vendor |
Chaîne fournisseur pour le nom du processeur | Lecture seule |
speed |
La vitesse d’horloge du processeur, en Hz | Lecture seule |
modelname |
Chaîne fournisseur pour le modèle de processeur, par exemple, « Intel (R) Xeon (TM) CPU 3.00 GHz » | Lecture seule |
stepping |
Numéro de révision du CPU | Lecture seule |
flags |
Les drapeaux de la CPU physique (une version décodée du champ d’entités) | Lecture seule |
Utilisation |
L’utilisation actuelle du processeur | Lecture seule |
host-uuid |
UUID si l’hôte dans lequel se trouve le CPU | Lecture seule |
model |
Numéro de modèle du CPU physique | Lecture seule |
family |
Numéro de famille de CPU physique | Lecture seule |
Les vidages sur les hôtes ont les paramètres suivants :
Nom du paramètre | Description | Tapez |
---|---|---|
uuid |
Référence identifiant/objet unique pour le crashdump | Lecture seule |
host |
hôte, le crashdump correspond à | Lecture seule |
timestamp |
Horodatage de la date et de l’heure auxquelles le crashdump s’est produit, sous la formeyyyymmdd-hhmmss-ABC , où ABCest l’indicateur de fuseau horaire, par exemple GMT |
Lecture seule |
size |
Taille du crashdump, en octets | Lecture seule |
host-all-editions
host-all-editions
Obtenir une liste de toutes les éditions disponibles
host-apply-edition
host-apply-edition [host-uuid = host_uuid] [edition = xenserver_edition = « free'per socket » "xendesktop"]
Affecte la licence à un serveur hôte. Lorsque vous attribuez une licence, contacte le serveur de licences et demande le type de licence spécifié. Si une licence est disponible, elle est retirée du serveur de licences.
Pour la configuration initiale des licences, reportez-vous également à la section license-server-address
et license-server-port
.
host-backup
host-backup file-name = backup_filename hôte = nom_hôte
Téléchargez une sauvegarde du domaine de contrôle de l’ hôte spécifié sur la machine à partir de laquelle la commande est appelée. Enregistrez-le là en tant que fichier avec le nomfile-name
.
Important :
Alors que la
xe host-backup
commande fonctionne si elle est exécutée sur l’hôte local (c’est-à-dire sans nom d’hôte spécifique spécifié), ne l’utilisez pas de cette façon. Cela remplirait la partition du domaine de contrôle avec le fichier de sauvegarde. Utilisez uniquement la commande d’une machine hors-hôte distante où vous avez de l’espace pour contenir le fichier de sauvegarde.
host-bugreport-upload
host-bugreport-upload [host-selector = host_selector_value...] [url = destination_url http-proxy = http_proxy_name]
Générez un nouveau rapport de bogue (à l’aide de xen-bugtool, avec tous les fichiers optionnels inclus) et téléchargez sur le site ftp de support ou un autre emplacement.
Les hôtes sur lesquels cette opération doit être effectuée sont sélectionnés à l’aide du mécanisme de sélection standard (voir les sélecteurs d’hôteci-dessus). Les arguments facultatifs peuvent être n’importe quel nombre des paramètres d’hôterépertoriés au début de cette section.
Les paramètres facultatifs sonthttp-proxy
: utilisez le proxy http spécifié eturl
: upload vers cette URL de destination. Si les paramètres facultatifs ne sont pas utilisés, aucun serveur proxy n’est identifié et la destination est le site ftp de support par défaut.
host-call-plugin
host-call-plugin host-uuid = host_uuid plugin = plugin fn = function [args = args]
Appelle la fonction dans le plugin sur l’hôte donné avec des arguments optionnels.
host-compute-free-memory
host-compute-free memory
Calcule la quantité de mémoire libre sur l’hôte.
host-compute-memory-overhead
host-compute-mémoire-surcharge
Calcule la surcharge mémoire de virtualisation d’un hôte.
host-cpu-info
host-cpu-info [uuid = uuid]
Répertorie des informations sur les processeurs physiques de l’hôte.
host-crashdump-destroy
host-crashdump-destroy uuid = crashdump_uuid
Supprimez un hôte crashdump spécifié par son UUID de l’ hôte.
host-crashdump-upload
host-crashdump-upload uuuid = crashdump_uuid [url = destination_url] [http-proxy = nom_proxy_http]
Téléchargez un crashdump sur le site ftp de support ou un autre emplacement. Si les paramètres facultatifs ne sont pas utilisés, aucun serveur proxy n’est identifié et la destination est le site ftp de support par défaut. Les paramètres facultatifs sonthttp-proxy
: utilisez le proxy http spécifié eturl
: upload vers cette URL de destination.
host-declare-dead
host-declare-dead uuid = host_uuid
Déclarez que l’hôte est mort sans le contacter explicitement.
Avertissement :
Cet appel est dangereux et peut entraîner une perte de données si l’hôte n’est pas réellement mort.
host-disable
host-disable [host-selector = host_selector_value...]
Désactive les hôtes spécifiés, ce qui empêche toute nouvelle VM de démarrer sur eux. Cette action prépare les hôtes à arrêter ou à redémarrer.
Les hôtes sur lesquels cette opération doit être effectuée sont sélectionnés à l’aide du mécanisme de sélection standard (voir sélecteurs d’hôte). Les arguments facultatifs peuvent être n’importe quel nombre des paramètres d’hôterépertoriés au début de cette section.
host-disable-display
host-disable-display uuid = host_uuid
Désactivez l’affichage de l’hôte.
host-disable-local-storage-caching
host-disable-local-stockage-mise en cache
Désactivez la mise en cache du stockage local sur l’hôte spécifié.
host-dmesg
host-dmesg [host-selector = host_selector_value...]
Obtenir un Xendmesg
(la sortie de la mémoire tampon du noyau) à partir des hôtes spécifiés.
Les hôtes sur lesquels cette opération doit être effectuée sont sélectionnés à l’aide du mécanisme de sélection standard (voir les sélecteurs d’hôteci-dessus). Les arguments facultatifs peuvent être n’importe quel nombre des paramètres d’hôterépertoriés au début de cette section.
host-emergency-ha-disable
host-emergency-ha-disable [— force]
Désactivez HA sur l’hôte local. Uniquement à utiliser pour récupérer un pool avec une configuration HA rompue.
host-emergency-management-reconfigure
host-emergency-management-reconfigure interface = uuid_of_management_interface_pif
Reconfigurez l’interface de gestion de cet hôte. Utilisez cette commande uniquement si l’ hôte est en mode d’urgence. Le mode d’urgence signifie que l’hôte est membre d’un pool de ressources dont le maître a disparu du réseau et ne peut pas être contacté après plusieurs tentatives.
host-enable
host-enable [host-selector = host_selector_value...]
Active les hôtes spécifiés, ce qui permet de démarrer de nouvelles machines virtuelles sur eux.
Les hôtes sur lesquels cette opération doit être effectuée sont sélectionnés à l’aide du mécanisme de sélection standard (voir les sélecteurs d’hôteci-dessus). Les arguments facultatifs peuvent être n’importe quel nombre des paramètres d’hôterépertoriés au début de cette section.
host-enable-display
host-enable-display uuid = host_uuid
Activer l’affichage de l’hôte.
host-enable-local-storage-caching
host-enable-local-stockage-caching sr-uuid = sr_uuid
Activer la mise en cache du stockage local sur l’hôte spécifié.
host-evacuate
host-evacuate [host-selector = host_selector_value...]
Live migre toutes les machines virtuelles en cours d’exécution vers d’autres hôtes appropriés sur un pool. Tout d’abord, disbale l’hôte à l’aide de lahost-disable
commande.
Si l’hôte évacué est le maître de pool, un autre hôte doit être sélectionné pour être le maître de pool. Pour modifier le maître de pool avec HA désactivé, utilisez lapool-designate-new-master
commande. Pour plus d’informations, voir pool-designate-new-master.
Avec HA activée, votre seule option est d’arrêter le serveur, ce qui provoque HA à élire un nouveau maître au hasard. Pour plus d’informations, voir host-shutdown.
Les hôtes sur lesquels cette opération doit être effectuée sont sélectionnés à l’aide du mécanisme de sélection standard (voir les sélecteurs d’hôteci-dessus). Les arguments facultatifs peuvent être n’importe quel nombre des paramètres d’hôterépertoriés au début de cette section.
host-forget
host-forget uuid = host_uuid
L’agent XAPI oublie l’ hôte spécifié sans le contacter explicitement.
Utilisez le--force
paramètre pour éviter d’être invité à confirmer que vous souhaitez réellement effectuer cette opération.
Avertissement :
N’utilisez pas cette commande si HA est activée sur le pool. Désactivez d’abord HA, puis réactivez-le après avoir oublié l’hôte.
Conseil :
Cette commande est utile si l’ hôte à « oublier » est mort. Toutefois, si l’ hôte est actif et fait partie du pool, utilisez à la
xe pool-eject
place.
host-get-cpu-features
host-get-cpu-features {features = pool_master_cpu_features} [uuid = host_uuid]
Imprime une représentation hexadécimale des fonctions physiques CPU de l’hôte.
host-get-server-certificate
host-get-server-certificate
Obtenez le certificat SSL du serveur installé.
host-get-sm-diagnostics
host-get-sm-diagnostics uuuid = uuid
Afficher les informations de diagnostic SM par hôte.
host-get-system-status
host-get-system-status filename = name\_for\_status\_file \[entries = virgule\_separated\_list] \[output = tar.bz2 | zip] \[host-selector = host\_selector\_value...]
Téléchargez les informations d’état du système dans le fichier spécifié. Le paramètre facultatifentries
est une liste séparée par des virgules d’entrées d’état système, tirée du fragment XML des capacités renvoyé par lahost-get-system-status-capabilities
commande. Pour plus d’informations, voir host-get-system-status-capabilities. Si ce n’est pas spécifié, toutes les informations d’état du système sont enregistrées dans le fichier. Le paramètreoutput
peut être tar.bz2 (valeur par défaut) ou zip . Si ce paramètre n’est pas spécifié, le fichier est enregistré soustar.bz2
forme.
Les hôtes sur lesquels cette opération doit être effectuée sont sélectionnés à l’aide du mécanisme de sélection standard (voir les sélecteurs d’hôteci-dessus).
host-get-system-status-capabilities
host-get-system-status-capabilities [host-selector = host_selector_value...]
Obtenez les capacités d’état du système pour les hôtes spécifiés. Les capacités sont renvoyées sous la forme d’un fragment XML semblable à l’exemple suivant :
<!--NeedCopy-->
Chaque entité de capacité peut avoir les attributs suivants.
-
key
Identificateur unique de la capacité. -
content-type
Peut être texte/plain ou application/données. Indique si une interface utilisateur peut afficher les entrées pour la consommation humaine. -
default-checked
Peut être oui ou non. Indique si une interface utilisateur doit sélectionner cette entrée par défaut. -
min-size
,max-size
Indique une plage approximative de la taille, en octets, de cette entrée. -1 indique que la taille est sans importance. -
min-time
,max-time
Indiquez une plage approximative pour le temps, en secondes, pris pour collecter cette entrée. -1 indique que l’heure n’est pas importante. -
Informations
pii
personnelles identifiables. Indique si l’entrée contient des informations permettant d’identifier le propriétaire du système ou les détails de leur topologie réseau. L’attribut peut avoir l’une des valeurs suivantes :-
no
: aucune PII n’est dans ces entrées -
yes
: PII est probable ou certainement dans ces entrées -
maybe
: vous voudrez peut-être auditer ces entrées pour les PII -
if_customized
si les fichiers ne sont pas modifiés, ils ne contiennent aucune PII. Cependant, étant donné que nous encourageons la modification de ces fichiers, des PII pourraient avoir été introduites par une telle personnalisation. Cette valeur est utilisée en particulier pour les scripts de mise en réseau dans le domaine de contrôle.
Les mots de passe ne doivent jamais être inclus dans un rapport de bogue, quelle que soit la déclaration de PII.
-
Les hôtes sur lesquels cette opération doit être effectuée sont sélectionnés à l’aide du mécanisme de sélection standard (voir les sélecteurs d’hôteci-dessus).
host-get-thread-diagnostics
host-get-thread-diagnostics uuuid = uuid
Afficher les informations de diagnostic de thread par hôte.
host-get-vms-which-prevent-evacuation
host-get-vms-which-prevent-évacuation uuid = uuid
Renvoie une liste de machines virtuelles qui empêchent l’évacuation d’un hôte spécifique et affiche les raisons pour chacune d’elles.
host-is-in-emergency-mode
host-is-en mode d'urgence
Renvoietrue
si l’hôte à qui l’interface de ligne de commande parle est en mode d’urgence,false
sinon. Cette commande CLI fonctionne directement sur les hôtes esclaves même sans hôte maître présent.
host-license-add
host-license-add [license-file = chemin/license_filename] [host-uuid = host_uuid]
Pour (édition gratuite), utilisez pour analyser un fichier de licence local et l’ajouter à l’ hôte spécifié.
host-license-remove
host-license-remove [host-uuid = host_uuid]
Supprimez toute licence appliquée à un hôte.
host-license-view
host-license-view [host-uuid = host_uuid]
Affiche le contenu de la licence hôte.
host-logs-download
host-logs-download [file-name = logfile_name] [host-selector = host_selector_value...]
Téléchargez une copie des journaux des hôtes spécifiés. La copie est enregistrée par défaut dans un fichier horodaté nomméhostname-yyyy-mm-dd T hh:mm:ssZ.tar.gz
. Vous pouvez spécifier un nom de fichier différent à l’aide du paramètre facultatif nom de fichier.
Les hôtes sur lesquels cette opération doit être effectuée sont sélectionnés à l’aide du mécanisme de sélection standard (voir les sélecteurs d’hôteci-dessus). Les arguments facultatifs peuvent être n’importe quel nombre des paramètres d’hôterépertoriés au début de cette section.
Important :
Alors que la
xe host-logs-download
commande fonctionne si elle est exécutée sur l’hôte local (c’est-à-dire sans nom d’hôte spécifique spécifié), ne l’utilisez pas de cette façon. Cela encombrera la partition du domaine de contrôle avec la copie des journaux. La commande ne doit être utilisée qu’à partir d’une machine hors hôte distante où vous avez de l’espace pour contenir la copie des journaux.
host-management-disable
host-management-disable
Désactive l’écoute de l’agent hôte sur une interface réseau de gestion externe et déconnecte tous les clients API connectés (tels que ). Cette commande fonctionne directement sur l’ hôte auquel la CLI est connectée. La commande n’est pas transférée au maître de pool lorsqu’elle est appliquée à un hôte membre.
Avertissement :
Soyez prudent lorsque vous utilisez cette commande CLI hors hôte. Une fois cette commande exécutée, vous ne pouvez pas vous connecter au domaine de contrôle à distance sur le réseau pour réactiver l’agent hôte.
host-management-reconfigure
host-management-reconfigure [interface = device] [pif-uuid = uuid]
Reconfigure l’ hôte pour utiliser l’interface réseau spécifiée comme interface de gestion, qui est l’interface utilisée pour se connecter à la . La commande réécrit la clé MANAGEMENT_INTERFACE dans/etc/xensource-inventory
.
Si le nom de périphérique d’une interface (qui doit avoir une adresse IP) est spécifié, l’ hôte se reconnecte immédiatement. Cette commande fonctionne à la fois en mode normal et en mode d’urgence.
Si l’UUID d’un objet PIF est spécifié, l’ hôte détermine l’adresse IP à relier à lui-même. Il ne doit pas être en mode d’urgence lorsque cette commande est exécutée.
Avertissement :
Soyez prudent lorsque vous utilisez cette commande CLI hors hôte et assurez-vous que vous disposez d’une connectivité réseau sur la nouvelle interface. Permet
xe pif-reconfigure
d’en configurer un en premier. Sinon, les commandes CLI suivantes atteignent l’ hôte.
host-power-on
host-power-on [host = host_uuid]
Active la mise sous tension des hôtes avec la fonction de mise sous tension de l’hôte activée. Avant d’utiliser cette commande, activez host-set-power-on
sur l’hôte.
host-reboot
host-reboot [host-selector = host_selector_value...]
Redémarrez les hôtes spécifiés. Les hôtes spécifiés doivent d’abord être désactivés à l’aide de laxe host-disable
commande, sinon un messageHOST_IN_USE
d’erreur s’affiche.
Les hôtes sur lesquels cette opération doit être effectuée sont sélectionnés à l’aide du mécanisme de sélection standard (voir les sélecteurs d’hôteci-dessus). Les arguments facultatifs peuvent être n’importe quel nombre des paramètres d’hôterépertoriés au début de cette section.
Si les hôtes spécifiés sont membres d’un pool, la perte de connectivité lors de l’arrêt est gérée et le pool récupère lorsque les hôtes retournent. Les autres membres et le capitaine continuent de fonctionner.
Si vous arrêtez le maître, le pool est hors d’action jusqu’à ce que l’une des actions suivantes se produise :
- Vous faites un des membres dans le maître
-
Le maître d’origine est redémarré et redémarré.
Lorsque le maître est de retour en ligne, les membres se reconnectent et se synchronisent avec le maître.
host-restore
host-restore [file-name = backup_filename] [host-selector = host_selector_value...]
Restaurer une sauvegarde nomméefile-name
du logiciel de contrôle hôte. L’utilisation du mot « restauration » ici ne signifie pas une restauration complète au sens habituel, mais simplement que le fichier de sauvegarde compressé a été décompressé et décompressé sur la partition secondaire. Après avoir fait unxe host-restore
, vous devez démarrer le CD d’installation et utiliser son option Restaurer à partir de la sauvegarde.
Les hôtes sur lesquels cette opération doit être effectuée sont sélectionnés à l’aide du mécanisme de sélection standard (voir les sélecteurs d’hôteci-dessus). Les arguments facultatifs peuvent être n’importe quel nombre des paramètres d’hôterépertoriés au début de cette section.
host-send-debug-keys
host-send-debug-keys host-uuid = host_uuid keys = keys
Envoyer les clés de débogage d’hyperviseur spécifiées à l’hôte spécifié.
host-set-hostname-live
host-set-hostname host-uuid = uuid_of_host hostname = new_hostname
Modifiez le nom d’hôte de l’ hôte spécifié parhost-uuid
. Cette commande définit de manière persistante le nom d’hôte dans la base de données du domaine de contrôle et le nom d’hôte Linux réel de l’ hôte. La valeur de hostname**n’est pas la même que celle du champ name_label .
host-set-power-on-mode
host-set-power-on-mode {host = host_uuid {power-on-mode = "" « wake-on-lan »
« iLO » \"DRAC\" \"« custom »} | \[power-on-config = « power\_on\_ip » \"power\_on\_user'power\_on\_password\_secret\"]}
Permet d’activer la fonction de mise sous tension de l’hôte sur les hôtes compatibles avec les solutions d’alimentation à distance. Lorsque vous utilisez lahost-set-power-on
commande, vous devez spécifier le type de solution de gestion de l’alimentation sur l’hôte (c’est-à-dire le mode d’alimentation). Spécifiez ensuite les options de configuration en utilisant l’argument power-on-config et les paires clé-valeur associées. Pour utiliser la fonction Secrets pour stocker votre mot de passe, spécifiez la clé"power_on_password_secret"
.
host-shutdown
host-shutdown [host-selector = host_selector_value...]
Arrêtez les hôtes spécifiés. Les hôtes spécifiés doivent d’abord être désactivés à l’aide de laxe host-disable
commande, sinon un messageHOST_IN_USE
d’erreur s’affiche.
Les hôtes sur lesquels cette opération doit être effectuée sont sélectionnés à l’aide du mécanisme de sélection standard (voir les sélecteurs d’hôteci-dessus). Les arguments facultatifs peuvent être n’importe quel nombre des paramètres d’hôterépertoriés au début de cette section.
Si les hôtes spécifiés sont membres d’un pool, la perte de connectivité lors de l’arrêt est gérée et le pool récupère lorsque les hôtes retournent. Les autres membres et le capitaine continuent de fonctionner.
Si vous arrêtez le maître, le pool est hors d’action jusqu’à ce que l’une des actions suivantes se produise :
- Vous faites un des membres dans le maître
-
Le maître d’origine est redémarré et redémarré.
Lorsque le maître est de retour en ligne, les membres se reconnectent et se synchronisent avec le maître.
Si HA est activée pour le pool, l’un des membres est automatiquement transformé en maître. Si HA est désactivée, vous devez désigner manuellement le serveur souhaité comme maître avec lapool-designate-new-master
commande. Pour plus d’informations, voir pool-designate-new-master.
host-sm-dp-destroy
host-sm-dp-destroy uuid = uuid dp = dp \[allow-leak = true | false]
Essayez de détruire et de nettoyer un chemin de données de stockage sur un hôte. Siallow-leak=true
est fourni, il supprimera tous les enregistrements du datapath même s’il n’a pas pu être arrêté proprement.
host-sync-data
host-synchronc-data
Synchronisez les données autres que la base de données stockées sur le maître de pool avec l’hôte nommé.
host-syslog-reconfigure
host-syslog-reconfigure [host-selector = host_selector_value...]
Reconfigurez lesyslog
démon sur les hôtes spécifiés. Cette commande applique les informations de configuration définies dans lelogging
paramètre hôte.
Les hôtes sur lesquels cette opération doit être effectuée sont sélectionnés à l’aide du mécanisme de sélection standard (voir les sélecteurs d’hôteci-dessus). Les arguments facultatifs peuvent être n’importe quel nombre des paramètres d’hôterépertoriés au début de cette section.
host-data-source-list
host-data-source-list [host-selectors = valeur du sélecteur d'hôte...]
Répertorie les sources de données pouvant être enregistrées pour un hôte.
Sélectionnez les hôtes sur lesquels effectuer cette opération à l’aide du mécanisme de sélection standard (voir sélecteurs d’hôte). Les arguments facultatifs peuvent être n’importe quel nombre des paramètres d’hôterépertoriés au début de cette section. Si aucun paramètre de sélection des hôtes n’est donné, l’opération est effectuée sur tous les hôtes.
Les sources de données ont deux paramètres —standard
etenabled
. Cette commande génère les valeurs des paramètres :
- Si une source de données est
enabled
définie surtrue
, les mesures sont actuellement enregistrées dans la base de données de performances. - Si une source de données a la
standard
valeurtrue
, les mesures sont enregistrées par défaut dans la base de données de performances. La valeur deenabled
est également définie surtrue
pour cette source de données. - Si une source de données a la
standard
valeurfalse
, les mesures ne sont pas enregistrées par défaut dans la base de données de performances. La valeur deenabled
est également définie surfalse
pour cette source de données.
Pour commencer à enregistrer des mesures de source de données dans la base de données de performances, exécutez lahost-data-source-record
commande. Cette commande définitenabled
la valeurtrue
. Pour arrêter, exécutez lehost-data-source-forget
. Cette commande définitenabled
la valeurfalse
.
host-data-source-record
host-data-source-record data-source = name_description_of_data_source [host-selectors = host_selector_value...]
Enregistrez la source de données spécifiée pour un hôte.
Cette opération écrit les informations de la source de données dans la base de données de mesures de performances persistantes des hôtes spécifiés. Pour des raisons de performances, cette base de données est distincte de la base de données de l’agent normal.
Sélectionnez les hôtes sur lesquels effectuer cette opération à l’aide du mécanisme de sélection standard (voir sélecteurs d’hôte). Les arguments facultatifs peuvent être n’importe quel nombre des paramètres d’hôterépertoriés au début de cette section. Si aucun paramètre de sélection des hôtes n’est donné, l’opération est effectuée sur tous les hôtes.
host-data-source-forget
host-data-source-forget data-source = name_description_of_data_source [host-selectors = host_selector_value...]
Arrêtez d’enregistrer la source de données spécifiée pour un hôte et oubliez toutes les données enregistrées.
Sélectionnez les hôtes sur lesquels effectuer cette opération à l’aide du mécanisme de sélection standard (voir sélecteurs d’hôte). Les arguments facultatifs peuvent être n’importe quel nombre des paramètres d’hôterépertoriés au début de cette section. Si aucun paramètre de sélection des hôtes n’est donné, l’opération est effectuée sur tous les hôtes.
host-data-source-query
host-data-source-query data-source = name_description_of_data_source [host-selectors = host_selector_value...]
Affiche la source de données spécifiée pour un hôte.
Sélectionnez les hôtes sur lesquels effectuer cette opération à l’aide du mécanisme de sélection standard (voir sélecteurs d’hôte). Les arguments facultatifs peuvent être n’importe quel nombre des paramètres d’hôterépertoriés au début de cette section. Si aucun paramètre de sélection des hôtes n’est donné, l’opération est effectuée sur tous les hôtes.
Commandes de journal
Commandes pour travailler avec les journaux.
log-get
log-get
Retourne le journal actuellement stocké dans l’enregistreur de chaînes.
log-get-keys
log-get-keys
Répertorier les clés connues par l’enregistreur.
log-reopen
rouvrir la session
Réouvrez tous les enregistreurs (utilisez ceci pour faire pivoter les fichiers).
log-set-output
log-set-output output output = output [key = key] [level = level]
Définissez tous les enregistreurs à la sortie spécifiée (nil, stderr, chaîne, fichier :nom de fichier, syslog :quelque chose).
Commandes de message
Commandes pour travailler avec les messages. Les messages sont créés pour avertir les utilisateurs d’événements importants et sont affichés sous forme d’alertes.
Les objets de message peuvent être répertoriés avec la commande de listage d’objets standard (xe message-list
) et les paramètres manipulés avec les commandes de paramètres standard. Pour plus d’informations, voir [Comman#low-level-parameter-commands()des de paramètres de bas niveau]
Paramètres du message
Nom du paramètre | Description | Tapez |
---|---|---|
uuid |
Identifiant/référence d’objet unique pour le message | Lecture seule |
name |
Le nom unique du message | Lecture seule |
priority |
La priorité du message. Les chiffres plus élevés indiquent une plus grande priorité | Lecture seule |
class |
La classe de message, par exemple la machine virtuelle. | Lecture seule |
obj-uuid |
UUID de l’objet affecté. | Lecture seule |
timestamp |
Heure à laquelle le message a été généré. | Lecture seule |
body |
Le contenu du message. | Lecture seule |
message-create
message-create name = message\_name body = message\_text \[\[host-uuid = uuid\_of\_host] | \[sr-uuuid = uuid\_of\_sr} | \[vm-uuid = uuid\_of\_vm] | \[pool-uuid = uuid\_of\_pool]]
Crée un message.
message-destroy
message-destroy [uuid = message_uuid]
Détruit un message existant. Vous pouvez créer un script pour détruire tous les messages. Par exemple :
# Ignorer toutes les alertes \
IFS = « , » ; pour m en $(xe message-list params = uuid — minimal) ; faire \
xe message-destroy uuid = $m \
fait
Commandes réseau
Commandes pour travailler avec des réseaux.
Les objets réseau peuvent être répertoriés avec la commande de listage d’objets standard (xe network-list
) et les paramètres manipulés avec les commandes de paramètres standard. Pour plus d’informations, voir [Comman#low-level-parameter-commands()des de paramètres de bas niveau]
Paramètres réseau
Les réseaux ont les paramètres suivants :
Nom du paramètre | Description | Tapez |
---|---|---|
uuid |
Identifiant/référence d’objet unique pour le réseau | Lecture seule |
name-label |
Le nom du réseau | Lecture/écriture |
name-description |
Le texte de description du réseau | Lecture/écriture |
VIF-uuids |
Liste des identificateurs uniques des VIF (interfaces réseau virtuelles) qui sont attachés à partir de machines virtuelles à ce réseau | Paramètre de jeu en lecture seule |
PIF-uuids |
Liste des identificateurs uniques des PIF (interfaces réseau physiques) qui sont attachés à ce réseau depuis des hôtes | Paramètre de jeu en lecture seule |
bridge |
Nom du pont correspondant à ce réseau sur l’ hôte local | Lecture seule |
default-locking-mode |
Objet réseau utilisé avec les objets VIF pour le filtrage ARP. Définissezunlocked sur pour supprimer toutes les règles de filtrage associées au VIF. Réglez surdisabled telle sorte que le VIF supprime tout le trafic. |
Lecture/écriture |
purpose |
Ensemble d’objectifs pour lesquels l’ hôte utilise ce réseau. Définisseznbd sur pour utiliser le réseau pour établir des connexions NBD. |
Lecture/écriture |
other-config:staticroutes |
Liste séparée par des virgules d’entrées formatées sous réseaux/masque de réseau/passerellespécifiant l’adresse de passerelle à travers laquelle acheminer les sous-réseaux. Par exemple, la valeurother-config:static-routes 172.16.0.0/15/192 .168.0.3, 172.18.0.0/16/192 .168.0.4 entraîne le routage du trafic sur 172.16.0.0/15 sur 192.168.0.3 et le trafic sur 172.18.0.0/16 sur 192.168.0.4. |
Lecture/écriture |
other-config:ethtoolautoneg |
Définissez la valeur no pour désactiver l’autonégociation de l’interface physique ou du pont. La valeur par défaut est oui. | Lecture/écriture |
other-config:ethtool-rx |
Définir sur on pour activer la somme de contrôle de réception, désactivé pour désactiver | Lecture/écriture |
other-config:ethtool-tx |
Définir sur on pour activer la somme de contrôle de transmission, désactivé pour désactiver | Lecture/écriture |
other-config:ethtool-sg |
Activé pour activer le rassemblement de dispersion, désactivé pour désactiver | Lecture/écriture |
other-config:ethtool-tso |
Définir sur on pour activer le déchargement de la segmentation tcp, désactivé pour désactiver | Lecture/écriture |
other-config:ethtool-ufo |
Définir sur on pour activer le déchargement du fragment UDP, désactivé pour désactiver | Lecture/écriture |
other-config:ethtool-gso |
Définir sur on pour activer le déchargement de segmentation générique, désactivé pour désactiver | Lecture/écriture |
blobs |
Magasin de données binaires | Lecture seule |
network-create
network-create name-label = name_for_network [name-description = descriptive_text]
Crée un réseau.
network-destroy
network-destroy uuid = network_uuid
Détruit un réseau existant.
Commandes SR-IOV
Commandes pour travailler avec SR-IOV.
Les objets network-sriov peuvent être répertoriés avec la commande de listage d’objets standard (xe network-sriov-list
), et les paramètres manipulés avec les commandes de paramètres standard. Pour plus d’informations, voir [Comman#low-level-parameter-commands()des de paramètres de bas niveau]
Paramètres SR-IOV
SR-IOV a les paramètres suivants :
Nom du paramètre | Description | Tapez |
---|---|---|
physical-PIF |
Le PIF pour activer SR-IOV. | Lecture seule |
logical-PIF |
Un PIF logique SR-IOV. Les utilisateurs peuvent utiliser ce paramètre pour créer un réseau VLAN SR-IOV. | Lecture seule |
requires-reboot |
Si défini sur True, utilisé pour redémarrer l’hôte pour activer SR-IOV. | Lecture seule |
remaining-capacity |
Nombre de VF disponibles restants. | Lecture seule |
network-sriov-create
xe network-sriov-create network-uuid = network_uuid pif-uuid = physical_pif_uuid
Crée un objet réseau SR-IOV pour un PIF physique donné et active SR-IOV sur le PIF physique.
network-sriov-destroy
xe network-sriov-destroy uuid = network_sriov_uuid
Supprime un objet réseau SR-IOV et désactive SR-IOV sur son PIF physique.
Affecter un VF SR-IOV
xe vif-create device = device_index mac = vf_mac_address network-uuid = sriov_network vm-uuid = vm_uuid
Affecte un VF à partir d’un réseau SR-IOV à une machine virtuelle.
Commandes du contrôleur SDN
Commandes pour travailler avec le contrôleur SDN.
sdn-controller-forget
sdn-controller-introduce [address = address] [protocol = protocol] [tcp-port = tcp_port]
Introduire un contrôleur SDN.
sdn-controller-introduce
sdn-controller-forget uuuid = uuid
Supprimez un contrôleur SDN.
Commandes de tunnel
Commandes pour travailler avec des tunnels.
tunnel-create
tunnel-create pif-uuid = pif_uuid network-uuid = network_uuid
Créez un nouveau tunnel sur un hôte.
tunnel-destroy
tunnel-destroy uuid = uuid
Détruisez un tunnel.
Commandes de correctifs
Commandes pour travailler avec des correctifs.
patch-apply
patch-apply uuid = patch_uuid host-uuid = host_uuid
Appliquez le correctif précédemment téléchargé à l’hôte spécifié.
patch-clean
patch-clean uuid = uuid
Supprimez un fichier de correctifs précédemment téléchargé.
patch-destroy
patch-destroy uuid = uuid
Supprimez un enregistrement et des fichiers de correctif non appliqués du serveur.
patch-pool-apply
patch-pool-apply uuid = uuid
Appliquez le correctif précédemment téléchargé à tous les hôtes du pool.
patch-pool-clean
patch-pool-clean uuid = uuid
Supprimez un fichier de correctifs précédemment téléchargé sur tous les hôtes du pool.
patch-precheck
patch-precheck uuid = uuid host-uuid = host_uuid
Exécutez les prévérifications contenues dans le correctif précédemment téléchargé sur l’hôte spécifié.
patch-upload
patch-upload fichier-name = nom_fichier
Téléchargez un fichier de correctifs sur le serveur.
Commandes PBD
Commandes pour travailler avec les PBD (Physical Block Devices). Les PBD sont les objets logiciels par lesquels l’ hôte accède aux référentiels de stockage (SR).
Les objets PBD peuvent être répertoriés avec la commande de listage d’objets standard (xe pbd-list
) et les paramètres manipulés avec les commandes de paramètres standard. Pour plus d’informations, voir [Comman#low-level-parameter-commands()des de paramètres de bas niveau]
Paramètres PBD
Les PBD ont les paramètres suivants :
Nom du paramètre | Description | Tapez |
---|---|---|
uuid |
Identifiant/référence d’objet unique pour le PBD. | Lecture seule |
sr-uuid |
Référentiel de stockage vers lequel le PBD pointe | Lecture seule |
device-config |
Informations de configuration supplémentaires fournies au pilote SR-backend-driver d’un hôte | Paramètre de mappage en lecture seule |
currently-attached |
True si le SR est attaché à cet hôte, False sinon | Lecture seule |
host-uuid |
UUID de la machine physique sur laquelle le PBD est disponible | Lecture seule |
host |
Le champ hôte est obsolète. Utilisez host_uuid à la place. | Lecture seule |
other-config |
Informations de configuration supplémentaires. | Paramètre de mappage en lecture/écriture |
pbd-create
pbd-create host-uuid = uuid_of_host sr-uuid = uuid_of_sr [device-config : key = value_correspondant]
Créez un PBD sur votre hôte. Ledevice-config
paramètre en lecture seule ne peut être défini qu’à la création.
Pour ajouter un mappage de ‘path’ à ‘/ tmp’, la ligne de commande doit contenir l’argumentdevice-config:path=/tmp
Pour obtenir la liste complète des paires clé/valeur de configuration périphérique prises en charge pour chaque type SR, reportez-vous à la section Stockage.
pbd-destroy
pbd-destroy uuid = uuid_of_pbd
Détruisez le PBD spécifié.
pbd-plug
pbd-plug uuid = uuid_of_pbd
Tente de brancher le PBD à l’ hôte. Si cette commande réussit, le SR référencé (et les VDI contenus dans) devrait alors devenir visible par l’ hôte.
pbd-unplug
pbd-unplug uuid = uuid_of_pbd
Essayez de débrancher le PBD de l’ hôte.
Commandes PIF
Commandes pour travailler avec des PIF (objets représentant les interfaces réseau physiques).
Les objets PIF peuvent être répertoriés avec la commande de listage d’objets standard (xe pif-list
) et les paramètres manipulés avec les commandes de paramètres standard. Pour plus d’informations, voir [Comman#low-level-parameter-commands()des de paramètres de bas niveau]
Paramètres PIF
Les FRP ont les paramètres suivants :
Nom du paramètre | Description | Tapez |
---|---|---|
uuid |
Identifiant/référence d’objet unique pour le FRP | Lecture seule |
device machine-readable |
Nom de l’interface (par exemple, eth0) | Lecture seule |
MAC |
L’adresse MAC du FRP | Lecture seule |
other-config |
Pname:value aires de configuration PIF supplémentaires. |
Paramètre de mappage en lecture/écriture |
physical |
Si la valeur est true, le PIF pointe vers une interface réseau physique réelle | Lecture seule |
currently-attached |
Le FRP est-il actuellement attaché à cet hôte ? true oufalse
|
Lecture seule |
MTU |
Unité de transmission maximale du PIF en octets. | Lecture seule |
VLAN |
Balise VLAN pour tout le trafic passant par cette interface. -1 indique qu’aucune balise VLAN n’est attribuée | Lecture seule |
bond-master-of |
L’UUID de l’obligation que ce FRP est le maître de (le cas échéant) | Lecture seule |
bond-slave-of |
L’UUID du lien que ce PIF est l’esclave de (le cas échéant) | Lecture seule |
management |
Ce PIF est-il désigné comme une interface de gestion pour le domaine de contrôle | Lecture seule |
network-uuid |
Identifiant/référence d’objet unique du réseau virtuel auquel ce PIF est connecté | Lecture seule |
network-name-label |
Nom du réseau virtuel auquel ce PIF est connecté | Lecture seule |
host-uuid |
Identifiant/référence d’objet unique de l’ hôte auquel ce PIF est connecté | Lecture seule |
host-name-label |
Nom de l’ hôte auquel ce PIF est connecté | Lecture seule |
IP-configuration-mode |
Type de configuration d’adresse réseau utilisé ; DHCP ou statique | Lecture seule |
IP |
Adresse IP du PIF. Définie ici lorsque le mode de configuration IP est statique ; non définie lorsque DHCP | Lecture seule |
netmask |
Masque réseau du PIF. Définie ici lorsque le mode de configuration IP est statique ; non définie lorsqu’il est fourni par DHCP | Lecture seule |
gateway |
Adresse de la passerelle du PIF. Définie ici lorsque le mode de configuration IP est statique ; non définie lorsqu’il est fourni par DHCP | Lecture seule |
DNS |
Adresse DNS du PIF. Définie ici lorsque le mode de configuration IP est statique ; non définie lorsqu’il est fourni par DHCP | Lecture seule |
io_read_kbs |
Taux de lecture moyen en Ko/s pour l’appareil | Lecture seule |
io_write_kbs |
Taux d’écriture moyen en Ko/s pour l’appareil | Lecture seule |
carrier |
État du lien pour ce périphérique | Lecture seule |
vendor-id |
ID attribué au fournisseur de la carte réseau | Lecture seule |
vendor-name |
Nom du fournisseur de la carte réseau | Lecture seule |
device-id |
ID attribué par le fournisseur à ce modèle de carte réseau | Lecture seule |
device-name |
Nom attribué par le fournisseur à ce modèle de carte réseau | Lecture seule |
speed |
Taux de transfert de données de la carte réseau | Lecture seule |
duplex |
Mode duplexage de la carte réseau ; plein ou demi | Lecture seule |
pci-bus-path |
Adresse du chemin de bus PCI | Lecture seule |
other-config:ethtoolspeed |
Définit la vitesse de connexion en Mbps | Lecture/écriture |
other-config:ethtoolautoneg |
Définissez la valeur no pour désactiver l’autonégociation de l’interface physique ou du pont. La valeur par défaut est oui. | Lecture/écriture |
other-config:ethtoolduplex |
Définit la capacité de duplexage du PIF, soit plein, soit moitié. | Lecture/écriture |
other-config:ethtool-rx |
Définir sur on pour activer la somme de contrôle de réception, désactivé pour désactiver | Lecture/écriture |
other-config:ethtool-tx |
Définir sur on pour activer la somme de contrôle de transmission, désactivé pour désactiver | Lecture/écriture |
other-config:ethtool-sg |
Activé pour activer le rassemblement de dispersion, désactivé pour désactiver | Lecture/écriture |
other-config:ethtool-tso |
Définir sur on pour activer le déchargement de la segmentation tcp, désactivé pour désactiver | Lecture/écriture |
other-config:ethtool-ufo |
Définir sur on pour activer le déchargement du fragment udp, désactivé pour désactiver | Lecture/écriture |
other-config:ethtool-gso |
Définir sur on pour activer le déchargement de segmentation générique, désactivé pour désactiver | Lecture/écriture |
other-config:domain |
Liste séparée par des virgules utilisée pour définir le chemin de recherche DNS | Lecture/écriture |
other-config:bondmiimon |
Intervalle entre les contrôles de liveness, en millisecondes | Lecture/écriture |
other-config:bonddowndelay |
Nombre de millisecondes à attendre après la perte du lien avant de considérer vraiment le lien comme étant parti. Ce paramètre permet la perte de lien transitoire | Lecture/écriture |
other-config:bondupdelay |
Nombre de millisecondes à attendre après l’arrivée du lien avant de vraiment l’envisager. Permet le battement de liens. La valeur par défaut est31s de laisser le temps aux commutateurs pour commencer à transférer le trafic. |
Lecture/écriture |
disallow-unplug |
True si ce PIF est une carte réseau de stockage dédiée, false sinon | Lecture/écriture |
Note :
Les modifications apportées aux
other-config
champs d’un PIF ne prennent effet qu’après un redémarrage. Alternativement, utilisez lesxe pif-unplug
commandesxe pif-plug
et pour provoquer la réécriture de la configuration PIF.
pif-forget
pif-forget uuid = uuid_of_pif
Détruisez l’objet PIF spécifié sur un hôte particulier.
pif-introduce
pif-introduce host-uuid = host_uuid mac = mac_address_for_pif device = nom_interface
Créez un objet PIF représentant une interface physique sur l’ hôte spécifié.
pif-plug
pif-plug uuid = uuid_of_pif
Essayez de faire apparaître l’interface physique spécifiée.
pif-reconfigure-ip
pif-reconfigure-ip uuuid = uuid\_of\_pif \[mode = dhcp | mode = statique] gateway = network\_gateway\_address IP = static\_ip\_for\_this\_pif netmask = netmask\_for\_this\_pif \[DNS = dns\_address]
Modifiez l’adresse IP du PIF. Pour la configuration IP statique, définissez le mode paramètre surstatic
, avec legatewayIP````, etnetmask`` définis sur les valeurs appropriées. Pour utiliser DHCP, définissez lemode
paramètre surDHCP
et laissez les paramètres statiques indéfinis.
Note :
L’utilisation d’adresses IP statiques sur des interfaces réseau physiques connectées à un port sur un commutateur à l’aide du protocole Spanning Tree avec STP Fast Link désactivé (ou non pris en charge) entraîne une période pendant laquelle il n’y a pas de trafic.
pif-reconfigure-ipv6
pif-reconfigure-ipv6 uuid = uuid_of_pif mode = mode [gateway = network_gateway_address] [IPv6 = static_ip_for_this_pif] [DNS = dns_address]
Reconfigurez les paramètres d’adresse IPv6 sur un PIF.
pif-scan
pif-scan host-uuid = host_uuid
Rechercher de nouvelles interfaces physiques sur votre hôte.
pif-set-primary-address-type
pif-set-primary-address-type uuid = uuid primary_address_type = address_type
Modifiez le type d’adresse principal utilisé par ce PIF.
pif-unplug
pif-unplug uuid = uuid_of_pif
Essayez de faire baisser l’interface physique spécifiée.
Commandes de pool
Commandes pour travailler avec des pools. Un pool est un agrégat d’un ou de plusieurs hôtes. Un pool utilise un ou plusieurs référentiels de stockage partagés afin que les machines virtuelles exécutées sur un hôte du pool puissent être migrées en temps quasi réel vers un autre hôte du pool. Cette migration se produit alors que la machine virtuelle est toujours en cours d’exécution, sans qu’elle ait besoin d’être arrêtée et ramenée. Chaque hôte est vraiment un pool composé d’un seul membre par défaut. Lorsque votre hôte est joint à un pool, il est désigné comme membre, et le pool auquel il a rejoint devient le maître du pool.
L’objet pool singleton peut être répertorié avec la commande de listage d’objets standard (xe pool-list
). Ses paramètres peuvent être manipulés avec les commandes de paramètres standard. Pour plus d’informations, voir [Comman#low-level-parameter-commands()des de paramètres de bas niveau]
Paramètres de pool
Les pools ont les paramètres suivants :
Nom du paramètre | Description | Tapez |
---|---|---|
uuid |
Identifiant/référence d’objet unique pour le pool | Lecture seule |
name-label |
Le nom du pool | Lecture/écriture |
name-description |
La chaîne de description du pool | Lecture/écriture |
master |
Identifiant/référence d’objet unique de l’ hôte désigné comme maître du pool | Lecture seule |
default-SR |
Identifiant/référence d’objet unique de la SR par défaut pour le pool | Lecture/écriture |
crash-dump-SR |
Référence identifiant/objet unique de la SR où les vidages de plantage pour les membres du pool sont enregistrés | Lecture/écriture |
metadata-vdis |
Tous les VDI de métadonnées connues pour le pool | Lecture seule |
suspend-image-SR |
Identifiant/référence d’objet unique de la SR où les machines virtuelles suspendues sur les membres du pool sont enregistrées | Lecture/écriture |
other-config |
Une liste de paires clé/valeur qui spécifient des paramètres de configuration supplémentaires pour le pool | Paramètre de mappage en lecture/écriture |
supported-sr-types |
Types SR que ce pool peut utiliser | Lecture seule |
ha-enabled |
True si HA est activée pour le pool, false sinon | Lecture seule |
ha-configuration |
Réservé pour une utilisation future. | Lecture seule |
ha-statefiles |
Répertorie les UUID des VDI utilisés par HA pour déterminer l’intégrité du stockage | Lecture seule |
ha-host-failures-to-tolerate |
Nombre d’échecs d’hôte à tolérer avant d’envoyer une alerte système | Lecture/écriture |
ha-plan-exists-for |
Le nombre d’échecs d’hôtes qui peuvent réellement être gérés, selon les calculs de l’algorithme HA | Lecture seule |
ha-allow-overcommit |
True si le pool est autorisé à être surengagé, False sinon | Lecture/écriture |
ha-overcommitted |
True si le pool est surengagé | Lecture seule |
blobs |
Magasin de données binaires | Lecture seule |
live-patching-disabled |
Définissez la valeur False pour activer l’application de correctifs en direct. Définissez la valeur True pour désactiver l’application de correctifs en direct. | Lecture/écriture |
igmp-snooping-enabled |
Définissez la valeur True pour activer le snooping IGMP. Définissez la valeur False pour désactiver l’espionnage IGMP. | Lecture/écriture |
pool-apply-edition
pool-apply-edition edition = edition [uuid = uuid] [license-server-address = address] [license-server-port = port]
Appliquez une édition dans la piscine.
pool-certificate-install
pool-certificate-install filename = nom_fichier
Installez un certificat SSL à l’échelle du pool.
pool-certificate-list
liste de certificats de pool
Répertorier tous les certificats SSL installés.
pool-certificate-sync
pool-certificate-sync
Synchroniser les certificats SSL et les listes de révocation de certificats du maître aux esclaves.
pool-certificate-uninstall
pool-certificate-uninstall name = name
Désinstallez un certificat SSL.
pool-crl-install
pool-crl-install filename = nom_fichier
Installez une liste de révocation de certificats SSL, à l’échelle du pool.
pool-crl-list
pool-crl-list
Répertorier toutes les listes de révocation de certificats SSL installées.
pool-crl-uninstall
pool-crl-uninstall name = name
Désinstallez une liste de révocation de certificats SSL.
pool-deconfigure-wlb
pool-deconfigure-wlb
Supprimez définitivement la configuration pour l’équilibrage de la charge de travail.
pool-designate-new-master
pool-designate-new-master host-uuid = uuid_of_new_master
Demandez à l’ hôte membre spécifié de devenir maître d’un pool existant. Cette commande effectue un transfert ordonné du rôle d’hôte maître à un autre hôte du pool de ressources. Cette commande ne fonctionne que lorsque le maître actuel est en ligne. Il ne remplace pas les commandes du mode d’urgence énumérées ci-dessous.
pool-disable-external-auth
pool-disable-external-auth [uuid = uuid] [config = config]
Désactive l’authentification externe dans tous les hôtes d’un pool.
pool-disable-local-storage-caching
pool-disable-local-stockage-cache uuuid = uuid
Désactivez la mise en cache du stockage local dans le pool.
pool-disable-redo-log
pool-disable-redo-log
Désactivez le fichier de journalisation s’il est utilisé, sauf si HA est activé.
pool-disable-ssl-legacy
pool-disable-ssl-legacy [uuid = uuid]
Définissez ssl-legacy sur False sur chaque hôte.
pool-dump-database
pool-dump-database file-name = filename_to_dump_database_into_( on_client)
Téléchargez une copie de la base de données entière du pool et videz-la dans un fichier sur le client.
pool-enable-external-auth
pool-enable-external-auth auth-type = auth_type service-name = nom_service [uuid = uuid] [config : = config]
Active l’authentification externe dans tous les hôtes d’un pool. Notez que certaines valeurs de type auth-nécessitent une configuration particulière : valeurs.
pool-enable-local-storage-caching
pool-enable-local-storage-caching uuuid = uuid
Activez la mise en cache du stockage local dans le pool.
pool-enable-redo-log
pool-ensable-redo-log sr-uuid = sr_uuid
Activez le journalisation sur le SR donné s’il est utilisé, sauf si HA est activé.
pool-enable-ssl-legacy
pool-enable-ssl-legacy [uuid = uuid]
Définissez ssl-legacy sur True sur chaque hôte.
pool-eject
pool-eject host-uuid = uuid_of_host_to_eject
Demandez à l’ hôte spécifié de quitter un pool existant.
pool-emergency-reset-master
pool-emergency-reset-master master-address = address_of_pool_master
Demandez à un hôte membre esclave de réinitialiser son adresse maître à la nouvelle valeur et de tenter de se connecter à elle. N’exécutez pas cette commande sur les hôtes maîtres.
pool-emergency-transition-to-master
pool-urgency-transition-master
Demandez à un hôte membre de devenir le maître de pool. L’ hôte accepte cette commande uniquement après la transition de l’hôte vers le mode d’urgence. Le mode d’urgence signifie qu’il est membre d’un pool dont le maître a disparu du réseau et ne peut pas être contacté après un certain nombre de tentatives.
Si le mot de passe de l’hôte a été modifié depuis que l’hôte a rejoint le pool, cette commande peut provoquer la réinitialisation du mot de passe de l’hôte. Pour plus d’informations, voir (Commandes utilisateur).
pool-ha-enable
pool-ha-enable heartbeat-sr-uuids = uuid_of_heartbeat_sr
Activez la haute disponibilité sur le pool de ressources, en utilisant l’UUID SR spécifié comme référentiel de pulsations de stockage central.
pool-ha-disable
pool-ha-disable
Désactive la fonctionnalité haute disponibilité sur le pool de ressources.
pool-ha-compute-hypothetical-max-host-failures-to-tolerate
Calculer le nombre maximal d’échecs d’hôte à tolérer dans la configuration actuelle du pool.
pool-ha-compute-max-host-failures-to-tolerate
pool-ha-compute-hypothetical-max-host-failures-to-tolerate [vm-uuid = vm_uuid] [restart-priority = restart_priority]
Calculez le nombre maximal de défaillances d’hôte à tolérer avec les machines virtuelles protégées proposées.
pool-initialize-wlb
pool-initialize-wlb wlb_url = url wlb_username = wlb_username wlb_password = wlb_password xenserver_username = username xenserver_password = username xenserver_password = password
Initialisez l’équilibrage de la charge de travail pour le pool actuel avec le serveur WLB cible.
pool-join
pool-join master-address = adresse master-username = nom d'utilisateur master-password = mot de passe
Demandez à votre hôte de rejoindre un pool existant.
pool-management-reconfigure
pool-management-reconfigure [network-uuid = network-uuid]
Reconfigure l’interface de gestion de tous les hôtes du pool pour utiliser l’interface réseau spécifiée, qui est l’interface utilisée pour se connecter à la . La commande réécrit la clé MANAGEMENT_INTERFACE/etc/xensource-inventory
pour tous les hôtes du pool.
Si le nom de périphérique d’une interface (qui doit avoir une adresse IP) est spécifié, l’hôte maître se reconnecte immédiatement. Cette commande fonctionne à la fois en mode normal et en mode d’urgence.
À partir de l’UUID réseau spécifié, l’UUID de l’objet PIF est identifié et mappé à l’ hôte, ce qui détermine l’adresse IP à relier à lui-même. Il ne doit pas être en mode d’urgence lorsque cette commande est exécutée.
Avertissement :
Soyez prudent lorsque vous utilisez cette commande CLI hors hôte et assurez-vous que vous disposez d’une connectivité réseau sur la nouvelle interface. Permet
xe pif-reconfigure
d’en configurer un en premier. Sinon, les commandes CLI suivantes n’atteignent pas l’ hôte.
pool-recover-slaves
esclaves de récupération de la piscine
Demandez au maître de pool d’essayer de réinitialiser l’adresse principale de tous les membres en cours d’exécution en mode d’urgence. Cette commande est généralement utilisée après avoirpool-emergency-transition-to-master
été utilisée pour définir l’un des membres comme nouveau maître.
pool-restore-database
pool-restore-database file-name = filename_to_restore_from_on_client [dry-run = true | false]
Chargez une sauvegarde de base de données (créée avecpool-dump-database
) dans un pool. À la réception du téléchargement, le maître redémarre avec la nouvelle base de données.
Il existe également une option d’ exécution à sec , qui vous permet de vérifier que la base de données du pool peut être restaurée sans effectuer l’opération. Par défaut,dry-run
est défini sur false.
pool-retrieve-wlb-configuration
pool-retrieve-wlb-configuration
Récupère les critères d’optimisation du pool à partir du serveur d’équilibrage de la charge de travail.
pool-retrieve-wlb-diagnostics
pool-retrieve-wlb-diagnostics [nomfichier = nom_fichier]
Récupère les diagnostics du serveur d’équilibrage de la charge de travail.
pool-retrieve-wlb-recommendations
pool-retrieve-wlb-recommendations
Récupère les recommandations de migration de la machine virtuelle pour le pool à partir du serveur d’équilibrage de la charge de travail.
pool-retrieve-wlb-report
rapport pool-retrieve-wlb-report = rapport [nom_fichier = nom_fichier]
Récupère les rapports du serveur d’équilibrage de la charge de travail.
pool-send-test-post
pool-send-test-post dest-host = destination_host dest-port = destination_port body = post_body
Envoyez le corps donné à l’hôte et au port donnés, en utilisant HTTPS, et imprimez la réponse. Ceci est utilisé pour le débogage de la couche SSL.
pool-send-wlb-configuration
pool-send-wlb-configuration [config : = config]
Définit les critères d’optimisation du pool pour le serveur d’équilibrage de la charge de travail.
pool-sync-database
pool-sync-database
Forcer la base de données du pool à être synchronisée sur tous les hôtes du pool de ressources. Cette commande n’est pas nécessaire en fonctionnement normal puisque la base de données est régulièrement répliquée automatiquement. Cependant, la commande peut être utile pour s’assurer que les modifications sont rapidement répliquées après avoir effectué un ensemble important d’opérations CLI.
Définir la piscineigmp-snooping
pool-param-set [uuid = pool-uuid] [igmp-snooping-enabled = true | false]
Active ou désactive le snooping IGMP sur un pool.
Commandes PVS Accelerator
Commandes pour travailler avec l’accélérateur PVS.
pvs-cache-storage-create
pvs-cache-stockage-create sr-uuid = sr_uuid pvs-site-uid = pvs_site_uuid size = taille
Configurez un cache PVS sur un SR donné pour un hôte donné.
pvs-cache-storage-destroy
pvs-cache-stockage-destroy uuid = uuid
Supprimez un cache PVS.
pvs-proxy-create
pvs-proxy-create pvs-site-uuid = pvs_site_uuid vif-uuid = vif_uuid
Configurez un VM/VIF pour utiliser un proxy PVS.
pvs-proxy-destroy
pvs-proxy-destroy uuid = uuid
Supprimez (ou éteignez) un proxy PVS pour cette VIF/VM.
pvs-server-forget
pvs-server-forget uuuid = uuid
Oubliez un serveur PVS.
pvs-server-introduce
pvs-server-introduce adresses = adresses premier-port = first_port last-port = last_port pvs-site-uuid = pvs_site_uuid
Introduire un nouveau serveur PVS.
pvs-site-forget
pvs-site-forget uuuid = uuid
Oubliez un site PVS.
pvs-site-introduce
pvs-site-introduce nom-label = name_label [nom-description = nom_description] [pvs-uuid = pvs_uuid]
Introduire un nouveau site PVS.
Commandes Storage Manager
Commandes de contrôle des plugins Storage Manager.
Les objets du gestionnaire de stockage peuvent être répertoriés à l’aide de la commande de liste d’objets standard (xe sm-list
). Les paramètres peuvent être manipulés avec les commandes de paramètres standard. Pour plus d’informations, voir [Comman#low-level-parameter-commands()des de paramètres de bas niveau]
Paramètres SM
Les SMS ont les paramètres suivants :
Nom du paramètre | Description | Tapez |
---|---|---|
uuid |
La référence unique identifiant/objet pour le plugin SM | Lecture seule |
name-label |
Le nom du plugin SM | Lecture seule |
name-description |
La chaîne de description du plugin SM | Lecture seule |
type |
Le type SR auquel ce plugin se connecte | Lecture seule |
vendor |
Nom du fournisseur qui a créé ce plugin | Lecture seule |
copyright |
Déclaration de copyright pour ce plugin SM | Lecture seule |
required-api-version |
Version minimale de l’API SM requise sur l’ hôte | Lecture seule |
configuration |
Noms et descriptions des clés de configuration de périphérique | Lecture seule |
capabilities |
Capacités du plugin SM | Lecture seule |
driver-filename |
Nom de fichier du pilote SR. | Lecture seule |
Commandes instantanés
Commandes pour travailler avec des instantanés.
snapshot-clone
snapshot-clone new-name-label = name_label [uuid = uuid] [new-nom-description = description]
Créez un nouveau modèle en clonant un instantané existant, à l’aide d’une opération de clone de disque rapide au niveau du stockage, le cas échéant.
snapshot-copy
snapshot-copy new-name-label = name_label [uuid = uuid] [new-name-description = name_description] [sr-uuid = sr_uuid]
Créez un nouveau modèle en copiant une machine virtuelle existante, mais sans utiliser l’opération de clone de disque rapide au niveau du stockage (même si elle est disponible). Les images disque de la machine virtuelle copiée sont garanties comme des « images complètes » - c’est-à-dire ne faisant pas partie d’une chaîne CoW.
snapshot-destroy
snapshot-destroy [uuid = uuid] [snapshot-uuid = snapshot_uuid]
Détruisez un instantané. Le stockage associé au snapshot reste intact. Pour supprimer également le stockage, utilisez snapshot-uninstall.
snapshot-disk-list
liste de disques instantanés [uuid = uuid] [snapshot-uuid = snapshot_uuid] [vbd-params = vbd_params] [vdi-params = vdi_params]
Répertorier les disques sur la ou les machines virtuelles sélectionnées.
snapshot-export-to-template
snapshot-export-to-template filename = nom_fichier snapshot-uuid = snapshot_uuid [preserve-power-state = true | false]
Exporter un instantané vers le nom de fichier.
snapshot-reset-powerstate
snapshot-reset-powerstate [uuid = uuid] [snapshot-uuid = snapshot_uuid] [— force]
Forcer l’état de la machine virtuelle à arrêter uniquement dans la base de données de la pile d’outils de gestion. Cette commande permet de récupérer un instantané marqué comme « suspendu ». C’est une opération potentiellement dangereuse : vous devez vous assurer que vous n’avez plus besoin de l’image mémoire (c’est-à-dire que vous ne pourrez plus reprendre votre instantané).
snapshot-revert
snapshot-revert [uuid = uuid] [snapshot-uuid = snapshot_uuid]
Rétablir une machine virtuelle existante à un état précédemment pointé ou instantané.
snapshot-uninstall
snapshot-uninstall [uuid = uuid] [snapshot-uuid = snapshot_uuid] [— force]
Désinstallez un instantané. Cette opération détruira les VDI marqués RW et connectés à ce snapshot uniquement. Pour simplement détruire l’enregistrement de la machine virtuelle, utilisez snapshot-destroy.
Commandes SR
Commandes pour contrôler les SR (référentiels de stockage).
Les objets SR peuvent être répertoriés avec la commande de listage d’objets standard (xe sr-list
) et les paramètres manipulés avec les commandes de paramètres standard. Pour plus d’informations, voir [Comman#low-level-parameter-commands()des de paramètres de bas niveau]
Paramètres SR
Les SR ont les paramètres suivants :
Nom du paramètre | Description | Tapez |
---|---|---|
uuid |
Identifiant/référence d’objet unique pour le SR | Lecture seule |
name-label |
Le nom de la SR | Lecture/écriture |
name-description |
La chaîne de description du SR | Lecture/écriture |
allowed-operations |
Liste des opérations autorisées sur la SR dans cet état | Paramètre de jeu en lecture seule |
current-operations |
Liste des opérations en cours dans le cadre de ce RS | Paramètre de jeu en lecture seule |
VDIs |
Identifiant/référence d’objet unique pour les disques virtuels de cette SR | Paramètre de jeu en lecture seule |
PBDs |
Identifiant/référence d’objet unique pour les PBD attachés à ce SR | Paramètre de jeu en lecture seule |
physical-utilisation |
Espace physique actuellement utilisé sur ce SR, en octets. Pour les formats de disque à provisionnement fin, l’utilisation physique peut être inférieure à l’allocation virtuelle | Lecture seule |
physical-size |
Taille physique totale de la SR, en octets | Lecture seule |
type |
Type de SR, utilisé pour spécifier le pilote principal SR à utiliser | Lecture seule |
introduced-by |
Le drtask (le cas échéant) qui a introduit le SR | Lecture seule |
content-type |
Type de contenu du SR. Utilisé pour distinguer les bibliothèques ISO des autres SR. Pour les référentiels de stockage qui stockent une bibliothèque d’ISO, le type de contenu doit être défini sur iso. Dans d’autres cas, il est recommandé de définir ce paramètre soit à vide, soit à l’utilisateur de chaîne. | Lecture seule |
shared |
True si cette SR peut être partagée entre plusieurs hôtes ; False sinon | Lecture/écriture |
other-config |
Liste des paires clé/valeur qui spécifient des paramètres de configuration supplémentaires pour le SR | Paramètre de mappage en lecture/écriture |
host |
Nom d’hôte du référentiel de stockage | Lecture seule |
virtual-allocation |
Somme des valeurs virtuelles de tous les VDI dans ce référentiel de stockage (en octets) | Lecture seule |
sm-config |
Données dépendantes de SM | Paramètre de mappage en lecture seule |
blobs |
Magasin de données binaires | Lecture seule |
sr-create
sr-create name-label = name physical-size = size type = type content-type = content_type device-config : config_name = value [host-uuid = host_uuid] [shared = true | false]
Crée un SR sur le disque, l’introduit dans la base de données et crée un PBD attachant le SR à l’ hôte. Si la valeurshared
est définie surtrue
, un PBD est créé pour chaque hôte du pool. Si n’shared
est pas spécifié ou défini surfalse
, un PBD est créé uniquement pour l’ hôte spécifié avechost-uuid
.
Lesdevice-config
paramètres exacts diffèrent en fonction de l’appareiltype
. Pour plus de détails sur ces paramètres sur les différents back-ends de stockage, reportez-vous à la section Stockage.
sr-data-source-forget
sr-data-source-forget data-source = source_data
Arrêtez d’enregistrer la source de données spécifiée pour une SR et oubliez toutes les données enregistrées.
sr-data-source-list
sr-data-source-list »
Répertorier les sources de données qui peuvent être enregistrées pour une SR.
sr-data-source-query
sr-data-source-query data-source = source_data
Interrogez la dernière valeur lue à partir d’une source de données SR.
sr-data-source-record
sr-data-source-record data-source = source_data
Enregistrez la source de données spécifiée pour une SR.
sr-destroy
sr-destroy uuid = sr_uuid
Détruit le SR spécifié sur l’ hôte.
sr-enable-database-replication
sr-enable-database-replication uuuid = sr_uuid
Active la réplication de base de données XAPI vers le SR spécifié (partagé). Par exemple :
xe sr-enable-database-replication uuuid = sr-uuid
sr-disable-database-replication
sr-disable-database-replication uuuid = sr_uuid
Désactive la réplication de base de données XAPI vers le SR spécifié. Par exemple :
xe sr-enable-database-replication uuuid = sr-uuid
sr-forget
sr-forget uuid = sr_uuid
L’agent XAPI oublie un SR spécifié sur l’ hôte. Lorsque l’agent XAPI oublie un SR, le SR est détaché et vous ne pouvez pas accéder aux VDI dessus, mais il reste intact sur le support source (les données ne sont pas perdues).
sr-introduce
sr-introduce name-label = name physical-size = physical_size type = type content-type = content_type uuid = sr_uuid
Place juste un enregistrement SR dans la base de données. Utilisezdevice-config
pour spécifier des paramètres supplémentaires sous forme de téhdevice-config:parameter_key=parameter_value
, par exemple :
xe sr-introduce device-config : device = / dev/sdb1
Note :
Cette commande n’est jamais utilisée en fonctionnement normal. Cette opération avancée peut être utile lorsqu’une SR doit être reconfigurée comme étant partagée après sa création ou pour aider à récupérer à partir de différents scénarios d’échec.
sr-probe
sr-sonde type = type [host-uuid = host_uuid] [device-config : config_name = value]
Effectue une analyse spécifique au backend, à l’aide desdevice-config
clés fournies. Si ladevice-config
est terminée pour le back-end SR, cette commande renvoie une liste des SR présents sur le périphérique, le cas échéant. Si lesdevice-config
paramètres ne sont que partiels, une analyse spécifique au back-end est effectuée, renvoyant les résultats qui vous guident dans l’amélioration desdevice-config
paramètres restants. Les résultats de l’analyse sont renvoyés sous forme de XML spécifique au backend, imprimés sur l’interface de ligne de commande.
Lesdevice-config
paramètres exacts diffèrent en fonction de l’appareiltype
. Pour plus de détails sur ces paramètres sur les différents back-ends de stockage, reportez-vous à la section Stockage.
sr-probe-ext
sr-probe-ext type = type [host-uuid = host_uuid] [device-config : = config] [sm-config : -sm_config]
Effectuez une sonde de stockage. Les paramètres de device-config peuvent être spécifiés par exemple device-config : devs = / dev/sdb1. Contrairement à sr-sonde, cette commande renvoie les résultats dans le même format lisible par l’homme pour chaque type SR.
sr-scan
sr-scan uuuid = sr_uuid
Forcer une analyse SR en synchronisant la base de données XAPI avec les VDI présents dans le substrat de stockage sous-jacent.
sr-update
sr-update uuid = uuid
Actualisez les champs de l’objet SR dans la base de données.
lvhd-enable-thin-provisioning
lvhd-enable-thin-provisioning sr-uuid = sr_uuid initial-allocation = initial_allocation allocation-quantum = allocation_quantum
Activer le provisionnement fin sur un SR LVHD.
Commandes d’objet
Commandes pour travailler avec des sujets.
session-subject-identifier-list
session-subject-identifier-list
Renvoie une liste de tous les identifiants de sujet utilisateur de toutes les sessions existantes authentifiées en externe.
session-subject-identifier-logout
session-subject-identifier-logout subject-identifier = subject_identifier
Déconnectez toutes les sessions authentifiées en externe associées à un identifiant de sujet utilisateur.
session-subject-identifier-logout-all
session-subject-identifier-logout-all
Déconnectez toutes les sessions authentifiées en externe.
subject-add
subject-add subject-name = nom_sujet
Ajoutez un sujet à la liste des sujets pouvant accéder au pool.
subject-remove
subject-remove subject-uuid = subject_uuid
Supprimez un sujet de la liste des sujets pouvant accéder au pool.
subject-role-add
subject-role-add uuid = uuid [nom_rôle = nom_rôle] [rôle_uuid = rôle_uuid]
Ajouter un rôle à un sujet.
subject-role-remove
subject-role-remove uuid = uuid [nom_rôle = nom_rôle] [rôle_uuid = rôle_uuid]
Supprimez un rôle d’un sujet.
secret-create
Secreté-créer valeur = valeur
Créez un secret.
secret-destroy
secrète-détruire uuid = uuid
Détruisez un secret.
Commandes de tâche
Commandes pour travailler avec des tâches asynchrones longues. Ces commandes sont des tâches telles que le démarrage, l’arrêt et la suspension d’une machine virtuelle. Les tâches sont généralement composées d’un ensemble d’autres tâches subordonnées atomiques qui accomplissent ensemble l’opération demandée.
Les objets de tâche peuvent être répertoriés avec la commande de listage d’objets standard (xe task-list
) et les paramètres manipulés avec les commandes de paramètres standard. Pour plus d’informations, voir [Comman#low-level-parameter-commands()des de paramètres de bas niveau]
Paramètres de la tâche
Les tâches ont les paramètres suivants :
Nom du paramètre | Description | Tapez |
---|---|---|
uuid |
Identifiant/référence d’objet unique pour la tâche | Lecture seule |
name-label |
Le nom de la tâche | Lecture seule |
name-description |
La chaîne de description de la tâche | Lecture seule |
resident-on |
Identifiant/référence d’objet unique de l’hôte sur lequel la tâche est exécutée | Lecture seule |
status |
État de la tâche | Lecture seule |
progress |
Si la tâche est toujours en attente, ce champ contient le pourcentage estimé achevé, compris entre 0 et 1. Si la tâche est terminée, avec succès ou sans succès, la valeur est 1. | Lecture seule |
type |
Si la tâche s’est terminée avec succès, ce paramètre contient le type du résultat codé. Le type est le nom de la classe dont la référence est dans le champ de résultat. Sinon, la valeur de ce paramètre n’est pas définie | Lecture seule |
result |
Si la tâche s’est terminée avec succès, ce champ contient la valeur de résultat, soit Void ou une référence d’objet ; sinon, la valeur de ce paramètre n’est pas définie | Lecture seule |
error_info |
Si la tâche a échoué, ce paramètre contient l’ensemble des chaînes d’erreur associées. Sinon, la valeur de ce paramètre n’est pas définie | Lecture seule |
allowed_operations |
Liste des opérations autorisées dans cet état | Lecture seule |
created |
Heure de création de la tâche | Lecture seule |
finished |
Tâche temporelle terminée (c’est-à-dire réussie ou échouée). Si l’état de la tâche est en attente, la valeur de ce champ n’a pas de sens | Lecture seule |
subtask_of |
Contient l’UUID des tâches que cette tâche est une sous-tâche de | Lecture seule |
subtasks |
Contient les UUID de toutes les sous-tâches de cette tâche | Lecture seule |
task-cancel
task-cancel [uuid = task_uuid]
Diriger la tâche spécifiée d’annuler et de retourner.
Commandes de modèle
Commandes pour travailler avec des modèles de machines virtuelles.
Les modèles sont essentiellement des machines virtuelles dont leis-a-template
paramètre est défini surtrue
. Un modèle est une « image or » qui contient tous les différents paramètres de configuration pour instancier une machine virtuelle spécifique. est livré avec un ensemble de modèles de base, qui sont des machines virtuelles « brutes » génériques qui peuvent démarrer un CD d’installation du fournisseur d’exploitation (par exemple : RHEL, CentOS, SLES, Windows). Vous pouvez créer des machines virtuelles, les configurer dans des formulaires standard pour vos besoins particuliers et en enregistrer une copie en tant que modèles pour une utilisation ultérieure dans le déploiement de machines virtuelles.
Les objets de modèle peuvent être répertoriés avec la commande de listage d’objets standard (xe template-list
) et les paramètres manipulés avec les commandes de paramètres standard. Pour plus d’informations, voir [Comman#low-level-parameter-commands()des de paramètres de bas niveau]
Note :
Les modèles ne peuvent pas être convertis directement en machines virtuelles en définissant le
is-a-template
paramètre surfalse
. La définition duis-a-template
paramètre sur n’false
est pas prise en charge et entraîne une machine virtuelle qui ne peut pas être démarrée.
Paramètres de modèle de machine virtuelle
Les modèles ont les paramètres suivants :
-
uuid
( lecture seule) la référence identifiant/objet unique pour le modèle -
name-label
( lecture/écriture) le nom du modèle -
name-description
( lecture/écriture) la chaîne de description du modèle - Chaîne
user-version
(lecture/écriture) pour les créateurs de machines virtuelles et de modèles pour placer les informations de version -
is-a-template
( lecture/écriture) true si cette machine virtuelle est un modèle. Les machines virtuelles de modèle ne peuvent jamais être démarrées, elles sont utilisées uniquement pour le clonage d’autres machines virtuelles. Une fois cette valeur définie sur true, elle ne peut pas être réinitialisée à false. Les machines virtuelles de modèle ne peuvent pas être converties en machines virtuelles à l’aide de ce paramètre. -
is-control-domain
(lecture seule) true s’il s’agit d’un domaine de contrôle (domaine 0 ou domaine pilote) -
power-state
(lecture seule) état courant de l’alimentation. La valeur est toujours arrêtée pour un modèle -
memory-dynamic-max
(lecture seule) mémoire maximale dynamique en octets.Actuellement inutilisée, mais si elle est modifiée, la contrainte suivante doit être respectée :memory_static_max>=memory_dynamic_max>=<!--NeedCopy-->
````memory_dynamic_min>=memory_static_min<!--NeedCopy-->
.
-
memory-dynamic-min
(lecture/écriture) mémoire minimale dynamique en octets. Actuellement inutilisé, mais si changé, les mêmes contraintesmemory-dynamic-max
doivent être respectées. -
memory-static-max
(lecture/écriture) fixe statiquement (absolue) la mémoire maximale en octets. Ce champ est la valeur principale utilisée pour déterminer la quantité de mémoire affectée à une machine virtuelle. -
memory-static-min
(lecture/écriture) fixe statiquement la mémoire minimale (absolue) en octets. Ce champ représente la mémoire minimale absolue etmemory-static-min
doit être inférieur àmemory-static-max
. Cette valeur n’est pas utilisée en fonctionnement normal, mais la contrainte précédente doit être respectée. -
suspend-VDI-uuid
(lecture seule) le VDI sur lequel une image suspendue est stockée (n’a aucune signification pour un modèle) -
VCPUs-params
(paramètre de carte en lecture/écriture) pour la stratégie vCPU sélectionnée.Vous pouvez régler l’épinglage d’un vCPU avec :
xe template-param-set uuuid = < template_uuid > VCPUS-params : mask = 1,2,3
Une machine virtuelle créée à partir de ce modèle s’exécute uniquement sur des processeurs physiques 1, 2 et 3.
Vous pouvez également régler la priorité vCPU (planification xen) avec les paramètres de plafond et de poids. Par exemple :
xe template-param-set uuuid = < template_uuid > VCPUS-params : weight = 512 xe template-param-set uuuid = < template_uuid > VCPUS-params : cap = 100
Une machine virtuelle basée sur ce modèle avec un poids de 512 obtient deux fois plus de CPU qu’un domaine avec un poids de 256 sur un hôte concurrent. Les pondérations légales varient de 1 à 65535 et la valeur par défaut est 256.
Le plafond fixe éventuellement la quantité maximale de CPU qu’une machine virtuelle basée sur ce modèle peut consommer, même si l’ hôte a des cycles CPU inactifs. Le plafond est exprimé en pourcentage d’un CPU physique : 100 est un CPU physique, 50 est un demi-CPU, 400 est 4 CPU, etc. La valeur par défaut, 0, signifie qu’il n’y a pas de capuchon supérieur.
-
VCPUs-max
( lecture/écriture) nombre maximal de vCPU - Numéro de démarrage
VCPUs-at-startup
(lecture/écriture) des vCPU -
actions-after-crash
( lecture/écriture) à prendre lorsqu’une machine virtuelle basée sur ce modèle se bloque -
console-uuids
( paramètre de jeu en lecture seule) périphériques de console virtuelle -
platform
( paramètre de carte en lecture/écriture) configuration spécifique à la plate-formePour désactiver l’émulation d’un port parallèle pour les invités HVM (par exemple, les invités Windows) :
xe vm-param-set uuuid = < vm_uuid > plateforme : parallel = none
Pour désactiver l’émulation d’un port série pour les invités HVM :
xe vm-param-set uuuid = < vm_uuid > plateforme : hvm_serial = none
Pour désactiver l’émulation d’un contrôleur USB et d’une tablette USB pour les invités HVM :
xe vm-param-set uuuid = < vm_uuid > plateforme : usb = false xe vm-param-set uuuid = < vm_uuid > plateforme : usb_tablet = false
Pour utiliser qemu-upstream pour le passage USB :
xe vm-param-set uuuid = < vm_uuid > platform : device-model = qemu-upstream-compat
-
allowed-operations
( lecture seule paramètre set) liste des opérations autorisées dans cet état -
current-operations
( paramètre de jeu en lecture seule) liste des opérations en cours sur ce modèle -
allowed-VBD-devices
( paramètre de jeu en lecture seule) liste des identificateurs VBD disponibles pour l’utilisation, représentés par des entiers de la plage 0 à 15. Cette liste est informative seulement, et d’autres périphériques peuvent être utilisés (mais peuvent ne pas fonctionner). -
allowed-VIF-devices
( paramètre de jeu en lecture seule) liste des identificateurs VIF disponibles à l’emploi, représentés par des entiers de la plage 0 à 15. Cette liste est informative seulement, et d’autres périphériques peuvent être utilisés (mais peuvent ne pas fonctionner). -
HVM-boot-policy
( lecture/écriture) la stratégie de démarrage pour les invités HVM. Commande BIOS ou chaîne vide. -
HVM-boot-params
( paramètre de carte en lecture/écriture), la clé de commande contrôle l’ordre de démarrage invité HVM, représenté sous la forme d’une chaîne où chaque caractère est une méthode de démarrage : d pour le CD/DVD, c pour le disque racine et n pour le démarrage réseau PXE. La valeur par défaut est dc. -
PV-kernel
( lecture/écriture) vers le noyau -
PV-ramdisk
( lecture/écriture) vers l’initrd -
PV-args
( lecture/écriture) chaîne d’arguments de ligne de commande du noyau -
PV-legacy-args
( lecture/écriture) chaîne d’arguments pour créer des machines virtuelles héritées basées sur ce modèle de démarrage -
PV-bootloader
( lecture/écriture) nom ou chemin d’accès au chargeur de démarrage -
PV-bootloader-args
( lecture/écriture) chaîne d’arguments divers pour le chargeur d’amorçage -
last-boot-CPU-flags
( lecture seule) décrit les indicateurs CPU sur lesquels une machine virtuelle basée sur ce modèle a été démarrée pour la dernière fois ; non renseignée pour un modèle -
resident-on
( lecture seule) l’ hôte sur lequel une machine virtuelle basée sur ce modèle est résidente. Apparaît commenot in database
pour un modèle -
affinity
( lecture/écriture) l’ hôte sur lequel une machine virtuelle basée sur ce modèle a la préférence pour s’exécuter. Utilisé par laxe vm-start
commande pour décider où exécuter la machine virtuelle -
other-config
( paramètre de carte en lecture/écriture) liste de paires clé/valeur qui spécifient des paramètres de configuration supplémentaires pour le modèle -
start-time
( lecture seule) horodatage de la date et de l’heure auxquelles les mesures d’une machine virtuelle basée sur ce modèle ont été lues, sous la formeyyyymmddThh:mm:ss z
, où z est l’indicateur de fuseau horaire militaire à une lettre, par exemple Z pour UTC (GMT). Définir sur1 Jan 1970 Z
(début de l’époque UNIX/POSIX) pour un modèle -
install-time
( lecture seule) horodatage de la date et de l’heure auxquelles les mesures d’une machine virtuelle basée sur ce modèle ont été lues, sous la formeyyyymmddThh:mm:ss z
, où z est l’indicateur de fuseau horaire militaire à une lettre, par exemple Z pour UTC (GMT). Définir sur1 Jan 1970 Z
(début de l’époque UNIX/POSIX) pour un modèle -
memory-actual
( lecture seule) la mémoire réelle utilisée par une machine virtuelle basée sur ce modèle ; 0 pour un modèle -
VCPUs-number
( lecture seule) le nombre de processeurs virtuels affectés à une machine virtuelle basée sur ce modèle ; 0 pour un modèle -
VCPUs-Utilization
( paramètre de carte en lecture seule) liste des processeurs virtuels et leur poids en lecture seule paramètre de carte os-version la version du système d’exploitation pour une machine virtuelle basée sur ce modèle. Apparaît commenot in database
pour un modèle -
PV-drivers-version
( paramètre de carte en lecture seule) les versions des pilotes paravirtualisés pour une machine virtuelle basée sur ce modèle. Apparaît commenot in database
pour un modèle -
PV-drivers-detected
( lecture seule) pour la dernière version des pilotes paravirtualisés pour une machine virtuelle basée sur ce modèle. Apparaît commenot in database
pour un modèle -
memory
( paramètre de mappage en lecture seule) signalées par l’agent sur une machine virtuelle basée sur ce modèle. Apparaît commenot in database
pour un modèle -
disks
( paramètre de mappage en lecture seule) des mesures de disque signalées par l’agent sur une machine virtuelle basée sur ce modèle. Apparaît commenot in database
pour un modèle -
networks
( paramètre de carte en lecture seule) des mesures de réseau signalées par l’agent sur une machine virtuelle basée sur ce modèle. Apparaît commenot in database
pour un modèle -
other
( paramètre de mappage en lecture seule) autres mesures rapportées par l’agent sur une machine virtuelle basée sur ce modèle. Apparaît commenot in database
pour un modèle -
guest-metrics-last-updated
( lecture seule) horodatage lorsque l’agent in-guest a effectué la dernière écriture dans ces champs. Dans le formulaireyyyymmddThh:mm:ss z
, où z est l’indicateur de fuseau horaire militaire à une lettre, par exemple, Z pour UTC (GMT) -
actions-after-shutdown
( lecture/écriture) à prendre après l’arrêt de la machine virtuelle -
actions-after-reboot
( lecture/écriture) à effectuer après le redémarrage de la machine virtuelle -
possible-hosts
( lecture seule) liste des hôtes susceptibles d’héberger la machine virtuelle -
HVM-shadow-multiplier
( lecture/écriture) appliqué à la quantité d’ombre mise à la disposition de l’invité -
dom-id
( lecture seule) ID de domaine (si disponible, -1 sinon) -
recommendations
( lecture seule) Spécification XML des valeurs et plages recommandées pour les propriétés de cette machine virtuelle -
xenstore-data
( paramètre de carte en lecture/écriture) à insérer dans l’arborescence xenstore (/ local/domain/domid /vmdata) après la création de la machine virtuelle. -
is-a-snapshot
( lecture seule) True si ce modèle est un snapshot de machine virtuelle -
snapshot_of
( lecture seule) l’UUID de la machine virtuelle que ce modèle est un instantané de -
snapshots
( lecture seule) les UUID de tous les instantanés qui ont été pris de ce modèle -
snapshot_time
( lecture seule) l’horodatage de l’instantané de machine virtuelle le plus récent pris -
memory-target
( lecture seule) la quantité cible de mémoire définie pour ce modèle -
blocked-operations
( paramètre de carte en lecture/écriture) répertorie les opérations qui ne peuvent pas être effectuées sur ce modèle -
last-boot-record
( lecture seule) enregistrement des derniers paramètres de démarrage de ce modèle, au format XML -
ha-always-run
( lecture/écriture) True si une instance de ce modèle est toujours redémarrée sur un autre hôte en cas de défaillance de l’hôte sur lequel il réside. Ce paramètre est maintenant obsolète. Utilisez leha-restartpriority
paramètre à la place. -
ha-restart-priority
( lecture seule) redémarrage ou le meilleur effort de lecture/écriture blobs magasin de données binaires -
live
( lecture seule) ne concerne qu’une machine virtuelle en cours d’exécution.
template-export
template-export template-uuid = uuid_of_existing_template filename = filename_for_new_template
Exporte une copie d’un modèle spécifié vers un fichier portant le nouveau nom de fichier spécifié.
template-uninstall
template-uninstall template-uuid = template_uuid [— force]
Désinstallez un modèle personnalisé. Cette opération va détruire les VDI qui sont marqués comme « appartenant » par ce modèle.
Commandes de mise à jour
La section suivante contient les commandes de mise à jour de l’ hôte.
Les objets de mise à jour peuvent être répertoriés avec la commande de listage d’objets standard (xe update-list
) et les paramètres manipulés avec les commandes de paramètres standard. Pour plus d’informations, voir [Comman#low-level-parameter-commands()des de paramètres de bas niveau]
Paramètres de mise à jour
ont les paramètres suivants :
Nom du paramètre | Description | Tapez |
---|---|---|
uuid |
Identifiant/référence d’objet unique pour la mise à jour | Lecture seule |
host |
La liste des hôtes auxquels cette mise à jour est appliquée | Lecture seule |
host-uuid |
Identifiant unique pour l’ hôte à interroger | Lecture seule |
name-label |
Le nom de la mise à jour | Lecture seule |
name-description |
La chaîne de description de la mise à jour | Lecture seule |
applied |
Si la mise à jour a été appliquée ou non ; true ou false | Lecture seule |
installation-size |
Taille de la mise à jour en octets | Lecture seule |
after-apply-guidance |
Si la pile d’outils XAPI ou l’hôte nécessite un redémarrage | Lecture seule |
version |
La version de la mise à jour | Lecture seule |
update-upload
update-upload file-name = update_filename
Téléchargez un fichier de mise à jour spécifié sur l’ hôte. Cette commande prépare une mise à jour à appliquer. En cas de succès, l’UUID de la mise à jour téléchargée est imprimé. Si la mise à jour a déjà été téléchargée,UPDATE_ALREADY_EXISTS
une erreur est renvoyée à la place et le correctif n’est plus téléchargé.
update-precheck
update-precheck uuid = update_uuid host-uuid = host_uuid
Exécutez les prévérifications contenues dans la mise à jour spécifiée sur l’ hôte spécifié.
update-destroy
update-destroy uuid = update_file_uuid
Supprime un fichier de mise à jour qui n’a pas été appliqué du pool. Peut être utilisé pour supprimer un fichier de mise à jour qui ne peut pas être appliqué aux hôtes.
update-apply
update-apply host-uuid = host_uuid uuid = update_file_uuid
Appliquez le fichier de mise à jour spécifié.
update-pool-apply
update-pool-apply uuid = update_uuid
Appliquez la mise à jour spécifiée à tous les hôtes du pool.
update-introduce
update-introduce vdi-uuid = vdi_uuid
Introduire la mise à jour VDI.
update-pool-clean
update-pool-clean uuid = uuid
Supprime les fichiers de la mise à jour de tous les hôtes du pool.
Commandes utilisateur
user-password-change
user-password-change old = old_password new = new_password
Modifie le mot de passe de l’utilisateur connecté. L’ancien champ de mot de passe n’est pas coché car vous avez besoin du privilège de superviseur pour utiliser cette commande.
Commandes VBD
Commandes pour travailler avec les VBD (Virtual Block Devices).
Un VBD est un objet logiciel qui connecte une machine virtuelle au VDI, qui représente le contenu du disque virtuel. Le VBD a les attributs qui lient le VDI à la machine virtuelle (est-il amorçable, ses mesures de lecture/écriture, etc.). Le VDI contient les informations sur les attributs physiques du disque virtuel (quel type de SR, si le disque est partageable, si le support est en lecture/écriture ou en lecture seule, etc.).
Les objets VBD peuvent être répertoriés avec la commande de listage d’objets standard (xe vbd-list
) et les paramètres manipulés avec les commandes de paramètres standard. Pour plus d’informations, voir [Comman#low-level-parameter-commands()des de paramètres de bas niveau]
Paramètres VBD
Les VBD ont les paramètres suivants :
Nom du paramètre | Description | Tapez |
---|---|---|
uuid |
Identifiant/référence d’objet unique pour le VBD | Lecture seule |
vm-uuid |
Référence identifiant/objet unique pour la machine virtuelle que ce VBD est attaché à | Lecture seule |
vm-name-label |
Nom de la machine virtuelle que ce VBD est attaché à | Lecture seule |
vdi-uuid |
Identifiant/référence d’objet unique pour le VDI auquel VBD est mappé | Lecture seule |
vdi-name-label |
Nom du VDI que ce VBD est mappé à | Lecture seule |
empty |
Sitrue , ce VBD représente un lecteur vide |
Lecture seule |
device |
L’appareil vu par l’invité, par exemplehda
|
Lecture seule |
userdevice |
Numéro de périphérique spécifié par le paramètre de périphérique pendantvbd-create , par exemple, 0 pour hda, 1 pour hdb, etc |
Lecture/écriture |
bootable |
True si ce VBD est amorçable | Lecture/écriture |
mode |
Le mode avec lequel le VBD doit être installé | Lecture/écriture |
type |
Comment le VBD apparaît à la machine virtuelle, par exemple disque ou CD | Lecture/écriture |
currently-attached |
True si le VBD est attaché à cet hôte, false sinon | Lecture seule |
storage-lock |
True si un verrou au niveau du stockage a été acquis | Lecture seule |
status-code |
Code erreur/succès associé à la dernière opération d’attachement | Lecture seule |
status-detail |
Informations sur les erreurs/succès associées au statut de la dernière opération de connexion | Lecture seule |
qos_algorithm_type |
L’algorithme QoS à utiliser | Lecture/écriture |
qos_algorithm_params |
Paramètres de l’algorithme QoS choisi | Paramètre de mappage en lecture/écriture |
qos_supported_algorithms |
Algorithmes QoS pris en charge pour ce VBD | Paramètre de jeu en lecture seule |
io_read_kbs |
Taux de lecture moyen en kB par seconde pour ce VBD | Lecture seule |
io_write_kbs |
Taux d’écriture moyen en kB par seconde pour ce VBD | Lecture seule |
allowed-operations |
Liste des opérations autorisées dans cet état. Cette liste est purement consultative et l’état du serveur peut avoir changé au moment où ce champ est lu par un client. | Paramètre de jeu en lecture seule |
current-operations |
Lie chacune des tâches en cours d’exécution utilisant cet objet (par référence) à une énumération current_operation qui décrit la nature de la tâche. | Paramètre de jeu en lecture seule |
unpluggable |
True si ce VBD prend en charge le débranchement à chaud | Lecture/écriture |
attachable |
True si l’appareil peut être connecté | Lecture seule |
other-config |
Configuration supplémentaire | Paramètre de mappage en lecture/écriture |
vbd-create
vbd-create vm-uuid = uuid_of_the_vm device = device_value vdi-uuid = uuid_of_vdi_to_connect_to [bootable = true] [type = Disque | CD] [mode = RW | RO]
Créez un VBD sur une machine virtuelle.
Les valeurs autorisées pour ledevice
champ sont des entiers 0 à 15 et le nombre doit être unique pour chaque machine virtuelle. Les valeurs autorisées actuelles peuvent être vues dans leallowed-VBD-devices
paramètre sur la machine virtuelle spécifiée. Ceci est considéré commeuserdevice
dans lesvbd
paramètres.
Si l’type
estDisk
,vdi-uuid
est nécessaire. Le mode peut êtreRO
ouRW
pour un disque.
Si letype
estCD
,vdi-uuid
est facultatif. Si aucun VDI n’est spécifié, un VBD vide est créé pour le CD. Le mode doit êtreRO
pour un CD.
vbd-destroy
vbd-destroy uuid = uuid_of_vbd
Détruisez le VBD spécifié.
Si leother-config:owner
paramètre VBD est défini surtrue
, le VDI associé est également détruit.
vbd-eject
vbd-eject uuuid = uuid_of_vbd
Retirez le support du lecteur représenté par un VBD. Cette commande ne fonctionne que si le support est de type amovible (CD physique ou ISO). Sinon, un message d’erreurVBD_NOT_REMOVABLE_MEDIA
est retourné.
vbd-insert
vbd-insert uuid = uuid_of_vbd vdi-uuid = uuid_of_vdi_containing_media
Insérez un nouveau média dans le lecteur représenté par un VBD. Cette commande ne fonctionne que si le support est de type amovible (CD physique ou ISO). Sinon, un message d’erreurVBD_NOT_REMOVABLE_MEDIA
est retourné.
vbd-plug
vbd-plug uuid = uuid_of_vbd
Essayez d’attacher le VBD lorsque la machine virtuelle est en cours d’exécution.
vbd-unplug
vbd-unplug uuid = uuid_of_vbd
Tente de détacher le VBD de la machine virtuelle alors qu’il est en cours d’exécution.
Commandes VDI
Commandes pour travailler avec les VDIs (Virtual Disk Images).
Un VDI est un objet logiciel qui représente le contenu du disque virtuel vu par une machine virtuelle. Ceci est différent du VBD, qui est un objet qui relie une machine virtuelle au VDI. Le VDI contient les informations sur les attributs physiques du disque virtuel (quel type de SR, si le disque est partageable, si le support est en lecture/écriture ou en lecture seule, etc.). Le VBD possède les attributs qui lient le VDI à la machine virtuelle (est-il amorçable, ses mesures de lecture/écriture, etc.).
Les objets VDI peuvent être répertoriés avec la commande de listage d’objets standard (xe vdi-list
) et les paramètres manipulés avec les commandes de paramètres standard. Pour plus d’informations, voir [Comman#low-level-parameter-commands()des de paramètres de bas niveau]
Paramètres VDI
Les VDI ont les paramètres suivants :
Nom du paramètre | Description | Tapez |
---|---|---|
uuid |
Identifiant/référence d’objet unique pour le VDI | Lecture seule |
name-label |
Le nom du VDI | Lecture/écriture |
name-description |
La chaîne de description du VDI | Lecture/écriture |
allowed-operations |
Liste des opérations autorisées dans cet état | Paramètre de jeu en lecture seule |
current-operations |
Une liste des opérations en cours sur ce VDI | Paramètre de jeu en lecture seule |
sr-uuid |
SR dans lequel réside le VDI | Lecture seule |
vbd-uuids |
Une liste de VBD qui font référence à ce VDI | Paramètre de jeu en lecture seule |
crashdump-uuids |
Liste des vidages de crash qui font référence à ce VDI | Paramètre de jeu en lecture seule |
virtual-size |
Taille du disque telle que présentée à la machine virtuelle, en octets. Selon le type de back-end de stockage, la taille peut ne pas être respectée exactement | Lecture seule |
physical-utilisation |
Quantité d’espace physique que le VDI occupe sur le SR, en octets | Lecture seule |
type |
Type de VDI, par exemple, Système ou Utilisateur | Lecture seule |
sharable |
True si ce VDI peut être partagé | Lecture seule |
read-only |
True si ce VDI ne peut être installé qu’en lecture seule | Lecture seule |
storage-lock |
True si ce VDI est verrouillé au niveau du stockage | Lecture seule |
parent |
Références le VDI parent lorsque ce VDI fait partie d’une chaîne | Lecture seule |
missing |
True si l’opération d’analyse SR a signalé que ce VDI n’était pas présent | Lecture seule |
other-config |
Informations de configuration supplémentaires pour ce VDI | Paramètre de mappage en lecture/écriture |
sr-name-label |
Nom du référentiel de stockage contenant | Lecture seule |
location |
Informations de localisation | Lecture seule |
managed |
True si le VDI est géré | Lecture seule |
xenstore-data |
Données à insérer dans l’arborescence xenstore (/ local/domain/0/backend/ vbd /dom**ice-id/smdata) après l’attachement du VDI. Les back-ends SM définissent généralement ce champvdi_attach . |
Paramètre de mappage en lecture seule |
sm-config |
Données dépendantes de SM | Paramètre de mappage en lecture seule |
is-a-snapshot |
True si ce VDI est un instantané de stockage de machine virtuelle | Lecture seule |
snapshot_of |
L’UUID du stockage de ce VDI est un instantané de | Lecture seule |
snapshots |
Les UUID de tous les instantanés de ce VDI | Lecture seule |
snapshot_time |
Horodatage de l’opération de snapshot qui a créé ce VDI | Lecture seule |
metadata-of-pool |
Uuid du pool qui a créé cette métadonnées VDI | Lecture seule |
metadata-latest |
Indicateur indiquant si le VDI contient les dernières métadonnées connues pour ce pool | Lecture seule |
cbt-enabled |
Indicateur indiquant si le suivi des blocs modifiés est activé pour le VDI | Lecture/écriture |
vdi-clone
vdi-clone uuid = uuid_of_the_vdi [driver-params : key = value]
Créez une nouvelle copie accessible en écriture du VDI spécifié qui peut être utilisée directement. Il est une variante devdi-copy
ce qui est peut exposer les installations de clone d’image haute vitesse où elles existent.
Utilisez le paramètre dedriver-params
carte facultatif pour transmettre des informations de configuration supplémentaires spécifiques au fournisseur au pilote de stockage principal sur lequel repose le VDI. Pour plus d’informations, consultez la documentation sur le pilote fournisseur de stockage.
vdi-copy
vdi-copy uuuid = uuid_of_the_vdi sr-uuid = uuid_of_the_destination_sr
Copiez un VDI vers un SR spécifié.
vdi-create
vdi-create sr-uuid = uuid_of_sr_to_create_vdi_on nom-label = name_for_the_vdi type = system | user | suspend | crashdump virtual-size = size_of_virtual_disk sm-config- * = storage_specific_configuration_data
Créez un VDI.
Levirtual-size
paramètre peut être spécifié en octets ou en utilisant les suffixes standard IEC Kio, MiB, Gio et TiB.
Note :
Les types SR qui prennent en charge le provisionnement fin des disques (tels que VHD local et NFS) n’appliquent pas l’allocation virtuelle des disques. Faites attention lorsque vous allouez trop d’espace disque virtuel sur un SR. Si un SR suralloué devient complet, l’espace disque doit être disponible soit sur le substrat cible SR, soit en supprimant les VDI inutilisés dans le SR.
Note :
Certains types SR peuvent arrondir la
virtual-size
valeur pour la rendre divisible par une taille de bloc configurée.
vdi-data-destroy
vdi-data-destroy uuid = uuid_of_vdi
Détruisez les données associées au VDI spécifié, mais conservez les métadonnées de suivi de bloc modifiées.
Note :
Si vous utilisez le suivi des blocs modifiés pour effectuer des sauvegardes incrémentielles du VDI, assurez-vous d’utiliser la
vdi-data-destroy
commande pour supprimer les instantanés mais conserver les métadonnées. Ne pas utiliservdi-destroy
sur les instantanés de VDI qui ont modifié le suivi des blocs activé.
vdi-destroy
vdi-destroy uuid = uuid_of_vdi
Détruisez le VDI spécifié.
Note :
Si vous utilisez le suivi des blocs modifiés pour effectuer des sauvegardes incrémentielles du VDI, assurez-vous d’utiliser la
vdi-data-destroy
commande pour supprimer les instantanés mais conserver les métadonnées. Ne pas utiliservdi-destroy
sur les instantanés de VDI qui ont modifié le suivi des blocs activé.Note :
Pour les types Local VHD et NFS SR, l’espace disque n’est pas immédiatement libéré
vdi-destroy
, mais périodiquement pendant une opération d’analyse du référentiel de stockage. Si vous devez forcer la disponibilité de l’espace disque supprimé, appelez [sr-scan
] (#sr -scan) manuellement.
vdi-disable-cbt
vdi-disable-cbt uuid = uuid_of_vdi
Désactiver le suivi des blocs modifiés pour le VDI.
vdi-enable-cbt
vdi-enable-cbt uuid = uuid_of_vdi
Activer le suivi des blocs modifiés pour le VDI.
Note :
Vous pouvez activer le suivi des blocs modifiés uniquement sur les instances sous licence de .
vdi-export
vdi-export uuid = uuid_of_vdi nom_fichier = nom_fichier_to_export_to [format = format] [base = uuid_of_base_vdi] [— progress]
Exportez un VDI vers le nom de fichier spécifié. Vous pouvez exporter un VDI dans l’un des formats suivants :
raw
vhd
Le format VHD peut être clairsemé. S’il y a des blocs non alloués dans le VDI, ces blocs peuvent être omis du fichier VHD, ce qui rend le fichier VHD plus petit. Vous pouvez exporter au format VHD à partir de tous les types de stockage VHD pris en charge (EXT, NFS).
Si vous spécifiez lebase
paramètre, cette commande exporte uniquement les blocs qui ont changé entre le VDI exporté et le VDI de base.
vdi-forget
vdi-forget uuid = uuid_of_vdi
Supprime sans condition un enregistrement VDI de la base de données sans toucher le back-end de stockage. En fonctionnement normal, vous devriez utiliser [vdi-destroy
] (#vdi -destroy) à la place.
vdi-import
vdi-import uuuid = uuid_of_vdi filename = nom_fichier_to_import_from [format = format] [— progress]
Importer un VDI. Vous pouvez importer un VDI à partir de l’un des formats suivants :
raw
vhd
vdi-introduce
vdi-introduce uuid = uuid_of_vdi sr-uuid = uuid_of_sr nom-label = name_of_new_vdi type = system | user | suspend | crashdump emplacement = device_location_( varies_by_storage_type) [name-description = description_of_vdi] [sharable = oui | non] [lecture seule = oui | non] config = map_to_store_misc_user_specific_data] [xenstore-data = map_to_of_additional_xenstore_keys] [sm-config = storage_specific_configuration_data]
Créez un objet VDI représentant un périphérique de stockage existant, sans modifier ou créer de stockage. Cette commande est principalement utilisée en interne pour introduire automatiquement des périphériques de stockage branchés à chaud.
vdi-list-changed-blocks
vdi-list-changed-blocks vdi-from-uuid = first-vdi-uuid vdi-to-uuid = second vdi-uuid
Comparez deux VDI et renvoyez la liste des blocs qui ont changé entre les deux sous la forme d’une chaîne codée en base64. Cette commande ne fonctionne que pour les VDI qui ont modifié le suivi des blocs activé.
Pour plus d’informations, voir Suivi des blocs modifiés.
vdi-pool-migrate
vdi-pool-migrate uuuid = VDI_uuid sr-uuid = destination-sr-uuid
Migrez un VDI vers un SR spécifié, tandis que le VDI est attaché à un invité en cours d’exécution. (Stockage )
Pour plus d’informations, voir Migration des machines virtuelles.
vdi-resize
vdi-resize uuid = vdi_uuid disk-size = new_size_for_disk
Modifiez la taille du VDI spécifié par UUID.
vdi-snapshot
vdi-snapshot uuid = uuid_of_the_vdi [driver-params = params]
Produit une version en lecture-écriture d’un VDI qui peut être utilisée comme référence à des fins de sauvegarde ou de création de modèles, ou les deux. Utilisez l’instantané pour effectuer une sauvegarde plutôt que d’installer et d’exécuter un logiciel de sauvegarde à l’intérieur de la machine virtuelle. La machine virtuelle continue d’être exécutée pendant que le logiciel de sauvegarde externe diffuse le contenu de l’instantané vers le support de sauvegarde. De même, un instantané peut être utilisé comme une « image or » sur laquelle baser un modèle. Un modèle peut être réalisé en utilisant n’importe quel VDI.
Utilisez le paramètre dedriver-params
carte facultatif pour transmettre des informations de configuration supplémentaires spécifiques au fournisseur au pilote de stockage principal sur lequel repose le VDI. Pour plus d’informations, consultez la documentation sur le pilote fournisseur de stockage.
Un clone d’un instantané doit toujours produire un VDI accessible en écriture.
vdi-unlock
vdi-unlock uuid = uuid_of_vdi_to_unlock [force = true]
Tente de déverrouiller les VDI spécifiés. Si elleforce=true
est passée à la commande, elle force l’opération de déverrouillage.
vdi-update
vdi-update uuid = uuid
Actualisez les champs de l’objet VDI dans la base de données.
Commandes VIF
Commandes pour travailler avec des VIF (interfaces réseau virtuelles).
Les objets VIF peuvent être répertoriés avec la commande de listage d’objets standard (xe vif-list
) et les paramètres manipulés avec les commandes de paramètres standard. Pour plus d’informations, voir [Comman#low-level-parameter-commands()des de paramètres de bas niveau]
Paramètres VIF
Les VIF ont les paramètres suivants :
-
uuid
( lecture seule) la référence identifiant/objet unique pour le VIF -
vm-uuid
( lecture seule) la référence identifiant/objet unique pour la machine virtuelle sur laquelle ce VIF réside -
vm-name-label
( lecture seule) le nom de la machine virtuelle sur laquelle ce VIF réside -
allowed-operations
( lecture seule paramètre set) une liste des opérations autorisées dans cet état -
current-operations
( lecture seule paramètre set) une liste des opérations en cours sur ce VIF -
device
( lecture seule) libellé entier de ce VIF, indiquant l’ordre dans lequel les back-ends VIF ont été créés -
MAC
( lecture seule) Adresse MAC de VIF, telle qu’exposée à la machine virtuelle -
MTU
( lecture seule) Unité de transmission maximale du VIF en octets.Ce paramètre est en lecture seule, mais vous pouvez remplacer le paramètre MTU avec la
mtu
clé à l’aide du paramètreother-config
map. Par exemple, pour réinitialiser le MTU sur une carte réseau virtuelle pour utiliser des trames jumbo :xe-vif-param-set \ < vif_uuid >uuid = \ other-config:mtu=9000
-
currently-attached
( lecture seule) true si le périphérique est connecté - Algorithme QoS
qos_algorithm_type
(lecture/écriture) à utiliser -
qos_algorithm_params
( paramètre de carte en lecture/écriture) pour l’algorithme QoS choisi -
qos_supported_algorithms
( paramètre de jeu en lecture seule) pris en charge les algorithmes QoS pour ce VIF -
MAC-autogenerated
( lecture seule) True si l’adresse MAC du VIF a été générée automatiquement -
other-config
( paramètre de carte en lecture/écriture)key:value
paires de configuration supplémentaires -
other-config:ethtoolrx
( lecture/écriture) défini sur on pour activer la somme de contrôle de réception, désactivé pour désactiver -
other-config:ethtooltx
( lecture/écriture) défini sur on pour activer la somme de contrôle de transmission, désactivé pour désactiver -
other-config:ethtoolsg
( lecture/écriture) défini sur on pour activer la collecte de dispersion, désactivé pour désactiver -
other-config:ethtooltso
( lecture/écriture) définie sur on pour activer le déchargement de la segmentation tcp, off pour désactiver -
other-config:ethtoolufo
( lecture/écriture) définie sur on pour activer le déchargement du fragment udp, off pour désactiver -
other-config:ethtoolgso
( lecture/écriture) défini sur on pour activer le déchargement de segmentation générique, désactivé pour désactiver -
other-config:promiscuous
( lecture/écriture) true à un VIF pour être promiscuous sur le pont, de sorte qu’il voit tout le trafic sur le pont. Utile pour exécuter un système de détection d’intrusion (IDS) ou similaire dans une machine virtuelle. -
network-uuid
( lecture seule) la référence identifiant/objet unique du réseau virtuel auquel ce VIF est connecté -
network-name-label
( lecture seule) le nom descriptif du réseau virtuel auquel ce VIF est connecté -
io_read_kbs
( lecture seule) taux moyen de lecture en Ko/s pour cette VIF -
io_write_kbs
( lecture seule) taux d’écriture moyen en kb/s pour ce VIF -
locking_mode
( lecture/écriture) Affecte la capacité VIF à filtrer le trafic vers/depuis une liste d’adresses MAC et IP. Nécessite des paramètres supplémentaires. -
locking_mode:default
( lecture/écriture) Varie en fonction du mode de verrouillage par défaut du réseau VIF.Si le mode de verrouillage par défaut est défini sur
disabled
, applique une règle de filtrage afin que le VIF ne puisse pas envoyer ou recevoir du trafic. Si le mode de verrouillage par défaut est défini surunlocked
, supprime toutes les règles de filtrage associées au VIF. Pour plus d’informations, voir Commandes réseau. -
locking_mode:locked
( lecture/écriture) Seul le trafic envoyé ou envoyé à partir des adresses MAC et IP spécifiées est autorisé sur le VIF. Si aucune adresse IP n’est spécifiée, aucun trafic n’est autorisé. -
locking_mode:unlocked
( lecture/écriture) Aucun filtre n’est appliqué à tout trafic entrant ou sortant du VIF. -
locking_mode:disabled
( lecture/écriture) applique une règle de filtrage est appliquée de sorte que le VIF supprime tout le trafic.
vif-create
vif-create vm-uuid = uuid_of_the_vm device = voir ci-dessous network-uuid = uuid_of_network_to_connect_to [mac = mac_address]
Créez un VIF sur une machine virtuelle.
Les valeurs appropriées pour ledevice
champ sont répertoriées dans le paramètreallowed-VIF-devices
sur la machine virtuelle spécifiée. Avant qu’il y ait des VIF, les valeurs autorisées sont des entiers compris entre 0 et 15.
Lemac
paramètre est l’adresse MAC standard dans le formulaireaa:bb:cc:dd:ee:ff
. Si vous ne le laissez pas spécifié, une adresse MAC aléatoire appropriée est créée. Vous pouvez également définir explicitement une adresse MAC aléatoire en spécifiantmac=random
.
vif-destroy
vif-destroy uuid = uuid_of_vif
Détruisez un VIF.
vif-move
vif-move uuid = uuid network-uuid = network_uuid
Déplacez le VIF vers un autre réseau.
vif-plug
vif-plug uuid = uuid_of_vif
Essayez d’attacher le VIF lorsque la machine virtuelle est en cours d’exécution.
vif-unplug
vif-unplug uuid = uuid_of_vif
Tente de détacher le VIF de la machine virtuelle pendant son exécution.
vif-configure-ipv4
Configurez les paramètres IPv4 pour cette interface virtuelle. Définissez les paramètres IPv4 comme suit :
vif-configure-ipv4 uuid = uuid_of_vif mode = static address = CIDR_address gateway = gateway_gateway_gateway
Par exemple :
VIF.configure_ipv4 (vifObject, « statique », « 192.168.1.10/24 », "192.168.1.1")
Nettoyer les paramètres IPv4 comme ci-dessous :
vif-configure-ipv4 uuid = uuid_of_vif mode = none
vif-configure-ipv6
Configurez les paramètres IPv6 pour cette interface virtuelle. Définissez les paramètres IPv6 comme suit :
vif-configure-ipv6 uuid = uuid_of_vif mode = static address = IP_address gateway = gateway_gateway_gateway = gateway_address
Par exemple :
VIF.configure_ipv6 (vifObject, « statique », « fd 06:7768 : b9e 5:8 b00 : : 5001/64 », "fd 06:7768 : b9e 5:8 b00 : : 1")
Nettoyer les paramètres IPv6 comme ci-dessous :
vif-configure-ipv6 uuid = uuid_of_vif mode = none
Commandes VLAN
Commandes pour travailler avec des VLAN (réseaux virtuels). Pour répertorier et modifier les interfaces virtuelles, reportez-vous aux commandes PIF, qui ont un paramètre VLAN pour signaler qu’elles ont un réseau virtuel associé. Pour plus d’informations, voir Commandes PIF. Par exemple, pour répertorier les VLAN, utilisezxe pif-list
.
vlan-create
vlan-create pif-uuid = uuid_of_pif vlan = vlan_number network-uuid = uuid_of_network
Créez un VLAN sur votre hôte.
pool-vlan-create
pool-vlan-create pif-uuid = uuid_of_pif vlan = vlan_number network-uuid = uuid_of_network
Créez un VLAN sur tous les hôtes d’un pool, en déterminant l’interface (par exempleeth0
) sur laquelle se trouve le réseau spécifié (sur chaque hôte) et en créant et en branchant un nouvel objet PIF sur chaque hôte en conséquence.
vlan-destroy
vlan-destroy uuid = uuid_of_pif_mapped_to_vlan
Détruisez un VLAN. Nécessite l’UUID du PIF qui représente le VLAN.
Commandes VM
Commandes pour contrôler les machines virtuelles et leurs attributs.
Sélecteurs de machines virtuelles
Plusieurs des commandes répertoriées ici ont un mécanisme commun pour sélectionner une ou plusieurs machines virtuelles sur lesquelles effectuer l’opération. Le moyen le plus simple est de fournir l’argumentvm=name_or_uuid
. Un moyen facile d’obtenir l’uuuid d’une machine virtuelle réelle est, par exemple, d’exécuterxe vm-list power-state=running
. ( Récupère la liste complète des champs qui peuvent être mis en correspondance à l'aide de la commandexe vm-list params=all
.) Par exemple, la spécificationpower-state=halted
sélectionne des machines virtuelles dont lepower-state
paramètre est égal à halted.
Lorsque plusieurs machines virtuelles correspondent, spécifiez l’option--multiple
permettant d’effectuer l’opération. La liste complète des paramètres pouvant être mis en correspondance est décrite au début de cette section.
Les objets VM peuvent être répertoriés avec la commande de listage d’objets standard (xe vm-list
) et les paramètres manipulés avec les commandes de paramètres standard. Pour plus d’informations, voir [Comman#low-level-parameter-commands()des de paramètres de bas niveau]
Paramètres VM
Les machines virtuelles ont les paramètres suivants :
Note :
Toutes les valeurs de paramètre VM accessibles en écriture peuvent être modifiées pendant l’exécution de la machine virtuelle, mais les nouveaux paramètres ne sont pas appliqués dynamiquement et ne peuvent pas être appliqués tant que la machine virtuelle n’est pas redémarrée.
-
appliance
( lecture/écriture) l’Appliance/VApp auquel appartient la VM -
uuid
( lecture seule) l’identificateur unique/référence d’objet pour la machine virtuelle -
name-label
( lecture/écriture) le nom de la machine virtuelle -
name-description
( lecture/écriture) la chaîne de description de la machine virtuelle -
order start order
( lecture/écriture) pour le démarrage/arrêt de vApp et pour le démarrage après basculement HA -
version
( lecture seule) le nombre de fois que cette machine virtuelle a été récupérée. Si vous souhaitez remplacer une nouvelle machine virtuelle avec une version plus ancienne, appelezvm-recover
- Chaîne
user-version
(lecture/écriture) pour les créateurs de machines virtuelles et de modèles pour placer les informations de version -
is-a-template
( lecture/écriture) False, sauf si cette machine virtuelle est un modèle. Les machines virtuelles de modèle ne peuvent jamais être démarrées, elles sont utilisées uniquement pour le clonage d’autres machines virtuelles Une fois que cette valeur a été définie sur true, elle ne peut pas être réinitialisée à false. Les machines virtuelles de modèle ne peuvent pas être converties en machines virtuelles à l’aide de ce paramètre. -
is-control-domain
( lecture seule) True s’il s’agit d’un domaine de contrôle (domaine 0 ou domaine pilote) -
power-state
( lecture seule) état courant de l’alimentation -
start-delay
( lecture/écriture) le délai à attendre avant qu’un appel pour démarrer la machine virtuelle retourne -
shutdown-delay
( lecture/écriture) le délai à attendre avant qu’un appel pour arrêter la machine virtuelle retourne -
memory-dynamic-max
( lecture/écriture) maximum dynamique en octets -
memory-dynamic-min
( lecture/écriture) minimum dynamique en octets -
memory-static-max
( lecture/écriture) fixe statiquement (absolu) maximum en octets. Si vous souhaitez modifier cette valeur, la machine virtuelle doit être arrêtée. -
memory-static-min
( lecture/écriture) défini statiquement (absolu) minimum en octets. Si vous souhaitez modifier cette valeur, la machine virtuelle doit être arrêtée. -
suspend-VDI-uuid
( lecture seule) le VDI sur lequel une image suspendue est stockée -
VCPUs-params
( paramètre de carte en lecture/écriture) pour la stratégie vCPU sélectionnée.Vous pouvez régler l’épinglage d’un vCPU avec
xe vm-param-set uuuid = < vm_uuid > VCPUS-params : mask = 1,2,3
La machine virtuelle sélectionnée s’exécute ensuite uniquement sur les processeurs physiques 1, 2 et 3. Vous pouvez également régler la priorité vCPU (planification xen) avec les paramètres de plafond et de poids. Par exemple :
xe vm-param-set uuuid = < vm_uuid > VCPUS-params : poids = 512 xe vm-param-set uuuid = < vm_uuid > VCPUS-params : cap = 100
Une machine virtuelle avec un poids de 512 obtient deux fois plus de CPU qu’un domaine avec un poids de 256 sur un hôte concurrent. Les pondérations légales varient de 1 à 65535 et la valeur par défaut est 256. Le plafond fixe éventuellement la quantité maximale de CPU qu’une machine virtuelle peut consommer, même si l’ hôte a des cycles CPU inactifs. Le plafond est exprimé en pourcentage d’un CPU physique : 100 est un CPU physique, 50 est un demi-CPU, 400 est 4 CPU, etc. La valeur par défaut, 0, signifie qu’il n’y a pas de capuchon supérieur.
-
VCPUs-max
( lecture/écriture) nombre maximal de processeurs virtuels. - Nombre de démarrage
VCPUs-at-startup
(lecture/écriture) des processeurs virtuels -
actions-after-crash
( lecture/écriture) à effectuer si la machine virtuelle se bloque. Pour les invités PV, les paramètres valides sont :-
preserve
( pour analyse seulement) -
coredump_and_restart
( enregistrer un coredump et redémarrer une machine virtuelle) -
coredump_and_destroy
( enregistrer un coredump et laisser la machine virtuelle interrompue) -
restart
( pas de coredump et redémarrage de la machine virtuelle) -
destroy
( pas de coredump et laisser la machine virtuelle interrompue)
-
-
console-uuids
( paramètre de jeu en lecture seule) périphériques de console virtuelle -
platform
( paramètre de carte en lecture/écriture) configuration spécifique à la plate-formePour désactiver Virtual Desktop Agent (VDA) pour basculer Windows 10 en mode Tablet :
xe vm-param-set uuuid = < vm_uuid > plateforme : acpi_laptop_slate = 0
Pour activer le VDA pour basculer Windows 10 en mode Tablet :
xe vm-param-set uuuid = < vm_uuid > plateforme : acpi_laptop_slate = 1
Pour vérifier l’état actuel :
xe vm-param-get uuid = < vm_uuid > param-name = platform param-key = acpi_laptop_slate
-
allowed-operations
( lecture seule paramètre set) liste des opérations autorisées dans cet état -
current-operations
( lecture seule paramètre set) une liste des opérations en cours sur la machine virtuelle -
allowed-VBD-devices
( paramètre de jeu en lecture seule) liste des identificateurs VBD disponibles pour l’utilisation, représentés par des entiers de la plage 0 à 15. Cette liste est informative uniquement, et d’autres périphériques peuvent être utilisés (mais peuvent ne pas fonctionner). -
allowed-VIF-devices
( paramètre de jeu en lecture seule) liste des identificateurs VIF disponibles à l’emploi, représentés par des entiers de la plage 0 à 15. Cette liste est informative uniquement, et d’autres périphériques peuvent être utilisés (mais peuvent ne pas fonctionner). -
HVM-boot-policy
( lecture/écriture) la stratégie de démarrage pour les invités HVM. Commande BIOS ou chaîne vide. -
HVM-boot-params
( paramètre de carte en lecture/écriture), la clé de commande contrôle l’ordre de démarrage invité HVM, représenté sous la forme d’une chaîne où chaque caractère est une méthode de démarrage : d pour le CD/DVD, c pour le disque racine et n pour le démarrage réseau PXE. La valeur par défaut est dc. -
HVM-shadow-multiplier
( lecture/écriture) Valeur à virgule flottante qui contrôle la quantité de mémoire ombragée à accorder à la machine virtuelle. La valeur par défaut est 1.0 (la valeur minimale), et seuls les utilisateurs avancés doivent modifier cette valeur. -
PV-kernel
( lecture/écriture) vers le noyau -
PV-ramdisk
( lecture/écriture) vers l’initrd -
PV-args
( lecture/écriture) chaîne d’arguments de ligne de commande du noyau -
PV-legacy-args
( lecture/écriture) chaîne d’arguments pour faire démarrer les machines virtuelles héritées -
PV-bootloader
( lecture/écriture) nom ou chemin d’accès au chargeur de démarrage -
PV-bootloader-args
( lecture/écriture) chaîne d’arguments divers pour le chargeur d’amorçage -
last-boot-CPU-flags
( lecture seule) décrit les indicateurs CPU sur lesquels la machine virtuelle a été démarrée pour la dernière fois -
resident-on
( lecture seule) l’ hôte sur lequel une machine virtuelle réside -
affinity
( lecture/écriture) Hôte sur lequel la machine virtuelle a la préférence pour s’exécuter. Utilisé par laxe vm-start
commande pour décider où exécuter la machine virtuelle -
other-config
( paramètre de carte en lecture/écriture) Liste de paires clé/valeur qui spécifient des paramètres de configuration supplémentaires pour la machine virtuelle. Par exemple, une machine virtuelle est démarrée automatiquement après le démarrage de l’hôte lorsque leother-config
paramètre inclut la paireauto_poweron: true
clé/valeur -
start-time
( lecture seule) horodatage de la date et de l’heure auxquelles les mesures de la machine virtuelle ont été lues. Cet horodatage est sous la formeyyyymmddThh:mm:ss z
, où z est l’indicateur de fuseau horaire militaire à une lettre unique, par exemple, Z pour UTC (GMT) -
install-time
( lecture seule) horodatage de la date et de l’heure auxquelles les mesures de la machine virtuelle ont été lues. Cet horodatage est sous la formeyyyymmddThh:mm:ss z
, où z est l’indicateur de fuseau horaire militaire à une lettre unique, par exemple, Z pour UTC (GMT) -
memory-actual
( lecture seule) la mémoire réelle utilisée par une machine virtuelle -
VCPUs-number
( lecture seule) le nombre de processeurs virtuels affectés à la machine virtuelle pour une machine virtuelle Linux PV (paravirtuelle) ou HVM (machine virtuelle matérielle). Ce nombre peut différerVCPUS-max
et peut être modifié sans redémarrer la machine virtuelle à l’aide de lavm-vcpu-hotplug
commande. Pour plus d’informations, consultez [vm-vcpu-hotplug
] (#vm -vcpu-hotplug). Les machines virtuelles Windows s’exécutent toujours avec le nombre de vCPU défini surVCPUsmax
et doit être redémarré pour modifier cette valeur. Les performances diminuent fortement lorsque vous définissezVCPUs-number
une valeur supérieure au nombre de processeurs physiques sur l’ hôte. -
VCPUs-Utilization
( paramètre de carte en lecture seule) une liste des processeurs virtuels et leur poids -
os-version
( paramètre de carte en lecture seule) la version du système d’exploitation de la machine virtuelle -
PV-drivers-version
( paramètre de carte en lecture seule) les versions des pilotes paravirtualisés pour la machine virtuelle -
PV-drivers-detected
( lecture seule) pour la dernière version des pilotes paravirtualisés pour la machine virtuelle -
memory
( paramètre de mappage en lecture seule) des mesures de mémoire rapportées par l’agent sur la machine virtuelle -
disks
( paramètre de mappage en lecture seule) des mesures de disque signalées par l’agent sur la machine virtuelle -
networks
( paramètre de carte en lecture seule) mesures de réseau signalées par l’agent sur la machine virtuelle -
other
( paramètre de mappage en lecture seule) autres mesures rapportées par l’agent sur la machine virtuelle -
guest-metrics-lastupdated
( lecture seule) horodatage lorsque l’agent in-guest a effectué la dernière écriture dans ces champs. L’horodatage est sous la formeyyyymmddThh:mm:ss z
, où z est l’indicateur de fuseau horaire militaire à une lettre unique, par exemple, Z pour UTC (GMT) -
actions-after-shutdown
( lecture/écriture) à prendre après l’arrêt de la machine virtuelle -
actions-after-reboot
( lecture/écriture) à effectuer après le redémarrage de la machine virtuelle - hôtes
possible-hosts
potentiels de cette machine virtuelle en lecture seule -
dom-id
( lecture seule) ID de domaine (si disponible, -1 sinon) -
recommendations
( lecture seule) Spécification XML des valeurs et plages recommandées pour les propriétés de cette machine virtuelle -
xenstore-data
( paramètre de carte en lecture/écriture) à insérer dans l’arborescence xenstore (/ local/domain/domid /vm-data) après la création de la machine virtuelle -
is-a-snapshot
( lecture seule) True si cette machine virtuelle est un instantané -
snapshot_of
( lecture seule) l’UUID de la machine virtuelle dont ce snapshot est de -
snapshots
( lecture seule) les UUID de tous les instantanés de cette machine virtuelle -
snapshot_time
( lecture seule) l’horodatage de l’opération de capture instantanée qui a créé ce snapshot de machine virtuelle -
memory-target
( lecture seule) la quantité cible de mémoire définie pour cette machine virtuelle -
blocked-operations
( paramètre de carte en lecture/écriture) répertorie les opérations qui ne peuvent pas être effectuées sur cette machine virtuelle -
last-boot-record
( lecture seule) enregistrement des derniers paramètres de démarrage de ce modèle, au format XML -
ha-always-run
( lecture/écriture) True si cette machine virtuelle est toujours redémarrée sur un autre hôte s’il y a une défaillance de l’hôte sur lequel elle réside. Ce paramètre est maintenant obsolète. Utilisez leha-restart-priority
paramètre à la place. -
ha-restart-priority
( lecture/écriture) redémarrage ou meilleur effort - stockage de données binaires
blobs
(lecture seule) -
live
( lecture seule) True si la machine virtuelle est en cours d’exécution. False si HA soupçonne que la machine virtuelle n’est pas en cours d’exécution.
vm-assert-can-be-recovered
vm-assert-can-be-récupéré uuid [base de données] vdi-uuid
Teste si le stockage est disponible pour récupérer cette machine virtuelle.
vm-call-plugin
vm-call-plugin vm-uuid = vm_uuid plugin = plugin fn = function [args : key = value]
Appelle la fonction dans le plugin sur la vm donnée avec des arguments optionnels (args : key = value). Pour passer une chaîne « value » avec des caractères spéciaux (par exemple nouvelle ligne), une syntaxe alternative args : key : file = local_file peut être utilisée en place, où le contenu de local_file sera récupéré et attribué à « key » dans son ensemble.
vm-cd-add
vm-cd-add cd-name = name_of_new_cd device = integer_value_of_an_available_vbd [vm-selector = vm_selector_value...]
Ajoutez un nouveau CD virtuel à la machine virtuelle sélectionnée. Ledevice
paramètre doit être sélectionné à partir de la valeur duallowed-VBD-devices
paramètre de la machine virtuelle.
La ou les machines virtuelles sur lesquelles cette opération est effectuée sont sélectionnées à l’aide du mécanisme de sélection standard. Pour plus d’informations, voir sélecteurs de machines virtuelles. Les arguments facultatifs peuvent être n’importe quel nombre de paramètres VMrépertoriés au début de cette section.
vm-cd-eject
vm-cd-eject [vm-selector = vm_selector_value...]
Éjectez un CD du lecteur de CD virtuel. Cette commande ne fonctionne que si exactement un CD est attaché à la machine virtuelle. Lorsqu’il y a deux CD ou plus, utilisez la commandexe vbd-eject
et spécifiez l’UUID du VBD.
La ou les machines virtuelles sur lesquelles cette opération est effectuée sont sélectionnées à l’aide du mécanisme de sélection standard. Pour plus d’informations, voir sélecteurs de machines virtuelles. Les arguments facultatifs peuvent être n’importe quel nombre de paramètres VMrépertoriés au début de cette section.
vm-cd-insert
vm-cd-insert cd-name = name_of_cd [vm-selector = vm_selector_value...]
Insérez un CD dans le lecteur de CD virtuel. Cette commande ne fonctionne que s’il y a exactement un périphérique CD vide attaché à la machine virtuelle. Lorsqu’il y a deux ou plusieurs périphériques CD vides, utilisez laxe vbd-insert
commande et spécifiez les UUID du VBD et du VDI à insérer.
La ou les machines virtuelles sur lesquelles cette opération est effectuée sont sélectionnées à l’aide du mécanisme de sélection standard. Pour plus d’informations, voir sélecteurs de machines virtuelles. Les arguments facultatifs peuvent être n’importe quel nombre de paramètres VMrépertoriés au début de cette section.
vm-cd-list
vm-cd-list [vbd-params] [vdi-params] [vm-selector = vm_selector_value...]
Répertorie les CD attachés aux machines virtuelles spécifiées.
La ou les machines virtuelles sur lesquelles cette opération est effectuée sont sélectionnées à l’aide du mécanisme de sélection standard. Pour plus d’informations, voir sélecteurs de machines virtuelles. Les arguments facultatifs peuvent être n’importe quel nombre de paramètres VMrépertoriés au début de cette section.
Vous pouvez également sélectionner les paramètres VBD et VDI à lister.
vm-cd-remove
vm-cd-remove cd-name = name_of_cd [vm-selector = vm_selector_value...]
Supprimez un CD virtuel des machines virtuelles spécifiées.
La ou les machines virtuelles sur lesquelles cette opération est effectuée sont sélectionnées à l’aide du mécanisme de sélection standard. Pour plus d’informations, voir sélecteurs de machines virtuelles. Les arguments facultatifs peuvent être n’importe quel nombre de paramètres VMrépertoriés au début de cette section.
vm-checkpoint
vm-checkpoint new-name-label = name_label [new-nom-description = description]
Checkpoint une machine virtuelle existante, à l’aide d’une opération rapide de snapshot de disque au niveau du stockage, le cas échéant.
vm-clone
vm-clone new-name-label = name_for_clone [new-name-description = description_for_clone] [vm-selector = vm_selector_value...]
Clonez une machine virtuelle existante, à l’aide d’une opération de clone de disque rapide au niveau du stockage, le cas échéant. Spécifiez le nom et la description facultative de la machine virtuelle clonée résultante à l’aidenew-name-label
desnew-name-description
arguments et.
La ou les machines virtuelles sur lesquelles cette opération est effectuée sont sélectionnées à l’aide du mécanisme de sélection standard. Pour plus d’informations, voir sélecteurs de machines virtuelles. Les arguments facultatifs peuvent être n’importe quel nombre de paramètres VMrépertoriés au début de cette section.
vm-compute-maximum-memory
vm-compute-maximum-memory total = amount_of_available_physical_ram_in_bytes [approximate = ajouter de la mémoire pour les vCPU supplémentaires ? true | false] [vm_selector = vm_selector_value...]
Calculez la quantité maximale de mémoire statique qui peut être allouée à une machine virtuelle existante, en utilisant la quantité totale de RAM physique comme limite supérieure. Le paramètre optionnelapproximate
réserve suffisamment de mémoire supplémentaire dans le calcul pour tenir compte de l’ajout de vCPU supplémentaires dans la machine virtuelle ultérieurement.
Par exemple :
xe vm-compute-maximum-memory vm = testvm total = `xe host-list params = free memory — minimal`
Cette commande utilise la valeur dumemory-free
paramètre renvoyé par laxe host-list
commande pour définir la mémoire maximale de la machine virtuelle nomméetestvm
.
La ou les machines virtuelles sur lesquelles cette opération est effectuée sont sélectionnées à l’aide du mécanisme de sélection standard. Pour plus d’informations, voir sélecteurs de machines virtuelles. Les arguments facultatifs peuvent être n’importe quel nombre de paramètres VMrépertoriés au début de cette section.
vm-compute-memory-overhead
vm-compute-mémoire surpassée-mémoire
Calcule la surcharge mémoire de virtualisation d’une machine virtuelle.
vm-copy
vm-copy new-name-label = name_for_copy [new-name-description = description_for_copy] [sr-uuid = uuid_of_sr] [vm-selector = vm_selector_value...]
Copiez une machine virtuelle existante, mais sans utiliser une opération de clone de disque rapide au niveau du stockage (même si cette option est disponible). Les images disque de la machine virtuelle copiée sont garanties comme des images complètes, c’est-à-dire qu’elles ne font pas partie d’une chaîne Copy-on-Write (CoW).
Spécifiez le nom et la description facultative de la machine virtuelle copiée résultante à l’aidenew-name-label
desnew-name-description
arguments et.
Spécifiez la SR de destination pour la machine virtuelle copiée résultante à l’aide de lasr-uuid
. Si ce paramètre n’est pas spécifié, la destination est la même SR que la machine virtuelle d’origine.
La ou les machines virtuelles sur lesquelles cette opération est effectuée sont sélectionnées à l’aide du mécanisme de sélection standard. Pour plus d’informations, voir sélecteurs de machines virtuelles. Les arguments facultatifs peuvent être n’importe quel nombre de paramètres VMrépertoriés au début de cette section.
vm-copy-bios-strings
vm-copy-bios-strings host-uuid = host_uuid
Copiez les chaînes du BIOS de l’hôte donné sur la machine virtuelle.
vm-crashdump-list
vm-crashdump-list [vm-selector = valeur de sélecteur vm...]
Répertorier les crashdumps associés aux machines virtuelles spécifiées.
Lorsque vous utilisez l’argument facultatifparams
, la valeur de params est une chaîne contenant une liste de paramètres de cet objet que vous souhaitez afficher. Vous pouvez également utiliser le mot-cléall
pour afficher tous les paramètres. Si elle n’params
est pas utilisée, la liste renvoyée affiche un sous-ensemble par défaut de tous les paramètres disponibles.
La ou les machines virtuelles sur lesquelles cette opération est effectuée sont sélectionnées à l’aide du mécanisme de sélection standard. Pour plus d’informations, voir sélecteurs de machines virtuelles. Les arguments facultatifs peuvent être n’importe quel nombre de paramètres VMrépertoriés au début de cette section.
vm-data-source-list
vm-data-source-list [vm-selector = valeur de sélecteur vm...]
Répertorie les sources de données pouvant être enregistrées pour une machine virtuelle.
Sélectionnez les machines virtuelles sur lesquelles effectuer cette opération à l’aide du mécanisme de sélection standard. Pour plus d’informations, voir sélecteurs de machines virtuelles. Les arguments facultatifs peuvent être n’importe quel nombre de paramètres VMrépertoriés au début de cette section. Si aucun paramètre de sélection d’hôtes n’est donné, l’opération est effectuée sur toutes les machines virtuelles.
Les sources de données ont deux paramètresstandard
—enabled
et — que vous pouvez voir dans la sortie de cette commande. Si une source de données estenabled
définie surtrue
, les mesures sont actuellement enregistrées dans la base de données de performances. Si une source de données a lastandard
valeurtrue
, les mesures sont enregistrées dans la base de données de performances par défaut (etenabled
sont également définies surtrue
pour cette source de données). Si une source de données a lastandard
valeurfalse
, les mesures *ne sont pas* enregistrées dans la base de données de performances par défaut (etenabled
sont également définies sur falsepour cette source de données).
Pour commencer à enregistrer des mesures de source de données dans la base de données de performances, exécutez lavm-data-source-record
commande. Cette commande définitenabled
la valeurtrue
. Pour arrêter, exécutez levm-data-source-forget
. Cette commande définitenabled
la valeurfalse
.
vm-data-source-record
vm-data-source-record data-source = name_description_of_data-source [vm-selector = valeur de sélecteur vm...]
Enregistrez la source de données spécifiée pour une machine virtuelle.
Cette opération écrit les informations de la source de données dans la base de données de mesures de performances persistantes des machines virtuelles spécifiées. Pour des raisons de performances, cette base de données est distincte de la base de données de l’agent normal.
Sélectionnez les machines virtuelles sur lesquelles effectuer cette opération à l’aide du mécanisme de sélection standard. Pour plus d’informations, voir sélecteurs de machines virtuelles. Les arguments facultatifs peuvent être n’importe quel nombre de paramètres VMrépertoriés au début de cette section. Si aucun paramètre de sélection d’hôtes n’est donné, l’opération est effectuée sur toutes les machines virtuelles.
vm-data-source-forget
vm-data-source-forget data-source = name_description_of_data-source [vm-selector = valeur de sélecteur vm...]
Arrêtez d’enregistrer la source de données spécifiée pour une machine virtuelle et oubliez toutes les données enregistrées.
Sélectionnez les machines virtuelles sur lesquelles effectuer cette opération à l’aide du mécanisme de sélection standard. Pour plus d’informations, voir sélecteurs de machines virtuelles. Les arguments facultatifs peuvent être n’importe quel nombre de paramètres VMrépertoriés au début de cette section. Si aucun paramètre de sélection d’hôtes n’est donné, l’opération est effectuée sur toutes les machines virtuelles.
vm-data-source-query
vm-data-source-query data-source = name_description_of_data-source [vm-selector = vm_selector_value...]
Affiche la source de données spécifiée pour une machine virtuelle.
Sélectionnez les machines virtuelles sur lesquelles effectuer cette opération à l’aide du mécanisme de sélection standard. Pour plus d’informations, voir sélecteurs de machines virtuelles. Les arguments facultatifs peuvent être n’importe quel nombre de paramètres VMrépertoriés au début de cette section. Si aucun paramètre de sélection d’hôtes n’est donné, l’opération est effectuée sur toutes les machines virtuelles.
vm-destroy
vm-destroy uuid = uuid_of_vm
Détruisez la machine virtuelle spécifiée. Le stockage associé à la machine virtuelle reste intact. Pour supprimer également le stockage, utilisezxe vm-uninstall
.
vm-disk-add
vm-disk-add disk-size = size_of_disk_to_add device = uuid_of_device [vm-selector = vm_selector_value...]
Ajoutez un disque aux machines virtuelles spécifiées. Sélectionnez ledevice
paramètre dans la valeur duallowed-VBD-devices
paramètre des machines virtuelles.
Ledisk-size
paramètre peut être spécifié en octets ou en utilisant les suffixes standard IEC Kio, MiB, Gio et TiB.
La ou les machines virtuelles sur lesquelles cette opération est effectuée sont sélectionnées à l’aide du mécanisme de sélection standard. Pour plus d’informations, voir sélecteurs de machines virtuelles. Les arguments facultatifs peuvent être n’importe quel nombre de paramètres VMrépertoriés au début de cette section.
vm-disk-list
vm-disk-list [vbd-params] [vdi-params] [vm-selector = vm_selector_value...]
Répertorie les disques attachés aux machines virtuelles spécifiées. Lesvbd-params
paramètresvdi-params
et contrôlent les champs des objets respectifs à sortir. Donnez les paramètres sous forme de liste séparée par des virgules, ou la clé spécialeall
pour la liste complète.
La ou les machines virtuelles sur lesquelles cette opération est effectuée sont sélectionnées à l’aide du mécanisme de sélection standard. Pour plus d’informations, voir sélecteurs de machines virtuelles. Les arguments facultatifs peuvent être n’importe quel nombre de paramètres VMrépertoriés au début de cette section.
vm-disk-remove
vm-disk-remove device = integer_label_of_disk [vm-selector = vm_selector_value...]
Supprimez un disque des machines virtuelles spécifiées et détruisez-le.
La ou les machines virtuelles sur lesquelles cette opération est effectuée sont sélectionnées à l’aide du mécanisme de sélection standard. Pour plus d’informations, voir sélecteurs de machines virtuelles. Les arguments facultatifs peuvent être n’importe quel nombre de paramètres VMrépertoriés au début de cette section.
vm-export
vm-export filename = export_filename [metadata = true | false] [vm-selector = vm_selector_value...]
Exportez les machines virtuelles spécifiées (y compris les images disque) vers un fichier sur la machine locale. Spécifiez le nom de fichier dans lequel exporter la machine virtuelle à l’aide dufilename
paramètre. Par convention, le nom de fichier doit avoir une.xva
extension.
Si lemetadata
paramètre esttrue
, les disques ne sont pas exportés. Seules les métadonnées de la machine virtuelle sont écrites dans le fichier de sortie. Utilisez ce paramètre lorsque le stockage sous-jacent est transféré via d’autres mécanismes et permet de recréer les informations de la machine virtuelle. Pour plus d’informations, consultez vm-import.
La ou les machines virtuelles sur lesquelles cette opération est effectuée sont sélectionnées à l’aide du mécanisme de sélection standard. Pour plus d’informations, voir sélecteurs de machines virtuelles. Les arguments facultatifs peuvent être n’importe quel nombre de paramètres VMrépertoriés au début de cette section.
vm-import
vm-import filename = export_filename [metadata = true | false] [preserve = true | false] [sr-uuid = destination_sr_uuid]
Importez une machine virtuelle à partir d’un fichier précédemment exporté. Si ellepreserve
est définie surtrue
, l’adresse MAC de la machine virtuelle d’origine est conservée. Lesr-uuid
détermine le SR de destination dans lequel importer la machine virtuelle. Si ce paramètre n’est pas spécifié, la SR par défaut est utilisée.
Lefilename
paramètre peut également pointer vers une machine virtuelle au format XVA, qui est le format d’exportation hérité de 3.2. Ce format est utilisé par certains fournisseurs tiers pour fournir des appliances virtuelles. Le format XVA utilise un répertoire pour stocker les données de la machine virtuelle, donc définifilename
sur le répertoire racine de l’exportation XVA et non sur un fichier réel. Les exportations ultérieures de l’invité hérité importé sont automatiquement mises à niveau vers le nouveau format basé sur le nom de fichier, qui stocke beaucoup plus de données sur la configuration de la machine virtuelle.
Note :
L’ancien format XVA basé sur un répertoire ne conserve pas complètement tous les attributs de la machine virtuelle. En particulier, les machines virtuelles importées n’ont pas d’interface réseau virtuelle attachée par défaut. Si la mise en réseau est requise, créez-en un en utilisant
vif-create
etvif-plug
.
metadata
Le cas échéanttrue
, vous pouvez importer un jeu de métadonnées précédemment exporté sans les blocs de disque associés. L’importation de métadonnées uniquement échoue si aucun VDI ne peut être trouvé (nommé par SR etVDI.location
), sauf si l’--force
option est spécifiée, auquel cas l’importation est effectuée indépendamment. Si les disques peuvent être mis en miroir ou déplacés hors bande, l’importation/exportation de métadonnées est un moyen rapide de déplacer des machines virtuelles entre des pools disjoints. Par exemple, dans le cadre d’un plan de reprise après sinistre.
Note :
Plusieurs importations de machines virtuelles sont effectuées plus rapidement en série qu’en parallèle.
vm-install
vm-install new-name-label = name [template-uuid = uuid_of_desired_template] [template = template_uuid_or_name] [sr-uuid = sr_uuid | sr-name-label = name_of_sr] [copy-bios-strings-from = host_uuuid]
Installez ou clonez une machine virtuelle à partir d’un modèle. Spécifiez le nom du modèle à l’aide de l’template-uuid
argumenttemplate
ou. Spécifiez une SR à l’aide de l’sr-uuid
argumentsr-name-label
ou. Spécifiez l’installation du média verrouillé BIOS à l’aide de l’copy-bios-strings-from
argument.
Note :
Lors de l’installation à partir d’un modèle contenant des disques existants, par défaut, de nouveaux disques sont créés dans le même SR que ces disques existants. Lorsque le SR le prend en charge, ces disques sont des copies rapides. Si un SR différent est spécifié sur la ligne de commande, les nouveaux disques y sont créés. Dans ce cas, une copie rapide n’est pas possible et les disques sont des copies complètes.
Lors de l’installation à partir d’un modèle qui n’a pas de disques existants, tous les nouveaux disques sont créés dans le SR spécifié, ou le SR par défaut du pool lorsqu’un SR n’est pas spécifié.
vm-is-bios-customized
vm-is-bios-customisé
Indique si les chaînes du BIOS de la machine virtuelle ont été personnalisées.
vm-memory-balloon
vm-memory-balloon target = target
Définissez la cible de mémoire pour une machine virtuelle en cours d’exécution. La valeur donnée doit être comprise dans la plage définie par les valeurs memory_dynamic_min et memory_dynamic_max de la machine virtuelle.
vm-memory-dynamic-range-set
vm-memory-dynamic-range-set min = min max = max
Configurez la plage de mémoire dynamique d’une machine virtuelle. La plage de mémoire dynamique définit les limites inférieures et supérieures de la mémoire d’une machine virtuelle. Il est possible de modifier ces champs lorsqu’une machine virtuelle est en cours d’exécution ou arrêtée. La plage dynamique doit être comprise dans la plage statique.
vm-memory-limits-set
vm-memory-limits-set static-min = static_min static-max = static_max dynamic-min = dynamic_min dynamic-max = dynamic_max
Configurez les limites de mémoire d’une machine virtuelle.
vm-memory-set
mémoire mémoire vm-set = mémoire
Configurez l’allocation de mémoire d’une machine virtuelle.
vm-memory-shadow-multiplier-set
vm-memory-shadow-multiplier-set [vm-selector = vm_selector_value...] [multiplicateur = float_memory_multiplicateur]
Définissez le multiplicateur de mémoire instantanée pour la machine virtuelle spécifiée.
Il s’agit d’une option avancée qui modifie la quantité de mémoire instantan ée attribuée à une machine virtuelle assistée par le matériel.
Cette mémoire est considérée comme une surcharge. Il est séparé des calculs de mémoire normale pour comptabiliser la mémoire à une machine virtuelle. Lorsque cette commande est appelée, la quantité de mémoire hôte libre diminue en fonction du multiplicateur et leHVM_shadow_multiplier
champ est mis à jour avec la valeur attribuée par Xen à la machine virtuelle. S’il n’y a pas assez de mémoire hôte libre, une erreur est renvoyée.
Les machines virtuelles sur lesquelles cette opération doit être effectuée sont sélectionnées à l’aide du mécanisme de sélection standard. Pour plus d’informations, voir sélecteurs de machines virtuelles.
vm-memory-static-range-set
vm-memory-static-range-set min = min max = max
Configurez la plage de mémoire statique d’une machine virtuelle. La plage de mémoire statique définit les limites inférieures et supérieures de la mémoire d’une machine virtuelle. Il est possible de modifier ces champs uniquement lorsqu’une machine virtuelle est arrêtée. La plage statique doit englober la plage dynamique.
vm-memory-target-set
vm-memory-target-set target = target
Définissez la cible de mémoire pour une machine virtuelle arrêtée ou en cours d’exécution. La valeur donnée doit être comprise dans la plage définie par les valeurs memory_static_min et memory_static_max de la machine virtuelle.
vm-memory-target-wait
vm-memory-target-wait
Attendez qu’une machine virtuelle en cours d’exécution atteigne sa cible de mémoire actuelle.
vm-migrate
vm-migrer [copy = true | false] [host-uuid = destination_host_uuid] [host = name_or_uuid_of_destination_host] [force = true | false] [live = true | false] [vm-selector = vm_selector_value...] [remote-master = destination_pool_master_uuid] [remote-username = destination_pool_username] [remote-password = destination_pool_password] [remote-network = destination_pool_network_uuid] [vif : = vif_uuid] [vdi = vdi_uuid]
Cette commande migre les machines virtuelles spécifiées entre les hôtes physiques. Lehost
paramètre peut être le nom ou l’UUID de l’ hôte. Par exemple, pour migrer la machine virtuelle vers un autre hôte du pool, où les disques de machine virtuelle se trouvent sur le stockage partagé par les deux hôtes :
xe vm-migrate uuuid = vm_uuid host-uuid = host_uuid
Pour déplacer des machines virtuelles entre des hôtes du même pool, qui ne partagent pas de stockage (stockage ) :
xe vm-migrate uuuid = vm_uuid remote-master = 12.34.56.78 \
remote-username = nom d'utilisateur remote-mot de passe = mot de passe \
host-uuid = desination_host_uuid vdi = vdi_uuid
Vous pouvez choisir le SR où chaque VDI est stocké :
xe vm-migrate uuuid = vm_uuid host-uuid = destination_host_uuid \
vdi1 : vdi_1_uuid = destination_sr_uuid \
vdi2:vdi_2_uuid=destination_sr2_uuid \
vdi3:vdi_3_uuid=destination_sr3_uuid
En outre, vous pouvez choisir le réseau à attacher la machine virtuelle après la migration :
xe vm-migrer uuid = vm_uuid \
vdi1 : vdi_1_uuid = destination_sr_uuid \
vdi2:vdi_2_uuid=destination_sr2_uuid \
vdi3:vdi_3_uuid=destination_sr3_uuid \
vif : vif_uuid = network_uuid
Pour la migration entre pools :
xe vm-migrate uuuid = vm_uuid remote-master = 12.34.56.78
remote-username = nom d'utilisateur remote-mot de passe = mot de passe \
host-uuid = desination_host_uuid vdi = vdi_uuid
Pour plus d’informations sur le stockage et la migration VDI en direct, voir [Migration des machines virtuelles avec et stockage /en-us/xenserver/current-release/vms/migrate.html()].
Par défaut, la machine virtuelle est suspendue, migrée et reprise sur l’autre hôte. Lelive
paramètre sélectionne . maintient la machine virtuelle en cours d’exécution lors de la migration, réduisant ainsi les temps d’arrêt de la machine virtuelle à moins d’une seconde. Dans certaines circonstances, telles que des charges de travail extrêmement volumineuses en mémoire dans la machine virtuelle, retombe en mode par défaut et suspend la machine virtuelle pendant une courte période avant d’effectuer le transfert de mémoire.
La ou les machines virtuelles sur lesquelles cette opération est effectuée sont sélectionnées à l’aide du mécanisme de sélection standard. Pour plus d’informations, voir sélecteurs de machines virtuelles. Les arguments facultatifs peuvent être n’importe quel nombre de paramètres VMrépertoriés au début de cette section.
vm-pause
vm-pause
Suspendre une machine virtuelle en cours d’exécution. Notez que cette opération ne libère pas la mémoire associée (voirvm-suspend
).
vm-query-services
vm-query-services
Interrogez les services système offerts par les machines virtuelles données.
vm-reboot
vm-reboot [vm-selector = vm_selector_value...] [force = true]
Redémarrez les machines virtuelles spécifiées.
La ou les machines virtuelles sur lesquelles cette opération est effectuée sont sélectionnées à l’aide du mécanisme de sélection standard. Pour plus d’informations, voir sélecteurs de machines virtuelles. Les arguments facultatifs peuvent être n’importe quel nombre de paramètres VMrépertoriés au début de cette section.
Utilisez l’force
argument pour provoquer un redémarrage ingracieux. Où l’arrêt s’apparente à tirer la fiche sur un serveur physique.
vm-recover
vm-recover vm-uuid [base de données] [vdi-uuid] [force]
Récupère une machine virtuelle à partir de la base de données contenue dans le VDI fourni.
vm-reset-powerstate
vm-reset-powerstate [vm-selector = vm_selector_value...] {force = true}
La ou les machines virtuelles sur lesquelles cette opération est effectuée sont sélectionnées à l’aide du mécanisme de sélection standard. Pour plus d’informations, voir sélecteurs de machines virtuelles. Les arguments facultatifs peuvent être n’importe quel nombre de paramètres VMrépertoriés au début de cette section.
Il s’agit d’une commande avancée uniquement à utiliser lorsqu’un hôte membre d’un pool tombe en panne. Vous pouvez utiliser cette commande pour forcer le maître de pool à réinitialiser l’état d’alimentation des machines virtuelles à êtrehalted
. Essentiellement, cette commande force le verrou sur la machine virtuelle et ses disques afin qu’il puisse être démarré sur un autre hôte de pool. Cet appel nécessite que l’indicateur de force soit spécifié et échoue s’il n’est pas sur la ligne de commande.
vm-resume
vm-resume [vm-selector = vm_selector_value...] [force = true | false] [on = host_uuid]
Reprenez les machines virtuelles spécifiées.
La ou les machines virtuelles sur lesquelles cette opération est effectuée sont sélectionnées à l’aide du mécanisme de sélection standard. Pour plus d’informations, voir sélecteurs de machines virtuelles. Les arguments facultatifs peuvent être n’importe quel nombre de paramètres VMrépertoriés au début de cette section.
Si la machine virtuelle se trouve sur une SR partagée dans un pool d’hôtes, utilisez l’on
argument pour spécifier le membre de pool sur lequel démarrer. Par défaut, le système détermine un hôte approprié, qui peut être l’un des membres du pool.
vm-retrieve-wlb-recommendations
vm-retrieve-wlb-recommendations
Récupérer les recommandations d’équilibrage de charge de travail pour la machine virtuelle sélectionnée.
vm-shutdown
vm-shutdown [vm-selector = vm_selector_value...] [force = true | false]
Arrêtez la machine virtuelle spécifiée.
La ou les machines virtuelles sur lesquelles cette opération est effectuée sont sélectionnées à l’aide du mécanisme de sélection standard. Pour plus d’informations, voir sélecteurs de machines virtuelles. Les arguments facultatifs peuvent être n’importe quel nombre de paramètres VMrépertoriés au début de cette section.
Utilisez l’force
argument pour provoquer un arrêt ingracieux, similaire à la prise sur un serveur physique.
vm-snapshot
vm-snapshot new-name-label = name_label [new-nom-description + name_description]
Instantané une machine virtuelle existante, à l’aide d’une opération d’instantané de disque rapide au niveau du stockage, le cas échéant.
vm-snapshot-with-quiesce
vm-snapshot-with-quiesce new-name-label = name_label [new-nom-description + name_description]
Instantané une machine virtuelle existante avec le mode de repos, à l’aide d’une opération rapide d’instantané de disque au niveau du stockage, le cas échéant.
vm-start
vm-start [vm-selector = vm_selector_value...] [force = true | false] [on = host_uuid] [— multiple]
Démarrez les machines virtuelles spécifiées.
La ou les machines virtuelles sur lesquelles cette opération est effectuée sont sélectionnées à l’aide du mécanisme de sélection standard. Pour plus d’informations, voir sélecteurs de machines virtuelles. Les arguments facultatifs peuvent être n’importe quel nombre de paramètres VMrépertoriés au début de cette section.
Si les machines virtuelles se trouvent sur une SR partagée dans un pool d’hôtes, utilisez l’on
argument pour spécifier le membre de pool sur lequel démarrer les machines virtuelles. Par défaut, le système détermine un hôte approprié, qui peut être l’un des membres du pool.
vm-suspend
vm-suspend [vm-selector = vm_selector_value...]
Suspendre la machine virtuelle spécifiée.
La ou les machines virtuelles sur lesquelles cette opération est effectuée sont sélectionnées à l’aide du mécanisme de sélection standard. Pour plus d’informations, voir sélecteurs de machines virtuelles. Les arguments facultatifs peuvent être n’importe quel nombre de paramètres VMrépertoriés au début de cette section.
vm-uninstall
vm-uninstall [vm-selector = vm_selector_value...] [force = true | false]
Désinstallez une machine virtuelle, détruisant ses disques (les VDI marqués RW et connectés à cette machine virtuelle uniquement) ainsi que son enregistrement de métadonnées. Pour détruire uniquement les métadonnées de la machine virtuelle, utilisezxe vm-destroy
.
La ou les machines virtuelles sur lesquelles cette opération est effectuée sont sélectionnées à l’aide du mécanisme de sélection standard. Pour plus d’informations, voir sélecteurs de machines virtuelles. Les arguments facultatifs peuvent être n’importe quel nombre de paramètres VMrépertoriés au début de cette section.
vm-unpause
vm-unpause
Désinterrompue une machine virtuelle en pause.
vm-vcpu-hotplug
vm-vcpu-hotplug new-vcpus = new_vcpu_count [vm-selector = vm_selector_value...]
Ajustez dynamiquement le nombre de vCPU disponibles pour une machine virtuelle Linux PV ou HVM en cours d’exécution. Le nombre de vCPU est limité par le paramètreVCPUs-max
. Les machines virtuelles Windows s’exécutent toujours avec le nombre de vCPU défini surVCPUs-max
et doit être redémarré pour modifier cette valeur.
Les machines virtuelles Linux PV ou HVM sur lesquelles cette opération est effectuée sont sélectionnées à l’aide du mécanisme de sélection standard. Pour plus d’informations, voir sélecteurs de machines virtuelles. Les arguments facultatifs peuvent être n’importe quel nombre de paramètres VMrépertoriés au début de cette section.
Note :
Lorsque vous exécutez des machines virtuelles Linux sans installation, exécutez la commande suivante sur la machine virtuelle afin de
root
vous assurer que les vCPU nouvellement branchés à chaud sont utilisés :# for i in /sys/devices/system/cpu/cpu[1-9]*/online; do if [ "$(cat $i)" = 0 ]; then echo 1 > $i; fi; done
vm-vif-list
vm-vif-list [vm-selector = vm_selector_value...]
Répertorie les VIF des machines virtuelles spécifiées.
La ou les machines virtuelles sur lesquelles cette opération est effectuée sont sélectionnées à l’aide du mécanisme de sélection standard. Pour plus d’informations, voir sélecteurs de machines virtuelles. Les sélecteurs fonctionnent sur les enregistrements VM lors du filtrage, et non sur les valeurs VIF. Les arguments facultatifs peuvent être n’importe quel nombre de paramètres VMrépertoriés au début de cette section.
Instantanés planifiés
Commandes pour contrôler les snapshots shceduled VM et leurs attributs.
Les objets vmss peuvent être répertoriés avec la commande de listage d’objets standard (xe vmss-list
) et les paramètres manipulés avec les commandes de paramètres standard. Pour plus d’informations, voir [Comman#low-level-parameter-commands()des de paramètres de bas niveau]
vmss-create
vmss-create enabled = Vraie/False nom-label = type de nom = type fréquence = fréquence retenued-snapshots = valeur nom-description = description planification : planning
Crée une planification d’instantanés dans le pool.
Par exemple :
xe vmss-create retained-snapshots = 9 enabled = true frequency = daily \
name-description = sample name-label = samplepolicy type = snapshot \
horaire : heure = 10 horaire : min = 30
Les programmes d’instantanés ont les paramètres suivants :
Nom du paramètre | Description | Tapez |
---|---|---|
name-label |
Nom de la planification de l’instantané. | Lecture/écriture |
name-description |
Description de la planification de l’instantané. | Lecture/écriture |
type |
Instantané de disque ; Instantané mémoire ; Instantané en repos | Lecture/écriture |
frequency |
Horaire ; Quotidien ; Hebdomadaire | Lecture/écriture |
retained-snapshots |
Instantanés à conserver. Portée : 1-10. | Lecture/écriture |
schedule |
schedule:days ( lundi au dimanche),schedule:hours (0 à 23),schedule:minutes (0, 15, 30, 45) |
Lecture/écriture |
vmss-destroy
vmss-destroy uuid = uuid
Détruit une planification d’instantanés dans le pool.
Passthrough USB
Activer/désactiver le passage USB
pusb-param-set uuuid = pusb_uuid passthrough enabled = true/false
Activer/désactiver le passage USB.
pusb-scan
pusb-scan host-uuid = host_uuid
Analyser le PUSB et la mise à jour.
vusb-create
vusb-create usb-group-uuid = usb_group_uuid vm-uid = vm_uuid
Crée un USB virtuel dans le pool. Démarrez la machine virtuelle pour passer par l’USB à la machine virtuelle.
vusb-unplug
vusb-unplug uuid = vusb_uuid
Débranche USB de la machine virtuelle.
vusb-destroy
vusb-destroy uuid = vusb_uuid
Supprime la liste USB virtuelle de la machine virtuelle.
Dans cet article
- Syntaxe xe de base
- Caractères spéciaux et syntaxe
- Types de commandes
- référence de commande xe
- Commandes de l’appliance
- Commandes d’audit
- Commandes de liaison
- Commandes CD
- Commandes de cluster
- Commandes de la console
- Commandes de diagnostic
- Commandes de reprise après sinistre
- Commandes d’événement
- Commandes GPU
- Commandes de l’hôte
- Commandes de journal
- Commandes de message
- Commandes réseau
- Commandes du contrôleur SDN
- Commandes de tunnel
- Commandes de correctifs
- Commandes PBD
- Commandes PIF
- Commandes de pool
- Commandes PVS Accelerator
- Commandes Storage Manager
- Commandes instantanés
- Commandes SR
- Commandes d’objet
- Commandes de tâche
- Commandes de modèle
- Commandes de mise à jour
- Commandes utilisateur
- Commandes VBD
- Commandes VDI
- Commandes VIF
- Commandes VLAN
- Commandes VM