Citrix Hypervisor

Interfaz de la línea de comandos

La CLI xe le permite crear scripts y automatizar las tareas de administración del sistema. Use la CLI para integrar Citrix Hypervisor en una infraestructura de TI existente.

Introducción a la CLI xe

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

En su servidor Citrix Hypervisor

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

  • En XenCenter, vaya a la ficha Consola del servidor en el que quiera ejecutar el comando.
  • Utilice SSH en el servidor en el que quiera 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 los directorios al directorio en el que se encuentra el archivo xe.exe (normalmente C:\Program Files (x86)\Citrix\XenCenter). Si agrega la ubicación de instalación 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 nombrado client_install/xapi-xe-BUILD.x86_64.rpm en la ISO de instalación principal de Citrix Hypervisor.

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 servidor de Citrix Hypervisor, el nombre de usuario y la contraseña que se utilizarán al ejecutar los 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 xe remota en Linux puede bloquearse al intentar ejecutar comandos a través de una conexión segura y estos comandos implican la transferencia de archivos. Si es así, puede utilizar el comando --no-ssl a través de una conexión insegura con el servidor de Citrix Hypervisor.

Obtener ayuda con los comandos xe

La ayuda básica está disponible para los comandos de CLI en el host escribiendo lo siguiente:

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 xe básica

La sintaxis básica de todos los comandos de la CLI de Citrix Hypervisor 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 requeridos y la mayoría tienen algún 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 usan argumentos adicionales para conectarse y autenticarse. Estos argumentos también toman la forma argument=argument_value.

El argumento server se usa 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 usa esa contraseña para conectarse. (Todos los CR y LF finales al final del archivo se eliminan). 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 servidor de Citrix Hypervisor remoto (el valor predeterminado es 443).

Ejemplo: En el servidor de Citrix Hypervisor local:

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

Ejemplo: En un servidor de Citrix Hypervisor remoto:

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ñas
  • Puerto -p
  • -s servidor

Ejemplo: En un servidor de Citrix Hypervisor 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 servidor de Citrix Hypervisor 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 tiene que especificar los parámetros del servidor de Citrix Hypervisor remoto en cada comando xe que ejecute.

El uso de la variable de entorno XE_EXTRA_ARGS también permite la finalización de tabulaciones de comandos xe cuando se emiten contra un servidor de Citrix Hypervisor remoto, que está inhabilitado 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 use 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 se ignora.

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

Cuando utiliza la CLI en el servidor de Citrix Hypervisor, los comandos tienen una función de finalización de tabulación similar a la función del shell bash de Linux estándar. Por ejemplo, si escribe xe vm-l y, a continuación, pulsa la tecla TAB, se mostrará el resto del comando. Si comienza con más de un comando vm-l, al presionar TAB por segunda vez se muestran las posibilidades. Esta función es útil cuando se especifican los UUID de objetos en los comandos.

Nota:

La finalización de fichas normalmente no funciona cuando se ejecutan comandos en un servidor Citrix Hypervisor remoto. Sin embargo, si establece la variable XE_EXTRA_ARGS en la máquina en la que introduce los comandos, se habilita la finalización de tabulaciones. Para obtener más información, consulte Sintaxis xe básica.

Tipos de comandos

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

Los comandos de bajo nivel son:

  • class-list

  • clase-param-get

  • clase-param-set

  • class-param-list

  • clase-param-add

  • clase-param-remove

  • clase-param-clear

Donde class es una de las siguientes:

  • 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 de comandos más pequeño.

Tipos de parámetros

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

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

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

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

Los otros dos tipos de parámetros tienen varios valores. Un parámetro set contiene una lista de valores. Un parámetro de mapa 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 máquina virtual 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 está separado del siguiente por un carácter de punto y coma (;). La M que precede a la RW indica que este parámetro es un parámetro de mapa y se puede leer y escribir. El parámetro allowed-operations tiene una lista que constituye un conjunto de elementos. La S que precede al RO indica que este es un parámetro establecido y es legible pero no escribible.

Para filtrar por un parámetro de mapa o establecer un parámetro de mapa, utilice 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

Hay varios comandos para operar en 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 en particular. Como estos comandos se consideran comandos de bajo nivel, deben usar el UUID y no la etiqueta del nombre de la máquina virtual.

  • 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 “caros”.

  • 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 se obtiene el valor asociado a esa clave en el mapa. Si no se especifica param-key o si el parámetro es un conjunto, el comando devuelve una representación de cadena del conjunto o el 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

    Se agrega a un mapa o a un parámetro establecido. Para un parámetro de mapa, agregue pares clave/valor mediante la sintaxis key=value. Si el parámetro es un conjunto, agregue 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. De forma predeterminada, este tipo de comando enumera todos los objetos e imprime un subconjunto de los parámetros. Este comportamiento se puede modificar de las siguientes maneras:

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

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

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

Como alternativa, para enumerar todos los parámetros, use la sintaxis:

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

El comando list no muestra algunos parámetros que sean costosos de calcular. Estos parámetros se muestran, por ejemplo:

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

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

Para filtrar la lista, la CLI hace coincidir 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 enumera solo las máquinas virtuales para las que los dos campos, tanto power-state como HVM-boot-policy, tengan los valores detenido y orden de BIOS respectivamente.

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 en función de las claves en los mapas es map-name:key=value. La sintaxis para filtrar en función de los valores existentes en un conjunto es set-name:contains=value.

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

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

Secretos

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

Nota:

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

Para crear un objeto secreto, ejecute el siguiente comando en el host de Citrix Hypervisor.

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

Se crea un secreto y se almacena en el host de Citrix Hypervisor. El comando genera el UUID del objeto secreto. Por ejemplo: 99945d96-5890-de2a-3899-8c04ef2521db. Adjunte _secret al nombre del argumento password para pasar este UUID a cualquier comando que requiera una contraseña.

Ejemplo: En el host Citrix Hypervisor 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 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 confiables.

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

referencia de comandos xe

En esta sección se agrupan los comandos por los objetos a los que se dirige el comando. Estos objetos se enumeran alfabéticamente.

Comandos del dispositivo

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

Parámetros del dispositivo

Los comandos del dispositivo tienen los siguientes parámetros:

Nombre del parámetro Descripción Tipo
uuid El uuid del dispositivo Si son necesarias
name-description La descripción del dispositivo Opcional
paused   Opcional
force Forzar el cierre Opcional

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 de VM o vApp.

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

Agregue máquinas virtuales 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-->

Recupere una VM Appliance/vApp de la base de datos contenida en la VDI suministrada.

appliance-shutdown

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

Apaga todas las máquinas virtuales de 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 grupo. Si el parámetro opcional since está presente, solo descarga los registros de ese punto específico en el tiempo.

Parámetros de audit-log-get

audit-log-get tiene los siguientes parámetros

Nombre del parámetro Descripción Tipo
filename Escribir el registro de auditoría del grupo en el nombre del archivo Si son necesarias
since Punto de fecha/hora específico Opcional

audit-log-get

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

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

Ejecute este comando:

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

Comandos de unión

Comandos para trabajar con vínculos 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 unión es un objeto de referencia que pega entre sí las PIF maestras y miembros. El PIF maestro es la interfaz de unión que debe usarse como el PIF general para referirse a la unión. Los PIF miembros 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 vínculos

Los vínculos tienen los siguientes parámetros:

Nombre del parámetro Descripción Tipo
uuid Referencia de identificador/objeto única para el vínculo Solo lectura
master UUID para el PIF de vínculos maestros Solo lectura
members Conjunto de UUID para los PIF enlazados subyacentes Solo lectura

bond-create

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

Cree 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 vínculo
  • Si algún miembro tiene una etiqueta de VLAN configurada
  • Si los PIF a los que se hace referencia no están en el mismo servidor de Citrix Hypervisor
  • Si se suministran 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-->

Cambia el modo de enlace.

Comandos de CD

Comandos para trabajar con unidades de CD/DVD físicas en servidores de Citrix Hypervisor.

Parámetros de CD

Los CD tienen los siguientes parámetros:

Nombre del parámetro Descripción Tipo
uuid Referencia única de identificador/objeto para el CD Solo lectura
name-label Nombre del CD Lectura/Escritura
name-description Texto descriptivo del CD Lectura/Escritura
allowed-operations Una lista de las operaciones que se pueden realizar en este CD Parámetro de conjunto de solo lectura
current-operations Una lista de las operaciones que están actualmente en curso en este CD Parámetro de conjunto de solo lectura
sr-uuid La referencia única de identificador/objeto para la SR de la que forma parte este CD Solo lectura
sr-name-label El nombre de la SR de la que forma parte este CD Solo lectura
vbd-uuids Una lista de los identificadores únicos para los VBD de las VM que se conectan a este CD Parámetro de conjunto de solo lectura
crashdump-uuids No se usa en CD. Porque los volcados de memoria no se pueden escribir en CD Parámetro de conjunto de solo lectura
virtual-size Tamaño del CD tal como aparece en las máquinas virtuales (en bytes) Solo lectura
physical-utilisation Cantidad de espacio físico que ocupa la imagen de CD en el SR (en bytes) Solo lectura
type Definir como Usuario para CD Solo lectura
sharable Indica si la unidad de CD se puede compartir o no. El valor predeterminado es false. Solo lectura
read-only Indica si el CD es de solo lectura false, si es posible escribir en el dispositivo. Siempre es cierto para los CD. Solo lectura
storage-lock El valor es true si este disco está bloqueado en el nivel de almacenamiento. Solo lectura
parent Referencia al disco principal, si este CD forma parte de una cadena. Solo lectura
missing El valor es true si la operación de escaneo SR informó que este CD no está presente en el disco Solo lectura
other-config Una lista de pares clave/valor que especifican parámetros de configuración adicionales para el CD Parámetro de mapa de lectura y escritura
location La ruta en la que se monta el dispositivo Solo lectura
managed El valor es true si el dispositivo está administrado Solo lectura
xenstore-data Datos que se insertarán en el árbol xenstore Parámetro de mapa de solo lectura
sm-config Nombres y descripciones de las claves de configuración del dispositivo del administrador de almacenamiento Parámetro de mapa de solo lectura
is-a-snapshot El valor es true si esta plantilla es una instantánea de CD Solo lectura
snapshot_of El UUID del CD del que esta plantilla es una instantánea Solo lectura
snapshots Los UUID de cualquier instantánea que se haya tomado de este CD Solo lectura
snapshot_time La marca de tiempo de la operación de instantánea Solo lectura

cd-list

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

Enumere los CD y las ISO (archivos de imagen de CD) en el servidor o grupo Citrix Hypervisor, filtrando por el argumento opcional params.

Si se usa el argumento opcional params, el valor de params es una cadena que contiene una lista de parámetros de este objeto que quiere mostrar. Como alternativa, puede usar la palabra clave all para mostrar todos los parámetros. Cuando params no se usa, 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

Comandos para trabajar con grupos agrupados.

Los grupos agrupados son grupos de recursos que tienen habilitada la función de agrupación en clústeres. Use estas agrupaciones con SR de GFS2. Para obtener más información, consulte Grupos agrupados

Los objetos cluster y cluster-host se pueden enumerar con los comandos de listado de objetos estándar (xe cluster-list y xe cluster-host-list) y los parámetros manipulados 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 agrupados.

Parámetros de clúster

Los clústeres tienen los siguientes parámetros:

Nombre del parámetro Descripción Tipo
uuid La referencia de identificador/objeto única para el clúster Solo lectura
cluster-hosts Una lista de referencias de identificadores/objetos únicos para los hosts del clúster Parámetro de conjunto de solo lectura
cluster-token La clave secreta que usa xapi-clusterd cuando habla consigo misma en otros hosts Solo lectura
cluster-stack La pila de tecnología que proporciona las capacidades de agrupación en clústeres. Los valores posibles son corosync. Solo lectura
allowed-operations Enumera las operaciones permitidas en este estado. Esta lista es solo de carácter consultivo y el estado del clúster puede haber cambiado en el momento en que un cliente lee este campo. Parámetro de conjunto de solo lectura
current-operations Enumera las operaciones en curso en ese momento. Esta lista es solo de carácter consultivo y el estado del clúster puede haber cambiado en el momento en que un cliente lee este campo. Parámetro de conjunto de solo lectura
token-timeout El tiempo de espera del token corosync en segundos Solo lectura
token-timeout-coefficient El coeficiente de tiempo de espera del token corosync en segundos Solo lectura
pool-auto-join True si se unen automáticamente nuevos miembros del grupo al clúster. Esto está configurado para true. Solo lectura
cluster-config Una lista de pares clave/valor que especifican parámetros de configuración adicionales para el clúster. Parámetro de mapa de solo lectura
other-config Una lista de pares clave/valor que especifican parámetros de configuración adicionales para el clúster. Parámetro de mapa de lectura y escritura

cluster-host-destroy

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

Destruye un host de clúster y abandona el clúster de manera efectiva

cluster-host-disable

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

Inhabilite la pertenencia al clúster para un host de clúster habilitado.

cluster-host-enable

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

Habilite la pertenencia al clúster para un host de clúster inhabilitado.

cluster-host-force-destroy

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

Destruya un objeto host de clúster con fuerza y abandone el clúster de manera efectiva.

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

Cree un clúster para todo el grupo.

cluster-pool-destroy

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

Destruya el clúster de todo el grupo El grupo sigue existiendo, pero ya no está agrupado en clústeres y ya no puede usar SR de GFS2.

cluster-pool-force-destroy

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

Fuerce la destrucción del clúster de todo el grupo.

cluster-pool-resync

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

Vuelva a sincronizar un clúster en un grupo.

Comandos de consola

Comandos para trabajar con consolas.

Los objetos de consola se pueden enumerar con el comando estándar de listado de objetos (xe console-list) y los parámetros manipulados 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:

Nombre del parámetro Descripción Tipo
uuid La referencia de identificador/objeto única para la consola Solo lectura
vm-uuid La referencia única de identificador/objeto de la máquina virtual en la que está abierta esta consola Solo lectura
vm-name-label El nombre de la máquina virtual en la que está abierta esta consola Solo lectura
protocol Protocolo que usa esta consola. Los valores posibles son vt100: terminal VT100, rfb: Protocolo de búfer de cuadro remoto (como se usa en VNC) o rdp: Protocolo de escritorio remoto Solo lectura
location URI para el servicio de consola Solo lectura
other-config Una lista de pares clave/valor que especifican parámetros de configuración adicionales para la consola. Parámetro de mapa de lectura y escritura

console

xe console
<!--NeedCopy-->

Se conecta a una consola en particular.

Comandos de diagnóstico

Comandos para recopilar información de diagnóstico de Citrix Hypervisor.

diagnostic-compact

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

Realice una recolección de GC importante y una compactación de pilas.

RETIRADO:diagnostic-db-log

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

Comience a registrar las operaciones de base de datos Advertencia: Una vez iniciado, esto no se puede detener.

diagnostic-db-stats

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

Imprimir estadísticas de bases de datos.

diagnostic-gc-stats

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

Imprime las estadísticas de GC.

diagnostic-license-status

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

