Interfaz de línea de comandos

La CLI xe le permite crear scripts y automatizar tareas de administración del sistema. Utilice la CLI para integrar XenServer® en una infraestructura de TI existente.

Primeros pasos con la CLI de xe

La interfaz de línea de comandos xe se instala de forma predeterminada en todos los hosts de XenServer. Se incluye una versión remota para Windows con XenCenter. También hay disponible una CLI remota independiente para Linux.

En su host XenServer

La interfaz de línea de comandos xe se instala de forma predeterminada en su host. Puede ejecutar comandos de la CLI de xe en la consola dom0. Acceda a la consola dom0 de una de las siguientes maneras:

• En XenCenter, vaya a la ficha Console del host donde desea ejecutar el comando.
• Conéctese por SSH al host donde desea ejecutar el comando.

En Windows

En Windows, el comando xe.exe se instala junto con XenCenter.

Para usar el comando xe.exe, abra un símbolo del sistema de Windows y cambie de directorio al directorio donde se encuentra el archivo xe.exe (normalmente C:\Program Files (x86)\XenServer\XenCenter). Si agrega la ubicación de instalación de xe.exe a la ruta del sistema, puede usar el comando sin tener que cambiar al directorio.

En Linux

En distribuciones basadas en RPM (como Red Hat), puede instalar el comando xe independiente desde el RPM denominado client_install/xapi-xe-BUILD.x86_64.rpm en la ISO de instalación principal de XenServer.

Para instalar desde el RPM, use el siguiente comando:

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

Puede usar parámetros en la línea de comandos para definir el host de XenServer, el nombre de usuario y la contraseña que se usarán al ejecutar comandos xe. Sin embargo, también tiene la opción de establecer esta información como una variable de entorno. Por ejemplo:

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

Nota:

La CLI remota de xe en Linux podría quedarse colgada al intentar ejecutar comandos a través de una conexión segura y estos comandos implican la transferencia de archivos. Si es así, puede usar el parámetro --no-ssl para ejecutar el comando a través de una conexión no segura al host de XenServer.

Obtener ayuda con los comandos xe

Hay ayuda básica disponible para los comandos de la CLI en el host escribiendo:

xe help command
<!--NeedCopy-->

Se muestra una lista de los comandos xe más utilizados si escribe:

xe help
<!--NeedCopy-->

O se muestra una lista de todos los comandos xe si escribe:

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

Sintaxis básica de xe

La sintaxis básica de todos los comandos de la CLI de XenServer xe es:

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

Cada comando específico contiene su propio conjunto de argumentos que tienen la forma argument=value. Algunos comandos tienen argumentos obligatorios, y la mayoría tienen un conjunto de argumentos opcionales. Normalmente, un comando asume valores predeterminados para algunos de los argumentos opcionales cuando se invoca sin ellos.

Si el comando xe se ejecuta de forma remota, se utilizan argumentos adicionales para conectarse y autenticarse. Estos argumentos también tienen la forma argument=argument_value.

El argumento server se utiliza para especificar el nombre de host o la dirección IP. Los argumentos username y password se utilizan para especificar las credenciales.

Se puede especificar un argumento password-file en lugar de la contraseña directamente. En este caso, el comando xe intenta leer la contraseña del archivo especificado y utiliza esa contraseña para conectarse. (Cualquier CR y LF final al final del archivo se elimina.) Este método es más seguro que especificar la contraseña directamente en la línea de comandos.

El argumento opcional port se puede utilizar para especificar el puerto del agente en el host remoto de XenServer (el valor predeterminado es 443).

Ejemplo: En el host local de XenServer:

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

Ejemplo: En un host remoto de XenServer:

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

La sintaxis abreviada también está disponible para los argumentos de conexión remota:

• -u nombre de usuario
• -pw contraseña
• -pwf archivo de contraseña
• -p puerto
• -s servidor

Ejemplo: En un host XenServer remoto:

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

Los argumentos también se toman de la variable de entorno XE_EXTRA_ARGS, en forma de pares clave-valor separados por comas. Por ejemplo, para introducir comandos que se ejecutan en un host XenServer remoto, primero ejecute el siguiente comando:

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

Después de ejecutar este comando, ya no tendrá que especificar los parámetros del host XenServer remoto en cada comando xe que ejecute.

El uso de la variable de entorno XE_EXTRA_ARGS también permite la finalización con tabulador de los comandos xe cuando se emiten contra un host XenServer remoto, lo que está deshabilitado de forma predeterminada.

Caracteres especiales y sintaxis

Para especificar pares argumento/valor en la línea de comandos xe, escriba: argument=value

A menos que el valor incluya espacios, no utilice comillas. No incluya espacios en blanco entre el nombre del argumento, el signo igual (=) y el valor. Cualquier argumento que no se ajuste a este formato será ignorado.

Para valores que contengan espacios, escriba: argument="value with spaces"

Cuando utiliza la CLI en su host XenServer, los comandos tienen una función de autocompletado con tabulador similar a la función de la shell bash estándar de Linux. Por ejemplo, si escribe xe vm-l y luego presiona la tecla TAB, se muestra el resto del comando. Si más de un comando comienza con vm-l, al presionar TAB una segunda vez se enumeran las posibilidades. Esta función es útil al especificar UUID de objetos en los comandos.

Nota:

La función de autocompletar con tabulador no suele funcionar al ejecutar comandos en un host XenServer remoto. Sin embargo, si establece la variable XE_EXTRA_ARGS en la máquina donde introduce los comandos, la función de autocompletar con tabulador se habilita. Para obtener más información, consulte (/es-es/xenserver/9/command-line-interface.html#basic-xe-syntax).

Tipos de comandos

Los comandos de la CLI se pueden dividir en dos mitades. Los comandos de bajo nivel se ocupan de la enumeración y manipulación de parámetros de los objetos de la API. Los comandos de nivel superior se utilizan para interactuar con máquinas virtuales o hosts a un nivel más abstracto.

Los comandos de bajo nivel son:

• class-list

• class-param-get

• class-param-set

• class-param-list

• class-param-add

• class-param-remove

• class-param-clear

Donde class es uno de:

• bond

• console

• host

• host-crashdump

• host-cpu

• network

• patch

• pbd

• pif

• pool

• sm

• sr

• task

• template

• vbd

• vdi

• vif

• vlan

• vm

No todos los valores de class tienen el conjunto completo de comandos class-param-action. Algunos valores de class tienen un conjunto más pequeño de comandos.

Tipos de parámetros

Los objetos a los que se dirigen los comandos xe tienen conjuntos de parámetros que los identifican y definen sus estados.

La mayoría de los parámetros toman un único valor. Por ejemplo, el parámetro name-label de una VM contiene un único valor de cadena. En la salida de los comandos de lista de parámetros, como xe vm-param-list, un valor entre paréntesis indica si los parámetros son de lectura-escritura (RW) o de solo lectura (RO). La salida de xe vm-param-list en una VM especificada podría tener las siguientes líneas:

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

El primer parámetro, user-version, es escribible y tiene el valor 1. El segundo, is-control-domain, es de solo lectura y tiene un valor de false.

Los otros dos tipos de parámetros son multivalor. Un parámetro set contiene una lista de valores. Un parámetro map es un conjunto de pares clave-valor. Como ejemplo, observe la siguiente parte de la salida de muestra de xe vm-param-list en una VM especificada:

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

El parámetro platform tiene una lista de elementos que representan pares clave-valor. Los nombres de las claves van seguidos de un carácter de dos puntos (:). Cada par clave-valor se separa del siguiente por un carácter de punto y coma (;). La M que precede a RW indica que este parámetro es un parámetro de mapa y es legible y escribible. El parámetro allowed-operations tiene una lista que forma un conjunto de elementos. La S que precede a RO indica que este es un parámetro de conjunto y es legible pero no escribible.

Para filtrar un parámetro de mapa o establecer un parámetro de mapa, use dos puntos (:) para separar el nombre del parámetro de mapa y el par clave-valor. Por ejemplo, para establecer el valor de la clave foo del parámetro other-config de una VM en baa, el comando sería

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

Comandos de parámetros de bajo nivel

Existen varios comandos para operar con parámetros de objetos: class-param-get, class-param-set, class-param-add, class-param-remove, class-param-clear y class-param-list. Cada uno de estos comandos toma un parámetro uuid para especificar el objeto particular. Dado que estos comandos se consideran de bajo nivel, deben usar el UUID y no la etiqueta de nombre de la VM.

• xe class-param-list uuid=uuid

  Enumera todos los parámetros y sus valores asociados. A diferencia del comando class-list, este comando enumera los valores de los campos “costosos”.

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

  Devuelve el valor de un parámetro en particular. Para un parámetro de mapa, al especificar la clave de parámetro (param-key) se obtiene el valor asociado a esa clave en el mapa. Si no se especifica la clave de parámetro o si el parámetro es un conjunto, el comando devuelve una representación de cadena del conjunto o mapa.

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

  Establece el valor de uno o más parámetros.

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

  Añade a un parámetro de mapa o de conjunto. Para un parámetro de mapa, añada pares clave-valor usando la sintaxis key=value. Si el parámetro es un conjunto, añada claves con la sintaxis param-key=key.

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

  Elimina un par clave-valor de un mapa o una clave de un conjunto.

• xe class-param-clear uuid=uuid param-name=parameter

  Borra completamente un conjunto o un mapa.

Comandos de lista de bajo nivel

El comando class-list enumera los objetos de tipo class. Por defecto, este tipo de comando enumera todos los objetos, imprimiendo un subconjunto de los parámetros. Este comportamiento se puede modificar de las siguientes maneras:

• Puede filtrar los objetos para que solo muestre un subconjunto.
• Los parámetros que se imprimen pueden modificarse.

Para cambiar los parámetros que se imprimen, especifique el argumento params como una lista separada por comas de los parámetros requeridos. Por ejemplo:

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

Alternativamente, para listar todos los parámetros, use la sintaxis:

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

El comando list no muestra algunos parámetros cuyo cálculo es costoso. Estos parámetros se muestran, por ejemplo, como:

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

Para obtener estos campos, utilice el comando class-param-list o class-param-get.

Para filtrar la lista, la CLI compara los valores de los parámetros con los valores especificados en la línea de comandos, imprimiendo solo los objetos que coinciden con todas las restricciones especificadas. Por ejemplo:

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

Este comando lista solo aquellas máquinas virtuales para las que ambos el campo power-state tiene el valor halted y el campo HVM-boot-policy tiene el valor BIOS order.

También puede filtrar la lista por el valor de las claves en los mapas o por la existencia de valores en un conjunto. La sintaxis para filtrar basándose en claves en mapas es map-name:key=value. La sintaxis para filtrar basándose en valores existentes en un conjunto es set-name:contains=value.

Al escribir scripts, una técnica útil es pasar --minimal en la línea de comandos, lo que hace que xe imprima solo el primer campo en una lista separada por comas. Por ejemplo, el comando xe vm-list --minimal en un host con tres máquinas virtuales instaladas da los tres UUID de las máquinas virtuales:

    a85d6717-7264-d00e-069b-3b1d19d56ad9,aaa3eec5-9499-bcf3-4c03-af10baea96b7, \
    42c044de-df69-4b30-89d9-2c199564581d
<!--NeedCopy-->

Secretos

XenServer proporciona un mecanismo de secretos para evitar que las contraseñas se almacenen en texto sin formato en el historial de la línea de comandos o en los objetos de la API. XenCenter utiliza esta característica automáticamente y también se puede usar desde la CLI de xe para cualquier comando que requiera una contraseña.

Nota:

Los secretos de contraseña no se pueden usar para autenticarse con un host XenServer desde una instancia remota de la CLI de xe.

Para crear un objeto secreto, ejecute el siguiente comando en su host XenServer.

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

Se crea y almacena un secreto en el host XenServer. El comando muestra el UUID del objeto secreto. Por ejemplo, 99945d96-5890-de2a-3899-8c04ef2521db. Añada _secret al nombre del argumento de la contraseña para pasar este UUID a cualquier comando que requiera una contraseña.

Ejemplo: En el host XenServer donde creó el secreto, puede ejecutar el siguiente comando:

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

Historial de comandos

Algunos comandos de xe, por ejemplo xe vm-migrate o xe pool-enable-external-auth, toman secretos como contraseñas como parámetros. Estos pueden terminar en el historial del shell y, durante la ejecución del comando, son visibles en la tabla de procesos. Por lo tanto, es importante ejecutar estos comandos solo en entornos de confianza.

Para el shell bash, puede usar la variable HISTCONTROL para controlar qué comandos se almacenan en el historial del shell.

Referencia de comandos xe

Esta sección agrupa los comandos por los objetos a los que se dirige el comando. Estos objetos se enumeran alfabéticamente.

Comandos de dispositivo

Comandos para crear y modificar dispositivos VM (también conocidos como vApps). Para obtener más información, consulte vApps.

Parámetros de dispositivo

Los comandos de dispositivo tienen los siguientes parámetros:

appliance-assert-can-be-recovered

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

Comprueba si hay almacenamiento disponible para recuperar este dispositivo/vApp de VM.

appliance-create

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

Crea un dispositivo/vApp. Por ejemplo:

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

Añadir VM al dispositivo:

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

appliance-destroy

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

Destruye un dispositivo/vApp. Por ejemplo:

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

appliance-recover

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

Recupera un dispositivo/vApp de VM de la base de datos contenida en el VDI suministrado.

appliance-shutdown

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

Apaga todas las máquinas virtuales en un dispositivo/vApp. Por ejemplo:

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

appliance-start

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

Inicia un dispositivo/vApp. Por ejemplo:

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

Comandos de auditoría

Los comandos de auditoría descargan todos los registros disponibles del archivo de auditoría RBAC en el pool. Si el parámetro opcional since está presente, solo descarga los registros desde ese punto específico en el tiempo.

Parámetros de audit-log-get

audit-log-get tiene los siguientes parámetros

audit-log-get

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

Por ejemplo, para obtener registros de auditoría del pool desde una marca de tiempo precisa en milisegundos, ejecute el siguiente comando:

Ejecute el siguiente comando:

xe audit-log-get since=2009-09-24T17:56:20.530Z filename=/tmp/auditlog-pool-actions.out
<!--NeedCopy-->

Comandos de enlace

Comandos para trabajar con enlaces de red, para la resiliencia con conmutación por error de interfaz física. Para obtener más información, consulte Redes.

El objeto de enlace es un objeto de referencia que une los PIF maestro y miembro. El PIF maestro es la interfaz de enlace que debe utilizarse como PIF general para referirse al enlace. Los PIF miembro son un conjunto de dos o más interfaces físicas que se han combinado en la interfaz enlazada de alto nivel.

Parámetros de enlace

Los enlaces tienen los siguientes parámetros:

bond-create

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

Crea una interfaz de red enlazada en la red especificada a partir de una lista de objetos PIF existentes. El comando falla en cualquiera de los siguientes casos:

• Si los PIF ya están en otro enlace
• Si algún miembro tiene una etiqueta VLAN configurada
• Si los PIF referenciados no están en el mismo host de XenServer
• Si se proporcionan menos de 2 PIF

bond-destroy

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

Elimina una interfaz enlazada especificada por su UUID de un host.

bond-set-mode

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

Cambiar el modo de enlace.

Comandos de CD

Comandos para trabajar con unidades físicas de CD/DVD en hosts de XenServer.

Parámetros de CD

Los CD tienen los siguientes parámetros:

cd-list

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

Enumera los CD e ISO (archivos de imagen de CD) en el host o grupo de XenServer, filtrando por el argumento opcional params.

Si se utiliza el argumento opcional params, el valor de params es una cadena que contiene una lista de parámetros de este objeto que desea mostrar. Alternativamente, puede usar la palabra clave all para mostrar todos los parámetros. Cuando no se usa params, la lista devuelta muestra un subconjunto predeterminado de todos los parámetros disponibles.

Los argumentos opcionales pueden ser cualquier número de los parámetros de CD enumerados al principio de esta sección.

Comandos de clúster GFS2

Comandos para trabajar con grupos en clúster GFS2.

Los grupos en clúster GFS2 son grupos de recursos que tienen la función de clúster habilitada. Utilice estos grupos con SR GFS2. Para obtener más información, consulte Grupos en clúster GFS2

Los objetos de clúster y host de clúster se pueden enumerar con los comandos de listado de objetos estándar (xe cluster-list y xe cluster-host-list), y los parámetros se pueden manipular con los comandos de parámetros estándar. Para obtener más información, consulte Comandos de parámetros de bajo nivel. Comandos para trabajar con grupos en clúster GFS2.

Parámetros del clúster GFS2

Los clústeres GFS2 tienen los siguientes parámetros:

Los hosts dentro del clúster GFS2 (cluster-host) tienen los siguientes parámetros:

cluster-host-destroy

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

Destruye un host del clúster GFS2, abandonando efectivamente el clúster GFS2.

cluster-host-disable

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

Deshabilita la pertenencia al clúster GFS2 para un host del clúster GFS2 habilitado.

cluster-host-enable

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

Habilita la pertenencia al clúster GFS2 para un host del clúster GFS2 deshabilitado.

cluster-host-force-destroy

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

Destruye un objeto de host del clúster GFS2 de forma forzada, abandonando efectivamente el clúster GFS2.

cluster-pool-create

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

Crea un clúster GFS2 a nivel de pool.

cluster-pool-destroy

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

Destruye el clúster GFS2 a nivel de pool. El pool sigue existiendo, pero ya no está agrupado en clúster GFS2 y ya no puede usar SR GFS2.

cluster-pool-force-destroy

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

Forzar la destrucción del clúster GFS2 de todo el pool.

cluster-pool-resync

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

Resincronizar un clúster GFS2 en todo un pool.

Comandos de consola

Comandos para trabajar con consolas.

Los objetos de consola se pueden listar con el comando estándar de listado de objetos (xe console-list), y los parámetros se pueden manipular con los comandos de parámetros estándar. Para obtener más información, consulte Comandos de parámetros de bajo nivel.

Parámetros de consola

Las consolas tienen los siguientes parámetros:

console

xe console
<!--NeedCopy-->

Conectarse a una consola en particular.

Comandos de diagnóstico

Comandos para recopilar información de diagnóstico de XenServer.

diagnostic-compact

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

Realizar una recolección de GC principal y compactación de pila.

diagnostic-db-stats

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

Imprimir estadísticas de la base de datos.

diagnostic-gc-stats

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

Imprimir estadísticas de GC.

diagnostic-license-status

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

Ayuda a diagnosticar problemas de licencias en todo el grupo.

diagnostic-net-stats

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

Imprimir estadísticas de red.

diagnostic-timing-stats

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

Imprimir estadísticas de tiempo.

diagnostic-vdi-status

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

Consultar el estado de bloqueo y uso compartido de un VDI.

diagnostic-vm-status

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

Consultar los hosts en los que la VM puede arrancar, comprobar el estado de uso compartido/bloqueo de todos los VBD.

Comandos de recuperación ante desastres

Comandos para recuperar máquinas virtuales después de un desastre

drtask-create

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

Crea una tarea de recuperación ante desastres. Por ejemplo, para conectarse a un SR iSCSI en preparación para la recuperación ante desastres:

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

Nota:

El comando sr-whitelist enumera los UUID de SR permitidos. El comando drtask-create solo introduce y se conecta a un SR que tiene uno de los UUID permitidos.

drtask-destroy

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

Destruye una tarea de recuperación ante desastres y olvida el SR introducido.

vm-assert-can-be-recovered

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

Comprueba si hay almacenamiento disponible para recuperar esta VM.

appliance-assert-can-be-recovered

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

Comprueba si el almacenamiento (que contiene el disco del dispositivo/vAPP) está visible.

appliance-recover

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

Recupera un dispositivo/vAPP de la base de datos contenida en el VDI suministrado.

vm-recover

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

Recupera una VM de la base de datos contenida en el VDI suministrado.

sr-enable-database-replication

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

Habilita la replicación de la base de datos XAPI en el SR especificado (compartido).

sr-disable-database-replication

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

Deshabilita la replicación de la base de datos XAPI en el SR especificado.

Ejemplo de uso

El siguiente ejemplo muestra los comandos de la CLI de DR en contexto:

En el sitio principal, habilite la replicación de la base de datos:

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

Después de un desastre, en el sitio secundario, conéctese al SR. El comando device-config tiene los mismos campos que sr-probe.

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

Busque VDIs de base de datos en el SR:

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

Consulte un VDI de base de datos para las VM presentes:

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

Recuperar una VM:

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

Destruya la tarea de DR. Cualquier SR introducido por la tarea de DR y no requerido por las VM se destruye:

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

Comandos de eventos

Comandos para trabajar con eventos.

Clases de eventos

Las clases de eventos se enumeran en la siguiente tabla:

event-wait

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

Bloquea la ejecución de otros comandos hasta que exista un objeto que cumpla las condiciones dadas en la línea de comandos. El argumento x=y significa “esperar a que el campo x tome el valor y” y x=/=y significa “esperar a que el campo x tome cualquier valor distinto de y”.

Ejemplo: esperar a que una VM específica esté en ejecución.

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

Bloquea otros comandos hasta que una VM llamada myvm esté en el estado power-state “en ejecución”.

Ejemplo: esperar a que una VM específica se reinicie:

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

Bloquea otros comandos hasta que una VM con UUID $VM se reinicie. El comando utiliza el valor de start-time para decidir cuándo se reinicia la VM.

El nombre de la clase puede ser cualquiera de las clases de eventos enumeradas al principio de esta sección. Los parámetros pueden ser cualquiera de los parámetros enumerados en el comando CLI class-param-list.

Comandos de GPU

Comandos para trabajar con GPU físicas, grupos de GPU y GPU virtuales.

Los objetos GPU se pueden enumerar con los comandos estándar de listado de objetos: xe pgpu-list, xe gpu-group-list y xe vgpu-list. Los parámetros se pueden manipular con los comandos estándar de parámetros. Para obtener más información, consulte Comandos de parámetros de bajo nivel.

Parámetros de GPU físicas

Las GPU físicas (pGPU) tienen los siguientes parámetros:

pgpu-disable-dom0-access

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

Deshabilitar el acceso de la PGPU a dom0.

pgpu-enable-dom0-access

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

Habilitar el acceso de la PGPU a dom0.

Parámetros del grupo de GPU

Los grupos de GPU tienen los siguientes parámetros:

Operaciones de grupo de GPU

Comandos para trabajar con grupos de GPU

gpu-group-create

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

Crea un nuevo grupo de GPU (vacío) al que se pueden mover las pGPU.

gpu-group-destroy

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

Destruye el grupo de GPU; solo permitido para grupos vacíos.

gpu-group-get-remaining-capacity

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

Devuelve cuántas GPU virtuales más del tipo especificado se pueden instanciar en este grupo de GPU.

gpu-group-param-set

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

Cambia el algoritmo que utiliza el grupo de GPU para asignar GPU virtuales a pGPU.

Parámetros de la GPU virtual

Las GPU virtuales tienen los siguientes parámetros:

Parámetros del tipo de GPU virtual

Nota:

La transferencia de GPU y las GPU virtuales no son compatibles con la migración en vivo, la migración en vivo de almacenamiento o la suspensión de VM a menos que haya software y tarjetas gráficas compatibles de los proveedores de GPU. Las VM sin este soporte no se pueden migrar para evitar el tiempo de inactividad. Para obtener información sobre la compatibilidad de NVIDIA vGPU con la migración en vivo, la migración en vivo de almacenamiento y la suspensión de VM, consulte Gráficos.

Los tipos de GPU virtual tienen los siguientes parámetros:

Operaciones de GPU virtual

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

Crea una GPU virtual. Este comando adjunta la VM al grupo de GPU especificado y, opcionalmente, especifica el tipo de GPU virtual. Si no se especifica ningún tipo de GPU virtual, se asume el tipo ‘pass-through’.

vgpu-destroy

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

Destruye la GPU virtual especificada.

Deshabilitar VNC para máquinas virtuales con GPU virtual

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

El uso de false deshabilita la consola VNC para una máquina virtual, ya que pasa disablevnc=1 al emulador de pantalla. De forma predeterminada, VNC está habilitado.

Comandos de host

Comandos para interactuar con el host de XenServer.

Los hosts de XenServer son los servidores físicos que ejecutan el software XenServer. Tienen máquinas virtuales ejecutándose en ellos bajo el control de una máquina virtual privilegiada especial, conocida como dominio de control o dominio 0.

Los objetos de host de XenServer se pueden listar con los comandos estándar de listado de objetos: xe host-list, xe host-cpu-list y xe host-crashdump-list). Los parámetros se pueden manipular con los comandos de parámetros estándar. Para obtener más información, consulte Comandos de parámetros de bajo nivel.

