Interface de ligne de commande

Le Xe L’interface de ligne de commande 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.

Prise en main de 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 xe CLI dans la console dom0. Accédez à la console dom0 de l’une des manières suivantes :

• Dans XenCenter, accédez à l’onglet Consoler de l’hôte sur lequel vous souhaitez exécuter la commande.
• SSH dans l’hôte où vous souhaitez exécuter la commande.

Sous Windows

Sous Windows, le xe.exe est installée en même temps que XenCenter.

Pour utiliser le xe.exe , ouvrez une invite de commande Windows et changez de répertoire pour le répertoire où la commande xe.exe fichier est localisé (généralement C :\Program Files (x86)\XenServer\XenCentre). Si vous ajoutez l’icône xe.exe à votre chemin d’accès système, vous pouvez utiliser la commande sans avoir à passer dans le répertoire.

Sous Linux

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

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

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

Vous pouvez utiliser les paramètres de la 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. Toutefois, vous avez également la possibilité de définir ces informations en tant que variable d’environnement. Par exemple :

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

Remarque :

L’interface de ligne de commande xe distante sous Linux peut se bloquer lors d’une tentative d’exécution de commandes via une connexion sécurisée et ces commandes impliquent un transfert de fichiers. Si c’est le cas, vous pouvez utiliser l’option --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 xe de base

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

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

Chaque commande spécifique contient son propre ensemble d’arguments qui sont de la forme argument=valeur. Certaines commandes ont des arguments obligatoires, et la plupart ont un ensemble d’arguments facultatifs. En règle générale, une commande suppose des valeurs par défaut pour certains des arguments 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.

Le serveur est utilisé pour spécifier le nom d’hôte ou l’adresse IP. Le nom d’utilisateur et mot de passe sont utilisés pour spécifier les informations d’identification.

Un fichier-mot de passe peut être spécifié à la place du mot de passe directement. Dans ce cas, la commande xe tente de lire le mot de passe à partir du fichier spécifié et utilise ce mot de passe pour se connecter. (Tous les CR et LF de fin à la fin du fichier sont supprimés.) Cette méthode est plus sûre que de spécifier le mot de passe directement sur la ligne de commande.

L’option 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
• -prisonnier de guerre mot de passe
• -pwf fichier de mot de passe
• -p port
• -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 entrer 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 permet également de compléter par tabulation les commandes xe lorsqu’elles sont émises sur un hôte XenServer distant, qui est désactivé par défaut.

Caractères spéciaux et syntaxe

Pour spécifier des paires argument/valeur sur le Xe ligne de commande, écrivez : argument=valeur

À moins que la valeur n’inclue des espaces, n’utilisez pas de guillemets. N’incluez pas d’espace entre le nom de l’argument, le signe égal (=) et la valeur. Tout argument non conforme à ce format est ignoré.

Pour les valeurs contenant des espaces, écrivez : argument="valeur avec espaces »

Lorsque vous utilisez l’interface de ligne de commande sur votre hôte XenServer, les commandes disposent d’une fonction de complétion d’onglet similaire à celle du shell bash Linux standard. Par exemple, si vous tapez xe vm-l puis appuyez sur le bouton ONGLET , le reste de la commande s’affiche. Si plusieurs commandes commencent par vm-lpressant ONGLET une seconde fois énumère les possibilités. Cette fonctionnalité est utile lors de la spécification d’UUID d’objet dans les commandes.

Remarque :

La saisie semi-automatique par tabulation ne fonctionne normalement pas lors de l’exécution de commandes sur un hôte XenServer distant. Toutefois, si vous définissez la variable XE_EXTRA_ARGS sur l’ordinateur sur lequel vous entrez les commandes, la saisie semi-automatique de tabulation est activée. Pour plus d’informations, consultez Syntaxe xe de base.

Types de commandes

Les commandes CLI peuvent être divisées en deux moitiés. 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 des machines virtuelles ou des hôtes à un niveau plus abstrait.

Les commandes de bas niveau sont les suivantes :

• classe-liste

• classe-param-get

• classe-param-set

• classe-liste-param

• classe-param-ajouter

• classe-param-supprimer

• classe-param-clear

Où classe est l’un des 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 classe dispose de l’ensemble complet des classe-Param-action Commandes. Certaines valeurs de classe avoir un ensemble de commandes plus petit.

Types de paramètres

Les objets qui sont adressés avec les commandes xe ont des ensembles de paramètres qui les identifient et définissent leurs états.

La plupart des paramètres prennent une seule valeur. Par exemple, le nom-étiquette d’une machine virtuelle 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 machine virtuelle spécifiée peut avoir les lignes suivantes :

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

Le premier paramètre, Version utilisateur, est accessible en écriture et a la valeur 1. La seconde, domaine-de-contrôle-is-, est en lecture seule et a la valeur false.

Les deux autres types de paramètres sont à valeurs multiples. Un poser contient une liste de valeurs. Un carte est un ensemble de paires clé/valeur. À titre d’exemple, regardez l’exemple suivant de sortie de la xe vm-param-list sur une machine virtuelle spécifiée :

  platform (MRW): acpi: true; apic: true; pae: true; nx: false
  allowed-operations (SRO): pause; clean_shutdown; clean_reboot; \
  hard_shutdown; hard_reboot; suspend

Le plateforme contient une liste d’éléments qui représentent des paires clé/valeur. Les noms des touches sont suivis d’un caractère deux-points (:). Chaque paire clé/valeur est séparée de la suivante par un point-virgule (;). Le M précédant le RW indique que ce paramètre est un paramètre de mappage et qu’il est lisible et accessible en écriture. Le opérations-autorisées a une liste qui constitue un ensemble d’éléments. Le S précédant l’RO indique qu’il s’agit d’un paramètre défini et qu’il est lisible mais pas accessible en écriture.

Pour filtrer sur un paramètre de mappage ou définir un paramètre de mappage, utilisez un deux-points (:) pour séparer le nom du paramètre de mappage et la paire clé/valeur. Par exemple, pour définir la valeur de la fonction Foo clé de la autre-config d’une machine virtuelle à bêler, 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 : classe-param-get, classe-param-set, classe-param-add, classe-param-supprimer, classe-param-clear, et classe-param-list. Chacune de ces commandes prend un 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 machine virtuelle.

• xe class-param-list uuid=uuid

  Répertorie tous les paramètres et leurs valeurs associées. Contrairement à la classe-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 carte, la spécification de la clé de paramètre permet d’obtenir la valeur associée à cette clé dans la carte. Si param-key n’est pas spécifié ou si le paramètre est un ensemble, la commande renvoie une représentation sous forme de chaîne de caractères de l’ensemble ou de la carte.

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

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

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

  S’ajoute à une carte ou à un paramètre défini. Pour un paramètre de mappage, ajoutez des paires clé/valeur à l’aide de la syntaxe clé=valeur. Si le paramètre est un défini, 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

Le classe-list liste les objets de type classe. Par défaut, ce type de commande répertorie tous les objets, en imprimant un sous-ensemble des paramètres. Ce comportement peut être modifié de la manière suivante :

• Il peut filtrer les objets de sorte qu’il ne génère qu’un sous-ensemble
• Les paramètres imprimés peuvent être modifiés.

Pour modifier les paramètres affichés, spécifiez l’argument Paramètres sous la forme d’une liste des paramètres requis, séparés par des virgules. Par exemple :

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

Sinon, 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 illustrés, par exemple :

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

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

Pour filtrer la liste, l’interface de ligne de commande fait correspondre les valeurs des paramètres avec les valeurs spécifiées sur la ligne de commande, en affichant uniquement 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 répertorie uniquement les machines virtuelles pour lesquelles les deux Le terrain état-de-puissance a la valeur Arrêté et le terrain HVM-boot-policy a la valeur Ordre du BIOS.

Vous pouvez également filtrer la liste en fonction de la valeur des clés dans les cartes ou de l’existence de valeurs dans un ensemble. La syntaxe de filtrage basé sur les clés dans les cartes est la suivante map-name :clé=valeur. La syntaxe de filtrage en fonction des valeurs existantes dans un ensemble est la suivante : nom_ensemble :contient=valeur.

Lors de la création de scripts, une technique utile consiste à passer --minimal sur la ligne de commande, ce qui entraîne Xe pour imprimer uniquement 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 texte brut, dans l’historique de la ligne de commande ou sur des objets API. XenCenter utilise cette fonctionnalité automatiquement et peut également être utilisée à partir de l’interface de ligne de commande xe pour toute commande nécessitant un mot de passe.

Remarque :

Les secrets de mot de passe ne peuvent pas être utilisés pour s’authentifier auprès d’un hôte XenServer à partir d’une instance distante de l’interface de ligne de commande xe.

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

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

Un secret est créé et stocké sur l’hôte XenServer. La commande génère l’UUID de l’objet secret. Par exemple 99945d96-5890-de2a-3899-8c04ef2521db. Ajouter _secret au nom de l’argument password 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, prenez des secrets comme des mots de passe comme 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 de processus. Il est donc important de n’exécuter ces commandes que dans des environnements fiables.

Pour le shell bash, vous pouvez utiliser l’attribut HISTCONTROL pour contrôler les commandes stockées dans l’historique de l’interpréteur de commandes.

Référence de la commande xe

Cette section regroupe les commandes en fonction des objets qu’elles traitent. Ces objets sont classés par ordre alphabétique.

Commandes de l’appliance

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

Paramètres de l’appareil

Les commandes de l’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 du stockage est disponible pour récupérer cette appliance de machine virtuelle/vApp.

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

Ajoutez 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érez une appliance VM/vApp à 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 machines virtuelles 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 depuis est présent, il télécharge uniquement les enregistrements de ce point précis dans le temps.

audit-log-get Paramètres

audit-log-get a les paramètres suivants

audit-log-get

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

Par exemple, pour obtenir des enregistrements d’audit du pool à partir d’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 l’utilisation des liaisons réseau, pour la résilience avec le basculement de l’interface physique. Pour plus d’informations, consultez Réseautage.

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

Paramètres de liaison

Les obligations ont les paramètres suivants :

bond-create

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

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

• Si les FRP sont déjà dans une autre obligation
• Si un membre a 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 d’un hôte une interface liée spécifiée par son UUID.

bond-set-mode

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

Changez le mode de liaison.

Commandes CD

Commandes permettant d’utiliser des lecteurs de CD/DVD physiques sur des hôtes XenServer.

Paramètres CD

Les CD ont les paramètres suivants :

cd-list

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

Répertorier les CD et les ISO (fichiers image CD) sur l’hôte ou le pool XenServer, en filtrant sur l’argument facultatif Paramètres.

Si l’argument facultatif Paramètres 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é tout pour afficher tous les paramètres. Quand Paramètres 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 de l’ Paramètres CD répertorié au début de cette section.

Commandes de cluster

Commandes permettant d’utiliser des pools en cluster.

Les pools en cluster sont des pools de ressources pour lesquels la fonctionnalité de clustering est activée. Utilisez ces pools avec des SR GFS2. Pour plus d’informations, consultez Pools en cluster

Les objets cluster et cluster-host peuvent être répertoriés à l’aide des commandes standard de liste d’objets (xe cluster-list et xe cluster-host-list) et les paramètres manipulés à l’aide des commandes de paramètres standard. Pour plus d’informations, consultez Commandes de paramètres de bas niveau. Commandes permettant d’utiliser des pools en cluster.

Paramètres du cluster

Les clusters ont les paramètres suivants :

cluster-host-destroy

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

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

cluster-host-disable

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

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

cluster-host-enable

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

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

cluster-host-force-destroy

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

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

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éez un cluster à l’échelle du pool.

cluster-pool-destroy

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

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

cluster-pool-force-destroy

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

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

cluster-pool-resync

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

Resynchronisez un cluster sur un pool.

Commandes de la console

Commandes pour l’utilisation des consoles.

Les objets de la console peuvent être répertoriés à l’aide de la commande standard de liste d’objets (xe liste-console) et les paramètres manipulés à l’aide des 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-->

Fixez-le à une console particulière.

Commandes de diagnostic

Commandes permettant de collecter des informations de diagnostic à partir de XenServer.

diagnostic-compact

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

Effectuez une collecte GC majeure et un compactage du tas.

diagnostic-db-stats

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

Imprimer les statistiques de la base de données.

diagnostic-gc-stats

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

Imprimez les statistiques du GC.

diagnostic-license-status

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

Aidez à 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-->

Imprimez les statistiques du réseau.

diagnostic-timing-stats

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

Imprimer les statistiques de chronométrage.

diagnostic-vdi-status

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

Interrogez l’état de verrouillage et de partage d’une VDI.

diagnostic-vm-status

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

Interrogez les hôtes sur lesquels la VM peut démarrer, vérifiez l’état de partage/verrouillage de tous les VBD.

Commandes de récupération d’urgence

Commandes de récupération de 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 récupération d’urgence. Par exemple, pour vous connecter à un SR iSCSI en vue d’une récupération d’urgence :

  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 Liste blanche sr répertorie les UUID SR autorisés. Le drtask-create ne présente et se connecte à un SR qui a l’un des UUID autorisés

drtask-destroy

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

Détruit une tâche de récupération d’urgence 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 du 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 du dispositif/vAPP) est visible.

