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 intégrer HASH (0x2c1a078) dans une infrastructure informatique existante.

Installation de l’interface de ligne de commande xe

L’interface de ligne de commande xe est installée par défaut sur tous les serveurs HASH (0x2e68218) et est incluse avec HASH (0x2e6c8e8). Une CLI distante autonome est également disponible pour Linux.

Sur Windows

Sous Windows, laxe.exe commande est installée avec HASH (0x2e6c8e8).

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\HASH(0x2e6cb58)\HASH(0x2e6c8e8) ). 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.

Sous Linux

Sur les distributions basées sur RPM (telles que Red Hat), vous pouvez installer la commande xe autonome à partir du RPM nomméclient_install/xapi-xe-BUILD.x86_64.rpm sur l’ISO d’installation principale HASH (0x2c1a078).

Pour installer à partir du RPM, utilisez la commande suivante :

rpm -ivh xapi-xe-BUILD.x86_64.rpm

Vous pouvez utiliser les paramètres de la ligne de commande pour définir le serveur HASH (0x2c1a078), le nom d’utilisateur et le mot de passe à utiliser lors de l’exécution de commandes xe. Toutefois, vous avez également la possibilité de définir ces informations en tant que variable d’environnement. Par exemple :

export XE_EXTRA_ARGS="server=<host name>,username=<user name>,password=<password>"

Note :

L’interface de ligne de commande xe distante sous Linux peut se bloquer lorsque vous tentez d’exécuter des commandes sur une connexion sécurisée et ces commandes impliquent un transfert de fichiers. Si tel est le cas, vous pouvez utiliser le--no-ssl paramètre pour exécuter la commande sur une connexion non sécurisée au serveur HASH (0x2c1a078).

Obtenir de l’aide sur les commandes xe

L’aide de base est disponible pour les commandes CLI sur l’hôte en tapant :

xe help command

Une liste des commandes xe les plus couramment utilisées s’affiche si vous tapez :

xe help

Ou une liste de toutes les commandes xe s’affiche si vous tapez :

xe help --all

Syntaxe xe de base

La syntaxe de base de toutes les commandes CLI HASH (0x2c1a078) xe est la suivante :

xe command-name argument=value argument=value

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 optionnel peut être utilisé pour spécifier le port de l’agent sur le serveur HASH distant (0x2e68218) (valeur par défaut 443).

Exemple : Sur le serveur HASH local (0x2e68218) :

xe vm-list

Exemple : Sur le serveur HASH distant (0x2e68218) :

xe vm-list -user username -password password -server hostname

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 serveur HASH distant (0x2e68218) :

xe vm-list -u myuser -pw mypassword -s hostname

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 qui sont exécutées sur un serveur HASH distant (0x2e68218), exécutez d’abord la commande suivante :

export XE_EXTRA_ARGS="server=jeffbeck,port=443,username=root,password=pass"

Après avoir exécuté cette commande, vous n’avez plus besoin de spécifier les paramètres de serveur HASH (0x2e68218) distants 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 serveur HASH distant (0x2e68218), 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=value

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="value with spaces"