Selectores de host

Varios de los comandos enumerados aquí tienen un mecanismo común para seleccionar uno o más hosts de XenServer en los que realizar la operación. El más simple es proporcionando el argumento host=uuid_or_name_label. También puede especificar XenServer filtrando la lista completa de hosts según los valores de los campos. Por ejemplo, especificar enabled=true selecciona todos los hosts de XenServer cuyo campo enabled es igual a true. Cuando coinciden varios hosts de XenServer y la operación se puede realizar en varios hosts de XenServer, debe especificar --multiple para realizar la operación. La lista completa de parámetros que se pueden hacer coincidir se describe al principio de esta sección. Puede obtener esta lista de comandos ejecutando el comando xe host-list params=all. Si no se proporcionan parámetros para seleccionar hosts de XenServer, la operación se realiza en todos los hosts de XenServer.

Parámetros de host

Los hosts de XenServer tienen los siguientes parámetros:

Ejemplos:

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

Los hosts de XenServer contienen otros objetos que también tienen listas de parámetros.

Las CPU de los hosts de XenServer tienen los siguientes parámetros:

Los volcados de memoria en los hosts XenServer tienen los siguientes parámetros:

host-all-editions

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

Obtener una lista de todas las ediciones disponibles

host-apply-edition

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

Asigna la licencia de XenServer a un servidor host. Cuando asigna una licencia, XenServer se pone en contacto con el servidor de licencias y solicita el tipo de licencia especificado. Si hay una licencia disponible, se extrae del servidor de licencias.

Para la configuración inicial de licencias, consulte también license-server-address y license-server-port.

Los valores de edición incluyen “cloud”, “free”, “premium-per-socket” y “standard-per-socket”. En el futuro, solo se admitirá “cloud”.

host-backup

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

Descargue una copia de seguridad del dominio de control del host XenServer especificado en la máquina desde la que se invoca el comando. Guárdela allí como un archivo con el nombre file-name.

Importante:

Aunque el comando xe host-backup funciona si se ejecuta en el host local (es decir, sin un nombre de host específico), no lo utilice de esta manera. Hacerlo llenaría la partición del dominio de control con el archivo de copia de seguridad. Utilice el comando solo desde una máquina remota fuera del host donde tenga espacio para guardar el archivo de copia de seguridad.

host-bugreport-upload

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

Genere un nuevo informe de errores (utilizando xen-bugtool, con todos los archivos opcionales incluidos) y cárguelo al sitio FTP de soporte o a otra ubicación.

Los hosts en los que realizar esta operación se seleccionan utilizando el mecanismo de selección estándar (consulte selectores de host arriba). Los argumentos opcionales pueden ser cualquiera de los parámetros de host enumerados al principio de esta sección.

Los parámetros opcionales son http-proxy: usar el proxy HTTP especificado, y url: cargar a esta URL de destino. Si no se utilizan parámetros opcionales, no se identifica ningún servidor proxy y el destino es el sitio FTP de soporte predeterminado.

host-call-plugin

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

Llama a la función dentro del complemento en el host dado con argumentos opcionales.

host-compute-free-memory

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

Calcula la cantidad de memoria libre en el host.

host-compute-memory-overhead

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

Calcula la sobrecarga de memoria de virtualización de un host.

host-cpu-info

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

Enumera información sobre las CPU físicas del host.

host-crashdump-destroy

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

Elimina un volcado de memoria del host especificado por su UUID del host XenServer.

host-crashdump-upload

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

Carga un volcado de memoria al sitio FTP de soporte u otra ubicación. Si no se utilizan parámetros opcionales, no se identifica ningún servidor proxy y el destino es el sitio FTP de soporte predeterminado. Los parámetros opcionales son http-proxy: usar el proxy HTTP especificado, y url: cargar a esta URL de destino.

host-declare-dead

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

Declara que el host está inactivo sin contactarlo explícitamente.

Advertencia:

Esta llamada es peligrosa y puede causar pérdida de datos si el host no está realmente inactivo.

host-disable

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

Deshabilita los hosts de XenServer especificados, lo que impide que se inicien nuevas máquinas virtuales en ellos. Esta acción prepara los hosts de XenServer para ser apagados o reiniciados. Después de que el host se reinicia, si se cumplen todas las condiciones para la habilitación (por ejemplo, el almacenamiento está disponible), el host se vuelve a habilitar automáticamente.

Los hosts en los que se realizará esta operación se seleccionan utilizando el mecanismo de selección estándar (consulte selectores de host). Los argumentos opcionales pueden ser cualquier número de los parámetros de host enumerados al principio de esta sección.

host-disable-display

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

Deshabilitar la visualización para el host.

host-disable-local-storage-caching

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

Deshabilitar el almacenamiento en caché local en el host especificado.

host-dmesg

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

Obtenga un dmesg de Xen (la salida del búfer de anillo del kernel) de los hosts de XenServer especificados.

Los hosts en los que se realizará esta operación se seleccionan utilizando el mecanismo de selección estándar (consulte selectores de host). Los argumentos opcionales pueden ser cualquier número de los parámetros de host enumerados al principio de esta sección.

host-emergency-ha-disable

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

Deshabilitar HA en el host local. Solo debe usarse para recuperar un grupo con una configuración de HA defectuosa.

host-emergency-management-reconfigure

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

Reconfigure la interfaz de administración de este host de XenServer. Utilice este comando solo si el host de XenServer está en modo de emergencia. El modo de emergencia significa que el host es miembro de un grupo de recursos cuyo coordinador de grupo ha desaparecido de la red y no puede ser contactado después de varios reintentos.

host-emergency-reset-server-certificate

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

Instala un certificado autofirmado en el host de XenServer donde se ejecuta el comando.

host-enable

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

Habilita los hosts de XenServer especificados, lo que permite iniciar nuevas máquinas virtuales en ellos.

Los hosts en los que realizar esta operación se seleccionan utilizando el mecanismo de selección estándar (consulte selectores de host más arriba). Los argumentos opcionales pueden ser cualquiera de los parámetros de host enumerados al principio de esta sección.

host-enable-display

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

Habilitar la visualización para el host.

host-enable-local-storage-caching

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

Habilitar el almacenamiento en caché local en el host especificado.

host-evacuate

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

Migra en vivo todas las máquinas virtuales en ejecución a otros hosts adecuados en un pool. Primero, deshabilite el host usando el comando host-disable.

Si el host evacuado es el coordinador del pool, se debe seleccionar otro host para que sea el coordinador del pool. Para cambiar el coordinador del pool con HA deshabilitado, use el comando pool-designate-new-master. Para obtener más información, consulte pool-designate-new-master.

Con HA habilitado, su única opción es apagar el host de XenServer, lo que hace que HA elija un nuevo coordinador de pool al azar. Para obtener más información, consulte host-shutdown.

Los hosts en los que realizar esta operación se seleccionan utilizando el mecanismo de selección estándar (consulte selectores de host más arriba). Los argumentos opcionales pueden ser cualquiera de los parámetros de host enumerados al principio de esta sección.

host-forget

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

El agente XAPI olvida el host XenServer especificado sin contactarlo explícitamente.

Utilice el parámetro --force para evitar que se le pida confirmar que realmente desea realizar esta operación.

Advertencia:

No utilice este comando si la alta disponibilidad (HA) está habilitada en el grupo. Deshabilite primero la HA y, a continuación, vuelva a habilitarla después de haber olvidado el host.

Este comando es útil si el host XenServer que se va a “olvidar” está inactivo. Sin embargo, si el host XenServer está activo y forma parte del grupo, utilice xe pool-eject en su lugar.

host-get-server-certificate

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

Obtenga el certificado TLS del servidor instalado.

host-get-sm-diagnostics

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

Muestra la información de diagnóstico de SM por host.

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

Descargue la información de estado del sistema en el archivo especificado. El parámetro opcional entries es una lista de entradas de estado del sistema separadas por comas, tomadas del fragmento XML de capacidades devuelto por el comando host-get-system-status-capabilities. Para obtener más información, consulte host-get-system-status-capabilities. Si no se especifica, toda la información de estado del sistema se guarda en el archivo. El parámetro output puede ser tar.bz2 (el valor predeterminado) o zip. Si no se especifica este parámetro, el archivo se guarda en formato tar.bz2.

Los hosts en los que se realizará esta operación se seleccionan mediante el mecanismo de selección estándar (consulte selectores de host anterior).

host-get-system-status-capabilities

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

Obtenga las capacidades de estado del sistema para los hosts especificados. Las capacidades se devuelven como un fragmento XML similar al siguiente ejemplo:

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

Cada entidad de capacidad puede tener los siguientes atributos.

