Interface de ligne de commande

L’interface de ligne de commande xe vous permet de scripter et d’automatiser les tâches d’administration système. Utilisez l’interface de ligne de commande pour intégrer XenServer® dans une infrastructure informatique existante.

Démarrer avec l’interface de ligne de commande xe

L’interface de ligne de commande xe est installée par défaut sur tous les hôtes XenServer. Une version Windows distante est incluse avec XenCenter. Une interface de ligne de commande distante autonome est également disponible pour Linux.

Sur votre hôte XenServer

L’interface de ligne de commande xe est installée par défaut sur votre hôte. Vous pouvez exécuter des commandes CLI xe dans la console dom0. Accédez à la console dom0 de l’une des manières suivantes :

• Dans XenCenter, accédez à l’onglet Console de l’hôte sur lequel vous souhaitez exécuter la commande.
• Connectez-vous en SSH à l’hôte sur lequel vous souhaitez exécuter la commande.

Sous Windows

Sous Windows, la commande xe.exe est installée avec XenCenter.

Pour utiliser la commande xe.exe, ouvrez une invite de commande Windows et accédez au répertoire où se trouve le fichier xe.exe (généralement C:\Program Files (x86)\XenServer\XenCenter). Si vous ajoutez l’emplacement d’installation de xe.exe à votre chemin système, vous pouvez utiliser la commande sans avoir à changer de 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 de XenServer.

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

rpm -ivh xapi-xe-BUILD.x86_64.rpm
<!--NeedCopy-->

Vous pouvez utiliser des paramètres en ligne de commande pour définir l’hôte XenServer, le nom d’utilisateur et le mot de passe à utiliser lors de l’exécution des commandes xe. Cependant, vous avez également la possibilité de définir ces informations comme une variable d’environnement. Par exemple :

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

Remarque :

L’interface de ligne de commande xe distante sous Linux peut se bloquer lors de l’exécution de commandes via une connexion sécurisée et que ces commandes impliquent un transfert de fichiers. Dans ce cas, vous pouvez utiliser le paramètre --no-ssl pour exécuter la commande via une connexion non sécurisée à l’hôte XenServer.

Obtenir de l’aide avec les commandes xe

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

xe help command
<!--NeedCopy-->

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

xe help
<!--NeedCopy-->

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

xe help --all
<!--NeedCopy-->

Syntaxe de base de xe

La syntaxe de base de toutes les commandes CLI xe de XenServer est :

xe command-name argument=value argument=value
<!--NeedCopy-->

Chaque commande spécifique contient son propre ensemble d’arguments qui sont de la forme argument=value. Certaines commandes ont des arguments obligatoires, et la plupart ont un ensemble d’arguments facultatifs. Généralement, une commande utilise des valeurs par défaut pour certains des arguments facultatifs lorsqu’elle est appelée sans eux.

Si la commande xe s’exécute à distance, des arguments supplémentaires sont utilisés pour se connecter et s’authentifier. Ces arguments prennent également la forme argument=argument_value.

L’argument server est utilisé pour spécifier le nom d’hôte ou l’adresse IP. Les arguments username et password sont utilisés pour spécifier les informations d’identification.

Un argument password-file peut être spécifié à la place du mot de passe directement. Dans ce cas, la commande xe tente de lire le mot de passe du fichier spécifié et utilise ce mot de passe pour se connecter. (Tous les retours chariot et sauts de ligne en fin de fichier sont supprimés.) Cette méthode est plus sécurisée que de spécifier le mot de passe directement sur la ligne de commande.

L’argument facultatif port peut être utilisé pour spécifier le port de l’agent sur l’hôte XenServer distant (par défaut 443).

Exemple : Sur l’hôte XenServer local :

xe vm-list
<!--NeedCopy-->

Exemple : Sur un hôte XenServer distant :

xe vm-list username=username password=password server=hostname
<!--NeedCopy-->

La syntaxe abrégée est également disponible pour les arguments de connexion à distance :

• -u nom d’utilisateur
• -pw mot de passe
• -pwf fichier de mot de passe
• -p connecteur
• -s serveur

Exemple : Sur un hôte XenServer distant :

xe vm-list -u myuser -pw mypassword -s hostname
<!--NeedCopy-->

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 saisir des commandes exécutées sur un hôte XenServer distant, exécutez d’abord la commande suivante :

export XE_EXTRA_ARGS="server=jeffbeck,port=443,username=root,password=pass"
<!--NeedCopy-->

Après avoir exécuté cette commande, vous n’avez plus besoin de spécifier les paramètres de l’hôte XenServer distant dans chaque commande xe que vous exécutez.

L’utilisation de la variable d’environnement XE_EXTRA_ARGS active également la complétion par tabulation des commandes xe lorsqu’elles sont émises vers un hôte XenServer distant, ce qui est désactivé par défaut.

Caractères spéciaux et syntaxe

Pour spécifier des paires argument/valeur sur la ligne de commande xe, écrivez : argument=value

Sauf si la valeur contient des espaces, n’utilisez pas de guillemets. N’incluez pas d’espaces 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 hôte XenServer, les commandes disposent d’une fonction de complétion par tabulation similaire à celle du shell bash Linux standard. Par exemple, si vous tapez xe vm-l puis appuyez sur la touche TAB, le reste de la commande s’affiche. Si plusieurs commandes commencent par vm-l, appuyer une deuxième fois sur TAB liste les possibilités. Cette fonction est utile lors de la spécification des UUID d’objets dans les commandes.

Remarque :

La complétion par tabulation ne fonctionne normalement pas lors de l’exécution de commandes sur un hôte XenServer distant. Cependant, si vous définissez la variable XE_EXTRA_ARGS sur la machine où vous saisissez les commandes, la complétion par tabulation est activée. Pour plus d’informations, consultez Syntaxe de base de xe.

Types de commandes

Les commandes CLI peuvent être divisées en deux catégories. Les commandes de bas niveau concernent la liste et la manipulation des paramètres des objets API. Les commandes de niveau supérieur sont utilisées pour interagir avec les machines virtuelles ou les hôtes à un niveau plus abstrait.

Les commandes de bas niveau sont :

• class-list

• class-param-get

• class-param-set

• class-param-list

• class-param-add

• class-param-remove

• class-param-clear

Où class 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 ne disposent pas de l’ensemble complet des commandes class-param-action. Certaines valeurs de class ont un ensemble de commandes plus restreint.

Types de paramètres

Les objets adressés par les commandes xe possèdent des ensembles de paramètres qui les identifient et définissent leurs états.

La plupart des paramètres prennent une seule valeur. Par exemple, le paramètre name-label d’une VM contient une seule valeur de chaîne. Dans la sortie des commandes de liste de paramètres, telles que xe vm-param-list, une valeur entre parenthèses indique si les paramètres sont en lecture-écriture (RW) ou en lecture seule (RO). La sortie de xe vm-param-list sur une VM spécifiée peut contenir les lignes suivantes :

user-version ( RW): 1
 is-control-domain ( RO): false

Le premier paramètre, user-version, est modifiable 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 map est un ensemble de paires clé-valeur. À titre d’exemple, examinez l’extrait de sortie suivant de xe vm-param-list sur une VM 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

Le paramètre platform contient 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 caractère point-virgule (;). Le M précédant le RW indique que ce paramètre est un paramètre de type map et qu’il est lisible et modifiable. Le paramètre allowed-operations contient 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 de type set et qu’il est lisible mais non modifiable.

Pour filtrer sur un paramètre de type map ou définir un paramètre de type map, utilisez un deux-points (:) pour séparer le nom du paramètre de type map et la paire clé-valeur. Par exemple, pour définir la valeur de la clé foo du paramètre other-config d’une VM à baa, la commande serait

xe vm-param-set uuid=VM uuid other-config:foo=baa
<!--NeedCopy-->

Commandes de paramètres de bas niveau

Il existe plusieurs commandes pour opérer 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 un paramètre uuid pour spécifier l’objet particulier. Étant donné que ces commandes sont considérées comme des commandes de bas niveau, elles doivent utiliser l’UUID et non l’étiquette de nom de la VM.

• xe class-param-list uuid=uuid

  Liste tous les paramètres et leurs valeurs associées. Contrairement à la commande class-list, cette commande liste les valeurs des champs “coûteux”.

• xe class-param-get uuid=uuid param-name=parameter param-key=key

  Renvoie la valeur d’un paramètre particulier. Pour un paramètre de type carte (map), la spécification de la clé de paramètre (param-key) obtient la valeur associée à cette clé dans la carte. Si la clé de paramètre n’est pas spécifiée ou si le paramètre est un ensemble (set), la commande renvoie une représentation textuelle de l’ensemble ou de la carte.

• xe class-param-set uuid=uuid param=value

  Définit la valeur d’un ou plusieurs paramètres.

• xe class-param-add uuid=uuid param-name=parameter key=value param-key=key

  Ajoute à un paramètre de type carte (map) ou ensemble (set). Pour un paramètre de type carte, ajoutez des paires clé-valeur en utilisant la syntaxe key=value. Si le paramètre est un ensemble, ajoutez des clés avec la syntaxe param-key=key.

• xe 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.

• xe 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 affichant un sous-ensemble des paramètres. Ce comportement peut être modifié des manières suivantes :

• Elle peut filtrer les objets de manière à n’afficher qu’un sous-ensemble.
• Les paramètres affichés peuvent être modifiés.

Pour modifier les paramètres affichés, spécifiez l’argument params comme une liste des paramètres requis, séparés par des virgules. Par exemple :

xe vm-list params=name-label,other-config
<!--NeedCopy-->

Alternativement, pour lister tous les paramètres, utilisez la syntaxe :

xe vm-list params=all
<!--NeedCopy-->

La commande list n’affiche pas certains paramètres coûteux à calculer. Ces paramètres sont affichés comme, par exemple :

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

Pour obtenir ces champs, utilisez la commande class-param-list ou class-param-get

Pour filtrer la liste, la CLI fait correspondre les valeurs des paramètres avec celles spécifiées sur la ligne de commande, n’affichant que les objets qui correspondent à toutes les contraintes spécifiées. Par exemple :

xe vm-list HVM-boot-policy="BIOS order" power-state=halted
<!--NeedCopy-->

Cette commande liste uniquement les machines virtuelles pour lesquelles à la fois le champ power-state a la valeur halted et le champ HVM-boot-policy a la valeur BIOS order.

Vous pouvez également filtrer la liste par la valeur des clés dans les mappages ou par l’existence de valeurs dans un ensemble. La syntaxe pour le filtrage basé sur les clés dans les mappages est map-name:key=value. La syntaxe pour le filtrage basé sur les valeurs existantes dans un ensemble est set-name:contains=value.

Lors de l’écriture de scripts, une technique utile consiste à passer --minimal sur la ligne de commande, ce qui fait que xe n’affiche que le premier champ d’une liste séparée par des virgules. Par exemple, la commande xe 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
<!--NeedCopy-->

Secrets

XenServer fournit un mécanisme de secrets pour éviter que les mots de passe ne soient stockés en clair dans l’historique de la ligne de commande ou sur les objets API. XenCenter utilise cette fonctionnalité automatiquement et elle peut également être utilisée à partir de la CLI 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 auprès d’un hôte XenServer à partir d’une instance distante de la CLI xe.

Pour créer un objet secret, exécutez la commande suivante sur votre hôte XenServer.

xe secret-create value=my-password
<!--NeedCopy-->

Un secret est créé et stocké sur l’hôte XenServer. La commande affiche l’UUID de l’objet secret. Par exemple, 99945d96-5890-de2a-3899-8c04ef2521db. Ajoutez _secret au nom de l’argument de mot de passe pour passer cet UUID à toute commande nécessitant un mot de passe.

Exemple : Sur l’hôte XenServer 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"
<!--NeedCopy-->

Historique des commandes

Certaines commandes xe, par exemple xe vm-migrate ou xe pool-enable-external-auth, prennent des secrets comme des mots de passe en tant que paramètres. Ceux-ci peuvent se retrouver dans l’historique du shell et, lors de l’exécution de la commande, sont visibles dans la table des processus. Il est donc important d’exécuter ces commandes uniquement dans des environnements fiables.

Pour le shell bash, vous pouvez utiliser la variable HISTCONTROL pour contrôler les commandes stockées dans l’historique du shell.

Référence des commandes xe

Cette section regroupe les commandes par les objets auxquels la commande s’adresse. Ces objets sont listés par ordre alphabétique.

Commandes d’appliance

Commandes pour la création et la modification d’appliances de VM (également appelées vApps). Pour plus d’informations, consultez vApps.

Paramètres d’appliance

Les commandes d’appliance ont les paramètres suivants :

appliance-assert-can-be-recovered

xe appliance-assert-can-be-recovered uuid=appliance-uuid database:vdi-uuid=vdi-uuid
<!--NeedCopy-->

Vérifie si le stockage est disponible pour récupérer cette appliance/vApp de machine virtuelle.

appliance-create

xe appliance-create name-label=name-label [name-description=name-description]
<!--NeedCopy-->

Crée une appliance/vApp. Par exemple :

xe appliance-create name-label=my_appliance
<!--NeedCopy-->

Ajouter des machines virtuelles à l’appliance :

xe vm-param-set uuid=VM-UUID appliance=appliance-uuid
<!--NeedCopy-->

appliance-destroy

xe appliance-destroy uuid=appliance-uuid
<!--NeedCopy-->

Détruit une appliance/vApp. Par exemple :

xe appliance-destroy uuid=appliance-uuid
<!--NeedCopy-->

appliance-recover

xe appliance-recover uuid=appliance-uuid database:vdi-uuid=vdi-uuid [paused=true|false]
<!--NeedCopy-->

Récupère une appliance/vApp de machine virtuelle à partir de la base de données contenue dans le VDI fourni.

appliance-shutdown

xe appliance-shutdown uuid=appliance-uuid [force=true|false]
<!--NeedCopy-->

Arrête toutes les VM d’une appliance/vApp. Par exemple :

xe appliance-shutdown uuid=appliance-uuid
<!--NeedCopy-->

appliance-start

xe appliance-start uuid=appliance-uuid [paused=true|false]
<!--NeedCopy-->

Démarre une appliance/vApp. Par exemple :

xe appliance-start uuid=appliance-uuid
<!--NeedCopy-->

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 facultatif since est présent, il ne télécharge que les enregistrements à partir de ce point précis dans le temps.

Paramètres audit-log-get

audit-log-get a les paramètres suivants

audit-log-get

xe audit-log-get [since=timestamp] filename=filename
<!--NeedCopy-->

Par exemple, pour obtenir les enregistrements d’audit du pool depuis un horodatage précis en millisecondes, 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
<!--NeedCopy-->

Commandes de liaison

Commandes pour travailler avec les liaisons réseau, pour la résilience avec basculement d’interface physique. Pour plus d’informations, consultez Mise en réseau.

L’objet de liaison est un objet de référence qui relie les PIF maîtres et membres. Le PIF maître est l’interface de liaison qui doit être utilisée comme PIF 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 liaisons ont les paramètres suivants :

bond-create

xe bond-create network-uuid=network_uuid pif-uuids=pif_uuid_1,pif_uuid_2,...
<!--NeedCopy-->

Crée 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 PIF sont déjà dans une autre liaison
• Si un membre a une balise VLAN définie
• Si les PIF référencés ne se trouvent pas sur le même hôte XenServer
• Si moins de 2 PIF sont fournis

bond-destroy

xe bond-destroy uuid=bond_uuid
<!--NeedCopy-->

Supprime une interface liée spécifiée par son UUID d’un hôte.

bond-set-mode

xe bond-set-mode uuid=bond_uuid mode=bond_mode
<!--NeedCopy-->

Modifier le mode de liaison.

Commandes de CD

Commandes pour travailler avec les lecteurs de CD/DVD physiques sur les hôtes XenServer.

Paramètres de CD

Les CD ont les paramètres suivants :

cd-list

xe cd-list [params=param1,param2,...] [parameter=parameter_value]
<!--NeedCopy-->

Répertoriez les CD et les ISO (fichiers image de CD) sur l’hôte ou le pool XenServer, en filtrant sur l’argument facultatif params.

Si l’argument facultatif params est utilisé, la valeur de params est une chaîne contenant une liste de paramètres de cet objet que vous souhaitez afficher. Alternativement, vous pouvez utiliser le mot-clé all pour afficher tous les paramètres. Lorsque params n’est pas utilisé, 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 des paramètres CD listés au début de cette section.

Commandes de cluster GFS2

Commandes pour travailler avec les pools en cluster GFS2.

Les pools en cluster GFS2 sont des pools de ressources qui ont la fonctionnalité de clustering activée. Utilisez ces pools avec les SR GFS2. Pour plus d’informations, voir pools en cluster GFS2