appliance-recover

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

Récupérez 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 machine virtuelle à 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 la SR spécifiée.

Exemple d’utilisation

L’exemple ci-dessous montre les commandes de l’interface de ligne de commande DR en contexte :

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

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

Après un sinistre, sur le site secondaire, connectez-vous au SR. Le configuration-appareil a les mêmes champs que Sonde SR.

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

Interroger une VDI de base de données pour les machines virtuelles présentes :

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

Récupérer une machine virtuelle :

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

Détruisez la tâche DR. Tous les SR introduits par la tâche DR et non requis par les machines virtuelles sont détruits :

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

Commandes d’événements

Commandes permettant d’utiliser des é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-->

Empêche l’exécution d’autres commandes jusqu’à ce qu’il existe un objet qui satisfait les conditions données sur la ligne de commande. L’argument x=y signifie « Attendez que le champ X prenne la valeur y » et x=/=y signifie « Attendez que le champ X prenne une valeur autre que Y ».

Exemple: attendez qu’une machine virtuelle spécifique soit en cours d’exécution.

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

Bloque les autres commandes jusqu’à ce qu’une machine virtuelle appelée myvm se trouve dans le état-de-puissance « En courant. »

Exemple: attendez le redémarrage d’une machine virtuelle spécifique :

  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 machine virtuelle avec UUID $VM Redémarre. La commande utilise la valeur de heure-de-début pour décider du moment du redémarrage de la machine virtuelle.

Le nom de la classe peut être l’un des Classes d’événements répertorié au début de cette section. Les paramètres peuvent être n’importe quel paramètre répertorié dans la commande CLI classe-param-list.

Commandes GPU

Commandes permettant d’utiliser des GPU physiques, des groupes de GPU et des GPU virtuels.

Les objets GPU peuvent être répertoriés à l’aide des commandes standard de liste d’objets : xe pgpu-list, xe gpu-group-listet xe vgpu-list. Les paramètres peuvent être manipulés à l’aide des commandes de paramètres standard. Pour plus d’informations, consultez Commandes de paramètres de bas niveau.

Paramètres physiques du GPU

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 PGPU à dom0.

pgpu-enable-dom0-access

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

Activez l’accès PGPU à dom0.

Paramètres de groupe GPU

Les groupes de GPU ont les paramètres suivants :

Opérations de groupe GPU

Commandes pour l’utilisation des groupes de GPU

gpu-group-create

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

Crée un nouveau groupe de 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é qui peuvent être instanciés dans ce groupe de GPU.

gpu-group-param-set

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

Modifie l’algorithme utilisé par le groupe de GPU pour allouer des GPU virtuels aux pGPU.

Paramètres du GPU virtuel

Les GPU virtuels ont les paramètres suivants :

Paramètres de type GPU virtuel

Remarque :

Le relais GPU et les GPU virtuels ne sont pas compatibles avec la migration en direct, la migration en direct du stockage ou la suspension de machine virtuelle, sauf si des logiciels et des cartes graphiques pris en charge par les fournisseurs de GPU sont présents. Les machines virtuelles sans cette prise en charge ne peuvent pas être migrées pour éviter les temps d’arrêt. Pour plus d’informations sur la compatibilité de NVIDIA vGPU avec la migration en direct, la migration en direct du stockage et la suspension de machine virtuelle, consultez la section Graphisme.

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étruisez 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-->

Utilisant faux désactive la console VNC pour une machine virtuelle lors de son passage désactivationvnc=1 jusqu’à l’émulateur d’affichage. Par défaut, VNC est activé.

Commandes de l’hôte

Commandes permettant d’interagir avec l’hôte XenServer.

Les hôtes XenServer sont les serveurs physiques qui exécutent le logiciel XenServer. Des machines virtuelles s’exécutent sur celles-ci 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 à l’aide des commandes standard de listing d’objets : liste d’hôtes xe, xe host-cpu-listet xe host-crashdump-list). Les paramètres peuvent être manipulés à l’aide des commandes de paramètres standard. Pour plus d’informations, consultez Commandes de paramètres de bas niveau.

Sélecteurs d’hôtes

Plusieurs des commandes listées ici ont 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 hôte=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, spécifier enabled=true sélectionne tous les hôtes XenServer dont Activé champ est égal à vrai. 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 n’est fourni pour sélectionner les hôtes XenServer, 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 :

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

Les processeurs sur les 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-->

Obtenez une liste de toutes les éditions disponibles

host-apply-edition

  xe host-apply-edition [host-uuid=host_uuid] [edition=xenserver_edition="free" "per-socket" "xendesktop"]
<!--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 ensuite extraite du serveur de licences.

Pour la configuration initiale de la licence, voir aussi adresse-serveur-licence et port-serveur-licence.

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 appelée. Enregistrez-le là en tant que fichier avec le nom nom_fichier.

Important :

Bien que le 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 spécifié), ne l’utilisez pas de cette façon. Cela remplirait la partition du domaine de contrôle avec le fichier de sauvegarde. N’utilisez la commande qu’à partir d’une machine distante hors hôte où vous disposez d’un 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 (en utilisant xen-bugtool, avec tous les fichiers facultatifs inclus) et téléchargez-le sur le site FTP de 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ôte ci-dessus). Les arguments facultatifs peuvent être n’importe quel nombre de l’ Paramètres de l’hôte répertorié au début de cette section.

Les paramètres facultatifs sont http-proxy: utilisez 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 dans le 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-->

Répertorie les informations sur les processeurs physiques de l’hôte.

host-crashdump-destroy

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

Supprimez un crash dump d’hôte spécifié par son UUID à partir de l’hôte XenServer.

host-crashdump-upload

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

Téléchargez un crash dump sur le site FTP de support ou à un autre emplacement. Si les paramètres facultatifs ne sont pas utilisés, aucun serveur proxy n’est identifié et la destination est le site FTP de support par défaut. Les paramètres facultatifs sont http-proxy: utilisez le proxy HTTP spécifié, et URL: télécharger vers cette URL de destination.

host-declare-dead

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

Déclarez que l’hôte est mort sans le contacter explicitement.

Avertissement :

Cet appel est dangereux et peut entraîner une perte de données si l’hôte n’est pas réellement mort.

host-disable

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

Désactive les hôtes XenServer spécifiés, ce qui empêche le démarrage de nouvelles machines virtuelles sur ceux-ci. Cette action prépare les hôtes XenServer à être arrêtés ou redémarrés. Une fois que l’hôte a redémarré, si toutes les conditions d’activation sont remplies (par exemple, si 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ôte). Les arguments facultatifs peuvent être n’importe quel nombre de l’ Paramètres de l’hôte répertorié 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ésactivez 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 Xen dmesg (la sortie de la mémoire tampon en anneau 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ôte ci-dessus). Les arguments facultatifs peuvent être n’importe quel nombre de l’ Paramètres de l’hôte répertorié au début de cette section.

host-emergency-ha-disable

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

Désactivez 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-->

Reconfigurez l’interface de gestion de cet hôte XenServer. N’utilisez cette commande que 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 un certain nombre de tentatives.

host-emergency-reset-server-certificate

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

Installe un certificat auto-signé sur l’hôte XenServer sur lequel 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ôte ci-dessus). Les arguments facultatifs peuvent être n’importe quel nombre de l’ Paramètres de l’hôte répertorié au début de cette section.

host-enable-display

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

Activez l’affichage pour l’hôte.

host-enable-local-storage-caching

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

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

host-evacuate

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

Live migre toutes les machines virtuelles en cours d’exécution vers d’autres hôtes appropriés sur un pool. Tout d’abord, désactivez l’hôte à l’aide de l’icône désactivation de l’hôte commander.

Si l’hôte évacué est le coordinateur de la piscine, un autre hôte doit être sélectionné pour être le coordinateur de la piscine. Pour changer le coordinateur de pool avec HA désactivé, utilisez le piscine-désignée-nouveau-maître commander. Pour plus d’informations, consultez piscine-désignée-nouveau-maître.

Lorsque HA est activé, votre seule option est d’arrêter l’hôte XenServer, ce qui oblige HA à élire un nouveau coordinateur de pool au hasard. Pour plus d’informations, consultez arrêt 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ôte ci-dessus). Les arguments facultatifs peuvent être n’importe quel nombre de l’ Paramètres de l’hôte répertorié 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 --force pour éviter d’être invité à confirmer que vous souhaitez réellement effectuer cette opération.

Avertissement :

N’utilisez pas cette commande si HA est activé sur le pool. Désactivez d’abord HA, puis réactivez-la une fois que vous avez oublié l’hôte.

Cette commande est utile si l’hôte XenServer à « oublier » est mort. Cependant, si l’hôte XenServer est en ligne et fait partie du pool, utilisez xe pool-eject au lieu de.

host-get-server-certificate

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

Obtenez le certificat TLS du serveur installé.

host-get-sm-diagnostics

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

Affichez 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 Entrées est une liste d’entrées d’état du système séparées par des virgules, extraite du fragment XML des capacités renvoyé par le host-get-system-status-capabilities commander. 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 sortie Peut être tar.bz2 (par défaut) ou fermeture éclair. Si ce paramètre n’est pas spécifié, le fichier est enregistré dans tar.bz2 forme.

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).

host-get-system-status-capabilities

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

Obtenir les fonctionnalités d’état du système pour les hôtes spécifiés. Les fonctionnalité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.

• clé Identificateur unique de la capacité.
• type_contenu Il peut s’agir de texte/brut ou d’application/données. Indique si une interface utilisateur peut afficher les entrées pour la consommation humaine.
• vérifié par défaut Peut être oui ou non. Indique si une interface utilisateur sélectionne cette entrée par défaut.
• taille minimale, taille maximale Indique une plage approximative pour la taille, en octets, de cette entrée. -1 indique que la taille n’a pas d’importance.
• min-temps, temps-max. Indiquez une plage approximative du temps, en secondes, nécessaire pour collecter cette entrée. -1 indique que le temps n’a pas d’importance.

• 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 sur la topologie de son réseau. L’attribut peut avoir l’une des valeurs suivantes :

  • Non: aucune PII ne figure dans ces entrées
  • oui: PII est probablement ou certainement dans ces entrées
  • peut-être: vous voudrez peut-être auditer ces entrées pour les PII
  • if_customized si les fichiers ne sont pas modifiés, ils ne contiennent pas d’informations personnelles. Cependant, étant donné que nous encourageons la modification de ces fichiers, il se peut que des informations personnelles aient été introduites par une telle personnalisation. Cette valeur est utilisée en particulier pour les scripts de mise en réseau dans le domaine de contrôle.

  Les mots de passe ne doivent jamais être inclus dans un rapport de bogue, quelle que soit la déclaration d’informations personnelles.

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).

host-get-thread-diagnostics

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

Affichez les informations de diagnostic par thread d’hôte.

host-get-vms-which-prevent-evacuation

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

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

host-is-in-emergency-mode

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

Retourne vrai si l’hôte avec lequel l’interface de ligne de commande communique est en mode d’urgence, faux autrement. 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échargez une copie des journaux des hôtes XenServer spécifiés. La copie est enregistrée par défaut dans un fichier horodaté nommé nom-hôte-aaaa-mm-jj T hh:mm:ssZ.tar.gz. Vous pouvez spécifier un autre nom de fichier à l’aide du paramètre facultatif nom_fichier.

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 de l’ Paramètres de l’hôte répertorié au début de cette section.

Important :

Bien que le 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 spécifié), non Utilisez-le de cette façon. 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’un espace pour stocker la copie des journaux.

host-management-disable

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

Désactive l’écoute de l’agent hôte sur une interface réseau de gestion externe et déconnecte tous les clients API connectés (tels que XenCenter). Cette commande s’exécute directement sur l’hôte XenServer auquel l’interface de ligne de commande 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 pouvez pas 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 qu’il utilise l’interface réseau spécifiée comme interface de gestion, c’est-à-dire l’interface utilisée pour se connecter à XenCenter. La commande réécrit la clé de MANAGEMENT_INTERFACE /etc/xensource-inventaire.

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

Si l’UUID d’un objet PIF est spécifié, l’hôte XenServer détermine l’adresse IP à laquelle il doit se relier. Il ne doit pas être en mode d’urgence lors de l’exécution de cette commande.

Avertissement :

Soyez prudent lorsque vous utilisez cette commande CLI hors hôte et assurez-vous que vous disposez d’une connectivité réseau sur la nouvelle interface. Utiliser xe pif-reconfigure pour en configurer un en premier. Sinon, les commandes CLI suivantes ne peuvent pas atteindre l’hôte XenServer.

host-power-on

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

Allume les hôtes XenServer à l’aide de l’option Mise sous tension de l’hôte fonction activée. Avant d’utiliser cette commande, activez mise sous tension du jeu d’hôtes 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 commande, sinon une commande HOST_IN_USE Le message d’erreur 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 de l’ Paramètres de l’hôte répertorié au début de cette section.

Si les hôtes XenServer spécifiés sont membres d’un pool, la perte de connectivité à 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 la piscine 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 la piscine

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

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

host-restore

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

Restaurer une sauvegarde nommée nom_fichier 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écompressé sur la partition secondaire. Après avoir effectué une 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 de l’ Paramètres de l’hôte répertorié au début de cette section.