Ayude a diagnosticar problemas de licencias en todo el grupo.

diagnostic-net-stats

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

Imprime estadísticas de red.

diagnostic-timing-stats

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

Estadísticas de tiempo de impresión.

diagnostic-vdi-status

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

Consulte el estado de bloqueo y uso compartido de una VDI.

diagnostic-vm-status

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

Consulte los hosts en los que la VM puede arrancar y compruebe el estado de compartición/bloqueo de todos los VBD.

Comandos de recuperación ante

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 una 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 que están 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 la SR introducida.

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 de vApp o del dispositivo) está visible.

appliance-recover

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

Recupere un dispositivo/vApp de la base de datos contenida en la VDI suministrada.

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 la VDI suministrada.

sr-enable-database-replication

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

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

sr-disable-database-replication

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

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

Uso de ejemplo

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

En el sitio principal, habilite la replicación de 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 los VDI de base de datos en el SR:

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

Consulte una VDI de base de datos para las máquinas virtuales 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-->

Destruye la tarea de DR. Se destruyen todos los SR introducidos por la tarea de DR y que no sean requeridos por las VM:

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:

Nombre de la clase Descripción
pool Un conjunto de hosts físicos
vm Una máquina virtual
host Un host físico
network Una red virtual
vif Una interfaz de red virtual
pif Una interfaz de red física (las VLAN separadas se representan como varios PIF)
sr Un repositorio de almacenamiento
vdi Una imagen de disco virtual
vbd Un dispositivo de bloques virtual
pbd Los dispositivos de bloques físicos a través de los cuales los hosts acceden

event-wait

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

Impide 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 que no sea y”.

Ejemplo: espere a que se ejecute una VM específica.

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

Bloquea otros comandos hasta que una máquina virtual llamada myvm tenga el estado power-state “activo”.

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

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

Bloquea otros comandos hasta que se reinicie una VM con UUID $VM. El comando usa 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 que se enumeran al principio de esta sección. Los parámetros pueden ser cualquiera de los parámetros enumerados en el comando de la CLI class-param-list.

Comandos de GPU

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

Los objetos de GPU se pueden enumerar con los comandos de lista de objetos estándar: xe pgpu-list, xe gpu-group-list y xe vgpu-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 GPU física

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

Nombre del parámetro Descripción Tipo
uuid La referencia única de identificador/objeto para la PGPU Solo lectura
vendor-name El nombre del proveedor de la PGPU Solo lectura
device-name El nombre asignado por el proveedor a este modelo de PGPU Solo lectura
gpu-group-uuid La referencia única de identificador/objeto para el grupo de GPU al que Citrix Hypervisor ha asignado automáticamente esta PGPU. Las PGPU idénticas en todos los hosts de un grupo se agrupan Solo lectura
gpu-group-name-label El nombre del grupo de GPU al que se asigna la PGPU Solo lectura
host-uuid La referencia única de identificador/objeto para el servidor de Citrix Hypervisor al que está conectada la PGPU Solo lectura
host-name-label El nombre del servidor de Citrix Hypervisor al que está conectada la PGPU Solo lectura
pci-id Identificador de PCI Solo lectura
dependencies Enumera los dispositivos PCI dependientes que se han pasado a la misma VM Parámetro de mapa de lectura y escritura
other-config Una lista de pares clave/valor que especifican parámetros de configuración adicionales para la PGPU Parámetro de mapa de lectura y escritura
supported-VGPU-types Lista de tipos de GPU virtuales compatibles con el hardware subyacente Solo lectura
enabled-VGPU-types Lista de tipos de GPU virtuales que se han habilitado para esta PGPU Lectura/escritura
resident-VGPUs Lista de vGPU que se ejecutan en esta PGPU Solo lectura

pgpu-disable-dom0-access

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

Desactiva el acceso de la PGPU a dom0.

pgpu-enable-dom0-access

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

Habilite el acceso de la PGPU a dom0.

Parámetros del grupo de GPU

Los grupos de GPU tienen los siguientes parámetros:

Nombre del parámetro Descripción Tipo
uuid La referencia única de identificador/objeto para el grupo de GPU Solo lectura
name-label El nombre del grupo de GPU Lectura/Escritura
name-description El texto descriptivo del grupo de GPU Lectura/Escritura
VGPU-uuids Muestra las referencias únicas de identificador/objeto para las GPU virtuales en el grupo de GPU Parámetro de conjunto de solo lectura
PGPU-uuids Muestra las referencias únicas de identificador/objeto para las GPU en el grupo de GPU Parámetro de conjunto de solo lectura
other-config Una lista de pares clave/valor que especifican parámetros de configuración adicionales para el grupo de GPU Parámetro de mapa de lectura y escritura
supported-VGPU-types Unión de todos los tipos de GPU virtuales admitidos por el hardware subyacente Solo lectura
enabled-VGPU-types Unión de todos los tipos de GPU virtuales que se han habilitado en las GPU subyacentes Solo lectura
allocation-algorithm Configuración de primero en profundidad/amplitud para la asignación de GPU virtuales en PGPU dentro del grupo Parámetro enum de lectura y escritura

Operaciones de grupos 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 GPU.

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

Destruye el grupo de GPU; solo se permite 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 crear instancias 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 el grupo de GPU utiliza para asignar GPU virtuales a las GPU.

gpu-group-param-get-uuid
xe gpu-group-param-get-uuid uuid=uuid_of_group param-name=supported-vGPU-types|enabled-vGPU-types
<!--NeedCopy-->

Devuelve los tipos compatibles o habilitados para este grupo de GPU.

Parámetros de GPU virtual

Las GPU virtuales tienen los siguientes parámetros:

Nombre del parámetro Descripción Tipo
uuid La referencia única de identificador/objeto para la GPU virtual Solo lectura
vm-uuid La referencia única de identificador/objeto para la máquina virtual a la que se asigna la GPU virtual Solo lectura
vm-name-label El nombre de la VM a la que se asigna la GPU virtual Solo lectura
gpu-group-uuid La referencia única de identificador/objeto para el grupo de GPU en el que se encuentra la GPU virtual Solo lectura
gpu-group-name-label El nombre del grupo de GPU en el que se encuentra la GPU virtual Solo lectura
currently-attached True si se está ejecutando una máquina virtual con paso a través de GPU, falso en caso contrario Solo lectura
other-config Una lista de pares clave/valor que especifican parámetros de configuración adicionales para la GPU virtual Parámetro de mapa de lectura y escritura
type-uuid La referencia única de identificador/objeto para el tipo de GPU virtual de esta GPU virtual Parámetro de mapa de lectura y escritura
type-model-name Nombre del modelo asociado al tipo de GPU virtual Solo lectura

Parámetros de tipo de GPU virtual

Nota:

Las GPU virtuales y de transferencia de GPU no son compatibles con la migración en vivo, la migración en vivo del almacenamiento ni la suspensión de máquinas virtuales, a menos que haya software y tarjetas gráficas compatibles de los proveedores de GPU. Las máquinas virtuales sin este soporte no se pueden migrar para evitar el tiempo de inactividad. Para obtener información sobre la compatibilidad de vGPU de NVIDIA 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 virtuales tienen los siguientes parámetros:

Nombre del parámetro Descripción Tipo
uuid La referencia única de identificador/objeto para el tipo de GPU virtual Solo lectura
vendor-name Nombre del proveedor de GPU virtual Solo lectura
model-name Nombre del modelo asociado al tipo de GPU virtual Solo lectura
freeze-frame Tamaño del búfer de fotogramas del tipo de GPU virtual, en bytes Solo lectura
max-heads Número máximo de pantallas admitidas por el tipo de GPU virtual Solo lectura
supported-on-PGPUs Lista de GPU que admiten este tipo de GPU virtual Solo lectura
enabled-on-PGPUs Lista de las GPU que tienen habilitado este tipo de GPU virtual Solo lectura
VGPU-uuids Lista de GPU virtuales de este tipo Solo lectura

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 conecta la VM al grupo de GPU especificado y, de manera opcional, especifica el tipo de GPU virtual. Si no se especifica ningún tipo de GPU virtual, se asume el tipo de “transferencia”.

vgpu-destroy

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

Destruye la GPU virtual especificada.

Desactivación de 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 inhabilita la consola de VNC para una VM a medida que disablevnc=1 pasa al emulador de pantalla. De forma predeterminada, la VNC está habilitada.

Comandos de host

Comandos para interactuar con el servidor de Citrix Hypervisor.

Los servidores de Citrix Hypervisor son los servidores físicos que ejecutan el software Citrix Hypervisor. Tienen máquinas virtuales ejecutándose en ellas bajo el control de una máquina virtual con privilegios especiales, conocida como dominio de control o dominio 0.

Los objetos del servidor de Citrix Hypervisor se pueden enumerar con los comandos estándar de lista 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 servidores de Citrix Hypervisor en los que realizar la operación. Lo más simple es proporcionar el argumento host=uuid_or_name_label. También puede especificar Citrix Hypervisor filtrando la lista completa de hosts en los valores de los campos. Por ejemplo, al especificar enabled=true, se seleccionan todos los servidores de Citrix Hypervisor cuyo campo enabled es igual a true. Cuando varios servidores de Citrix Hypervisor coinciden y la operación se puede realizar en varios servidores de Citrix Hypervisor, debe especificar --multiple para que se realice 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 los servidores de Citrix Hypervisor, la operación se realiza en todos los servidores de Citrix Hypervisor.

Parámetros de host

Los servidores de Citrix Hypervisor tienen los siguientes parámetros:

Nombre del parámetro Descripción Tipo
uuid La referencia única de identificador/objeto para el servidor de Citrix Hypervisor Solo lectura
name-label El nombre del servidor de Citrix Hypervisor Lectura/Escritura
name-description La cadena descriptiva del servidor de Citrix Hypervisor Solo lectura
enabled El valor es false si está inhabilitado. Esto evita que las máquinas virtuales nuevas se inicien en los hosts y prepara los hosts para que se apaguen o reinicien. El valor es true si el host está habilitado Solo lectura
API-version-major Número de versión principal Solo lectura
API-version-minor Número de versión menor Solo lectura
API-version-vendor Identificación del proveedor de API Solo lectura
API-version-vendor-implementation Detalles de la implementación del proveedor Parámetro de mapa de solo lectura
logging Configuración de registros Parámetro de mapa de lectura y escritura
suspend-image-sr-uuid La referencia única de identificador/objeto para el SR donde se colocan imágenes suspendidas Lectura/Escritura
crash-dump-sr-uuid La referencia única de identificador/objeto para el SR donde se colocan los volcados de memoria Lectura/Escritura
software-version Lista de parámetros de control de versiones y sus valores Parámetro de mapa de solo lectura
capabilities Lista de versiones de Xen que puede ejecutar el servidor de Citrix Hypervisor Parámetro de conjunto de solo lectura
other-config Una lista de pares clave/valor que especifican parámetros de configuración adicionales para el servidor de Citrix Hypervisor Parámetro de mapa de lectura y escritura
chipset-info Una lista de pares clave/valor que especifican información sobre el conjunto de chips Parámetro de mapa de solo lectura
hostname Nombre de host del servidor de Citrix Hypervisor Solo lectura
address Dirección IP del servidor de Citrix Hypervisor Solo lectura
license-server Una lista de pares clave/valor que especifican información sobre el servidor de licencias. El puerto predeterminado para las comunicaciones con los productos Citrix es 27000. Para obtener información sobre cómo cambiar los números de puerto debido a conflictos, consulte Cambiar los números de puerto Parámetro de mapa de solo lectura
supported-bootloaders Lista de cargadores de arranque que admite el servidor de Citrix Hypervisor, por ejemplo pygrub, eliloader Parámetro de conjunto de solo lectura
memory-total Cantidad total de RAM física en el servidor de Citrix Hypervisor, en bytes Solo lectura
memory-free Cantidad total de RAM física restante que se puede asignar a las VM, en bytes Solo lectura
host-metrics-live True si el host está operativo Solo lectura
logging La clave syslog_destination se puede establecer en el nombre de host de un servicio syslog de escucha remota. Parámetro de mapa de lectura y escritura
allowed-operations Enumera las operaciones permitidas en este estado. Esta lista es solo de carácter consultivo y el estado del servidor puede haber cambiado en el momento en que un cliente lee este campo. Parámetro de conjunto de solo lectura
current-operations Enumera las operaciones en curso en ese momento. Esta lista es solo de carácter consultivo y el estado del servidor puede haber cambiado en el momento en que un cliente lee este campo. Parámetro de conjunto de solo lectura
patches Conjunto de parches de host Parámetro de conjunto de solo lectura
blobs almacén de datos binarios Solo lectura
memory-free-computed Una estimación conservadora de la cantidad máxima de memoria libre en un host Solo lectura
ha-statefiles Los UUID de todos los archivos de estado de HA Solo lectura
ha-network-peers Los UUID de todos los hosts que pueden alojar las VM en este host si se produce un error Solo lectura
external-auth-type Tipo de autenticación externa, por ejemplo, Active Directory. Solo lectura
external-auth-service-name El nombre del servicio de autenticación externo Solo lectura
external-auth-configuration Información de configuración para el servicio de autenticación externo. Parámetro de mapa de solo lectura

Los servidores de Citrix Hypervisor contienen otros objetos que también tienen listas de parámetros.

Las CPU de los servidores de Citrix Hypervisor tienen los siguientes parámetros:

Nombre del parámetro Descripción Tipo
uuid La referencia única de identificador/objeto para la CPU Solo lectura
number El número del núcleo de CPU físico dentro del servidor de Citrix Hypervisor Solo lectura
vendor La cadena de proveedor para el nombre de la CPU Solo lectura
speed La velocidad del reloj de la CPU, en Hz Solo lectura
modelname La cadena de proveedor para el modelo de CPU, por ejemplo, “CPU Intel(R) Xeon(TM) de 3,00 GHz” Solo lectura
stepping El número de revisión de la CPU Solo lectura
flags Los indicadores de la CPU física (una versión descodificada del campo de funciones) Solo lectura
Utilisation La utilización actual de la CPU Solo lectura
host-uuid El UUID si el host en el que se encuentra la CPU Solo lectura
model El número de modelo de la CPU física Solo lectura
family El número de familia de CPU física Solo lectura

Los volcados de memoria en los servidores de Citrix Hypervisor tienen los siguientes parámetros:

Nombre del parámetro Descripción Tipo
uuid La referencia de identificador/objeto única para el volcado de bloqueo Solo lectura
host Servidor de Citrix Hypervisor al que corresponde el volcado Solo lectura
timestamp Marca de tiempo de la fecha y hora en que se produjo el volcado, en el formulario yyyymmdd-hhmmss-ABC, donde ABC es el indicador de zona horaria, por ejemplo, GMT Solo lectura
size Tamaño del volcado de bloqueo, en bytes Solo lectura

host-all-editions

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

Obtenga una lista de todas las ediciones disponibles

host-apply-edition

xe host-apply-edition [host-uuid=host_uuid] [edition=xenserver_edition="free" "per-socket" "xendesktop"]
<!--NeedCopy-->