Lorsque vous utilisez l’interface de ligne de commande sur votre serveur HASH (0x2e68218), les commandes ont une fonctionnalité de saisie de tabulation 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 serveur HASH distant (0x2e68218). 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

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 :

    user-version ( 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 :

    platform (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 uuid=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 :

allowed-VBD-devices (SRO): <expensive field>

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="BIOS order" power-state=halted

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

Secrets

HASH (0x2c1a078) fournit un mécanisme de secrets pour éviter que les mots de passe soient stockés en texte brut dans l’historique de ligne de commande ou sur des objets API. HASH (0x2e6c8e8) utilise cette fonctionnalité automatiquement et peut également être utilisée à partir de l’interface de ligne de commande xe pour toute commande nécessitant un mot de passe.

Remarque

Les secrets de mot de passe ne peuvent pas être utilisés pour s’authentifier avec un hôte HASH (0x2c1a078) à partir d’une instance distante de l’interface de ligne de commande xe.

Pour créer un objet secret, exécutez la commande suivante sur votre hôte HASH (0x2e68218).

xe secret-create value=my-password

Un secret est créé et stocké sur l’hôte HASH (0x2c1a078). La commande génère l’UUID de l’objet secret. Par exemple,99945d96-5890-de2a-3899-8c04ef2521db. Ajoutez_secret au nom de l’argument mot de passe pour transmettre cet UUID à toute commande nécessitant un mot de passe.

Exemple : Sur l’hôte HASH (0x2e68218) où vous avez créé le secret, vous pouvez exécuter la commande suivante :

    xe sr-create device-config:location=sr_address device-config:type=cifs device-config:username=cifs_username  \
    device-config:cifspassword_secret=secret_uuid name-label="CIFS ISO SR" type="iso" content-type="iso" shared="true"

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, reportez-vous à la section vApps.

Paramètres de l’appliance

Les commandes de l’appliance ont les paramètres suivants :

Nom du paramètre Description Type
uuid UUID de l’appliance Obligatoire
name-description Description de l’appliance Facultatif
paused   Facultatif
force Forcer l’arrêt Facultatif

appliance-assert-can-be-recovered

appliance-assert-can-be-recovered uuid=appliance-uuid database:vdi-uuid=vdi-uuid

Teste si le stockage est disponible pour récupérer cette machine virtuelle/vApp.

appliance-create

appliance-create name-label=name-label [name-description=name-description]

Crée une Appliance/VApp. Par exemple :

xe appliance-create name-label=my_appliance

Ajouter des machines virtuelles à l’appliance :

    xe vm-param-set uuid=VM-UUID appliance=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=appliance-uuid database:vdi-uuid=vdi-uuid [paused=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 uuid=appliance-uuid [force=true|false]

Arrête toutes les machines virtuelles d’une Appliance/VApp. Par exemple :

xe appliance-shutdown uuid=appliance-uuid

appliance-start

appliance-start uuid=appliance-uuid [paused=true|false]

Démarre une Appliance/VApp. Par exemple :

xe appliance-start uuid=appliance-uuid

Commandes d’audit

Les commandes d’audit téléchargent tous les enregistrements disponibles du fichier d’audit RBAC dans le pool. Si le paramètre optionnelsince est présent, il ne télécharge que les enregistrements à partir de ce point précis dans le temps.

audit-log-get paramètres

audit-log-get a les paramètres suivants

Nom du paramètre Description Type
filename Ecrire le journal d’audit du pool dans le nom de fichier Obligatoire
since Date/heure spécifique Facultatif

audit-log-get

audit-log-get [since=timestamp] filename=filename

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-24T17:56:20.530Z filename=/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 Gestion des réseaux.

L’objet de liaison est un objet de référence qui colle ensemble les PIF maître et membre . Le PIF principal est l’interface de liaison qui doit être utilisée comme FRP global pour faire référence à la liaison. Les PIF membres sont un ensemble de deux interfaces physiques ou plus qui ont été combinées dans l’interface liée de haut niveau.

Paramètres de liaison

Les obligations ont les paramètres suivants :

Nom du paramètre Description Type
uuid Identifiant/référence d’objet unique pour le lien Lecture seule
master UUID pour le FRP de l’obligation principale Lecture seule
members Ensemble d’UUID pour les PIF liés sous-jacents Lecture seule

bond-create

bond-create network-uuid=network_uuid pif-uuids=pif_uuid_1,pif_uuid_2,...

Créez une interface réseau liée sur le réseau spécifié à partir d’une liste d’objets PIF existants. La commande échoue dans l’un des cas suivants :

  • Si les FRP sont déjà dans une autre obligation
  • Si un membre a un jeu de balises VLAN
  • Si les PIF référencés ne sont pas sur le même serveur HASH (0x2e68218)
  • 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 serveurs HASH (0x2e68218).

Paramètres du CD

Les CD ont les paramètres suivants :

Nom du paramètre Description Type
uuid Identifiant/référence d’objet unique pour le CD Lecture seule
name-label Nom du CD Lecture/écriture
name-description Texte de description pour le CD Lecture/écriture
allowed-operations Une liste des opérations qui peuvent être effectuées sur ce CD Paramètre en lecture seule
current-operations Une liste des opérations en cours sur cette CD Paramètre en lecture seule
sr-uuid La référence identifiant/objet unique pour la SR que ce CD fait partie de Lecture seule
sr-name-label Le nom de la SR ce CD fait partie de Lecture seule
vbd-uuids Liste des identifiants uniques pour les VBD sur les machines virtuelles qui se connectent à ce CD Paramètre en lecture seule
crashdump-uuids Non utilisé sur les CD. Parce que les crashdumps ne peuvent pas être écrits sur des CD Paramètre en lecture seule
virtual-size Taille du CD telle qu’elle apparaît aux machines virtuelles (en octets) Lecture seule
physical-utilisation Quantité d’espace physique que l’image du CD occupe sur le SR (en octets) Lecture seule
type Définir sur Utilisateur pour CD Lecture seule
sharable Indique si le lecteur de CD est partageable ou non. La valeur par défaut estfalse. Lecture seule
read-only Si le CD est en lecture seule, sifalse, le périphérique est accessible en écriture. Toujours vrai pour les CD. Lecture seule
storage-lock La valeur esttrue si ce disque est verrouillé au niveau du stockage. Lecture seule
parent Référence au disque parent, si ce CD fait partie d’une chaîne. Lecture seule
missing La valeur esttrue si l’opération d’analyse SR a signalé que ce CD n’était pas présent sur le disque Lecture seule
other-config Une liste de paires clé/valeur qui spécifient des paramètres de configuration supplémentaires pour le CD Paramètre de mappage en lecture/écriture
location Chemin d’accès sur lequel le périphérique est installé Lecture seule
managed La valeur esttrue si le périphérique est géré Lecture seule
xenstore-data Données à insérer dans l’arborescence xenstore Paramètre de mappage en lecture seule
sm-config Noms et descriptions des clés de configuration des périphériques du gestionnaire de stockage Paramètre de mappage en lecture seule
is-a-snapshot La valeur esttrue si ce modèle est un instantané de CD Lecture seule
snapshot_of UUID du CD que ce modèle est un instantané de Lecture seule
snapshots UUID de tous les instantanés qui ont été pris de ce CD Lecture seule
snapshot_time Horodatage de l’opération de cliché Lecture seule

cd-list

cd-list [params=param1,param2,...] [parameter=parameter_value]

Répertorier les CD et les ISO (fichiers image CD) sur le serveur ou le pool HASH (0x2e68218), 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 du CD ré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 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, reportez-vous à la section Commandes de paramètres de bas niveau. Commandes pour travailler avec des pools en cluster.

Paramètres du cluster

Les clusters ont les paramètres suivants :

Nom du paramètre Description Type
uuid Identifiant/référence d’objet unique pour le cluster Lecture seule
cluster-hosts Une liste d’identificateurs/références d’objet uniques pour les hôtes du cluster Paramètre en lecture seule
cluster-token La clé secrète utilisée par xapi-clusterd quand il parle à lui-même sur d’autres hôtes Lecture seule
cluster-stack La pile technologique fournissant les capacités de clustering. Les valeurs possibles sontcorosync. Lecture seule
allowed-operations Répertorie les opérations autorisées dans cet état. Cette liste est purement consultative et l’état du cluster peut avoir changé au moment où un client lit ce champ. Paramètre en lecture seule
current-operations Répertorie les opérations en cours. Cette liste est purement consultative et l’état du cluster peut avoir changé au moment où un client lit ce champ. Paramètre en lecture seule
token-timeout Le délai d’expiration du jeton corosync en secondes Lecture seule
token-timeout-coefficient Coefficient de délai d’expiration du jeton corosync en secondes Lecture seule
pool-auto-join Cette propriété a la valeur True si vous joignez automatiquement de nouveaux membres de pool au cluster. Ceci est réglé surtrue. Lecture seule
cluster-config Liste de paires clé/valeur qui spécifient des paramètres de configuration supplémentaires pour le cluster. Paramètre de mappage en lecture seule
other-config Liste de paires clé/valeur qui spécifient des paramètres de configuration supplémentaires pour le cluster. Paramètre de mappage en lecture/écriture

cluster-host-create

cluster-host-create cluster-uuid=cluster_uuid host-uuid=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, reportez-vous à la section Commandes de paramètres de bas niveau.

Paramètres de la console

Les consoles ont les paramètres suivants :

Nom du paramètre Description Type
uuid Identifiant/référence d’objet unique pour la console Lecture seule
vm-uuid La référence identifiant/objet unique de la machine virtuelle que cette console est ouverte sur Lecture seule
vm-name-label Le nom de la machine virtuelle que cette console est ouverte sur Lecture seule
protocol Protocole utilisé par cette console. Les valeurs possibles sontvt100 : terminal VT100,rfb : protocole distant Framebuffer (tel qu’il est utilisé dans VNC), ourdp : protocole Bureau à distance Lecture seule
location URI pour le service de console Lecture seule
other-config Liste de paires clé/valeur qui spécifient des paramètres de configuration supplémentaires pour la console. Paramètre de mappage en lecture/écriture

console

console

Attachez à une console particulière.

Commandes de diagnostic

Commandes pour collecter des informations de diagnostic à partir de HASH (0x2c1a078).

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-license-status

Aide à diagnostiquer les problèmes de licence à l’échelle du pool.

diagnostic-net-stats

diagnostic-net-stats [uri=uri] [method=method] [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-uuid

Détruit une tâche de reprise après sinistre et oublie la SR introduite.

vm-assert-can-be-recovered

vm-assert-can-be-recovered uuid=vm-uuid database: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-recovered uuid=appliance-uuid database:vdi-uuid=vdi-uuid

Vérifie si le stockage (contenant le disque VApp de l’appliance) est visible.

appliance-recover

appliance-recover uuid=appliance-uuid database: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=vm-uuid database: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 uuid=sr_uuid

Active la réplication de base de données XAPI vers le SR spécifié (partagé).

sr-disable-database-replication

sr-disable-database-replication uuid=sr_uuid

Désactive la réplication de base de données XAPI vers le SR spécifié.

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 uuid=sr=uuid

Après un sinistre, sur le site secondaire, connectez-vous à la SR. La commande device-config a les mêmes champs que sr-probe.

xe drtask-create type=lvmoiscsi \
    device-config:target=target ip address \
    device-config:targetIQN=target-iqn \
    device-config:SCSIid=scsi-id \
    sr-whitelist=sr-uuid

Recherchez les VDI de base de données sur le SR :

xe vdi-list sr-uuid=sr-uuid type=Metadata

Interrogez un VDI de base de données pour les machines virtuelles présentes :

xe vm-list database:vdi-uuid=vdi-uuid

Récupérer une machine virtuelle :

xe vm-recover uuid=vm-uuid database:vdi-uuid=vdi-uuid

Détruisez la tâche de reprise après sinistre. Tous les SR introduits par la tâche DR et non requis par les machines virtuelles sont détruits :

xe drtask-destroy uuid=drtask-uuid

Commandes d’événement

Commandes pour travailler avec des événements.

Classes d’événements

Les classes d’événements sont répertoriées dans le tableau suivant :

Nom de la classe Description
pool Un pool d’hôtes physiques
vm Une machine virtuelle
host Un hôte physique
network Un réseau virtuel
vif Une interface réseau virtuelle
pif Une interface réseau physique (les VLAN séparés sont représentés sous la forme de plusieurs PIF)
sr Un référentiel de stockage
vdi Une image de disque virtuel
vbd Un périphérique de bloc virtuel
pbd Périphériques de blocs physiques via lesquels les hôtes accèdent aux SR

event-wait

event-wait class=class_name [param-name=param_value] [param-name=/=param_value]

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=running

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 uuid=$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 n’importe lequel des nomsclasses d’événementsrépertoriés 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, reportez-vous à la section Commandes de paramètres de bas niveau.

Paramètres GPU physiques

Les GPU physiques (PGPU) ont les paramètres suivants :

Nom du paramètre Description Type
uuid Identifiant/référence d’objet unique pour le PGPU Lecture seule
vendor-name Nom du fournisseur du PGPU Lecture seule
device-name Nom attribué par le fournisseur à ce modèle PGPU Lecture seule
gpu-group-uuid Référence identifiant/objet unique pour le groupe GPU auquel ce PGPU a été automatiquement assigné par HASH (0x2c1a078). Les PGPU identiques sur les hôtes d’un pool sont regroupés Lecture seule
gpu-group-name-label Nom du groupe GPU auquel le PGPU est affecté Lecture seule
host-uuid Référence identifiant/objet unique pour le serveur HASH (0x2e68218) auquel le PGPU est connecté Lecture seule
host-name-label Nom du serveur HASH (0x2e68218) auquel le PGPU est connecté Lecture seule
pci-id Identificateur PCI Lecture seule
dependencies Répertorie les périphériques PCI dépendants transmis à la même machine virtuelle Paramètre de mappage en lecture/écriture
other-config Une liste de paires clé/valeur qui spécifient des paramètres de configuration supplémentaires pour le PGPU Paramètre de mappage en lecture/écriture
supported-VGPU-types Liste des types de GPU virtuels pris en charge par le matériel sous-jacent Lecture seule
enabled-VGPU-types Liste des types de GPU virtuels qui ont été activés pour ce PGPU Lecture/écriture
resident-VGPUs Liste des VGPU fonctionnant sur ce PGPU Lecture seule

pgpu-disable-dom0-access

pgpu-disable-dom0-access uuid=uuid

Désactivez l’accès PGPU à dom0.

pgpu-enable-dom0-access

pgpu-enable-dom0-access uuid=uuid

Activer l’accès PGPU à dom0.

Paramètres du groupe GPU

Les groupes GPU ont les paramètres suivants :

Nom du paramètre Description Type
uuid Identifiant/référence d’objet unique pour le groupe GPU Lecture seule
name-label Le nom du groupe GPU Lecture/écriture
name-description Le texte descriptif du groupe GPU Lecture/écriture
VGPU-uuids Répertorie les références d’identificateur/objet uniques pour les GPU virtuels dans le groupe GPU Paramètre en lecture seule
PGPU-uuids Répertorie les références d’identificateur/objet uniques pour les PGPU dans le groupe GPU Paramètre en lecture seule
other-config Une liste de paires clé/valeur qui spécifient des paramètres de configuration supplémentaires pour le groupe GPU Paramètre de mappage en lecture/écriture
supported-VGPU-types Union de tous les types de GPU virtuels pris en charge par le matériel sous-jacent Lecture seule
enabled-VGPU-types Union de tous les types de GPU virtuels activés sur les PGPU sous-jacents Lecture seule
allocation-algorithm Depth-First/Breadth -first paramètre pour l’allocation de GPU virtuels sur les PGPU au sein du groupe Paramètre enum en lecture/écriture

Opérations du groupe GPU

Commandes pour travailler avec des groupes GPU

gpu-group-create
gpu-group-create name-label=name_for_group [name-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 uuid=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 uuid=uuid_of_group param-name=supported-vGPU-types|enabled-vGPU-types

Renvoie les types pris en charge ou activés pour ce groupe GPU.

Paramètres GPU virtuels

Les GPU virtuels ont les paramètres suivants :

Nom du paramètre Description Type
uuid Identifiant/référence d’objet unique pour le GPU virtuel Lecture seule
vm-uuid Référence identifiant/objet unique pour la machine virtuelle à laquelle le GPU virtuel est affecté Lecture seule
vm-name-label Nom de la machine virtuelle à laquelle le GPU virtuel est affecté Lecture seule
gpu-group-uuid Référence identifiant/objet unique pour le groupe GPU dans lequel le GPU virtuel est contenu Lecture seule
gpu-group-name-label Nom du groupe GPU dans lequel le GPU virtuel est contenu Lecture seule
currently-attached True si une machine virtuelle avec GPU Pass-Through est en cours d’exécution, false sinon Lecture seule
other-config Une liste de paires clé/valeur qui spécifient des paramètres de configuration supplémentaires pour le GPU virtuel Paramètre de mappage en lecture/écriture
type-uuid Identifiant/référence d’objet unique pour le type de GPU virtuel de ce GPU virtuel Paramètre de mappage en lecture/écriture
type-model-name Nom du modèle associé au type GPU virtuel Lecture seule

Paramètres de type GPU virtuel

Note :

Les GPU Passthrough et les GPU virtuels ne sont pas compatibles avec la migration en direct, la migration en direct du stockage ou la suspension de la machine virtuelle, sauf si des logiciels et des cartes graphiques pris en charge par les fournisseurs de 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 la migration en direct, la migration en direct du stockage et la suspension de la machine virtuelle, reportez-vous à la sectionGraphiques.

Les types de GPU virtuels ont les paramètres suivants :

Nom du paramètre Description Type
uuid Identifiant/référence d’objet unique pour le type de GPU virtuel Lecture seule
vendor-name Nom du fournisseur de GPU virtuel Lecture seule
model-name Nom du modèle associé au type GPU virtuel Lecture seule
freeze-frame Taille de la mémoire tampon du type GPU virtuel, en octets Lecture seule
max-heads Nombre maximal d’écrans pris en charge par le type GPU virtuel Lecture seule
supported-on-PGPUs Liste des PGPU qui prennent en charge ce type de GPU virtuel Lecture seule
enabled-on-PGPUs Liste des PGPU pour lesquels ce type de GPU virtuel est activé Lecture seule
VGPU-uuids Liste des GPU virtuels de ce type Lecture seule

Opérations GPU virtuelles

vgpu-create

vgpu-create vm-uuid=uuid_of_vm gpu_group_uuid=uuid_of_gpu_group [vgpu-type-uuid=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 le serveur HASH (0x2e68218).

Les serveurs HASH (0x2e68218) sont les serveurs physiques exécutant le logiciel HASH (0x2c1a078). 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 serveur HASH (0x2e68218) peuvent être répertoriés avec les commandes de liste d’objets standard :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, reportez-vous à la section 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 serveurs HASH (0x2e68218) sur lesquels effectuer l’opération. Le plus simple est de fournir l’argumenthost=uuid_or_name_label. Vous pouvez également spécifier HASH (0x2e68218) en filtrant la liste complète des hôtes sur les valeurs des champs. Par exemple, la spécificationenabled=true sélectionne tous les serveurs HASH (0x2e68218) dontenabled le champ est égal àtrue . Lorsque plusieurs serveurs HASH (0x2e68218) correspondent et que l’opération peut être effectuée sur plusieurs serveurs HASH (0x2e68218), 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 pour sélectionner les serveurs HASH (0x2e68218) n’est donné, l’opération est effectuée sur tous les serveurs HASH (0x2e68218).

Paramètres de l’hôte

Les serveurs HASH (0x2e68218) ont les paramètres suivants :

Nom du paramètre Description Type
uuid Référence identifiant/objet unique pour le serveur HASH (0x2e68218) Lecture seule
name-label Le nom du serveur HASH (0x2e68218) Lecture/écriture
name-description La chaîne de description du serveur HASH (0x2e68218) Lecture seule
enabled La valeur estfalse si désactivée. Cela empêche les nouvelles machines virtuelles de démarrer sur les hôtes et prépare les hôtes à arrêter ou à redémarrer. La valeur esttrue si l’hôte est activé Lecture seule
API-version-major Numéro de version principal Lecture seule
API-version-minor Numéro de version mineur Lecture seule
API-version-vendor Identification du fournisseur d’API Lecture seule
API-version-vendor-implementation Détails de la mise en œuvre du fournisseur Paramètre de mappage en lecture seule
logging Configuration de journalisation Paramètre de mappage en lecture/écriture
suspend-image-sr-uuid Référence identifiant/objet unique pour le SR où les images suspendues sont placées Lecture/écriture
crash-dump-sr-uuid Référence identifiant/objet unique pour le SR où les vidages de plantage sont placés Lecture/écriture
software-version Liste des paramètres de versioning et de leurs valeurs Paramètre de mappage en lecture seule
capabilities Liste des versions Xen que le serveur HASH (0x2e68218) peut exécuter Paramètre en lecture seule
other-config Une liste de paires clé/valeur qui spécifient des paramètres de configuration supplémentaires pour le serveur HASH (0x2e68218) Paramètre de mappage en lecture/écriture
chipset-info Une liste de paires clé/valeur qui spécifient des informations sur le chipset Paramètre de mappage en lecture seule
hostname Nom d’hôte du serveur HASH (0x2e68218) Lecture seule
address Adresse IP du serveur HASH (0x2e68218) Lecture seule
license-server Liste de paires clé/valeur qui spécifient des informations sur le serveur de licences. Le port par défaut pour les communications avec les produits Citrix est 27000. Pour plus d’informations sur la modification des numéros de port en raison de conflits, voirModifier les numéros de port Paramètre de mappage en lecture seule
supported-bootloaders Liste des chargeurs d’amorçage pris en charge par le serveur HASH (0x2e68218), par exemple, pygrub, eliloader Paramètre en lecture seule
memory-total Quantité totale de RAM physique sur le serveur HASH (0x2e68218), en octets Lecture seule
memory-free Quantité totale de RAM physique restante pouvant être allouée aux machines virtuelles, en octets Lecture seule
host-metrics-live True si l’hôte est opérationnel Lecture seule
logging La clé syslog_destination peut être définie sur le nom d’hôte d’un service syslog à l’écoute distante. Paramètre de mappage en lecture/écriture
allowed-operations Répertorie les opérations autorisées dans cet état. Cette liste est purement consultative et l’état du serveur peut avoir changé au moment où un client lit ce champ. Paramètre en lecture seule
current-operations Répertorie les opérations en cours. Cette liste est purement consultative et l’état du serveur peut avoir changé au moment où un client lit ce champ. Paramètre en lecture seule
patches Ensemble de patchs hôtes Paramètre en lecture seule
blobs Magasin de données binaires Lecture seule
memory-free-computed Estimation prudente de la quantité maximale de mémoire libre sur un hôte Lecture seule
ha-statefiles UUID de tous les fichiers d’état HA Lecture seule
ha-network-peers UUID de tous les hôtes pouvant héberger les machines virtuelles sur cet hôte en cas d’échec Lecture seule
external-auth-type Type d’authentification externe, par exemple, Active Directory. Lecture seule
external-auth-service-name Nom du service d’authentification externe Lecture seule
external-auth-configuration Informations de configuration pour le service d’authentification externe. Paramètre de mappage en lecture seule

Les serveurs HASH (0x2e68218) contiennent d’autres objets qui ont également des listes de paramètres.

Les processeurs des serveurs HASH (0x2e68218) ont les paramètres suivants :

Nom du paramètre Description Type
uuid Identifiant/référence d’objet unique pour le processeur Lecture seule
number Le numéro du cœur du processeur physique dans le serveur HASH (0x2e68218) Lecture seule
vendor Chaîne fournisseur pour le nom du processeur Lecture seule
speed La vitesse d’horloge du processeur, en Hz Lecture seule
modelname Chaîne fournisseur pour le modèle de processeur, par exemple, « Intel (R) Xeon (TM) CPU 3.00 GHz » Lecture seule
stepping Numéro de révision du CPU Lecture seule
flags Les drapeaux de la CPU physique (une version décodée du champ d’entités) Lecture seule
Utilisation L’utilisation actuelle du processeur Lecture seule
host-uuid UUID si l’hôte dans lequel se trouve le CPU Lecture seule
model Numéro de modèle du CPU physique Lecture seule
family Numéro de famille de CPU physique Lecture seule

Les vidages de crash sur les serveurs HASH (0x2e68218) ont les paramètres suivants :

Nom du paramètre Description Type
uuid Référence identifiant/objet unique pour le crashdump Lecture seule
host Serveur HASH (0x2e68218) auquel le crashdump correspond Lecture seule
timestamp Horodatage de la date et de l’heure auxquelles le crashdump s’est produit, sous la formeyyyymmdd-hhmmss-ABC, où ABCest l’indicateur de fuseau horaire, par exemple GMT Lecture seule
size Taille du crashdump, en octets Lecture seule

host-all-editions

host-all-editions

Obtenir une liste de toutes les éditions disponibles

host-apply-edition

host-apply-edition [host-uuid=host_uuid] [edition=xenserver_edition="free" "per-socket" "xendesktop"]

Affecte la licence HASH (0x2e68218) à un serveur hôte. Lorsque vous attribuez une licence, HASH (0x2c1a078) 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 les éditions HASH (0x2c1a078) pour Citrix Virtual Desktops, utilisez"xendesktop".

Pour la configuration initiale des licences, reportez-vous également à la sectionlicense-server-address etlicense-server-port .

host-backup

host-backup file-name=backup_filename host=host_name

Téléchargez une sauvegarde du domaine de contrôle du serveur HASH (0x2e68218) 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 sélecteurs d’hôte ci-dessus). Les arguments facultatifs peuvent être n’importe quel nombre de paramètres de l’hôte répertoriés au début de cette section.

Les paramètres facultatifs sont http-proxy: utilisez le proxy http spécifié et url : chargez 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-memory-overhead

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 du serveur HASH (0x2e68218).

host-crashdump-upload

host-crashdump-upload uuid=crashdump_uuid [url=destination_url] [http-proxy=http_proxy_name]

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 sont http-proxy: utilisez le proxy http spécifié et url : chargez 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 serveurs HASH (0x2e68218) spécifiés, ce qui empêche toute nouvelle VM de démarrer sur eux. Cette action prépare les serveurs HASH (0x2e68218) à 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 (voirsélecteurs d’hôte). Les arguments facultatifs peuvent être n’importe quel nombre de paramètres de l’hôte ré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-storage-caching

Désactivez la mise en cache du stockage local sur l’hôte spécifié.

host-dmesg

host-dmesg [host-selector=host_selector_value...]

Obtenez un Xendmesg (la sortie du tampon de l’anneau du noyau) à partir des serveurs HASH spécifiés (0x2e68218).

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 ci-dessus). Les arguments facultatifs peuvent être n’importe quel nombre de paramètres de l’hôte ré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 ce serveur HASH (0x2e68218). Utilisez cette commande uniquement si le serveur HASH (0x2e68218) 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 serveurs HASH (0x2e68218) 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 sélecteurs d’hôte ci-dessus). Les arguments facultatifs peuvent être n’importe quel nombre de paramètres de l’hôte ré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-storage-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, désactivez l’hôte à l’aide de la commande host-disable.

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, reportez-vous à la section 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, reportez-vous à la section arrêt de l’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 sélecteurs d’hôte ci-dessus). Les arguments facultatifs peuvent être n’importe quel nombre de paramètres de l’hôte répertoriés au début de cette section.

host-forget

host-forget uuid=host_uuid

L’agent XAPI oublie le serveur HASH spécifié (0x2e68218) 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.

Cette commande est utile si le serveur HASH (0x2e68218) à « oublier » est mort. Toutefois, si le serveur HASH (0x2e68218) 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 uuid=uuid

Afficher les informations de diagnostic SM par hôte.

host-get-system-status

host-get-system-status filename=name_for_status_file [entries=comma_separated_list] [output=tar.bz2|zip] [host-selector=host_selector_value...]

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, reportez-vous à la section 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 sélecteurs d’hôte ci-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 :

<?xml version="1.0" ?>
<system-status-capabilities>
    <capability content-type="text/plain" default-checked="yes" key="xenserver-logs"  \
        max-size="150425200" max-time="-1" min-size="150425200" min-time="-1" \
        pii="maybe"/>
    <capability content-type="text/plain" default-checked="yes" \
        key="xenserver-install" max-size="51200" max-time="-1" min-size="10240" \
        min-time="-1" pii="maybe"/>
    ...
</system-status-capabilities>

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 sélecteurs d’hôte ci-dessus).

host-get-thread-diagnostics

host-get-thread-diagnostics uuid=uuid

Afficher les informations de diagnostic de thread par hôte.

host-get-vms-which-prevent-evacuation

host-get-vms-which-prevent-evacuation 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-in-emergency-mode

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=path/license_filename] [host-uuid=host_uuid]