Les objets cluster et cluster-hôte peuvent être listés avec les commandes de listage d’objets standard (xe cluster-list et xe cluster-host-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. Commandes pour travailler avec les pools en cluster GFS2.

Paramètres de cluster GFS2

Les clusters GFS2 ont les paramètres suivants :

Les hôtes au sein du cluster GFS2 (cluster-host) ont les paramètres suivants :

cluster-host-destroy

xe cluster-host-destroy uuid=host_uuid
<!--NeedCopy-->

Détruire un hôte de cluster GFS2, quittant ainsi le cluster GFS2.

cluster-host-disable

xe cluster-host-disable uuid=cluster_uuid
<!--NeedCopy-->

Désactiver l’appartenance au cluster GFS2 pour un hôte de cluster GFS2 activé.

cluster-host-enable

xe cluster-host-enable uuid=cluster_uuid
<!--NeedCopy-->

Activer l’appartenance au cluster GFS2 pour un hôte de cluster GFS2 désactivé.

cluster-host-force-destroy

xe cluster-host-force-destroy uuid=cluster_host
<!--NeedCopy-->

Détruire un objet hôte de cluster GFS2 de force, quittant ainsi le cluster GFS2.

cluster-pool-create

xe cluster-pool-create network-uuid=network_uuid [cluster-stack=cluster_stack] [token-timeout=token_timeout] [token-timeout-coefficient=token_timeout_coefficient]
<!--NeedCopy-->

Créer un cluster GFS2 à l’échelle du pool.

cluster-pool-destroy

xe cluster-pool-destroy cluster-uuid=cluster_uuid
<!--NeedCopy-->

Détruire le cluster GFS2 à l’échelle du pool. Le pool continue d’exister, mais il n’est plus en cluster GFS2 et ne peut plus utiliser les SR GFS2.

cluster-pool-force-destroy

xe cluster-pool-force-destroy cluster-uuid=cluster_uuid
<!--NeedCopy-->

Forcer la destruction du cluster GFS2 à l’échelle du pool.

cluster-pool-resync

xe cluster-pool-resync cluster-uuid=cluster_uuid
<!--NeedCopy-->

Resynchroniser un cluster GFS2 sur un pool.

Commandes de console

Commandes pour travailler avec les consoles.

Les objets console peuvent être listés avec la commande de liste d’objets standard (xe console-list), et les paramètres manipulés avec les commandes de paramètres standard. Pour plus d’informations, consultez Commandes de paramètres de bas niveau.

Paramètres de la console

Les consoles ont les paramètres suivants :

console

xe console
<!--NeedCopy-->

Se connecter à une console particulière.

Commandes de diagnostic

Commandes pour collecter des informations de diagnostic depuis XenServer.

diagnostic-compact

xe diagnostic-compact
<!--NeedCopy-->

Effectuer une collecte GC majeure et une compaction du tas.

diagnostic-db-stats

xe diagnostic-db-stats
<!--NeedCopy-->

Afficher les statistiques de la base de données.

diagnostic-gc-stats

xe diagnostic-gc-stats
<!--NeedCopy-->

Afficher les statistiques GC.

diagnostic-license-status

xe diagnostic-license-status
<!--NeedCopy-->

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

diagnostic-net-stats

xe diagnostic-net-stats [uri=uri] [method=method] [params=param1,param2...]
<!--NeedCopy-->

Afficher les statistiques réseau.

diagnostic-timing-stats

xe diagnostic-timing-stats
<!--NeedCopy-->

Afficher les statistiques de temps.

diagnostic-vdi-status

xe diagnostic-vdi-status uuid=vdi_uuid
<!--NeedCopy-->

Interroge l’état de verrouillage et de partage d’un VDI.

diagnostic-vm-status

xe diagnostic-vm-status uuid=vm_uuid
<!--NeedCopy-->

Interroge les hôtes sur lesquels la machine virtuelle peut démarrer, vérifie 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

xe drtask-create type=type sr-whitelist=sr-white-list device-config=device-config
<!--NeedCopy-->

Crée une tâche de reprise après sinistre. Par exemple, pour se connecter à un 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
<!--NeedCopy-->

Remarque :

La commande sr-whitelist répertorie les UUID de SR autorisés. La commande drtask-create introduit et se connecte uniquement à un SR qui possède l’un des UUID autorisés.

drtask-destroy

xe drtask-destroy uuid=dr-task-uuid
<!--NeedCopy-->

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

vm-assert-can-be-recovered

xe vm-assert-can-be-recovered uuid=vm-uuid database:vdi-uuid=vdi-uuid
<!--NeedCopy-->

Vérifie si le stockage est disponible pour récupérer cette machine virtuelle.

appliance-assert-can-be-recovered

xe appliance-assert-can-be-recovered uuid=appliance-uuid database:vdi-uuid=vdi-uuid
<!--NeedCopy-->

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

appliance-recover

xe appliance-recover uuid=appliance-uuid database:vdi-uuid=vdi-uuid [force=true|false]
<!--NeedCopy-->

Récupère une appliance/vAPP à partir de la base de données contenue dans le VDI fourni.

vm-recover

xe vm-recover uuid=vm-uuid database:vdi-uuid=vdi-uuid [force=true|false]
<!--NeedCopy-->

Récupère une VM à partir de la base de données contenue dans le VDI fourni.

sr-enable-database-replication

xe sr-enable-database-replication uuid=sr_uuid
<!--NeedCopy-->

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

sr-disable-database-replication

xe sr-disable-database-replication uuid=sr_uuid
<!--NeedCopy-->

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

Exemple d’utilisation

L’exemple ci-dessous montre les commandes CLI de DR en contexte :

Sur le site principal, activez la réplication de la base de données :

xe sr-database-replication uuid=sr=uuid
<!--NeedCopy-->

Après un sinistre, sur le site secondaire, connectez-vous au 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
<!--NeedCopy-->

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

xe vdi-list sr-uuid=sr-uuid type=Metadata
<!--NeedCopy-->

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

xe vm-list database:vdi-uuid=vdi-uuid
<!--NeedCopy-->

Récupérer une VM :

xe vm-recover uuid=vm-uuid database:vdi-uuid=vdi-uuid
<!--NeedCopy-->

Détruire la tâche de reprise après sinistre. Toutes les SR introduites par la tâche de reprise après sinistre et non requises par les VM sont détruites :

xe drtask-destroy uuid=drtask-uuid
<!--NeedCopy-->

Commandes d’événements

Commandes pour travailler avec les événements.

Classes d’événements

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

event-wait

xe event-wait class=class_name [param-name=param_value] [param-name=/=param_value]
<!--NeedCopy-->

Bloque l’exécution d’autres commandes jusqu’à ce qu’un objet existe qui satisfasse les conditions données sur la ligne de commande. L’argument x=y signifie « attendre que le champ x prenne la valeur y » et x=/=y signifie « attendre que le champ x prenne toute valeur autre que y ».

Exemple : attendre qu’une VM spécifique soit en cours d’exécution.

xe event-wait class=vm name-label=myvm power-state=running
<!--NeedCopy-->

Bloque les autres commandes jusqu’à ce qu’une VM appelée myvm soit dans l’état power-state “en cours d’exécution”.

Exemple : attendre qu’une VM spécifique redémarre :

xe event-wait class=vm uuid=$VM start-time=/=$(xe vm-list uuid=$VM params=start-time --minimal)
<!--NeedCopy-->

Bloque les autres commandes jusqu’à ce qu’une VM avec l’UUID $VM redémarre. La commande utilise la valeur de start-time pour déterminer quand la VM redémarre.

Le nom de la classe peut être l’une des classes d’événements répertoriées au début de cette section. Les paramètres peuvent être n’importe lequel des paramètres répertoriés dans la commande CLI class-param-list.

Commandes GPU

Commandes pour travailler avec les GPU physiques, les groupes de GPU et les GPU virtuels.

Les objets GPU peuvent être répertoriés avec les commandes standard de listage d’objets : xe pgpu-list, xe gpu-group-list et xe vgpu-list. Les paramètres peuvent être manipulés avec les commandes de paramètres standard. Pour plus d’informations, consultez Commandes de paramètres de bas niveau.

Paramètres GPU physiques

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

pgpu-disable-dom0-access

xe pgpu-disable-dom0-access uuid=uuid
<!--NeedCopy-->

Désactiver l’accès du PGPU à dom0.

pgpu-enable-dom0-access

xe pgpu-enable-dom0-access uuid=uuid
<!--NeedCopy-->

Activer l’accès du PGPU à dom0.

Paramètres du groupe de GPU

Les groupes de GPU ont les paramètres suivants :

Opérations de groupe de GPU

Commandes pour travailler avec les groupes de GPU

gpu-group-create

xe gpu-group-create name-label=name_for_group [name-description=description]
<!--NeedCopy-->

Crée un nouveau groupe GPU (vide) dans lequel les pGPU peuvent être déplacés.

gpu-group-destroy

xe gpu-group-destroy uuid=uuid_of_group
<!--NeedCopy-->

Détruit le groupe GPU ; autorisé uniquement pour les groupes vides.

gpu-group-get-remaining-capacity

xe gpu-group-get-remaining-capacity uuid=uuid_of_group vgpu-type-uuid=uuid_of_vgpu_type
<!--NeedCopy-->

Renvoie le nombre de GPU virtuels supplémentaires du type spécifié pouvant être instanciés dans ce groupe GPU.

gpu-group-param-set

xe gpu-group-param-set uuid=uuid_of_group allocation-algorithm=breadth-first|depth-first
<!--NeedCopy-->

Modifie l’algorithme que le groupe GPU utilise pour allouer des GPU virtuels aux pGPU.

Paramètres du GPU virtuel

Les GPU virtuels ont les paramètres suivants :

Paramètres de type de GPU virtuel

Remarque :

Le pass-through GPU et les GPU virtuels ne sont pas compatibles avec la migration en direct, la migration de stockage en direct ou la suspension de VM, sauf si des logiciels et des cartes graphiques pris en charge par les fournisseurs de GPU sont présents. Les VM sans ce support ne peuvent pas être migrées pour éviter les temps d’arrêt. Pour plus d’informations sur la compatibilité de NVIDIA vGPU avec la migration en direct, la migration de stockage en direct et la suspension de VM, consultez Graphiques.

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

Opérations de GPU virtuel

vgpu-create

xe vgpu-create vm-uuid=uuid_of_vm gpu_group_uuid=uuid_of_gpu_group [vgpu-type-uuid=uuid_of_vgpu-type]
<!--NeedCopy-->

Crée un GPU virtuel. Cette commande attache la machine virtuelle au groupe de GPU spécifié et spécifie éventuellement le type de GPU virtuel. Si aucun type de GPU virtuel n’est spécifié, le type ‘pass-through’ est supposé.

vgpu-destroy

xe vgpu-destroy uuid=uuid_of_vgpu
<!--NeedCopy-->

Détruire le GPU virtuel spécifié.

Désactivation de VNC pour les machines virtuelles avec GPU virtuel

xe vm-param-add uuid=uuid_of_vmparam-name=platform vgpu_vnc_enabled=true|false
<!--NeedCopy-->

L’utilisation de false désactive la console VNC pour une machine virtuelle car elle transmet disablevnc=1 à l’émulateur d’affichage. Par défaut, VNC est activé.

Commandes de l’hôte

Commandes pour interagir avec l’hôte XenServer.

Les hôtes XenServer sont les serveurs physiques exécutant le logiciel XenServer. Ils hébergent des machines virtuelles sous le contrôle d’une machine virtuelle privilégiée spéciale, connue sous le nom de domaine de contrôle ou domaine 0.

Les objets hôtes XenServer peuvent être listés avec les commandes de listage d’objets standard : xe host-list, xe host-cpu-list et xe host-crashdump-list). Les paramètres peuvent être manipulés avec les commandes de paramètres standard. Pour plus d’informations, consultez Commandes de paramètres de bas niveau.

Sélecteurs d’hôte

Plusieurs des commandes listées ici disposent d’un mécanisme commun pour sélectionner un ou plusieurs hôtes XenServer sur lesquels effectuer l’opération. Le plus simple est de fournir l’argument host=uuid_or_name_label. Vous pouvez également spécifier XenServer en filtrant la liste complète des hôtes sur les valeurs des champs. Par exemple, la spécification de enabled=true sélectionne tous les hôtes XenServer dont le champ enabled est égal à true. Lorsque plusieurs hôtes XenServer correspondent et que l’opération peut être effectuée sur plusieurs hôtes XenServer, vous devez spécifier --multiple pour effectuer l’opération. La liste complète des paramètres qui peuvent être mis en correspondance est décrite au début de cette section. Vous pouvez obtenir cette liste de commandes en exécutant la commande xe host-list params=all. Si aucun paramètre de sélection d’hôtes XenServer n’est fourni, l’opération est effectuée sur tous les hôtes XenServer.

Paramètres de l’hôte

Les hôtes XenServer ont les paramètres suivants :

Exemples :

• xe host-param-set uuid=<uuid> ntp-mode=Factory
• xe host-param-set uuid=<uuid> ntp-custom-servers=server1,server2
• xe host-param-set uuid=<uuid> timezone=UTC
• xe host-param-set uuid=<uuid> max-cstate=1

Les hôtes XenServer contiennent d’autres objets qui ont également des listes de paramètres.

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

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

host-all-editions

xe host-all-editions
<!--NeedCopy-->

Obtenir la liste de toutes les éditions disponibles

host-apply-edition

xe host-apply-edition [host-uuid=host_uuid] [edition=premium-per-socket|standard-per-socket|cloud]
<!--NeedCopy-->

Attribue la licence XenServer à un serveur hôte. Lorsque vous attribuez une licence, XenServer contacte le serveur de licences et demande le type de licence spécifié. Si une licence est disponible, elle est alors extraite du serveur de licences.

Pour la configuration initiale des licences, voir également license-server-address et license-server-port.

Les valeurs d’édition incluent « cloud », « free », « premium-per-socket » et « standard-per-socket ». À l’avenir, seul « cloud » sera pris en charge.

host-backup

xe host-backup file-name=backup_filename host=host_name
<!--NeedCopy-->

Téléchargez une sauvegarde du domaine de contrôle de l’hôte XenServer spécifié sur la machine à partir de laquelle la commande est invoquée. Enregistrez-la sous le nom de fichier file-name.

Important :

Bien que la commande xe host-backup fonctionne si elle est exécutée sur l’hôte local (c’est-à-dire sans nom d’hôte spécifique), ne l’utilisez pas de cette manière. Cela remplirait la partition du domaine de contrôle avec le fichier de sauvegarde. Utilisez la commande uniquement à partir d’une machine distante hors hôte où vous disposez d’espace pour stocker le fichier de sauvegarde.

host-bugreport-upload

xe host-bugreport-upload [host-selector=host_selector_value...] [url=destination_url http-proxy=http_proxy_name]
<!--NeedCopy-->

Générez un nouveau rapport de bogue (à l’aide de xen-bugtool, avec tous les fichiers facultatifs inclus) et téléchargez-le sur le site FTP du support ou à un autre emplacement.

Les hôtes sur lesquels effectuer cette opération sont sélectionnés à l’aide du mécanisme de sélection standard (voir sélecteurs d’hôtes ci-dessus). Les arguments facultatifs peuvent être n’importe quel nombre des paramètres d’hôte répertoriés au début de cette section.

Les paramètres facultatifs sont http-proxy : utiliser le proxy HTTP spécifié, et url : télécharger 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

xe host-call-plugin host-uuid=host_uuid plugin=plugin fn=function [args=args]
<!--NeedCopy-->

Appelle la fonction du plug-in sur l’hôte donné avec des arguments facultatifs.

host-compute-free-memory

xe host-compute-free-memory
<!--NeedCopy-->

Calcule la quantité de mémoire libre sur l’hôte.

host-compute-memory-overhead

xe host-compute-memory-overhead
<!--NeedCopy-->

Calcule la surcharge de mémoire de virtualisation d’un hôte.

host-cpu-info

xe host-cpu-info [uuid=uuid]
<!--NeedCopy-->

Liste les informations sur les CPU physiques de l’hôte.

host-crashdump-destroy

xe host-crashdump-destroy uuid=crashdump_uuid
<!--NeedCopy-->

Supprime un crashdump d’hôte spécifié par son UUID de l’hôte XenServer.

host-crashdump-upload

xe host-crashdump-upload uuid=crashdump_uuid [url=destination_url] [http-proxy=http_proxy_name]
<!--NeedCopy-->

Charge un crashdump sur le site FTP du 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 du support par défaut. Les paramètres facultatifs sont http-proxy : utiliser le proxy HTTP spécifié, et url : charger vers cette URL de destination.

host-declare-dead

xe host-declare-dead uuid=host_uuid
<!--NeedCopy-->

Déclare que l’hôte est hors service 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 hors service.

host-disable

xe host-disable [host-selector=host_selector_value...]
<!--NeedCopy-->

Désactive les hôtes XenServer spécifiés, ce qui empêche tout nouveau VM de démarrer sur ceux-ci. Cette action prépare les hôtes XenServer à être arrêtés ou redémarrés. Une fois que cet hôte a redémarré, si toutes les conditions d’activation sont remplies (par exemple, le stockage est disponible), l’hôte est automatiquement réactivé.

Les hôtes sur lesquels effectuer cette opération sont sélectionnés à l’aide du mécanisme de sélection standard (voir sélecteurs d’hôtes). Les arguments facultatifs peuvent être n’importe quel nombre des paramètres d’hôte listés au début de cette section.

host-disable-display

xe host-disable-display uuid=host_uuid
<!--NeedCopy-->

Désactiver l’affichage pour l’hôte.

host-disable-local-storage-caching

xe host-disable-local-storage-caching
<!--NeedCopy-->

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

host-dmesg

xe host-dmesg [host-selector=host_selector_value...]
<!--NeedCopy-->

Obtenir un dmesg Xen (la sortie du tampon circulaire du noyau) à partir des hôtes XenServer spécifiés.

Les hôtes sur lesquels effectuer cette opération sont sélectionnés à l’aide du mécanisme de sélection standard (voir sélecteurs d’hôtes ci-dessus). Les arguments facultatifs peuvent être n’importe quel nombre des paramètres d’hôte listés au début de cette section.

host-emergency-ha-disable

xe host-emergency-ha-disable  [--force]
<!--NeedCopy-->

Désactiver la HA sur l’hôte local. À utiliser uniquement pour récupérer un pool avec une configuration HA défectueuse.

host-emergency-management-reconfigure

xe host-emergency-management-reconfigure interface=uuid_of_management_interface_pif
<!--NeedCopy-->

Reconfigurer l’interface de gestion de cet hôte XenServer. Utilisez cette commande uniquement si l’hôte XenServer est en mode d’urgence. Le mode d’urgence signifie que l’hôte est membre d’un pool de ressources dont le coordinateur de pool a disparu du réseau et ne peut pas être contacté après plusieurs tentatives.

host-emergency-reset-server-certificate

xe host-emergency-reset-server-certificate
<!--NeedCopy-->

Installe un certificat auto-signé sur l’hôte XenServer où la commande est exécutée.

host-enable

xe host-enable [host-selector=host_selector_value...]
<!--NeedCopy-->

Active les hôtes XenServer spécifiés, ce qui permet de démarrer de nouvelles machines virtuelles sur ceux-ci.

Les hôtes sur lesquels effectuer cette opération sont sélectionnés à l’aide du mécanisme de sélection standard (voir sélecteurs d’hôtes ci-dessus). Les arguments facultatifs peuvent être n’importe quel nombre de paramètres d’hôte répertoriés au début de cette section.

host-enable-display

xe host-enable-display uuid=host_uuid
<!--NeedCopy-->

Active l’affichage pour l’hôte.

host-enable-local-storage-caching

xe host-enable-local-storage-caching  sr-uuid=sr_uuid
<!--NeedCopy-->

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

host-evacuate

xe host-evacuate [host-selector=host_selector_value...]
<!--NeedCopy-->

Migre en direct 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 coordinateur de pool, un autre hôte doit être sélectionné pour être le coordinateur de pool. Pour modifier le coordinateur de pool avec la haute disponibilité désactivée, utilisez la commande pool-designate-new-master. Pour plus d’informations, consultez pool-designate-new-master.

Avec la haute disponibilité activée, votre seule option est d’arrêter l’hôte XenServer, ce qui entraîne l’élection aléatoire d’un nouveau coordinateur de pool par la haute disponibilité. Pour plus d’informations, consultez host-shutdown.

Les hôtes sur lesquels effectuer cette opération sont sélectionnés à l’aide du mécanisme de sélection standard (voir sélecteurs d’hôtes ci-dessus). Les arguments facultatifs peuvent être n’importe quel nombre de paramètres d’hôte répertoriés au début de cette section.

host-forget

xe host-forget uuid=host_uuid
<!--NeedCopy-->

L’agent XAPI oublie l’hôte XenServer spécifié sans le contacter explicitement.

Utilisez le paramètre --force pour éviter d’être invité à confirmer que vous souhaitez réellement effectuer cette opération.

Avertissement :

N’utilisez pas cette commande si la HA est activée sur le pool. Désactivez d’abord la HA, puis réactivez-la après avoir oublié l’hôte.

Cette commande est utile si l’hôte XenServer à « oublier » est hors service. Cependant, si l’hôte XenServer est actif et fait partie du pool, utilisez xe pool-eject à la place.

host-get-server-certificate

xe host-get-server-certificate
<!--NeedCopy-->

Obtenir le certificat TLS du serveur installé.

host-get-sm-diagnostics

xe host-get-sm-diagnostics uuid=uuid
<!--NeedCopy-->

Afficher les informations de diagnostic SM par hôte.

host-get-system-status

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

Téléchargez les informations d’état du système dans le fichier spécifié. Le paramètre facultatif entries est une liste d’entrées d’état du système séparées par des virgules, extraites du fragment XML de capacités renvoyé par la commande host-get-system-status-capabilities. Pour plus d’informations, consultez host-get-system-status-capabilities. S’il n’est pas spécifié, toutes les informations d’état du système sont enregistrées dans le fichier. Le paramètre output peut être tar.bz2 (par défaut) ou zip. Si ce paramètre n’est pas spécifié, le fichier est enregistré au format tar.bz2.