Asigna la licencia de Citrix Hypervisor a un servidor host. Al asignar una licencia, Citrix Hypervisor se pone en contacto con el servidor de licencias y solicita el tipo de licencia especificado. Si hay una licencia disponible, se retira del servidor de licencias.

Para las ediciones de Citrix Hypervisor para Citrix Virtual Desktops y DaaS, utilice "xendesktop".

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

host-backup

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

Descargue una copia de seguridad del dominio de control del servidor de Citrix Hypervisor especificado en la máquina desde la que se invoca el comando. Guárdalo ahí como un archivo con el nombre file-name.

Importante:

Si bien el xe host-backupcomando funciona si se ejecuta en el host local (es decir, sin especificar un nombre de host específico), no lo use de esta manera. Hacerlo llenaría la partición del dominio de control con el archivo de copia de seguridad. Utilice el comando únicamente desde una máquina remota fuera del host en la que 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-->

Genera un nuevo informe de errores (mediantexen-bugtool, con todos los archivos opcionales incluidos) y súbelo al sitio FTP de Soporte o a alguna otra ubicación.

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

Los parámetros opcionales sonhttp-proxy: Utilizar proxy HTTP especificado yurl: 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-->

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

host-crashdump-destroy

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

Elimine un volcado de host especificado por su UUID del servidor de Citrix Hypervisor.

host-crashdump-upload

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

Cargue un volcado en el 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 sonhttp-proxy: Utilizar proxy HTTP especificado yurl: 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 provocar la pérdida de datos si el host no está realmente muerto.

host-disable

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

Inhabilita los servidores de Citrix Hypervisor especificados, lo que impide que las máquinas virtuales nuevas se inicien en ellos. Esta acción prepara los servidores de Citrix Hypervisor para que se apaguen o reinicien. Una vez reiniciado el host, si se cumplen todas las condiciones para la activación (por ejemplo, si hay almacenamiento disponible), el host se vuelve a habilitar automáticamente.

Los hosts en los que se realizará esta operación se seleccionan mediante el mecanismo de selección estándar (consulte los selectores de anfitriones). 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-->

Inhabilitar la visualización para el host.

host-disable-local-storage-caching

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

Inhabilite el almacenamiento en caché del almacenamiento local en el host especificado.

host-dmesg

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

Obtenga un dmesg Xen (la salida del búfer en anillo del núcleo) de los servidores de Citrix Hypervisor especificados.