host-send-debug-keys

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

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

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

Modifiez le nom d’hôte de l’hôte XenServer spécifié par hôte-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 nom-hôte est non la même que la valeur de la name_label champ.

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

Utilisez pour activer le Mise sous tension de l’hôte sur les hôtes XenServer compatibles avec les solutions d’alimentation à distance. Lors de l’utilisation de la mise sous tension du jeu d’hôtes , 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). Spécifiez ensuite 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 pour 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êtez 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 commande, sinon une commande HOST_IN_USE Le message d’erreur 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 de l’ Paramètres de l’hôte répertorié au début de cette section.

Si les hôtes XenServer spécifiés sont membres d’un pool, la perte de connectivité à l’arrêt est gérée et le pool récupère lorsque les hôtes XenServer reviennent. Les autres membres et le coordinateur de la piscine 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 la piscine

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

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

Si HA est activé pour le pool, l’un des membres est automatiquement transformé en coordinateur de pool. Si HA est désactivé, vous devez désigner manuellement l’hôte XenServer souhaité comme coordinateur de pool avec l’option piscine-désignée-nouveau-maître commander. Pour plus d’informations, consultez piscine-désignée-nouveau-maître.

host-sm-dp-destroy

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

Tenter de détruire et de nettoyer un chemin d’accès aux données de stockage sur un hôte. Si allow-leak=vrai 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-->

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

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

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 de l’ Paramètres de l’hôte répertorié au début de cette section.

host-data-source-list

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

Répertoriez 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 à l’aide du mécanisme de sélection standard (voir sélecteurs d’hôte). Les arguments facultatifs peuvent être n’importe quel nombre de l’ Paramètres de l’hôte répertorié au début de cette section. Si aucun paramètre n’est donné pour sélectionner les hôtes, l’opération est effectuée sur tous les hôtes.

Les sources de données ont deux paramètres : standard et Activé. Cette commande génère les valeurs des paramètres :

• Si une source de données a Activé se mettre à vrai, les indicateurs sont actuellement enregistrés dans la base de données des performances.
• Si une source de données a standard se mettre à vrai, les mesures sont enregistrées dans la base de données de performances par défaut. La valeur de Activé est également défini sur vrai pour cette source de données.
• Si une source de données a standard se mettre à faux, les indicateurs sont non enregistré dans la base de données de performances par défaut. La valeur de Activé est également défini sur faux pour cette source de données.

Pour commencer à enregistrer des mesures de source de données dans la base de données de performances, exécutez la commande enregistrement-source-de-données-hôte commander. Cette commande définit Activé À vrai. Pour arrêter, exécutez le hôte-source-de-données-forget. Cette commande définit Activé À faux.

host-data-source-record

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

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

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

Sélectionnez les hôtes sur lesquels effectuer cette opération à l’aide du mécanisme de sélection standard (voir sélecteurs d’hôte). Les arguments facultatifs peuvent être n’importe quel nombre de l’ Paramètres de l’hôte répertorié au début de cette section. Si aucun paramètre n’est donné pour sélectionner les hôtes, 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êtez d’enregistrer la source de données spécifiée pour un hôte et oubliez toutes les données enregistrées.

Sélectionnez les hôtes sur lesquels effectuer cette opération à l’aide du mécanisme de sélection standard (voir sélecteurs d’hôte). Les arguments facultatifs peuvent être n’importe quel nombre de l’ Paramètres de l’hôte répertorié au début de cette section. Si aucun paramètre n’est donné pour sélectionner les hôtes, 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-->

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

Sélectionnez les hôtes sur lesquels effectuer cette opération à l’aide du mécanisme de sélection standard (voir sélecteurs d’hôte). Les arguments facultatifs peuvent être n’importe quel nombre de l’ Paramètres de l’hôte répertorié au début de cette section. Si aucun paramètre n’est donné pour sélectionner les hôtes, l’opération est effectuée sur tous les hôtes.

Commandes de message

Commandes permettant d’utiliser des messages. Les messages sont créés pour informer les utilisateurs des événements importants et s’affichent dans XenCenter sous forme d’alertes.

Les objets de message peuvent être listés à l’aide de la commande standard de listing d’objets (xe liste-de-messages) et les paramètres manipulés à l’aide des commandes de paramètres standard. Pour plus d’informations, consultez Commandes de paramètres de bas niveau

Paramètres du message

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 l’utilisation des réseaux.

Les objets réseau peuvent être répertoriés à l’aide de la commande standard de liste d’objets (xe network-list) et les paramètres manipulés à l’aide des 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.

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

Paramètres SR-IOV

SR-IOV a les paramètres suivants :

network-sriov-create

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

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

network-sriov-destroy

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

Supprime un objet SR-IOV réseau et désactive SR-IOV sur son 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 machine virtuelle.

Commandes du contrôleur SDN

Commandes d’utilisation du 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-->

Retirez un contrôleur SDN.

Commandes de tunnel

Commandes pour l’utilisation des tunnels.

tunnel-create

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

Créez un tunnel sur un hôte.

tunnel-destroy

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

Détruisez un tunnel.

Commandes de patch

Commandes pour l’utilisation des patchs.

patch-apply

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

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

patch-clean

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

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

patch-destroy

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

Supprimez un enregistrement de correctif et des fichiers non appliqués de l’hôte.

patch-pool-apply

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

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

patch-pool-clean

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

Supprimez 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écutez 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échargez un fichier de correctif sur l’hôte.

Commandes PBD

Commandes pour l’utilisation des 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 répertoriés à l’aide de la commande standard de liste d’objets (xe pbd-list) et les paramètres manipulés à l’aide des 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 mode lecture seule configuration-appareil ne peut être défini qu’à la création.

Pour ajouter un mappage de ‘path’ à ‘/tmp’, assurez-vous que la ligne de commande contient l’argument configuration-périphérique :chemin=/tmp

Pour obtenir la liste complète des paires clé/valeur device-config prises en charge sur chaque type de SR, consultez Stockage.

pbd-destroy

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

Détruisez le PBD spécifié.

pbd-plug

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

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

pbd-unplug

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

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

Commandes PIF

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

Les objets PIF peuvent être répertoriés à l’aide de la commande standard de liste d’objets (xe pif-list) et les paramètres manipulés à l’aide des commandes de paramètres standard. Pour plus d’informations, consultez Commandes de paramètres de bas niveau

Paramètres PIF

Les PIFs ont les paramètres suivants :

Remarque :

Modifications apportées à la autre-config d’un PIF ne prendront effet qu’après un redémarrage. Vous pouvez également utiliser le xe pif-unplug et XE PIF-PLUG pour provoquer la réécriture de la configuration PIF.

pif-forget

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

Détruisez 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éez 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-->

Essayez d’afficher 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-->

Modifiez l’adresse IP du PIF. Pour une configuration IP statique, définissez l’icône mode pour statique, avec l’attribut passerelle, IPet masque de réseau paramètres définis sur les valeurs appropriées. Pour utiliser DHCP, définissez le mode pour 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 d’un commutateur à l’aide du protocole Spanning Tree avec STP Fast Link désactivé (ou non pris en charge) entraîne une période pendant laquelle il n’y a pas de trafic.

pif-reconfigure-ipv6

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

Reconfigurez les paramètres d’adresse IPv6 sur un PIF.

pif-scan

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

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

Modifiez le type d’adresse principale utilisé par ce code d’adresse personnelle.

pif-unplug

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

Essayez d’arrêter l’interface physique spécifiée.

Commandes de pool

Commandes permettant d’utiliser des pools. Un mare 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 alors que la machine virtuelle est toujours en cours d’exécution, sans qu’il soit nécessaire de l’arrêter et de la remettre en marche.

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 dernier devient le coordinateur du pool. Si le pool auquel l’hôte est joint comporte déjà plusieurs membres, l’un d’entre eux est déjà le coordinateur du pool et le reste lorsque le nouvel hôte rejoint le pool.