Les hôtes sur lesquels effectuer cette opération sont sélectionnés à l’aide du mécanisme de sélection standard (voir sélecteurs d’hôtes ci-dessus).

host-get-system-status-capabilities

xe host-get-system-status-capabilities [host-selector=host_selector_value...]
<!--NeedCopy-->

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 similaire à 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>
<!--NeedCopy-->

Chaque entité de capacité peut avoir les attributs suivants.

• key Un identifiant unique pour la capacité.
• content-type Peut être text/plain ou application/data. 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 sélectionne cette entrée par défaut.
• min-size, max-size Indique une plage approximative pour la taille, en octets, de cette entrée. -1 indique que la taille n’est pas importante.
• min-time, max-time Indique une plage approximative pour le temps, en secondes, nécessaire à la collecte de cette entrée. -1 indique que le temps n’est pas important.

• pii Informations personnellement identifiables. Indique si l’entrée contient des informations permettant d’identifier le propriétaire du système ou des détails de sa topologie réseau. L’attribut peut avoir l’une des valeurs suivantes :

  • no: aucune PII n’est présente dans ces entrées
  • yes: des PII sont probablement ou certainement présentes dans ces entrées
  • maybe: vous pourriez vouloir auditer ces entrées pour des PII
  • if_customized si les fichiers ne sont pas modifiés, ils ne contiennent aucune PII. Cependant, comme 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 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 effectuer cette opération sont sélectionnés à l’aide du mécanisme de sélection standard (voir sélecteurs d’hôtes ci-dessus).

host-get-thread-diagnostics

xe host-get-thread-diagnostics uuid=uuid
<!--NeedCopy-->

Afficher les informations de diagnostic des threads par hôte.

host-get-vms-which-prevent-evacuation

xe host-get-vms-which-prevent-evacuation uuid=uuid
<!--NeedCopy-->

Retourne une liste de machines virtuelles qui empêchent l’évacuation d’un hôte spécifique et affiche les raisons pour chacune.

host-is-in-emergency-mode

xe host-is-in-emergency-mode
<!--NeedCopy-->

Retourne true si l’hôte avec lequel la CLI communique est en mode d’urgence, false sinon. Cette commande CLI fonctionne directement sur les hôtes membres du pool même en l’absence de coordinateur de pool.

host-license-view

xe host-license-view [host-uuid=host_uuid]
<!--NeedCopy-->

Affiche le contenu de la licence de l’hôte XenServer.

host-logs-download

xe host-logs-download [file-name=logfile_name] [host-selector=host_selector_value...]
<!--NeedCopy-->

Télécharge une copie des journaux des hôtes XenServer 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 file-name.

Les hôtes sur lesquels effectuer cette opération sont sélectionnés à l’aide du mécanisme de sélection standard (voir sélecteurs d’hôtes ci-dessus). Les arguments facultatifs peuvent être n’importe quel nombre des paramètres d’hôte listés au début de cette section.

Important :

Bien que la commande xe host-logs-download fonctionne si elle est exécutée sur l’hôte local (c’est-à-dire sans nom d’hôte spécifique), ne l’utilisez pas de cette manière. Cela encombre la partition du domaine de contrôle avec la copie des journaux. N’utilisez la commande qu’à partir d’une machine distante hors hôte où vous disposez d’espace pour conserver la copie des journaux.

host-management-disable

xe host-management-disable
<!--NeedCopy-->

Désactive l’agent hôte écoutant sur une interface réseau de gestion externe et déconnecte tous les clients API connectés (tels que XenCenter). Cette commande opère directement sur l’hôte XenServer auquel la CLI est connectée. La commande n’est pas transmise au coordinateur de pool lorsqu’elle est appliquée à un hôte XenServer membre.

Avertissement :

Soyez prudent lorsque vous utilisez cette commande CLI hors hôte. Une fois cette commande exécutée, vous ne pourrez plus vous connecter au domaine de contrôle à distance via le réseau pour réactiver l’agent hôte.

host-management-reconfigure

xe host-management-reconfigure [interface=device] [pif-uuid=uuid]
<!--NeedCopy-->

Reconfigure l’hôte XenServer pour utiliser l’interface réseau spécifiée comme interface de gestion, qui est l’interface utilisée pour se connecter à XenCenter. La commande réécrit la clé MANAGEMENT_INTERFACE dans /etc/xensource-inventory.

Si le nom de périphérique d’une interface (qui doit avoir une adresse IP) est spécifié, l’hôte XenServer se relie immédiatement. Cette commande fonctionne en mode normal et en mode d’urgence.

Si l’UUID d’un objet PIF est spécifié, l’hôte XenServer détermine quelle adresse IP il doit se réaffecter. 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 de l’hôte et assurez-vous d’avoir une connectivité réseau sur la nouvelle interface. Utilisez xe pif-reconfigure pour en configurer une d’abord. Sinon, les commandes CLI ultérieures ne pourront pas atteindre l’hôte XenServer.

host-power-on

xe host-power-on [host=host_uuid]
<!--NeedCopy-->

Met sous tension les hôtes XenServer avec la fonction Host Power On activée. Avant d’utiliser cette commande, activez host-set-power-on sur l’hôte.

host-reboot

xe host-reboot [host-selector=host_selector_value...]
<!--NeedCopy-->

Redémarrez les hôtes XenServer spécifiés. Les hôtes spécifiés doivent d’abord être désactivés à l’aide de la commande xe host-disable, sinon un message d’erreur HOST_IN_USE s’affiche.

Les hôtes sur lesquels effectuer cette opération 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 des paramètres d’hôte énumérés au début de cette section.

Si les hôtes XenServer spécifiés sont membres d’un pool, la perte de connectivité lors de l’arrêt est gérée et le pool se rétablit lorsque les hôtes XenServer reviennent. Les autres membres et le coordinateur de pool continuent de fonctionner.

Si vous arrêtez le coordinateur de pool, le pool est hors service jusqu’à ce que l’une des actions suivantes se produise :

• Vous faites de l’un des membres le coordinateur de pool

• Le coordinateur de pool d’origine est redémarré et de nouveau en ligne.

  Lorsque le coordinateur de pool est de nouveau en ligne, les membres se reconnectent et se synchronisent avec le coordinateur de pool.

host-restore

xe host-restore [file-name=backup_filename] [host-selector=host_selector_value...]
<!--NeedCopy-->

Restaure une sauvegarde nommée file-name du logiciel de contrôle de l’hôte XenServer. L’utilisation du mot « restaurer » ici ne signifie pas une restauration complète au sens habituel, cela signifie simplement que le fichier de sauvegarde compressé a été décompressé et dépaqueté sur la partition secondaire. Après avoir effectué un xe host-restore, vous devez démarrer le CD d’installation et utiliser son option Restaurer à partir de la sauvegarde.

Les hôtes sur lesquels effectuer cette opération 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 des paramètres d’hôte énumérés au début de cette section.

host-send-debug-keys

xe host-send-debug-keys  host-uuid=host_uuid keys=keys
<!--NeedCopy-->

Envoie les clés de débogage de l’hyperviseur spécifiées à l’hôte spécifié.

host-server-certificate-install

xe host-server-certificate-install certificate=path_to_certificate_file private-key=path_to_private_key [certificate-chain=path_to_chain_file] [host=host_name | uuid=host_uuid]
<!--NeedCopy-->

Installe un certificat TLS sur un hôte XenServer.

host-set-hostname-live

xe host-set-hostname-live host-uuid=uuid_of_host host-name=new_hostname
<!--NeedCopy-->

Modifie le nom d’hôte de l’hôte XenServer spécifié par host-uuid. Cette commande définit de manière persistante à la fois le nom d’hôte dans la base de données du domaine de contrôle et le nom d’hôte Linux réel de l’hôte XenServer. La valeur de host-name n’est pas la même que la valeur du champ name_label.

host-set-power-on-mode

xe host-set-power-on-mode host=host_uuid power-on-mode={"" | "wake-on-lan" | "IPMI" | "custom"} \
    [ power-on-config:power_on_ip=ip-address power-on-config:power_on_user=user power-on-config:power_on_password_secret=secret-uuid ]
<!--NeedCopy-->

Permet d’activer la fonction Mise sous tension de l’hôte sur les hôtes XenServer compatibles avec les solutions d’alimentation à distance. Lorsque vous utilisez la commande host-set-power-on, vous devez spécifier le type de solution de gestion de l’alimentation sur l’hôte (c’est-à-dire le mode de mise sous tension). Ensuite, spécifiez les options de configuration à l’aide de l’argument power-on-config et de ses paires clé-valeur associées.

Pour utiliser la fonction de secrets afin de stocker votre mot de passe, spécifiez la clé "power_on_password_secret". Pour plus d’informations, consultez Secrets.

host-shutdown

xe host-shutdown [host-selector=host_selector_value...]
<!--NeedCopy-->

Arrête les hôtes XenServer spécifiés. Les hôtes XenServer spécifiés doivent d’abord être désactivés à l’aide de la commande xe host-disable, sinon un message d’erreur HOST_IN_USE s’affiche.

Les hôtes sur lesquels effectuer cette opération 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 des paramètres d’hôte énumérés au début de cette section.

Si les hôtes XenServer spécifiés sont membres d’un pool, la perte de connectivité lors de l’arrêt est gérée et le pool se rétablit lorsque les hôtes XenServer reviennent. Les autres membres et le coordinateur de pool continuent de fonctionner.

Si vous arrêtez le coordinateur de pool, le pool est inactif jusqu’à ce que l’une des actions suivantes se produise :

• Vous faites d’un des membres le coordinateur de pool

• Le coordinateur de pool d’origine est redémarré et de nouveau en ligne.

  Lorsque le coordinateur de pool est de nouveau en ligne, les membres se reconnectent et se synchronisent avec le coordinateur de pool.

Si la haute disponibilité (HA) est activée pour le pool, l’un des membres est automatiquement désigné comme coordinateur de pool. Si la haute disponibilité (HA) est désactivée, vous devez désigner manuellement l’hôte XenServer souhaité comme coordinateur de pool avec la commande pool-designate-new-master. Pour plus d’informations, consultez pool-designate-new-master.

host-sm-dp-destroy

xe host-sm-dp-destroy uuid=uuid dp=dp [allow-leak=true|false]
<!--NeedCopy-->

Tente de détruire et de nettoyer un chemin de données de stockage sur un hôte. Si allow-leak=true est fourni, il supprime tous les enregistrements du chemin de données même s’il n’est pas arrêté proprement.

host-sync-data

xe host-sync-data
<!--NeedCopy-->

Synchronise les données stockées sur le coordinateur de pool avec l’hôte nommé. Cela n’inclut pas les données de la base de données).

host-syslog-reconfigure

xe host-syslog-reconfigure [host-selector=host_selector_value...]
<!--NeedCopy-->

Reconfigure le démon syslog sur les hôtes XenServer spécifiés. Cette commande applique les informations de configuration définies dans le paramètre logging de l’hôte.

Les hôtes sur lesquels effectuer cette opération sont sélectionnés à l’aide du mécanisme de sélection standard (voir sélecteurs d’hôtes ci-dessus). Les arguments facultatifs peuvent être n’importe quel nombre des paramètres d’hôte listés au début de cette section.

host-data-source-list

xe host-data-source-list [host-selectors=host selector value...]
<!--NeedCopy-->

Liste les sources de données qui peuvent être enregistrées pour un hôte.

Sélectionnez les hôtes sur lesquels effectuer cette opération en utilisant le mécanisme de sélection standard (voir sélecteurs d’hôtes). Les arguments facultatifs peuvent être n’importe quel nombre des paramètres d’hôte listés au début de cette section. Si aucun paramètre de sélection d’hôtes n’est fourni, l’opération est effectuée sur tous les hôtes.

Les sources de données ont deux paramètres – standard et enabled. Cette commande affiche les valeurs des paramètres :

• Si une source de données a enabled défini sur true, les métriques sont actuellement enregistrées dans la base de données de performances.
• Si une source de données a standard défini sur true, les métriques sont enregistrées dans la base de données de performances par défaut. La valeur de enabled est également définie sur true pour cette source de données.
• Si une source de données a standard défini sur false, les métriques ne sont pas enregistrées dans la base de données de performances par défaut. La valeur de enabled est également définie sur false pour cette source de données.

Pour commencer à enregistrer les métriques de la 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 la commande host-data-source-forget. Cette commande définit enabled sur false.

host-data-source-record

xe host-data-source-record data-source=name_description_of_data_source [host-selectors=host_selector_value...]
<!--NeedCopy-->

Enregistre 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 métriques de performances persistante des hôtes spécifiés. Pour des raisons de performances, cette base de données est distincte de la base de données d’agents normale.

Sélectionnez les hôtes sur lesquels effectuer cette opération en utilisant le mécanisme de sélection standard (voir sélecteurs d’hôtes). Les arguments facultatifs peuvent être n’importe quel nombre des paramètres d’hôte listés au début de cette section. Si aucun paramètre de sélection d’hôtes n’est fourni, l’opération est effectuée sur tous les hôtes.

host-data-source-forget

xe host-data-source-forget data-source=name_description_of_data_source [host-selectors=host_selector_value...]
<!--NeedCopy-->

Arrête l’enregistrement de la source de données spécifiée pour un hôte et supprime toutes les données enregistrées.

Sélectionnez les hôtes sur lesquels effectuer cette opération en utilisant le mécanisme de sélection standard (voir sélecteurs d’hôtes). Les arguments facultatifs peuvent être n’importe quel nombre des paramètres d’hôte listés au début de cette section. Si aucun paramètre de sélection d’hôtes n’est fourni, l’opération est effectuée sur tous les hôtes.

host-data-source-query

xe host-data-source-query data-source=name_description_of_data_source [host-selectors=host_selector_value...]
<!--NeedCopy-->

Affiche la source de données spécifiée pour un hôte.

Sélectionnez les hôtes sur lesquels effectuer cette opération en utilisant le mécanisme de sélection standard (voir sélecteurs d’hôtes). Les arguments facultatifs peuvent être n’importe quel nombre des paramètres d’hôte listés au début de cette section. Si aucun paramètre de sélection d’hôtes n’est fourni, l’opération est effectuée sur tous les hôtes.

Commandes de messages

Commandes pour travailler avec les messages. Les messages sont créés pour informer les utilisateurs d’événements importants et sont affichés dans XenCenter sous forme d’alertes.

Les objets message peuvent être listés avec la commande de liste 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 de messages

message-create

xe message-create name=message_name body=message_text [[host-uuid=uuid_of_host] | [sr-uuid=uuid_of_sr] | [vm-uuid=uuid_of_vm] | [pool-uuid=uuid_of_pool]]
<!--NeedCopy-->

Crée un message.

message-destroy

xe message-destroy [uuid=message_uuid]
<!--NeedCopy-->

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
<!--NeedCopy-->

Commandes réseau

Commandes pour travailler avec les réseaux.

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

Paramètres réseau

Les réseaux ont les paramètres suivants :

network-create

xe network-create name-label=name_for_network [name-description=descriptive_text]
<!--NeedCopy-->

Crée un réseau.

network-destroy

xe network-destroy uuid=network_uuid
<!--NeedCopy-->

Détruit un réseau existant.

Commandes SR-IOV

Commandes pour travailler avec SR-IOV.

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

Paramètres SR-IOV

SR-IOV possède les paramètres suivants :

network-sriov-create

xe network-sriov-create network-uuid=network_uuid pif-uuid=physical_pif_uuid
<!--NeedCopy-->

Crée un objet réseau SR-IOV pour une PIF physique donnée et active SR-IOV sur la PIF physique.

network-sriov-destroy

xe network-sriov-destroy uuid=network_sriov_uuid
<!--NeedCopy-->

Supprime un objet réseau SR-IOV et désactive SR-IOV sur sa PIF physique.

Attribuer un VF SR-IOV

xe vif-create device=device_index mac=vf_mac_address network-uuid=sriov_network vm-uuid=vm_uuid
<!--NeedCopy-->

Attribue un VF d’un réseau SR-IOV à une VM.

Commandes du contrôleur SDN

Commandes pour travailler avec le contrôleur SDN.

sdn-controller-forget

xe sdn-controller-introduce [address=address] [protocol=protocol] [tcp-port=tcp_port]
<!--NeedCopy-->

Introduire un contrôleur SDN.

sdn-controller-introduce

xe sdn-controller-forget uuid=uuid
<!--NeedCopy-->

Supprimer un contrôleur SDN.

Commandes de tunnel

Commandes pour travailler avec les tunnels.

tunnel-create

xe tunnel-create pif-uuid=pif_uuid network-uuid=network_uuid
<!--NeedCopy-->

Créer un nouveau tunnel sur un hôte.

tunnel-destroy

xe tunnel-destroy uuid=uuid
<!--NeedCopy-->

Détruire un tunnel.

Commandes de correctif

Commandes pour travailler avec les correctifs.

patch-apply

xe patch-apply uuid=patch_uuid host-uuid=host_uuid
<!--NeedCopy-->

Appliquer le correctif précédemment téléchargé à l’hôte spécifié.

patch-clean

xe patch-clean uuid=uuid
<!--NeedCopy-->

Supprimer un fichier de correctif précédemment téléchargé.

patch-destroy

xe patch-destroy uuid=uuid
<!--NeedCopy-->

Supprimer un enregistrement de correctif non appliqué et les fichiers de l’hôte.

patch-pool-apply

xe patch-pool-apply uuid=uuid
<!--NeedCopy-->

Appliquer le correctif précédemment téléchargé à tous les hôtes du pool.

patch-pool-clean

xe patch-pool-clean uuid=uuid
<!--NeedCopy-->

Supprimer un fichier de correctif précédemment téléchargé sur tous les hôtes du pool.

patch-precheck

xe patch-precheck uuid=uuid host-uuid=host_uuid
<!--NeedCopy-->

Exécuter les vérifications préalables contenues dans le correctif précédemment téléchargé sur l’hôte spécifié.

patch-upload

xe patch-upload file-name=file_name
<!--NeedCopy-->

Télécharger un fichier de correctif sur l’hôte.

Commandes PBD

Commandes pour travailler avec les PBD (Physical Block Devices). Les PBD sont les objets logiciels par lesquels l’hôte XenServer accède aux référentiels de stockage (SR).

Les objets PBD peuvent être listé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, consultez Commandes de paramètres de bas niveau

Paramètres PBD

Les PBD ont les paramètres suivants :

pbd-create

xe pbd-create host-uuid=uuid_of_host sr-uuid=uuid_of_sr [device-config:key=corresponding_value]
<!--NeedCopy-->

Créez un PBD sur votre hôte XenServer. Le paramètre device-config en lecture seule ne peut être défini qu’à la création.

Pour ajouter un mappage de ‘path’ vers ‘/tmp’, assurez-vous que la ligne de commande contient l’argument device-config:path=/tmp

Pour une liste complète des paires clé-valeur de configuration de périphérique prises en charge sur chaque type de SR, voir Stockage.

pbd-destroy

xe pbd-destroy uuid=uuid_of_pbd
<!--NeedCopy-->

Détruire le PBD spécifié.

pbd-plug

xe pbd-plug uuid=uuid_of_pbd
<!--NeedCopy-->

Tente de brancher le PBD à l’hôte XenServer. Si cette commande réussit, le SR référencé (et les VDI qu’il contient) devient visible pour l’hôte XenServer.

pbd-unplug

xe pbd-unplug uuid=uuid_of_pbd
<!--NeedCopy-->

Tente de débrancher le PBD de l’hôte XenServer.

Commandes PIF