Los hosts en los que se realizará esta operación se seleccionan mediante el mecanismo de selección estándar (consulte los selectores de anfitriones 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-emergency-ha-disable

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

Inhabilite HA en el host local. Solo se usa para recuperar un grupo con una configuración de alta disponibilidad rota.

host-emergency-management-reconfigure

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

Vuelva a configurar la interfaz de administración de este servidor de Citrix Hypervisor. Utilice este comando solo si el servidor de Citrix Hypervisor está en modo de emergencia. El modo de emergencia significa que el host es miembro de un grupo de recursos cuyo maestro ha desaparecido de la red y no se puede contactar con él después de varios intentos.

host-emergency-reset-server-certificate

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

Instala un certificado autofirmado en el servidor de Citrix Hypervisor donde se ejecuta el comando.

host-enable

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

Habilita los servidores de Citrix Hypervisor especificados, lo que permite que se inicien nuevas VM en ellos.

Los hosts en los que se realizará esta operación se seleccionan mediante el mecanismo de selección estándar (consulte los selectores de anfitriones 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-enable-display

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

Habilite la visualización para el host.

host-enable-local-storage-caching

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

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

host-evacuate

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

Live migra todas las VM en ejecución a otros hosts adecuados de un grupo. En primer lugar, inhabilite el host mediante el comando host-disable.

Si el host evacuado es el maestro del grupo, se debe seleccionar otro host para que sea el maestro del grupo. Para cambiar el patrón de grupo con HA inhabilitado, ejecute el comando pool-designate-new-master. Para obtener más información, consulte pool-designate-new-master.

Con HA habilitado, la única opción es apagar el servidor, lo que hace que HA elija un nuevo maestro al azar. Para obtener más información, consulte host-shutdown.

Los hosts en los que se realizará esta operación se seleccionan mediante el mecanismo de selección estándar (consulte los selectores de anfitriones 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-forget

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

El agente XAPI olvida el servidor de Citrix Hypervisor especificado sin ponerse en contacto con él de forma explícita.

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

Advertencia:

No utilice este comando si la alta disponibilidad está habilitada en el grupo. Desactive primero HA y, a continuación, vuelva a activarla cuando haya olvidado el host.

Este comando es útil si el servidor de Citrix Hypervisor para “olvidar” está muerto. Sin embargo, si el servidor de Citrix Hypervisor está activo y forma parte del grupo, use 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 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 del estado del sistema en el archivo especificado. El parámetro opcional entries es una lista separada por comas de entradas de estado del sistema, tomada 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 como tar.bz2.

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

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 texto/sin formato o aplicación/datos. Indica si una interfaz de usuario puede renderizar las entradas para consumo humano.
  • default-checked Puede ser sí o no. Indica si una interfaz de usuario selecciona esta entrada de forma predeterminada.
  • min-size, max-size indica un intervalo aproximado para el tamaño, en bytes, de esta entrada. -1 indica que el tamaño no es importante.
  • min-time, max-time indica un intervalo aproximado para el tiempo, en segundos, que tardó en recopilar esta entrada. -1 indica que el tiempo no es importante.
  • pii Información de identificación personal. Indica si la entrada tiene información que puede identificar al propietario del sistema o detalles de su topología de red. El atributo puede tener uno de los valores siguientes:

    • no: No hay información de identificación personal en estas entradas
    • yes: Es probable o seguro que la PII está en estas entradas
    • maybe: Puede que quiera auditar estas entradas para obtener información de identificación personal
    • if_customized si los archivos no están modificados, no contienen PII. Sin embargo, dado que alentamos la edición de estos archivos, es posible que dicha personalización haya introducido la PII. Este valor se usa en particular para los scripts de red en el dominio de control.

    Las contraseñas nunca se incluirán 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 mediante el mecanismo de selección estándar (consulte los selectores de anfitriones más arriba).

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

Devuelva una lista de máquinas virtuales que eviten la evacuación de un host específico y muestre 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 está hablando la CLI está en modo de emergencia; de lo contrario, devuelve false. Este comando de la CLI funciona directamente en los servidores miembros del grupo incluso sin un servidor maestro presente.

host-license-add

xe host-license-add [license-file=path/license_filename] [host-uuid=host_uuid]
<!--NeedCopy-->

Para Citrix Hypervisor (edición gratuita), utilícelo para analizar un archivo de licencia local y agregarlo al servidor de Citrix Hypervisor especificado.

host-license-remove

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

Elimina cualquier licencia aplicada a un host.

host-license-view

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

Muestra el contenido de la licencia del servidor de Citrix Hypervisor.

host-logs-download

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

Descargue una copia de los registros de los servidores de Citrix Hypervisor especificados. La copia se guarda de forma predeterminada 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 mediante el parámetro opcional nombre-archivo.

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

Importante:

Si bien el xe host-logs-download comando funciona si se ejecuta en el host local (es decir, sin especificar un nombre de host específico), no lo utilice de esta manera. Al hacerlo, se desordena la partición del dominio de control con la copia de los registros. Utilice el comando únicamente desde un equipo remoto ajeno al servidor en el que disponga de espacio para guardar la copia de los registros.

host-management-disable

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

Inhabilita la escucha del agente host en una interfaz de red de administración externa y desconecta todos los clientes de API conectados (como XenCenter). Este comando funciona directamente en el servidor de Citrix Hypervisor al que está conectada la CLI. El comando no se reenvía al maestro del grupo cuando se aplica a un servidor de Citrix Hypervisor miembro.

Advertencia:

Tenga cuidado al usar este comando CLI fuera del host. Después de ejecutar este comando, no puede 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 servidor de Citrix Hypervisor para que use la interfaz de red especificada como interfaz de administración, que es la interfaz que se usa para conectarse a XenCenter. El comando reescribe la clave MANAGEMENT_INTERFACE en /etc/xensource-inventory.

Si se especifica el nombre del dispositivo de una interfaz (que debe tener una dirección IP), el servidor de Citrix Hypervisor 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 servidor de Citrix Hypervisor determina qué dirección IP se debe volver a vincular a sí mismo. No debe estar en modo de emergencia cuando se ejecute 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 uno primero. De lo contrario, los comandos CLI posteriores no pueden llegar al servidor de Citrix Hypervisor.

host-power-on

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

Enciende los servidores de Citrix Hypervisor con la función Host Power On habilitada. Antes de usar este comando, host-set-power-on habilítelo en el host.

host-reboot

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

Reinicie los servidores de Citrix Hypervisor especificados. Los hosts especificados deben inhabilitarse primero mediante 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 mediante el mecanismo de selección estándar (consulte los selectores de anfitriones 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 servidores de Citrix Hypervisor especificados son miembros de un grupo, la pérdida de conectividad al apagarse se controla y el grupo se recupera cuando los servidores de Citrix Hypervisor regresan. Los demás miembros y el maestro siguen funcionando.

Si cierra el maestro, el grupo queda inactivo hasta que se produzca una de las siguientes acciones:

  • Conviertes a uno de los miembros en el maestro
  • El maestro original se reinicia y vuelve a estar en línea.

    Cuando el maestro vuelve a estar en línea, los miembros se vuelven a conectar y se sincronizan con el maestro.

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 servidor de Citrix Hypervisor. El uso de la palabra “restaurar” aquí no significa una restauración completa en el sentido habitual, simplemente significa que el archivo de copia de seguridad comprimido se ha descomprimido y desempaquetado en la partición secundaria. Después de haber hecho 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 se realizará esta operación se seleccionan mediante el mecanismo de selección estándar (consulte los selectores de anfitriones 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íe 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 servidor de Citrix Hypervisor.

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 servidor de Citrix Hypervisor 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 Linux real del servidor de Citrix Hypervisor. 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" | "DRAC" | "custom"} \
    [ power-on-config:power_on_ip=ip-address power-on-config:power_on_user=user power-on-config:power_on_password_secret=secret-uuid ]
<!--NeedCopy-->

Utilícela para habilitar la función Host Power On en hosts Citrix Hypervisor que sean compatibles con soluciones de energía 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). A continuación, especifique las opciones de configuración mediante el argumento power-on-config y sus pares clave-valor asociados.

Para utilizar la función de secretos para almacenar la 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 servidores de Citrix Hypervisor especificados. Los servidores de Citrix Hypervisor especificados deben inhabilitarse primero mediante 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 mediante el mecanismo de selección estándar (consulte los selectores de anfitriones 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 servidores de Citrix Hypervisor especificados son miembros de un grupo, la pérdida de conectividad al apagarse se controla y el grupo se recupera cuando los servidores de Citrix Hypervisor regresan. Los demás miembros y el maestro siguen funcionando.

Si cierra el maestro, el grupo queda inactivo hasta que se produzca una de las siguientes acciones:

  • Conviertes a uno de los miembros en el maestro
  • El maestro original se reinicia y vuelve a estar en línea.

    Cuando el maestro vuelve a estar en línea, los miembros se vuelven a conectar y se sincronizan con el maestro.

Si la HA está habilitada para el grupo, uno de los miembros se convierte en maestro automáticamente. Si HA está inhabilitada, debe designar manualmente el servidor deseado como maestro 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-->

Intente 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 cierra limpiamente.

host-sync-data

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

Sincronice los datos almacenados en el maestro de grupo 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-->

Vuelva a configurar el demonio syslog en los servidores de Citrix Hypervisor especificados. Este comando aplica la información de configuración definida en el parámetro logging de host.

Los hosts en los que se realizará esta operación se seleccionan mediante el mecanismo de selección estándar (consulte los selectores de anfitriones 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-data-source-list

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

Enumerar las fuentes de datos que se pueden grabar para un host.

Seleccione los hosts en los que quiere realizar esta operación mediante 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 dan parámetros para seleccionar hosts, la operación se lleva a cabo en todos los hosts.

Los orígenes de datos tienen dos parámetros: standard y enabled. Este comando genera los valores de los parámetros:

  • Si un origen de datos tiene enabled establecido en true, las métricas se están registrando actualmente en la base de datos de rendimiento.
  • Si un origen de datos tiene standard establecido en true, las métricas se registran en la base de datos de rendimiento de forma predeterminada. El valor de enabled también se establece en true para este origen de datos.
  • Si un origen de datos tiene standard establecido en false, las métricas no se registran en la base de datos de rendimiento de forma predeterminada. El valor de enabled también se establece en false para este origen de datos.

Para empezar a registrar métricas de fuentes de datos en la base de datos de rendimiento, ejecute el comando host-data-source-record. Este comando establece enabled en true. Para detener, ejecute el 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-->

Registre 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 persistentes de los hosts especificados. Por motivos de rendimiento, esta base de datos es distinta de la base de datos de agentes normal.

Seleccione los hosts en los que quiere realizar esta operación mediante 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 dan parámetros para seleccionar hosts, la operación se lleva a cabo 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-->

Deje de grabar la fuente de datos especificada para un host y olvide todos los datos grabados.

Seleccione los hosts en los que quiere realizar esta operación mediante 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 dan parámetros para seleccionar hosts, la operación se lleva a cabo 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 quiere realizar esta operación mediante 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 dan parámetros para seleccionar hosts, la operación se lleva a cabo en todos los hosts.

OBSOLETO: comandos de registro

Comandos para trabajar con registros.

RETIRADO:log-get

xe log-get
<!--NeedCopy-->

Devuelve el registro almacenado actualmente en el registrador de cadenas.

RETIRADO:log-get-keys

xe log-get-keys
<!--NeedCopy-->

Haga una lista de las claves conocidas por el registrador.

RETIRADO:log-reopen

xe log-reopen
<!--NeedCopy-->

Vuelva a abrir todos los registradores (utilícelo para rotar archivos).

RETIRADO:log-set-output

xe log-set-output output=output [key=key] [level=level]
<!--NeedCopy-->

Configure todos los registradores en la salida especificada (nil, stderr, string, file:nombre de archivo, syslog:algo).

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 enumerar con el comando estándar de listado de objetos (xe message-list) y los parámetros manipulados 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 mensajes

Nombre del parámetro Descripción Tipo
uuid La referencia de identificador/objeto única para el mensaje Solo lectura
name El nombre único del mensaje Solo lectura
priority La prioridad del mensaje. Los números más altos indican una mayor prioridad Solo lectura
class La clase de mensaje, por ejemplo, VM. Solo lectura
obj-uuid El uuid del objeto afectado. Solo lectura
timestamp La hora en que se generó el mensaje. Solo lectura
body El contenido del mensaje. Solo lectura

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 enumerar con el comando estándar de listado de objetos (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:

Nombre del parámetro Descripción Tipo
uuid La referencia única de identificador/objeto para la red Solo lectura
name-label El nombre de la red Lectura/Escritura
name-description El texto descriptivo de la red Lectura/Escritura
VIF-uuids Una lista de identificadores únicos de las VIF (interfaces de red virtual) que se conectan desde las VM a esta red Parámetro de conjunto de solo lectura
PIF-uuids Una lista de identificadores únicos de las PIF (interfaces de red físicas) que se conectan desde los servidores de Citrix Hypervisor a esta red Parámetro de conjunto de solo lectura
bridge Nombre del puente correspondiente a esta red en el servidor de Citrix Hypervisor local Solo lectura
default-locking-mode Objeto de red que se utiliza con objetos VIF para el filtrado ARP. Se establece en unlocked para eliminar todas las reglas de filtrado asociadas con el VIF. Se establece en disabled para que el VIF interrumpa todo el tráfico. Lectura/Escritura
purpose Conjunto de propósitos para los que el servidor de Citrix Hypervisor usa esta red. Se establece en nbd para usar la red para realizar conexiones NBD. Lectura/Escritura
other-config:staticroutes Lista separada por comas de entradas con formato de subred/máscara de red/puerta de enlace que especifican la dirección de la puerta de enlace a través de la cual se redirigen. Por ejemplo, configurar other-config:static-routes en 172.16.0.0/15/192.168.0.3,172.18.0.0/16/192.168.0.4 provoca que el tráfico en 172.16.0.0/15 se redirija a 192.168.0.3 y el tráfico en 172.18.0.0/16 se redirija a 192.168.0.4. Lectura/Escritura
other-config:ethtoolautoneg Actívela para inhabilitar la negociación automática de la interfaz física o el puente. El valor predeterminado es sí. Lectura/Escritura
other-config:ethtool-rx Actívela para habilitar la suma de comprobación de recepción y desactívela para inhabilitarla. Lectura/Escritura
other-config:ethtool-tx Actívela para habilitar la suma de comprobación de transmisión y desactívela para inhabilitarla. Lectura/Escritura
other-config:ethtool-sg Actívela para activar la recopilación de dispersión y desactívela para inhabilitarla. Lectura/Escritura
other-config:ethtool-tso Actívela para habilitar la descarga de segmentación de TCP y desactívela para inhabilitarla. Lectura/Escritura
other-config:ethtool-ufo Actívela para habilitar la descarga de fragmentos UDP y desactívela para inhabilitarla. Lectura/Escritura
other-config:ethtool-gso Actívela para habilitar la descarga de segmentación genérica y desactívela para inhabilitarla. Lectura/Escritura
blobs almacén de datos binarios Solo lectura

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 de SR-IOV

Comandos para trabajar con SR-IOV.

Los objetos network-sriov se pueden enumerar 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 de SR-IOV

El SR-IOV tiene los siguientes parámetros:

Nombre del parámetro Descripción Tipo
physical-PIF El PIF para habilitar SR-IOV. Solo lectura
logical-PIF Un PIF lógico de SR-IOV. Los usuarios pueden usar este parámetro para crear una red VLAN SR-IOV. Solo lectura
requires-reboot Si se establece en True, se usa para reiniciar el host para que la habilitación de SR-IOV entre en vigor. Solo lectura
remaining-capacity Número de VF disponibles restantes. Solo lectura

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 una PIF física determinada y habilita SR-IOV en la PIF física.

network-sriov-destroy

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

Quita un objeto SR-IOV de red e inhabilita 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 desde 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-->

Presente un controlador SDN.

sdn-controller-introduce

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

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

Crea un túnel nuevo en un host.

tunnel-destroy

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

Destruye un túnel.

Comandos de parches

Comandos para trabajar con parches.

patch-apply

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

Aplique el parche cargado anteriormente al host especificado.

patch-clean

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

Elimina un archivo de parches cargado anteriormente.

patch-destroy

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

Elimine archivos y registros de parches no aplicados del servidor.

patch-pool-apply

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

Aplique el parche cargado anteriormente a todos los hosts del grupo.

patch-pool-clean

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

Elimine un archivo de parches cargado anteriormente en todos los hosts del grupo.

patch-precheck

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

Ejecute las comprobaciones previas incluidas en el parche cargado anteriormente en el host especificado.

patch-upload

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

Cargue un archivo de parches en el servidor.

Comandos PBD

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

Los objetos PBD se pueden enumerar con el comando estándar de listado de objetos (xe pbd-list) y los parámetros manipulados 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 PBD

Los PBD tienen los siguientes parámetros:

Nombre del parámetro Descripción Tipo
uuid La referencia de identificador/objeto única para el PBD. Solo lectura
sr-uuid El repositorio de almacenamiento al que apunta el PBD Solo lectura
device-config Información de configuración adicional que se proporciona al controlador de backend de SR de un host Parámetro de mapa de solo lectura
currently-attached True si el SR está conectado a este host, False en caso contrario Solo lectura
host-uuid UUID de la máquina física en la que está disponible el PBD Solo lectura
host El campo host está en desuso. Usa host_uuid en su lugar. Solo lectura
other-config Información de configuración adicional. Parámetro de mapa de lectura y escritura

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 el servidor de Citrix Hypervisor. El parámetro device-config de solo lectura solo se puede configurar en el momento de la creación.

Para agregar una asignación desde ‘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 configuración de dispositivo compatibles en cada tipo de SR, consulte Almacenamiento.

pbd-destroy

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

Destruye el PBD especificado.

pbd-plug

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

Intenta conectar el PBD al servidor de Citrix Hypervisor. Si este comando se ejecuta correctamente, el SR al que se hace referencia (y los VDI que contiene) pasarán a ser visibles para el servidor Citrix Hypervisor.

pbd-unplug

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

Intente desconectar el PBD del servidor de Citrix Hypervisor.

Comandos PIF

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

Los objetos de PIF se pueden enumerar con el comando estándar de lista de objetos (xe pif-list) y los parámetros manipulados 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:

Nombre del parámetro Descripción Tipo
uuid La referencia única de identificador/objeto para el PIF Solo lectura
device machine-readable Nombre de la interfaz (por ejemplo, eth0) Solo lectura
MAC La dirección MAC del PIF Solo lectura
other-config Pares name:value de configuración PIF adicionales. Parámetro de mapa de lectura y escritura
physical Si es cierto, el PIF apunta a una interfaz de red física real Solo lectura
currently-attached ¿El PIF está conectado actualmente a este host? true o false Solo lectura
MTU Unidad de transmisión máxima del PIF en bytes. Solo lectura
VLAN Etiqueta VLAN para todo el tráfico que pasa a través de esta interfaz. -1 indica que no se ha asignado ninguna etiqueta VLAN Solo lectura
bond-master-of El UUID del vínculo del que este PIF es el maestro (si lo hay) Solo lectura
bond-slave-of El UUID del vínculo del que forma parte este PIF (si lo hay) Solo lectura
management ¿Se ha designado este PIF para que sea una interfaz de administración para el dominio de control? Solo lectura
network-uuid La referencia única de identificador/objeto de la red virtual a la que está conectado este PIF Solo lectura
network-name-label El nombre de la red virtual a la que está conectado este PIF Solo lectura
host-uuid La referencia única de identificador/objeto del servidor de Citrix Hypervisor al que está conectado este PIF Solo lectura
host-name-label El nombre del servidor de Citrix Hypervisor al que está conectado este PIF Solo lectura
IP-configuration-mode Tipo de configuración de dirección de red utilizada; DHCP o estática Solo lectura
IP Dirección IP del PIF. Se define aquí cuando el modo de configuración de IP es estático; indefinido cuando DHCP Solo lectura
netmask Máscara de red del PIF. Se define aquí cuando el modo de configuración de IP es estático; indefinido cuando lo suministra DHCP Solo lectura
gateway Dirección de puerta de enlace del PIF. Se define aquí cuando el modo de configuración de IP es estático; indefinido cuando lo suministra DHCP Solo lectura
DNS Dirección DNS del PIF. Se define aquí cuando el modo de configuración de IP es estático; indefinido cuando lo suministra DHCP Solo lectura
io_read_kbs Velocidad de lectura media en kb/s para el dispositivo Solo lectura
io_write_kbs Velocidad de escritura promedio en kb/s para el dispositivo Solo lectura
carrier Estado del enlace para este dispositivo Solo lectura
vendor-id El identificador asignado al proveedor de NIC Solo lectura
vendor-name Nombre del proveedor de NIC Solo lectura
device-id El identificador asignado por el proveedor a este modelo de NIC Solo lectura
device-name El nombre asignado por el proveedor a este modelo de NIC Solo lectura
speed Velocidad de transferencia de datos de la NIC Solo lectura
duplex Modo dúplex de la NIC; completo o medio Solo lectura
pci-bus-path Dirección de ruta de bus PCI Solo lectura
other-config:ethtoolspeed Establece la velocidad de conexión en Mbps Lectura/Escritura
other-config:ethtoolautoneg Actívela para inhabilitar la negociación automática de la interfaz física o el puente. El valor predeterminado es sí. Lectura/Escritura
other-config:ethtoolduplex Establece la capacidad de duplexación de la PIF, ya sea completa o media. Lectura/Escritura
other-config:ethtool-rx Actívela para habilitar la suma de comprobación de recepción y desactívela para inhabilitarla. Lectura/Escritura
other-config:ethtool-tx Actívela para habilitar la suma de comprobación de transmisión y desactívela para inhabilitarla. Lectura/Escritura
other-config:ethtool-sg Actívela para activar la recopilación de dispersión y desactívela para inhabilitarla. Lectura/Escritura
other-config:ethtool-tso Actívela para habilitar la descarga de segmentación de TCP y desactívela para inhabilitarla. Lectura/Escritura
other-config:ethtool-ufo Actívela para habilitar la descarga de fragmentos UDP y desactívela para inhabilitarla. Lectura/Escritura
other-config:ethtool-gso Actívela para habilitar la descarga de segmentación genérica y desactívela para inhabilitarla. Lectura/Escritura
other-config:domain Lista separada por comas utilizada para establecer la ruta de búsqueda de DNS Lectura/Escritura
other-config:bondmiimon Intervalo entre comprobaciones de vida de enlace, en milisegundos Lectura/Escritura
other-config:bonddowndelay Número de milisegundos a esperar después de que se pierde el enlace antes de considerar realmente que el enlace se ha ido. Este parámetro permite la pérdida de enlace transitoria Lectura/Escritura
other-config:bondupdelay Número de milisegundos a esperar después de que aparezca el enlace antes de considerarlo realmente. Permite que los enlaces se activen. El valor predeterminado es 31s para permitir que los conmutadores comiencen a reenviar el tráfico. Lectura/Escritura
disallow-unplug True si este PIF es una NIC de almacenamiento dedicada, falso en caso contrario Lectura/Escritura

Nota:

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

pif-forget

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

Destruye el objeto PIF especificado en un host en particular.

pif-introduce

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

Cree un objeto PIF que represente una interfaz física en el servidor de Citrix Hypervisor especificado.

pif-plug

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

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

Modifique la dirección IP del PIF. Para la configuración de IP estática, establezca el parámetro mode en static, con los parámetros gateway, IP y netmask establecidos en los valores apropiados. Para usar DHCP, defina 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 de un conmutador que utiliza 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-->

Vuelva a configurar la configuración de la dirección IPv6 en un PIF.

pif-scan

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

Busque nuevas interfaces físicas en el servidor de Citrix Hypervisor.

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 que utiliza este PIF.

pif-unplug

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

Intente desactivar la interfaz física especificada.

Comandos de agrupación

Comandos para trabajar con grupos. Un grupo es un agregado de uno o más servidores de Citrix Hypervisor. Un grupo usa uno o más repositorios de almacenamiento compartidos para que las máquinas virtuales que se ejecutan en un host del grupo se puedan migrar casi en tiempo real a otro host del grupo. Esta migración se produce mientras la VM sigue en ejecución, sin que sea necesario apagarla y volver a activarla. Cada servidor de Citrix Hypervisor es en realidad un grupo que consta de un solo miembro de forma predeterminada. Cuando el servidor de Citrix Hypervisor se une a un grupo, se designa como miembro y el grupo al que se ha unido se convierte en el maestro del grupo.

El objeto de agrupación singleton se puede enumerar con el comando estándar de listado de objetos (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 de la agrupación

Los grupos tienen los siguientes parámetros:

Nombre del parámetro Descripción Tipo
uuid La referencia única de identificador/objeto para el grupo Solo lectura
name-label El nombre de la agrupación Lectura/Escritura
name-description La cadena de descripción de la agrupación Lectura/Escritura
master La referencia única de identificador/objeto del servidor de Citrix Hypervisor designado como maestro del grupo Solo lectura
default-SR La referencia única de identificador/objeto del SR predeterminado para el grupo Lectura/Escritura
crash-dump-SR La referencia única de identificador/objeto del SR donde se guardan los volcados de memoria para los miembros del grupo Lectura/Escritura
metadata-vdis Todos los VDI de metadatos conocidos para el grupo Solo lectura
suspend-image-SR La referencia única de identificador/objeto del SR donde se guardan las VM suspendidas en los miembros del grupo Lectura/Escritura
other-config Una lista de pares clave/valor que especifican parámetros de configuración adicionales para el grupo Parámetro de mapa de lectura y escritura
supported-sr-types Tipos de SR que puede usar este grupo Solo lectura
ha-enabled True si la alta disponibilidad está habilitada para el grupo, falso en caso contrario Solo lectura
ha-configuration Reservado para uso futuro. Solo lectura
ha-statefiles Enumera los UUID de los VDI que utiliza HA para determinar el estado del almacenamiento Solo lectura
ha-host-failures-to-tolerate La cantidad de errores de host que se deben tolerar antes de enviar una alerta del sistema Lectura/Escritura
ha-plan-exists-for El número de fallos de hosts que realmente se pueden gestionar, de acuerdo con los cálculos del algoritmo de alta disponibilidad Solo lectura
ha-allow-overcommit True si se permite que el grupo se comprometa en exceso, False en caso contrario Lectura/Escritura
ha-overcommitted True si el grupo está sobrecomprometido Solo lectura
blobs almacén de datos binarios Solo lectura
live-patching-disabled Se establece en False para habilitar la aplicación de parches en vivo. Establézcala en True para inhabilitar la aplicación de parches en vivo. Lectura/Escritura
igmp-snooping-enabled Se establece en True para habilitar la indagación IGMP. Establézcala en False para inhabilitar la indagación IGMP. Lectura/Escritura
https-only Establézcalo en False para permitir que los clientes externos que usan la API de administración se conecten a Citrix Hypervisor mediante HTTPS a través del puerto 443 o HTTP a través del puerto 80. Establézcalo en True para bloquear el puerto 80 y exigir que los clientes se conecten exclusivamente mediante HTTPS a través del puerto 443. Lectura/Escritura

pool-apply-edition

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

Aplica una edición en toda la agrupación.

pool-certificate-install

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

Instale un certificado TLS en todo el grupo.

pool-certificate-list

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

Enumera todos los certificados TLS instalados en un grupo.

pool-certificate-sync

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

Sincronice los certificados TLS y las listas de revocación de certificados del maestro del grupo con los demás miembros del grupo.

pool-certificate-uninstall

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

Desinstale un certificado TLS.

pool-crl-install

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

Instale una lista de revocación de certificados TLS para todo el grupo.

pool-crl-list

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

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

pool-crl-uninstall

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

Desinstale una lista de revocación de certificados TLS.

pool-deconfigure-wlb

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

Elimine permanentemente la configuración para equilibrar la carga de trabajo.

pool-designate-new-master

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

Indique al servidor de Citrix Hypervisor miembro especificado que se convierta en el maestro de un grupo existente. Este comando realiza un traspaso ordenado de la función de host principal a otro host del grupo de recursos. Este comando solo funciona cuando el maestro actual está en línea. No reemplaza los comandos del modo de emergencia que se enumeran a continuación.

pool-disable-external-auth

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

Inhabilita la autenticación externa en todos los hosts de un grupo.

pool-disable-local-storage-caching

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

Inhabilite el almacenamiento en caché local en todo el grupo.

pool-disable-redo-log

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

Inhabilite el registro de rehacer si se está usando, a menos que se habilite HA.

pool-dump-database

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

Descargue una copia de toda la base de datos del grupo y viértala 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-->

Permite la autenticación externa en todos los hosts de un grupo. 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-->

Habilite el almacenamiento en caché local en todo el grupo.

pool-enable-redo-log

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

Habilite el registro de rehacer en el SR dado si está en uso, a menos que la alta disponibilidad esté habilitada.

pool-eject

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

Indique al servidor de Citrix Hypervisor especificado que abandone un grupo existente.

pool-emergency-reset-master

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

Indique a un servidor miembro del grupo que restablezca su dirección de servidor maestro al nuevo valor e intente conectarse a él. No ejecute este comando en servidores maestros.

pool-emergency-transition-to-master

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

Indique a un servidor de Citrix Hypervisor miembro que se convierta en el maestro del grupo. El servidor de Citrix Hypervisor 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 maestro ha desaparecido de la red y no se puede contactar con él después de varios intentos.

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

pool-ha-enable

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

Habilite la alta disponibilidad en la agrupación de recursos, mediante el UUID SR especificado como repositorio de latido de almacenamiento central.

pool-ha-disable

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

Inhabilita 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 errores de host que se deben tolerar en la configuración de grupo actual.

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 la cantidad máxima de errores de host que se deben 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-->

Inicialice el equilibrio de carga de trabajo del 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 servidor de Citrix Hypervisor 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 que usen la interfaz de red especificada, que es la interfaz que se usa 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 del dispositivo de una interfaz (que debe tener una dirección IP), el host maestro de Citrix Hypervisor se vuelve a enlazar inmediatamente. Este comando funciona tanto en modo normal como de emergencia.

A partir del UUID de red especificado, el UUID del objeto PIF se identifica y se asigna al servidor de Citrix Hypervisor, que determina qué dirección IP se debe volver a vincular a sí mismo. No debe estar en modo de emergencia cuando se ejecute 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 uno primero. De lo contrario, los comandos CLI posteriores no pueden llegar al servidor de Citrix Hypervisor.

pool-recover-slaves

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

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

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 base de datos (creada con pool-dump-database) en un grupo. Al recibir la carga, el maestro 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 la operación. De forma predeterminada, dry-run se establece en false.

pool-retrieve-wlb-configuration

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

Recupera los criterios de optimización del grupo 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 recomendaciones de migración de VM para el grupo desde el servidor de equilibrio de carga de trabajo.

pool-retrieve-wlb-report

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

Recupera informes del servidor de equilibrio de carga de trabajo.

pool-secret-rotate

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

Gira el secreto de la agrupación.

El secreto del grupo es un secreto compartido entre los servidores de un grupo que permite al servidor demostrar su pertenencia a un grupo. Los usuarios con la función de administrador del grupo pueden ver este secreto cuando se conectan al servidor a través de SSH. Rote el secreto del grupo si uno de estos usuarios abandona su organización o pierde su función de administrador del grupo.

pool-send-test-post

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

Envíe el cuerpo dado al host y puerto dados, mediante HTTPS, e imprima la respuesta. Se usa para depurar la capa TLS.

pool-send-wlb-configuration

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

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

pool-sync-database

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

Forzar la sincronización de la base de datos del grupo en todos los hosts del grupo 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.

igmp-snooping-enabled

xe pool-param-set [uuid=pool-uuid] [igmp-snooping-enabled=true|false]
<!--NeedCopy-->

Habilita o inhabilita la indagación IGMP en un grupo de Citrix Hypervisor.

https-only

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

Habilita o inhabilita el bloqueo del puerto 80 en la interfaz de administración de los hosts de Citrix Hypervisor.

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

Configure una memoria caché de PVS en un SR determinado para un host determinado.

pvs-cache-storage-destroy

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

Elimina una memoria caché de PVS.

pvs-proxy-create

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

Configure una VM/VIF para que use un proxy PVS.

pvs-proxy-destroy

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

Elimine (o apague) un proxy PVS para esta VIF/VM.

pvs-server-forget

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

Olvídese de 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 un nuevo servidor PVS.

pvs-site-forget

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

Olvídate de un sitio PVS.

pvs-site-introduce

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

Presentamos el nuevo sitio de PVS.

comandos de Storage Manager

Comandos para controlar los complementos de Storage Manager.

Los objetos del administrador de almacenamiento se pueden enumerar 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 SM

Los SM tienen los siguientes parámetros:

Nombre del parámetro Descripción Tipo
uuid La referencia única de identificador/objeto para el complemento SM Solo lectura
name-label El nombre del complemento SM Solo lectura
name-description La cadena de descripción del complemento SM Solo lectura
type El tipo de SR al que se conecta este complemento Solo lectura
vendor Nombre del proveedor que creó este complemento Solo lectura
copyright Declaración de derechos de autor para este complemento SM Solo lectura
required-api-version Se requiere una versión mínima de la API de SM en el servidor de Citrix Hypervisor Solo lectura
configuration Nombres y descripciones de las claves de configuración de dispositivos Solo lectura
capabilities Capacidades del complemento SM Solo lectura
driver-filename Nombre de archivo del controlador SR. Solo lectura

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 mediante la clonación de una instantánea existente, mediante la operación de clonación rápida de discos en el 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-->

Cree 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 máquina virtual copiada serán “imágenes completas”, es decir, no formarán parte de una cadena CoW.

snapshot-destroy

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

Destruye una instantánea. Esto deja intacto el almacenamiento asociado a la instantánea. Para eliminar el almacenamiento también, 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-->

Enumera los discos en las VM seleccionadas.

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 un nombre de archivo.

snapshot-reset-powerstate

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

Forzar que el estado de energía de la VM se detenga solo en la base de datos de la pila de herramientas Este comando se usa para recuperar una instantánea que está marcada como “suspendida”. Se trata de una operación potencialmente peligrosa: debe asegurarse de que ya no necesita la imagen de memoria. Ya no podrás reanudar la 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-->

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

Comandos SR

Comandos para controlar los SR (repositorios de almacenamiento).

Los objetos de SR se pueden enumerar con el comando estándar de lista de objetos (xe sr-list) y los parámetros manipulados 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:

Nombre del parámetro Descripción Tipo
uuid La referencia única de identificador/objeto para el SR Solo lectura
name-label El nombre de la SR Lectura/Escritura
name-description La cadena de descripción de la SR Lectura/Escritura
host Nombre de host del repositorio de almacenamiento Solo lectura
allowed-operations Lista de las operaciones permitidas en el SR en este estado Parámetro de conjunto de solo lectura
current-operations Lista de las operaciones que están actualmente en curso en este SR Parámetro de conjunto de solo lectura
VDIs Referencia única de identificador/objeto para los discos virtuales de esta SR Parámetro de conjunto de solo lectura
PBDs Referencia de identificador/objeto única para los PBD adjuntos a este SR Parámetro de conjunto de solo lectura
virtual-allocation Suma de los valores de tamaño virtual de todos los VDI en este repositorio de almacenamiento (en bytes) Solo lectura
physical-utilisation Espacio físico utilizado actualmente en este SR, en bytes. Para los formatos de disco de aprovisionamiento delgado, la utilización física puede ser inferior a la asignación virtual. Solo lectura
physical-size Tamaño físico total de la SR, en bytes Solo lectura
type Tipo de SR, que se utiliza para especificar el controlador de back-end de SR que se va a usar Solo lectura
content-type El tipo de contenido de la SR. Se utiliza para distinguir las bibliotecas ISO de otras SR. Para los repositorios de almacenamiento que almacenan una biblioteca de ISO, se content-typedebe establecer eniso. En otros casos, le recomendamos que establezca este parámetro en vacío o en el usuario de cadena. Solo lectura
shared Es cierto si este SR se puede compartir entre varios servidores Citrix Hypervisor. De lo contrario, es falso. Lectura/Escritura
introduced-by El drtask (si lo hay) que introdujo el SR Solo lectura
is-tools-sr Cierto si se trata del SR que contiene los VDI ISO de Tools. De lo contrario, es falso. Solo lectura
other-config Lista de pares clave/valor que especifican parámetros de configuración adicionales para el SR Parámetro de mapa de lectura y escritura
sm-config Datos dependientes de SM Parámetro de mapa de solo lectura
blobs almacén de datos binarios Solo lectura
local-cache-enabled Verdadero si este SR está asignado como la caché local de su host. De lo contrario, es falso. Solo lectura
tags Etiquetas especificadas por el usuario para fines de categorización Parámetro establecido de lectura/escritura
clustered Es cierto que el SR utiliza almacenamiento local agregado. De lo contrario, es falso. Solo lectura

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 servidor de Citrix Hypervisor. Sishared se establece en true, se crea un PBD para cada servidor de Citrix Hypervisor del grupo. Si noshared se especifica o se establece en false, solo se crea un PBD para el servidor de Citrix Hypervisor especificado conhost-uuid.

Los parámetros device-config exactos difieren según el dispositivo type. Para obtener más información sobre estos parámetros en los distintos back-ends de almacenamiento, consulte Crear una SR .

sr-data-source-forget

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

Deje de grabar la fuente de datos especificada para una SR y olvide todos los datos grabados.

sr-data-source-list

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

Enumere las fuentes de datos que se pueden grabar para una SR.

sr-data-source-query

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

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

sr-data-source-record

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

Registre la fuente de datos especificada para un SR.

sr-destroy

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

Destruye el SR especificado en el servidor de Citrix Hypervisor.

sr-enable-database-replication

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

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

sr-disable-database-replication

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

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

sr-forget

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

El agente XAPI olvida un SR especificado en el servidor de Citrix Hypervisor. Cuando el agente XAPI olvida un SR, el SR se separa y no puede acceder a los VDI en él, pero permanece intacto 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 SR en la base de datos. Use device-config para especificar parámetros adicionales en la forma device-config:parameter_key=parameter_value. Por ejemplo:

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

Nota:

Este comando nunca se usa en funcionamiento normal. Esta operación avanzada puede ser útil cuando un SR debe reconfigurarse como compartido después de que se creó o para ayudar a recuperarse de varios casos de error.

sr-probe

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

Realiza un escaneo del backend con las claves device-config proporcionadas. Si el comando device-config devuelve una lista de los SRs presentes en el dispositivo, si los hay. Si losdevice-config parámetros son solo parciales, se realiza un análisis específico de back-end, que devuelve resultados que le guiarán en la mejora de losdevice-config parámetros restantes. Los resultados del análisis se devuelven como XML específico para el back-end, impresos en la CLI.

Los parámetros device-config exactos difieren según el dispositivo type. Para obtener detalles de estos parámetros en los diferentes back-ends 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-->

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

sr-scan

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

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

sr-update

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

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

Habilite el aprovisionamiento ligero en una SR LVHD.

Comandos de materia

Comandos para trabajar con sujetos.

session-subject-identifier-list

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

Devuelve una lista de todos los identificadores 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-->

Cierre sesión en todas las sesiones autenticadas externamente asociadas a un identificador de asunto de usuario.

session-subject-identifier-logout-all

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

Cierre sesión en todas las sesiones autenticadas externamente.

subject-add

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

Agregue un tema a la lista de temas que pueden acceder al grupo.

subject-remove

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

Elimina un tema de la lista de temas que pueden acceder al grupo.

subject-role-add

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

Agrega una función a una asignatura.

subject-role-remove

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

Elimina una función de una asignatura.

secret-create

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

Crea un secreto.

secret-destroy

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

Destruye un secreto.

Comandos de tareas

Comandos para trabajar con tareas asíncronas de larga ejecución. Estos comandos son tareas como iniciar, detener y suspender una máquina virtual. Las tareas se componen típicamente de un conjunto de otras subtareas atómicas que juntas llevan a cabo la operación solicitada.

Los objetos de tarea se pueden enumerar con el comando estándar de listado de objetos (xe task-list) y los parámetros manipulados 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 tareas

Las tareas tienen los siguientes parámetros:

Nombre del parámetro Descripción Tipo
uuid La referencia única de identificador/objeto para la tarea Solo lectura
name-label El nombre de la tarea Solo lectura
name-description La cadena de descripción de la tarea Solo lectura
resident-on La referencia única de identificador/objeto del host en el que se ejecuta la tarea Solo lectura
status Estado de la tarea Solo lectura
progress Si la tarea sigue pendiente, este campo contiene el porcentaje estimado completado, de 0 a 1. Si la tarea se ha completado, con éxito o sin éxito, el valor es 1. Solo lectura
type Si la tarea se ha completado correctamente, este parámetro contiene el tipo de resultado codificado. El tipo es el nombre de la clase cuya referencia se encuentra en el campo de resultados. De lo contrario, el valor de este parámetro no está definido Solo lectura
result Si la tarea se ha completado correctamente, este campo contiene el valor del resultado, ya sea Nulo o una referencia a objeto; de lo contrario, el valor de este parámetro no está definido Solo lectura
error_info Si la tarea ha fallado, este parámetro contiene el conjunto de cadenas de error asociadas. De lo contrario, el valor de este parámetro no está definido Solo lectura
allowed_operations Lista de las operaciones permitidas en este estado Solo lectura
created Hora en que se creó la tarea Solo lectura
finished Hora de finalización de la tarea (es decir, correcta o fallida). Si el estado de la tarea está pendiente, el valor de este campo no tiene significado Solo lectura
subtask_of Contiene el UUID de las tareas de las que esta tarea es una subtarea Solo lectura
subtasks Contiene los UUID de todas las subtareas de esta tarea Solo lectura

task-cancel

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

Indique a la tarea especificada que se cancele y devuelva.

Comandos de plantilla

Comandos para trabajar con plantillas de VM.

Las plantillas son esencialmente máquinas virtuales con el parámetro is-a-template establecido en true. Una plantilla es una “imagen dorada” que contiene todas las distintas opciones de configuración para crear instancias de una VM específica. Citrix Hypervisor incluye un conjunto básico de plantillas, que son máquinas virtuales genéricas “sin formato” 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 formularios estándar para sus necesidades particulares y guardar una copia de ellas como plantillas para usarlas en el futuro en la implementación de máquinas virtuales.

Los objetos de plantilla se pueden enumerar con el comando estándar de listado de objetos (xe template-list) y los parámetros manipulados 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 se admite y resulta en una máquina virtual que no se puede iniciar.

Parámetros de plantilla de VM

Las plantillas tienen los siguientes parámetros:

  • uuid (solo lectura) la referencia única de identificador/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) para creadores de máquinas virtuales y plantillas para poner información de versión
  • is-a-template (lectura/escritura) true si esta máquina virtual es una plantilla. Las VM de plantilla nunca se pueden iniciar, solo se usan para clonar otras VM. Una vez que este valor se ha establecido en verdadero, no se puede restablecer en falso. Las máquinas virtuales de plantilla no se pueden convertir en máquinas virtuales con 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) true 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 se detiene para una plantilla
  • memory-dynamic-max (solo lectura) memoria dinámica máxima en bytes. Actualmente no se utiliza, pero si se cambia, se debe cumplir 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. No se usa actualmente, pero, si se cambia, se deben cumplir las mismas restricciones para memory-dynamic-max.
  • memory-static-max (lectura/escritura) establece estáticamente (absoluta) la memoria máxima en bytes. Este campo es el valor principal que se utiliza para determinar la cantidad de memoria asignada a una VM.
  • memory-static-min (lectura/escritura) establece estáticamente la memoria mínima (absoluta) en bytes. Este campo representa la memoria mínima absoluta y memory-static-min debe ser inferior a memory-static-max. Este valor no se utiliza en el funcionamiento normal, pero se debe cumplir la restricción anterior.
  • suspend-VDI-uuid (solo lectura) la VDI en la que está almacenada una imagen suspendida (no significa nada para una plantilla)
  • VCPUs-params (parámetro de mapa de lectura/escritura) para la directiva de vCPU seleccionada.

    Puede ajustar la fijación de una vCPU con:

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

    Una máquina virtual creada a partir de esta plantilla se ejecuta solo en las CPU físicas 1, 2 y 3.

    También puede ajustar la prioridad de la vCPU (programación xen) con los parámetros de límite y peso. Por ejemplo:

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

    Una máquina virtual basada en esta plantilla con un peso de 512 obtiene el doble de CPU que un dominio con un peso de 256 en un host con competencia. Los pesos legales varían de 1 a 65535 y el valor predeterminado es 256.

    El límite fija opcionalmente la cantidad máxima de CPU que puede consumir una máquina virtual basada en esta plantilla, incluso si el servidor de Citrix Hypervisor tiene ciclos de CPU inactivos. El límite se expresa en porcentaje de una CPU física: 100 es 1 CPU física, 50 es media CPU, 400 son 4 CPU, etc. El valor predeterminado, 0, significa que no hay límite superior.

  • VCPUs-max (lectura/escritura) cantidad máxima de vCPU
  • VCPUs-at-startup (lectura/escritura) número de arranque de vCPU
  • actions-after-crash (lectura/escritura) que se debe realizar cuando una máquina virtual basada en esta plantilla se bloquea
  • console-uuids (parámetro establecido de solo lectura) dispositivos de consola virtual
  • platform (parámetro de mapa de lectura/escritura) configuración específica de la plataforma

    Para inhabilitar la emulación de un puerto paralelo para huéspedes HVM (por ejemplo, invitados de Windows):

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

    Para inhabilitar la emulación de un puerto serie para huéspedes HVM:

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

    Para inhabilitar la emulación de un controlador USB y un dispositivo de tableta USB para huéspedes HVM:

     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 conjunto de solo lectura) de identificadores VBD disponibles para su uso, representados por enteros del rango 0—15. Esta lista es solo informativa y se pueden usar otros dispositivos (pero puede que no funcionen).
  • allowed-VIF-devices (parámetro conjunto de solo lectura) de identificadores VIF disponibles para su uso, representados por enteros del rango 0—15. Esta lista es solo informativa y se pueden usar otros dispositivos (pero puede que no funcionen).
  • HVM-boot-policy (lectura/escritura) la directiva de arranque para invitados HVM. Orden de BIOS o una cadena vacía.
  • HVM-boot-params (parámetro del mapa de lectura/escritura) la tecla de orden controla el orden de arranque del invitado HVM, representado como una cadena en la que 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 por defecto es dc.
  • PV-kernel (lectura/escritura) al núcleo
  • PV-ramdisk (lectura/escritura) a la initrd
  • PV-args (lectura/escritura) de argumentos de línea de comandos del núcleo
  • PV-legacy-args (lectura/escritura) de argumentos para hacer que las máquinas virtuales heredadas basadas en esta plantilla se inicien
  • PV-bootloader (lectura/escritura) nombre o ruta al gestor de arranque
  • PV-bootloader-args (lectura/escritura) de argumentos varios para el gestor de arranque
  • last-boot-CPU-flags (solo lectura) describe los indicadores de CPU en los que se arrancó por última vez una máquina virtual basada en esta plantilla; no se rellenó para una plantilla
  • resident-on (solo lectura) el servidor de Citrix Hypervisor en el que reside una máquina virtual basada en esta plantilla. Aparece como not in database para una plantilla
  • affinity (lectura/escritura) el servidor de Citrix Hypervisor 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 VM
  • 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 basadas en esta plantilla, en el formulario yyyymmddThh:mm:ss z, donde z es el indicador de zona horaria militar de una sola letra, por ejemplo, Z para UTC (GMT). Establecer en 1 Jan 1970 Z (comienzo 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 basadas en esta plantilla, en el formulario yyyymmddThh:mm:ss z, donde z es el indicador de zona horaria militar de una sola letra, por ejemplo, Z para UTC (GMT). Establecer en 1 Jan 1970 Z (comienzo de la época UNIX/POSIX) para una plantilla
  • memory-actual (solo lectura) la memoria real que utiliza una VM basada en esta plantilla; 0 para una plantilla
  • VCPUs-number (solo lectura) el número de CPU virtuales asignadas a una máquina virtual basada en esta plantilla; 0 para una plantilla
  • VCPUs-Utilization (parámetro de asignación de solo lectura) Lista de CPU virtuales y su parámetro de peso de asignación de solo lectura os-version La versión del sistema operativo para una máquina virtual 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) para la última versión de los controladores paravirtualizados para una máquina virtual basada en esta plantilla. Aparece como not in database para una plantilla
  • memory (parámetro de mapa de solo lectura) métricas de memoria notificadas por el agente en una máquina virtual 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 máquina virtual 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 máquina virtual basada en esta plantilla. Aparece como not in database para una plantilla
  • other (parámetro de mapa de solo lectura) otras métricas notificadas por el agente en una máquina virtual 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 formulario 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) que se debe realizar después de que la máquina virtual se haya apagado
  • actions-after-reboot (lectura/escritura) que se debe realizar después de que la VM se haya reiniciado
  • possible-hosts (solo lectura) lista de hosts que potencialmente pueden alojar la VM
  • HVM-shadow-multiplier (lectura/escritura) se aplica a la cantidad de sombra que se pone a disposición del huésped
  • 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 máquina virtual
  • xenstore-data (parámetro de asignación de lectura/escritura) Datos que se insertarán en el árbol xenstore (/local/domain/*domid*/vmdata) después de crear la máquina virtual.
  • is-a-snapshot (solo lectura) True si esta plantilla es una instantánea de VM
  • snapshot_of (solo lectura) el UUID de la máquina virtual 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 objetivo de memoria establecida para esta plantilla
  • blocked-operations (parámetro de mapa de lectura/escritura) muestra las operaciones que no se pueden realizar en esta plantilla
  • last-boot-record (solo lectura) de los últimos parámetros de arranque para esta plantilla, en formato XML
  • ha-always-run (lectura/escritura) True si una instancia de esta plantilla siempre se reinicia en otro host si se produce un error en el host en el que reside. Este parámetro ahora está en desuso. Utilice el parámetro ha-restartpriority en su lugar.
  • ha-restart-priority (solo lectura) reinicio o lo mejor que se pueda hacer con almacenes de datos binarios de blobs de lectura/escritura
  • 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 nombre de archivo nuevo especificado.

template-uninstall

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

Desinstale una plantilla personalizada. Esta operación destruirá los VDI que estén marcados como “propiedad” de esta plantilla.

Comandos de actualización

La siguiente sección contiene los comandos de actualización del servidor de Citrix Hypervisor.

Los objetos de actualización se pueden enumerar con el comando estándar de listado de objetos (xe update-list) y los parámetros manipulados 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 servidor de Citrix Hypervisor tienen los siguientes parámetros:

Nombre del parámetro Descripción Tipo
uuid La referencia única de identificador/objeto para la actualización Solo lectura
host La lista de hosts a los que se aplica esta actualización Solo lectura
host-uuid El identificador único para que el servidor de Citrix Hypervisor consulte Solo lectura
name-label El nombre de la actualización Solo lectura
name-description La cadena de descripción de la actualización Solo lectura
applied Si la actualización se ha aplicado o no; verdadero o falso Solo lectura
installation-size El tamaño de la actualización en bytes Solo lectura
after-apply-guidance Si la pila de herramientas XAPI o el host requieren un reinicio Solo lectura
version La versión de la actualización Solo lectura

update-upload

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

Cargue un archivo de actualización especificado en el servidor de Citrix Hypervisor. Este comando prepara una actualización para aplicarla. Si tiene éxito, se imprime el UUID de la actualización cargada. Si la actualización se cargó anteriormente, se devuelve un error UPDATE_ALREADY_EXISTS y el parche no se vuelve a cargar.

update-precheck

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

Ejecute las comprobaciones previas contenidas en la actualización especificada en el servidor de Citrix Hypervisor 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-->

Aplica el archivo de actualización especificado.

update-pool-apply

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

Aplique la actualización especificada a todos los servidores de Citrix Hypervisor del grupo.

update-introduce

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

Introduce la actualización de VDI.

update-pool-clean

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

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

Comandos del 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 anterior no está marcado porque necesita privilegios de supervisor para usar este comando.

Comandos de VBD

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

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

Los objetos de VBD se pueden enumerar con el comando estándar de lista de objetos (xe vbd-list) y los parámetros manipulados 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:

Nombre del parámetro Descripción Tipo
uuid La referencia única de identificador/objeto para el VBD Solo lectura
vm-uuid La referencia de identificador/objeto única para la máquina virtual a la que está conectado este VBD Solo lectura
vm-name-label El nombre de la máquina virtual a la que está conectado este VBD Solo lectura
vdi-uuid La referencia de identificador/objeto única para la VDI a la que se asigna este VBD Solo lectura
vdi-name-label El nombre de la VDI a la que se asigna este VBD Solo lectura
empty Si true, este VBD representa una unidad vacía Solo lectura
device El dispositivo que ve el invitado, por ejemplo hda Solo lectura
userdevice Número de dispositivo especificado por el parámetro de dispositivo durante vbd-create, por ejemplo hda, 0 para hdb, 1 para, etc. Lectura/Escritura
bootable True si este VBD es de arranque Lectura/Escritura
mode El modo con el que se monta el VBD Lectura/Escritura
type Cómo se ve el VBD en la VM, por ejemplo, disco o CD Lectura/Escritura
currently-attached True si el VBD está conectado a este host, falso en caso contrario Solo lectura
storage-lock True si se adquirió un bloqueo a nivel de almacenamiento Solo lectura
status-code Código de error/éxito asociado a la última operación de conexión Solo lectura
status-detail Información de error/éxito asociada con el estado de la última operación de conexión Solo lectura
qos_algorithm_type El algoritmo de priorización a utilizar Lectura/Escritura
qos_algorithm_params Parámetros del algoritmo de priorización elegido Parámetro de mapa de lectura y escritura
qos_supported_algorithms Algoritmos de priorización compatibles para este VBD Parámetro de conjunto de solo lectura
io_read_kbs Velocidad media de lectura en kb por segundo para este VBD Solo lectura
io_write_kbs Velocidad media de escritura en kb por segundo para este VBD Solo lectura
allowed-operations Lista de las operaciones permitidas en este estado. Esta lista es solo consultiva y es posible que el estado del servidor haya cambiado para cuando un cliente lea este campo. Parámetro de conjunto de solo lectura
current-operations Vincula cada una de las tareas en ejecución que utilizan este objeto (por referencia) a una enumeración current_operation que describe la naturaleza de la tarea. Parámetro de conjunto de solo lectura
unpluggable True si este VBD admite la desconexión en caliente Lectura/Escritura
attachable True si el dispositivo se puede conectar Solo lectura
other-config Configuración extra Parámetro de mapa de lectura y escritura

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

Crea un VBD en una VM.

Los valores permitidos para el campo device son enteros 0—15, y el número debe ser único para cada máquina virtual. 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, vdi-uuid es necesario. El modo puede ser RO o RW para un disco.

Si el type es CD, vdi-uuid es opcional. Si no se especifica 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-->

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

Retire los medios de 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-insert

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

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

Intente conectar el VBD mientras la máquina virtual se encuentra en estado de ejecución.

vbd-unplug

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

Intenta desconectar el VBD de la VM mientras está en ejecución.

Comandos de VDI

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

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

Los objetos de VDI se pueden enumerar con el comando estándar de lista de objetos (xe vdi-list) y los parámetros manipulados 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:

Nombre del parámetro Descripción Tipo
uuid La referencia única de identificador/objeto para la VDI Solo lectura
name-label El nombre de la VDI Lectura/Escritura
name-description La cadena de descripción de la VDI Lectura/Escritura
allowed-operations Una lista de las operaciones permitidas en este estado Parámetro de conjunto de solo lectura
current-operations Una lista de las operaciones que están actualmente en curso en esta VDI Parámetro de conjunto de solo lectura
sr-uuid SR en la que reside la VDI Solo lectura
vbd-uuids Una lista de VBD que hacen referencia a este VDI Parámetro de conjunto de solo lectura
crashdump-uuids Lista de volcados de memoria que hacen referencia a este VDI Parámetro de conjunto de solo lectura
virtual-size Tamaño del disco tal como se presenta a la máquina virtual, en bytes. Según el tipo de back-end de almacenamiento, es posible que el tamaño no se respete exactamente Solo lectura
physical-utilisation Cantidad de espacio físico que la VDI ocupa en el SR, en bytes Solo lectura
type Tipo de VDI, por ejemplo, sistema o usuario Solo lectura
sharable True si este VDI se puede compartir Solo lectura
read-only True si este VDI solo se puede montar en modo de solo lectura Solo lectura
storage-lock True si este VDI está bloqueado en el nivel de almacenamiento Solo lectura
parent Hace referencia a la VDI principal cuando esta VDI forma parte de una cadena Solo lectura
missing True si la operación de exploración SR informó que este VDI no estaba presente Solo lectura
other-config Información de configuración adicional para este VDI Parámetro de mapa de lectura y escritura
sr-name-label Nombre del repositorio de almacenamiento que lo contiene Solo lectura
location Información de ubicación Solo lectura
managed True si se administra la VDI Solo lectura
xenstore-data Datos que se insertarán en el árbol xenstore (/local/domain/0/backend/ vbd/domid/device-id/smdata) después de conectar la VDI. Los back-ends SM generalmente establecen este campo en vdi_attach. Parámetro de mapa de solo lectura
sm-config Datos dependientes de SM Parámetro de mapa de solo lectura
is-a-snapshot True si este VDI es una instantánea de almacenamiento de VM Solo lectura
snapshot_of El UUID del almacenamiento del que este VDI es una instantánea Solo lectura
snapshots Los UUID de todas las instantáneas de este VDI Solo lectura
snapshot_time La marca de tiempo de la operación de instantánea que creó esta VDI Solo lectura
metadata-of-pool El uuid del grupo que creó este VDI de metadatos Solo lectura
metadata-latest Marca que indica si la VDI contiene los últimos metadatos conocidos para este grupo Solo lectura
cbt-enabled Bandera que indica si el seguimiento de bloques modificados está habilitado para la VDI Lectura/Escritura

vdi-clone

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

Cree una nueva copia en la que se pueda escribir de la VDI especificada que se pueda usar directamente. Es una variante de vdi-copy que puede exponer instalaciones de clonación de imágenes de alta velocidad donde existan.

Utilice el parámetro de asignación driver-params opcional para pasar información de configuración adicional específica del proveedor al controlador de almacenamiento 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-->

Copie un VDI en 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-->

Crea una VDI.

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

Nota:

Los tipos de SR que admiten el aprovisionamiento controlado de discos (como VHD local y NFS) no imponen la asignación virtual de discos. Tenga mucho cuidado al sobreasignar espacio de disco virtual en un SR. Si un SR sobreasignado se llena, el espacio en disco debe estar disponible en el sustrato de destino de SR o eliminando los VDI no utilizados en el SR.

Algunos tipos SR pueden 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-->

Destruya los datos asociados a la VDI especificada, pero conserve los metadatos de seguimiento de bloques modificados.

Nota:

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

vdi-destroy

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

Destruya el VDI especificado.

Nota:

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

Para los tipos de SR de VHD local y NFS, el espacio en disco no se libera inmediatamente vdi-destroy, sino periódicamente durante una operación de exploración del repositorio de almacenamiento. Si debe forzar la disponibilidad del espacio en disco eliminado, llame sr-scan manualmente.

vdi-disable-cbt

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

Inhabilite el seguimiento de bloques cambiados para la VDI.

vdi-enable-cbt

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

Habilite el seguimiento de bloques modificados para la VDI.

Nota:

Puede habilitar el seguimiento de bloques cambiados solo en instancias con licencia de Citrix Hypervisor 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 una VDI al nombre de archivo especificado. Puede exportar un VDI en uno de los siguientes formatos:

  • raw
  • vhd

El formato VHD puede ser escaso. Si hay bloques sin asignar en la VDI, es posible que estos bloques se omita en el archivo VHD, lo que reduce el tamaño del archivo VHD. Puede exportar a formato VHD desde todos los tipos de almacenamiento compatibles basados en VHD (EXT3/EXT4, NFS).

Si especifica el comando base exporta solo los 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-->

Importe 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 ningún almacenamiento. Este comando se usa principalmente de forma interna para introducir automáticamente dispositivos de almacenamiento conectables 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 los dos como una cadena codificada en base64. Este comando solo funciona para los VDI que han cambiado el seguimiento de bloques habilitado.

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 de almacenamiento en vivo)

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

Cambia el tamaño del VDI especificado por el UUID.

vdi-snapshot

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

Produce una versión de lectura y escritura de una VDI que se puede utilizar como referencia para crear copias de seguridad o plantillas, o ambas cosas. Use la instantánea para realizar una copia de seguridad en lugar de instalar y ejecutar el software de copia de seguridad dentro de la VM. La VM sigue ejecutándose mientras el software de reserva externo transmite el contenido de la instantánea a los medios de reserva. Del mismo modo, una instantánea se puede usar como una “imagen dorada” en la que basar una plantilla. Se puede crear una plantilla con cualquier VDI.

Utilice el parámetro de asignación driver-params opcional para pasar información de configuración adicional específica del proveedor al controlador de almacenamiento 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 una VDI grabable.

vdi-unlock

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

Intenta desbloquear los VDI especificados. Si force=true se pasa 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 de VIF se pueden enumerar con el comando estándar de lista de objetos (xe vif-list) y los parámetros manipulados 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) la referencia única de identificador/objeto para el VIF
  • vm-uuid (solo lectura) la referencia única de identificador/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 set de solo lectura) una lista de las operaciones permitidas en este estado
  • current-operations (parámetro establecido de solo lectura) una lista de las operaciones que están actualmente en curso en este VIF
  • device (solo lectura) etiqueta de entero de este VIF, que indica el orden en que se crearon los back-ends de VIF
  • MAC (solo lectura) Dirección MAC de VIF, tal como se expone a la VM
  • MTU (solo lectura) Unidad de transmisión máxima del VIF en bytes.

    Este parámetro es de solo lectura, pero puede anular la configuración de MTU con la clave mtu mediante el parámetro de asignación other-config. Por ejemplo, para restablecer la MTU en una NIC virtual para que use tramas gigantes:

     xe vif-param-set \
         uuid=<vif_uuid> \
         other-config:mtu=9000
     <!--NeedCopy-->
    
  • currently-attached (solo lectura) true si el dispositivo está conectado
  • qos_algorithm_type (lectura/escritura) Algoritmo de QoS a usar
  • qos_algorithm_params (parámetro de mapa de lectura/escritura) parámetros para el algoritmo QoS elegido
  • qos_supported_algorithms (parámetro establecido de solo lectura) algoritmos de QoS compatibles para este VIF
  • MAC-autogenerated (solo lectura) True si la dirección MAC del VIF se generó automáticamente
  • other-config (parámetro de mapa de lectura/escritura) pares key:value de configuración adicionales
  • other-config:ethtoolrx (lectura/escritura) establecido en activado para activar la suma de comprobación de recepción, desactivado para inhabilitar
  • other-config:ethtooltx (lectura/escritura) establecido en activado para habilitar la suma de comprobación de transmisión, desactivado para inhabilitar
  • other-config:ethtoolsg (lectura/escritura) se activa para habilitar la recopilación de dispersión, desactiva para inhabilitar
  • other-config:ethtooltso (lectura/escritura) establecido en activado para habilitar la descarga de segmentación de TCP, desactivado para inhabilitar
  • other-config:ethtoolufo (lectura/escritura) establecido en activado para habilitar la descarga de fragmentos UDP, desactivado para inhabilitar
  • other-config:ethtoolgso (lectura/escritura) establecido en activado para habilitar la descarga de segmentación genérica, desactivado para inhabilitar
  • other-config:promiscuous (lectura/escritura) true para que un VIF sea promiscuo en el puente, de modo que vea todo el tráfico a través del puente. Es útil para ejecutar un sistema de detección de intrusiones (IDS) o similar en una máquina virtual.
  • network-uuid (solo lectura) la referencia única de identificador/objeto de la red virtual a la que está conectado este VIF
  • network-name-label (solo lectura) el nombre descriptivo de la red virtual a la que está conectado este VIF
  • io_read_kbs (solo lectura) velocidad de lectura promedio en kb/s para este VIF
  • io_write_kbs (solo lectura) velocidad de escritura promedio en kb/s para este VIF
  • locking_mode (lectura/escritura) Afecta a la capacidad de las 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 de la red VIF.

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

  • locking_mode:locked (lectura/escritura) Solo se permite el tráfico enviado a o enviado desde las direcciones MAC e IP especificadas en el VIF. Si no se especifican direcciones IP, no se permite el tráfico.
  • locking_mode:unlocked (lectura/escritura) No se aplican filtros a ningún tráfico que vaya hacia o desde el VIF.
  • locking_mode:disabled (lectura/escritura) Citrix Hypervisor aplica una regla de filtrado para que el 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-->

Cree una VIF en una VM.

Los valores apropiados para el campo device se enumeran en el parámetro allowed-VIF-devices de la máquina virtual especificada. Antes de que existan VIF, los valores permitidos son enteros de 0 a 15.

El parámetro mac es la dirección MAC estándar en forma 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-->

Destruya una VIF.

vif-move

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

Mueva la VIF a otra red.

vif-plug

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

Intente conectar el VIF mientras la máquina virtual se encuentra en estado de ejecución.

vif-unplug

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

Intenta desconectar la VIF de la VM mientras se está ejecutando.

vif-configure-ipv4

Configure los ajustes de IPv4 para esta interfaz virtual. Configure la configuración de IPv4 de la siguiente manera:

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

Limpie la configuración IPv4 de la siguiente manera:

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

vif-configure-ipv6

Configure los ajustes de IPv6 para esta interfaz virtual. Configure la configuración de IPv6 de la siguiente manera:

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 la configuración IPv6 de la siguiente manera:

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

Comandos de VLAN

Comandos para trabajar con VLAN (redes virtuales). Para enumerar y modificar 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 servidor de Citrix Hypervisor.

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, eth0) se encuentra la red especificada (en cada host) y 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-->

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