• key Un identificador único para la capacidad.
• content-type Puede ser text/plain o application/data. Indica si una interfaz de usuario puede renderizar las entradas para el consumo humano.
• default-checked Puede ser sí o no. Indica si una interfaz de usuario selecciona esta entrada por defecto.
• min-size, max-size Indica un rango aproximado para el tamaño, en bytes, de esta entrada. -1 indica que el tamaño no es importante.
• min-time, max-time Indican un rango aproximado para el tiempo, en segundos, que se tarda en recopilar esta entrada. -1 indica que el tiempo no es importante.

• pii Información de identificación personal. Indica si la entrada contiene información que puede identificar al propietario del sistema o detalles de su topología de red. El atributo puede tener uno de los siguientes valores:

  • no: no hay PII en estas entradas
  • yes: es probable o seguro que haya PII en estas entradas
  • maybe: es posible que desee auditar estas entradas en busca de PII
  • if_customized si los archivos no están modificados, no contienen PII. Sin embargo, dado que fomentamos la edición de estos archivos, es posible que se haya introducido PII mediante dicha personalización. Este valor se utiliza en particular para los scripts de red en el dominio de control.

  Las contraseñas nunca deben incluirse en ningún informe de errores, independientemente de cualquier declaración de PII.

Los hosts en los que se realizará esta operación se seleccionan utilizando el mecanismo de selección estándar (consulte selectores de host anterior).

host-get-thread-diagnostics

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

Muestra información de diagnóstico de subprocesos por host.

host-get-vms-which-prevent-evacuation

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

Devuelve una lista de máquinas virtuales que impiden la evacuación de un host específico y muestra los motivos de cada una.

host-is-in-emergency-mode

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

Devuelve true si el host con el que se comunica la CLI está en modo de emergencia, false en caso contrario. Este comando de la CLI funciona directamente en los hosts miembros del pool, incluso sin un coordinador de pool presente.

host-license-view

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

Muestra el contenido de la licencia del host XenServer.

host-logs-download

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

Descarga una copia de los registros de los hosts XenServer especificados. La copia se guarda por defecto en un archivo con marca de tiempo llamado hostname-yyyy-mm-dd T hh:mm:ssZ.tar.gz. Puede especificar un nombre de archivo diferente utilizando el parámetro opcional file-name.

Los hosts en los que se realizará esta operación se seleccionan utilizando el mecanismo de selección estándar (consulte selectores de host más arriba). Los argumentos opcionales pueden ser cualquiera de los parámetros de host enumerados al principio de esta sección.

Importante:

Aunque el comando xe host-logs-download funciona si se ejecuta en el host local (es decir, sin especificar un nombre de host específico), no lo utilice de esta manera. Hacerlo satura la partición del dominio de control con la copia de los registros. Utilice el comando únicamente desde una máquina remota externa al host donde tenga espacio para guardar la copia de los registros.

host-management-disable

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

Deshabilita el agente de host que escucha en una interfaz de red de administración externa y desconecta todos los clientes de API conectados (como XenCenter). Este comando opera directamente en el host XenServer al que está conectada la CLI. El comando no se reenvía al coordinador del pool cuando se aplica a un host XenServer miembro.

Advertencia:

Tenga cuidado al usar este comando de la CLI fuera del host. Después de ejecutar este comando, no podrá conectarse al dominio de control de forma remota a través de la red para volver a habilitar el agente de host.

host-management-reconfigure

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

Reconfigura el host XenServer para usar la interfaz de red especificada como su interfaz de administración, que es la interfaz utilizada para conectarse a XenCenter. El comando reescribe la clave MANAGEMENT_INTERFACE en /etc/xensource-inventory.

Si se especifica el nombre de dispositivo de una interfaz (que debe tener una dirección IP), el host XenServer se vuelve a enlazar inmediatamente. Este comando funciona tanto en modo normal como de emergencia.

Si se especifica el UUID de un objeto PIF, el host XenServer determina a qué dirección IP debe volverse a enlazar. No debe estar en modo de emergencia cuando se ejecuta este comando.

Advertencia:

Tenga cuidado al usar este comando CLI fuera del host y asegúrese de tener conectividad de red en la nueva interfaz. Use xe pif-reconfigure para configurar una primero. De lo contrario, los comandos CLI posteriores no podrán llegar al host XenServer.

host-power-on

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

Enciende los hosts XenServer con la función Host Power On habilitada. Antes de usar este comando, habilite host-set-power-on en el host.

host-reboot

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

Reinicia los hosts XenServer especificados. Los hosts especificados deben deshabilitarse primero usando el comando xe host-disable, de lo contrario se mostrará un mensaje de error HOST_IN_USE.

Los hosts en los que se realizará esta operación se seleccionan utilizando el mecanismo de selección estándar (consulte selectores de host arriba). Los argumentos opcionales pueden ser cualquier número de los parámetros de host enumerados al principio de esta sección.

Si los hosts XenServer especificados son miembros de un grupo, la pérdida de conectividad al apagarse se gestiona y el grupo se recupera cuando los hosts XenServer vuelven. Los otros miembros y el coordinador del grupo continúan funcionando.

Si apaga el coordinador del grupo, el grupo queda inactivo hasta que ocurra una de las siguientes acciones:

• Convierte a uno de los miembros en el coordinador del grupo.

• El coordinador del grupo original se reinicia y vuelve a estar en línea.

  Cuando el coordinador del grupo vuelve a estar en línea, los miembros se reconectan y sincronizan con el coordinador del grupo.

host-restore

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

Restaure una copia de seguridad denominada file-name del software de control del host XenServer. El uso de la palabra “restaurar” aquí no significa una restauración completa en el sentido habitual, sino que simplemente significa que el archivo de copia de seguridad comprimido se ha descomprimido y desempaquetado en la partición secundaria. Después de haber realizado un xe host-restore, debe arrancar el CD de instalación y usar su opción Restaurar desde copia de seguridad.

Los hosts en los que realizar esta operación se seleccionan mediante el mecanismo de selección estándar (consulte selectores de host más arriba). Los argumentos opcionales pueden ser cualquier número de los parámetros de host enumerados al principio de esta sección.

host-send-debug-keys

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

Envía las claves de depuración del hipervisor especificadas al host especificado.

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

Instale un certificado TLS en un host XenServer.

host-set-hostname-live

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

Cambie el nombre de host del host XenServer especificado por host-uuid. Este comando establece de forma persistente tanto el nombre de host en la base de datos del dominio de control como el nombre de host real de Linux del host XenServer. El valor de host-name no es el mismo que el valor del campo name_label.

host-set-power-on-mode

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

Se utiliza para habilitar la función Encendido del host en hosts XenServer que son compatibles con soluciones de alimentación remota. Al usar el comando host-set-power-on, debe especificar el tipo de solución de administración de energía en el host (es decir, el modo de encendido). Luego, especifique las opciones de configuración usando el argumento power-on-config y sus pares clave-valor asociados.

Para usar la función de secretos para almacenar su contraseña, especifique la clave "power_on_password_secret". Para obtener más información, consulte Secretos.

host-shutdown

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

Apague los hosts XenServer especificados. Los hosts XenServer especificados deben deshabilitarse primero usando el comando xe host-disable, de lo contrario se mostrará un mensaje de error HOST_IN_USE.

Los hosts en los que realizar esta operación se seleccionan mediante el mecanismo de selección estándar (consulte selectores de host más arriba). Los argumentos opcionales pueden ser cualquier número de los parámetros de host enumerados al principio de esta sección.

Si los hosts de XenServer especificados son miembros de un pool, la pérdida de conectividad al apagarse se gestiona y el pool se recupera cuando los hosts de XenServer vuelven a estar operativos. Los demás miembros y el coordinador del pool siguen funcionando.

Si apaga el coordinador del pool, el pool quedará inactivo hasta que ocurra una de las siguientes acciones:

• Convierte a uno de los miembros en el coordinador del pool.

• El coordinador del pool original se reinicia y vuelve a estar en línea.

  Cuando el coordinador del pool vuelve a estar en línea, los miembros se reconectan y se sincronizan con el coordinador del pool.

Si HA está habilitado para el pool, uno de los miembros se convierte automáticamente en coordinador del pool. Si HA está deshabilitado, debe designar manualmente el host de XenServer deseado como coordinador del pool con el comando pool-designate-new-master. Para obtener más información, consulte pool-designate-new-master.

host-sm-dp-destroy

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

Intenta destruir y limpiar una ruta de datos de almacenamiento en un host. Si se proporciona allow-leak=true, elimina todos los registros de la ruta de datos, incluso si no se ha apagado limpiamente.

host-sync-data

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

Sincroniza los datos almacenados en el coordinador del pool con el host nombrado. Esto no incluye los datos de la base de datos).

host-syslog-reconfigure

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

Reconfigura el demonio syslog en los hosts de XenServer especificados. Este comando aplica la información de configuración definida en el parámetro logging del host.

Los hosts en los que se realizará esta operación se seleccionan utilizando el mecanismo de selección estándar (consulte selectores de host anterior). Los argumentos opcionales pueden ser cualquier número de los parámetros de host enumerados al principio de esta sección.

host-data-source-list

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

Enumera las fuentes de datos que se pueden registrar para un host.

Seleccione los hosts en los que desea realizar esta operación utilizando el mecanismo de selección estándar (consulte selectores de host). Los argumentos opcionales pueden ser cualquier número de los parámetros de host enumerados al principio de esta sección. Si no se proporcionan parámetros para seleccionar hosts, la operación se realiza en todos los hosts.

Las fuentes de datos tienen dos parámetros: standard y enabled. Este comando muestra los valores de los parámetros:

• Si una fuente de datos tiene enabled establecido en true, las métricas se están registrando actualmente en la base de datos de rendimiento.
• Si una fuente de datos tiene standard establecido en true, las métricas se registran en la base de datos de rendimiento por defecto. El valor de enabled también se establece en true para esta fuente de datos.
• Si una fuente de datos tiene standard establecido en false, las métricas no se registran en la base de datos de rendimiento por defecto. El valor de enabled también se establece en false para esta fuente de datos.

Para empezar a registrar métricas de la fuente de datos en la base de datos de rendimiento, ejecute el comando host-data-source-record. Este comando establece enabled en true. Para detenerlo, ejecute host-data-source-forget. Este comando establece enabled en false.

host-data-source-record

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

Registra la fuente de datos especificada para un host.

Esta operación escribe la información de la fuente de datos en la base de datos de métricas de rendimiento persistente de los hosts especificados. Por razones de rendimiento, esta base de datos es distinta de la base de datos normal del agente.

Seleccione los hosts en los que desea realizar esta operación utilizando el mecanismo de selección estándar (consulte selectores de host). Los argumentos opcionales pueden ser cualquier número de los parámetros de host enumerados al principio de esta sección. Si no se proporcionan parámetros para seleccionar hosts, la operación se realiza en todos los hosts.

host-data-source-forget

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

Detiene el registro de la fuente de datos especificada para un host y olvida todos los datos registrados.

Seleccione los hosts en los que desea realizar esta operación utilizando el mecanismo de selección estándar (consulte selectores de host). Los argumentos opcionales pueden ser cualquier número de los parámetros de host enumerados al principio de esta sección. Si no se proporcionan parámetros para seleccionar hosts, la operación se realiza en todos los hosts.

host-data-source-query

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

Muestra la fuente de datos especificada para un host.

Seleccione los hosts en los que realizar esta operación utilizando el mecanismo de selección estándar (consulte selectores de host). Los argumentos opcionales pueden ser cualquiera de los parámetros de host enumerados al principio de esta sección. Si no se proporcionan parámetros para seleccionar hosts, la operación se realiza en todos los hosts.

Comandos de mensajes

Comandos para trabajar con mensajes. Los mensajes se crean para notificar a los usuarios sobre eventos importantes y se muestran en XenCenter como alertas.

Los objetos de mensaje se pueden listar con el comando estándar de listado de objetos (xe message-list), y los parámetros se pueden manipular con los comandos de parámetros estándar. Para obtener más información, consulte Comandos de parámetros de bajo nivel

Parámetros de mensaje

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

Crea un mensaje.

message-destroy

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

Destruye un mensaje existente. Puede crear un script para destruir todos los mensajes. Por ejemplo:

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

Comandos de red

Comandos para trabajar con redes.

Los objetos de red se pueden listar con el comando de listado de objetos estándar (xe network-list), y los parámetros se pueden manipular con los comandos de parámetros estándar. Para obtener más información, consulte Comandos de parámetros de bajo nivel

Parámetros de red

Las redes tienen los siguientes parámetros:

network-create

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

Crea una red.

network-destroy

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

Destruye una red existente.

Comandos SR-IOV

Comandos para trabajar con SR-IOV.

Los objetos network-sriov se pueden listar con el comando estándar de listado de objetos (xe network-sriov-list) y los parámetros se pueden manipular con los comandos de parámetros estándar. Para obtener más información, consulte Comandos de parámetros de bajo nivel

Parámetros SR-IOV

SR-IOV tiene los siguientes parámetros:

network-sriov-create

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

Crea un objeto de red SR-IOV para un PIF físico dado y habilita SR-IOV en el PIF físico.

network-sriov-destroy

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

Elimina un objeto SR-IOV de red y deshabilita SR-IOV en su PIF físico.

Asignar una VF SR-IOV

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

Asigna una VF de una red SR-IOV a una VM.

Comandos del controlador SDN

Comandos para trabajar con el controlador SDN.

sdn-controller-forget

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

Introducir un controlador SDN.

sdn-controller-introduce

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

Eliminar un controlador SDN.

Comandos de túnel

Comandos para trabajar con túneles.

tunnel-create

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

Crear un nuevo túnel en un host.

tunnel-destroy

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

Destruir un túnel.

Comandos de parche

Comandos para trabajar con parches.

patch-apply

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

Aplicar el parche cargado previamente al host especificado.

patch-clean

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

Eliminar un archivo de parche cargado previamente.

patch-destroy

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

Eliminar un registro de parche no aplicado y los archivos del host.

patch-pool-apply

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

Aplicar el parche cargado previamente a todos los hosts del pool.

patch-pool-clean

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

Eliminar un archivo de parche cargado previamente en todos los hosts del pool.

patch-precheck

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

Ejecutar las comprobaciones previas contenidas en el parche cargado previamente al host especificado.

patch-upload

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

Cargar un archivo de parche al host.

Comandos PBD

Comandos para trabajar con PBD (dispositivos de bloque físicos). Los PBD son los objetos de software a través de los cuales el host de XenServer accede a los repositorios de almacenamiento (SR).

Los objetos PBD se pueden enumerar con el comando de enumeración de objetos estándar (xe pbd-list) y los parámetros se pueden manipular con los comandos de parámetros estándar. Para obtener más información, consulte Comandos de parámetros de bajo nivel

Parámetros PBD

Los PBD tienen los siguientes parámetros:

pbd-create

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

Cree un PBD en su host XenServer. El parámetro device-config de solo lectura solo se puede establecer en el momento de la creación.

Para agregar una asignación de ‘path’ a ‘/tmp’, asegúrese de que la línea de comandos contenga el argumento device-config:path=/tmp

Para obtener una lista completa de los pares clave-valor de device-config admitidos en cada tipo de SR, consulte Almacenamiento.

pbd-destroy

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

Destruya el PBD especificado.

pbd-plug

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

Intenta conectar el PBD al host XenServer. Si este comando se ejecuta correctamente, el SR referenciado (y los VDI que contiene) se vuelve visible para el host XenServer.

pbd-unplug

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

Intente desconectar el PBD del host XenServer.

Comandos PIF

Comandos para trabajar con PIF (objetos que representan las interfaces de red físicas).

Los objetos PIF se pueden listar con el comando de listado de objetos estándar (xe pif-list) y los parámetros se pueden manipular con los comandos de parámetros estándar. Para obtener más información, consulte Comandos de parámetros de bajo nivel

Parámetros PIF

Los PIF tienen los siguientes parámetros:

Nota:

Los cambios realizados en los campos other-config de una PIF solo surtirán efecto después de un reinicio. Alternativamente, utilice los comandos xe pif-unplug y xe pif-plug para que la configuración de la PIF se reescriba.

pif-forget

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

Destruir el objeto PIF especificado en un host determinado.

pif-introduce

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

Crear un objeto PIF que represente una interfaz física en el host XenServer especificado.

pif-plug

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

Intentar activar la interfaz física especificada.

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

Modificar la dirección IP de la PIF. Para la configuración de IP estática, establezca el parámetro mode en static, con los parámetros gateway, IP y netmask configurados con los valores adecuados. Para usar DHCP, establezca el parámetro mode en DHCP y deje los parámetros estáticos sin definir.

Nota:

El uso de direcciones IP estáticas en interfaces de red físicas conectadas a un puerto en un conmutador que utiliza el Protocolo de árbol de expansión (Spanning Tree Protocol) con STP Fast Link desactivado (o no compatible) da como resultado un período durante el cual no hay tráfico.

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