Commandes pour travailler avec les PIF (objets représentant les interfaces réseau physiques).

Les objets PIF peuvent être listés avec la commande de liste 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 PIF ont les paramètres suivants :

Remarque :

Les modifications apportées aux champs other-config d’une PIF ne prendront effet qu’après un redémarrage. Alternativement, utilisez les commandes xe pif-unplug et xe pif-plug pour que la configuration de la PIF soit réécrite.

pif-forget

xe pif-forget uuid=uuid_of_pif
<!--NeedCopy-->

Détruit l’objet PIF spécifié sur un hôte particulier.

pif-introduce

xe pif-introduce host-uuid=host_uuid mac=mac_address_for_pif device=interface_name
<!--NeedCopy-->

Crée un objet PIF représentant une interface physique sur l’hôte XenServer spécifié.

pif-plug

xe pif-plug uuid=uuid_of_pif
<!--NeedCopy-->

Tente de démarrer l’interface physique spécifiée.

pif-reconfigure-ip

xe pif-reconfigure-ip uuid=uuid_of_pif [mode=dhcp|mode=static] gateway=network_gateway_address IP=static_ip_for_this_pif netmask=netmask_for_this_pif [DNS=dns_address]
<!--NeedCopy-->

Modifie l’adresse IP de la PIF. Pour une configuration IP statique, définissez le paramètre mode sur static, avec les paramètres gateway, IP 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.

Remarque :

L’utilisation d’adresses IP statiques sur des interfaces réseau physiques connectées à un port sur un commutateur utilisant le 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

xe pif-reconfigure-ipv6 uuid=uuid_of_pif mode=mode [gateway=network_gateway_address] [IPv6=static_ip_for_this_pif] [DNS=dns_address]
<!--NeedCopy-->

Reconfigure les paramètres d’adresse IPv6 sur une PIF.

pif-scan

xe pif-scan host-uuid=host_uuid
<!--NeedCopy-->

Recherche de nouvelles interfaces physiques sur votre hôte XenServer.

pif-set-primary-address-type

xe pif-set-primary-address-type  uuid=uuid primary_address_type=address_type
<!--NeedCopy-->

Modifier le type d’adresse primaire utilisé par cette PIF.

pif-unplug

xe pif-unplug uuid=uuid_of_pif
<!--NeedCopy-->

Tenter de désactiver l’interface physique spécifiée.

Commandes de pools

Commandes pour travailler avec les pools. Un pool est un agrégat d’un ou plusieurs hôtes XenServer. 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 pendant que la machine virtuelle est toujours en cours d’exécution, sans qu’il soit nécessaire de l’arrêter et de la redémarrer.

Chaque hôte XenServer est en réalité un pool composé d’un seul membre par défaut. Lorsque votre hôte XenServer est joint à un pool, il est désigné comme membre. Si le pool auquel l’hôte est joint se compose d’un seul membre, ce membre devient le coordinateur du pool. Si le pool auquel l’hôte est joint compte déjà plusieurs membres, l’un de ces membres est déjà le coordinateur du pool et le reste lorsque le nouvel hôte rejoint le pool.

L’objet pool singleton peut être listé avec la commande de liste d’objets standard (xe pool-list). Ses paramètres peuvent être manipulés avec les commandes de paramètres standard. Pour plus d’informations, consultez Commandes de paramètres de bas niveau

Paramètres de pool

Les pools ont les paramètres suivants :

pool-apply-edition

xe pool-apply-edition edition=cloud|standard-per-socket|premium-per-socket [uuid=uuid] [license-server-address=address] [license-server-port=port]
<!--NeedCopy-->

Appliquer une édition à l’ensemble du pool. Les valeurs d’édition incluent “cloud”, “standard-per-socket” et “premium-per-socket”. À l’avenir, seule “cloud” sera prise en charge.

pool-certificate-install

xe pool-certificate-install filename=file_name
<!--NeedCopy-->

Installer un certificat TLS, à l’échelle du pool.

pool-certificate-list

xe pool-certificate-list
<!--NeedCopy-->

Lister tous les certificats TLS installés dans un pool.

pool-certificate-sync

xe pool-certificate-sync
<!--NeedCopy-->

Synchroniser les certificats TLS et les listes de révocation de certificats du coordinateur de pool vers les autres membres du pool.

pool-certificate-uninstall

xe pool-certificate-uninstall name=name
<!--NeedCopy-->

Désinstaller un certificat TLS.

pool-crl-install

xe pool-crl-install filename=file_name
<!--NeedCopy-->

Installer une liste de révocation de certificats TLS, à l’échelle du pool.

pool-crl-list

xe pool-crl-list
<!--NeedCopy-->

Lister toutes les listes de révocation de certificats TLS installées.

pool-crl-uninstall

xe pool-crl-uninstall name=name
<!--NeedCopy-->

Désinstaller une liste de révocation de certificats TLS.

pool-deconfigure-wlb

xe pool-deconfigure-wlb
<!--NeedCopy-->

Supprimer définitivement la configuration pour l’équilibrage de charge.

pool-designate-new-master

xe pool-designate-new-master host-uuid=uuid_of_new_master
<!--NeedCopy-->

Demander à l’hôte XenServer membre spécifié de devenir le coordinateur (anciennement appelé « maître ») d’un pool existant. Cette commande effectue un transfert ordonné du rôle de coordinateur de pool vers un autre hôte du pool de ressources. Cette commande ne fonctionne que lorsque le coordinateur de pool actuel est en ligne. Elle ne remplace pas les commandes en mode d’urgence listées ci-dessous.

pool-disable-external-auth

xe pool-disable-external-auth [uuid=uuid] [config=config]
<!--NeedCopy-->

Désactive l’authentification externe sur tous les hôtes d’un pool.

pool-disable-local-storage-caching

xe pool-disable-local-storage-caching uuid=uuid
<!--NeedCopy-->

Désactiver la mise en cache du stockage local sur l’ensemble du pool.

pool-disable-redo-log

xe pool-disable-redo-log
<!--NeedCopy-->

Désactiver le journal de relecture s’il est utilisé, sauf si la haute disponibilité (HA) est activée.

pool-dump-database

xe pool-dump-database file-name=filename_to_dump_database_into_(on_client)
<!--NeedCopy-->

Télécharger une copie de l’intégralité de la base de données du pool et la vider dans un fichier sur le client.

pool-enable-external-auth

xe pool-enable-external-auth  auth-type=auth_type service-name=service_name [uuid=uuid] [config:=config]
<!--NeedCopy-->

Active l’authentification externe sur tous les hôtes d’un pool. Notez que certaines valeurs de auth-type nécessiteront des valeurs config: particulières.

pool-enable-local-storage-caching

xe pool-enable-local-storage-caching uuid=uuid
<!--NeedCopy-->

Activer la mise en cache du stockage local sur l’ensemble du pool.

pool-enable-redo-log

xe pool-ensable-redo-log sr-uuid=sr_uuid
<!--NeedCopy-->

Activer le journal de relecture sur le SR donné s’il est utilisé, sauf si la haute disponibilité (HA) est activée.

pool-eject

xe pool-eject host-uuid=uuid_of_host_to_eject
<!--NeedCopy-->

Demander à l’hôte XenServer spécifié de quitter un pool existant.

pool-emergency-reset-master

xe pool-emergency-reset-master master-address=address_of_pool_master
<!--NeedCopy-->

Demander à un hôte membre du pool de réinitialiser l’adresse de son coordinateur de pool à la nouvelle valeur et de tenter de s’y connecter. N’exécutez pas cette commande sur les coordinateurs de pool.

pool-emergency-transition-to-master

xe pool-emergency-transition-to-master
<!--NeedCopy-->

Demander à un hôte XenServer membre de devenir le coordinateur de pool (anciennement appelé « maître de pool »). L’hôte XenServer n’accepte cette commande qu’après être passé en mode d’urgence. Le mode d’urgence signifie qu’il est membre d’un pool dont le coordinateur 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 entraîner la réinitialisation du mot de passe de l’hôte. Pour plus d’informations, consultez (Commandes utilisateur).

pool-ha-enable

xe pool-ha-enable heartbeat-sr-uuids=uuid_of_heartbeat_sr
<!--NeedCopy-->

Activer la haute disponibilité sur le pool de ressources, en utilisant l’UUID SR spécifié comme référentiel central de pulsations de stockage.

pool-ha-disable

xe pool-ha-disable
<!--NeedCopy-->

Désactive la fonction de haute disponibilité sur le pool de ressources.

pool-ha-compute-hypothetical-max-host-failures-to-tolerate

Calculer le nombre maximal de pannes d’hôte à tolérer dans la configuration actuelle du pool.

pool-ha-compute-max-host-failures-to-tolerate

xe pool-ha-compute-hypothetical-max-host-failures-to-tolerate [vm-uuid=vm_uuid] [restart-priority=restart_priority]
<!--NeedCopy-->

Calculer le nombre maximal de pannes d’hôte à tolérer avec les machines virtuelles protégées proposées et fournies.

pool-initialize-wlb

xe pool-initialize-wlb wlb_url=url wlb_username=wlb_username wlb_password=wlb_password xenserver_username=username xenserver_password=password
<!--NeedCopy-->

Initialiser l’équilibrage de charge pour le pool actuel avec le serveur d’équilibrage de charge cible.

pool-join

xe pool-join master-address=address master-username=username master-password=password
<!--NeedCopy-->

Demandez à votre hôte XenServer de rejoindre un pool existant.

pool-management-reconfigure

xe pool-management-reconfigure [network-uuid=network-uuid]
<!--NeedCopy-->

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 à XenCenter. La commande réécrit la clé MANAGEMENT_INTERFACE dans /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é, le coordinateur du pool XenServer se lie immédiatement. Cette commande fonctionne en mode normal et en mode d’urgence.

À partir de l’UUID réseau spécifié, l’UUID de l’objet PIF est identifié et mappé à l’hôte XenServer, ce qui détermine l’adresse IP à laquelle se relier. 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 d’avoir une connectivité réseau sur la nouvelle interface. Utilisez xe pif-reconfigure pour en configurer une d’abord. Sinon, les commandes CLI ultérieures ne pourront pas atteindre l’hôte XenServer.

pool-recover-slaves

xe pool-recover-slaves
<!--NeedCopy-->

Demandez au coordinateur du pool d’essayer de réinitialiser l’adresse de tous les membres actuellement en mode d’urgence. Cette commande est généralement utilisée après que pool-emergency-transition-to-master a été utilisé pour définir l’un des membres comme nouveau coordinateur du pool.

pool-restore-database

xe pool-restore-database file-name=filename_to_restore_from_on_client [dry-run=true|false]
<!--NeedCopy-->

Téléchargez une sauvegarde de base de données (créée avec pool-dump-database) vers un pool. Lors de la réception du téléchargement, le coordinateur du pool redémarre avec la nouvelle base de données.

Il existe également une option de simulation (dry run), qui vous permet de vérifier que la base de données du pool peut être restaurée sans réellement effectuer l’opération. Par défaut, dry-run est défini sur false.

pool-retrieve-wlb-configuration

xe pool-retrieve-wlb-configuration
<!--NeedCopy-->

Récupère les critères d’optimisation du pool du serveur Workload Balancing.

pool-retrieve-wlb-diagnostics

xe pool-retrieve-wlb-diagnostics [filename=file_name]
<!--NeedCopy-->

Récupère les diagnostics du serveur Workload Balancing.

pool-retrieve-wlb-recommendations

xe pool-retrieve-wlb-recommendations
<!--NeedCopy-->

Récupère les recommandations de migration de VM pour le pool du serveur Workload Balancing.

pool-retrieve-wlb-report

xe pool-retrieve-wlb-report report=report [filename=file_name]
<!--NeedCopy-->

Récupère les rapports du serveur Workload Balancing.

pool-secret-rotate

xe pool-secret-rotate
<!--NeedCopy-->

Renouveler le secret du pool.

Le secret du pool est un secret partagé entre les hôtes XenServer d’un pool qui permet à l’hôte de prouver son appartenance à un pool. Les utilisateurs ayant le rôle d’administrateur de pool peuvent afficher ce secret lors de la connexion à l’hôte via SSH. Renouvelez le secret du pool si l’un de ces utilisateurs quitte votre organisation ou perd son rôle d’administrateur de pool.

pool-send-test-post

xe pool-send-test-post dest-host=destination_host dest-port=destination_port body=post_body
<!--NeedCopy-->

Envoie le corps donné à l’hôte et au port donnés, en utilisant HTTPS, et affiche la réponse. Ceci est utilisé pour le débogage de la couche TLS.

pool-send-wlb-configuration

xe pool-send-wlb-configuration [config:=config]
<!--NeedCopy-->

Définit les critères d’optimisation du pool pour le serveur Workload Balancing.

pool-sync-database

xe pool-sync-database
<!--NeedCopy-->

Force la synchronisation de la base de données du pool sur tous les hôtes du pool de ressources. Cette commande n’est pas nécessaire en fonctionnement normal car la base de données est régulièrement répliquée automatiquement. Cependant, la commande peut être utile pour garantir que les modifications sont rapidement répliquées après l’exécution d’un ensemble important d’opérations CLI.

Définir https-only

xe pool-param-set [uuid=pool-uuid] [https-only=true|false]
<!--NeedCopy-->

Active ou désactive le blocage du port 80 sur l’interface de gestion des hôtes XenServer.

Commandes de l’accélérateur PVS

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

pvs-cache-storage-create

xe pvs-cache-storage-create sr-uuid=sr_uuid pvs-site-uuid=pvs_site_uuid size=size
<!--NeedCopy-->

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

pvs-cache-storage-destroy

xe pvs-cache-storage-destroy uuid=uuid
<!--NeedCopy-->

Supprime un cache PVS.

pvs-proxy-create

xe pvs-proxy-create pvs-site-uuid=pvs_site_uuid vif-uuid=vif_uuid
<!--NeedCopy-->

Configure une VM/VIF pour utiliser un proxy PVS.

pvs-proxy-destroy

xe pvs-proxy-destroy uuid=uuid
<!--NeedCopy-->

Supprime (ou désactive) un proxy PVS pour cette VIF/VM.

pvs-server-forget

xe pvs-server-forget uuid=uuid
<!--NeedCopy-->

Oublie un serveur PVS.

pvs-server-introduce

xe pvs-server-introduce addresses=adresses first-port=first_port last-port=last_port pvs-site-uuid=pvs_site_uuid
<!--NeedCopy-->

Introduire un nouveau serveur PVS.

pvs-site-forget

xe pvs-site-forget uuid=uuid
<!--NeedCopy-->

Oublier un site PVS.

pvs-site-introduce

xe pvs-site-introduce name-label=name_label [name-description=name_description] [pvs-uuid=pvs_uuid]
<!--NeedCopy-->

Introduire un nouveau site PVS.

Commandes du gestionnaire de stockage

Commandes pour contrôler les plug-ins du gestionnaire de stockage.

Les objets du gestionnaire de stockage peuvent être listés avec la commande standard de listage d’objets (xe sm-list). Les paramètres peuvent être manipulés avec les commandes de paramètres standard. Pour plus d’informations, consultez Commandes de paramètres de bas niveau

Paramètres SM

Les SM ont les paramètres suivants :

Gérer l’accès SSH sur les hôtes et les pools

Présentation

Dans XenServer 8.4, l’accès SSH à dom0 est désormais activé par défaut. Cette version introduit la capacité de contrôler l’accès SSH de manière programmatique en utilisant soit l’API XenAPI, soit l’interface de ligne de commande (CLI) xe.

Cette amélioration permet aux administrateurs de gérer l’accès SSH au niveau de l’hôte individuel et de l’ensemble du pool, éliminant ainsi le besoin d’une interaction manuelle avec chaque console de serveur.

Avantages

• Gestion automatisée : Activez ou désactivez SSH sur des hôtes individuels ou sur l’ensemble d’un pool de manière programmatique.

• Réduction de la charge administrative : Réduisez considérablement l’effort administratif manuel requis pour gérer l’accès SSH.

• Flux de travail améliorés : Améliorez les scripts d’automatisation et renforcez les flux de travail de sécurité en intégrant le contrôle SSH dans les systèmes de gestion existants.

Compatibilité et mises en garde

• Aucune exigence supplémentaire : Cette fonctionnalité ne nécessite aucune configuration supplémentaire ni ajustement de compatibilité spécifique.

• Comportement du service : La désactivation de SSH arrêtera et désactivera le service sshd sur l’hôte (ou les hôtes) spécifié(s).

• Sessions existantes : Toutes les sessions SSH existantes resteront actives et ininterrompues même après la désactivation du service.

• Nouvelles connexions : Les nouvelles tentatives de connexion seront refusées une fois SSH désactivé.

• Opérations à l’échelle du pool : Les opérations effectuées sur l’ensemble d’un pool se poursuivront même si un ou plusieurs hôtes du pool rencontrent une défaillance.

Un message récapitulatif sera fourni, détaillant toutes les opérations ayant échoué.

Configuration de la CLI

Activer SSH sur un hôte

xe host-enable-ssh host=<host_uuid_or_name_label>
<!--NeedCopy-->

Cette commande démarre et active le service sshd sur l’hôte spécifié. Pour les sélecteurs host valides, consultez Sélecteurs d’hôtes .

Désactiver SSH sur un hôte

xe host-disable-ssh host=<host_uuid_or_name_label>
<!--NeedCopy-->

Cette commande arrête et désactive le service sshd sur l’hôte spécifié.

Activer SSH sur tous les hôtes d’un pool

xe pool-enable-ssh
<!--NeedCopy-->

Cette commande démarre et active le service sshd sur tous les hôtes du pool actuel.

Désactiver SSH sur tous les hôtes d’un pool

xe pool-disable-ssh
<!--NeedCopy-->

Cette commande arrête et désactive le service sshd sur tous les hôtes du pool actuel.

Exemple de sortie (opération au niveau du pool)

xe pool-enable-ssh

Some of hosts failed to enable SSH access.
hosts: d734ff47-f429-4bd4-93f7-245cffbdc79e (genus-35-003d)
<!--NeedCopy-->

Si un hôte échoue, la commande continue de traiter les hôtes restants et signale les échecs à la fin.

Commandes d’instantanés

Commandes pour travailler avec des instantanés.

snapshot-clone

xe snapshot-clone new-name-label=name_label [uuid=uuid] [new-name-description=description]
<!--NeedCopy-->

Créez un nouveau modèle en clonant un instantané existant, en utilisant l’opération de clonage rapide de disque au niveau du stockage, si disponible.

snapshot-copy

xe snapshot-copy new-name-label=name_label [uuid=uuid] [new-name-description=name_description] [sr-uuid=sr_uuid]
<!--NeedCopy-->

Créez un nouveau modèle en copiant une VM existante, mais sans utiliser l’opération de clonage rapide de disque au niveau du stockage (même si elle est disponible). Les images disque de la VM copiée sont garanties d’être des ‘images complètes’ - c’est-à-dire ne faisant pas partie d’une chaîne CoW.

snapshot-destroy

xe snapshot-destroy  [uuid=uuid] [snapshot-uuid=snapshot_uuid]
<!--NeedCopy-->

Détruit un instantané. Cela laisse le stockage associé à l’instantané intact. Pour supprimer également le stockage, utilisez snapshot-uninstall.

snapshot-disk-list

xe snapshot-disk-list [uuid=uuid] [snapshot-uuid=snapshot_uuid] [vbd-params=vbd_params] [vdi-params=vdi_params]
<!--NeedCopy-->

Liste les disques sur la ou les VM sélectionnées.