Pour HASH (0x2c1a078) (édition gratuite), utilisez pour analyser un fichier de licence local et l’ajouter au serveur HASH spécifié (0x2e68218).

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 serveur HASH (0x2e68218).

host-logs-download

host-logs-download [file-name=logfile_name] [host-selector=host_selector_value...]

Téléchargez une copie des journaux des serveurs HASH (0x2e68218) 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 sélecteurs d’hôte ci-dessus). Les arguments facultatifs peuvent être n’importe quel nombre de paramètres de l’hôte ré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 le HASH (0x2e6c8e8)). Cette commande fonctionne directement sur le serveur HASH (0x2e68218) 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 serveur HASH membre (0x2e68218).

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 le serveur HASH (0x2e68218) pour utiliser l’interface réseau spécifiée comme interface de gestion, qui est l’interface utilisée pour se connecter au HASH (0x2e6c8e8). 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é, le serveur HASH (0x2e68218) se relie 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é, le serveur HASH (0x2e68218) 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. Utilisez xe pif-reconfigure pour en configurer un en premier. Sinon, les commandes CLI suivantes ne parviennent pas à atteindre le serveur HASH (0x2e68218).

host-power-on

host-power-on [host=host_uuid]

Mettez sous tension les serveurs HASH (0x2e68218) avec la fonction Host Power On 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 serveurs HASH (0x2e68218) 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 sélecteurs d’hôte ci-dessus). Les arguments facultatifs peuvent être n’importe quel nombre de paramètres de l’hôte répertoriés au début de cette section.