Reconfigurar la configuración de dirección IPv6 en una PIF.

pif-scan

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

Buscar nuevas interfaces físicas en su host XenServer.

pif-set-primary-address-type

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

Cambie el tipo de dirección principal utilizado por esta PIF.

pif-unplug

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

Intente desactivar la interfaz física especificada.

Comandos de grupo

Comandos para trabajar con grupos. Un grupo es un agregado de uno o más hosts de XenServer. Un grupo utiliza uno o más repositorios de almacenamiento compartidos para que las máquinas virtuales que se ejecutan en un host del grupo puedan migrarse en tiempo casi real a otro host del grupo. Esta migración se produce mientras la máquina virtual sigue en ejecución, sin necesidad de apagarla y volver a encenderla.

Cada host de XenServer es en realidad un grupo que consta de un único miembro de forma predeterminada. Cuando su host de XenServer se une a un grupo, se designa como miembro. Si el grupo al que se une el host consta de un único miembro, ese miembro se convierte en el coordinador del grupo. Si el grupo al que se une el host ya tiene varios miembros, uno de ellos ya es el coordinador del grupo y lo sigue siendo cuando el nuevo host se une al grupo.

El objeto de grupo singleton se puede listar con el comando de listado de objetos estándar (xe pool-list). Sus parámetros se pueden manipular con los comandos de parámetros estándar. Para obtener más información, consulte Comandos de parámetros de bajo nivel

Parámetros del grupo

Los grupos tienen los siguientes parámetros:

pool-apply-edition

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

Aplique una edición en todo el pool. Los valores de edición incluyen “cloud”, “standard-per-socket” y “premium-per-socket”. En el futuro, solo se admitirá “cloud”.

pool-certificate-install

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

Instale un certificado TLS, en todo el pool.

pool-certificate-list

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

Listar todos los certificados TLS instalados en un pool.

pool-certificate-sync

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

Sincronizar los certificados TLS y las listas de revocación de certificados del coordinador del pool con los demás miembros del pool.

pool-certificate-uninstall

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

Desinstalar un certificado TLS.

pool-crl-install

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

Instalar una lista de revocación de certificados TLS, en todo el pool.

pool-crl-list

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

Listar todas las listas de revocación de certificados TLS instaladas.

pool-crl-uninstall

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

Desinstalar una lista de revocación de certificados TLS.

pool-deconfigure-wlb

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

Eliminar permanentemente la configuración para el equilibrio de carga de trabajo.

pool-designate-new-master

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

Indicar al host XenServer miembro especificado que se convierta en el coordinador (anteriormente llamado “maestro”) de un pool existente. Este comando realiza un traspaso ordenado del rol de coordinador del pool a otro host en el pool de recursos. Este comando solo funciona cuando el coordinador del pool actual está en línea. No es un reemplazo para los comandos de modo de emergencia que se enumeran a continuación.

pool-disable-external-auth

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

Deshabilita la autenticación externa en todos los hosts de un pool.

pool-disable-local-storage-caching

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

Deshabilita el almacenamiento en caché local en todo el pool.

pool-disable-redo-log

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

Deshabilita el registro de rehacer si está en uso, a menos que HA esté habilitado.

pool-dump-database

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

Descarga una copia de toda la base de datos del pool y la vuelca en un archivo en el cliente.

pool-enable-external-auth

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

Habilita la autenticación externa en todos los hosts de un pool. Tenga en cuenta que algunos valores de auth-type requerirán valores config: particulares.

pool-enable-local-storage-caching

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

Habilita el almacenamiento en caché local en todo el pool.

pool-enable-redo-log

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

Habilita el registro de rehacer en el SR dado si está en uso, a menos que HA esté habilitado.

pool-eject

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

Indica al host XenServer especificado que abandone un grupo existente.

pool-emergency-reset-master

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

Indica a un host miembro del grupo que restablezca su dirección de coordinador de grupo al nuevo valor e intente conectarse a él. No ejecute este comando en los coordinadores del grupo.

pool-emergency-transition-to-master

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

Indica a un host XenServer miembro que se convierta en el coordinador del grupo (anteriormente llamado “el maestro del grupo”). El host XenServer acepta este comando solo después de que el host haya pasado al modo de emergencia. El modo de emergencia significa que es miembro de un grupo cuyo coordinador ha desaparecido de la red y no se puede contactar después de un cierto número de reintentos.

Si la contraseña del host se ha modificado desde que el host se unió al grupo, este comando puede hacer que la contraseña del host se restablezca. Para obtener más información, consulte (Comandos de usuario).

pool-ha-enable

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

Habilite la alta disponibilidad en el grupo de recursos, utilizando el UUID de SR especificado como repositorio central de latidos de almacenamiento.

pool-ha-disable

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

Deshabilita la función de alta disponibilidad en el grupo de recursos.

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

Calcule el número máximo de fallos de host que se pueden tolerar con la configuración actual del grupo.

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

Calcule el número máximo de fallos de host que se pueden tolerar con las máquinas virtuales protegidas propuestas y suministradas.

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

Inicializar el equilibrio de carga de trabajo para el grupo actual con el servidor de equilibrio de carga de trabajo de destino.

pool-join

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

Indique a su host XenServer que se una a un grupo existente.

pool-management-reconfigure

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

Reconfigura la interfaz de administración de todos los hosts del grupo para usar la interfaz de red especificada, que es la interfaz que se utiliza para conectarse a XenCenter. El comando reescribe la clave MANAGEMENT_INTERFACE en /etc/xensource-inventory para todos los hosts del grupo.

Si se especifica el nombre de dispositivo de una interfaz (que debe tener una dirección IP), el coordinador del grupo XenServer se vuelve a enlazar inmediatamente. Este comando funciona tanto en modo normal como de emergencia.

A partir del UUID de red especificado, se identifica el UUID del objeto PIF y se asigna al host XenServer, lo que determina qué dirección IP se debe volver a enlazar a sí mismo. No debe estar en modo de emergencia cuando se ejecuta este comando.

Advertencia:

Tenga cuidado al usar este comando CLI fuera del host y asegúrese de tener conectividad de red en la nueva interfaz. Use xe pif-reconfigure para configurar una primero. De lo contrario, los comandos CLI posteriores no podrán llegar al host XenServer.

pool-recover-slaves

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

Indique al coordinador del grupo que intente restablecer la dirección de todos los miembros que se ejecutan actualmente en modo de emergencia. Este comando se usa normalmente después de que se haya usado pool-emergency-transition-to-master para establecer uno de los miembros como el nuevo coordinador del grupo.

pool-restore-database

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

Cargue una copia de seguridad de la base de datos (creada con pool-dump-database) en un grupo. Al recibir la carga, el coordinador del grupo se reinicia con la nueva base de datos.

También hay una opción de ejecución en seco, que le permite comprobar que la base de datos del grupo se puede restaurar sin realizar realmente la operación. Por defecto, dry-run está establecido en falso.

pool-retrieve-wlb-configuration

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

Recupera los criterios de optimización del pool del servidor de equilibrio de carga de trabajo.

pool-retrieve-wlb-diagnostics

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

Recupera los diagnósticos del servidor de equilibrio de carga de trabajo.

pool-retrieve-wlb-recommendations

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

Recupera las recomendaciones de migración de VM para el pool del servidor de equilibrio de carga de trabajo.

pool-retrieve-wlb-report

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

Recupera los informes del servidor de equilibrio de carga de trabajo.

pool-secret-rotate

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

Rota el secreto del pool.

El secreto del pool es un secreto compartido entre los hosts de XenServer en un pool que permite al host probar su pertenencia a un pool. Los usuarios con el rol de Administrador del pool pueden ver este secreto al conectarse al host a través de SSH. Rote el secreto del pool si uno de estos usuarios abandona su organización o pierde su rol de Administrador del pool.

pool-send-test-post

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

Envía el cuerpo dado al host y puerto dados, usando HTTPS, e imprime la respuesta. Esto se utiliza para depurar la capa TLS.

pool-send-wlb-configuration

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

Establece los criterios de optimización del pool para el servidor de equilibrio de carga de trabajo.

pool-sync-database

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

Fuerza la sincronización de la base de datos del pool en todos los hosts del pool de recursos. Este comando no es necesario en el funcionamiento normal, ya que la base de datos se replica automáticamente de forma regular. Sin embargo, el comando puede ser útil para garantizar que los cambios se repliquen rápidamente después de realizar un conjunto significativo de operaciones de CLI.

Establecer https-only

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

Habilita o deshabilita el bloqueo del puerto 80 en la interfaz de administración de los hosts de XenServer.

Comandos del acelerador PVS

Comandos para trabajar con el acelerador PVS.

pvs-cache-storage-create

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

Configura una caché PVS en un SR determinado para un host determinado.

pvs-cache-storage-destroy

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

Elimina una caché PVS.

pvs-proxy-create

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

Configura una VM/VIF para usar un proxy PVS.

pvs-proxy-destroy

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

Elimina (o desactiva) un proxy PVS para esta VIF/VM.

pvs-server-forget

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

Olvida un servidor 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-->

Introducir nuevo servidor PVS.

pvs-site-forget

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

Olvidar un sitio PVS.

pvs-site-introduce

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

Introducir nuevo sitio PVS.

Comandos del Administrador de almacenamiento

Comandos para controlar los complementos del Administrador de almacenamiento.

Los objetos del administrador de almacenamiento se pueden listar con el comando estándar de listado de objetos (xe sm-list). Los parámetros se pueden manipular con los comandos de parámetros estándar. Para obtener más información, consulte Comandos de parámetros de bajo nivel

Parámetros de SM

Los SM tienen los siguientes parámetros:

Administrar el acceso SSH en hosts y grupos

Descripción general

En XenServer 8.4, el acceso SSH a dom0 ahora está habilitado de forma predeterminada. Esta versión introduce la capacidad de controlar programáticamente el acceso SSH utilizando la XenAPI o la interfaz de línea de comandos (CLI) xe.

Esta mejora permite a los administradores gestionar el acceso SSH tanto a nivel de host individual como de todo el pool, eliminando la necesidad de interacción manual con cada consola de servidor.

Ventajas

• Gestión automatizada: Habilite o deshabilite SSH en hosts individuales o en todo un pool de forma programática.

• Sobrecarga administrativa reducida: Reduzca significativamente el esfuerzo administrativo manual necesario para gestionar el acceso SSH.

• Flujos de trabajo mejorados: Mejore los scripts de automatización y refuerce los flujos de trabajo de seguridad integrando el control SSH en los sistemas de gestión existentes.

Compatibilidad y advertencias

• Sin requisitos adicionales: Esta característica no requiere ninguna configuración adicional ni ajustes de compatibilidad específicos.

• Comportamiento del servicio: Deshabilitar SSH detendrá y deshabilitará el servicio sshd en el/los host(s) especificado(s).

• Sesiones existentes: Cualquier sesión SSH existente permanecerá activa e ininterrumpida incluso después de deshabilitar el servicio.

• Nuevas conexiones: Los nuevos intentos de conexión serán rechazados una vez que SSH esté deshabilitado.

• Operaciones a nivel de pool: Las operaciones realizadas en todo un pool continuarán incluso si uno o más hosts dentro del pool encuentran un fallo.

Se proporcionará un mensaje de resumen, detallando cualquier operación fallida.

Configuración de la CLI

Habilitar SSH en un host

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

Este comando inicia y habilita el servicio sshd en el host especificado. Para selectores host válidos, consulte Selectores de host .

Deshabilitar SSH en un host

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

Este comando detiene y deshabilita el servicio sshd en el host especificado.

Habilitar SSH en todos los hosts de un pool

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

Este comando inicia y habilita el servicio sshd en todos los hosts del pool actual.

Deshabilitar SSH en todos los hosts de un pool

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

Este comando detiene y deshabilita el servicio sshd en todos los hosts del pool actual.

Salida de ejemplo (operación a nivel de pool)

xe pool-enable-ssh

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

Si un host falla, el comando continúa procesando los hosts restantes e informa de los fallos al final.

Comandos de instantáneas

Comandos para trabajar con instantáneas.

snapshot-clone

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

Cree una nueva plantilla clonando una instantánea existente, utilizando la operación de clonación rápida de disco a nivel de almacenamiento cuando esté disponible.

snapshot-copy

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

Crear una nueva plantilla copiando una VM existente, pero sin usar la operación de clonación rápida de disco a nivel de almacenamiento (incluso si está disponible). Se garantiza que las imágenes de disco de la VM copiada son ‘imágenes completas’, es decir, no forman parte de una cadena CoW.

snapshot-destroy

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

Destruir una instantánea. Esto deja intacto el almacenamiento asociado a la instantánea. Para eliminar también el almacenamiento, use snapshot-uninstall.

snapshot-disk-list

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

Listar los discos en la(s) VM(s) seleccionada(s).

snapshot-export-to-template

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

Exportar una instantánea a nombre de archivo.

snapshot-reset-powerstate

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

Forzar el estado de energía de la VM a detenido solo en la base de datos del conjunto de herramientas de administración. Este comando se usa para recuperar una instantánea que está marcada como ‘suspendida’. Esta es una operación potencialmente peligrosa: debe asegurarse de que ya no necesita la imagen de memoria. Ya no podrá reanudar su instantánea.

snapshot-revert

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

Revertir una VM existente a un estado de punto de control o instantánea anterior.

snapshot-uninstall

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

Desinstalar una instantánea. Esta operación destruirá los VDI que estén marcados como RW y conectados solo a esta instantánea. Para simplemente destruir el registro de la VM, use snapshot-destroy.

Comandos de SR

Comandos para controlar SR (repositorios de almacenamiento).

Los objetos SR se pueden listar con el comando estándar de listado de objetos (xe sr-list), y los parámetros se pueden manipular con los comandos de parámetros estándar. Para obtener más información, consulte Comandos de parámetros de bajo nivel

Parámetros de SR

Los SR tienen los siguientes parámetros:

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

Crea un SR en el disco, lo introduce en la base de datos y crea un PBD que adjunta el SR al host de XenServer. Si shared se establece en true, se crea un PBD para cada host de XenServer en el grupo. Si shared no se especifica o se establece en false, se crea un PBD solo para el host de XenServer especificado con host-uuid.

Los parámetros exactos de device-config difieren según el type del dispositivo. Para obtener detalles de estos parámetros en los diferentes back-ends de almacenamiento, consulte Crear un SR.

sr-data-source-forget

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

Detener la grabación del origen de datos especificado para un SR y olvidar todos los datos registrados.

sr-data-source-list

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

Listar los orígenes de datos que se pueden grabar para un SR.

sr-data-source-query

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

Consultar el último valor leído de un origen de datos SR.

sr-data-source-record

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

Grabar el origen de datos especificado para un SR.

sr-destroy

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

Destruye el SR especificado en el host de XenServer.

sr-enable-database-replication

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

Habilita la replicación de la base de datos XAPI en el SR especificado (compartido).

sr-disable-database-replication

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

Deshabilita la replicación de la base de datos XAPI en el SR especificado.

sr-forget

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

El agente XAPI olvida una SR especificada en el host XenServer. Cuando el agente XAPI olvida una SR, esta se desvincula y no se puede acceder a las VDI que contiene, pero permanece intacta en el medio de origen (los datos no se pierden).

sr-introduce

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

Simplemente coloca un registro de SR en la base de datos. Utilice device-config para especificar parámetros adicionales en el formato device-config:parameter_key=parameter_value, por ejemplo:

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

Nota:

Este comando nunca se utiliza en el funcionamiento normal. Esta operación avanzada podría ser útil cuando una SR debe reconfigurarse como compartida después de su creación o para ayudar a recuperarse de varios escenarios de fallo.

sr-probe

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

Realiza un escaneo del backend, utilizando las claves device-config proporcionadas. Si el device-config está completo para el backend de la SR, este comando devuelve una lista de las SR presentes en el dispositivo, si las hay. Si los parámetros device-config son solo parciales, se realiza un escaneo específico del backend, devolviendo resultados que le guían para mejorar los parámetros device-config restantes. Los resultados del escaneo se devuelven como XML específico del backend, impreso en la CLI.

Los parámetros exactos de device-config difieren según el type del dispositivo. Para obtener detalles de estos parámetros en los diferentes backends de almacenamiento, consulte Almacenamiento.

sr-probe-ext

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

Realiza una sonda de almacenamiento. Los parámetros de configuración del dispositivo se pueden especificar, por ejemplo, como device-config:devs=/dev/sdb1. A diferencia de sr-probe, este comando devuelve los resultados en el mismo formato legible para cada tipo de SR.

sr-scan

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

Fuerza un escaneo de SR, sincronizando la base de datos XAPI con las VDI presentes en el sustrato de almacenamiento subyacente.

sr-update

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

Actualiza los campos del objeto SR en la base de datos.