L’objet de pool singleton peut être répertorié à l’aide de la commande standard de listing d’objets (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 la piscine

Les pools ont les paramètres suivants :

pool-apply-edition

  xe pool-apply-edition edition=edition [uuid=uuid] [license-server-address=address] [license-server-port=port]
<!--NeedCopy-->

Appliquez une édition à l’ensemble de la piscine.

pool-certificate-install

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

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

pool-certificate-list

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

Répertorier tous les certificats TLS installés dans un pool.

pool-certificate-sync

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

Synchronisez les certificats TLS et les listes de révocation de certificats du coordinateur de pool avec les autres membres du pool.

pool-certificate-uninstall

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

Désinstallez un certificat TLS.

pool-crl-install

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

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

pool-crl-list

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

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

pool-crl-uninstall

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

Désinstallez une liste de révocation de certificat TLS.

pool-deconfigure-wlb

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

Supprimez définitivement la configuration de l’équilibrage de la charge de travail.

pool-designate-new-master

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

Demandez à 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 à un autre hôte du pool de ressources. Cette commande ne fonctionne que lorsque le coordinateur de pool actuel est en ligne. Il ne remplace pas les commandes du mode d’urgence répertoriées ci-dessous.

pool-disable-external-auth

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

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

pool-disable-local-storage-caching

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

Désactivez la mise en cache du stockage local dans le pool.

pool-disable-redo-log

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

Désactivez le journal de rétablissement s’il est utilisé, sauf si HA est activé.

pool-dump-database

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

Téléchargez une copie de l’intégralité de la base de données du pool et videz-la 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 dans tous les hôtes d’un pool. Notez que certaines valeurs de type-d’authentification nécessitera des Configuration : Valeurs.

pool-enable-local-storage-caching

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

Activez la mise en cache du stockage local dans le pool.

pool-enable-redo-log

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

Activez le journal de rétablissement sur le SR donné s’il est utilisé, sauf si HA est activé.

pool-eject

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

Demandez à 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-->

Demandez à un hôte membre du pool de réinitialiser l’adresse de son coordinateur de pool à la nouvelle valeur et d’essayer 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-->

Demandez à un hôte XenServer membre de devenir le coordinateur du pool (anciennement appelé « le maître du 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 s’agit d’un 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, voir (Commandes utilisateur).

pool-ha-enable

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

Activez la haute disponibilité sur le pool de ressources, à l’aide de l’UUID SR spécifié comme référentiel de pulsation de stockage central.

pool-ha-disable

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

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

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

Calculez le nombre maximal de défaillances 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-->

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

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

Initialisez l’équilibrage de la charge de travail pour le pool actuel avec le serveur d’équilibrage de la charge de travail 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é de MANAGEMENT_INTERFACE /etc/xensource-inventaire 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 de pool XenServer effectue immédiatement une nouvelle liaison. Cette commande fonctionne à la fois en mode normal et en mode d’urgence.

À partir de l’UUID réseau spécifié, l’UUID de l’objet PIF est identifié et mappé à l’hôte XenServer, qui détermine l’adresse IP à laquelle se rattacher. Il ne doit pas être en mode d’urgence lors de l’exécution de cette commande.

Avertissement :

Soyez prudent lorsque vous utilisez cette commande CLI hors hôte et assurez-vous que vous disposez d’une connectivité réseau sur la nouvelle interface. Utiliser xe pif-reconfigure pour en configurer un en premier. Sinon, les commandes CLI suivantes ne peuvent 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 piscine-urgence-transition-vers-maître a été utilisé pour désigner 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) à une piscine. À la réception du téléchargement, le coordinateur de pool redémarre avec la nouvelle base de données.

Il y a aussi un Essai , qui permet de vérifier que la base de données du pool peut être restaurée sans effectuer réellement l’opération. Par défaut Essai à sec 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 à partir du serveur d’équilibrage de la charge de travail.

pool-retrieve-wlb-diagnostics

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

Récupère les diagnostics du serveur d’équilibrage de la charge de travail.

pool-retrieve-wlb-recommendations

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

Récupère les recommandations de migration de machine virtuelle pour le pool à partir du serveur d’équilibrage de la charge de travail.

pool-retrieve-wlb-report

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

Récupère les rapports du serveur d’équilibrage de la charge de travail.

pool-secret-rotate

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

Faites pivoter le secret de pool.

Le secret de pool est un secret partagé entre les hôtes XenServer dans un pool qui permet à l’hôte de prouver son appartenance à un pool. Les utilisateurs disposant du rôle Administrateur de pool peuvent afficher ce secret lorsqu’ils se connectent à l’hôte via SSH. Effectuez une rotation du secret de 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-->

Envoyez le corps donné à l’hôte et au port donnés, en utilisant HTTPS, et imprimez la réponse. Ceci est utilisé pour déboguer 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 d’équilibrage de la charge de travail.

pool-sync-database

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

Forcez 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 puisque la base de données est régulièrement répliquée automatiquement. Toutefois, la commande peut être utile pour s’assurer que les modifications sont rapidement répliquées après l’exécution d’un ensemble important d’opérations CLI.

Poser https uniquement

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

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

pvs-cache-storage-destroy

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

Supprimez un cache PVS.

pvs-proxy-create

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

Configurez une machine virtuelle/VIF pour utiliser un proxy PVS.

pvs-proxy-destroy

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

Supprimez (ou désactivez) un proxy PVS pour cette VIF/VM.

pvs-server-forget

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

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

Oubliez 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 de contrôle des plug-ins du Gestionnaire de stockage.

Les objets du gestionnaire de stockage peuvent être répertoriés à l’aide de la commande standard de liste d’objets (xe sm-list). Les paramètres peuvent être manipulés à l’aide des 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 :

Commandes d’instantané

Commandes permettant d’utiliser des instantanés.

snapshot-clone

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

Créez un modèle en clonant un instantané existant, à l’aide de l’opération de clonage de disque rapide au niveau du stockage, le cas échéant.

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 modèle en copiant une machine virtuelle existante, mais sans utiliser l’opération de clonage rapide de disque au niveau du stockage (même si cela est disponible). Les images disque de la machine virtuelle copiée sont garanties être des « images complètes », c’est-à-dire ne fait pas partie d’une chaîne CoW.

snapshot-destroy

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

Détruire un instantané. Cela laisse le stockage associé à l’instantané intact. Pour supprimer également du 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-->

Répertoriez les disques sur les machines virtuelles 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-->

Exporter un instantané vers Nom du fichier.

snapshot-reset-powerstate

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

Forcer l’état d’alimentation de la machine virtuelle à arrêter dans la base de données de la pile d’outils de gestion uniquement. Cette commande permet de récupérer un instantané marqué comme « suspendu ». Il s’agit d’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établissez l’état précédent d’un point de contrôle ou d’un instantané d’une machine virtuelle existante.

snapshot-uninstall

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

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

Commandes SR

Commandes de contrôle des SR (référentiels de stockage).

Les objets SR peuvent être listés à l’aide de la commande standard de listing d’objets (Liste XE SR) et les paramètres manipulés à l’aide des 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 partagé est défini sur vrai, un PBD est créé pour chaque hôte XenServer du pool. Si partagé n’est pas spécifié ou défini sur faux, un PBD est créé uniquement pour l’hôte XenServer spécifié avec hôte-uuid.

L’exact configuration-appareil Les paramètres diffèrent selon l’appareil type. Pour plus d’informations sur ces paramètres sur les différents back-ends de stockage, reportez-vous à la section Créer un SR.

sr-data-source-forget

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

Arrêtez d’enregistrer la source de données spécifiée pour une SR et oubliez toutes les données enregistrées.

sr-data-source-list

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

Énumérez les sources de données qui peuvent être enregistrées pour une SR.

sr-data-source-query

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

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

Enregistrez la source de données spécifiée pour une 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 la SR spécifiée.

sr-forget

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

L’agent XAPI oublie une SR spécifiée sur l’hôte XenServer. Lorsque l’agent XAPI oublie une SR, celle-ci est détachée et vous ne pouvez pas accéder aux VDI sur celle-ci, mais elle reste intacte 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. Utiliser configuration-appareil Pour spécifier des paramètres supplémentaires dans le formulaire config_appareil :parameter_key=parameter_valuepar 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é en tant que partagé après sa création ou pour faciliter la récupération à partir de divers scénarios d’échec.

sr-probe

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

Effectue une analyse du backend, à l’aide de la configuration-appareil Clés. Si l’icône configuration-appareil est terminée pour le back-end SR, cette commande renvoie une liste des SR présents sur le périphérique, le cas échéant. Si l’icône configuration-appareil Les paramètres ne sont que partiels, une analyse spécifique au back-end est effectuée, renvoyant des résultats qui vous guident dans l’amélioration des paramètres restants. configuration-appareil Paramètres. Les résultats de l’analyse sont renvoyés au format XML spécifique au back-end, imprimé sur l’interface de ligne de commande.

L’exact configuration-appareil Les paramètres diffèrent selon l’appareil type. Pour plus d’informations sur ces paramètres sur les différents back-ends de stockage, reportez-vous à la section Stockage.

sr-probe-ext

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

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

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

sr-update

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

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

Activez le provisionnement dynamique sur un LVHD SR.

Commandes du sujet

Commandes pour travailler avec des sujets.

session-subject-identifier-list

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

Renvoie une liste de tous les ID d’objet 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éconnectez-vous de toutes les sessions authentifiées en externe associées à un ID de sujet d’utilisateur.

session-subject-identifier-logout-all

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

Déconnectez-vous de toutes les sessions authentifiées en externe.

subject-add

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

Ajoutez un sujet à la liste des sujets qui peuvent accéder au pool.

subject-remove

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

Supprimez un sujet de la liste des sujets qui peuvent 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éez un secret.

secret-destroy

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

Détruisez un secret.

Commandes de tâche

Commandes permettant d’utiliser 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 constituées d’un ensemble d’autres sous-tâches atomiques qui, ensemble, accomplissent l’opération demandée.

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

Paramètres de la tâche

Les tâches ont les paramètres suivants :

task-cancel

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

Indiquez à la tâche spécifiée d’annuler et de revenir.

Commandes de modèle

Commandes permettant d’utiliser des modèles de machine virtuelle.

Les modèles sont essentiellement des machines virtuelles avec l’attribut est-un-modèle défini sur vrai. Un modèle est une « image gold » qui contient tous les différents paramètres de configuration permettant d’instancier une machine virtuelle spécifique. XenServer est livré avec un ensemble de base de modèles, qui sont des VM génériques « brutes » qui peuvent démarrer le CD d’installation d’un 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 ultérieure dans le déploiement de machines virtuelles.

Les objets modèle peuvent être répertoriés à l’aide de la commande standard de liste d’objets (xe template-list) et les paramètres manipulés à l’aide des 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 convertis directement en machines virtuelles en définissant l’option est-un-modèle pour faux. Réglage est-un-modèle pour faux n’est pas pris 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’identificateur unique/la référence d’objet du modèle
• nom-étiquette (lecture/écriture) le nom du modèle
• nom-description (lecture/écriture) la chaîne de description du modèle
• Version utilisateur (lecture/écriture) pour les créateurs de machines virtuelles et de modèles pour mettre les informations de version

• est-un-modèle (lecture/écriture) true si cette machine virtuelle est un modèle. Les modèles de machines virtuelles ne peuvent jamais être démarrés, ils sont utilisés uniquement pour cloner d’autres machines virtuelles. Une fois que cette valeur a été définie sur true, elle ne peut pas être réinitialisée sur false. 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-->
  

• domaine-de-contrôle-is- (lecture seule) true s’il s’agit d’un domaine de contrôle (domaine 0 ou domaine de pilote)
• état-de-puissance (lecture seule) état actuel de l’alimentation. La valeur est toujours arrêtée pour un modèle
• mémoire-dynamique-max (lecture seule) Mémoire dynamique maximale en octets. Actuellement inutilisé, mais s’il est modifié, la contrainte suivante doit être respectée : memory_static_max >= memory_dynamic_max >= memory_dynamic_min >= memory_static_min.
• mémoire-dynamique-min (lecture/écriture) Mémoire minimale dynamique en octets. Actuellement inutilisé, mais s’il a été modifié, les mêmes contraintes pour mémoire-dynamique-max doit être obéi.
• mémoire-statique-max (lecture/écriture) définit statiquement (absolument) la mémoire maximale en octets. Ce champ est la valeur principale utilisée pour déterminer la quantité de mémoire affectée à une machine virtuelle.
• mémoire-statique-min (lecture/écriture) Définir statiquement (absolu) la mémoire minimale en octets. Ce champ représente la mémoire minimale absolue, et mémoire-statique-min doit être inférieur à mémoire-statique-max. Cette valeur n’est pas utilisée en fonctionnement normal, mais la contrainte précédente doit être respectée.
• suspend-VDI-uuid (lecture seule) la VDI sur laquelle une image suspendue est stockée (n’a aucune signification pour un modèle)

• VCPUs-params (paramètre de mappage de lecture/écriture) pour la stratégie vCPU sélectionnée.

  Vous pouvez régler l’épinglage d’un vCPU avec les éléments suivants :

     xe template-param-set uuid=<template_uuid> vCPUs-params:mask=1,2,3
   <!--NeedCopy-->
  

  Une machine virtuelle créée à partir de ce modèle s’exécute uniquement sur les processeurs physiques 1, 2 et 3.

  Vous pouvez également régler la priorité vCPU (planification xen) avec les paramètres de plafond et de poids. Par exemple :

     xe template-param-set uuid=<template_uuid> VCPUs-params:weight=512 xe template-param-set uuid=<template_uuid> VCPUs-params:cap=100
   <!--NeedCopy-->
  

  Une machine virtuelle basée sur ce modèle avec un poids de 512 obtient deux fois plus de processeur qu’un domaine avec un poids de 256 sur un hôte en conflit. Les poids légaux sont compris entre 1 et 65535 et la valeur par défaut est 256.

  Le plafond fixe éventuellement la quantité maximale de CPU qu’une machine virtuelle basée sur ce modèle peut consommer, même si l’hôte XenServer a des cycles de CPU inactifs. La limite est exprimée en pourcentage d’un processeur physique : 100 correspond à 1 processeur physique, 50 à la moitié d’un processeur, 400 à 4 processeurs, etc. La valeur par défaut, 0, signifie qu’il n’y a pas de plafond supérieur.

• VCPUs-max Nombre maximal de vCPU (lecture/écriture)
• VCPU-au-démarrage (lecture/écriture) du nombre de démarrage des vCPU
• actions-après-crash action (lecture/écriture) à effectuer lorsqu’une VM basée sur ce modèle se bloque
• console-uuids (paramètre de définition en lecture seule) Périphériques de console virtuelle

• plateforme (paramètre de carte de lecture/écriture) Configuration spécifique à la plate-forme

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

• opérations-autorisées (paramètre Set Set en lecture seule) liste des opérations autorisées dans cet état
• opérations-courantes (paramètre Set en lecture seule) liste des opérations actuellement en cours sur ce modèle
• appareils-VBD-autorisés (paramètre d’ensemble en lecture seule) liste des identificateurs VBD disponibles à l’utilisation, représentés par des entiers compris entre 0 et 15. Cette liste n’est fournie qu’à titre informatif et d’autres appareils peuvent être utilisés (mais peuvent ne pas fonctionner).
• périphériques-VIF autorisés (paramètre de réglage en lecture seule) liste des identificateurs VIF disponibles, représentés par des entiers compris entre 0 et 15. Cette liste n’est fournie qu’à titre informatif et d’autres appareils peuvent être utilisés (mais peuvent ne pas fonctionner).
• HVM-boot-policy (lecture/écriture) la politique de démarrage pour les invités. Ordre du BIOS ou chaîne vide.
• HVM-boot-params (paramètre de mappage de lecture/écriture) la touche order contrôle l’ordre de démarrage de l’invité, représenté par 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 PXE réseau. La valeur par défaut est dc.
• Noyau PV chemin (lecture/écriture) vers le noyau
• PV-ramdisk (lecture/écriture) vers le initrd
• PV-args (lecture/écriture) chaîne d’arguments de ligne de commande du noyau
• PV-legacy-args (lecture/écriture) pour créer des machines virtuelles héritées basées sur ce démarrage de modèle
• PV-bootloader (lecture/écriture) nom ou chemin d’accès au chargeur d’amorçage
• PV-bootloader-args (lecture/écriture) Chaîne d’arguments divers pour le chargeur d’amorçage
• last-boot-CPU-flags (lecture seule) décrit les indicateurs de processeur sur lesquels une machine virtuelle basée sur ce modèle a été démarrée pour la dernière fois ; non renseigné pour un modèle
• résident-on (lecture seule) l’hôte XenServer sur lequel réside une VM basée sur ce modèle. Apparaît comme Pas dans la base de données pour un modèle
• affinité (lecture/écriture) l’hôte XenServer sur lequel une VM basée sur ce modèle a la préférence pour s’exécuter. Utilisé par le xe vm-start pour décider où exécuter la machine virtuelle. Également connu sous le nom de serveur domestique.
• groupe (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.
• autre-config (paramètre de carte de lecture/écriture) liste des paires clé/valeur qui spécifient des paramètres de configuration supplémentaires pour le modèle
• heure-de-début horodatage (en lecture seule) de la date et de l’heure de lecture des métriques d’une machine virtuelle basée sur ce modèle, sous la forme aaaammjjThh :mm :ss z, où z est l’indicateur de fuseau horaire militaire à une seule lettre, par exemple, Z pour UTC(GMT). Se mettre à 1 janv. 1970 Z (début de l’époque Unix/POSIX) pour un modèle
• temps_d’installation horodatage (en lecture seule) de la date et de l’heure de lecture des métriques d’une machine virtuelle basée sur ce modèle, sous la forme aaaammjjThh :mm :ss z, où z est l’indicateur de fuseau horaire militaire à une seule lettre, par exemple, Z pour UTC (GMT). Se mettre à 1 janv. 1970 Z (début de l’époque Unix/POSIX) pour un modèle
• mémoire-réel (lecture seule) la mémoire réelle utilisée par une machine virtuelle basée sur ce modèle ; 0 pour un modèle
• Nombre de VCPU (lecture seule) le nombre de processeurs virtuels attribués à une machine virtuelle basée sur ce modèle ; 0 pour un modèle
• VCPU-Utilisation (paramètre de carte en lecture seule) liste des CPU virtuels et leur poids paramètre de carte en lecture seule Version du système d’exploitation la version du système d’exploitation d’une machine virtuelle basée sur ce modèle. Apparaît comme Pas dans la base de données pour un modèle
• Version des pilotes PV (paramètre de mappage en lecture seule) les versions des pilotes paravirtualisés pour une machine virtuelle basée sur ce modèle. Apparaît comme Pas dans la base de données pour un modèle
• Pilotes PV détectés (lecture seule) pour la dernière version des pilotes paravirtualisés pour une machine virtuelle basée sur ce modèle. Apparaît comme Pas dans la base de données pour un modèle
• mémoire (paramètre de carte en lecture seule) métriques de mémoire signalées par l’agent sur une machine virtuelle basée sur ce modèle. Apparaît comme Pas dans la base de données pour un modèle
• Disques (paramètre de carte en lecture seule) métriques de disque signalées par l’agent sur une machine virtuelle basée sur ce modèle. Apparaît comme Pas dans la base de données pour un modèle
• réseau (paramètre de carte en lecture seule) métriques réseau signalées par l’agent sur une machine virtuelle basée sur ce modèle. Apparaît comme Pas dans la base de données pour un modèle
• autre (paramètre de carte en lecture seule) autres métriques signalées par l’agent sur une machine virtuelle basée sur ce modèle. Apparaît comme Pas dans la base de données pour un modèle
• guest-metrics-last-updated (lecture seule) lorsque l’agent invité a effectué la dernière écriture dans ces champs. Dans le formulaire aaaammjjThh :mm :ss z, où z est l’indicateur de fuseau horaire militaire à une lettre, par exemple, Z pour UTC (GMT)
• actions-après-arrêt (lecture/écriture) à effectuer après l’arrêt de la machine virtuelle
• actions-après-redémarrage action (lecture/écriture) à effectuer après le redémarrage de la machine virtuelle
• hôtes-possibles liste (en lecture seule) des hôtes susceptibles d’héberger la machine virtuelle
• HVM-multiplicateur d’ombre (lecture/écriture) appliqué à la quantité d’ombre mise à la disposition de l’invité
• dom-id (lecture seule) ID de domaine (si disponible, -1 dans le cas contraire)
• Recommandations (en 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 de lecture/écriture) à insérer dans le xenstore arbre (/local/domaine/*domid*/vmdata) après la création de la machine virtuelle.
• est-un-instantané (en lecture seule) True si ce modèle est un instantané de machine virtuelle
• snapshot_of (lecture seule) l’UUID de la machine virtuelle 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 de l’instantané de machine virtuelle le plus récent pris
• cible_mémoire (lecture seule) la quantité cible de mémoire définie pour ce modèle
• opérations-bloquées (paramètre de carte de lecture/écriture) répertorie les opérations qui ne peuvent pas être effectuées sur ce modèle
• dernier-enregistrement-de-démarrage enregistrement (en lecture seule) des derniers paramètres de démarrage de ce modèle, au format XML
• ha-toujours-exécuter (lecture/écriture) True si une instance de ce modèle est toujours redémarrée sur un autre hôte en cas de défaillance de l’hôte sur lequel elle réside. Ce paramètre est désormais obsolète. Utilisez le ha-restartpriorité à la place.
• ha-restart-priority (lecture seule) redémarrage ou lecture/écriture des objets blob du magasin de données binaires
• vivre (lecture seule) pertinent uniquement pour une machine virtuelle 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é dans un fichier portant le nouveau nom de fichier spécifié.

template-uninstall

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

Désinstallez un modèle personnalisé. Cette opération détruira les VDI marquées comme « possédées » par ce modèle.

Mettre à jour les commandes

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

Les objets de mise à jour peuvent être répertoriés à l’aide de la commande standard de liste d’objets (xe update-list) et les paramètres manipulés à l’aide des commandes de paramètres standard. Pour plus d’informations, consultez 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échargez 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 imprimé. Si la mise à jour a déjà été téléchargée, UPDATE_ALREADY_EXISTS error 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écutez 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 du pool un fichier de mise à jour qui n’a pas été appliqué. 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-->

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

update-pool-apply

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

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

update-introduce

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

Introduire la mise à jour de la VDI.

update-pool-clean

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

Supprime les fichiers de 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-->

Change le mot de passe de l’utilisateur connecté. L’ancien champ de mot de passe n’est pas coché car vous avez besoin du privilège de superviseur pour utiliser cette commande.

Commandes VBD

Commandes pour l’utilisation des VBD (Virtual Block Devices).

Un VBD est un objet logiciel qui connecte une machine virtuelle au VDI, qui représente le contenu du disque virtuel. Le VBD possède les attributs qui lient le VDI à la machine virtuelle (est-il amorçable, ses métriques de lecture/écriture, etc.). Le VDI contient des informations sur les attributs physiques du disque virtuel (type de SR, si le disque peut être partagé, si le support est en lecture/écriture ou en lecture seule, etc.).

Les objets VBD peuvent être répertoriés à l’aide de la commande standard de liste d’objets (xe vbd-list) et les paramètres manipulés à l’aide des 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 appareil sont des entiers de 0 à 15 et le numéro doit être unique pour chaque machine virtuelle. Les valeurs autorisées actuelles peuvent être consultées dans le appareils-VBD-autorisés sur la machine virtuelle spécifiée. Ceci est considéré comme utilisateurappareil dans le vbd Paramètres.

Si l’icône type est Disque, vdi-uuid est obligatoire. Le mode peut être RO ou RW pour un disque.

Si l’icône 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étruisez le VBD spécifié.

Si le VBD a son other-config :propriétaire défini sur vrai, le VDI associé est également détruit.

vbd-eject

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

Retirez le support du lecteur représenté par un VBD. Cette commande ne fonctionne que si le support est de type amovible (un CD physique ou un 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 support dans le lecteur représenté par un VBD. Cette commande ne fonctionne que si le support est de type amovible (un CD physique ou un ISO). Sinon, un message d’erreur VBD_NOT_REMOVABLE_MEDIA est renvoyé.

vbd-plug

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

Essayez d’attacher le VBD pendant que la machine virtuelle est en cours d’exécution.

vbd-unplug

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

Tente de détacher le VBD de la machine virtuelle alors qu’il est en cours d’exécution.

Commandes VDI

Commandes permettant d’utiliser des VDI (Virtual Disk Images).

Un VDI est un objet logiciel qui représente le contenu du disque virtuel vu par une machine virtuelle. Ceci est différent du VBD, qui est un objet qui lie une machine virtuelle au VDI. Le VDI contient des informations sur les attributs physiques du disque virtuel (type de SR, si le disque peut être partagé, si le support est en lecture/écriture ou en lecture seule, etc.). Le VBD possède les attributs qui lient le VDI à la machine virtuelle (est-il amorçable, ses métriques de lecture/écriture, etc.).

Les objets VDI peuvent être répertoriés à l’aide de la commande standard de liste d’objets (xe vdi-list) et les paramètres manipulés à l’aide des 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éez une nouvelle copie accessible en écriture de la VDI spécifiée qui peut être utilisée directement. Il s’agit d’une variante de copie vdi c’est-à-dire qu’il peut exposer des installations de clonage d’images à grande vitesse là où elles existent.

Utilisez l’option params-pilote map 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.

vdi-copy

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

Copiez une VDI dans une SR spécifiée.

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éez une VDI.

Le taille-virtuelle Le paramètre peut être spécifié en octets ou à l’aide des suffixes standard CEI KiB, MiB, GiB et TiB.

Remarque :

Les types SR qui prennent en charge le provisionnement dynamique des disques (tels que VHD local et NFS) n’appliquent pas l’allocation virtuelle des disques. Soyez très prudent lorsque vous surallouez de l’espace disque virtuel sur un SR. Si une SR surallouée devient pleine, l’espace disque doit être disponible soit sur le substrat cible de la SR, soit en supprimant les VDI inutilisées dans la SR.

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

vdi-data-destroy

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

Détruisez les données associées au VDI spécifié, mais conservez les métadonnées de suivi de bloc modifiées.

Remarque :

Si vous utilisez le suivi des blocs modifiés pour effectuer des sauvegardes incrémentielles de la VDI, assurez-vous d’utiliser l’option vdi-de_données-destruction pour supprimer les instantanés mais conserver les métadonnées. Ne pas utiliser vdi-détruire sur les instantanés des VDI pour lesquels le suivi des blocs a été activé.

vdi-destroy

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

Détruisez le VDI spécifié.

Remarque :

Si vous utilisez le suivi des blocs modifiés pour effectuer des sauvegardes incrémentielles de la VDI, assurez-vous d’utiliser l’option vdi-de_données-destruction pour supprimer les instantanés mais conserver les métadonnées. Ne pas utiliser vdi-détruire sur les instantanés des VDI pour lesquels le suivi des blocs a été activé.

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

vdi-disable-cbt

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

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

vdi-enable-cbt

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

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

Exportez un VDI vers le nom de fichier spécifié. Vous pouvez exporter une VDI dans l’un des formats suivants :

• raw
• vhd

Le format VHD peut être clairsemé. S’il existe des blocs non alloués dans le VDI, ces blocs peuvent être omis du fichier VHD, ce qui réduit la taille du fichier VHD. Vous pouvez exporter au format VHD à partir de tous les types de stockage VHD pris en charge (EXT3/EXT4, NFS).

Si vous spécifiez l’icône base , cette commande exporte uniquement les blocs qui ont changé 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-détruire au lieu de.

vdi-import

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

Importez un VDI. Vous pouvez importer une 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 modifier ni créer de stockage. Cette commande est principalement utilisée en interne pour introduire automatiquement des périphériques de stockage enfichables à 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 retournez la liste des blocs qui ont changé entre les deux sous la forme d’une chaîne encodée en base64. Cette commande ne fonctionne que pour les VDI dont le suivi de bloc a été activé.

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

vdi-pool-migrate

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

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

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 de la VDI spécifiée par l’UUID.

vdi-snapshot

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

Produit une version en lecture-écriture d’une VDI qui peut être utilisée comme référence à des fins de sauvegarde ou de création de modèle, ou les deux. Utilisez le snapshot pour effectuer une sauvegarde plutôt que d’installer et d’exécuter un logiciel de sauvegarde à l’intérieur de la machine virtuelle. La machine virtuelle continue de s’exécuter pendant qu’un logiciel de sauvegarde externe diffuse le contenu de l’instantané sur le support de sauvegarde. De même, un instantané peut être utilisé comme une « image dorée » sur laquelle baser un modèle. Un modèle peut être créé à l’aide de n’importe quelle VDI.

Utilisez l’option params-pilote map 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 une VDI accessible en écriture.

vdi-unlock

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

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

vdi-update

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

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

Commandes VIF

Commandes pour l’utilisation des VIFs (interfaces réseau virtuelles).

Les objets VIF peuvent être répertoriés à l’aide de la commande standard de liste d’objets (xe VIF-list) et les paramètres manipulés à l’aide des 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’identificateur unique/la référence d’objet pour la VIF
• vm-uuid (lecture seule) l’identificateur/la référence d’objet unique de la machine virtuelle sur laquelle réside cette VIF
• nom-vm (lecture seule) le nom de la machine virtuelle sur laquelle réside cette VIF
• opérations-autorisées (paramètre set en lecture seule) une liste des opérations autorisées dans cet état
• opérations-courantes (paramètre set en lecture seule) une liste des opérations actuellement en cours sur cette VIF
• appareil (lecture seule) de cette VIF, indiquant l’ordre dans lequel les backends VIF ont été créés
• MAC (en lecture seule) Adresse MAC de la VIF, telle qu’exposée à la machine virtuelle

• MTU (en lecture seule) Unité de transmission maximale de la VIF en octets.

  Ce paramètre est en lecture seule, mais vous pouvez remplacer le paramètre MTU par la commande Mtu à l’aide de la touche autre-config map. Par exemple, pour réinitialiser la MTU sur une carte réseau virtuelle afin d’utiliser des trames étendues :

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

• Actuellement attaché (lecture seule) true si l’appareil est connecté
• qos_algorithm_type (lecture/écriture) Algorithme QoS à utiliser
• qos_algorithm_params (paramètre de carte de lecture/écriture) pour l’algorithme QoS choisi
• qos_supported_algorithms (paramètre de réglage en lecture seule) algorithmes QoS pris en charge pour cette VIF
• Généré automatiquement par MAC (en lecture seule) True si l’adresse MAC de la VIF a été générée automatiquement
• autre-config (paramètre de carte en lecture/écriture) Configuration supplémentaire clé :valeur Paires
• other-config :ethtoolrx (lecture/écriture) défini sur On pour activer la réception de la somme de contrôle, Off pour désactiver
• other-config :ethtooltx (lecture/écriture) Mis à On pour activer la somme de contrôle de transmission, Off pour désactiver
• other-config :ethtoolsg (lecture/écriture) réglé sur on pour activer la collecte de dispersion, off pour désactiver
• other-config :ethtooltso (lecture/écriture) défini sur on pour activer le déchargement de la segmentation TCP, off pour désactiver
• other-config :ethtoolufo (lecture/écriture) défini sur on pour activer le déchargement de fragments UDP, off pour désactiver
• other-config :ethtoolgso (lecture/écriture) défini sur ON pour activer le déchargement de la segmentation générique, OFF pour désactiver
• other-config :promiscuité (lecture/écriture) true à un VIF pour être de mœurs légères sur le pont, de sorte qu’il voit tout le trafic sur le pont. Utile pour l’exécution d’un système de détection d’intrusion (IDS) ou similaire dans une machine virtuelle.
• réseau-uuid (lecture seule) l’identificateur unique/la référence d’objet du réseau virtuel auquel cette VIF est connectée
• nom-réseau-étiquette (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 kB/s pour cette VIF
• io_write_kbs (lecture seule) taux d’écriture moyen en kB/s pour cette VIF
• locking_mode (lecture/écriture) Affecte la capacité des VIF à filtrer le trafic vers/depuis une liste d’adresses MAC et IP. Nécessite des paramètres supplémentaires.

• locking_mode :default (lecture/écriture) Varie en fonction du mode de verrouillage par défaut du réseau VIF.

  Si default-locking-mode est défini sur handicapé, XenServer applique une règle de filtrage afin que la VIF ne puisse pas envoyer ou recevoir de trafic. Si default-lockingmode est défini sur déverrouillé, XenServer supprime toutes les règles de filtrage associées à la VIF. Pour plus d’informations, consultez Commandes réseau.

• locking_mode :verrouillé (lecture/écriture) Seul le trafic envoyé vers ou à partir des 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 :déverrouillé (lecture/écriture) Aucun filtre n’est appliqué au trafic à destination ou en provenance de la VIF.
• locking_mode :disabled (lecture/écriture) XenServer applique une règle de filtrage afin que la VIF abandonne 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éez une VIF sur une machine virtuelle.

Valeurs appropriées pour le appareil champs sont répertoriés dans le paramètre périphériques-VIF autorisés sur la machine virtuelle spécifiée. Avant qu’il n’y ait des VIFs, les valeurs autorisées sont des entiers compris entre 0 et 15.

Le Mac est l’adresse MAC standard dans le formulaire aa :bb :cc :dd :ee :ff. Si vous ne la 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=aléatoire.

vif-destroy

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

Détruisez une carte VIF.

vif-move

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

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

vif-plug

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

Essayez d’attacher la VIF pendant que la machine virtuelle est en cours d’exécution.

vif-unplug

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

Tente de détacher la VIF de la machine virtuelle pendant son exécution.

vif-configure-ipv4

Configurez les paramètres IPv4 pour cette interface virtuelle. Définissez les paramètres IPv4 comme ci-dessous :

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

Nettoyez les paramètres IPv4 comme ci-dessous :

  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 ci-dessous :

  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 ci-dessous :

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

Commandes VLAN

Commandes pour l’utilisation de VLAN (réseaux virtuels). Pour répertorier et modifier des 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, consultez Commandes PIF. Par exemple, pour répertorier 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 quelle interface (par exemple, eth0) le réseau spécifié est allumé (sur chaque hôte) et crée et branche 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étruisez un VLAN. Nécessite l’UUID du PIF qui représente le VLAN.

Commandes de machine virtuelle

Commandes permettant de contrôler les machines virtuelles et leurs attributs.

Sélecteurs de VM

Plusieurs des commandes répertoriées ici ont un mécanisme commun pour sélectionner une ou plusieurs machines virtuelles sur lesquelles effectuer l’opération. Le moyen le plus simple est de fournir l’argument vm=name_or_uuid. Un moyen simple d’obtenir l’uuid d’une machine virtuelle réelle est, par exemple, d’exécuter xe vm-list power-state=en cours d’exécution. (Obtenez la liste complète des champs qui peuvent être mis en correspondance à l’aide de la commande xe vm-list params=all. ) Par exemple, en spécifiant power-state=arrêté sélectionne les machines virtuelles dont état-de-puissance est égal à Arrêté. Lorsque plusieurs machines virtuelles 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 répertoriés à l’aide de la commande standard de listing d’objets (xe vm-list) et les paramètres manipulés à l’aide des commandes de paramètres standard. Pour plus d’informations, consultez Commandes de paramètres de bas niveau

Paramètres de la machine virtuelle

Les machines virtuelles ont les paramètres suivants :

Remarque :

Toutes les valeurs de paramètre de machine virtuelle accessibles en écriture peuvent être modifiées pendant l’exécution de la machine virtuelle, mais les nouveaux paramètres sont non appliqué dynamiquement et ne peut pas être appliqué tant que la machine virtuelle n’est pas redémarrée.

• appareil (lecture/écriture) l’appliance/le vApp auquel appartient la machine virtuelle
• uuid (lecture seule) l’identificateur unique/la référence d’objet de la machine virtuelle
• nom-étiquette (lecture/écriture) le nom de la machine virtuelle
• nom-description (lecture/écriture) la chaîne de description de la machine virtuelle
• commande (lecture/écriture) pour le démarrage/l’arrêt du vApp et pour le démarrage après le basculement HA. Les machines virtuelles dont la valeur d’ordre est 0 (zéro) sont démarrées en premier, puis les machines virtuelles dont la valeur d’ordre est 1, et ainsi de suite.
• Version (lecture seule) le nombre de fois que cette machine virtuelle a été récupérée. Si vous souhaitez remplacer une nouvelle machine virtuelle par une version plus ancienne, appelez vm-recover
• Version utilisateur (lecture/écriture) pour les créateurs de machines virtuelles et de modèles pour mettre les informations de version

• est-un-modèle (lecture/écriture) False, sauf si cette machine virtuelle est un modèle. Les modèles de machines virtuelles ne peuvent jamais être démarrés, ils sont utilisés uniquement pour cloner d’autres machines virtuelles Une fois que cette valeur a été définie sur true, elle ne peut pas être réinitialisée sur false. 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-->
  

• domaine-de-contrôle-is- (en lecture seule) True s’il s’agit d’un domaine de contrôle (domaine 0 ou domaine de pilote)
• état-de-puissance (lecture seule) état actuel de l’alimentation
• Délai de démarrage (lecture/écriture) le délai d’attente avant un appel au démarrage de la VM revient en secondes
• arrêt-délai (lecture/écriture) le délai d’attente avant qu’un appel d’arrêt de la VM ne revienne en secondes
• mémoire-dynamique-max (lecture/écriture) dynamique maximale en octets
• mémoire-dynamique-min (lecture/écriture) minimum dynamique en octets
• mémoire-statique-max (lecture/écriture) défini statiquement (absolu) maximum en octets. Si vous souhaitez modifier cette valeur, la machine virtuelle doit être arrêtée.
• mémoire-statique-min (lecture/écriture) fixé statiquement (absolu) minimum en octets. Si vous souhaitez modifier cette valeur, la machine virtuelle doit être arrêtée.
• suspend-VDI-uuid (lecture seule) le VDI sur lequel une image de suspension est stockée

• VCPUs-params (paramètre de mappage de lecture/écriture) pour la stratégie vCPU sélectionnée.

  Vous pouvez régler l’épinglage d’un vCPU avec

     xe vm-param-set uuid=<vm_uuid> VCPUs-params:mask=1,2,3
   <!--NeedCopy-->
  

  La machine virtuelle sélectionnée s’exécute ensuite sur les processeurs physiques 1, 2 et 3 uniquement. Vous pouvez également régler la priorité vCPU (planification xen) avec les paramètres de plafond et de poids. Par exemple :

     xe vm-param-set uuid=<vm_uuid> VCPUs-params:weight=512 xe vm-param-set uuid=<vm_uuid> VCPUs-params:cap=100
   <!--NeedCopy-->
  

  Une machine virtuelle d’un poids de 512 obtient deux fois plus de processeur qu’un domaine d’un poids de 256 sur un hôte XenServer en conflit. Les poids légaux sont compris entre 1 et 65535 et la valeur par défaut est 256. Le plafond fixe éventuellement la quantité maximale de CPU qu’une machine virtuelle pourra consommer, même si l’hôte XenServer a des cycles de CPU inactifs. La limite est exprimée en pourcentage d’un processeur physique : 100 correspond à 1 processeur physique, 50 à la moitié d’un processeur, 400 à 4 processeurs, etc. La valeur par défaut, 0, signifie qu’il n’y a pas de plafond supérieur.

• VCPUs-max (lecture/écriture) Nombre maximal de processeurs virtuels.
• VCPU-au-démarrage (lecture/écriture) numéro de démarrage des processeurs virtuels
• actions-after-crash (read/write) action to take if the VM crashes. For PV guests, valid parameters are:
  • préserver (à titre d’analyse seulement)
  • coredump_and_restart (enregistrer un vidage de mémoire et redémarrer la machine virtuelle)
  • coredump_and_destroy (enregistrez un vidage de mémoire et laissez la machine virtuelle arrêtée)
  • redémarrer (pas de vidage de mémoire et de redémarrage de la machine virtuelle)
  • détruire (pas de vidage de mémoire et laisser la machine virtuelle arrêtée)
• console-uuids (paramètre de définition en lecture seule) Périphériques de console virtuelle

• plateforme (paramètre de carte en lecture/écriture) Configuration spécifique à la plate-forme

  Pour désactiver VDA afin de passer Windows 10 en mode Tablette :

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

  Pour permettre à VDA de passer 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-->
  

• opérations-autorisées (paramètre Set Set en lecture seule) liste des opérations autorisées dans cet état
• opérations-courantes (paramètre set en lecture seule) une liste des opérations actuellement en cours sur la machine virtuelle
• appareils-VBD-autorisés (paramètre d’ensemble en lecture seule) liste des identificateurs VBD disponibles à l’utilisation, représentés par des entiers compris entre 0 et 15. Cette liste n’est fournie qu’à titre informatif et d’autres appareils peuvent être utilisés (mais peuvent ne pas fonctionner).
• périphériques-VIF autorisés (paramètre de réglage en lecture seule) liste des identificateurs VIF disponibles, représentés par des entiers compris entre 0 et 15. Cette liste n’est fournie qu’à titre informatif et d’autres appareils peuvent être utilisés (mais peuvent ne pas fonctionner).
• HVM-boot-policy (lecture/écriture) la politique de démarrage pour les invités. Ordre du BIOS ou chaîne vide.
• HVM-boot-params (paramètre de mappage de lecture/écriture) la touche order contrôle l’ordre de démarrage de l’invité, représenté par 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 PXE réseau. La valeur par défaut est dc.
• HVM-multiplicateur d’ombre (lecture/écriture) Valeur à virgule flottante qui contrôle la quantité de surcharge de mémoire fantôme à accorder à la machine virtuelle. La valeur par défaut est 1.0 (valeur minimale) et ne modifie cette valeur que si vous êtes un utilisateur avancé.
• Noyau PV chemin (lecture/écriture) vers le noyau
• PV-ramdisk (lecture/écriture) vers le initrd
• PV-args (lecture/écriture) chaîne d’arguments de ligne de commande du noyau
• PV-legacy-args (lecture/écriture) pour faire démarrer les machines virtuelles héritées
• PV-bootloader (lecture/écriture) nom ou chemin d’accès au chargeur d’amorçage
• PV-bootloader-args (lecture/écriture) Chaîne d’arguments divers pour le chargeur d’amorçage
• last-boot-CPU-flags (lecture seule) décrit les indicateurs de processeur sur lesquels la machine virtuelle a été démarrée pour la dernière fois
• résident-on (lecture seule) l’hôte XenServer sur lequel une VM est résidente
• affinité (lecture/écriture) L’hôte XenServer sur lequel la machine virtuelle a la préférence pour l’exécution. Utilisé par le xe vm-start pour décider où exécuter la machine virtuelle. Également connu sous le nom de serveur domestique.
• groupe (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.

• autre-config (paramètre de mappage en lecture/écriture) Liste de paires clé/valeur qui spécifient des paramètres de configuration supplémentaires pour la machine virtuelle.

  Par exemple, le autre-config Paire clé/valeur auto_poweron : vrai demande de démarrer automatiquement la machine virtuelle après le démarrage d’un hôte du pool. Vous devez également définir ce paramètre dans le fichier autre-config. Ces paramètres sont désormais obsolètes. Utilisez le ha-restart-priority à la place.

• heure-de-début (lecture seule) de la date et de l’heure de lecture des métriques de la machine virtuelle. Cet horodatage est dans le formulaire aaaammjjThh :mm :ss z, où z est l’indicateur de fuseau horaire militaire à une lettre, par exemple, Z pour UTC (GMT)
• temps_d’installation (lecture seule) de la date et de l’heure de lecture des métriques de la machine virtuelle. Cet horodatage est dans le formulaire aaaammjjThh :mm :ss z, où z est l’indicateur de fuseau horaire militaire à une lettre, par exemple, Z pour UTC (GMT)
• mémoire-réel (lecture seule) la mémoire réelle utilisée par une machine virtuelle
• Nombre de VCPU (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 commander. Pour plus d’informations, consultez vm-vcpu-hotplug. Les machines virtuelles Windows s’exécutent toujours avec le nombre de vCPU défini sur VCPUsmax et doit être redémarré pour modifier cette valeur. Les performances chutent fortement lorsque vous réglez Nombre de VCPU à une valeur supérieure au nombre de processeurs physiques sur l’hôte XenServer.
• VCPU-Utilisation (paramètre de carte en lecture seule) une liste de processeurs virtuels et leur poids
• Version du système d’exploitation (paramètre de mappage en lecture seule) la version du système d’exploitation de la machine virtuelle
• Version des pilotes PV (paramètre de carte en lecture seule) les versions des pilotes paravirtualisés pour la VM
• Pilotes PV détectés (lecture seule) pour la dernière version des pilotes paravirtualisés pour la machine virtuelle
• mémoire (paramètre de mappage en lecture seule) métriques de mémoire signalées par l’agent sur la machine virtuelle
• Disques (paramètre de carte en lecture seule) signalées par l’agent sur la machine virtuelle
• réseau (paramètre de carte en lecture seule) signalées par l’agent sur la machine virtuelle
• autre (paramètre de carte en lecture seule) autres métriques signalées par l’agent sur la machine virtuelle
• guest-metrics-lastupdated (lecture seule) lorsque l’agent invité a effectué la dernière écriture dans ces champs. L’horodatage est dans le formulaire aaaammjjThh :mm :ss z, où z est l’indicateur de fuseau horaire militaire à une lettre, par exemple, Z pour UTC (GMT)
• actions-après-arrêt (lecture/écriture) à effectuer après l’arrêt de la machine virtuelle
• actions-après-redémarrage action (lecture/écriture) à effectuer après le redémarrage de la machine virtuelle
• hôtes-possibles hôtes potentiels de cette VM en lecture seule
• dom-id (lecture seule) ID de domaine (si disponible, -1 dans le cas contraire)
• Recommandations (en 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 de lecture/écriture) à insérer dans le xenstore arbre (/local/domaine/*domid*/donnees-vm) après la création de la machine virtuelle
• est-un-instantané (en lecture seule) True si cette machine virtuelle est un instantané
• snapshot_of (lecture seule) l’UUID de la machine virtuelle dont se trouve cet instantané
• Snapshots (lecture seule) les UUID de tous les snapshots de cette VM
• snapshot_time (lecture seule) l’horodatage de l’opération de snapshot qui a créé ce snapshot de machine virtuelle
• cible_mémoire (lecture seule) la quantité cible de mémoire définie pour cette machine virtuelle
• opérations-bloquées (paramètre de mappage en lecture/écriture) répertorie les opérations qui ne peuvent pas être effectuées sur cette machine virtuelle
• dernier-enregistrement-de-démarrage enregistrement (en lecture seule) des derniers paramètres de démarrage de ce modèle, au format XML
• ha-toujours-exécuter (lecture/écriture) True si cette machine virtuelle 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 désormais obsolète. Utilisez le ha-restart-priority à la place.
• ha-restart-priority (lecture/écriture) redémarrage ou meilleur effort
• Blobs Magasin de données binaires (en lecture seule)
• vivre (en lecture seule) True si la machine virtuelle est en cours d’exécution. False si HA soupçonne que la machine virtuelle n’est pas en cours d’exécution.

vm-assert-can-be-recovered

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

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

vm-call-plugin

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

Appelle la fonction dans le plug-in sur la machine virtuelle donnée avec des arguments facultatifs (args :key=value). Pour passer une chaîne "value\ » contenant des caractères spéciaux (par exemple une nouvelle 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 ensemble.

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 machine virtuelle sélectionnée. Sélectionnez l’icône appareil de la valeur de la valeur appareils-VBD-autorisés de la machine virtuelle.

La ou les machines virtuelles sur lesquelles cette opération est effectuée sont sélectionnées à l’aide du mécanisme de sélection standard. Pour plus d’informations, consultez Sélecteurs de VM. Les arguments facultatifs peuvent être n’importe quel nombre de l’ Paramètres de la machine virtuelle répertorié 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 machine virtuelle. Lorsqu’il y a deux CD ou plus, utilisez la commande xe vbd-eject et spécifiez l’UUID du VBD.

La ou les machines virtuelles sur lesquelles cette opération est effectuée sont sélectionnées à l’aide du mécanisme de sélection standard. Pour plus d’informations, consultez Sélecteurs de VM. Les arguments facultatifs peuvent être n’importe quel nombre de l’ Paramètres de la machine virtuelle répertorié 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 existe exactement un périphérique CD vide attaché à la machine virtuelle. Lorsqu’il y a deux périphériques CD vides ou plus, utilisez le xe vbd-insert et spécifiez les UUID du VBD et du VDI à insérer.

La ou les machines virtuelles sur lesquelles cette opération est effectuée sont sélectionnées à l’aide du mécanisme de sélection standard. Pour plus d’informations, consultez Sélecteurs de VM. Les arguments facultatifs peuvent être n’importe quel nombre de l’ Paramètres de la machine virtuelle répertorié au début de cette section.

vm-cd-list

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

Répertorie les CD attachés aux machines virtuelles spécifiées.

La ou les machines virtuelles sur lesquelles cette opération est effectuée sont sélectionnées à l’aide du mécanisme de sélection standard. Pour plus d’informations, consultez Sélecteurs de VM. Les arguments facultatifs peuvent être n’importe quel nombre de l’ Paramètres de la machine virtuelle répertorié au début de cette section.

Vous pouvez également sélectionner les paramètres VBD et VDI à répertorier.

vm-cd-remove

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

Supprimez un CD virtuel des machines virtuelles spécifiées.

La ou les machines virtuelles sur lesquelles cette opération est effectuée sont sélectionnées à l’aide du mécanisme de sélection standard. Pour plus d’informations, consultez Sélecteurs de VM. Les arguments facultatifs peuvent être n’importe quel nombre de l’ Paramètres de la machine virtuelle répertorié au début de cette section.

vm-checkpoint

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

Pointez de contrôle une machine virtuelle existante, à l’aide de l’opération de capture instantanée de disque rapide au niveau du stockage, le cas échéant.

vm-clone

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

Clonez une machine virtuelle existante à l’aide de l’opération de clonage rapide de disque au niveau du stockage, le cas échéant. Spécifiez le nom et la description facultative de la machine virtuelle clonée résultante à l’aide de la commande nouvelle-étiquette-de-nom et nouveau-nom-description Arguments.

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 de l’ Paramètres de la machine virtuelle répertorié 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-->

Calculez la quantité maximale de mémoire statique qui peut être allouée à une machine virtuelle existante, en utilisant la quantité totale de RAM physique comme limite supérieure. Le paramètre facultatif approximatif réserve suffisamment de mémoire supplémentaire dans le calcul pour tenir compte de l’ajout ultérieur de processeurs virtuels supplémentaires dans 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 de la commande Sans mémoire renvoyé par le paramètre liste d’hôtes xe pour définir la mémoire maximale de la VM 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 VM. Les arguments facultatifs peuvent être n’importe quel nombre de l’ Paramètres de la machine virtuelle répertorié 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-->

Copiez une machine virtuelle 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 machine virtuelle copiée sont garanties Images complètes, c’est-à-dire qu’elle ne fait pas partie d’une chaîne de copie sur écriture (CoW).

Spécifiez le nom et la description facultative de la machine virtuelle copiée résultante à l’aide de la commande nouvelle-étiquette-de-nom et nouveau-nom-description Arguments.

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

La ou les machines virtuelles sur lesquelles cette opération est effectuée sont sélectionnées à l’aide du mécanisme de sélection standard. Pour plus d’informations, consultez Sélecteurs de VM. Les arguments facultatifs peuvent être n’importe quel nombre de l’ Paramètres de la machine virtuelle répertorié au début de cette section.

vm-copy-bios-strings

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

Copiez les chaînes du BIOS de l’hôte donné sur la machine virtuelle.

Remarque :

Après avoir démarré une machine virtuelle pour la première fois, vous ne pouvez pas modifier ses chaînes de BIOS. Assurez-vous que les chaînes du BIOS sont correctes avant de démarrer la machine virtuelle pour la première fois.

vm-crashdump-list

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

Répertorie les vidages sur incident associés aux machines virtuelles spécifiées.

Lorsque vous utilisez l’argument facultatif Paramètres, 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é tout pour afficher tous les paramètres. Si Paramètres n’est pas utilisé, la liste renvoyée affiche un sous-ensemble par défaut de tous les paramètres disponibles.

La ou les machines virtuelles sur lesquelles cette opération est effectuée sont sélectionnées à l’aide du mécanisme de sélection standard. Pour plus d’informations, consultez Sélecteurs de VM. Les arguments facultatifs peuvent être n’importe quel nombre de l’ Paramètres de la machine virtuelle répertorié 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 machine virtuelle.

Sélectionnez les machines virtuelles sur lesquelles effectuer cette opération à l’aide du mécanisme de sélection standard. Pour plus d’informations, consultez Sélecteurs de VM. Les arguments facultatifs peuvent être n’importe quel nombre de l’ Paramètres de la machine virtuelle répertorié au début de cette section. Si aucun paramètre n’est attribué pour sélectionner les hôtes, l’opération est effectuée sur toutes les machines virtuelles.

Les sources de données ont deux paramètres : standard et Activé – que vous pouvez voir dans la sortie de cette commande. Si une source de données a Activé se mettre à vrai, les indicateurs sont actuellement enregistrés dans la base de données des performances. Si une source de données a standard se mettre à vrai, les mesures sont enregistrées par défaut dans la base de données de performances (et Activé est également défini sur vrai pour cette source de données). Si une source de données a standard se mettre à faux, les indicateurs sont non enregistré dans la base de données de performances par défaut (et Activé est également défini sur faux pour cette source de données).

Pour commencer à enregistrer des mesures de source de données dans la base de données de performances, exécutez la commande enregistrement-source-de-données-vm commander. Cette commande définit Activé À vrai. Pour arrêter, exécutez le vm-data-source-forget. Cette commande définit Activé À faux.

vm-data-source-record

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

Enregistrez la source de données spécifiée pour une machine virtuelle.

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

Sélectionnez les machines virtuelles 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 de l’ Paramètres de la machine virtuelle répertorié au début de cette section. Si aucun paramètre n’est attribué pour sélectionner les hôtes, l’opération est effectuée sur toutes les machines virtuelles.

vm-data-source-forget

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

Arrêtez d’enregistrer la source de données spécifiée pour une machine virtuelle et oubliez toutes les données enregistrées.

Sélectionnez les machines virtuelles sur lesquelles effectuer cette opération à l’aide du mécanisme de sélection standard. Pour plus d’informations, consultez Sélecteurs de VM. Les arguments facultatifs peuvent être n’importe quel nombre de l’ Paramètres de la machine virtuelle répertorié au début de cette section. Si aucun paramètre n’est attribué pour sélectionner les hôtes, l’opération est effectuée sur toutes les machines virtuelles.

vm-data-source-query

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

Affichez la source de données spécifiée pour une machine virtuelle.

Sélectionnez les machines virtuelles sur lesquelles effectuer cette opération à l’aide du mécanisme de sélection standard. Pour plus d’informations, consultez Sélecteurs de VM. Les arguments facultatifs peuvent être n’importe quel nombre de l’ Paramètres de la machine virtuelle répertorié au début de cette section. Si aucun paramètre n’est attribué pour sélectionner les hôtes, l’opération est effectuée sur toutes les machines virtuelles.

vm-destroy

  xe vm-destroy uuid=uuid_of_vm
<!--NeedCopy-->

Détruisez la machine virtuelle spécifiée. Cela laisse le stockage associé à la machine virtuelle intact. Pour supprimer également de l’espace de stockage, utilisez xe vm-désinstallation.

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 l’icône appareil de la valeur de la valeur appareils-VBD-autorisés des VM.

Le taille-disque Le paramètre peut être spécifié en octets ou à l’aide des suffixes standard CEI 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 VM. Les arguments facultatifs peuvent être n’importe quel nombre de l’ Paramètres de la machine virtuelle répertorié 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. Le vbd-params et vdi-params Les paramètres contrôlent les champs des objets respectifs à afficher. Donnez les paramètres sous forme de liste séparée par des virgules, ou la touche spéciale tout 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 VM. Les arguments facultatifs peuvent être n’importe quel nombre de l’ Paramètres de la machine virtuelle répertorié 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 VM. Les arguments facultatifs peuvent être n’importe quel nombre de l’ Paramètres de la machine virtuelle répertorié 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) dans un fichier sur l’ordinateur local. Spécifiez le nom de fichier dans lequel exporter la machine virtuelle à l’aide de la commande Fichier paramètre. Par convention, le nom du fichier a un .xva extension.

Si l’icône métadonnées paramètre est vrai, les disques ne sont pas exportés. Seules les métadonnées de la machine virtuelle sont écrites dans le fichier de sortie. Utilisez ce paramètre lorsque le stockage sous-jacent est transféré via d’autres mécanismes et permet de recréer les informations de la machine virtuelle. Pour plus d’informations, consultez vm-import.

La ou les machines virtuelles sur lesquelles cette opération est effectuée sont sélectionnées à l’aide du mécanisme de sélection standard. Pour plus d’informations, consultez Sélecteurs de VM. Les arguments facultatifs peuvent être n’importe quel nombre de l’ Paramètres de la machine virtuelle répertorié 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 préserver est défini sur vrai, 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 l’icône métadonnées est vrai, vous pouvez importer un ensemble de métadonnées précédemment exporté sans les blocs de disque associés. L’importation des métadonnées uniquement échoue si des VDI sont introuvables (nommés par SR et VDI.location), à moins que le --force option est spécifiée, auquel cas l’importation se poursuit malgré tout. 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 à l’aide de l’icône modèle-uuid ou modèle argument. Spécifiez une SR à l’aide de l’icône sr-uuid ou Étiquette-nom-sr argument. Spécifiez l’installation du support verrouillé par le BIOS à l’aide de la commande copier-chaînes-bios-de-partir argument.

Remarque :

Lors de l’installation à partir d’un modèle qui contient des disques existants, par défaut, les nouveaux disques sont créés dans le même SR que ces disques existants. Lorsque le SR le supporte, ces disques sont des copies rapides. Si un SR différent est spécifié sur la ligne de commande, les nouveaux disques y sont créés. Dans ce cas, une copie rapide n’est pas possible et les disques sont des copies complètes.

Lors de l’installation à partir d’un modèle qui n’a pas de disques existants, tous les nouveaux disques sont créés dans le SR spécifié, ou le SR par défaut du pool lorsqu’aucun SR n’est spécifié.

vm-is-bios-customized

  xe vm-is-bios-customized
<!--NeedCopy-->

Indique si les chaînes du 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 des 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’adapter à 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 permet de modifier la quantité de Mémoire d’ombre attribué à 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 nécessaire pour obtenir des performances optimales.

Ce souvenir est considéré comme un surcoût. Il est séparé des calculs de mémoire normaux pour la comptabilisation de la mémoire d’une machine virtuelle. Lorsque cette commande est invoquée, la quantité de mémoire hôte libre diminue en fonction du multiplicateur et de la valeur HVM_shadow_multiplier est mis à jour avec la valeur que Xen a attribuée à la machine virtuelle. S’il n’y a pas assez de mémoire libre sur l’hôte XenServer, 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 VM.

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 est possible de modifier ces champs uniquement lorsqu’une machine virtuelle est arrêtée. La plage statique doit englober la plage dynamique.

vm-memory-target-set

  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 se situer 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 compresse remplace le paramètre migration-compression pool pour xe pool-param-set.

Le hôte dans le paramètre vm-migrate command peut être le nom ou 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 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 le stockage (migration dynamique du stockage) :

  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 dynamique du stockage, 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 si vous effectuez une migration 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-->

En outre, 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 entre pools :

  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 en direct du stockage, la migration en direct et la migration VDI en direct, consultez la section Migrer des machines virtuelles.

Remarque :

Si vous effectuez une mise à niveau à partir d’une ancienne version de XenServer ou de Citrix Hypervisor, 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 charge.

Par défaut, la machine virtuelle est suspendue, migrée et reprise sur l’autre hôte. Le vivre Paramètre Sélectionne la migration en direct. La migration en direct maintient la machine virtuelle en cours d’exécution pendant l’exécution de la migration, minimisant ainsi les temps d’arrêt de la machine virtuelle. Dans certaines circonstances, par exemple en cas de charges de travail extrêmement gourmandes en mémoire dans la machine virtuelle, la migration dynamique revient au 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 VM. Les arguments facultatifs peuvent être n’importe quel nombre de l’ Paramètres de la machine virtuelle répertorié au début de cette section.

vm-pause

  xe vm-pause
<!--NeedCopy-->

Mettre 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émarrez les machines virtuelles spécifiées.

La ou les machines virtuelles sur lesquelles cette opération est effectuée sont sélectionnées à l’aide du mécanisme de sélection standard. Pour plus d’informations, consultez Sélecteurs de VM. Les arguments facultatifs peuvent être n’importe quel nombre de l’ Paramètres de la machine virtuelle répertorié au début de cette section.

Utilisez le force argument pour provoquer un redémarrage disgracieux. Lorsque l’arrêt s’apparente à 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 de l’ Paramètres de la machine virtuelle répertorié au début de cette section.

Il s’agit d’un avancé à utiliser uniquement lorsqu’un hôte membre d’un pool tombe en panne. Vous pouvez utiliser cette commande pour forcer le coordinateur de pool à réinitialiser l’état d’alimentation des machines virtuelles à Arrêté. Essentiellement, cette commande force le verrou sur la machine virtuelle et ses disques afin qu’il puisse être démarré ensuite sur un autre hôte de pool. Cet appel Exige l’indicateur force à spécifier, et échoue s’il n’est pas sur la ligne de commande.

vm-restart-device-models

  xe vm-restart-device-models [vm-selector=vm_selector_value...]
<!--NeedCopy-->

Redémarrez 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 peut voir une légère pause et reprendre 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, les outils de machine virtuelle XenServer pour Windows doivent être installés sur la machine virtuelle.

vm-resume

  xe vm-resume [vm-selector=vm_selector_value...] [force=true|false] [on=host_uuid]
<!--NeedCopy-->

Reprenez les machines virtuelles spécifiées.

La ou les machines virtuelles sur lesquelles cette opération est effectuée sont sélectionnées à l’aide du mécanisme de sélection standard. Pour plus d’informations, consultez Sélecteurs de VM. Les arguments facultatifs peuvent être n’importe quel nombre de l’ Paramètres de la machine virtuelle répertorié au début de cette section.

Si la machine virtuelle se trouve sur un SR partagé dans un pool d’hôtes, utilisez le sur pour spécifier le membre du pool sur lequel le démarrer. Par défaut, le système détermine un hôte approprié, qui peut être l’un des membres du pool.

vm-retrieve-wlb-recommendations

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

Récupérez les recommandations d’équilibrage de la charge de travail pour la machine virtuelle sélectionnée.

vm-shutdown

  xe vm-shutdown [vm-selector=vm_selector_value...] [force=true|false]
<!--NeedCopy-->

Arrêtez la machine virtuelle spécifiée.

La ou les machines virtuelles sur lesquelles cette opération est effectuée sont sélectionnées à l’aide du mécanisme de sélection standard. Pour plus d’informations, consultez Sélecteurs de VM. Les arguments facultatifs peuvent être n’importe quel nombre de l’ Paramètres de la machine virtuelle répertorié au début de cette section.

Utilisez le force pour provoquer un arrêt disgracieux, similaire à la déconnexion d’un serveur physique.

vm-snapshot

  xe vm-snapshot new-name-label=name_label [new-name-description+name_description]
<!--NeedCopy-->

Capturez une machine virtuelle existante, à l’aide de l’opération de capture instantanée de disque rapide au niveau du stockage, le cas échéant.

vm-start

  xe vm-start [vm-selector=vm_selector_value...] [force=true|false] [on=host_uuid] [--multiple]
<!--NeedCopy-->

Démarrez les machines virtuelles spécifiées.

La ou les machines virtuelles sur lesquelles cette opération est effectuée sont sélectionnées à l’aide du mécanisme de sélection standard. Pour plus d’informations, consultez Sélecteurs de VM. Les arguments facultatifs peuvent être n’importe quel nombre de l’ Paramètres de la machine virtuelle répertorié au début de cette section.

Si les machines virtuelles se trouvent sur un SR partagé dans un pool d’hôtes, utilisez la commande sur pour spécifier le membre du pool sur lequel démarrer les machines virtuelles. Par défaut, le système détermine un hôte approprié, qui peut être l’un des membres du pool.

vm-suspend

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

Suspendez la machine virtuelle spécifiée.

La ou les machines virtuelles sur lesquelles cette opération est effectuée sont sélectionnées à l’aide du mécanisme de sélection standard. Pour plus d’informations, consultez Sélecteurs de VM. Les arguments facultatifs peuvent être n’importe quel nombre de l’ Paramètres de la machine virtuelle répertorié au début de cette section.

vm-uninstall

  xe vm-uninstall [vm-selector=vm_selector_value...] [force=true|false]
<!--NeedCopy-->

Désinstallez une machine virtuelle, en détruisant ses disques (les VDI marqués RW et connectés à cette machine virtuelle uniquement) en plus de son enregistrement de métadonnées. Pour détruire uniquement les métadonnées de la machine virtuelle, utilisez xe vm-destroy.

La ou les machines virtuelles sur lesquelles cette opération est effectuée sont sélectionnées à l’aide du mécanisme de sélection standard. Pour plus d’informations, consultez Sélecteurs de VM. Les arguments facultatifs peuvent être n’importe quel nombre de l’ Paramètres de la machine virtuelle répertorié au début de cette section.

vm-unpause

  xe vm-unpause
<!--NeedCopy-->

Déclenchez la pause d’une machine virtuelle suspendue.

vm-vcpu-hotplug

  xe vm-vcpu-hotplug new-vcpus=new_total_vcpu_count [vm-selector=vm_selector_value...]
<!--NeedCopy-->

Ajustez dynamiquement le nombre de processeurs virtuels disponibles pour une machine virtuelle Linux en cours d’exécution. Le nombre de vCPU est limité par le paramètre VCPUs-max. Les machines virtuelles Windows s’exécutent toujours avec le nombre de vCPU défini sur VCPUs-max et doit être redémarré pour modifier cette valeur.

Utilisez le nouveau-vcpu pour définir le nouveau paramètre total nombre de vCPU que vous souhaitez avoir après l’exécution de cette commande. N’utilisez pas ce paramètre pour transmettre le nombre de vCPU que vous souhaitez ajouter. Par exemple, si vous avez deux processeurs virtuels existants dans votre machine virtuelle et que vous souhaitez ajouter deux processeurs virtuels supplémentaires, spécifiez nouveau-vcpu=4.

La ou les machines virtuelles Linux 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 de l’ Paramètres de la machine virtuelle répertorié au début de cette section.

Remarque :

Lors de l’exécution de machines virtuelles Linux sans XenServer VM Tools installé, exécutez la commande suivante sur la machine virtuelle en tant que racine Pour vous assurer que les vCPU nouvellement branchés à chaud sont utilisés : # pour i dans /sys/devices/system/cpu/cpu[1-9]*/online ; do if [ "$(cat $i)" = 0 ] ; puis écho 1 > $i; Fi; fait

vm-vif-list

  xe vm-vif-list [vm-selector=vm_selector_value...]
<!--NeedCopy-->

Répertorie les VIF des machines virtuelles spécifiées.

La ou les machines virtuelles sur lesquelles cette opération est effectuée sont sélectionnées à l’aide du mécanisme de sélection standard. Pour plus d’informations, consultez Sélecteurs de VM. Les sélecteurs fonctionnent sur les enregistrements de la machine virtuelle lors du filtrage, et non sur les valeurs VIF. Les arguments facultatifs peuvent être n’importe quel nombre de l’ Paramètres de la machine virtuelle répertorié au début de cette section.

Instantanés planifiés

Commandes permettant de contrôler les instantanés planifiés de machine virtuelle et leurs attributs.

Le Les Les objets peuvent être listés à l’aide de la commande standard de liste d’objets (xe vmss-list) et les paramètres manipulés à l’aide des 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 une planification d’instantanés dans le pool.

Par exemple :

  xe vmss-create retained-snapshots=9 enabled=true frequency=daily \
      name-description=sample name-label=samplepolicy type=snapshot \
      schedule:hour=10 schedule:min=30
<!--NeedCopy-->

Les planifications 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.

Intercommunication USB

Le relais USB est pris en charge pour les versions USB suivantes : 1.1, 2.0 et 3.0.

Activation/désactivation du relais USB

  xe pusb-param-set uuid=pusb_uuid passthrough-enabled=true/false
<!--NeedCopy-->

Activer/désactiver l’USB Pass-through.

pusb-scan

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

Scannez PUSB et mettez à jour.

vusb-create

  xe vusb-create usb-group-uuid=usb_group_uuid vm-uuid=vm_uuid
<!--NeedCopy-->

Crée une clé USB virtuelle dans le pool. Démarrez la machine virtuelle pour qu’elle passe via l’USB vers la machine virtuelle.

vusb-unplug

  xe vusb-unplug uuid=vusb_uuid
<!--NeedCopy-->

Débranche l’USB de la machine virtuelle.

vusb-destroy

  xe vusb-destroy uuid=vusb_uuid
<!--NeedCopy-->

Supprime la liste des clés USB virtuelles de la machine virtuelle.

Commandes de groupe de machines virtuelles

Commandes permettant de contrôler les groupes de machines virtuelles et leurs attributs.

Paramètres du groupe de machines virtuelles

• uuid (lecture seule) l’identificateur unique/la référence d’objet de la machine virtuelle
• nom-étiquette (lecture/écriture) le nom de la machine virtuelle
• nom-description (lecture/écriture) la chaîne de description de la machine virtuelle
• placement (lecture seule) le type de règles de placement à appliquer aux machines virtuelles du groupe. Les valeurs disponibles sont les suivantes Anti-affinité et normal.

liste-groupe-vm

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

Répertorie tous les groupes de machines virtuelles 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 machines virtuelles.

vm-group-destroy

  xe vm-group-destroy uuid=<vm-group-uuid>
<!--NeedCopy-->

Supprime ce groupe de machines virtuelles. Si vous supprimez un groupe de machines virtuelles qui contient des machines virtuelles, celles-ci ne sont plus associées à un groupe, mais ne sont pas affectées.