Si les serveurs HASH (0x2e68218) 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 serveurs HASH (0x2e68218) retournent. Les autres membres et le maître 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...]

Restaurez une sauvegarde nomméefile-name du logiciel de contrôle de serveur HASH (0x2e68218). 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 sélecteurs d’hôte ci-dessus). Les arguments facultatifs peuvent être n’importe quel nombre de paramètres de l’hôte ré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 du serveur HASH (0x2e68218) 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 du serveur HASH (0x2e68218). 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=ip-address power-on-config:power_on_user=user power-on-config:power_on_password_secret=secret-uuid ]

Permet d’activer la fonction de mise sous tension de l’hôte sur les hôtes HASH (0x2e68218) 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". Pour plus d’informations, reportez-vous à la section Secrets.

host-shutdown

host-shutdown [host-selector=host_selector_value...]

Arrêtez les serveurs HASH (0x2e68218) spécifiés. Les serveurs HASH (0x2e68218) 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 sélecteurs d’hôte ci-dessus). Les arguments facultatifs peuvent être n’importe quel nombre de paramètres de l’hôte répertoriés au début de cette section.

Si les serveurs HASH (0x2e68218) 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 serveurs HASH (0x2e68218) retournent. Les autres membres et le maître 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, reportez-vous à la section 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-sync-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 serveurs HASH (0x2e68218) 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 sélecteurs d’hôte ci-dessus). Les arguments facultatifs peuvent être n’importe quel nombre de paramètres de l’hôte répertoriés au début de cette section.

host-data-source-list

host-data-source-list [host-selectors=host selector value...]

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 de paramètres de l’hôte ré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 a enabled défini sur true, 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 de enabled est également définie sur true 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 de enabled est également définie sur false 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 la commande host-data-source-record. Cette commande définit enabled sur true. Pour arrêter, exécutez le host-data-source-forget. Cette commande définit enabled sur false.

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 de paramètres de l’hôte ré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 de paramètres de l’hôte ré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 de paramètres de l’hôte ré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

log-reopen

Rouvrez tous les enregistreurs (utilisez ceci pour faire pivoter les fichiers).

log-set-output

log-set-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 informer les utilisateurs des événements importants et sont affichés dans HASH (0x2e6c8e8) 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 Commandes de paramètres de bas niveau

Paramètres du message

Nom du paramètre Description Type
uuid Identifiant/référence d’objet unique pour le message Lecture seule
name Le nom unique du message Lecture seule
priority La priorité du message. Les chiffres plus élevés indiquent une plus grande priorité Lecture seule
class La classe de message, par exemple la machine virtuelle. Lecture seule
obj-uuid UUID de l’objet affecté. Lecture seule
timestamp Heure à laquelle le message a été généré. Lecture seule
body Le contenu du message. Lecture seule

message-create