snapshot-export-to-template

xe snapshot-export-to-template filename=file_name snapshot-uuid=snapshot_uuid  [preserve-power-state=true|false]
<!--NeedCopy-->

Exporte un instantané vers nom de fichier.

snapshot-reset-powerstate

xe snapshot-reset-powerstate [uuid=uuid] [snapshot-uuid=snapshot_uuid] [--force]
<!--NeedCopy-->

Force l’état d’alimentation de la VM à ‘arrêté’ uniquement dans la base de données de la pile d’outils de gestion. Cette commande est utilisée pour 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. Vous ne pourrez plus reprendre votre instantané.

snapshot-revert

xe snapshot-revert [uuid=uuid] [snapshot-uuid=snapshot_uuid]
<!--NeedCopy-->

Rétablit une VM existante à un état de point de contrôle ou d’instantané précédent.

snapshot-uninstall

xe snapshot-uninstall [uuid=uuid] [snapshot-uuid=snapshot_uuid] [--force]
<!--NeedCopy-->

Désinstalle un instantané. Cette opération détruira les VDI marqués RW et connectés uniquement à cet instantané. Pour simplement détruire l’enregistrement de la VM, utilisez snapshot-destroy.

Commandes SR

Commandes pour contrôler les SR (référentiels de stockage).

Les objets SR peuvent être listés avec la commande de liste d’objets standard (xe sr-list), et les paramètres manipulés avec les commandes de paramètres standard. Pour plus d’informations, consultez Commandes de paramètres de bas niveau

Paramètres SR

Les SR ont les paramètres suivants :

sr-create

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

Crée un SR sur le disque, l’introduit dans la base de données et crée un PBD attachant le SR à l’hôte XenServer. Si shared est défini sur true, un PBD est créé pour chaque hôte XenServer du pool. Si shared n’est pas spécifié ou est défini sur false, un PBD est créé uniquement pour l’hôte XenServer spécifié avec host-uuid.

Les paramètres device-config exacts varient en fonction du type du périphérique. Pour plus de détails sur ces paramètres pour les différents back-ends de stockage, consultez Créer un SR.

sr-data-source-forget

xe sr-data-source-forget data-source=data_source
<!--NeedCopy-->

Arrête l’enregistrement de la source de données spécifiée pour un SR et oublie toutes les données enregistrées.

sr-data-source-list

xe sr-data-source-list
<!--NeedCopy-->

Liste les sources de données qui peuvent être enregistrées pour un SR.

sr-data-source-query

xe sr-data-source-query data-source=data_source
<!--NeedCopy-->

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

sr-data-source-record

xe sr-data-source-record  data-source=data_source
<!--NeedCopy-->

Enregistre la source de données spécifiée pour un SR.

sr-destroy

xe sr-destroy uuid=sr_uuid
<!--NeedCopy-->

Détruit le SR spécifié sur l’hôte XenServer.

sr-enable-database-replication

xe sr-enable-database-replication uuid=sr_uuid
<!--NeedCopy-->

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

sr-disable-database-replication

xe sr-disable-database-replication uuid=sr_uuid
<!--NeedCopy-->

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

sr-forget

xe sr-forget uuid=sr_uuid
<!--NeedCopy-->

L’agent XAPI oublie un SR spécifié sur l’hôte XenServer. Lorsque l’agent XAPI oublie un SR, le SR est détaché et vous ne pouvez pas accéder aux VDI qui s’y trouvent, mais il reste intact sur le support source (les données ne sont pas perdues).

sr-introduce

xe sr-introduce name-label=name physical-size=physical_size type=type content-type=content_type uuid=sr_uuid
<!--NeedCopy-->

Place simplement un enregistrement SR dans la base de données. Utilisez device-config pour spécifier des paramètres supplémentaires sous la forme device-config:parameter_key=parameter_value, par exemple :

xe sr-introduce device-config:device=/dev/sdb1
<!--NeedCopy-->

Remarque :

Cette commande n’est jamais utilisée en fonctionnement normal. Cette opération avancée peut être utile lorsqu’un SR doit être reconfiguré comme partagé après sa création ou pour aider à récupérer de divers scénarios de défaillance.

sr-probe

xe sr-probe type=type [host-uuid=host_uuid] [device-config:config_name=value]
<!--NeedCopy-->

Effectue une analyse du backend, en utilisant les clés device-config fournies. Si le device-config est complet pour le backend SR, cette commande renvoie une liste des SR présents sur le périphérique, le cas échéant. Si les paramètres device-config ne sont que partiels, une analyse spécifique au backend est effectuée, renvoyant des résultats qui vous guident dans l’amélioration des paramètres device-config restants. Les résultats de l’analyse sont renvoyés sous forme de XML spécifique au backend, affichés sur la CLI.

Les paramètres device-config exacts diffèrent selon le type du périphérique. Pour plus de détails sur ces paramètres pour les différents backends de stockage, consultez Stockage.

sr-probe-ext

xe sr-probe-ext type=type [host-uuid=host_uuid] [device-config:=config] [sm-config:-sm_config]
<!--NeedCopy-->

Effectue une sonde de stockage. Les paramètres device-config peuvent être spécifiés par exemple par device-config:devs=/dev/sdb1. Contrairement à sr-probe, cette commande renvoie les résultats dans le même format lisible par l’homme pour chaque type de SR.

sr-scan

xe sr-scan uuid=sr_uuid
<!--NeedCopy-->

Force une analyse SR, synchronisant la base de données XAPI avec les VDI présents dans le substrat de stockage sous-jacent.

sr-update

xe sr-update uuid=uuid
<!--NeedCopy-->

Actualise les champs de l’objet SR dans la base de données.

lvhd-enable-thin-provisioning

xe lvhd-enable-thin-provisioning  sr-uuid=sr_uuid initial-allocation=initial_allocation allocation-quantum=allocation_quantum
<!--NeedCopy-->

Activer le provisionnement léger sur un SR LVHD.

Commandes de sujet

Commandes pour travailler avec les sujets.

session-subject-identifier-list

xe session-subject-identifier-list
<!--NeedCopy-->

Retourne une liste de tous les ID de sujet utilisateur de toutes les sessions existantes authentifiées en externe.

session-subject-identifier-logout

xe session-subject-identifier-logout subject-identifier=subject_identifier
<!--NeedCopy-->

Déconnecte toutes les sessions authentifiées en externe associées à un ID de sujet utilisateur.

session-subject-identifier-logout-all

xe session-subject-identifier-logout-all
<!--NeedCopy-->

Déconnecte toutes les sessions authentifiées en externe.

subject-add

xe subject-add subject-name=subject_name
<!--NeedCopy-->

Ajouter un sujet à la liste des sujets pouvant accéder au pool.

subject-remove

xe subject-remove subject-uuid=subject_uuid
<!--NeedCopy-->

Supprimer un sujet de la liste des sujets pouvant accéder au pool.

subject-role-add

xe subject-role-add uuid=uuid [role-name=role_name] [role-uuid=role_uuid]
<!--NeedCopy-->

Ajouter un rôle à un sujet.

subject-role-remove

xe subject-role-remove uuid=uuid [role-name=role_name] [role-uuid=role_uuid]
<!--NeedCopy-->

Supprimer un rôle d’un sujet.

secret-create

xe secret-create value=value
<!--NeedCopy-->

Créer un secret.

secret-destroy

xe secret-destroy uuid=uuid
<!--NeedCopy-->

Détruire un secret.

Commandes de tâches

Commandes pour travailler avec des tâches asynchrones de longue durée. 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 sous-tâches atomiques qui accomplissent ensemble l’opération demandée.

Les objets de tâche peuvent être listés avec la commande de liste d’objets standard (xe task-list), et les paramètres manipulés avec les commandes de paramètres standard. Pour plus d’informations, consultez Commandes de paramètres de bas niveau

Paramètres de tâches

Les tâches ont les paramètres suivants :

task-cancel

xe task-cancel [uuid=task_uuid]
<!--NeedCopy-->

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

Commandes de modèle

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

Les modèles sont essentiellement des machines virtuelles avec le paramètre is-a-template défini sur true. Un modèle est une « image dorée » qui contient tous les différents paramètres de configuration pour instancier une machine virtuelle spécifique. XenServer est livré avec un ensemble de modèles de base, qui sont des machines virtuelles « brutes » génériques pouvant démarrer un CD d’installation de fournisseur de système d’exploitation (par exemple : RHEL, CentOS, SLES, Windows). Vous pouvez créer des machines virtuelles, les configurer sous des formes standard pour vos besoins particuliers, et en enregistrer une copie en tant que modèles pour une utilisation future dans le déploiement de machines virtuelles.

Les objets modèles peuvent être listés avec la commande de liste d’objets standard (xe template-list), et les paramètres manipulés avec les commandes de paramètres standard. Pour plus d’informations, consultez Commandes de paramètres de bas niveau

Remarque :

Les modèles ne peuvent pas être directement convertis en machines virtuelles en définissant le paramètre is-a-template sur false. La définition du paramètre is-a-template sur false n’est pas prise en charge et entraîne une machine virtuelle qui ne peut pas être démarrée.

Paramètres du modèle de machine virtuelle

Les modèles ont les paramètres suivants :

• uuid (lecture seule) l’identifiant unique/référence d’objet 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 (lecture/écriture) chaîne permettant aux créateurs de machines virtuelles et de modèles d’insérer des informations de version

• is-a-template (lecture/écriture) vrai si cette machine virtuelle est un modèle. Les machines virtuelles modèles ne peuvent jamais être démarrées, elles sont utilisées uniquement pour cloner d’autres machines virtuelles. Une fois cette valeur définie sur vrai, elle ne peut pas être réinitialisée sur faux. Les machines virtuelles modèles ne peuvent pas être converties en machines virtuelles à l’aide de ce paramètre.

  Vous pouvez convertir une machine virtuelle en modèle avec :

   xe vm-param-set uuid=<vm uuid> is-a-template=true
   <!--NeedCopy-->
  

• is-control-domain (lecture seule) vrai si c’est un domaine de contrôle (domaine 0 ou un domaine de pilote)
• power-state (lecture seule) état d’alimentation actuel. La valeur est toujours arrêtée pour un modèle
• memory-dynamic-max (lecture seule) mémoire maximale dynamique en octets. Actuellement inutilisé, mais si modifié, 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 modifié, les mêmes contraintes que pour memory-dynamic-max doivent être respectées.
• memory-static-max (lecture/écriture) mémoire maximale (absolue) définie statiquement en octets. Ce champ est la valeur principale utilisée pour déterminer la quantité de mémoire allouée à une VM.
• memory-static-min (lecture/écriture) mémoire minimale (absolue) définie statiquement en octets. Ce champ représente la mémoire minimale absolue, et memory-static-min doit être inférieur à memory-static-max. Cette valeur est inutilisé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 de suspension est stockée (n’a pas de signification pour un modèle)
• VCPUs-params (paramètre de carte lecture/écriture) paramètres de configuration pour la politique vCPU sélectionnée.
• VCPUs-max (lecture/écriture) nombre maximal de vCPU
• VCPUs-at-startup (lecture/écriture) nombre de vCPU au démarrage
• actions-after-crash (lecture/écriture) action à entreprendre lorsqu’une VM basée sur ce modèle plante
• console-uuids (paramètre d’ensemble en lecture seule) périphériques de console virtuelle

• platform (paramètre de carte lecture/écriture) configuration spécifique à la plateforme

  Pour désactiver l’émulation d’un port parallèle pour les invités :

   xe vm-param-set uuid=<vm_uuid> platform:parallel=none
   <!--NeedCopy-->
  

  Pour désactiver l’émulation d’un port série :

   xe vm-param-set uuid=<vm_uuid> platform:hvm_serial=none
   <!--NeedCopy-->
  

  Pour désactiver l’émulation d’un contrôleur USB et d’une tablette USB :

   xe vm-param-set uuid=<vm_uuid> platform:usb=false
   xe vm-param-set uuid=<vm_uuid> platform:usb_tablet=false
   <!--NeedCopy-->
  

• allowed-operations (paramètre d’ensemble en lecture seule) liste des opérations autorisées dans cet état
• current-operations (paramètre d’ensemble en lecture seule) liste des opérations en cours sur ce modèle
• allowed-VBD-devices (paramètre d’ensemble en lecture seule) liste des identifiants VBD disponibles pour utilisation, représentés par des entiers de la plage 0 à 254. Cette liste est uniquement informative, et d’autres périphériques peuvent être utilisés (mais peuvent ne pas fonctionner).
• allowed-VIF-devices (paramètre d’ensemble en lecture seule) liste des identifiants VIF disponibles pour utilisation, représentés par des entiers de la plage 0 à 6. Cette liste est uniquement informative, et d’autres périphériques peuvent être utilisés (mais peuvent ne pas fonctionner).
• HVM-boot-policy (lecture/écriture) la politique de démarrage pour les invités. Soit BIOS Order, soit une chaîne vide.
• HVM-boot-params (paramètre de carte en lecture/écriture) la clé d’ordre contrôle l’ordre de démarrage de l’invité, représentée comme 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) chemin d’accès au noyau
• PV-ramdisk (lecture/écriture) chemin d’accès au 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 basées sur ce modèle
• 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 de démarrage
• last-boot-CPU-flags (lecture seule) décrit les indicateurs CPU sur lesquels une VM basée sur ce modèle a été démarrée pour la dernière fois ; non renseigné pour un modèle
• resident-on (lecture seule) l’hôte XenServer sur lequel une VM basée sur ce modèle est résidente. Apparaît comme not in database pour un modèle
• affinity (lecture/écriture) l’hôte XenServer sur lequel une VM basée sur ce modèle a une préférence pour s’exécuter. Utilisé par la commande xe vm-start pour décider où exécuter la VM. Également appelé serveur d’accueil.
• groups (lecture/écriture) le groupe de VM auquel cette VM appartient. Un groupe de VM définit où XenServer tente de démarrer la VM ou de l’évacuer.
• 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 métriques d’une machine virtuelle basée sur ce modèle ont été lues, sous la forme yyyymmddThh:mm:ss z, où z est l’indicateur de fuseau horaire militaire à une seule lettre, par exemple, Z pour UTC (GMT). Défini 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 métriques d’une machine virtuelle basée sur ce modèle ont été lues, sous la forme yyyymmddThh:mm:ss z, où z est l’indicateur de fuseau horaire militaire à une seule lettre, par exemple, Z pour UTC (GMT). Défini 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 CPU virtuels attribué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 CPU virtuels et de leur poids paramètre de carte en lecture seule 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) indicateur 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 carte en lecture seule) métriques de mémoire 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
• disks (paramètre de carte en lecture seule) métriques de disque 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
• networks (paramètre de carte en lecture seule) métriques réseau 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
• other (paramètre de carte en lecture seule) autres métriques 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 de la dernière écriture effectuée par l’agent invité dans ces champs. Sous la forme yyyymmddThh:mm:ss z, où z est l’indicateur de fuseau horaire militaire à une seule lettre, par exemple, Z pour UTC (GMT)
• actions-after-shutdown (lecture/écriture) action à entreprendre après l’arrêt de la machine virtuelle
• actions-after-reboot (lecture/écriture) action à entreprendre après le redémarrage de la machine virtuelle
• possible-hosts (lecture seule) liste des hôtes pouvant potentiellement 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 VM
• xenstore-data (paramètre de carte lecture/écriture) données à insérer dans l’arborescence xenstore (/local/domain/*domid*/vmdata) après la création de la VM.
• is-a-snapshot (lecture seule) La valeur est vraie si ce modèle est un instantané de VM
• snapshot_of (lecture seule) l’UUID de la VM dont ce modèle est un instantané
• snapshots (lecture seule) les UUID de tous les instantanés qui ont été pris de ce modèle
• snapshot_time (lecture seule) l’horodatage du dernier instantané de VM pris
• memory-target (lecture seule) la quantité de mémoire cible définie pour ce modèle
• blocked-operations (paramètre de carte lecture/écriture) liste 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 pour ce modèle, au format XML
• ha-always-run (lecture/écriture) La valeur est vraie 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 elle réside. Ce paramètre est maintenant obsolète. Utilisez le paramètre ha-restartpriority à la place.
• ha-restart-priority (lecture seule) magasin de données binaires de type blobs en lecture/écriture pour le redémarrage ou le meilleur effort
• live (lecture seule) pertinent uniquement pour une VM en cours d’exécution.

template-export

xe template-export template-uuid=uuid_of_existing_template filename=filename_for_new_template
<!--NeedCopy-->

Exporte une copie d’un modèle spécifié vers un fichier avec le nouveau nom de fichier spécifié.

template-uninstall

xe template-uninstall template-uuid=template_uuid [--force]
<!--NeedCopy-->

Désinstalle un modèle personnalisé. Cette opération détruira les VDI qui sont marqués comme ‘appartenant’ à ce modèle.

Commandes de mise à jour

La section suivante contient les commandes de mise à jour de l’hôte XenServer.