Comandos de VM

Comandos para controlar las máquinas virtuales y sus atributos.

Selectores de VM

Varios de los comandos enumerados aquí tienen un mecanismo común para seleccionar una o más máquinas virtuales en las que realizar la operación. La forma más sencilla es proporcionar el argumento vm=name_or_uuid. Una forma sencilla de obtener el uuid de una máquina virtual real es, por ejemplo, ejecutarla xe vm-list power-state=running. (Obtenga la lista completa de campos que pueden coincidir mediante el comando xe vm-list params=all) Por ejemplo, al especificar power-state=halted se seleccionan las máquinas virtuales cuyo parámetro power-state es igual a halted. Si hay varias máquinas virtuales que coincidan, 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 de listado de objetos estándar (xe vm-list) y los parámetros manipulados con los comandos de parámetros estándar. Para obtener más información, consulte Comandos de parámetros de bajo nivel

Parámetros VM

Las VM tienen los siguientes parámetros:

Nota:

Todos los valores de parámetros de VM grabables se pueden cambiar mientras la VM se está ejecutando, 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 a la que pertenece la VM
  • uuid (solo lectura) la referencia única de identificador/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 o cierre de la vApp y para el inicio después de una conmutación por error de alta disponibilidad. Las máquinas virtuales con un valor de pedido de 0 (cero) se inician primero, luego las máquinas virtuales con un valor de pedido de 1, y así sucesivamente.
  • version (solo lectura) el número de veces que se ha recuperado esta máquina virtual. Si quiere sobrescribir una máquina virtual nueva con una versión anterior, llame a vm-recover
  • user-version (lectura/escritura) para creadores de máquinas virtuales y plantillas para poner información de versión
  • is-a-template (lectura/escritura) False a menos que esta máquina virtual sea una plantilla. Las VM de plantilla nunca se pueden iniciar, solo se usan para clonar otras VM. Una vez que este valor se ha establecido en true, no se puede restablecer a false. Las máquinas virtuales de plantilla no se pueden convertir en máquinas virtuales con 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) True si se trata de un dominio de control (dominio 0 o un dominio de controlador)
  • power-state (solo lectura) estado de alimentación actual
  • start-delay (lectura/escritura) el retraso de espera antes de que se produzca una llamada para iniciar la máquina virtual en segundos
  • shutdown-delay (lectura/escritura) el retraso de espera antes de que una llamada para apagar la máquina virtual regrese 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) establecido estáticamente como máximo (absoluto) en bytes. Si quiere cambiar este valor, la máquina virtual debe cerrarse.
  • memory-static-min (lectura/escritura) establecido estáticamente como mínimo (absoluto) en bytes. Si quiere cambiar este valor, la máquina virtual debe cerrarse.
  • suspend-VDI-uuid (solo lectura) la VDI en la que se almacena una imagen suspendida
  • VCPUs-params (parámetro de mapa de lectura/escritura) para la directiva de vCPU seleccionada.

    Puede ajustar la fijación de una vCPU con

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

    La VM seleccionada se ejecuta solo en las CPU físicas 1, 2 y 3. También puede ajustar la prioridad de la vCPU (programación xen) con los parámetros de límite y peso. Por ejemplo:

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

    Una máquina virtual con un peso de 512 obtiene el doble de CPU que un dominio con un peso de 256 en un servidor de Citrix Hypervisor en conflicto. Los pesos legales varían de 1 a 65535 y el valor predeterminado es 256. El límite fija opcionalmente la cantidad máxima de CPU que una VM podrá consumir, incluso si el servidor de Citrix Hypervisor tiene ciclos de CPU inactivos. El límite se expresa en porcentaje de una CPU física: 100 es 1 CPU física, 50 es media CPU, 400 son 4 CPU, etc. El valor predeterminado, 0, significa que no hay límite superior.

  • VCPUs-max (lectura/escritura) número máximo de CPU virtuales.
  • VCPUs-at-startup (lectura/escritura) número de arranque de CPU virtuales
  • actions-after-crash (lectura/escritura) que se debe realizar si la máquina virtual se bloquea. Para los huéspedes de PV, los parámetros válidos son:
    • preserve (solo para análisis)
    • coredump_and_restart (grabar un volcado de núcleo y reiniciar la VM)
    • coredump_and_destroy (grabar un volcado de núcleo y dejar la VM detenida)
    • restart (sin volcado de núcleo y reinicio de VM)
    • destroy (sin volcado de núcleo y dejar la VM detenida)
  • console-uuids (parámetro establecido de solo lectura) dispositivos de consola virtual
  • platform (parámetro de mapa de lectura/escritura) configuración específica de la plataforma

    Para inhabilitar el VDA para cambiar Windows 10 al modo Tableta:

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

    Para permitir que el VDA cambie 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 conjunto de solo lectura) lista de las operaciones permitidas en este estado
  • current-operations (parámetro establecido de solo lectura) una lista de las operaciones que están actualmente en curso en la VM
  • allowed-VBD-devices (parámetro conjunto de solo lectura) de identificadores VBD disponibles para su uso, representados por enteros del rango 0—15. Esta lista es solo informativa y se pueden usar otros dispositivos (pero es posible que no funcionen).
  • allowed-VIF-devices (parámetro conjunto de solo lectura) de identificadores VIF disponibles para su uso, representados por enteros del rango 0—15. Esta lista es solo informativa y se pueden usar otros dispositivos (pero es posible que no funcionen).
  • HVM-boot-policy (lectura/escritura) la directiva de arranque para invitados HVM. Orden de BIOS o una cadena vacía.
  • HVM-boot-params (parámetro del mapa de lectura/escritura) la tecla de orden controla el orden de arranque del invitado HVM, representado como una cadena en la que 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 por defecto es dc.
  • HVM-shadow-multiplier (lectura/escritura) Valor de punto flotante que controla la cantidad de sobrecarga de memoria instantánea que se debe conceder a la VM. El valor predeterminado es 1.0 (el valor mínimo) y solo cambia este valor si es un usuario avanzado.
  • PV-kernel (lectura/escritura) al núcleo
  • PV-ramdisk (lectura/escritura) a la initrd
  • PV-args (lectura/escritura) de argumentos de línea de comandos del núcleo
  • PV-legacy-args (lectura/escritura) de argumentos para hacer que las máquinas virtuales heredadas arranquen
  • PV-bootloader (lectura/escritura) nombre o ruta al gestor de arranque
  • PV-bootloader-args (lectura/escritura) de argumentos varios para el gestor de arranque
  • last-boot-CPU-flags (solo lectura) describe los indicadores de CPU en los que se inició la máquina virtual por última vez
  • resident-on (solo lectura) el servidor de Citrix Hypervisor en el que reside una VM
  • affinity (lectura/escritura) El servidor de Citrix Hypervisor en el que la máquina virtual tiene preferencia para ejecutarse. Utilizado por el comando xe vm-start para decidir dónde ejecutar la VM
  • 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 máquina virtual.

    Por ejemplo, el par de clave/valor other-config de auto_poweron: true solicita iniciar la máquina virtual automáticamente después de que se inicie cualquier host del grupo. También debe establecer este parámetro en el de su agrupación other-config. Estos parámetros ahora están en desuso. 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 máquina virtual. 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 máquina virtual. 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 que utiliza 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 cambiarse sin necesidad de reiniciar la VM mediante el comando vm-vcpu-hotplug. Para obtener más información, consulte vm-vcpu-hotplug. Las máquinas virtuales 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 la cantidad de CPU físicas en el servidor de Citrix Hypervisor.
  • VCPUs-Utilization (parámetro de mapa de solo lectura) una lista de CPU virtuales y su peso
  • os-version (parámetro map 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) para la última versión de los controladores paravirtualizados para la VM
  • memory (parámetro de mapa de solo lectura) métricas de memoria notificadas 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 notificadas 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) que se debe realizar después de que la máquina virtual se haya apagado
  • actions-after-reboot (lectura/escritura) que se debe realizar después de que la VM se haya reiniciado
  • possible-hosts hosts potenciales de esta VM de 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 máquina virtual
  • xenstore-data (parámetro de asignación de lectura/escritura) Datos que se insertarán en el árbol xenstore (/local/domain/*domid*/vm-data) después de crear la máquina virtual
  • is-a-snapshot (solo lectura) True si esta máquina virtual es una instantánea
  • snapshot_of (solo lectura) el UUID de la máquina virtual de la que pertenece 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 objetivo de memoria establecida para esta VM
  • blocked-operations (parámetro de mapa de lectura/escritura) enumera las operaciones que no se pueden realizar en esta máquina virtual
  • last-boot-record (solo lectura) de los últimos parámetros de arranque para esta plantilla, en formato XML
  • ha-always-run (lectura/escritura) True si esta máquina virtual se reinicia siempre en otro host si se produce un error en el host en el que reside. Este parámetro ahora está en desuso. Utilice el parámetro ha-restart-priority en su lugar.
  • ha-restart-priority (lectura/escritura) reinicio o lo mejor que se pueda hacer
  • blobs (solo lectura) almacén de datos binarios
  • live (solo lectura) True si la máquina virtual está en ejecución. False 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 máquina virtual dada con argumentos opcionales (args:key=value). Para pasar una cadena de “valor” con caracteres especiales (por ejemplo, una línea nueva), se puede usar una sintaxis alternativa args:key:file=local_file, donde se recuperará el contenido de local_file y se asignará a “key” como un todo.

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