lvhd-enable-thin-provisioning

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

Habilitar el aprovisionamiento ligero en un SR LVHD.

Comandos de sujeto

Comandos para trabajar con sujetos.

session-subject-identifier-list

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

Devolver una lista de todos los ID de sujeto de usuario de todas las sesiones existentes autenticadas externamente.

session-subject-identifier-logout

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

Cerrar todas las sesiones autenticadas externamente asociadas a un ID de sujeto de usuario.

session-subject-identifier-logout-all

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

Cerrar todas las sesiones autenticadas externamente.

subject-add

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

Añadir un sujeto a la lista de sujetos que pueden acceder al pool.

subject-remove

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

Eliminar un sujeto de la lista de sujetos que pueden acceder al pool.

subject-role-add

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

Añadir un rol a un sujeto.

subject-role-remove

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

Eliminar un rol de un sujeto.

secret-create

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

Crear un secreto.

secret-destroy

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

Destruir un secreto.

Comandos de tareas

Comandos para trabajar con tareas asíncronas de larga duración. Estos comandos son tareas como iniciar, detener y suspender una máquina virtual. Las tareas suelen estar compuestas por un conjunto de otras subtareas atómicas que, en conjunto, realizan la operación solicitada.

Los objetos de tarea se pueden listar con el comando estándar de listado de objetos (xe task-list), y los parámetros se pueden manipular con los comandos de parámetros estándar. Para obtener más información, consulte Comandos de parámetros de bajo nivel

Parámetros de tarea

Las tareas tienen los siguientes parámetros:

task-cancel

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

Indica a la tarea especificada que cancele y regrese.

Comandos de plantilla

Comandos para trabajar con plantillas de máquinas virtuales.

Las plantillas son esencialmente máquinas virtuales con el parámetro is-a-template establecido en true. Una plantilla es una “imagen de oro” que contiene todas las diversas configuraciones para instanciar una máquina virtual específica. XenServer se envía con un conjunto base de plantillas, que son máquinas virtuales “en bruto” genéricas que pueden arrancar un CD de instalación del proveedor del sistema operativo (por ejemplo: RHEL, CentOS, SLES, Windows). Puede crear máquinas virtuales, configurarlas en formatos estándar para sus necesidades particulares y guardar una copia de ellas como plantillas para su uso futuro en la implementación de máquinas virtuales.

Los objetos de plantilla se pueden listar con el comando de listado de objetos estándar (xe template-list) y los parámetros se pueden manipular con los comandos de parámetros estándar. Para obtener más información, consulte Comandos de parámetros de bajo nivel

Nota:

Las plantillas no se pueden convertir directamente en máquinas virtuales estableciendo el parámetro is-a-template en false. Establecer el parámetro is-a-template en false no es compatible y da como resultado una máquina virtual que no se puede iniciar.

Parámetros de plantilla de máquina virtual

Las plantillas tienen los siguientes parámetros:

• uuid (solo lectura) el identificador único/referencia de objeto para la plantilla
• name-label (lectura/escritura) el nombre de la plantilla
• name-description (lectura/escritura) la cadena de descripción de la plantilla
• user-version (lectura/escritura) cadena para que los creadores de máquinas virtuales y plantillas pongan información de versión

• is-a-template (lectura/escritura) verdadero si esta máquina virtual es una plantilla. Las máquinas virtuales de plantilla nunca se pueden iniciar, solo se utilizan para clonar otras máquinas virtuales. Una vez que este valor se ha establecido en verdadero, no se puede restablecer a falso. Las máquinas virtuales de plantilla no se pueden convertir en máquinas virtuales utilizando este parámetro.

  Puede convertir una máquina virtual en una plantilla con:

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

• is-control-domain (solo lectura) verdadero si se trata de un dominio de control (dominio 0 o un dominio de controlador)
• power-state (solo lectura) estado de energía actual. El valor siempre está detenido para una plantilla
• memory-dynamic-max (solo lectura) memoria máxima dinámica en bytes. Actualmente sin usar, pero si se cambia, se debe obedecer la siguiente restricción: memory_static_max >= memory_dynamic_max >= memory_dynamic_min >= memory_static_min.
• memory-dynamic-min (lectura/escritura) memoria mínima dinámica en bytes. Actualmente sin usar, pero si se cambia, deben obedecerse las mismas restricciones para memory-dynamic-max.
• memory-static-max (lectura/escritura) memoria máxima (absoluta) establecida estáticamente en bytes. Este campo es el valor principal utilizado para determinar la cantidad de memoria asignada a una VM.
• memory-static-min (lectura/escritura) memoria mínima (absoluta) establecida estáticamente en bytes. Este campo representa la memoria mínima absoluta, y memory-static-min debe ser menor que memory-static-max. Este valor no se utiliza en el funcionamiento normal, pero la restricción anterior debe obedecerse.
• suspend-VDI-uuid (solo lectura) el VDI donde se almacena una imagen de suspensión (no tiene significado para una plantilla)
• VCPUs-params (parámetro de mapa de lectura/escritura) parámetros de configuración para la política de vCPU seleccionada.
• VCPUs-max (lectura/escritura) número máximo de vCPU
• VCPUs-at-startup (lectura/escritura) número de vCPU de arranque
• actions-after-crash (lectura/escritura) acción a realizar cuando una VM basada en esta plantilla falla
• console-uuids (parámetro de conjunto de solo lectura) dispositivos de consola virtual

• platform (parámetro de mapa de lectura/escritura) configuración específica de la plataforma

  Para deshabilitar la emulación de un puerto paralelo para invitados:

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

  Para deshabilitar la emulación de un puerto serie:

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

  Para deshabilitar la emulación de un controlador USB y un dispositivo de tableta USB:

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

• allowed-operations (parámetro de conjunto de solo lectura) lista de las operaciones permitidas en este estado
• current-operations (parámetro de conjunto de solo lectura) lista de las operaciones que están actualmente en curso en esta plantilla
• allowed-VBD-devices (parámetro de conjunto de solo lectura) lista de identificadores VBD disponibles para su uso, representados por enteros del rango 0-254. Esta lista es solo informativa y se pueden usar otros dispositivos (pero es posible que no funcionen).
• allowed-VIF-devices (parámetro de conjunto de solo lectura) lista de identificadores VIF disponibles para su uso, representados por enteros del rango 0-6. Esta lista es solo informativa y se pueden usar otros dispositivos (pero es posible que no funcionen).
• HVM-boot-policy (lectura/escritura) la política de arranque para invitados. Puede ser BIOS Order o una cadena vacía.
• HVM-boot-params (parámetro de mapa de lectura/escritura) la clave de orden controla el orden de arranque del invitado, representado como una cadena donde cada carácter es un método de arranque: d para el CD/DVD, c para el disco raíz y n para el arranque PXE de red. El valor predeterminado es dc.
• PV-kernel (lectura/escritura) ruta al kernel
• PV-ramdisk (lectura/escritura) ruta a la initrd
• PV-args (lectura/escritura) cadena de argumentos de línea de comandos del kernel
• PV-legacy-args (lectura/escritura) cadena de argumentos para que las máquinas virtuales heredadas basadas en esta plantilla arranquen
• PV-bootloader (lectura/escritura) nombre o ruta al cargador de arranque
• PV-bootloader-args (lectura/escritura) cadena de argumentos varios para el cargador de arranque
• last-boot-CPU-flags (solo lectura) describe los indicadores de CPU con los que se arrancó por última vez una máquina virtual basada en esta plantilla; no se rellena para una plantilla
• resident-on (solo lectura) el host de XenServer en el que reside una máquina virtual basada en esta plantilla. Aparece como not in database para una plantilla
• affinity (lectura/escritura) el host de XenServer en el que una máquina virtual basada en esta plantilla tiene preferencia para ejecutarse. Utilizado por el comando xe vm-start para decidir dónde ejecutar la máquina virtual. También conocido como servidor principal.
• groups (lectura/escritura) el grupo de máquinas virtuales al que pertenece esta máquina virtual. Un grupo de máquinas virtuales define dónde XenServer intenta iniciar la máquina virtual o evacuarla.
• other-config (parámetro de mapa de lectura/escritura) lista de pares clave-valor que especifican parámetros de configuración adicionales para la plantilla
• start-time (solo lectura) marca de tiempo de la fecha y hora en que se leyeron las métricas de una VM basada en esta plantilla, en el formato yyyymmddThh:mm:ss z, donde z es el indicador de zona horaria militar de una sola letra, por ejemplo, Z para UTC(GMT). Se establece en 1 Jan 1970 Z (inicio de la época Unix/POSIX) para una plantilla
• install-time (solo lectura) marca de tiempo de la fecha y hora en que se leyeron las métricas de una VM basada en esta plantilla, en el formato yyyymmddThh:mm:ss z, donde z es el indicador de zona horaria militar de una sola letra, por ejemplo, Z para UTC (GMT). Se establece en 1 Jan 1970 Z (inicio de la época Unix/POSIX) para una plantilla
• memory-actual (solo lectura) la memoria real utilizada por una VM basada en esta plantilla; 0 para una plantilla
• VCPUs-number (solo lectura) el número de CPU virtuales asignadas a una VM basada en esta plantilla; 0 para una plantilla
• VCPUs-Utilization (parámetro de mapa de solo lectura) lista de CPU virtuales y su peso. os-version (parámetro de mapa de solo lectura) la versión del sistema operativo para una VM basada en esta plantilla. Aparece como not in database para una plantilla
• PV-drivers-version (parámetro de mapa de solo lectura) las versiones de los controladores paravirtualizados para una VM basada en esta plantilla. Aparece como not in database para una plantilla
• PV-drivers-detected (solo lectura) indicador de la última versión de los controladores paravirtualizados para una VM basada en esta plantilla. Aparece como not in database para una plantilla
• memory (parámetro de mapa de solo lectura) métricas de memoria informadas por el agente en una VM basada en esta plantilla. Aparece como not in database para una plantilla
• disks (parámetro de mapa de solo lectura) métricas de disco informadas por el agente en una VM basada en esta plantilla. Aparece como not in database para una plantilla
• networks (parámetro de mapa de solo lectura) métricas de red informadas por el agente en una VM basada en esta plantilla. Aparece como not in database para una plantilla
• other (parámetro de mapa de solo lectura) otras métricas informadas por el agente en una VM basada en esta plantilla. Aparece como not in database para una plantilla
• guest-metrics-last-updated (solo lectura) marca de tiempo cuando el agente invitado realizó la última escritura en estos campos. En el formato yyyymmddThh:mm:ss z, donde z es el indicador de zona horaria militar de una sola letra, por ejemplo, Z para UTC (GMT)
• actions-after-shutdown (lectura/escritura) acción a realizar después de que la VM se haya apagado
• actions-after-reboot (lectura/escritura) acción a realizar después de que la VM se haya reiniciado
• possible-hosts (solo lectura) lista de hosts que pueden alojar potencialmente la VM
• HVM-shadow-multiplier (lectura/escritura) multiplicador aplicado a la cantidad de sombra que se pone a disposición del invitado
• dom-id (solo lectura) ID de dominio (si está disponible, -1 en caso contrario)
• recommendations (solo lectura) Especificación XML de los valores y rangos recomendados para las propiedades de esta VM
• xenstore-data (parámetro de mapa de lectura/escritura) datos que se insertarán en el árbol xenstore (/local/domain/*domid*/vmdata) después de crear la VM.
• is-a-snapshot (solo lectura) El valor es verdadero si esta plantilla es una instantánea de VM
• snapshot_of (solo lectura) el UUID de la VM de la que esta plantilla es una instantánea
• snapshots (solo lectura) los UUID de cualquier instantánea que se haya tomado de esta plantilla
• snapshot_time (solo lectura) la marca de tiempo de la instantánea de VM más reciente tomada
• memory-target (solo lectura) la cantidad de memoria objetivo establecida para esta plantilla
• blocked-operations (parámetro de mapa de lectura/escritura) enumera las operaciones que no se pueden realizar en esta plantilla
• last-boot-record (solo lectura) registro de los últimos parámetros de arranque para esta plantilla, en formato XML
• ha-always-run (lectura/escritura) El valor es verdadero si una instancia de esta plantilla siempre se reinicia en otro host si falla el host en el que reside. Este parámetro está ahora obsoleto. Utilice el parámetro ha-restartpriority en su lugar.
• ha-restart-priority (solo lectura) almacén de datos binarios de blobs de lectura/escritura de reinicio o de mejor esfuerzo
• live (solo lectura) relevante solo para una VM en ejecución.

template-export

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

Exporta una copia de una plantilla especificada a un archivo con el nuevo nombre de archivo especificado.

template-uninstall

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

Desinstala una plantilla personalizada. Esta operación destruirá los VDI marcados como ‘propiedad’ de esta plantilla.

Comandos de actualización

La siguiente sección contiene comandos de actualización del host XenServer.

Los objetos de actualización se pueden listar con el comando de listado de objetos estándar (xe update-list), y los parámetros se pueden manipular con los comandos de parámetros estándar. Para obtener más información, consulte Comandos de parámetros de bajo nivel

Parámetros de actualización

Las actualizaciones del host XenServer tienen los siguientes parámetros:

update-upload

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

Carga un archivo de actualización especificado en el host de XenServer. Este comando prepara una actualización para ser aplicada. Si tiene éxito, se imprime el UUID de la actualización cargada. Si la actualización ya se ha cargado previamente, se devuelve UPDATE_ALREADY_EXISTS un error y el parche no se vuelve a cargar.

update-precheck

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

Ejecuta las comprobaciones previas contenidas en la actualización especificada en el host de XenServer especificado.

update-destroy

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

Elimina un archivo de actualización que no se ha aplicado del grupo. Se puede usar para eliminar un archivo de actualización que no se puede aplicar a los hosts.

update-apply

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

Aplicar el archivo de actualización especificado.

update-pool-apply

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

Aplicar la actualización especificada a todos los hosts de XenServer del pool.

update-introduce

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

Introducir VDI de actualización.

update-pool-clean

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

Elimina los archivos de la actualización de todos los hosts del pool.

Comandos de usuario

user-password-change

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

Cambia la contraseña del usuario que ha iniciado sesión. El campo de contraseña antigua no se comprueba porque se requiere privilegio de supervisor para usar este comando.

Comandos VBD

Comandos para trabajar con VBD (dispositivos de bloque virtuales).

Un VBD es un objeto de software que conecta una VM al VDI, que representa el contenido del disco virtual. El VBD tiene los atributos que vinculan el VDI a la VM (si es arrancable, sus métricas de lectura/escritura, etc.). El VDI tiene la información sobre los atributos físicos del disco virtual (qué tipo de SR, si el disco es compartible, si el medio es de lectura/escritura o solo lectura, etc.).

Los objetos VBD se pueden listar con el comando de listado de objetos estándar (xe vbd-list) y los parámetros se pueden manipular con los comandos de parámetros estándar. Para obtener más información, consulte Comandos de parámetros de bajo nivel

Parámetros VBD

Los VBD tienen los siguientes parámetros:

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

Crear un VBD en una VM.

Los valores permitidos para el campo device son enteros de 0 a 254, y el número debe ser único para cada VM. Los valores permitidos actuales se pueden ver en el parámetro allowed-VBD-devices de la VM especificada. Esto se ve como userdevice en los parámetros vbd.

Si el type es Disk, se requiere vdi-uuid. El modo puede ser RO o RW para un disco.

Si el type es CD, vdi-uuid es opcional. Si no se especifica ningún VDI, se crea un VBD vacío para el CD. El modo debe ser RO para un CD.

vbd-destroy

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

Destruir el VBD especificado.

Si el VBD tiene su parámetro other-config:owner establecido en true, el VDI asociado también se destruye.

vbd-eject

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

Quitar el medio de la unidad representada por un VBD. Este comando solo funciona si el medio es de tipo extraíble (un CD físico o una ISO). De lo contrario, se devuelve un mensaje de error VBD_NOT_REMOVABLE_MEDIA.

vbd-insert

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

Insertar nuevos medios en la unidad representada por un VBD. Este comando solo funciona si el medio es de un tipo extraíble (un CD físico o una ISO). De lo contrario, se devuelve un mensaje de error VBD_NOT_REMOVABLE_MEDIA.

vbd-plug

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

Intentar adjuntar el VBD mientras la VM está en estado de ejecución.

vbd-unplug

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

Intenta desasociar el VBD de la VM mientras esta se encuentra en estado de ejecución.

Comandos VDI

Comandos para trabajar con VDI (Imágenes de disco virtual).

Un VDI es un objeto de software que representa el contenido del disco virtual visto por una VM. Esto es diferente al VBD, que es un objeto que vincula una VM al VDI. El VDI contiene la información sobre los atributos físicos del disco virtual (qué tipo de SR, si el disco es compartible, si el medio es de lectura/escritura o solo lectura, y así sucesivamente). El VBD tiene los atributos que vinculan el VDI a la VM (si es arrancable, sus métricas de lectura/escritura, y así sucesivamente).