Les objets de mise à jour peuvent être listés avec la commande standard de listage d’objets (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 de l’hôte XenServer ont les paramètres suivants :

update-upload

xe update-upload file-name=update_filename
<!--NeedCopy-->

Télécharge un fichier de mise à jour spécifié sur l’hôte XenServer. Cette commande prépare une mise à jour à appliquer. En cas de succès, l’UUID de la mise à jour téléchargée est affiché. 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 pas téléchargé à nouveau.

update-precheck

xe update-precheck uuid=update_uuid host-uuid=host_uuid
<!--NeedCopy-->

Exécute les vérifications préalables contenues dans la mise à jour spécifiée sur l’hôte XenServer spécifié.

update-destroy

xe update-destroy uuid=update_file_uuid
<!--NeedCopy-->

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

xe update-apply host-uuid=host_uuid uuid=update_file_uuid
<!--NeedCopy-->

Appliquer le fichier de mise à jour spécifié.

update-pool-apply

xe update-pool-apply uuid=update_uuid
<!--NeedCopy-->

Appliquer la mise à jour spécifiée à tous les hôtes XenServer du pool.

update-introduce

xe update-introduce vdi-uuid=vdi_uuid
<!--NeedCopy-->

Introduire le VDI de mise à jour.

update-pool-clean

xe update-pool-clean uuid=uuid
<!--NeedCopy-->

Supprime les fichiers de la mise à jour de tous les hôtes du pool.

Commandes utilisateur

user-password-change

xe user-password-change old=old_password new=new_password
<!--NeedCopy-->

Modifie le mot de passe de l’utilisateur connecté. Le champ de l’ancien mot de passe n’est pas vérifié car vous avez besoin des privilèges 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 VM au VDI, lequel représente le contenu du disque virtuel. Le VBD possède les attributs qui lient le VDI à la VM (est-il amorçable, ses métriques 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 listés avec la commande standard de listage d’objets (xe vbd-list), et les paramètres manipulés avec les commandes de paramètres standard. Pour plus d’informations, consultez Commandes de paramètres de bas niveau

Paramètres VBD

Les VBD ont les paramètres suivants :

vbd-create

xe vbd-create vm-uuid=uuid_of_the_vm device=device_value vdi-uuid=uuid_of_vdi_to_connect_to [bootable=true] [type=Disk|CD] [mode=RW|RO]
<!--NeedCopy-->

Créez un VBD sur une machine virtuelle.

Les valeurs autorisées pour le champ device sont des entiers de 0 à 254, et le nombre doit être unique pour chaque machine virtuelle. Les valeurs autorisées actuelles peuvent être consultées dans le paramètre allowed-VBD-devices de la machine virtuelle spécifiée. Ceci est affiché comme userdevice dans les paramètres vbd.

Si le type est Disk, vdi-uuid est requis. Le mode peut être RO ou RW pour un disque.

Si le type est CD, vdi-uuid est facultatif. Si aucun VDI n’est spécifié, un VBD vide est créé pour le CD. Le mode doit être RO pour un CD.

vbd-destroy

xe vbd-destroy uuid=uuid_of_vbd
<!--NeedCopy-->

Détruit le VBD spécifié.

Si le paramètre other-config:owner du VBD est défini sur true, le VDI associé est également détruit.

vbd-eject

xe vbd-eject uuid=uuid_of_vbd
<!--NeedCopy-->

Retire le média du lecteur représenté par un VBD. Cette commande ne fonctionne que si le média est de type amovible (un CD physique ou une ISO). Sinon, un message d’erreur VBD_NOT_REMOVABLE_MEDIA est renvoyé.

vbd-insert

xe vbd-insert uuid=uuid_of_vbd vdi-uuid=uuid_of_vdi_containing_media
<!--NeedCopy-->

Insérez un nouveau média dans le lecteur représenté par un VBD. Cette commande ne fonctionne que si le média est de type amovible (un CD physique ou une ISO). Sinon, un message d’erreur VBD_NOT_REMOVABLE_MEDIA est renvoyé.

vbd-plug

xe vbd-plug uuid=uuid_of_vbd
<!--NeedCopy-->

Tente de joindre le VBD pendant que la VM est en cours d’exécution.

vbd-unplug

xe vbd-unplug uuid=uuid_of_vbd
<!--NeedCopy-->

Tente de détacher le VBD de la VM pendant qu’elle est en cours d’exécution.

Commandes VDI

Commandes pour travailler avec les VDI (images de disque virtuel).

Un VDI est un objet logiciel qui représente le contenu du disque virtuel vu par une VM. Ceci est différent du VBD, qui est un objet qui lie une VM 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 média est en lecture/écriture ou en lecture seule, etc.). Le VBD possède les attributs qui lient le VDI à la VM (est-il amorçable, ses métriques de lecture/écriture, etc.).

Les objets VDI peuvent être listés avec la commande de liste d’objets standard (xe vdi-list), et les paramètres manipulés avec les commandes de paramètres standard. Pour plus d’informations, consultez Commandes de paramètres de bas niveau

Paramètres VDI

Les VDI ont les paramètres suivants :

vdi-clone

xe vdi-clone uuid=uuid_of_the_vdi [driver-params:key=value]
<!--NeedCopy-->

Crée une nouvelle copie inscriptible du VDI spécifié qui peut être utilisée directement. C’est une variante de vdi-copy qui peut exposer des fonctionnalités de clonage d’image à haute vitesse là où elles existent.

Utilisez le paramètre de mappage optionnel driver-params pour transmettre des informations de configuration supplémentaires spécifiques au fournisseur au pilote de stockage back-end sur lequel le VDI est basé. Pour plus d’informations, consultez la documentation du pilote du fournisseur de stockage.

vdi-copy

xe vdi-copy uuid=uuid_of_the_vdi sr-uuid=uuid_of_the_destination_sr
<!--NeedCopy-->

Copier un VDI vers un SR spécifié.

vdi-create

xe vdi-create sr-uuid=uuid_of_sr_to_create_vdi_on name-label=name_for_the_vdi type=system|user|suspend|crashdump virtual-size=size_of_virtual_disk sm-config-\*=storage_specific_configuration_data
<!--NeedCopy-->

Créer un VDI.

Le paramètre virtual-size peut être spécifié en octets ou en utilisant les suffixes standard IEC KiB, MiB, GiB et TiB.

Remarque :

Les types de SR qui prennent en charge le provisionnement léger des disques (tels que VHD local et NFS) n’appliquent pas l’allocation virtuelle des disques. Soyez très prudent lors de la surallocation d’espace disque virtuel sur un SR. Si un SR suralloué devient plein, de l’espace disque doit être libéré soit sur le substrat cible du SR, soit en supprimant les VDI inutilisés dans le SR.

Certains types de SR peuvent arrondir la valeur virtual-size pour la rendre divisible par une taille de bloc configurée.

vdi-data-destroy

xe vdi-data-destroy uuid=uuid_of_vdi
<!--NeedCopy-->

Détruire les données associées au VDI spécifié, mais conserver les métadonnées de suivi des blocs modifiés.

Remarque :

Si vous utilisez le suivi des blocs modifiés pour effectuer des sauvegardes incrémentielles du VDI, assurez-vous d’utiliser la commande vdi-data-destroy pour supprimer les instantanés tout en conservant les métadonnées. N’utilisez pas vdi-destroy sur les instantanés de VDI pour lesquels le suivi des blocs modifiés est activé.

vdi-destroy

xe vdi-destroy uuid=uuid_of_vdi
<!--NeedCopy-->

Détruire le VDI spécifié.

Remarque :

Si vous utilisez le suivi des blocs modifiés pour effectuer des sauvegardes incrémentielles du VDI, assurez-vous d’utiliser la commande vdi-data-destroy pour supprimer les instantanés tout en conservant les métadonnées. N’utilisez pas vdi-destroy sur les instantanés de VDI pour lesquels le suivi des blocs modifiés est activé.

Pour les types de SR VHD local et NFS, l’espace disque n’est pas immédiatement libéré sur vdi-destroy, mais périodiquement lors d’une opération d’analyse du référentiel de stockage. Si vous devez forcer la mise à disposition de l’espace disque supprimé, appelez sr-scan manuellement.

vdi-disable-cbt

xe vdi-disable-cbt uuid=uuid_of_vdi
<!--NeedCopy-->

Désactive le suivi des blocs modifiés pour le VDI.

vdi-enable-cbt

xe vdi-enable-cbt uuid=uuid_of_vdi
<!--NeedCopy-->

Active le suivi des blocs modifiés pour le VDI.

Remarque :

Vous ne pouvez activer le suivi des blocs modifiés que sur les instances sous licence de XenServer Premium Edition.

vdi-export

xe vdi-export uuid=uuid_of_vdi filename=filename_to_export_to [format=format] [base=uuid_of_base_vdi] [--progress]
<!--NeedCopy-->

Exporte 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 sparse. 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 basés sur VHD pris en charge (EXT3/EXT4, NFS).

Si vous spécifiez le paramètre base, cette commande exporte uniquement les blocs qui ont été modifiés entre le VDI exporté et le VDI de base.

vdi-forget

xe vdi-forget uuid=uuid_of_vdi
<!--NeedCopy-->

Supprime inconditionnellement un enregistrement VDI de la base de données sans toucher au back-end de stockage. En fonctionnement normal, utilisez vdi-destroy à la place.

vdi-import

xe vdi-import uuid=uuid_of_vdi filename=filename_to_import_from [format=format] [--progress]
<!--NeedCopy-->

Importez un VDI. Vous pouvez importer un VDI à partir de l’un des formats suivants :

• raw
• vhd

vdi-introduce

xe vdi-introduce uuid=uuid_of_vdi sr-uuid=uuid_of_sr name-label=name_of_new_vdi type=system|user|suspend|crashdump location=device_location_(varies_by_storage_type) [name-description=description_of_vdi] [sharable=yes|no] [read-only=yes|no] [other-config=map_to_store_misc_user_specific_data] [xenstore-data=map_to_of_additional_xenstore_keys] [sm-config=storage_specific_configuration_data]
<!--NeedCopy-->

Créez un objet VDI représentant un périphérique de stockage existant, sans réellement modifier ou créer de stockage. Cette commande est principalement utilisée en interne pour introduire automatiquement des périphériques de stockage à chaud.

vdi-list-changed-blocks

xe vdi-list-changed-blocks vdi-from-uuid=first-vdi-uuid vdi-to-uuid=second-vdi-uuid
<!--NeedCopy-->

Comparez deux VDI et renvoyez la liste des blocs qui ont changé entre les deux sous forme de chaîne encodée en base64. Cette commande ne fonctionne que pour les VDI pour lesquels le suivi des blocs modifiés est activé.

Pour plus d’informations, consultez Suivi des blocs modifiés.

vdi-pool-migrate

xe vdi-pool-migrate uuid=VDI_uuid sr-uuid=destination-sr-uuid
<!--NeedCopy-->

Migrez un VDI vers un SR spécifié, pendant que le VDI est attaché à un invité en cours d’exécution. (Migration de stockage en direct)

Pour plus d’informations, consultez Migrer des machines virtuelles.

vdi-resize

xe vdi-resize uuid=vdi_uuid disk-size=new_size_for_disk
<!--NeedCopy-->

Modifiez la taille du VDI spécifié par UUID.

vdi-snapshot

xe vdi-snapshot uuid=uuid_of_the_vdi [driver-params=params]
<!--NeedCopy-->

Produit une version en lecture-écriture d’un VDI qui peut être utilisée comme référence pour la sauvegarde ou la 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 VM. La VM continue de fonctionner pendant qu’un logiciel de sauvegarde externe diffuse le contenu de l’instantané vers le support de sauvegarde. De même, un instantané peut être utilisé comme « image de référence » sur laquelle baser un modèle. Un modèle peut être créé à l’aide de n’importe quel VDI.

Utilisez le paramètre de mappage driver-params facultatif pour transmettre des informations de configuration supplémentaires spécifiques au fournisseur au pilote de stockage principal sur lequel le VDI est basé. Pour plus d’informations, consultez la documentation du pilote du fournisseur de stockage.

Un clone d’un instantané produit toujours un VDI inscriptible.

vdi-unlock

xe vdi-unlock uuid=uuid_of_vdi_to_unlock [force=true]
<!--NeedCopy-->

Tente de déverrouiller les VDI spécifiés. Si force=true est passé à la commande, il force l’opération de déverrouillage.

vdi-update

xe vdi-update uuid=uuid
<!--NeedCopy-->

Actualise les champs de l’objet VDI dans la base de données.

Commandes VIF

Commandes pour travailler avec les VIF (interfaces réseau virtuelles).

Les objets VIF peuvent être listés avec la commande de liste d’objets standard (xe vif-list), et les paramètres manipulés avec les commandes de paramètres standard. Pour plus d’informations, consultez Commandes de paramètres de bas niveau

Paramètres VIF

Les VIF ont les paramètres suivants :

• uuid (lecture seule) l’identifiant unique/référence d’objet pour le VIF
• vm-uuid (lecture seule) l’identifiant unique/référence d’objet pour la VM sur laquelle réside ce VIF
• vm-name-label (lecture seule) le nom de la VM sur laquelle réside ce VIF
• allowed-operations (paramètre d’ensemble en lecture seule) liste des opérations autorisées dans cet état
• current-operations (paramètre d’ensemble en lecture seule) liste des opérations en cours sur cette VIF
• device (lecture seule) étiquette entière de cette VIF, indiquant l’ordre dans lequel les back-ends VIF ont été créés
• MAC (lecture seule) adresse MAC de la VIF, telle qu’exposée à la VM

• MTU (lecture seule) Unité de Transmission Maximale (MTU) de la VIF en octets.

  Ce paramètre est en lecture seule, mais vous pouvez remplacer le paramètre MTU avec la clé mtu en utilisant le paramètre de mappage other-config. Par exemple, pour réinitialiser le MTU sur une carte réseau virtuelle afin d’utiliser des trames jumbo :

   xe vif-param-set \
       uuid=<vif_uuid> \
       other-config:mtu=9000
   <!--NeedCopy-->
  

• currently-attached (lecture seule) vrai si le périphérique est attaché
• qos_algorithm_type (lecture/écriture) algorithme QoS à utiliser
• qos_algorithm_params (paramètre de mappage en lecture/écriture) paramètres pour l’algorithme QoS choisi
• qos_supported_algorithms (paramètre d’ensemble en lecture seule) algorithmes QoS pris en charge pour cette VIF
• MAC-autogenerated (lecture seule) La valeur est vraie si l’adresse MAC de la VIF a été générée automatiquement
• other-config (paramètre de mappage en lecture/écriture) paires de configuration supplémentaires key:value
• 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 le scatter gather, 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 le désactiver
• other-config:ethtoolufo (lecture/écriture) défini sur ‘on’ pour activer le déchargement des fragments UDP, sur ‘off’ pour le désactiver
• other-config:ethtoolgso (lecture/écriture) défini sur ‘on’ pour activer le déchargement de la segmentation générique, sur ‘off’ pour le désactiver
• other-config:promiscuous (lecture/écriture) vrai pour qu’une VIF soit en mode promiscuité sur le pont, afin qu’elle voie tout le trafic sur le pont. Utile pour exécuter un système de détection d’intrusion (IDS) ou similaire dans une VM.
• network-uuid (lecture seule) l’identifiant unique/la référence d’objet du réseau virtuel auquel cette VIF est connectée
• network-name-label (lecture seule) le nom descriptif du réseau virtuel auquel cette VIF est connectée
• io_read_kbs (lecture seule) taux de lecture moyen en Ko/s pour cette VIF
• io_write_kbs (lecture seule) taux d’écriture moyen en Ko/s pour cette VIF
• locking_mode (lecture/écriture) Affecte la capacité de la 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 pour le réseau VIF.

  Si le mode de verrouillage par défaut est défini sur disabled, XenServer applique une règle de filtrage de sorte que la VIF ne puisse ni envoyer ni recevoir de trafic. Si le mode de verrouillage par défaut est défini sur unlocked, XenServer supprime toutes les règles de filtrage associées à la VIF. Pour plus d’informations, consultez Commandes réseau.

• locking_mode:locked (lecture/écriture) Seul le trafic envoyé vers ou depuis les adresses MAC et IP spécifiées est autorisé sur la 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é au trafic entrant ou sortant de la VIF.
• locking_mode:disabled (lecture/écriture) XenServer applique une règle de filtrage de sorte que la VIF supprime tout le trafic.

vif-create

xe vif-create vm-uuid=uuid_of_the_vm device=see below network-uuid=uuid_of_network_to_connect_to [mac=mac_address]
<!--NeedCopy-->

Créer une VIF sur une VM.

Les valeurs appropriées pour le champ device sont répertoriées dans le paramètre allowed-VIF-devices sur la VM spécifiée. Avant qu’aucune VIF n’existe, les valeurs autorisées sont des entiers de 0 à 6.

Le paramètre mac est l’adresse MAC standard sous la forme aa:bb:cc:dd:ee:ff. Si vous ne le spécifiez pas, 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

xe vif-destroy uuid=uuid_of_vif
<!--NeedCopy-->

Détruire une VIF.

vif-move

xe vif-move uuid=uuid network-uuid=network_uuid
<!--NeedCopy-->

Déplacer la VIF vers un autre réseau.

vif-plug

xe vif-plug uuid=uuid_of_vif
<!--NeedCopy-->

Tenter d’attacher la VIF pendant que la VM est en cours d’exécution.

vif-unplug

xe vif-unplug uuid=uuid_of_vif
<!--NeedCopy-->

Tente de détacher la VIF de la VM pendant qu’elle est en cours d’exécution.

vif-configure-ipv4

Configurer les paramètres IPv4 pour cette interface virtuelle. Définir les paramètres IPv4 comme suit :

xe vif-configure-ipv4 uuid=uuid_of_vif mode=static address=CIDR_address gateway=gateway_address
<!--NeedCopy-->

Par exemple :

VIF.configure_ipv4(vifObject,"static", " 192.168.1.10/24", " 192.168.1.1")
<!--NeedCopy-->

Nettoyer les paramètres IPv4 comme suit :

xe vif-configure-ipv4 uuid=uuid_of_vif mode=none
<!--NeedCopy-->

vif-configure-ipv6

Configurez les paramètres IPv6 pour cette interface virtuelle. Définissez les paramètres IPv6 comme suit :

xe vif-configure-ipv6 uuid=uuid_of_vif mode=static address=IP_address gateway=gateway_address
<!--NeedCopy-->

Par exemple :

VIF.configure_ipv6(vifObject,"static", "fd06:7768:b9e5:8b00::5001/64", "fd06:7768:b9e5:8b00::1")
<!--NeedCopy-->

Nettoyez les paramètres IPv6 comme suit :

xe vif-configure-ipv6 uuid=uuid_of_vif mode=none
<!--NeedCopy-->

Commandes VLAN

Commandes pour travailler avec les VLAN (réseaux virtuels). Pour lister et modifier les interfaces virtuelles, reportez-vous aux commandes PIF, qui ont un paramètre VLAN pour signaler qu’elles ont un réseau virtuel associé. Pour plus d’informations, voir Commandes PIF. Par exemple, pour lister les VLAN, utilisez xe pif-list.

vlan-create

xe vlan-create pif-uuid=uuid_of_pif vlan=vlan_number network-uuid=uuid_of_network
<!--NeedCopy-->

Créez un VLAN sur votre hôte XenServer.

pool-vlan-create

xe pool-vlan-create pif-uuid=uuid_of_pif vlan=vlan_number network-uuid=uuid_of_network
<!--NeedCopy-->

Créez un VLAN sur tous les hôtes d’un pool en déterminant sur quelle interface (par exemple, eno12429np0) le réseau spécifié se trouve pour chaque hôte, puis en créant et en branchant un nouvel objet PIF sur chaque hôte en conséquence.

vlan-destroy

xe vlan-destroy uuid=uuid_of_pif_mapped_to_vlan
<!--NeedCopy-->

Détruire un VLAN. Nécessite l’UUID du PIF qui représente le VLAN.

Commandes de VM

Commandes pour contrôler les VM et leurs attributs.

Sélecteurs de VM

Plusieurs des commandes listées ici ont un mécanisme commun pour sélectionner une ou plusieurs VM sur lesquelles effectuer l’opération. La manière la plus simple est de fournir l’argument vm=name_or_uuid. Un moyen facile d’obtenir l’UUID d’une VM réelle est, par exemple, d’exécuter xe vm-list power-state=running. (Obtenez la liste complète des champs qui peuvent être mis en correspondance en utilisant la commande xe vm-list params=all.) Par exemple, spécifier power-state=halted sélectionne les VM dont le paramètre power-state est égal à halted. Lorsque plusieurs VM correspondent, spécifiez l’option --multiple pour effectuer l’opération. La liste complète des paramètres qui peuvent être mis en correspondance est décrite au début de cette section.

Les objets VM peuvent être listés avec la commande de liste d’objets standard (xe vm-list), et les paramètres manipulés avec les commandes de paramètres standard. Pour plus d’informations, consultez Commandes de paramètres de bas niveau

Paramètres de la VM

Les VM ont les paramètres suivants :

Remarque :

Toutes les valeurs de paramètres de VM modifiables peuvent être changées pendant que la VM est en cours d’exécution, mais les nouveaux paramètres ne sont pas appliqués dynamiquement et ne peuvent pas être appliqués tant que la VM n’est pas redémarrée.

• appliance (lecture/écriture) l’appliance/vApp à laquelle la VM appartient
• uuid (lecture seule) l’identifiant unique/référence d’objet pour la VM
• name-label (lecture/écriture) le nom de la VM
• name-description (lecture/écriture) la chaîne de description de la VM
• order (lecture/écriture) pour le démarrage/l’arrêt de la vApp et pour le démarrage après un basculement HA. Les VM avec une valeur d’ordre de 0 (zéro) sont démarrées en premier, puis les VM avec une valeur d’ordre de 1, et ainsi de suite.
• version (lecture seule) le nombre de fois où cette VM a été récupérée. Si vous souhaitez écraser une nouvelle VM avec une version plus ancienne, appelez vm-recover
• user-version (lecture/écriture) chaîne permettant aux créateurs de VM et de modèles d’insérer des informations de version

• is-a-template (lecture/écriture) La valeur est fausse, sauf si cette VM est un modèle. Les VM modèles ne peuvent jamais être démarrées, elles sont utilisées uniquement pour cloner d’autres VM. Une fois que cette valeur a été définie sur true, elle ne peut pas être réinitialisée sur false. Les VM modèles ne peuvent pas être converties en VM à l’aide de ce paramètre.

  Vous pouvez convertir une VM en modèle avec :

   xe vm-param-set uuid=<vm uuid> is-a-template=true
   <!--NeedCopy-->
  

• is-control-domain (lecture seule) La valeur est vraie s’il s’agit d’un domaine de contrôle (domaine 0 ou un domaine de pilote)
• power-state (lecture seule) état d’alimentation actuel
• start-delay (lecture/écriture) le délai d’attente avant qu’un appel pour démarrer la VM ne retourne en secondes
• shutdown-delay (lecture/écriture) le délai d’attente avant qu’un appel pour arrêter la VM ne retourne en secondes
• memory-dynamic-max (lecture/écriture) maximum dynamique en octets
• memory-dynamic-min (lecture/écriture) minimum dynamique en octets
• memory-static-max (lecture/écriture) maximum statiquement défini (absolu) en octets. Si vous souhaitez modifier cette valeur, la VM doit être arrêtée.
• memory-static-min (lecture/écriture) minimum statiquement défini (absolu) en octets. Si vous souhaitez modifier cette valeur, la VM doit être arrêtée.
• suspend-VDI-uuid (lecture seule) le VDI sur lequel une image de suspension est stockée
• VCPUs-params (paramètre de carte lecture/écriture) paramètres de configuration pour la politique vCPU sélectionnée.
• VCPUs-max (lecture/écriture) nombre maximal de CPU virtuels.
• VCPUs-at-startup (lecture/écriture) nombre de CPU virtuels au démarrage
• actions-after-crash (lecture/écriture) action à entreprendre si la VM plante. Pour les invités PV, les paramètres valides sont :
  • preserve (pour analyse uniquement)
  • coredump_and_restart (enregistrer un coredump et redémarrer la VM)
  • coredump_and_destroy (enregistre un coredump et laisse la VM arrêtée)
  • restart (pas de coredump et redémarre la VM)
  • destroy (pas de coredump et laisse la VM arrêtée)
• console-uuids (paramètre en lecture seule) périphériques de console virtuelle

• platform (paramètre de mappage en lecture/écriture) configuration spécifique à la plateforme

  Pour désactiver le VDA pour basculer Windows 10 en mode Tablette :

   xe vm-param-set uuid=<vm_uuid> platform:acpi_laptop_slate=0
   <!--NeedCopy-->
  

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

   xe vm-param-set uuid=<vm_uuid> platform:acpi_laptop_slate=1
   <!--NeedCopy-->
  

  Pour vérifier l’état actuel :

   xe vm-param-get uuid=<vm_uuid> param-name=platform param-key=acpi_laptop_slate
   <!--NeedCopy-->
  

• allowed-operations (paramètre en lecture seule) liste des opérations autorisées dans cet état
• current-operations (paramètre en lecture seule) liste des opérations en cours sur la VM
• allowed-VBD-devices (paramètre en lecture seule) liste des identifiants VBD disponibles, représentés par des entiers de la plage 0 à 254. Cette liste est uniquement informative, et d’autres périphériques peuvent être utilisés (mais pourraient ne pas fonctionner).
• allowed-VIF-devices (paramètre en lecture seule) liste des identifiants VIF disponibles, représentés par des entiers de la plage 0 à 6. Cette liste est uniquement informative, et d’autres périphériques peuvent être utilisés (mais pourraient ne pas fonctionner).
• HVM-boot-policy (lecture/écriture) la politique de démarrage pour les invités. Soit Ordre BIOS, soit une chaîne vide.
• HVM-boot-params (paramètre de mappage en lecture/écriture) la clé d’ordre contrôle l’ordre de démarrage de l’invité, représentée comme 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 surcharge de mémoire fantôme à accorder à la VM. La valeur par défaut est 1.0 (la valeur minimale), et ne modifiez cette valeur que si vous êtes un utilisateur avancé.
• PV-kernel (lecture/écriture) chemin vers le noyau
• PV-ramdisk (lecture/écriture) chemin vers le 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 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 de démarrage
• last-boot-CPU-flags (lecture seule) décrit les indicateurs de CPU sur lesquels la machine virtuelle a été démarrée pour la dernière fois
• resident-on (lecture seule) l’hôte XenServer sur lequel une machine virtuelle est résidente
• affinity (lecture/écriture) L’hôte XenServer sur lequel la machine virtuelle a une préférence pour s’exécuter. Utilisé par la commande xe vm-start pour décider où exécuter la machine virtuelle. Également connu sous le nom de serveur d’accueil.
• groups (lecture/écriture) le groupe de machines virtuelles auquel cette machine virtuelle appartient. Un groupe de machines virtuelles définit l’endroit où XenServer tente de démarrer la machine virtuelle ou de l’évacuer.

• other-config (paramètre de carte lecture/écriture) Une liste de paires clé-valeur qui spécifient des paramètres de configuration supplémentaires pour la machine virtuelle.

  Par exemple, la paire clé-valeur other-config auto_poweron: true demande de démarrer automatiquement la machine virtuelle après le démarrage de n’importe quel hôte du pool. Vous devez également définir ce paramètre dans le other-config de votre pool. Ces paramètres sont maintenant obsolètes. Utilisez plutôt le paramètre ha-restart-priority.

• start-time (lecture seule) horodatage de la date et de l’heure auxquelles les métriques de la machine virtuelle ont été lues. Cet horodatage est au format yyyymmddThh:mm:ss z, où z est l’indicateur de fuseau horaire militaire à une seule lettre, par exemple, Z pour UTC (GMT)
• install-time (lecture seule) horodatage de la date et de l’heure auxquelles les métriques de la machine virtuelle ont été lues. Cet horodatage est au format yyyymmddThh:mm:ss z, où z est l’indicateur de fuseau horaire militaire à une seule lettre, 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 attribués à la machine virtuelle pour une machine virtuelle Linux. Ce nombre peut différer de VCPUS-max et peut être modifié sans redémarrer la machine virtuelle à l’aide de la commande vm-vcpu-hotplug. Pour plus d’informations, consultez vm-vcpu-hotplug. Les machines virtuelles Windows fonctionnent toujours avec le nombre de vCPU défini sur VCPUsmax et doivent être redémarrées pour modifier cette valeur. Les performances diminuent fortement lorsque vous définissez VCPUs-number sur une valeur supérieure au nombre de processeurs physiques sur l’hôte XenServer.
• VCPUs-Utilization (paramètre de mappage en lecture seule) une liste des processeurs virtuels et de leur poids
• os-version (paramètre de mappage en lecture seule) la version du système d’exploitation de la machine virtuelle
• PV-drivers-version (paramètre de mappage en lecture seule) les versions des pilotes paravirtualisés pour la machine virtuelle
• PV-drivers-detected (lecture seule) indicateur pour la dernière version des pilotes paravirtualisés pour la machine virtuelle
• memory (paramètre de mappage en lecture seule) métriques de mémoire signalées par l’agent sur la machine virtuelle
• disks (paramètre de mappage en lecture seule) métriques de disque signalées par l’agent sur la machine virtuelle
• networks (paramètre de mappage en lecture seule) métriques réseau signalées par l’agent sur la machine virtuelle
• other (paramètre de mappage en lecture seule) autres métriques signalées par l’agent sur la machine virtuelle
• guest-metrics-lastupdated (lecture seule) horodatage de la dernière écriture effectuée par l’agent invité dans ces champs. L’horodatage est au format yyyymmddThh:mm:ss z, où z est l’indicateur de fuseau horaire militaire à une seule lettre, par exemple, Z pour UTC (GMT)
• actions-after-shutdown (lecture/écriture) action à effectuer 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 hôtes potentiels de cette machine virtuelle (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) données à insérer dans l’arbre xenstore (/local/domain/*domid*/vm-data) après la création de la VM
• is-a-snapshot (lecture seule) La valeur est vraie si cette VM est un instantané
• snapshot_of (lecture seule) l’UUID de la VM dont cet instantané est issu
• snapshots (lecture seule) les UUID de tous les instantanés de cette VM
• snapshot_time (lecture seule) l’horodatage de l’opération d’instantané qui a créé cet instantané de VM
• memory-target (lecture seule) la quantité de mémoire cible définie pour cette VM
• blocked-operations (paramètre de carte en lecture/écriture) liste les opérations qui ne peuvent pas être effectuées sur cette VM
• last-boot-record (lecture seule) enregistrement des derniers paramètres de démarrage pour ce modèle, au format XML
• ha-always-run (lecture/écriture) La valeur est vraie si cette VM est toujours redémarrée sur un autre hôte en cas de 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
• blobs (lecture seule) magasin de données binaires
• live (lecture seule) La valeur est vraie si la VM est en cours d’exécution. La valeur est fausse si HA suspecte que la VM n’est pas en cours d’exécution.

vm-assert-can-be-recovered

xe vm-assert-can-be-recovered uuid [database] vdi-uuid
<!--NeedCopy-->

Vérifie si le stockage est disponible pour récupérer cette VM.

vm-call-plugin

xe vm-call-plugin vm-uuid=vm_uuid plugin=plugin fn=function [args:key=value]
<!--NeedCopy-->

Appelle la fonction au sein du plug-in sur la VM donnée avec des arguments facultatifs (args:key=value). Pour passer une chaîne de caractères “value” contenant des caractères spéciaux (par exemple, un saut de ligne), une syntaxe alternative args:key:file=local_file peut être utilisée à la place, où le contenu de local_file sera récupéré et attribué à “key” dans son intégralité.

vm-cd-add

xe vm-cd-add cd-name=name_of_new_cd device=integer_value_of_an_available_vbd [vm-selector=vm_selector_value...]
<!--NeedCopy-->

Ajoutez un nouveau CD virtuel à la VM sélectionnée. Sélectionnez le paramètre device de 0 à 3.

La ou les VM 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, consultez Sélecteurs de VM. Les arguments facultatifs peuvent être n’importe quel nombre des paramètres de VM répertoriés au début de cette section.

vm-cd-eject

xe vm-cd-eject [vm-selector=vm_selector_value...]
<!--NeedCopy-->

Éjectez un CD du lecteur de CD virtuel. Cette commande ne fonctionne que si un seul CD est attaché à la VM. S’il y a deux CD ou plus, utilisez la commande xe vbd-eject et spécifiez l’UUID du VBD.

La ou les VM 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, consultez Sélecteurs de VM. Les arguments facultatifs peuvent être n’importe quel nombre des paramètres de VM répertoriés au début de cette section.

vm-cd-insert

xe vm-cd-insert cd-name=name_of_cd [vm-selector=vm_selector_value...]
<!--NeedCopy-->

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 VM. S’il y a deux périphériques CD vides ou plus, utilisez la commande xe vbd-insert et spécifiez les UUID du VBD et du VDI à insérer.

La ou les VM 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, consultez Sélecteurs de VM. Les arguments facultatifs peuvent être n’importe quel nombre des paramètres de VM répertoriés au début de cette section.

vm-cd-list

xe vm-cd-list [vbd-params] [vdi-params] [vm-selector=vm_selector_value...]
<!--NeedCopy-->

Liste les CD attachés aux VM spécifiées.

La ou les VM 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, consultez Sélecteurs de VM. Les arguments facultatifs peuvent être n’importe quel nombre des paramètres de 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

xe vm-cd-remove cd-name=name_of_cd [vm-selector=vm_selector_value...]
<!--NeedCopy-->

Supprimer 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, consultez Sélecteurs de machines virtuelles. Les arguments facultatifs peuvent être n’importe quel nombre des paramètres de machine virtuelle répertoriés au début de cette section.

vm-checkpoint

xe vm-checkpoint new-name-label=name_label [new-name-description=description]
<!--NeedCopy-->

Créer un point de contrôle d’une machine virtuelle existante, en utilisant une opération d’instantané de disque rapide au niveau du stockage, si disponible.

vm-clone

xe vm-clone new-name-label=name_for_clone [new-name-description=description_for_clone] [vm-selector=vm_selector_value...]
<!--NeedCopy-->

Cloner une machine virtuelle existante, en utilisant une opération de clonage de disque rapide au niveau du stockage, si disponible. Spécifiez le nom et la description facultative de la machine virtuelle clonée résultante à l’aide des arguments new-name-label et new-name-description.

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, consultez Sélecteurs de machines virtuelles. Les arguments facultatifs peuvent être n’importe quel nombre des paramètres de machine virtuelle répertoriés au début de cette section.

vm-compute-maximum-memory

xe vm-compute-maximum-memory total=amount_of_available_physical_ram_in_bytes [approximate=add overhead memory for additional vCPUS? true|false] [vm_selector=vm_selector_value...]
<!--NeedCopy-->

Calculer la quantité maximale de mémoire statique pouvant être allouée à une machine virtuelle existante, en utilisant la quantité totale de RAM physique comme limite supérieure. Le paramètre facultatif approximate réserve suffisamment de mémoire supplémentaire dans le calcul pour tenir compte de l’ajout ultérieur de vCPU supplémentaires à la machine virtuelle.

Par exemple :

xe vm-compute-maximum-memory vm=testvm total=`xe host-list params=memory-free --minimal`
<!--NeedCopy-->

Cette commande utilise la valeur du paramètre memory-free renvoyée par la commande xe host-list pour définir la mémoire maximale de la machine virtuelle nommée testvm.

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, consultez Sélecteurs de machines virtuelles. Les arguments facultatifs peuvent être n’importe quel nombre des paramètres de machine virtuelle répertoriés au début de cette section.

vm-compute-memory-overhead

xe vm-compute-memory-overhead
<!--NeedCopy-->

Calcule la surcharge de mémoire de virtualisation d’une machine virtuelle.

vm-copy

xe vm-copy new-name-label=name_for_copy [new-name-description=description_for_copy] [sr-uuid=uuid_of_sr] [vm-selector=vm_selector_value...]
<!--NeedCopy-->

Copier une VM existante, mais sans utiliser l’opération de clonage rapide de disque au niveau du stockage (même si cette option est disponible). Les images disque de la VM copiée sont garanties d’être des images complètes, c’est-à-dire ne faisant pas partie d’une chaîne de copie sur écriture (CoW).

Spécifiez le nom et la description facultative de la VM copiée résultante à l’aide des arguments new-name-label et new-name-description.

Spécifiez le SR de destination pour la VM copiée résultante à l’aide de sr-uuid. Si ce paramètre n’est pas spécifié, la destination est le même SR que celui de la VM d’origine.

La ou les VM 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, consultez Sélecteurs de VM. Les arguments facultatifs peuvent être n’importe quel nombre des paramètres de VM énumérés au début de cette section.

vm-copy-bios-strings

xe vm-copy-bios-strings host-uuid=host_uuid
<!--NeedCopy-->

Copiez les chaînes BIOS de l’hôte donné vers la VM.

Remarque :

Après le premier démarrage d’une VM, vous ne pouvez pas modifier ses chaînes BIOS. Assurez-vous que les chaînes BIOS sont correctes avant de démarrer la VM pour la première fois.

vm-crashdump-list

xe vm-crashdump-list [vm-selector=vm selector value...]
<!--NeedCopy-->

Répertoriez les crashdumps associés aux VM spécifiées.

Lorsque vous utilisez l’argument facultatif params, la valeur de params est une chaîne contenant une liste de paramètres de cet objet que vous souhaitez afficher. Alternativement, vous pouvez utiliser le mot-clé all pour afficher tous les paramètres. Si params n’est pas utilisé, la liste renvoyée affiche un sous-ensemble par défaut de tous les paramètres disponibles.

La ou les VM 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, consultez Sélecteurs de VM. Les arguments facultatifs peuvent être n’importe quel nombre des paramètres de VM énumérés au début de cette section.

vm-data-source-list

xe vm-data-source-list [vm-selector=vm selector value...]
<!--NeedCopy-->

Répertoriez les sources de données qui peuvent être enregistrées pour une VM.

Sélectionnez les VM sur lesquelles effectuer cette opération à l’aide du mécanisme de sélection standard. Pour plus d’informations, consultez Sélecteurs de VM. Les arguments facultatifs peuvent être n’importe quel nombre des paramètres de VM énuméré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 VM.

Les sources de données ont deux paramètres – standard et enabled – que vous pouvez voir dans la sortie de cette commande. Si une source de données a enabled défini sur true, les métriques sont actuellement enregistrées dans la base de données de performances. Si une source de données a standard défini sur true, les métriques sont enregistrées dans la base de données de performances par défaut (et enabled est également défini sur true pour cette source de données). Si une source de données a standard défini sur false, les métriques ne sont pas enregistrées dans la base de données de performances par défaut (et enabled est également défini sur false pour cette source de données).

Pour commencer à enregistrer les métriques de la 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 vm-data-source-forget. Cette commande définit enabled sur false.

vm-data-source-record

xe vm-data-source-record data-source=name_description_of_data-source [vm-selector=vm selector value...]
<!--NeedCopy-->

Enregistre la source de données spécifiée pour une VM.

Cette opération écrit les informations de la source de données dans la base de données de métriques de performances persistante des VM spécifiées. Pour des raisons de performances, cette base de données est distincte de la base de données d’agent normale.

Sélectionnez les VM sur lesquelles effectuer cette opération en utilisant le mécanisme de sélection standard. Pour plus d’informations, consultez Sélecteurs de VM. Les arguments facultatifs peuvent être n’importe quel nombre des paramètres de VM listés au début de cette section. Si aucun paramètre pour sélectionner les hôtes n’est donné, l’opération est effectuée sur toutes les VM.

vm-data-source-forget

xe vm-data-source-forget data-source=name_description_of_data-source [vm-selector=vm selector value...]
<!--NeedCopy-->

Arrête l’enregistrement de la source de données spécifiée pour une VM et supprime toutes les données enregistrées.

Sélectionnez les VM sur lesquelles effectuer cette opération en utilisant le mécanisme de sélection standard. Pour plus d’informations, consultez Sélecteurs de VM. Les arguments facultatifs peuvent être n’importe quel nombre des paramètres de VM listés au début de cette section. Si aucun paramètre pour sélectionner les hôtes n’est donné, l’opération est effectuée sur toutes les VM.

vm-data-source-query

xe vm-data-source-query data-source=name_description_of_data-source [vm-selector=vm_selector_value...]
<!--NeedCopy-->

Affiche la source de données spécifiée pour une VM.

Sélectionnez les VM sur lesquelles effectuer cette opération en utilisant le mécanisme de sélection standard. Pour plus d’informations, consultez Sélecteurs de VM. Les arguments facultatifs peuvent être n’importe quel nombre des paramètres de VM listés au début de cette section. Si aucun paramètre pour sélectionner les hôtes n’est donné, l’opération est effectuée sur toutes les VM.

vm-destroy

xe vm-destroy uuid=uuid_of_vm
<!--NeedCopy-->

Détruit la VM spécifiée. Cela laisse le stockage associé à la VM intact. Pour supprimer également le stockage, utilisez xe vm-uninstall.

vm-disk-add

xe vm-disk-add disk-size=size_of_disk_to_add device=uuid_of_device [vm-selector=vm_selector_value...]
<!--NeedCopy-->

Ajoutez un disque aux machines virtuelles spécifiées. Sélectionnez le paramètre device à partir de la valeur du paramètre allowed-VBD-devices des machines virtuelles.

Le paramètre disk-size peut être spécifié en octets ou en utilisant les suffixes standard IEC KiB, MiB, GiB 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, consultez Sélecteurs de machines virtuelles. Les arguments facultatifs peuvent être n’importe quel nombre des paramètres de machine virtuelle répertoriés au début de cette section.

vm-disk-list

xe vm-disk-list [vbd-params] [vdi-params] [vm-selector=vm_selector_value...]
<!--NeedCopy-->

Répertorie les disques attachés aux machines virtuelles spécifiées. Les paramètres vbd-params et vdi-params contrôlent les champs des objets respectifs à afficher. Indiquez les paramètres sous forme de liste séparée par des virgules, ou la clé spéciale all 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, consultez Sélecteurs de machines virtuelles. Les arguments facultatifs peuvent être n’importe quel nombre des paramètres de machine virtuelle répertoriés au début de cette section.

vm-disk-remove

xe vm-disk-remove device=integer_label_of_disk [vm-selector=vm_selector_value...]
<!--NeedCopy-->

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, consultez Sélecteurs de machines virtuelles. Les arguments facultatifs peuvent être n’importe quel nombre des paramètres de machine virtuelle répertoriés au début de cette section.

vm-export

xe vm-export filename=export_filename [metadata=true|false] [vm-selector=vm_selector_value...]
<!--NeedCopy-->

Exportez les machines virtuelles spécifiées (y compris les images disque) vers un fichier sur la machine locale. Spécifiez le nom du fichier dans lequel exporter la machine virtuelle à l’aide du paramètre filename. Par convention, le nom du fichier a une extension .xva.

Si le paramètre metadata est true, 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é par d’autres mécanismes et permet de recréer les informations de la machine virtuelle. Pour plus d’informations, consultez vm-import.

La ou les machines virtuelles sur lesquelles cette opération est effectuée sont sélectionnées à l’aide du mécanisme de sélection standard. Pour plus d’informations, consultez Sélecteurs de machines virtuelles. Les arguments facultatifs peuvent être n’importe quel nombre des paramètres de machine virtuelle répertoriés au début de cette section.

vm-import

xe vm-import filename=export_filename [metadata=true|false] [preserve=true|false][sr-uuid=destination_sr_uuid]
<!--NeedCopy-->

Importez une machine virtuelle à partir d’un fichier précédemment exporté. Si preserve est défini sur true, l’adresse MAC de la machine virtuelle d’origine est conservée. Le sr-uuid détermine le SR de destination dans lequel importer la machine virtuelle. Si ce paramètre n’est pas spécifié, le SR par défaut est utilisé.

Si le metadata est true, vous pouvez importer un ensemble de métadonnées précédemment exporté sans leurs blocs de disque associés. L’importation de métadonnées uniquement échoue si des VDI ne peuvent pas être trouvés (nommés par SR et VDI.location) à moins que l’option --force ne soit spécifiée, auquel cas l’importation se poursuit quoi qu’il arrive. 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.

Remarque :

Les importations de plusieurs machines virtuelles sont effectuées plus rapidement en série qu’en parallèle.

vm-install

xe vm-install new-name-label=name [template-uuid=uuid_of_desired_template] [template=template_uuid_or_name] [sr-uuid=sr_uuid | sr-name-label=name_of_sr][copy-bios-strings-from=host_uuid]
<!--NeedCopy-->

Installez ou clonez une machine virtuelle à partir d’un modèle. Spécifiez le nom du modèle en utilisant l’argument template-uuid ou template. Spécifiez un SR en utilisant l’argument sr-uuid ou sr-name-label. Spécifiez l’installation de médias verrouillés par le BIOS en utilisant l’argument copy-bios-strings-from.

Remarque :

Lors de l’installation à partir d’un modèle comportant 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 dans le SR par défaut du pool si aucun SR n’est spécifié.

vm-is-bios-customized

xe vm-is-bios-customized
<!--NeedCopy-->

Indique si les chaînes BIOS de la machine virtuelle ont été personnalisées.

vm-memory-dynamic-range-set

xe vm-memory-dynamic-range-set min=min max=max
<!--NeedCopy-->

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 souples pour 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 s’inscrire dans la plage statique.

vm-memory-limits-set

xe vm-memory-limits-set static-min=static_min static-max=static_max dynamic-min=dynamic_min dynamic-max=dynamic_max
<!--NeedCopy-->

Configurez les limites de mémoire d’une machine virtuelle.

vm-memory-set

xe vm-memory-set memory=memory
<!--NeedCopy-->

Configurez l’allocation de mémoire d’une machine virtuelle.

vm-memory-shadow-multiplier-set

xe vm-memory-shadow-multiplier-set [vm-selector=vm_selector_value...] [multiplier=float_memory_multiplier]
<!--NeedCopy-->

Définissez le multiplicateur de mémoire fantôme pour la machine virtuelle spécifiée.

Il s’agit d’une option avancée qui modifie la quantité de mémoire fantôme attribuée à une machine virtuelle assistée par matériel.

Dans certaines charges de travail d’applications spécialisées, telles que Citrix Virtual Apps™, une mémoire fantôme supplémentaire est requise pour atteindre des performances optimales.

Cette mémoire est considérée comme une surcharge. Elle est séparée des calculs de mémoire normaux pour l’attribution de mémoire à une machine virtuelle. Lorsque cette commande est invoquée, la quantité de mémoire hôte libre diminue en fonction du multiplicateur et le champ HVM_shadow_multiplier est mis à jour avec la valeur que Xen a attribuée à la machine virtuelle. S’il n’y a pas suffisamment de mémoire hôte XenServer libre, une erreur est renvoyée.

Les machines virtuelles sur lesquelles effectuer cette opération sont sélectionnées à l’aide du mécanisme de sélection standard. Pour plus d’informations, consultez Sélecteurs de machines virtuelles.

vm-memory-static-range-set

xe vm-memory-static-range-set min=min max=max
<!--NeedCopy-->

Configurez la plage de mémoire statique d’une machine virtuelle. La plage de mémoire statique définit des limites inférieures et supérieures strictes pour la mémoire d’une machine virtuelle. Il n’est possible de modifier ces champs que lorsqu’une machine virtuelle est arrêtée. La plage statique doit englober la plage dynamique.

vm-memory-target-set

xe vm-memory-target-set target=target
<!--NeedCopy-->

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

xe vm-migrate [compress=true|false] [copy=true|false] [host-uuid=destination_host_uuid] [host=name_or_ uuid_of_destination_host] [force=true|false] [live=true|false] [vm-selector=vm_selector_value...] [remote-master=destination_pool_master_uuid] [remote-username=destination_pool_username] [remote-password=destination_pool_password] [remote-network=destination_pool_network_uuid ][vif:source_vif_uuid=destination_network_uuid] [vdi:vdi_uuid=destination_sr_uuid]
<!--NeedCopy-->

Cette commande migre les machines virtuelles spécifiées entre les hôtes physiques.

Le paramètre compress remplace le paramètre de pool migration-compression pour xe pool-param-set.

Le paramètre host de la commande vm-migrate peut être soit le nom, soit l’UUID de l’hôte XenServer. Par exemple, pour migrer la machine virtuelle vers un autre hôte du pool, où les disques de la machine virtuelle se trouvent sur un stockage partagé par les deux hôtes :

xe vm-migrate uuid=vm_uuid host-uuid=destination_host_uuid
<!--NeedCopy-->

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

xe vm-migrate uuid=vm_uuid host-uuid=destination_host_uuid \
    remote-master=192.0.2.35 remote-username=username remote-password=password
<!--NeedCopy-->

Pour la migration de stockage en direct, vous devez fournir le nom d’hôte ou l’adresse IP, le nom d’utilisateur et le mot de passe du coordinateur de pool, même lorsque vous migrez au sein du même pool.

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

xe vm-migrate uuid=vm_uuid remote-master=192.0.2.35 remote-username=username remote-password=password host-uuid=destination_host_uuid \
    vdi:vdi_1=destination_sr1_uuid \
    vdi:vdi_2=destination_sr2_uuid \
    vdi:vdi_3=destination_sr3_uuid
<!--NeedCopy-->

De plus, vous pouvez choisir le réseau auquel attacher la machine virtuelle après la migration :

xe vm-migrate uuid=vm_uuid \
    vdi1:vdi_1_uuid=destination_sr1_uuid \
    vdi2:vdi_2_uuid=destination_sr2_uuid \
    vdi3:vdi_3_uuid=destination_sr3_uuid \
    vif:source_vif_uuid=destination_network_uuid
<!--NeedCopy-->

Pour la migration inter-pool :

xe vm-migrate uuid=vm_uuid remote-master=192.0.2.35 \
    remote-username=username remote-password=password \
    host-uuid=destination_host_uuid  \
    vif:source_vif_uuid=destination_network_uuid \
    vdi:vdi_uuid=destination_sr_uuid
<!--NeedCopy-->

Pour plus d’informations sur la migration de stockage en direct, la migration en direct et la migration de VDI en direct, consultez Migrer des machines virtuelles.

Remarque :

Si vous effectuez une mise à niveau à partir d’une version antérieure de XenServer, vous devrez peut-être arrêter et démarrer toutes les machines virtuelles après la migration de vos machines virtuelles, afin de vous assurer que les nouvelles fonctionnalités de virtualisation sont prises en compte.

Par défaut, la machine virtuelle est suspendue, migrée et reprise sur l’autre hôte. Le paramètre live sélectionne la migration en direct. La migration en direct maintient la machine virtuelle en cours d’exécution pendant la migration, minimisant ainsi les temps d’arrêt de la machine virtuelle. Dans certaines circonstances, comme des charges de travail extrêmement gourmandes en mémoire dans la machine virtuelle, la migration en direct revient 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, consultez Sélecteurs de machines virtuelles. Les arguments facultatifs peuvent être n’importe quel nombre des paramètres de machine virtuelle répertoriés au début de cette section.

vm-pause

xe vm-pause
<!--NeedCopy-->

Met en pause une machine virtuelle en cours d’exécution. Notez que cette opération ne libère pas la mémoire associée (voir vm-suspend).

vm-reboot

xe vm-reboot [vm-selector=vm_selector_value...] [force=true]
<!--NeedCopy-->

Redémarre 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, consultez Sélecteurs de machines virtuelles. Les arguments facultatifs peuvent être n’importe quel nombre des paramètres de machine virtuelle répertoriés au début de cette section.

Utilisez l’argument force pour provoquer un redémarrage non gracieux. L’arrêt est comparable à débrancher un serveur physique.

vm-recover

xe vm-recover vm-uuid [database] [vdi-uuid] [force]
<!--NeedCopy-->

Récupère une machine virtuelle à partir de la base de données contenue dans le VDI fourni.

vm-reset-powerstate

xe vm-reset-powerstate [vm-selector=vm_selector_value...] {force=true}
<!--NeedCopy-->

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, consultez Sélecteurs de VM. Les arguments facultatifs peuvent être n’importe quel nombre des paramètres de VM énumérés au début de cette section.

Il s’agit d’une commande avancée à utiliser uniquement lorsqu’un hôte membre d’un pool tombe en panne. Vous pouvez utiliser cette commande pour forcer le coordinateur du pool à réinitialiser l’état d’alimentation des machines virtuelles à halted. Essentiellement, cette commande force le verrouillage de la machine virtuelle et de ses disques afin qu’elle puisse être démarrée ensuite sur un autre hôte du pool. Cet appel exige que l’indicateur de forçage soit spécifié, et échoue s’il n’est pas présent sur la ligne de commande.

vm-restart-device-models

xe vm-restart-device-models [vm-selector=vm_selector_value...]
<!--NeedCopy-->

Redémarre le modèle de périphérique pour cette machine virtuelle sur l’hôte. Pendant le redémarrage du modèle de périphérique, vous ne pouvez pas arrêter, démarrer ou migrer la machine virtuelle. L’utilisateur final de la machine virtuelle pourrait observer une légère pause et une reprise de sa session.

Remarque :

Pour que l’action de redémarrage du modèle de périphérique soit prise en charge sur une machine virtuelle Windows, la machine virtuelle doit avoir les XenServer VM Tools pour Windows installés.

vm-resume

xe vm-resume [vm-selector=vm_selector_value...] [force=true|false] [on=host_uuid]
<!--NeedCopy-->

Reprend 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, consultez Sélecteurs de VM. Les arguments facultatifs peuvent être n’importe quel nombre des paramètres de VM énumérés au début de cette section.

Si la machine virtuelle se trouve sur un SR partagé dans un pool d’hôtes, utilisez l’argument on pour spécifier sur quel membre du pool la démarrer. Par défaut, le système détermine un hôte approprié, qui peut être n’importe lequel des membres du pool.

vm-retrieve-wlb-recommendations

xe vm-retrieve-wlb-recommendations
<!--NeedCopy-->

Récupérer les recommandations d’équilibrage de charge pour la VM sélectionnée.

vm-shutdown

xe vm-shutdown [vm-selector=vm_selector_value...] [force=true|false]
<!--NeedCopy-->

Arrêter la VM spécifiée.

La ou les VM 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, consultez sélecteurs de VM. Les arguments facultatifs peuvent être n’importe quel nombre des paramètres de VM répertoriés au début de cette section.

Utilisez l’argument force pour provoquer un arrêt brutal, similaire à débrancher un serveur physique.

vm-snapshot

xe vm-snapshot new-name-label=name_label [new-name-description+name_description]
<!--NeedCopy-->

Créer un instantané d’une VM existante, en utilisant une opération d’instantané de disque rapide au niveau du stockage, si disponible.

vm-start

xe vm-start [vm-selector=vm_selector_value...] [force=true|false] [on=host_uuid] [--multiple]
<!--NeedCopy-->

Démarrer les VM spécifiées.

La ou les VM 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, consultez sélecteurs de VM. Les arguments facultatifs peuvent être n’importe quel nombre des paramètres de VM répertoriés au début de cette section.

Si les VM se trouvent sur un SR partagé dans un pool d’hôtes, utilisez l’argument on pour spécifier sur quel membre du pool démarrer les VM. Par défaut, le système détermine un hôte approprié, qui peut être n’importe quel membre du pool.

vm-suspend

xe vm-suspend [vm-selector=vm_selector_value...]
<!--NeedCopy-->

Suspendre la VM spécifiée.

La ou les VM 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, consultez sélecteurs de VM. Les arguments facultatifs peuvent être n’importe quel nombre des paramètres de VM répertoriés au début de cette section.

vm-uninstall

xe vm-uninstall [vm-selector=vm_selector_value...] [force=true|false]
<!--NeedCopy-->

Désinstallez une VM, en détruisant ses disques (les VDI marqués RW et connectés uniquement à cette VM) en plus de son enregistrement de métadonnées. Pour détruire uniquement les métadonnées de la VM, utilisez xe vm-destroy.

La ou les VM 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, consultez Sélecteurs de VM. Les arguments facultatifs peuvent être n’importe quel nombre des paramètres de VM listés au début de cette section.

vm-unpause

xe vm-unpause
<!--NeedCopy-->

Reprendre une VM en pause.

vm-vcpu-hotplug

xe vm-vcpu-hotplug new-vcpus=new_total_vcpu_count [vm-selector=vm_selector_value...]
<!--NeedCopy-->

Ajustez dynamiquement le nombre de vCPU disponibles pour une VM Linux en cours d’exécution. Le nombre de vCPU est limité par le paramètre VCPUs-max. Les VM Windows fonctionnent toujours avec le nombre de vCPU défini sur VCPUs-max et doivent être redémarrées pour modifier cette valeur.

Utilisez le paramètre new-vcpus pour définir le nouveau nombre total de vCPU que vous souhaitez avoir après l’exécution de cette commande. N’utilisez pas ce paramètre pour indiquer le nombre de vCPU que vous souhaitez ajouter. Par exemple, si vous avez deux vCPU existants dans votre VM et que vous souhaitez en ajouter deux autres, spécifiez new-vcpus=4.

La ou les VM Linux ou Windows 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, consultez Sélecteurs de VM. Les arguments facultatifs peuvent être n’importe quel nombre des paramètres de VM listés au début de cette section.

Remarque :

Lorsque vous exécutez des VM Linux sans les outils XenServer VM Tools installés, exécutez la commande suivante sur la VM en tant que root pour vous assurer que les vCPU nouvellement connectés à chaud sont utilisés : # for i in /sys/devices/system/cpu/cpu[1-9]*/online; do if [ "$(cat $i)" = 0 ]; then echo 1 > $i; fi; done

vm-vif-list

xe vm-vif-list [vm-selector=vm_selector_value...]
<!--NeedCopy-->

Liste les VIF des VM spécifiées.

La ou les VM 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, consultez Sélecteurs de VM. Les sélecteurs opèrent sur les enregistrements de VM lors du filtrage, et non sur les valeurs VIF. Les arguments facultatifs peuvent être n’importe quel nombre des paramètres de VM listés au début de cette section.

Instantanés planifiés

Commandes pour contrôler les instantanés planifiés des VM et leurs attributs.

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

vmss-create

xe vmss-create enabled=true/false name-label=name type=type frequency=frequency retained-snapshots=value name-description=description schedule:schedule
<!--NeedCopy-->

Crée un programme 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
<!--NeedCopy-->

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

vmss-destroy

xe vmss-destroy uuid=uuid
<!--NeedCopy-->

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

Pass-through USB

Le pass-through USB est pris en charge pour les versions USB suivantes : 1.1, 2.0 et 3.0.

Activation/désactivation du pass-through USB

xe pusb-param-set uuid=pusb_uuid passthrough-enabled=true/false
<!--NeedCopy-->

Active/désactive le pass-through USB.

pusb-scan

xe pusb-scan host-uuid=host_uuid
<!--NeedCopy-->

Analyse et met à jour le PUSB.

vusb-create

xe vusb-create usb-group-uuid=usb_group_uuid vm-uuid=vm_uuid
<!--NeedCopy-->

Crée un USB virtuel dans le pool. Démarrez la VM pour faire passer l’USB à la VM.

vusb-unplug

xe vusb-unplug uuid=vusb_uuid
<!--NeedCopy-->

Déconnecte l’USB de la VM.

vusb-destroy

xe vusb-destroy uuid=vusb_uuid
<!--NeedCopy-->

Supprime la liste USB virtuelle de la VM.

Commandes de groupe de VM

Commandes pour contrôler les groupes de VM et leurs attributs.

Paramètres de groupe de VM

• uuid (lecture seule) l’identifiant unique/la référence d’objet pour la VM
• name-label (lecture/écriture) le nom de la VM
• name-description (lecture/écriture) la chaîne de description de la VM
• placement (lecture seule) le type de règles de placement à appliquer aux VM du groupe. Les valeurs disponibles sont anti-affinity et normal.

vm-group-list

xe vm-group-list
<!--NeedCopy-->

Liste tous les groupes de VM de ce pool.

vm-group-create

xe vm-group-create placement=anti-affinity|normal name-label=<name-label> [name-description=<name-description>]
<!--NeedCopy-->

Crée un groupe de VM.

vm-group-destroy

xe vm-group-destroy uuid=<vm-group-uuid>
<!--NeedCopy-->

Supprime ce groupe de VM. Si vous supprimez un groupe de VM qui contient des VM, les VM ne sont plus associées à un groupe, mais ne sont pas affectées autrement.