Agregue un nuevo CD virtual a la máquina virtual seleccionada. Seleccione el parámetro device entre el valor del parámetro allowed-VBD-devices de la máquina virtual.

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 VM. Los argumentos opcionales pueden ser cualquier número 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-->

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

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 VM. Los argumentos opcionales pueden ser cualquier número 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-->

Inserte 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 haya dos o más dispositivos de CD vacíos, utilice el comando xe vbd-insert y especifique los UUID del VBD y del VDI que se van a insertar.

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 VM. Los argumentos opcionales pueden ser cualquier número 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-->

Muestra los CD adjuntos a 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 VM. Los argumentos opcionales pueden ser cualquier número de los parámetros de VM enumerados al principio de esta sección.

También puede seleccionar los parámetros VBD y VDI que quiere enumerar.

vm-cd-remove

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

Retire un CD virtual de 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 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-->

Controle una VM existente, mediante la operación rápida de instantáneas de disco 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 VM existente, mediante la operación de clonación rápida de discos a nivel de almacenamiento, donde esté disponible. Especifique el nombre y la descripción opcional de la máquina virtual clonada resultante mediante los argumentos new-name-label y new-name-description.

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 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 VM existente, mediante 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 VM más adelante.

Por ejemplo:

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

Este comando usa 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 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 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 VM.

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