Los objetos VDI se pueden listar con el comando estándar de listado de objetos (xe vdi-list), y los parámetros se pueden manipular con los comandos de parámetros estándar. Para obtener más información, consulte Comandos de parámetros de bajo nivel

Parámetros VDI

Los VDI tienen los siguientes parámetros:

vdi-clone

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

Cree una copia nueva y grabable del VDI especificado que se pueda usar directamente. Es una variante de vdi-copy que puede exponer funciones de clonación de imágenes de alta velocidad donde existan.

Utilice el parámetro de mapa opcional driver-params para pasar información de configuración adicional específica del proveedor al controlador de almacenamiento de back-end en el que se basa el VDI. Para obtener más información, consulte la documentación del controlador del proveedor de almacenamiento.

vdi-copy

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

Copiar un VDI a un SR especificado.

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

Crear un VDI.

El parámetro virtual-size se puede especificar en bytes o utilizando los sufijos estándar IEC KiB, MiB, GiB y TiB.

Nota:

Los tipos de SR que admiten el aprovisionamiento ligero de discos (como VHD local y NFS) no aplican la asignación virtual de discos. Tenga mucho cuidado al asignar en exceso espacio de disco virtual en un SR. Si un SR con asignación excesiva se llena, el espacio en disco debe liberarse en el sustrato de destino del SR o eliminando los VDI no utilizados en el SR.

Algunos tipos de SR podrían redondear el valor virtual-size para que sea divisible por un tamaño de bloque configurado.

vdi-data-destroy

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

Destruir los datos asociados con el VDI especificado, pero conservar los metadatos de seguimiento de bloques modificados.

Nota:

Si utiliza el seguimiento de bloques modificados para realizar copias de seguridad incrementales del VDI, asegúrese de utilizar el comando vdi-data-destroy para eliminar instantáneas pero conservar los metadatos. No utilice vdi-destroy en instantáneas de VDI que tengan habilitado el seguimiento de bloques modificados.

vdi-destroy

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

Destruir el VDI especificado.

Nota:

Si utiliza el seguimiento de bloques modificados para realizar copias de seguridad incrementales del VDI, asegúrese de utilizar el comando vdi-data-destroy para eliminar instantáneas pero conservar los metadatos. No utilice vdi-destroy en instantáneas de VDI que tengan habilitado el seguimiento de bloques modificados.

Para los tipos de SR Local VHD y NFS, el espacio en disco no se libera inmediatamente en vdi-destroy, sino periódicamente durante una operación de escaneo del repositorio de almacenamiento. Si debe forzar que el espacio en disco eliminado esté disponible, llame a sr-scan manualmente.

vdi-disable-cbt

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

Deshabilite el seguimiento de bloques modificados para el VDI.

vdi-enable-cbt

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

Habilite el seguimiento de bloques modificados para el VDI.

Nota:

Puede habilitar el seguimiento de bloques modificados solo en instancias con licencia de XenServer Premium Edition.

vdi-export

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

Exporte un VDI al nombre de archivo especificado. Puede exportar un VDI en uno de los siguientes formatos:

• raw
• vhd

El formato VHD puede ser disperso. Si hay bloques no asignados dentro del VDI, estos bloques pueden omitirse del archivo VHD, lo que hace que el archivo VHD sea más pequeño. Puede exportar a formato VHD desde todos los tipos de almacenamiento basados en VHD compatibles (EXT3/EXT4, NFS).

Si especifica el parámetro base, este comando exporta solo aquellos bloques que han cambiado entre el VDI exportado y el VDI base.

vdi-forget

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

Elimina incondicionalmente un registro VDI de la base de datos sin tocar el back-end de almacenamiento. En funcionamiento normal, use vdi-destroy en su lugar.

vdi-import

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

Importar un VDI. Puede importar un VDI desde uno de los siguientes formatos:

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

Cree un objeto VDI que represente un dispositivo de almacenamiento existente, sin modificar ni crear realmente ningún almacenamiento. Este comando se utiliza principalmente de forma interna para introducir automáticamente dispositivos de almacenamiento de conexión en caliente.

vdi-list-changed-blocks

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

Compare dos VDI y devuelva la lista de bloques que han cambiado entre ambos como una cadena codificada en base64. Este comando solo funciona para VDI que tienen habilitado el seguimiento de bloques modificados.

Para obtener más información, consulte Seguimiento de bloques modificados.

vdi-pool-migrate

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

Migre un VDI a un SR especificado, mientras el VDI está conectado a un invitado en ejecución. (Migración en vivo de almacenamiento)

Para obtener más información, consulte Migrar máquinas virtuales.

vdi-resize

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

Cambie el tamaño del VDI especificado por UUID.

vdi-snapshot

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

Produce una versión de lectura y escritura de un VDI que se puede usar como referencia para fines de copia de seguridad o creación de plantillas, o ambos. Use la instantánea para realizar una copia de seguridad en lugar de instalar y ejecutar software de copia de seguridad dentro de la VM. La VM continúa ejecutándose mientras el software de copia de seguridad externo transmite el contenido de la instantánea al medio de copia de seguridad. De manera similar, una instantánea se puede usar como una “imagen dorada” sobre la cual basar una plantilla. Se puede crear una plantilla usando cualquier VDI.

Use el parámetro opcional driver-params para pasar información de configuración adicional específica del proveedor al controlador de almacenamiento de back-end en el que se basa el VDI. Para obtener más información, consulte la documentación del controlador del proveedor de almacenamiento.

Un clon de una instantánea siempre produce un VDI grabable.

vdi-unlock

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

Intenta desbloquear los VDI especificados. Si se pasa force=true al comando, fuerza la operación de desbloqueo.

vdi-update

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

Actualice los campos del objeto VDI en la base de datos.

Comandos VIF

Comandos para trabajar con VIF (interfaces de red virtuales).

Los objetos VIF se pueden listar con el comando de listado de objetos estándar (xe vif-list), y los parámetros se pueden manipular con los comandos de parámetros estándar. Para obtener más información, consulte Comandos de parámetros de bajo nivel

Parámetros VIF

Los VIF tienen los siguientes parámetros:

• uuid (solo lectura) el identificador único/referencia de objeto para el VIF
• vm-uuid (solo lectura) el identificador único/referencia de objeto para la VM en la que reside este VIF
• vm-name-label (solo lectura) el nombre de la VM en la que reside este VIF
• allowed-operations (parámetro de conjunto de solo lectura) una lista de las operaciones permitidas en este estado
• current-operations (parámetro de conjunto de solo lectura) una lista de las operaciones que están actualmente en curso en esta VIF
• device (solo lectura) etiqueta entera de esta VIF, que indica el orden en que se crearon los back-ends de la VIF
• MAC (solo lectura) dirección MAC de la VIF, tal como se expone a la VM

• MTU (solo lectura) Unidad de Transmisión Máxima de la VIF en bytes.

  Este parámetro es de solo lectura, pero puede anular la configuración de MTU con la clave mtu utilizando el parámetro de mapa other-config. Por ejemplo, para restablecer la MTU en una NIC virtual para usar tramas jumbo:

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

• currently-attached (solo lectura) verdadero si el dispositivo está conectado
• qos_algorithm_type (lectura/escritura) algoritmo de QoS a utilizar
• qos_algorithm_params (parámetro de mapa de lectura/escritura) parámetros para el algoritmo de QoS elegido
• qos_supported_algorithms (parámetro de conjunto de solo lectura) algoritmos de QoS compatibles para esta VIF
• MAC-autogenerated (solo lectura) El valor es verdadero si la dirección MAC de la VIF se generó automáticamente
• other-config (parámetro de mapa de lectura/escritura) pares de key:value de configuración adicional
• other-config:ethtoolrx (lectura/escritura) establecido en ‘on’ para habilitar la suma de comprobación de recepción, ‘off’ para deshabilitar
• other-config:ethtooltx (lectura/escritura) establecido en ‘on’ para habilitar la suma de comprobación de transmisión, ‘off’ para deshabilitar
• other-config:ethtoolsg (lectura/escritura) establecido en ‘on’ para habilitar la dispersión/recopilación, ‘off’ para deshabilitar
• other-config:ethtooltso (lectura/escritura) establecido en ‘on’ para habilitar la descarga de segmentación TCP, ‘off’ para deshabilitar
• other-config:ethtoolufo (lectura/escritura) establecido en ‘on’ para habilitar la descarga de fragmentos UDP, ‘off’ para deshabilitar
• other-config:ethtoolgso (lectura/escritura) establecido en ‘on’ para habilitar la descarga de segmentación genérica, ‘off’ para deshabilitar
• other-config:promiscuous (lectura/escritura) ‘true’ para que una VIF sea promiscua en el puente, de modo que vea todo el tráfico a través del puente. Útil para ejecutar un Sistema de Detección de Intrusiones (IDS) o similar en una VM.
• network-uuid (solo lectura) el identificador único/referencia de objeto de la red virtual a la que está conectada esta VIF
• network-name-label (solo lectura) el nombre descriptivo de la red virtual a la que está conectada esta VIF
• io_read_kbs (solo lectura) tasa de lectura promedio en kB/s para esta VIF
• io_write_kbs (solo lectura) tasa de escritura promedio en kB/s para esta VIF
• locking_mode (lectura/escritura) Afecta la capacidad de la VIF para filtrar el tráfico hacia/desde una lista de direcciones MAC e IP. Requiere parámetros adicionales.

• locking_mode:default (lectura/escritura) Varía según el modo de bloqueo predeterminado para la red VIF.

  Si el modo de bloqueo predeterminado se establece en disabled, XenServer aplica una regla de filtrado para que la VIF no pueda enviar ni recibir tráfico. Si el modo de bloqueo predeterminado se establece en unlocked, XenServer elimina todas las reglas de filtrado asociadas con la VIF. Para obtener más información, consulte Comandos de red.

• locking_mode:locked (lectura/escritura) Solo se permite en la VIF el tráfico enviado a o desde las direcciones MAC e IP especificadas. Si no se especifican direcciones IP, no se permite ningún tráfico.
• locking_mode:unlocked (lectura/escritura) No se aplican filtros a ningún tráfico que vaya hacia o desde la VIF.
• locking_mode:disabled (lectura/escritura) XenServer aplica una regla de filtrado para que la VIF descarte todo el tráfico.

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

Crear una VIF en una VM.

Los valores apropiados para el campo device se enumeran en el parámetro allowed-VIF-devices en la VM especificada. Antes de que existan VIFs allí, los valores permitidos son enteros del 0 al 6.

El parámetro mac es la dirección MAC estándar en el formato aa:bb:cc:dd:ee:ff. Si lo deja sin especificar, se crea una dirección MAC aleatoria apropiada. También puede establecer explícitamente una dirección MAC aleatoria especificando mac=random.

vif-destroy

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

Destruir una VIF.

vif-move

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

Mover la VIF a otra red.

vif-plug

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

Intentar adjuntar la VIF mientras la VM está en estado de ejecución.

vif-unplug

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

Intenta desvincular la VIF de la VM mientras está en ejecución.

vif-configure-ipv4

Configurar los ajustes de IPv4 para esta interfaz virtual. Establezca los ajustes de IPv4 como se indica a continuación:

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

Por ejemplo:

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

Limpiar los ajustes de IPv4 como se indica a continuación:

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

vif-configure-ipv6

Configure los ajustes de IPv6 para esta interfaz virtual. Establezca los ajustes de IPv6 como se indica a continuación:

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

Por ejemplo:

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

Limpie los ajustes de IPv6 como se indica a continuación:

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

Comandos de VLAN

Comandos para trabajar con VLAN (redes virtuales). Para enumerar y editar interfaces virtuales, consulte los comandos PIF, que tienen un parámetro VLAN para indicar que tienen una red virtual asociada. Para obtener más información, consulte Comandos PIF. Por ejemplo, para enumerar las VLAN, utilice xe pif-list.

vlan-create

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

Cree una VLAN en su host XenServer.

pool-vlan-create

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

Cree una VLAN en todos los hosts de un grupo determinando en qué interfaz (por ejemplo, eno12429np0) se encuentra la red especificada para cada host y, a continuación, creando y conectando un nuevo objeto PIF en cada host en consecuencia.

vlan-destroy

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

Destruya una VLAN. Requiere el UUID del PIF que representa la VLAN.

Comandos de VM

Comandos para controlar las VM y sus atributos.

Selectores de VM

Varios de los comandos que se enumeran aquí tienen un mecanismo común para seleccionar una o varias máquinas virtuales en las que realizar la operación. La forma más sencilla es proporcionando el argumento vm=name_or_uuid. Una forma fácil de obtener el UUID de una máquina virtual real es, por ejemplo, ejecutar xe vm-list power-state=running. (Obtenga la lista completa de campos que se pueden hacer coincidir usando el comando xe vm-list params=all.) Por ejemplo, especificar power-state=halted selecciona las máquinas virtuales cuyo parámetro power-state es igual a halted. Cuando coinciden varias máquinas virtuales, especifique la opción --multiple para realizar la operación. La lista completa de parámetros que se pueden hacer coincidir se describe al principio de esta sección.

Los objetos de VM se pueden enumerar con el comando estándar de enumeración de objetos (xe vm-list), y los parámetros se pueden manipular con los comandos de parámetros estándar. Para obtener más información, consulte Comandos de parámetros de bajo nivel

Parámetros de VM

Las máquinas virtuales tienen los siguientes parámetros:

Nota:

Todos los valores de parámetros de VM grabables se pueden cambiar mientras la VM está en ejecución, pero los nuevos parámetros no se aplican dinámicamente y no se pueden aplicar hasta que se reinicie la VM.

• appliance (lectura/escritura) el dispositivo/vApp al que pertenece la VM
• uuid (solo lectura) el identificador único/referencia de objeto para la VM
• name-label (lectura/escritura) el nombre de la VM
• name-description (lectura/escritura) la cadena de descripción de la VM
• order (lectura/escritura) para el inicio/apagado de vApp y para el inicio después de la conmutación por error de HA. Las máquinas virtuales con un valor de orden de 0 (cero) se inician primero, luego las máquinas virtuales con un valor de orden de 1, y así sucesivamente.
• version (solo lectura) el número de veces que se ha recuperado esta VM. Si desea sobrescribir una nueva VM con una versión anterior, llame a vm-recover
• user-version (lectura/escritura) cadena para que los creadores de máquinas virtuales y plantillas pongan información de versión

• is-a-template (lectura/escritura) El valor es falso a menos que esta VM sea una plantilla. Las VM de plantilla nunca se pueden iniciar, solo se utilizan para clonar otras VM. Una vez que este valor se ha establecido en verdadero, no se puede restablecer a falso. Las VM de plantilla no se pueden convertir en VM usando este parámetro.

  Puede convertir una VM en una plantilla con:

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

• is-control-domain (solo lectura) El valor es verdadero si se trata de un dominio de control (dominio 0 o un dominio de controlador)
• power-state (solo lectura) estado de energía actual
• start-delay (lectura/escritura) el retardo a esperar antes de que una llamada para iniciar la VM devuelva en segundos
• shutdown-delay (lectura/escritura) el retardo a esperar antes de que una llamada para apagar la VM devuelva en segundos
• memory-dynamic-max (lectura/escritura) máximo dinámico en bytes
• memory-dynamic-min (lectura/escritura) mínimo dinámico en bytes
• memory-static-max (lectura/escritura) máximo establecido estáticamente (absoluto) en bytes. Si desea cambiar este valor, la VM debe estar apagada.
• memory-static-min (lectura/escritura) mínimo establecido estáticamente (absoluto) en bytes. Si desea cambiar este valor, la VM debe estar apagada.
• suspend-VDI-uuid (solo lectura) el VDI en el que se almacena una imagen de suspensión
• VCPUs-params (parámetro de mapa de lectura/escritura) parámetros de configuración para la política de vCPU seleccionada.
• VCPUs-max (lectura/escritura) número máximo de CPU virtuales.
• VCPUs-at-startup (lectura/escritura) número de CPU virtuales de arranque
• actions-after-crash (lectura/escritura) acción a realizar si la VM falla. Para invitados PV, los parámetros válidos son:
  • preserve (solo para análisis)
  • coredump_and_restart (registrar un volcado de memoria y reiniciar la VM)
  • coredump_and_destroy (registrar un volcado de memoria y dejar la VM detenida)
  • restart (sin volcado de memoria y reiniciar la VM)
  • destroy (sin volcado de memoria y dejar la VM detenida)
• console-uuids (parámetro de solo lectura) dispositivos de consola virtual

