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 :

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

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 :

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 :

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 :

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 :

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 commandesr-whitelist répertorie les UUID SR. La drtask-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 :

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 :

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 :

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 :

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 :

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 :

contiennent d’autres objets qui ont également des listes de paramètres.

Les processeurs des hôtes ont les paramètres suivants :

Les vidages sur les hôtes ont les paramètres suivants :

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 laxe 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 à laxe 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.

• keyIdentificateur 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-sizeIndique une plage approximative de la taille, en octets, de cette entrée. -1 indique que la taille est sans importance.
• min-time,max-timeIndiquez une plage approximative pour le temps, en secondes, pris pour collecter cette entrée. -1 indique que l’heure n’est pas importante.

• Informationspii 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 laxe 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. Permetxe 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 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 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 lastandard 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

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 :

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 :

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 :

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 :

Note :

Les modifications apportées auxother-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 :

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. Permetxe 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 :

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 :

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 :

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 leis-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îneuser-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émarrageVCPUs-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-forme

  Pour 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 :

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 :

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 :

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 lavirtual-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 lavdi-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 lavdi-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 lamtu 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 QoSqos_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 surdisabled, 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=haltedsélectionne des machines virtuelles dont lepower-stateparamè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îneuser-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émarrageVCPUs-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-forme

  Pour 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ôtespossible-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 binairesblobs (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 utilisantvif-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’--forceoption 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 deroot 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 :

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.