Copie una VM existente, pero sin usar la operación de clonación rápida de disco a nivel de almacenamiento (incluso si esta opción está disponible). Se garantiza que las imágenes de disco de la máquina virtual copiada sean imágenes completas, es decir, que no formen parte de una cadena de copia en escritura (CoW).

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

Especifique el SR de destino para la máquina virtual copiada resultante mediante el 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 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 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-->

Copie las cadenas de BIOS del host dado en la VM.

Nota:

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

vm-crashdump-list

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

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

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

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

Enumere las fuentes de datos que se pueden grabar para una VM.

Seleccione las máquinas virtuales en las que quiere realizar esta operación 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. Si no se proporcionan parámetros para seleccionar hosts, la operación se lleva a cabo en todas las máquinas virtuales.

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

Para empezar a registrar métricas de fuentes de datos en la base de datos de rendimiento, ejecute el comando vm-data-source-record. Este comando establece enabled en true. Para detener, ejecute el 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-->

Registre 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 persistentes de las máquinas virtuales especificadas. Por motivos de rendimiento, esta base de datos es distinta de la base de datos de agentes normal.

Seleccione las máquinas virtuales en las que quiere realizar esta operación 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. Si no se proporcionan parámetros para seleccionar hosts, la operación se lleva a cabo 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-->