• platform (parámetro de mapa de lectura/escritura) configuración específica de la plataforma

  Para deshabilitar VDA para cambiar Windows 10 al modo tableta:

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

  Para habilitar VDA para cambiar Windows 10 al modo tableta:

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

  Para comprobar el estado actual:

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

• allowed-operations (parámetro de solo lectura) lista de las operaciones permitidas en este estado
• current-operations (parámetro de solo lectura) una lista de las operaciones que están actualmente en curso en la VM
• allowed-VBD-devices (parámetro de solo lectura) lista de identificadores VBD disponibles para su uso, representados por enteros del rango 0–254. Esta lista es solo informativa, y se pueden usar otros dispositivos (pero podrían no funcionar).
• allowed-VIF-devices (parámetro de solo lectura) lista de identificadores VIF disponibles para su uso, representados por enteros del rango 0–6. Esta lista es solo informativa, y se pueden usar otros dispositivos (pero podrían no funcionar).
• HVM-boot-policy (lectura/escritura) la política de arranque para invitados. Puede ser BIOS Order o una cadena vacía.
• HVM-boot-params (parámetro de mapa de lectura/escritura) la clave de orden controla el orden de arranque del invitado, representada como una cadena donde cada carácter es un método de arranque: d para el CD/DVD, c para el disco raíz y n para el arranque PXE de red. El valor predeterminado es dc.
• HVM-shadow-multiplier (lectura/escritura) Valor de punto flotante que controla la cantidad de sobrecarga de memoria en la sombra que se concede a la VM. El valor predeterminado es 1.0 (el valor mínimo), y solo cambie este valor si es un usuario avanzado.
• PV-kernel (lectura/escritura) ruta al kernel
• PV-ramdisk (lectura/escritura) ruta a la initrd
• PV-args (lectura/escritura) cadena de argumentos de línea de comandos del kernel
• PV-legacy-args (lectura/escritura) cadena de argumentos para que las VM heredadas arranquen
• PV-bootloader (lectura/escritura) nombre o ruta al cargador de arranque
• PV-bootloader-args (lectura/escritura) cadena de argumentos varios para el cargador de arranque
• last-boot-CPU-flags (solo lectura) describe las banderas de CPU en las que se arrancó por última vez la VM
• resident-on (solo lectura) el host de XenServer en el que reside una VM
• affinity (lectura/escritura) El host de XenServer en el que la VM tiene preferencia para ejecutarse. Utilizado por el comando xe vm-start para decidir dónde ejecutar la VM. También conocido como el servidor principal.
• groups (lectura/escritura) el grupo de VM al que pertenece esta VM. Un grupo de VM define dónde XenServer intenta iniciar la VM o evacuarla.

• other-config (parámetro de mapa de lectura/escritura) Una lista de pares clave-valor que especifican parámetros de configuración adicionales para la VM.

  Por ejemplo, el par clave-valor other-config auto_poweron: true solicita iniciar la VM automáticamente después de que arranque cualquier host del pool. También debe establecer este parámetro en el other-config de su pool. Estos parámetros ahora están obsoletos. Utilice el parámetro ha-restart-priority en su lugar.

• start-time (solo lectura) marca de tiempo de la fecha y hora en que se leyeron las métricas de la VM. Esta marca de tiempo tiene el formato yyyymmddThh:mm:ss z, donde z es el indicador de zona horaria militar de una sola letra, por ejemplo, Z para UTC (GMT)
• install-time (solo lectura) marca de tiempo de la fecha y hora en que se leyeron las métricas de la VM. Esta marca de tiempo tiene el formato yyyymmddThh:mm:ss z, donde z es el indicador de zona horaria militar de una sola letra, por ejemplo, Z para UTC (GMT)
• memory-actual (solo lectura) la memoria real utilizada por una VM
• VCPUs-number (solo lectura) el número de CPU virtuales asignadas a la VM para una VM Linux. Este número puede diferir de VCPUS-max y se puede cambiar sin reiniciar la VM usando el comando vm-vcpu-hotplug. Para obtener más información, consulte vm-vcpu-hotplug. Las VM de Windows siempre se ejecutan con el número de vCPU establecido en VCPUsmax y deben reiniciarse para cambiar este valor. El rendimiento disminuye drásticamente cuando se establece VCPUs-number en un valor mayor que el número de CPU físicas en el host de XenServer.
• VCPUs-Utilization (parámetro de mapa de solo lectura) una lista de CPU virtuales y su peso
• os-version (parámetro de mapa de solo lectura) la versión del sistema operativo para la VM
• PV-drivers-version (parámetro de mapa de solo lectura) las versiones de los controladores paravirtualizados para la VM
• PV-drivers-detected (solo lectura) indicador de la última versión de los controladores paravirtualizados para la VM
• memory (parámetro de mapa de solo lectura) métricas de memoria informadas por el agente en la VM
• disks (parámetro de mapa de solo lectura) métricas de disco informadas por el agente en la VM
• networks (parámetro de mapa de solo lectura) métricas de red informadas por el agente en la VM
• other (parámetro de mapa de solo lectura) otras métricas informadas por el agente en la VM
• guest-metrics-lastupdated (solo lectura) marca de tiempo cuando el agente invitado realizó la última escritura en estos campos. La marca de tiempo tiene el formato yyyymmddThh:mm:ss z, donde z es el indicador de zona horaria militar de una sola letra, por ejemplo, Z para UTC (GMT)
• actions-after-shutdown (lectura/escritura) acción a realizar después de que la VM se haya apagado
• actions-after-reboot (lectura/escritura) acción a realizar después de que la VM se haya reiniciado
• possible-hosts hosts potenciales de esta VM (solo lectura)
• dom-id (solo lectura) ID de dominio (si está disponible, -1 en caso contrario)
• recommendations (solo lectura) especificación XML de valores y rangos recomendados para las propiedades de esta VM
• datos (parámetro de mapa de lectura/escritura) xenstore-data que se insertarán en el árbol xenstore (/local/domain/*domid*/vm-data) después de crear la VM
• is-a-snapshot (solo lectura) El valor es verdadero si esta VM es una instantánea
• snapshot_of (solo lectura) el UUID de la VM de la que es esta instantánea
• snapshots (solo lectura) los UUID de todas las instantáneas de esta VM
• snapshot_time (solo lectura) la marca de tiempo de la operación de instantánea que creó esta instantánea de VM
• memory-target (solo lectura) la cantidad de memoria objetivo establecida para esta VM
• blocked-operations (parámetro de mapa de lectura/escritura) enumera las operaciones que no se pueden realizar en esta VM
• last-boot-record (solo lectura) registro de los últimos parámetros de arranque para esta plantilla, en formato XML
• ha-always-run (lectura/escritura) El valor es verdadero si esta VM siempre se reinicia en otro host si falla el host en el que reside. Este parámetro está ahora obsoleto. Utilice el parámetro ha-restart-priority en su lugar.
• ha-restart-priority (lectura/escritura) reiniciar o mejor esfuerzo
• blobs (solo lectura) almacén de datos binarios
• live (solo lectura) El valor es verdadero si la VM se está ejecutando. El valor es falso si HA sospecha que la VM no se está ejecutando.

vm-assert-can-be-recovered

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

Comprueba si hay almacenamiento disponible para recuperar esta VM.

vm-call-plugin

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

Llama a la función dentro del complemento en la VM dada con argumentos opcionales (args:key=value). Para pasar una cadena de “valor” con caracteres especiales (por ejemplo, una nueva línea), se puede usar una sintaxis alternativa args:key:file=local_file, donde el contenido de local_file se recuperará y se asignará a “key” en su totalidad.

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

Añade un nuevo CD virtual a la VM seleccionada. Seleccione el parámetro device de 0 a 3.

La VM o las VMs en las que se realiza esta operación se seleccionan utilizando el mecanismo de selección estándar. Para obtener más información, consulte selectores de VM. Los argumentos opcionales pueden ser cualquiera de los parámetros de VM enumerados al principio de esta sección.

vm-cd-eject

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

Expulsa un CD de la unidad de CD virtual. Este comando solo funciona si hay exactamente un CD conectado a la VM. Cuando hay dos o más CDs, use el comando xe vbd-eject y especifique el UUID del VBD.

La VM o las VMs en las que se realiza esta operación se seleccionan utilizando el mecanismo de selección estándar. Para obtener más información, consulte selectores de VM. Los argumentos opcionales pueden ser cualquiera de los parámetros de VM enumerados al principio de esta sección.

vm-cd-insert

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

Inserta un CD en la unidad de CD virtual. Este comando solo funciona si hay exactamente un dispositivo de CD vacío conectado a la VM. Cuando hay dos o más dispositivos de CD vacíos, use el comando xe vbd-insert y especifique los UUID del VBD y del VDI a insertar.

La VM o las VMs en las que se realiza esta operación se seleccionan utilizando el mecanismo de selección estándar. Para obtener más información, consulte selectores de VM. Los argumentos opcionales pueden ser cualquiera de los parámetros de VM enumerados al principio de esta sección.

vm-cd-list

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

Enumera los CDs conectados a las VMs especificadas.

La VM o las VMs en las que se realiza esta operación se seleccionan utilizando el mecanismo de selección estándar. Para obtener más información, consulte selectores de VM. Los argumentos opcionales pueden ser cualquiera de los parámetros de VM enumerados al principio de esta sección.

También puede seleccionar qué parámetros de VBD y VDI listar.

vm-cd-remove

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

Elimine un CD virtual de las máquinas virtuales especificadas.

La máquina virtual o máquinas virtuales en las que se realiza esta operación se seleccionan mediante el mecanismo de selección estándar. Para obtener más información, consulte selectores de VM. Los argumentos opcionales pueden ser cualquier número de los parámetros de VM enumerados al principio de esta sección.

vm-checkpoint

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

Cree un punto de control de una máquina virtual existente, utilizando la operación de instantánea de disco rápida a nivel de almacenamiento cuando esté disponible.

vm-clone

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

Clone una máquina virtual existente, utilizando la operación de clonación de disco rápida a nivel de almacenamiento cuando esté disponible. Especifique el nombre y la descripción opcional para la máquina virtual clonada resultante utilizando los argumentos new-name-label y new-name-description.

La máquina virtual o máquinas virtuales en las que se realiza esta operación se seleccionan mediante el mecanismo de selección estándar. Para obtener más información, consulte selectores de VM. Los argumentos opcionales pueden ser cualquier número de los parámetros de VM enumerados al principio de esta sección.

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

Calcule la cantidad máxima de memoria estática que se puede asignar a una máquina virtual existente, utilizando la cantidad total de RAM física como límite superior. El parámetro opcional approximate reserva suficiente memoria adicional en el cálculo para tener en cuenta la adición de vCPU adicionales a la máquina virtual más adelante.

Por ejemplo:

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

Este comando utiliza el valor del parámetro memory-free devuelto por el comando xe host-list para establecer la memoria máxima de la máquina virtual denominada testvm.

La máquina virtual o máquinas virtuales en las que se realiza esta operación se seleccionan mediante el mecanismo de selección estándar. Para obtener más información, consulte selectores de VM. Los argumentos opcionales pueden ser cualquier número de los parámetros de VM enumerados al principio de esta sección.

vm-compute-memory-overhead

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

Calcula la sobrecarga de memoria de virtualización de una máquina virtual.

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

Copia una máquina virtual existente, pero sin utilizar la operación de clonación rápida de disco a nivel de almacenamiento (incluso si esta opción está disponible). Las imágenes de disco de la máquina virtual copiada están garantizadas como imágenes completas, es decir, no forman parte de una cadena de copia en escritura (CoW).

Especifique el nombre y la descripción opcional para la máquina virtual copiada resultante utilizando los argumentos new-name-label y new-name-description.

Especifique el SR de destino para la máquina virtual copiada resultante utilizando sr-uuid. Si no se especifica este parámetro, el destino es el mismo SR en el que se encuentra la máquina virtual original.

La máquina virtual o máquinas virtuales en las que se realiza esta operación se seleccionan mediante el mecanismo de selección estándar. Para obtener más información, consulte Selectores de VM. Los argumentos opcionales pueden ser cualquier número de los parámetros de VM enumerados al principio de esta sección.

vm-copy-bios-strings

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

Copia las cadenas de BIOS del host dado a la máquina virtual.

Nota:

Después de iniciar una máquina virtual por primera vez, no puede cambiar sus cadenas de BIOS. Asegúrese de que las cadenas de BIOS sean correctas antes de iniciar la máquina virtual por primera vez.

vm-crashdump-list

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

Enumera los volcados de memoria asociados con las máquinas virtuales especificadas.

Cuando utiliza el argumento opcional params, el valor de params es una cadena que contiene una lista de parámetros de este objeto que desea mostrar. Alternativamente, puede usar la palabra clave all para mostrar todos los parámetros. Si no se usa params, la lista devuelta muestra un subconjunto predeterminado de todos los parámetros disponibles.

La máquina virtual o máquinas virtuales en las que se realiza esta operación se seleccionan mediante el mecanismo de selección estándar. Para obtener más información, consulte Selectores de VM. Los argumentos opcionales pueden ser cualquier número de los parámetros de VM enumerados al principio de esta sección.

vm-data-source-list

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

Enumera las fuentes de datos que se pueden registrar para una máquina virtual.

Seleccione las máquinas virtuales en las que realizar esta operación utilizando el mecanismo de selección estándar. Para obtener más información, consulte Selectores de VM. Los argumentos opcionales pueden ser cualquier número de los parámetros de VM enumerados al principio de esta sección. Si no se proporcionan parámetros para seleccionar hosts, la operación se realiza en todas las máquinas virtuales.

Las fuentes de datos tienen dos parámetros – standard y enabled – que puede ver en la salida de este comando. Si una fuente de datos tiene enabled establecido en true, las métricas se están registrando actualmente en la base de datos de rendimiento. Si una fuente de datos tiene standard establecido en true, las métricas se registran en la base de datos de rendimiento de forma predeterminada (y enabled también se establece en true para esta fuente de datos). Si una fuente de datos tiene standard establecido en false, las métricas no se registran en la base de datos de rendimiento de forma predeterminada (y enabled también se establece en false para esta fuente de datos).

Para empezar a registrar las métricas de la fuente de datos en la base de datos de rendimiento, ejecute el comando vm-data-source-record. Este comando establece enabled en true. Para detenerlo, ejecute el comando vm-data-source-forget. Este comando establece enabled en false.

vm-data-source-record

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

Registra la fuente de datos especificada para una VM.

Esta operación escribe la información de la fuente de datos en la base de datos de métricas de rendimiento persistente de las máquinas virtuales especificadas. Por razones de rendimiento, esta base de datos es distinta de la base de datos del agente normal.

Seleccione las máquinas virtuales en las que desea realizar esta operación utilizando el mecanismo de selección estándar. Para obtener más información, consulte Selectores de VM. Los argumentos opcionales pueden ser cualquier número de los parámetros de VM enumerados al principio de esta sección. Si no se proporcionan parámetros para seleccionar hosts, la operación se realiza en todas las máquinas virtuales.

vm-data-source-forget

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

Deja de registrar la fuente de datos especificada para una VM y olvida todos los datos registrados.

Seleccione las máquinas virtuales en las que desea realizar esta operación utilizando el mecanismo de selección estándar. Para obtener más información, consulte Selectores de VM. Los argumentos opcionales pueden ser cualquier número de los parámetros de VM enumerados al principio de esta sección. Si no se proporcionan parámetros para seleccionar hosts, la operación se realiza en todas las máquinas virtuales.

vm-data-source-query

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

Muestra la fuente de datos especificada para una VM.

Seleccione las máquinas virtuales en las que desea realizar esta operación utilizando el mecanismo de selección estándar. Para obtener más información, consulte Selectores de VM. Los argumentos opcionales pueden ser cualquier número de los parámetros de VM enumerados al principio de esta sección. Si no se proporcionan parámetros para seleccionar hosts, la operación se realiza en todas las máquinas virtuales.

vm-destroy

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

Destruye la VM especificada. Esto deja intacto el almacenamiento asociado a la VM. Para eliminar también el almacenamiento, utilice xe vm-uninstall.

vm-disk-add

xe vm-disk-add disk-size=size_of_disk_to_add device=uuid_of_device [vm-selector=vm_selector_value...]
<!--NeedCopy-->

Añada un disco a las VM especificadas. Seleccione el parámetro device del valor del parámetro allowed-VBD-devices de las VM.

El parámetro disk-size se puede especificar en bytes o utilizando los sufijos estándar IEC KiB, MiB, GiB y TiB.

La VM o las VM en las que se realiza esta operación se seleccionan mediante el mecanismo de selección estándar. Para obtener más información, consulte selectores de VM. Los argumentos opcionales pueden ser cualquiera de los parámetros de VM enumerados al principio de esta sección.

vm-disk-list

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