message-create name=message_name body=message_text [[host-uuid=uuid_of_host] | [sr-uuid=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 :

# Dismiss all alerts   \
    IFS=","; for m in $(xe message-list params=uuid --minimal); do  \
    xe message-destroy uuid=$m  \
    done

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 Commandes de paramètres de bas niveau

Paramètres réseau

Les réseaux ont les paramètres suivants :

Nom du paramètre Description Type
uuid Identifiant/référence d’objet unique pour le réseau Lecture seule
name-label Le nom du réseau Lecture/écriture
name-description Le texte de description du réseau Lecture/écriture
VIF-uuids Liste des identificateurs uniques des VIF (interfaces réseau virtuelles) qui sont attachés à partir de machines virtuelles à ce réseau Paramètre en lecture seule
PIF-uuids Liste des identificateurs uniques des PIF (interfaces réseau physiques) qui sont attachés à partir de serveurs HASH (0x2e68218) à ce réseau Paramètre en lecture seule
bridge Nom du pont correspondant à ce réseau sur le serveur HASH local (0x2e68218) Lecture seule
default-locking-mode Objet réseau utilisé avec les objets VIF pour le filtrage ARP. Définissezunlocked sur pour supprimer toutes les règles de filtrage associées au VIF. Réglez surdisabled telle sorte que le VIF supprime tout le trafic. Lecture/écriture
purpose Ensemble d’objectifs pour lesquels le serveur HASH (0x2e68218) utilise ce réseau. Définisseznbd sur pour utiliser le réseau pour établir des connexions NBD. Lecture/écriture
other-config:staticroutes Liste séparée par des virgules d’entrées formatées sous réseaux/masque de réseau/passerellespécifiant l’adresse de passerelle à travers laquelle acheminer les sous-réseaux. Par exemple, la valeurother-config:static-routes 172.16.0.0/15/192 .168.0.3, 172.18.0.0/16/192 .168.0.4 entraîne le routage du trafic sur 172.16.0.0/15 sur 192.168.0.3 et le trafic sur 172.18.0.0/16 sur 192.168.0.4. Lecture/écriture
other-config:ethtoolautoneg Définissez la valeur no pour désactiver l’autonégociation de l’interface physique ou du pont. La valeur par défaut est oui. Lecture/écriture
other-config:ethtool-rx Définir sur on pour activer la somme de contrôle de réception, sur off pour désactiver Lecture/écriture
other-config:ethtool-tx Définir sur on pour activer la somme de contrôle de transmission, sur off pour désactiver Lecture/écriture
other-config:ethtool-sg Définir sur on pour activer la ventilation-regroupement, sur off pour désactiver Lecture/écriture
other-config:ethtool-tso Définir sur on pour activer le déchargement de la segmentation tcp, sur off pour désactiver Lecture/écriture
other-config:ethtool-ufo Définir sur on pour activer le déchargement du fragment UDP, désactivé pour désactiver Lecture/écriture
other-config:ethtool-gso Définir sur on pour activer le déchargement de segmentation générique, sur off pour désactiver Lecture/écriture
blobs Magasin de données binaires Lecture seule

network-create

network-create name-label=name_for_network [name-description=descriptive_text]

Crée un réseau.

network-destroy

network-destroy uuid=network_uuid

Détruit un réseau existant.

Commandes SR-IOV

Commandes pour travailler avec SR-IOV.

Les objets network-sriov peuvent être répertoriés avec la commande de listage d’objets standard (xe network-sriov-list), et les paramètres manipulés avec les commandes de paramètres standard. Pour plus d’informations, voir Commandes de paramètres de bas niveau

Paramètres SR-IOV

SR-IOV a les paramètres suivants :

Nom du paramètre Description Type
physical-PIF Le PIF pour activer SR-IOV. Lecture seule
logical-PIF Un PIF logique SR-IOV. Les utilisateurs peuvent utiliser ce paramètre pour créer un réseau VLAN SR-IOV. Lecture seule
requires-reboot Si défini sur True, utilisé pour redémarrer l’hôte pour activer SR-IOV. Lecture seule
remaining-capacity Nombre de VF disponibles restants. Lecture seule

network-sriov-create

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

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 uuid=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 file-name=file_name

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 le serveur HASH (0x2e68218) accède aux référentiels de stockage (SRs).

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 Commandes de paramètres de bas niveau

Paramètres PBD

Les PBD ont les paramètres suivants :

Nom du paramètre Description Type
uuid Identifiant/référence d’objet unique pour le PBD. Lecture seule
sr-uuid Référentiel de stockage vers lequel le PBD pointe Lecture seule
device-config Informations de configuration supplémentaires fournies au pilote SR-backend-driver d’un hôte Paramètre de mappage en lecture seule
currently-attached True si le SR est attaché à cet hôte, False sinon Lecture seule
host-uuid UUID de la machine physique sur laquelle le PBD est disponible Lecture seule
host Le champ hôte est obsolète. Utilisez host_uuid à la place. Lecture seule
other-config Informations de configuration supplémentaires. Paramètre de mappage en lecture/écriture

pbd-create

pbd-create host-uuid=uuid_of_host sr-uuid=uuid_of_sr [device-config:key=corresponding_value]

Créez un PBD sur votre serveur HASH (0x2e68218). 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 sur chaque type SR, reportez-vous à la sectionStockage.

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 au serveur HASH (0x2e68218). Si cette commande réussit, le SR référencé (et les VDI contenus dans) devrait alors devenir visible par le serveur HASH (0x2e68218).

pbd-unplug

pbd-unplug uuid=uuid_of_pbd

Essayez de débrancher le PBD du serveur HASH (0x2e68218).

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 Commandes de paramètres de bas niveau

Paramètres PIF

Les FRP ont les paramètres suivants :

Nom du paramètre Description Type
uuid Identifiant/référence d’objet unique pour le FRP Lecture seule
device machine-readable Nom de l’interface (par exemple, eth0) Lecture seule
MAC L’adresse MAC du FRP Lecture seule
other-config Pname:value aires de configuration PIF supplémentaires. Paramètre de mappage en lecture/écriture
physical Si la valeur est true, le PIF pointe vers une interface réseau physique réelle Lecture seule
currently-attached Le FRP est-il actuellement attaché à cet hôte ? true oufalse Lecture seule
MTU Unité de transmission maximale du PIF en octets. Lecture seule
VLAN Balise VLAN pour tout le trafic passant par cette interface. -1 indique qu’aucune balise VLAN n’est attribuée Lecture seule
bond-master-of L’UUID de l’obligation que ce FRP est le maître de (le cas échéant) Lecture seule
bond-slave-of L’UUID du lien que ce PIF est l’esclave de (le cas échéant) Lecture seule
management Ce PIF est-il désigné comme une interface de gestion pour le domaine de contrôle Lecture seule
network-uuid Identifiant/référence d’objet unique du réseau virtuel auquel ce PIF est connecté Lecture seule
network-name-label Nom du réseau virtuel auquel ce PIF est connecté Lecture seule
host-uuid Référence identifiant/objet unique du serveur HASH (0x2e68218) auquel ce PIF est connecté Lecture seule
host-name-label Nom du serveur HASH (0x2e68218) auquel ce PIF est connecté Lecture seule
IP-configuration-mode Type de configuration d’adresse réseau utilisé ; DHCP ou statique Lecture seule
IP Adresse IP du PIF. Définie ici lorsque le mode de configuration IP est statique ; non définie lorsque DHCP Lecture seule
netmask Masque réseau du PIF. Définie ici lorsque le mode de configuration IP est statique ; non définie lorsqu’il est fourni par DHCP Lecture seule
gateway Adresse de la passerelle du PIF. Définie ici lorsque le mode de configuration IP est statique ; non définie lorsqu’il est fourni par DHCP Lecture seule
DNS Adresse DNS du PIF. Définie ici lorsque le mode de configuration IP est statique ; non définie lorsqu’il est fourni par DHCP Lecture seule
io_read_kbs Taux de lecture moyen en Ko/s pour l’appareil Lecture seule
io_write_kbs Taux d’écriture moyen en Ko/s pour l’appareil Lecture seule
carrier État du lien pour ce périphérique Lecture seule
vendor-id ID attribué au fournisseur de la carte réseau Lecture seule
vendor-name Nom du fournisseur de la carte réseau Lecture seule
device-id ID attribué par le fournisseur à ce modèle de carte réseau Lecture seule
device-name Nom attribué par le fournisseur à ce modèle de carte réseau Lecture seule
speed Taux de transfert de données de la carte réseau Lecture seule
duplex Mode duplexage de la carte réseau ; plein ou demi Lecture seule
pci-bus-path Adresse du chemin de bus PCI Lecture seule
other-config:ethtoolspeed Définit la vitesse de connexion en Mbps Lecture/écriture
other-config:ethtoolautoneg Définissez la valeur no pour désactiver l’autonégociation de l’interface physique ou du pont. La valeur par défaut est oui. Lecture/écriture
other-config:ethtoolduplex Définit la capacité de duplexage du PIF, soit plein, soit moitié. Lecture/écriture
other-config:ethtool-rx Définir sur on pour activer la somme de contrôle de réception, sur off pour désactiver Lecture/écriture
other-config:ethtool-tx Définir sur on pour activer la somme de contrôle de transmission, sur off pour désactiver Lecture/écriture
other-config:ethtool-sg Définir sur on pour activer la ventilation-regroupement, sur off pour désactiver Lecture/écriture
other-config:ethtool-tso Définir sur on pour activer le déchargement de la segmentation tcp, sur off pour désactiver Lecture/écriture
other-config:ethtool-ufo Définir sur on pour activer le déchargement du fragment udp, désactivé pour désactiver Lecture/écriture
other-config:ethtool-gso Définir sur on pour activer le déchargement de segmentation générique, sur off pour désactiver Lecture/écriture
other-config:domain Liste séparée par des virgules utilisée pour définir le chemin de recherche DNS Lecture/écriture
other-config:bondmiimon Intervalle entre les contrôles de liveness, en millisecondes Lecture/écriture
other-config:bonddowndelay Nombre de millisecondes à attendre après la perte du lien avant de considérer vraiment le lien comme étant parti. Ce paramètre permet la perte de lien transitoire Lecture/écriture
other-config:bondupdelay Nombre de millisecondes à attendre après l’arrivée du lien avant de vraiment l’envisager. Permet le battement de liens. La valeur par défaut est31s de laisser le temps aux commutateurs pour commencer à transférer le trafic. Lecture/écriture
disallow-unplug True si ce PIF est une carte réseau de stockage dédiée, false sinon Lecture/écriture

Note :

Les modifications apportées 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=interface_name

Créez un objet PIF représentant une interface physique sur le serveur HASH spécifié (0x2e68218).

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 uuid=uuid_of_pif [mode=dhcp|mode=static] gateway=network_gateway_address IP=static_ip_for_this_pif netmask=netmask_for_this_pif [DNS=dns_address]

Modifiez l’adresse IP du PIF. Pour la configuration IP statique, définissez le paramètre sur paramètre surstatic, avec les paramètres legatewayIP et netmask`` définis sur les valeurs appropriées. Pour utiliser DHCP, définissez le paramètre mode sur DHCP 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 serveur HASH (0x2e68218).

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 plusieurs serveurs HASH (0x2e68218). 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 serveur HASH (0x2e68218) est vraiment un pool composé d’un seul membre par défaut. Lorsque votre serveur HASH (0x2e68218) est joint à un pool, il est désigné comme membre, et le pool qu’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 Commandes de paramètres de bas niveau

Paramètres de pool

Les pools ont les paramètres suivants :

Nom du paramètre Description Type
uuid Identifiant/référence d’objet unique pour le pool Lecture seule
name-label Le nom du pool Lecture/écriture
name-description La chaîne de description du pool Lecture/écriture
master Identifiant/référence d’objet unique du serveur HASH (0x2e68218) désigné comme maître du pool Lecture seule
default-SR Identifiant/référence d’objet unique de la SR par défaut pour le pool Lecture/écriture
crash-dump-SR Référence identifiant/objet unique de la SR où les vidages de plantage pour les membres du pool sont enregistrés Lecture/écriture
metadata-vdis Tous les VDI de métadonnées connues pour le pool Lecture seule
suspend-image-SR Identifiant/référence d’objet unique de la SR où les machines virtuelles suspendues sur les membres du pool sont enregistrées Lecture/écriture
other-config Une liste de paires clé/valeur qui spécifient des paramètres de configuration supplémentaires pour le pool Paramètre de mappage en lecture/écriture
supported-sr-types Types SR que ce pool peut utiliser Lecture seule
ha-enabled True si HA est activée pour le pool, false sinon Lecture seule
ha-configuration Réservé pour une utilisation future. Lecture seule
ha-statefiles Répertorie les UUID des VDI utilisés par HA pour déterminer l’intégrité du stockage Lecture seule
ha-host-failures-to-tolerate Nombre d’échecs d’hôte à tolérer avant d’envoyer une alerte système Lecture/écriture
ha-plan-exists-for Le nombre d’échecs d’hôtes qui peuvent réellement être gérés, selon les calculs de l’algorithme HA Lecture seule
ha-allow-overcommit True si le pool est autorisé à être surchargé, False sinon Lecture/écriture
ha-overcommitted True si le pool est surchargé Lecture seule
blobs Magasin de données binaires Lecture seule
live-patching-disabled Définissez la valeur False pour activer l’application de correctifs en direct. Définissez la valeur True pour désactiver l’application de correctifs en direct. Lecture/écriture
igmp-snooping-enabled Définissez la valeur True pour activer le snooping IGMP. Définissez la valeur False pour désactiver l’espionnage IGMP. Lecture/écriture

pool-apply-edition

pool-apply-edition edition=edition [uuid=uuid] [license-server-address=address] [license-server-port=port]

Appliquez une édition dans le pool.

pool-certificate-install

pool-certificate-install filename=file_name

Installez un certificat SSL à l’échelle du pool.

pool-certificate-list

pool-certificate-list

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=file_name

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 au serveur HASH membre spécifié (0x2e68218) 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-storage-caching uuid=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=service_name [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 uuid=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 au serveur HASH (0x2e68218) spécifié de quitter un pool existant.

pool-emergency-reset-master

pool-emergency-reset-master master-address=address_of_pool_master

Demandez à un serveur HASH membre esclave (0x2e68218) de réinitialiser son adresse maître à la nouvelle valeur et de tenter de vous y connecter. N’exécutez pas cette commande sur les hôtes maîtres.

pool-emergency-transition-to-master

pool-emergency-transition-to-master

Demandez à un serveur HASH membre (0x2e68218) de devenir le maître de pool. Le serveur HASH (0x2e68218) accepte cette commande uniquement après la transition de l’hôte en 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=password

Initialisez l’équilibrage de la charge de travail pour le pool actuel avec le serveur WLB cible.

pool-join

pool-join master-address=address master-username=username master-password=password

Demandez à votre serveur HASH (0x2e68218) 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 au HASH (0x2e6c8e8). 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 HASH (0x2e68218) se relie 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é au serveur HASH (0x2e68218), 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. Utilisez xe pif-reconfigure pour en configurer un en premier. Sinon, les commandes CLI suivantes ne parviennent pas à atteindre le serveur HASH (0x2e68218).

pool-recover-slaves

pool-recover-slaves

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 [filename=file_name]

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

pool-retrieve-wlb-report report=report [filename=file_name]

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 le pooligmp-snooping

pool-param-set [uuid=pool-uuid] [igmp-snooping-enabled=true|false]

Active ou désactive le snooping IGMP sur un pool HASH (0x2e68218).

Commandes PVS Accelerator

Commandes pour travailler avec l’accélérateur PVS.

pvs-cache-storage-create

pvs-cache-storage-create sr-uuid=sr_uuid pvs-site-uuid=pvs_site_uuid size=size

Configurez un cache PVS sur un SR donné pour un hôte donné.

pvs-cache-storage-destroy

pvs-cache-storage-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 uuid=uuid

Oubliez un serveur PVS.

pvs-server-introduce

pvs-server-introduce addresses=adresses first-port=first_port last-port=last_port pvs-site-uuid=pvs_site_uuid

Introduire un nouveau serveur PVS.

pvs-site-forget

pvs-site-forget uuid=uuid

Oubliez un site PVS.

pvs-site-introduce

pvs-site-introduce name-label=name_label [name-description=name_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 Commandes de paramètres de bas niveau

Paramètres SM

Les SMS ont les paramètres suivants :

Nom du paramètre Description Type
uuid La référence unique identifiant/objet pour le plugin SM Lecture seule
name-label Le nom du plugin SM Lecture seule
name-description La chaîne de description du plugin SM Lecture seule
type Le type SR auquel ce plugin se connecte Lecture seule
vendor Nom du fournisseur qui a créé ce plugin Lecture seule
copyright Déclaration de copyright pour ce plugin SM Lecture seule
required-api-version Version minimale de l’API SM requise sur le serveur HASH (0x2e68218) Lecture seule
configuration Noms et descriptions des clés de configuration de périphérique Lecture seule
capabilities Capacités du plugin SM Lecture seule
driver-filename Nom de fichier du pilote SR. Lecture seule

Commandes instantanés

Commandes pour travailler avec des instantanés.

snapshot-clone

snapshot-clone new-name-label=name_label [uuid=uuid] [new-name-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

snapshot-disk-list [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=file_name 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 Commandes de paramètres de bas niveau

Paramètres SR

Les SR ont les paramètres suivants :

Nom du paramètre Description Type
uuid Identifiant/référence d’objet unique pour le SR Lecture seule
name-label Le nom de la SR Lecture/écriture
name-description La chaîne de description du SR Lecture/écriture
allowed-operations Liste des opérations autorisées sur la SR dans cet état Paramètre en lecture seule
current-operations Liste des opérations en cours dans le cadre de ce RS Paramètre en lecture seule
VDIs Identifiant/référence d’objet unique pour les disques virtuels de cette SR Paramètre en lecture seule
PBDs Identifiant/référence d’objet unique pour les PBD attachés à ce SR Paramètre en lecture seule
physical-utilisation Espace physique actuellement utilisé sur ce SR, en octets. Pour les formats de disque à provisionnement fin, l’utilisation physique peut être inférieure à l’allocation virtuelle Lecture seule
physical-size Taille physique totale de la SR, en octets Lecture seule
type Type de SR, utilisé pour spécifier le pilote principal SR à utiliser Lecture seule
introduced-by Le drtask (le cas échéant) qui a introduit le SR Lecture seule
content-type Type de contenu du SR. Utilisé pour distinguer les bibliothèques ISO des autres SR. Pour les référentiels de stockage qui stockent une bibliothèque d’ISO, le type de contenu doit être défini sur iso. Dans d’autres cas, nous vous recommandons de définir ce paramètre soit à vide, soit à l’utilisateur de chaîne. Lecture seule
shared True si cette SR peut être partagée entre plusieurs serveurs HASH (0x2e68218) ; False sinon Lecture/écriture
other-config Liste des paires clé/valeur qui spécifient des paramètres de configuration supplémentaires pour le SR Paramètre de mappage en lecture/écriture
host Nom d’hôte du référentiel de stockage Lecture seule
virtual-allocation Somme des valeurs virtuelles de tous les VDI dans ce référentiel de stockage (en octets) Lecture seule
sm-config Données dépendantes de SM Paramètre de mappage en lecture seule
blobs Magasin de données binaires Lecture seule

sr-create

sr-create name-label=name physical-size=size type=type content-type=content_type device-config:config_name=value [host-uuid=host_uuid] [shared=true|false]

Crée un SR sur le disque, l’introduit dans la base de données et crée un PBD attachant le SR au serveur HASH (0x2e68218). Si la valeurshared est définie surtrue , un PBD est créé pour chaque serveur HASH (0x2e68218) du pool. Si n’shared est pas spécifié ou défini surfalse , un PBD est créé uniquement pour le serveur HASH (0x2e68218) spécifié avechost-uuid .

Les paramètres device-config exacts diffèrent en fonction de l’appareil type. 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=data_source

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=data_source

Interrogez la dernière valeur lue à partir d’une source de données SR.

sr-data-source-record

sr-data-source-record  data-source=data_source

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 le serveur HASH (0x2e68218).

sr-enable-database-replication

sr-enable-database-replication uuid=sr_uuid

Active la réplication de base de données XAPI vers le SR spécifié (partagé).

sr-disable-database-replication

sr-disable-database-replication uuid=sr_uuid

Désactive la réplication de base de données XAPI vers le SR spécifié.

sr-forget

sr-forget uuid=sr_uuid

L’agent XAPI oublie un SR spécifié sur le serveur HASH (0x2e68218). 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. Utilisez device-config pour spécifier des paramètres supplémentaires au format device-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-probe 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.

Les paramètres device-config exacts diffèrent en fonction de l’appareil type. 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 uuid=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=subject_name

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 [role-name=role_name] [role-uuid=role_uuid]

Ajouter un rôle à un sujet.

subject-role-remove

subject-role-remove uuid=uuid [role-name=role_name] [role-uuid=role_uuid]

Supprimez un rôle d’un sujet.

secret-create

secret-create value=value

Créez un secret.

secret-destroy

secret-destroy 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 Commandes de paramètres de bas niveau

Paramètres de la tâche

Les tâches ont les paramètres suivants :

Nom du paramètre Description Type
uuid Identifiant/référence d’objet unique pour la tâche Lecture seule
name-label Le nom de la tâche Lecture seule
name-description La chaîne de description de la tâche Lecture seule
resident-on Identifiant/référence d’objet unique de l’hôte sur lequel la tâche est exécutée Lecture seule
status État de la tâche Lecture seule
progress Si la tâche est toujours en attente, ce champ contient le pourcentage estimé achevé, compris entre 0 et 1. Si la tâche est terminée, avec succès ou sans succès, la valeur est 1. Lecture seule
type Si la tâche s’est terminée avec succès, ce paramètre contient le type du résultat codé. Le type est le nom de la classe dont la référence est dans le champ de résultat. Sinon, la valeur de ce paramètre n’est pas définie Lecture seule
result Si la tâche s’est terminée avec succès, ce champ contient la valeur de résultat, soit Void ou une référence d’objet ; sinon, la valeur de ce paramètre n’est pas définie Lecture seule
error_info Si la tâche a échoué, ce paramètre contient l’ensemble des chaînes d’erreur associées. Sinon, la valeur de ce paramètre n’est pas définie Lecture seule
allowed_operations Liste des opérations autorisées dans cet état Lecture seule
created Heure de création de la tâche Lecture seule
finished Tâche temporelle terminée (c’est-à-dire réussie ou échouée). Si l’état de la tâche est en attente, la valeur de ce champ n’a pas de sens Lecture seule
subtask_of Contient l’UUID des tâches que cette tâche est une sous-tâche de Lecture seule
subtasks Contient les UUID de toutes les sous-tâches de cette tâche Lecture seule

task-cancel

task-cancel [uuid=task_uuid]

Diriger la tâche spécifiée d’annuler et de retourner.

Commandes de modèle

Commandes pour travailler avec des modèles de machines virtuelles.

Les modèles sont essentiellement des machines virtuelles dont leis-a-template paramètre est défini surtrue . Un modèle est une « image or » qui contient tous les différents paramètres de configuration pour instancier une machine virtuelle spécifique. HASH (0x2c1a078) 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 Commandes 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
  • user-version Chaîne (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>= memory_dynamic_min>=memory_static_min
  • 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 uuid=<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 uuid=<template_uuid> VCPUs-params:weight=512 xe template-param-set uuid=<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 le serveur HASH (0x2e68218) 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 uuid=<vm_uuid> platform:parallel=none
    

    Pour désactiver l’émulation d’un port série pour les invités HVM :

     xe vm-param-set uuid=<vm_uuid> platform: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 uuid=<vm_uuid> platform:usb=false
     xe vm-param-set uuid=<vm_uuid> platform:usb_tablet=false
    
  • 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) le serveur HASH (0x2e68218) sur lequel une machine virtuelle basée sur ce modèle est résidente. Apparaît comme not in database pour un modèle
  • affinity ( lecture/écriture) le serveur HASH (0x2e68218) sur lequel une machine virtuelle basée sur ce modèle a la préférence pour s’exécuter. Utilisé par la commande xe vm-start 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 sur 1 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 sur 1 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 comme not 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 comme not 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 comme not 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 comme not 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 comme not 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 comme not 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 comme not 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) action à prendre après l’arrêt de la machine virtuelle
  • actions-after-reboot (lecture/écriture) action à 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) multiplicateur 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 le paramètre ha-restartpriority à 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 du serveur HASH (0x2e68218).

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 Commandes de paramètres de bas niveau

Paramètres de mise à jour

Les mises à jour du serveur HASH (0x2e68218) ont les paramètres suivants :

Nom du paramètre Description Type
uuid Identifiant/référence d’objet unique pour la mise à jour Lecture seule
host La liste des hôtes auxquels cette mise à jour est appliquée Lecture seule
host-uuid Identificateur unique pour le serveur HASH (0x2e68218) à interroger Lecture seule
name-label Le nom de la mise à jour Lecture seule
name-description La chaîne de description de la mise à jour Lecture seule
applied Si la mise à jour a été appliquée ou non ; true ou false Lecture seule
installation-size Taille de la mise à jour en octets Lecture seule
after-apply-guidance Si la pile d’outils XAPI ou l’hôte nécessite un redémarrage Lecture seule
version La version de la mise à jour Lecture seule

update-upload

update-upload file-name=update_filename

Téléchargez un fichier de mise à jour spécifié sur le serveur HASH (0x2e68218). 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 le serveur HASH spécifié (0x2e68218).

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 serveurs HASH (0x2e68218) dans le 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 Commandes de paramètres de bas niveau

Paramètres VBD

Les VBD ont les paramètres suivants :

Nom du paramètre Description Type
uuid Identifiant/référence d’objet unique pour le VBD Lecture seule
vm-uuid Référence identifiant/objet unique pour la machine virtuelle que ce VBD est attaché à Lecture seule
vm-name-label Nom de la machine virtuelle que ce VBD est attaché à Lecture seule
vdi-uuid Identifiant/référence d’objet unique pour le VDI auquel VBD est mappé Lecture seule
vdi-name-label Nom du VDI que ce VBD est mappé à Lecture seule
empty Sitrue, ce VBD représente un lecteur vide Lecture seule
device L’appareil vu par l’invité, par exemplehda Lecture seule
userdevice Numéro de périphérique spécifié par le paramètre de périphérique pendantvbd-create, par exemple, 0 pour hda, 1 pour hdb, etc Lecture/écriture
bootable True si ce VBD est amorçable Lecture/écriture
mode Le mode avec lequel le VBD doit être installé Lecture/écriture
type Comment le VBD apparaît à la machine virtuelle, par exemple disque ou CD Lecture/écriture
currently-attached True si le VBD est attaché à cet hôte, false sinon Lecture seule
storage-lock True si un verrou au niveau du stockage a été acquis Lecture seule
status-code Code erreur/succès associé à la dernière opération d’attachement Lecture seule
status-detail Informations sur les erreurs/succès associées au statut de la dernière opération de connexion Lecture seule
qos_algorithm_type L’algorithme QoS à utiliser Lecture/écriture
qos_algorithm_params Paramètres de l’algorithme QoS choisi Paramètre de mappage en lecture/écriture
qos_supported_algorithms Algorithmes QoS pris en charge pour ce VBD Paramètre en lecture seule
io_read_kbs Taux de lecture moyen en kB par seconde pour ce VBD Lecture seule
io_write_kbs Taux d’écriture moyen en kB par seconde pour ce VBD Lecture seule
allowed-operations Liste des opérations autorisées dans cet état. Cette liste est purement consultative et l’état du serveur peut avoir changé au moment où ce champ est lu par un client. Paramètre en lecture seule
current-operations Lie chacune des tâches en cours d’exécution utilisant cet objet (par référence) à une énumération current_operation qui décrit la nature de la tâche. Paramètre en lecture seule
unpluggable True si ce VBD prend en charge le débranchement à chaud Lecture/écriture
attachable True si l’appareil peut être connecté Lecture seule
other-config Configuration supplémentaire Paramètre de mappage en lecture/écriture

vbd-create

vbd-create vm-uuid=uuid_of_the_vm device=device_value vdi-uuid=uuid_of_vdi_to_connect_to [bootable=true] [type=Disk|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 uuid=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’erreur VBD_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’erreur VBD_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 Commandes de paramètres de bas niveau

Paramètres VDI

Les VDI ont les paramètres suivants :

Nom du paramètre Description Type
uuid Identifiant/référence d’objet unique pour le VDI Lecture seule
name-label Le nom du VDI Lecture/écriture
name-description La chaîne de description du VDI Lecture/écriture
allowed-operations Liste des opérations autorisées dans cet état Paramètre en lecture seule
current-operations Une liste des opérations en cours sur ce VDI Paramètre en lecture seule
sr-uuid SR dans lequel réside le VDI Lecture seule
vbd-uuids Une liste de VBD qui font référence à ce VDI Paramètre en lecture seule
crashdump-uuids Liste des vidages de crash qui font référence à ce VDI Paramètre en lecture seule
virtual-size Taille du disque telle que présentée à la machine virtuelle, en octets. Selon le type de back-end de stockage, la taille peut ne pas être respectée exactement Lecture seule
physical-utilisation Quantité d’espace physique que le VDI occupe sur le SR, en octets Lecture seule
type Type de VDI, par exemple, Système ou Utilisateur Lecture seule
sharable True si ce VDI peut être partagé Lecture seule
read-only True si ce VDI ne peut être installé qu’en lecture seule Lecture seule
storage-lock True si ce VDI est verrouillé au niveau du stockage Lecture seule
parent Références le VDI parent lorsque ce VDI fait partie d’une chaîne Lecture seule
missing True si l’opération d’analyse SR a signalé que ce VDI n’était pas présent Lecture seule
other-config Informations de configuration supplémentaires pour ce VDI Paramètre de mappage en lecture/écriture
sr-name-label Nom du référentiel de stockage contenant Lecture seule
location Informations de localisation Lecture seule
managed True si le VDI est géré Lecture seule
xenstore-data Données à insérer dans l’arborescence xenstore (/local/domain/0/backend/ vbd/domid/device-id/smdata) après l’attachement du VDI. Les back-ends SM définissent généralement ce champ sur vdi_attach. Paramètre de mappage en lecture seule
sm-config Données dépendantes de SM Paramètre de mappage en lecture seule
is-a-snapshot True si ce VDI est un instantané de stockage de machine virtuelle Lecture seule
snapshot_of L’UUID du stockage de ce VDI est un instantané de Lecture seule
snapshots Les UUID de tous les instantanés de ce VDI Lecture seule
snapshot_time Horodatage de l’opération de snapshot qui a créé ce VDI Lecture seule
metadata-of-pool Uuid du pool qui a créé cette métadonnées VDI Lecture seule
metadata-latest Indicateur indiquant si le VDI contient les dernières métadonnées connues pour ce pool Lecture seule
cbt-enabled Indicateur indiquant si le suivi des blocs modifiés est activé pour le VDI Lecture/écriture

vdi-clone

vdi-clone uuid=uuid_of_the_vdi [driver-params:key=value]

Créez une nouvelle copie accessible en écriture du VDI spécifié qui peut être utilisée directement. Il est une variante devdi-copy ce qui est peut exposer les installations de clone d’image haute vitesse où elles existent.

Utilisez le paramètre de carte driver-params 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 uuid=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 name-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.

Le paramètre virtual-size 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.

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 utiliser vdi-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 utiliser vdi-destroy sur les instantanés de VDI qui ont modifié le suivi des blocs activé.

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 HASH (0x2c1a078) HASH (0x2e72eb8).

vdi-export

vdi-export uuid=uuid_of_vdi filename=filename_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 uuid=uuid_of_vdi filename=filename_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 name-label=name_of_new_vdi type=system|user|suspend|crashdump location=device_location_(varies_by_storage_type) [name-description=description_of_vdi] [sharable=yes|no] [read-only=yes|no] [other-config=map_to_store_misc_user_specific_data] [xenstore-data=map_to_of_additional_xenstore_keys] [sm-config=storage_specific_configuration_data]

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, reportez-vous à la section Suivi des blocs modifiés.

vdi-pool-migrate

vdi-pool-migrate uuid=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. (Migration active du stockage)

Pour plus d’informations, reportez-vous à la section 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 de carte driver-params 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 Commandes 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 (Paramètre en lecture seule) une liste des opérations autorisées dans cet état
  • current-operations (Paramètre en lecture seule) 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 \
         uuid=<vif_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 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, sur off pour désactiver
  • other-config:ethtooltx (lecture/écriture) défini sur on pour activer la somme de contrôle de transmission, sur off pour désactiver
  • other-config:ethtoolsg (lecture/écriture) défini sur on pour activer la collecte de dispersion, sur off pour désactiver
  • other-config:ethtooltso (lecture/écriture) défini sur on pour activer le déchargement de la segmentation tcp, sur off pour désactiver
  • other-config:ethtoolufo (lecture/écriture) défini sur on pour activer le déchargement du fragment udp, sur off pour désactiver
  • other-config:ethtoolgso (lecture/écriture) défini sur on pour activer le déchargement de segmentation générique, sur off pour désactiver
  • other-config:promiscuous (lecture/écriture) true à un VIF pour être en mode de proximité 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, HASH (0x2c1a078) 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, HASH (0x2c1a078) supprime toutes les règles de filtrage associées au VIF. Pour plus d’informations, reportez-vous à la section 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) HASH (0x2c1a078) 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=see below network-uuid=uuid_of_network_to_connect_to [mac=mac_address]

Créez un VIF sur une machine virtuelle.

Les valeurs appropriées pour le champ device sont répertoriées dans le paramètre allowed-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.

Le paramètre mac est l’adresse MAC standard dans le formulaire aa: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écifiant mac=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_address

Par exemple :

VIF.configure_ipv4(vifObject,"static", " 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_address

Par exemple :

VIF.configure_ipv6(vifObject,"static", "fd06:7768:b9e5:8b00::5001/64", "fd06:7768:b9e5:8b00::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, reportez-vous à la section 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 serveur HASH (0x2e68218).

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 Commandes 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
  • user-version Chaîne (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 uuid=<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 uuid=<vm_uuid> VCPUs-params:weight=512 xe vm-param-set uuid=<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 serveur HASH (0x2e68218). 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 le serveur HASH (0x2e68218) 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 uuid=<vm_uuid> platform:acpi_laptop_slate=0
    

    Pour activer le VDA pour basculer Windows 10 en mode Tablet :

     xe vm-param-set uuid=<vm_uuid> platform: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) le serveur HASH (0x2e68218) sur lequel une machine virtuelle réside
  • affinity ( lecture/écriture) Serveur HASH (0x2e68218) sur lequel la machine virtuelle a la préférence pour s’exécuter. Utilisé par la commande xe vm-start 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 forme yyyymmddThh: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 forme yyyymmddThh: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 sur VCPUsmax 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 le serveur HASH (0x2e68218).
  • 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 le paramètre ha-restart-priority à 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-recovered uuid [database] 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, reportez-vous à la section Sélecteurs de machines virtuelles. Les arguments facultatifs peuvent être n’importe quel nombre de Paramètres VM ré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, reportez-vous à la section Sélecteurs de machines virtuelles. Les arguments facultatifs peuvent être n’importe quel nombre de Paramètres VM ré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, reportez-vous à la section Sélecteurs de machines virtuelles. Les arguments facultatifs peuvent être n’importe quel nombre de Paramètres VM ré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, reportez-vous à la section Sélecteurs de machines virtuelles. Les arguments facultatifs peuvent être n’importe quel nombre de Paramètres VM ré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, reportez-vous à la section Sélecteurs de machines virtuelles. Les arguments facultatifs peuvent être n’importe quel nombre de Paramètres VM répertoriés au début de cette section.

vm-checkpoint

vm-checkpoint new-name-label=name_label [new-name-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, reportez-vous à la section Sélecteurs de machines virtuelles. Les arguments facultatifs peuvent être n’importe quel nombre de Paramètres VM ré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=add overhead memory for additional vCPUS? 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=memory-free --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, reportez-vous à la section Sélecteurs de machines virtuelles. Les arguments facultatifs peuvent être n’importe quel nombre de Paramètres VM répertoriés au début de cette section.

vm-compute-memory-overhead

vm-compute-memory-overhead

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, reportez-vous à la section Sélecteurs de machines virtuelles. Les arguments facultatifs peuvent être n’importe quel nombre de Paramètres VM ré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=vm selector value...]

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, reportez-vous à la section Sélecteurs de machines virtuelles. Les arguments facultatifs peuvent être n’importe quel nombre de Paramètres VM répertoriés au début de cette section.

vm-data-source-list

vm-data-source-list [vm-selector=vm selector value...]

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, reportez-vous à la section Sélecteurs de machines virtuelles. Les arguments facultatifs peuvent être n’importe quel nombre de Paramètres VM ré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ètresstandardenabled et — que vous pouvez voir dans la sortie de cette commande. Si une source de données a enabled défini sur true, 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 la commande vm-data-source-record. Cette commande définit enabled sur true. Pour arrêter, exécutez le vm-data-source-forget. Cette commande définit enabled sur false.

vm-data-source-record

vm-data-source-record data-source=name_description_of_data-source [vm-selector=vm selector value...]

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, reportez-vous à la section Sélecteurs de machines virtuelles. Les arguments facultatifs peuvent être n’importe quel nombre de Paramètres VM ré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=vm selector value...]

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, reportez-vous à la section Sélecteurs de machines virtuelles. Les arguments facultatifs peuvent être n’importe quel nombre de Paramètres VM ré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, reportez-vous à la section Sélecteurs de machines virtuelles. Les arguments facultatifs peuvent être n’importe quel nombre de Paramètres VM ré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.

Le paramètre disk-size 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, reportez-vous à la section Sélecteurs de machines virtuelles. Les arguments facultatifs peuvent être n’importe quel nombre de Paramètres VM ré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, reportez-vous à la section Sélecteurs de machines virtuelles. Les arguments facultatifs peuvent être n’importe quel nombre de Paramètres VM ré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, reportez-vous à la section Sélecteurs de machines virtuelles. Les arguments facultatifs peuvent être n’importe quel nombre de Paramètres VM ré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, reportez-vous à la section import-vm-vm-.

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, reportez-vous à la section Sélecteurs de machines virtuelles. Les arguments facultatifs peuvent être n’importe quel nombre de Paramètres VM ré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 HASH (0x2c1a078) 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_uuid]

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-customized

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

vm-memory-set memory=memory

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...] [multiplier=float_memory_multiplier]

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.

Dans certaines charges de travail d’applications spécialisées, telles que Citrix Virtual Apps, une mémoire instantanée supplémentaire est nécessaire pour obtenir des performances optimales.

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. Si la mémoire du serveur HASH (0x2e68218) n’est pas suffisante, 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, reportez-vous à la section 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-migrate [copy=true|false] [host-uuid=destination_host_uuid] [host=name_or_ uuid_of_destination_host] [force=true|false] [live=true|false] [vm-selector=vm_selector_value...] [remote-master=destination_pool_master_uuid] [remote-username=destination_pool_username] [remote-password=destination_pool_password] [remote-network=destination_pool_network_uuid ][vif:=vif_uuid] [vdi=vdi_uuid]

Cette commande migre les machines virtuelles spécifiées entre les hôtes physiques. Lehost paramètre peut être le nom ou l’UUID du serveur HASH (0x2e68218). 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 uuid=vm_uuid host-uuid=host_uuid

Pour déplacer des machines virtuelles entre des hôtes du même pool, qui ne partagent pas le stockage (migration en direct du stockage) :

xe vm-migrate uuid=vm_uuid remote-master=12.34.56.78 \
    remote-username=username remote-password=password \
    host-uuid=desination_host_uuid vdi=vdi_uuid

Vous pouvez choisir le SR où chaque VDI est stocké :

xe vm-migrate uuid=vm_uuid host-uuid=destination_host_uuid \
    vdi1:vdi_1_uuid=destination_sr_uuid \
    vdi2:vdi_2_uuid=destination_sr2_uuid \
    vdi3:vdi_3_uuid=destination_sr3_uuid

En outre, vous pouvez choisir le réseau à attacher la machine virtuelle après la migration :

xe vm-migrate uuid=vm_uuid \
    vdi1:vdi_1_uuid=destination_sr_uuid \
    vdi2:vdi_2_uuid=destination_sr2_uuid \
    vdi3:vdi_3_uuid=destination_sr3_uuid \
    vif:vif_uuid=network_uuid

Pour la migration entre pools :

xe vm-migrate uuid=vm_uuid remote-master=12.34.56.78
    remote-username=username remote-password=password \
    host-uuid=desination_host_uuid vdi=vdi_uuid

Pour plus d’informations sur la migration en direct du stockage, la migration en direct et la migration VDI en direct, reportez-vous à la sectionMigration des machines virtuelles.

Par défaut, la machine virtuelle est suspendue, migrée et reprise sur l’autre hôte. Lelive paramètre sélectionne la migration en direct. La migration en direct maintient la machine virtuelle en cours d’exécution pendant la migration, réduisant ainsi les temps d’arrêt de la machine virtuelle à moins d’une seconde. Dans certains cas, comme des charges de travail extrêmement volumineuses en mémoire dans la machine virtuelle, la migration en direct retombe en mode par défaut et suspend la machine virtuelle pendant une courte période avant de terminer 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, reportez-vous à la section Sélecteurs de machines virtuelles. Les arguments facultatifs peuvent être n’importe quel nombre de Paramètres VM ré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, reportez-vous à la section Sélecteurs de machines virtuelles. Les arguments facultatifs peuvent être n’importe quel nombre de Paramètres VM répertoriés au début de cette section.

Utilisez l’argument force pour provoquer un redémarrage inapproprié. Où l’arrêt s’apparente à tirer la fiche sur un serveur physique.

vm-recover

vm-recover vm-uuid [database] [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, reportez-vous à la section Sélecteurs de machines virtuelles. Les arguments facultatifs peuvent être n’importe quel nombre de Paramètres VM ré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, reportez-vous à la section Sélecteurs de machines virtuelles. Les arguments facultatifs peuvent être n’importe quel nombre de Paramètres VM ré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, reportez-vous à la section Sélecteurs de machines virtuelles. Les arguments facultatifs peuvent être n’importe quel nombre de Paramètres VM ré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-name-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-name-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, reportez-vous à la section Sélecteurs de machines virtuelles. Les arguments facultatifs peuvent être n’importe quel nombre de Paramètres VM ré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, reportez-vous à la section Sélecteurs de machines virtuelles. Les arguments facultatifs peuvent être n’importe quel nombre de Paramètres VM ré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, reportez-vous à la section Sélecteurs de machines virtuelles. Les arguments facultatifs peuvent être n’importe quel nombre de Paramètres VM répertoriés au début de cette section.

vm-unpause

vm-unpause

Activez 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 sur VCPUs-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, reportez-vous à la section Sélecteurs de machines virtuelles. Les arguments facultatifs peuvent être n’importe quel nombre de Paramètres VM répertoriés au début de cette section.

Note :

Lorsque vous exécutez des machines virtuelles Linux sans HASH (0x2e68170) installé, exécutez la commande suivante sur la machine virtuelleroot afin de vous assurer que les vCPU nouvellement connectés 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, reportez-vous à la section 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 VM ré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 Commandes de paramètres de bas niveau

vmss-create

vmss-create enabled=True/False name-label=name type=type frequency=frequency retained-snapshots=value name-description=description schedule:schedule

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 \
    schedule:hour=10 schedule:min=30

Les programmes d’instantanés ont les paramètres suivants :

Nom du paramètre Description Type
name-label Nom de la planification de l’instantané. Lecture/écriture
name-description Description de la planification de l’instantané. Lecture/écriture
type Instantané de disque ; Instantané mémoire ; Instantané en repos Lecture/écriture
frequency Horaire ; Quotidien ; Hebdomadaire Lecture/écriture
retained-snapshots Instantanés à conserver. Portée : 1-10. Lecture/écriture
schedule schedule:days ( lundi au dimanche),schedule:hours (0 à 23),schedule:minutes (0, 15, 30, 45) Lecture/écriture

vmss-destroy

vmss-destroy uuid=uuid

Détruit une planification d’instantanés dans le pool.

Passthrough USB

Activer/désactiver le passage USB

pusb-param-set uuid=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-uuid=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.