Deje de grabar la fuente de datos especificada para una VM y olvide todos los datos grabados.

Seleccione las máquinas virtuales en las que quiere realizar esta operación 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. Si no se proporcionan parámetros para seleccionar hosts, la operación se lleva a cabo 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 quiere realizar esta operación 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. Si no se proporcionan parámetros para seleccionar hosts, la operación se lleva a cabo 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, use 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-->

Agregue un disco a las máquinas virtuales especificadas. Seleccione el parámetro device del valor del parámetro allowed-VBD-devices de las máquinas virtuales.

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

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 VM. Los argumentos opcionales pueden ser cualquier número 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 emitir. Indique los parámetros como una lista separada por comas o la clave especial all para la lista completa.

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 VM. Los argumentos opcionales pueden ser cualquier número 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-->

Retire un disco de las máquinas virtuales especificadas y destrúyalo.

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 VM. Los argumentos opcionales pueden ser cualquier número 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 máquinas virtuales especificadas (incluidas las imágenes de disco) a un archivo en la máquina local. Especifique el nombre de archivo al que exportar la máquina virtual mediante el parámetro filename. Por convención, el nombre del archivo tiene una .xva extensión.

Si el parámetro metadata es true, los discos no se exportan. Solo se escriben los metadatos de la VM en el archivo de salida. Use este parámetro cuando el almacenamiento subyacente se transfiera a través de otros mecanismos y permita que se vuelva a crear la información de la VM. Para obtener más información, consulte vm-import.

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 VM. Los argumentos opcionales pueden ser cualquier número 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 anteriormente. Si preserve se establece en true, se conserva la dirección MAC de la máquina virtual original. sr-uuid determina el SR de destino en el que se importará la VM. Si no se especifica este parámetro, se utiliza el SR predeterminado.

Si metadata es true, puede importar un conjunto de metadatos previamente exportado sin sus bloques de disco asociados. La importación solo de metadatos falla si no se puede encontrar ningún VDI (nombrado por SR y VDI.location) a menos que se especifique la opción --force, en cuyo caso la importación continúa independientemente. 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 las VM entre grupos separados. 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 VM a partir de una plantilla. Especifique el nombre de la plantilla mediante el argumento template-uuid o template. Especifique un SR mediante el argumento sr-uuid o sr-name-label. Especifique para instalar medios bloqueados por BIOS mediante el argumento copy-bios-strings-from.

Nota:

Al instalar desde una plantilla que tiene discos existentes, de forma predeterminada, los discos nuevos se crean en la misma 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 discos nuevos se crean allí. En este caso, no es posible realizar una copia rápida y los discos son copias completas.

Cuando se instala desde una plantilla que no tiene discos existentes, cualquier disco nuevo se crea 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 de BIOS de la VM 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 VM. El rango de memoria dinámica define límites inferiores y superiores suaves para la memoria de una VM. Es posible cambiar estos campos cuando una VM se está ejecutando o se detiene. 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 VM.

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

Configure el multiplicador de memoria instantánea para la máquina virtual especificada.

Se trata de una opción avanzada que modifica la cantidad de memoria oculta asignada a una máquina virtual asistida por hardware.

En algunas cargas de trabajo de aplicaciones especializadas, como Citrix Virtual Apps, se requiere memoria oculta adicional para lograr un rendimiento completo.

Esta memoria se considera una sobrecarga. Se separa de los cálculos de memoria normales para la memoria de cuentas de una máquina virtual. 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 libre en el servidor de Citrix Hypervisor, se devuelve un error.

Las máquinas virtuales 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 los límites inferior y superior duros para la memoria de una VM. Es posible cambiar estos campos solo cuando se detiene una VM. 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 [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 máquinas virtuales especificadas entre hosts físicos. El parámetro host puede ser el nombre o el UUID del servidor de Citrix Hypervisor. Por ejemplo, para migrar la VM a otro host del grupo, donde los discos de VM se encuentran en 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 grupo que no comparten almacenamiento (migración de almacenamiento en vivo):

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 del almacenamiento, debe proporcionar el nombre de host o la dirección IP, el nombre de usuario y la contraseña del maestro del grupo, incluso cuando esté migrando dentro del mismo grupo.

Puede elegir la SR en la que 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 qué red quiere conectar la VM 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:vif_uuid=network_uuid
<!--NeedCopy-->

Para la migración entre grupos:

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 del almacenamiento, la migración en vivo y la migración de VDI en vivo, consulte Migración de máquinas virtuales.

De forma predeterminada, la VM se suspende, migra y 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 funcionamiento mientras se realiza la migración, lo que minimiza el tiempo de inactividad de la máquina virtual. En algunas circunstancias, como las cargas de trabajo que consumen mucha memoria en la VM, la migración en vivo vuelve al modo predeterminado y suspende la VM durante un breve período 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 VM. Los argumentos opcionales pueden ser cualquier número de los parámetros de VM enumerados al principio de esta sección.

vm-pause

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

Ponga en pausa una VM 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-->

Reinicie las VM 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 VM. Los argumentos opcionales pueden ser cualquier número de los parámetros de VM enumerados al principio de esta sección.

Use el argumento force para provocar un reinicio implacable. 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 la VDI suministrada.

vm-reset-powerstate

xe vm-reset-powerstate [vm-selector=vm_selector_value...] {force=true}
<!--NeedCopy-->

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 VM. Los argumentos opcionales pueden ser cualquier número de los parámetros de VM enumerados al principio de esta sección.

Se trata de un comando avanzado que solo se utiliza cuando un host miembro de un grupo se desactiva. Puede usar este comando para forzar al maestro del grupo a restablecer el estado de energía de las máquinas virtuales halted. Básicamente, este comando fuerza el bloqueo de la máquina virtual y sus discos para que se pueda iniciar a continuación en otro host de grupo. Esta llamada requiere que se especifique la marca force y falla si no está en la línea de comandos.

vm-resume

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

Reanude 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 VM. Los argumentos opcionales pueden ser cualquier número de los parámetros de VM enumerados al principio de esta sección.

Si la máquina virtual está en un SR compartido en un grupo de hosts, utilice el argumento on para especificar en qué miembro del grupo se va a iniciar. De forma predeterminada, el sistema determina un host apropiado, que puede 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 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 VM. Los argumentos opcionales pueden ser cualquier número de los parámetros de VM enumerados al principio de esta sección.

Utilice el argumento force para provocar un apagado incorrecto, similar a tirar del enchufe en un servidor físico.

vm-snapshot

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

Realice una instantánea de una VM existente, utilizando la operación de instantánea de disco rápida 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 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 VM. Los argumentos opcionales pueden ser cualquier número de los parámetros de VM enumerados al principio de esta sección.

Si las máquinas virtuales están en un SR compartido en un grupo de hosts, utilice el argumento on para especificar en qué miembro del grupo se van a iniciar las máquinas virtuales. De forma predeterminada, el sistema determina un host apropiado, que puede ser cualquiera de los miembros del grupo.

vm-suspend

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

Suspenda la VM especificada.

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 VM. Los argumentos opcionales pueden ser cualquier número 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-->

Desinstale una VM y destruya sus discos (los VDI marcados como RW y conectados a esta VM únicamente) además de su registro de metadatos. Para destruir solo los metadatos de la VM, use xe vm-destroy.

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

Reanuda una VM en pausa.

vm-vcpu-hotplug

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

Ajuste dinámicamente la cantidad de vCPU disponibles para una VM Linux en ejecución. El número de CPU virtuales está limitado por el parámetro VCPUs-max. Las máquinas virtuales de Windows siempre se ejecutan con el número de vCPU establecido en VCPUs-max y deben reiniciarse para cambiar este valor.

Usa el new-vcpusparámetro para definir la nueva cantidad total de vCPU que deseas tener después de ejecutar este comando. No utilices este parámetro para pasar la cantidad de vCPU que deseas agregar. Por ejemplo, si ya tiene dos vCPU en su máquina virtual y desea agregar dos CPU virtuales más, especifíquelonew-vcpus=4.

Las máquinas virtuales Linux o Windows 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.

Nota:

Cuando ejecute máquinas virtuales Linux sin Citrix VM Tools instalado, ejecute el siguiente comando en la máquina virtual 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 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 VM. Los selectores funcionan en los registros de VM al filtrar, y no en los valores 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 enumerar 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 grupo.

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:

Nombre del parámetro Descripción Tipo
name-label Nombre de la programación de instantáneas. Lectura/Escritura
name-description Descripción de la programación de instantáneas. Lectura/Escritura
type Snapshot de disco o snapshot de memoria. Lectura/Escritura
frequency Cada hora; diaria; semanal Lectura/Escritura
retained-snapshots Instantáneas que se conservarán. Intervalo: 1-10. Lectura/Escritura
schedule schedule:days (de lunes a domingo), schedule:hours (de 0 a 23), schedule:minutes (0, 15, 30, 45) Lectura/Escritura

vmss-destroy

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

Destruye una programación de instantáneas en el grupo.

Paso a través de USB

La transferencia USB es compatible con las siguientes versiones de USB: 1.1, 2.0 y 3.0.

Activación/desactivación de paso a través de USB

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

Habilitar/inhabilitar el paso a través de USB.

pusb-scan

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

Escanee PUSB y actualice.

vusb-create

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

Crea un USB virtual en el grupo. Inicie la VM para pasar a través del 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.