Enumera los discos conectados a las VM especificadas. Los parámetros vbd-params y vdi-params controlan los campos de los objetos respectivos que se van a generar. Proporcione los parámetros como una lista separada por comas, o la clave especial all para la lista completa.

La VM o las VM en las que se realiza esta operación se seleccionan mediante el mecanismo de selección estándar. Para obtener más información, consulte selectores de VM. Los argumentos opcionales pueden ser cualquiera de los parámetros de VM enumerados al principio de esta sección.

vm-disk-remove

xe vm-disk-remove device=integer_label_of_disk [vm-selector=vm_selector_value...]
<!--NeedCopy-->

Elimine un disco de las VM especificadas y destrúyalo.

La VM o las VM en las que se realiza esta operación se seleccionan mediante el mecanismo de selección estándar. Para obtener más información, consulte selectores de VM. Los argumentos opcionales pueden ser cualquiera de los parámetros de VM enumerados al principio de esta sección.

vm-export

xe vm-export filename=export_filename [metadata=true|false] [vm-selector=vm_selector_value...]
<!--NeedCopy-->

Exporte las VM especificadas (incluidas las imágenes de disco) a un archivo en la máquina local. Especifique el nombre del archivo en el que exportar la VM utilizando el parámetro filename. Por convención, el nombre del archivo tiene una extensión .xva.

Si el parámetro metadata es true, los discos no se exportan. Solo los metadatos de la VM se escriben en el archivo de salida. Utilice este parámetro cuando el almacenamiento subyacente se transfiera a través de otros mecanismos y permita recrear la información de la VM. Para obtener más información, consulte vm-import.

La VM o las VM en las que se realiza esta operación se seleccionan mediante el mecanismo de selección estándar. Para obtener más información, consulte selectores de VM. Los argumentos opcionales pueden ser cualquiera de los parámetros de VM enumerados al principio de esta sección.

vm-import

xe vm-import filename=export_filename [metadata=true|false] [preserve=true|false][sr-uuid=destination_sr_uuid]
<!--NeedCopy-->

Importe una VM desde un archivo exportado previamente. Si preserve se establece en true, se conserva la dirección MAC de la VM original. El sr-uuid determina el SR de destino en el que importar la VM. Si no se especifica este parámetro, se utiliza el SR predeterminado.

Si el metadata es true, puede importar un conjunto de metadatos exportado previamente sin sus bloques de disco asociados. La importación solo de metadatos falla si no se encuentra ningún VDI (nombrado por SR y VDI.location), a menos que se especifique la opción --force, en cuyo caso la importación procede de todos modos. Si los discos se pueden duplicar o mover fuera de banda, la importación/exportación de metadatos es una forma rápida de mover máquinas virtuales entre grupos disjuntos. Por ejemplo, como parte de un plan de recuperación ante desastres.

Nota:

Las importaciones de varias máquinas virtuales se realizan más rápido en serie que en paralelo.

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

Instale o clone una máquina virtual a partir de una plantilla. Especifique el nombre de la plantilla utilizando el argumento template-uuid o template. Especifique un SR utilizando el argumento sr-uuid o sr-name-label. Especifique la instalación de medios bloqueados por BIOS utilizando el argumento copy-bios-strings-from.

Nota:

Al instalar desde una plantilla que tiene discos existentes, por defecto, se crean nuevos discos en el mismo SR que estos discos existentes. Cuando el SR lo admite, estos discos son copias rápidas. Si se especifica un SR diferente en la línea de comandos, los nuevos discos se crean allí. En este caso, una copia rápida no es posible y los discos son copias completas.

Al instalar desde una plantilla que no tiene discos existentes, los nuevos discos se crean en el SR especificado, o en el SR predeterminado del grupo cuando no se especifica un SR.

vm-is-bios-customized

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

Indica si las cadenas del BIOS de la máquina virtual se han personalizado.

vm-memory-dynamic-range-set

xe vm-memory-dynamic-range-set min=min max=max
<!--NeedCopy-->

Configure el rango de memoria dinámica de una máquina virtual. El rango de memoria dinámica define límites mínimos y máximos flexibles para la memoria de una máquina virtual. Es posible cambiar estos campos cuando una máquina virtual está en ejecución o detenida. El rango dinámico debe ajustarse al rango estático.

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

Configure los límites de memoria de una máquina virtual.

vm-memory-set

xe vm-memory-set memory=memory
<!--NeedCopy-->

Configure la asignación de memoria de una VM.

vm-memory-shadow-multiplier-set

xe vm-memory-shadow-multiplier-set [vm-selector=vm_selector_value...] [multiplier=float_memory_multiplier]
<!--NeedCopy-->

Establezca el multiplicador de memoria en la sombra para la VM especificada.

Esta es una opción avanzada que modifica la cantidad de memoria en la sombra asignada a una VM asistida por hardware.

En algunas cargas de trabajo de aplicaciones especializadas, como Citrix Virtual Apps™, se requiere memoria en la sombra adicional para lograr el rendimiento completo.

Esta memoria se considera una sobrecarga. Se separa de los cálculos de memoria normales para la contabilidad de la memoria de una VM. Cuando se invoca este comando, la cantidad de memoria de host libre disminuye según el multiplicador y el campo HVM_shadow_multiplier se actualiza con el valor que Xen ha asignado a la VM. Si no hay suficiente memoria de host de XenServer libre, se devuelve un error.

Las VM en las que se realizará esta operación se seleccionan mediante el mecanismo de selección estándar. Para obtener más información, consulte Selectores de VM.

vm-memory-static-range-set

xe vm-memory-static-range-set min=min max=max
<!--NeedCopy-->

Configure el rango de memoria estática de una VM. El rango de memoria estática define límites inferiores y superiores estrictos para la memoria de una VM. Es posible cambiar estos campos solo cuando una VM está detenida. El rango estático debe abarcar el rango dinámico.

vm-memory-target-set

xe vm-memory-target-set target=target
<!--NeedCopy-->

Establezca el objetivo de memoria para una VM detenida o en ejecución. El valor dado debe estar dentro del rango definido por los valores memory_static_min y memory_static_max de la VM.

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

Este comando migra las VM especificadas entre hosts físicos.

El parámetro compress anula el parámetro de grupo migration-compression para xe pool-param-set.

El parámetro host del comando vm-migrate puede ser el nombre o el UUID del host de XenServer. Por ejemplo, para migrar la VM a otro host del grupo, donde los discos de la VM están en un almacenamiento compartido por ambos hosts:

xe vm-migrate uuid=vm_uuid host-uuid=destination_host_uuid
<!--NeedCopy-->

Para mover máquinas virtuales entre hosts del mismo pool que no comparten almacenamiento (migración en vivo de almacenamiento):

xe vm-migrate uuid=vm_uuid host-uuid=destination_host_uuid \
    remote-master=192.0.2.35 remote-username=username remote-password=password
<!--NeedCopy-->

Para la migración en vivo de almacenamiento, debe proporcionar el nombre de host o la dirección IP, el nombre de usuario y la contraseña del coordinador del pool, incluso cuando migre dentro del mismo pool.

Puede elegir el SR donde se almacena cada VDI:

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

Además, puede elegir a qué red conectar la máquina virtual después de la migración:

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

Para la migración 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-->

Para obtener más información sobre la migración en vivo de almacenamiento, la migración en vivo y la migración en vivo de VDI, consulte Migrar máquinas virtuales.

Nota:

Si está actualizando desde una versión anterior de XenServer, es posible que deba apagar e iniciar todas las máquinas virtuales después de migrarlas, para asegurarse de que se apliquen las nuevas funciones de virtualización.

De forma predeterminada, la máquina virtual se suspende, se migra y se reanuda en el otro host. El parámetro live selecciona la migración en vivo. La migración en vivo mantiene la máquina virtual en ejecución mientras se realiza la migración, minimizando así el tiempo de inactividad de la máquina virtual. En algunas circunstancias, como cargas de trabajo con un uso de memoria extremadamente alto en la máquina virtual, la migración en vivo vuelve al modo predeterminado y suspende la máquina virtual por un corto tiempo antes de completar la transferencia de memoria.

La máquina virtual o las máquinas virtuales en las que se realiza esta operación se seleccionan mediante el mecanismo de selección estándar. Para obtener más información, consulte Selectores de máquinas virtuales. Los argumentos opcionales pueden ser cualquier número de los parámetros de máquina virtual enumerados al principio de esta sección.

vm-pause

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

Pausa una máquina virtual en ejecución. Tenga en cuenta que esta operación no libera la memoria asociada (consulte vm-suspend).

vm-reboot

xe vm-reboot [vm-selector=vm_selector_value...] [force=true]
<!--NeedCopy-->

Reinicia las máquinas virtuales especificadas.

La máquina virtual o las máquinas virtuales en las que se realiza esta operación se seleccionan mediante el mecanismo de selección estándar. Para obtener más información, consulte Selectores de máquinas virtuales. Los argumentos opcionales pueden ser cualquier número de los parámetros de máquina virtual enumerados al principio de esta sección.

Utilice el argumento force para provocar un reinicio no elegante. Donde el apagado es similar a desconectar un servidor físico.

vm-recover

xe vm-recover vm-uuid [database] [vdi-uuid] [force]
<!--NeedCopy-->

Recupera una VM de la base de datos contenida en el VDI suministrado.

vm-reset-powerstate

xe vm-reset-powerstate [vm-selector=vm_selector_value...] {force=true}
<!--NeedCopy-->

La VM o las VM en las que se realiza esta operación se seleccionan mediante el mecanismo de selección estándar. Para obtener más información, consulte selectores de VM. Los argumentos opcionales pueden ser cualquiera de los parámetros de VM enumerados al principio de esta sección.

Este es un comando avanzado que solo debe usarse cuando un host miembro de un grupo se cae. Puede usar este comando para forzar al coordinador del grupo a restablecer el estado de energía de las VM a halted. Esencialmente, este comando fuerza el bloqueo de la VM y sus discos para que pueda iniciarse a continuación en otro host del grupo. Esta llamada requiere que se especifique el indicador de fuerza, y falla si no está en la línea de comandos.

vm-restart-device-models

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

Reinicie el modelo de dispositivo para esta VM en el host. Mientras el modelo de dispositivo se reinicia, no puede detener, iniciar o migrar la VM. El usuario final de la VM podría ver una ligera pausa y reanudación en su sesión.

Nota:

Para que la acción de reiniciar el modelo de dispositivo sea compatible con una VM de Windows, la VM debe tener instaladas las XenServer VM Tools para Windows.

vm-resume

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

Reanudar las VM especificadas.

La VM o las VM en las que se realiza esta operación se seleccionan mediante el mecanismo de selección estándar. Para obtener más información, consulte selectores de VM. Los argumentos opcionales pueden ser cualquiera de los parámetros de VM enumerados al principio de esta sección.

Si la VM está en un SR compartido en un grupo de hosts, utilice el argumento on para especificar en qué miembro del grupo iniciarla. Por defecto, el sistema determina un host apropiado, que podría ser cualquiera de los miembros del grupo.

vm-retrieve-wlb-recommendations

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

Recupere las recomendaciones de equilibrio de carga de trabajo para la VM seleccionada.

vm-shutdown

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

Apague la VM especificada.

La VM o las VMs en las que se realiza esta operación se seleccionan mediante el mecanismo de selección estándar. Para obtener más información, consulte Selectores de VM. Los argumentos opcionales pueden ser cualquiera de los parámetros de VM enumerados al principio de esta sección.

Utilice el argumento force para provocar un apagado no elegante, similar a desconectar un servidor físico.

vm-snapshot

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

Cree una instantánea de una VM existente, utilizando la operación de instantánea de disco rápido a nivel de almacenamiento cuando esté disponible.

vm-start

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

Inicie las VMs especificadas.

La VM o las VMs en las que se realiza esta operación se seleccionan mediante el mecanismo de selección estándar. Para obtener más información, consulte Selectores de VM. Los argumentos opcionales pueden ser cualquiera de los parámetros de VM enumerados al principio de esta sección.

Si las VMs están en un SR compartido en un grupo de hosts, utilice el argumento on para especificar en qué miembro del grupo iniciar las VMs. Por defecto, el sistema determina un host apropiado, que podría ser cualquiera de los miembros del grupo.

vm-suspend

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

Suspenda la VM especificada.

La VM o las VMs en las que se realiza esta operación se seleccionan mediante el mecanismo de selección estándar. Para obtener más información, consulte Selectores de VM. Los argumentos opcionales pueden ser cualquiera de los parámetros de VM enumerados al principio de esta sección.

vm-uninstall

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

Desinstala una VM, destruyendo sus discos (aquellos VDI que están marcados como RW y conectados solo a esta VM) además de su registro de metadatos. Para destruir solo los metadatos de la VM, use xe vm-destroy.

La VM o VMs en las que se realiza esta operación se seleccionan utilizando el mecanismo de selección estándar. Para obtener más información, consulte Selectores de VM. Los argumentos opcionales pueden ser cualquier número de los parámetros de VM enumerados al principio de esta sección.

vm-unpause

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

Reanudar una VM en pausa.

vm-vcpu-hotplug

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

Ajusta dinámicamente el número de vCPU disponibles para una VM Linux en ejecución. El número de vCPU está limitado por el parámetro VCPUs-max. Las VM de Windows siempre se ejecutan con el número de vCPU establecido en VCPUs-max y deben reiniciarse para cambiar este valor.

Utilice el parámetro new-vcpus para definir el nuevo número total de vCPU que desea tener después de ejecutar este comando. No utilice este parámetro para pasar el número de vCPU que desea añadir. Por ejemplo, si tiene dos vCPU existentes en su VM y desea añadir dos vCPU más, especifique new-vcpus=4.

La VM Linux o las VM de Windows en las que se realiza esta operación se seleccionan utilizando el mecanismo de selección estándar. Para obtener más información, consulte Selectores de VM. Los argumentos opcionales pueden ser cualquier número de los parámetros de VM enumerados al principio de esta sección.

Nota:

Cuando ejecute VM Linux sin las herramientas de VM de XenServer instaladas, ejecute el siguiente comando en la VM como root para asegurarse de que se utilizan las vCPU recién conectadas en caliente: # for i in /sys/devices/system/cpu/cpu[1-9]*/online; do if [ "$(cat $i)" = 0 ]; then echo 1 > $i; fi; done

vm-vif-list

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

Enumera las VIF de las VM especificadas.

La VM o VMs en las que se realiza esta operación se seleccionan utilizando el mecanismo de selección estándar. Para obtener más información, consulte Selectores de VM. Los selectores operan en los registros de VM al filtrar, y no en los valores de VIF. Los argumentos opcionales pueden ser cualquier número de los parámetros de VM enumerados al principio de esta sección.

Instantáneas programadas

Comandos para controlar las instantáneas programadas de VM y sus atributos.

Los objetos vmss se pueden listar con el comando estándar de listado de objetos (xe vmss-list) y los parámetros se pueden manipular con los comandos de parámetros estándar. Para obtener más información, consulte Comandos de parámetros de bajo nivel

vmss-create

xe vmss-create enabled=true/false name-label=name type=type frequency=frequency retained-snapshots=value name-description=description schedule:schedule
<!--NeedCopy-->

Crea una programación de instantáneas en el pool.

Por ejemplo:

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

Las programaciones de instantáneas tienen los siguientes parámetros:

vmss-destroy

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

Destruye una programación de instantáneas en el pool.

Paso a través de USB

El paso a través de USB es compatible con las siguientes versiones de USB: 1.1, 2.0 y 3.0.

Habilitar/deshabilitar el paso a través de USB

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

Habilitar/deshabilitar el paso a través de USB.

pusb-scan

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

Escanear PUSB y actualizar.

vusb-create

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

Crea un USB virtual en el pool. Inicie la VM para pasar el USB a la VM.

vusb-unplug

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

Desconecta el USB de la VM.

vusb-destroy

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

Elimina la lista de USB virtuales de la VM.

Comandos de grupos de VM

Comandos para controlar grupos de VM y sus atributos.

Parámetros de grupos de VM

• uuid (solo lectura) el identificador único/referencia de objeto para la VM
• name-label (lectura/escritura) el nombre de la VM
• name-description (lectura/escritura) la cadena de descripción de la VM
• placement (solo lectura) el tipo de reglas de ubicación a aplicar a las VM del grupo. Los valores disponibles son anti-affinity y normal.

vm-group-list

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

Enumera todos los grupos de VM en este pool.

vm-group-create

xe vm-group-create placement=anti-affinity|normal name-label=<name-label> [name-description=<name-description>]
<!--NeedCopy-->

Crea un grupo de VM.

vm-group-destroy

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

Elimina este grupo de VM. Si elimina un grupo de VM que contiene VM, las VM ya no estarán asociadas a un grupo, pero no se verán afectadas de ninguna otra manera.