Interfaz de línea de comandos

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

Instalación de la CLI xe

La interfaz de línea de comandos xe se instala de forma predeterminada en todos los servidores Citrix Hypervisor y se incluye con XenCenter. Una CLI remota independiente también está disponible para Linux.

En Windows

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

Para utilizar el comando xe.exe, abra un símbolo del sistema de Windows y cambie los directorios al directorio donde se encuentra el archivo xe.exe (normalmente C:\Program Files\Citrix\XenCenter). Si agrega la ubicación de instalación xe.exe a la ruta de acceso del sistema, puede utilizar 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 nombradoclient_install/xapi-xe-BUILD.x86_64.rpm en el ISO de instalación principal de Citrix Hypervisor.

Para instalar desde RPM, utilice el siguiente comando:

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

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

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

Nota:

La CLI de xe remota en Linux podría bloquearse al intentar ejecutar comandos a través de una conexión segura y estos comandos implican la transferencia de archivos. Si este es el caso, puede utilizar el parámetro --no-ssl para ejecutar el comando a través de una conexión insegura con el servidor Citrix Hypervisor.

Obtener ayuda con los comandos xe

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

xe help command

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

xe help

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

xe help --all

Sintaxis xe básica

La sintaxis básica de todos los comandos de Citrix Hypervisor xe CLI es:

xe command-name argument=value argument=value

Cada comando específico contiene su propio conjunto de argumentos que son del formularioargument=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 utilizan argumentos adicionales para conectarse y autenticarse. Estos argumentos también toman la forma argument=argument_value.

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

Se puede especificar un argumento password-file en lugar de la contraseña directamente. En este caso, el comando xe intenta leer la contraseña del archivo especificado y utiliza esa contraseña para conectarse. (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 port opcional se puede utilizar para especificar el puerto del agente en el servidor Citrix Hypervisor remoto (el valor predeterminado es 443).

Ejemplo: En el servidor local de Citrix Hypervisor:

xe vm-list

Ejemplo: En el servidor Citrix Hypervisor remoto:

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

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

  • -u username
  • -pw password
  • -pwf password file
  • -p port
  • -s server

Ejemplo: En un servidor Citrix Hypervisor remoto:

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

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 Citrix Hypervisor remoto, ejecute primero el siguiente comando:

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

Después de ejecutar este comando, ya no es necesario especificar los parámetros remotos del servidor Citrix Hypervisor 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 Citrix Hypervisor remoto, que está deshabilitado de forma predeterminada.

Caracteres especiales y sintaxis

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

A menos que el valor incluya espacios, no use comillas. No debe haber espacios en blanco entre el nombre del argumento, el signo igual (=) y el valor. Se omite cualquier argumento que no se ajuste a este formato.

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

Cuando utiliza la CLI en el servidor Citrix Hypervisor, los comandos tienen una función de finalización de tabulación similar a la característica del shell bash de Linux estándar. Por ejemplo, si escribexe vm-l y, a continuación, presiona la tecla TAB , se mostrará el resto del comando. Si comienza con más de un comandovm-l, al presionar TABuna segunda vez se muestran las posibilidades. Esta característica es útil al especificar UUID de objeto en los comandos.

Nota:

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

Tipos de comandos

Los comandos CLI se pueden dividir en dos mitades. Los comandos de bajo nivel se ocupan de la manipulación de listas y parámetros de objetos 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:

  • lista declases

  • clase-param-get

  • clase-param-set

  • clase-param-list

  • clase-param-add

  • class-param-remove

  • class-param-clear

Donde la clase es uno de:

  • bond

  • console

  • host

  • host-crashdump

  • host-cpu

  • network

  • patch

  • pbd

  • pif

  • pool

  • sm

  • sr

  • task

  • template

  • vbd

  • vdi

  • vif

  • vlan

  • vm

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

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, elname-label parámetro de una VM contiene un único valor de cadena. En la salida de comandos de lista de parámetros, comoxe vm-param-list, por ejemplo, un valor entre paréntesis indica si los parámetros son de lectura y escritura (RW) o de sólo lectura (RO). La salida dexe vm-param-list en una máquina virtual especificada puede tener las siguientes líneas:

versión de usuario (RW): 1
 is-control-dominio (RO): false

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

Los otros dos tipos de parámetros son de varios valores. Un parámetro de conjunto 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 laxe vm-param-list en una máquina virtual especificada:

plataforma (MRW): acpi: true; apic: true; pae: true; nx: false
operaciones permitidas (SRO): pausa; clean_shutdown; clean_reboot; clean_reboot; \
hard_shutdown; hard_reboot; suspender

Elplatform parámetro tiene una lista de elementos que representan pares clave/valor. Los nombres de clave 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 al RW indica que este parámetro es un parámetro de mapa y es legible y grabable. Elallowed-operations parámetro tiene una lista que compone un conjunto de elementos. La S que precede a la RO indica que se trata de un parámetro establecido y que es legible pero no se puede escribir.

Para filtrar 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 lafoo clave delother-config parámetro de una VM enbaa , el comando sería

xe vm-param-set uuid=VM uuid other-config:foo=baa

Nota:

En versiones anteriores, se utilizó el carácter de guión (-) para especificar parámetros de mapa. Esta sintaxis sigue funcionando, pero está en desuso.

Comandos de parámetros de bajo nivel

Existen 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 unuuid parámetro para especificar el objeto en particular. Dado que estos comandos se consideran comandos de bajo nivel, deben usar el UUID y no la etiqueta de nombre de VM.

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

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

    Devuelve el valor de un parámetro determinado. Para un parámetro de mapa, al especificar la tecla param-key se obtiene el valor asociado con 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 mapa.

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

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

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

    Se agrega a un mapa o a un parámetro de conjunto. Para un parámetro de mapa, agregue pares clave/valor mediante la sintaxis clave-valor. Si el parámetro es un conjunto, agregue claves con la sintaxis param-key=key.

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

  • 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 clasetipo. De forma predeterminada, este tipo de comando muestra todos los objetos, imprimiendo un subconjunto de los parámetros. Este comportamiento se puede modificar de las siguientes maneras:

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

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

xe vm-list params=name-label,other-config

Alternativamente, para enumerar todos los parámetros, utilice la sintaxis:

xe vm-list params=all

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

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

Para obtener estos campos, utilice 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 sólo los objetos que coincidan con todas las restricciones especificadas. Por ejemplo:

xe vm-list HVM-boot-policy="BIOS order" power-state=halted

Este comando enumera sólo aquellas máquinas virtuales para las que el campopower-state tiene el valor detenido y el campoHVM-boot-policy tiene el orden BIOS del valor.

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 el filtrado basado en claves en mapas esmap-name:key=value. La sintaxis para filtrar en función de los valores existentes en un conjunto esset-name:contains=value.

Al crear secuencias de comandos, una técnica útil está--minimal pasando en la línea de comandos, haciendoxe que se imprima sólo el primer campo de una lista separada por comas. Por ejemplo, el comandoxe vm-list --minimal en un host con tres máquinas virtuales instaladas proporciona los tres UUID de las máquinas virtuales:

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

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 línea de comandos o en objetos API. XenCenter utiliza esta función automáticamente y también se puede utilizar desde la CLI de xe para cualquier comando que requiera una contraseña.

Nota

Los secretos de contraseña no se pueden usar para autenticar 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

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. _secret`` Anexar 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"

referencia de comando xe

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

Comandos del dispositivo

Comandos para crear y modificar dispositivos 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 de parámetro Descripción Tipo
uuid El dispositivo uuid Obligatorio
name-description Descripción del aparato Opcional
paused   Opcional
force Forzar apagado Opcional

appliance-assert-can-be-recovered

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

Comprueba si el almacenamiento está disponible para recuperar este dispositivo de VM o VApp.

appliance-create

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

Crea un dispositivo/VApp. Por ejemplo:

xe appliance-create name-label=my_appliance

Agregar máquinas virtuales al dispositivo:

    xe vm-param-set uuid=VM-UUID appliance=appliance-uuid

appliance-destroy

appliance-destroy uuid=appliance-uuid

Destruye un dispositivo/VApp. Por ejemplo:

xe appliance-destroy uuid=appliance-uuid

appliance-recover

appliance-recover uuid=appliance-uuid database:vdi-uuid=vdi-uuid [paused=true|false]

Recupere un dispositivo de VM o VApp de la base de datos contenida en el VDI suministrado.

appliance-shutdown

appliance-shutdown uuid=appliance-uuid [force=true|false]

Apaga todas las máquinas virtuales de un dispositivo/VApp. Por ejemplo:

xe appliance-shutdown uuid=appliance-uuid

appliance-start

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

Inicia un dispositivo/VApp. Por ejemplo:

xe appliance-start uuid=appliance-uuid

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 opcionalsince está presente, solo descarga los registros de ese punto específico en el tiempo.

audit-log-get parámetros

audit-log-get tiene los siguientes parámetros

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

audit-log-get

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

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

Ejecute el comando siguiente:

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

Comandos de unión

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

El objeto bond es un objeto de referencia que pega entre sí PIF maestro y miembro . El PIF maestro es la interfaz de unión que debe utilizarse como PIF general para referirse al enlace. 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 enlace

Los bonos tienen los siguientes parámetros:

Nombre de parámetro Descripción Tipo
uuid Identificador/referencia única del objeto para el enlace Sólo lectura
master UUID para el PIF del bono maestro Sólo lectura
members Conjunto de UUID para los PIF enlazados subyacentes Sólo lectura

bond-create

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

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

bond-destroy

bond-destroy uuid=bond_uuid

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

bond-set-mode

bond-set-mode uuid=bond_uuid mode=bond_mode

Cambie el modo de enlace.

Comandos de CD

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

Parámetros de CD

Los CD tienen los siguientes parámetros:

Nombre de parámetro Descripción Tipo
uuid Identificador/referencia de objeto único para el CD Sólo lectura
name-label Nombre del CD Lectura/Escritura
name-description Texto de descripción del CD Lectura/Escritura
allowed-operations Una lista de las operaciones que se pueden realizar en este CD Parámetro de conjunto de sólo lectura
current-operations Una lista de las operaciones actualmente en curso en este CD Parámetro de conjunto de sólo lectura
sr-uuid La referencia única de identificador/objeto para el SR este CD es parte de Sólo lectura
sr-name-label El nombre de la SR este CD es parte de Sólo lectura
vbd-uuids Una lista de los identificadores únicos para los VBD en las máquinas virtuales que se conectan a este CD Parámetro de conjunto de sólo lectura
crashdump-uuids No se utiliza en CD. Debido a que los volcados de descarga no se pueden escribir en CD Parámetro de conjunto de sólo lectura
virtual-size Tamaño del CD tal como aparece en las máquinas virtuales (en bytes) Sólo lectura
physical-utilisation Cantidad de espacio físico que ocupa la imagen de CD en el SR (en bytes) Sólo lectura
type Establecer como usuario para CD Sólo lectura
sharable Si la unidad de CD se puede compartir o no. El valor predeterminado esfalse. Sólo lectura
read-only Si el CD es de sólo lectura, sifalse, el dispositivo es grabable. Siempre es cierto para los CDs. Sólo lectura
storage-lock El valor estrue si este disco está bloqueado en el nivel de almacenamiento. Sólo lectura
parent Referencia al disco principal, si este CD forma parte de una cadena. Sólo lectura
missing El valor estrue si la operación de exploración SR notificó que este CD no está presente en el disco Sólo 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 está montado el dispositivo Sólo lectura
managed El valor estrue si el dispositivo está administrado Sólo lectura
xenstore-data Datos que se insertarán en el árbol de xenstore Parámetro de mapa de sólo lectura
sm-config Nombres y descripciones de las claves de configuración del dispositivo del administrador de almacenamiento Parámetro de mapa de sólo lectura
is-a-snapshot El valor estrue si esta plantilla es una instantánea de CD Sólo lectura
snapshot_of El UUID del CD del que esta plantilla es una instantánea de Sólo lectura
snapshots Los UUID de las instantáneas tomadas de este CD Sólo lectura
snapshot_time La marca de tiempo de la operación de instantánea Sólo lectura

cd-list

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

Enumere los CD e ISOS (archivos de imagen de CD) en el servidor o grupo de Citrix Hypervisor, filtrando en el argumento opcionalparams.

Si separams utiliza el argumento opcional, el valor de params es una cadena que contiene una lista de parámetros de este objeto que desea mostrar. Alternativamente, puede usar la palabra clave all para mostrar todos los parámetros. Cuando noparams se utiliza, 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 agrupamiento. Utilice estos grupos con SRs de GFS2. Para obtener más información, consulte Grupos agrupados

Los objetos cluster y cluster host se pueden enumerar con los comandos de lista de objetos estándar (xe cluster-list yxe 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 de parámetro Descripción Tipo
uuid La referencia única de identificador/objeto para el clúster Sólo lectura
cluster-hosts Una lista de identificadores y referencias de objetos únicos para los hosts del clúster Parámetro de conjunto de sólo lectura
cluster-token La clave secreta utilizada por xapi-clusterd cuando habla consigo mismo en otros hosts Sólo lectura
cluster-stack La pila de tecnología que proporciona las capacidades de clustering. Los valores posibles soncorosync. Sólo lectura
allowed-operations Enumera las operaciones permitidas en este estado. Esta lista es sólo 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 sólo lectura
current-operations Enumera las operaciones actualmente en curso. Esta lista es sólo 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 sólo lectura
token-timeout El tiempo de espera del token de corosync en segundos Sólo lectura
token-timeout-coefficient El coeficiente de tiempo de espera del token de corosync en segundos Sólo lectura
pool-auto-join True si se unen automáticamente nuevos miembros del grupo al clúster. Esto está configurado entrue. Sólo 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 sólo 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-create

cluster-host-create cluster-uuid=cluster_uuid host-uuid=host_uuid pif-uuid=pif_uuid

Agregar un host a un clúster existente.

cluster-host-destroy

cluster-host-destroy uuid=host_uuid

Destruye un host de clúster, dejando efectivamente el clúster.

cluster-host-disable

cluster-host-disable uuid=cluster_uuid

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

cluster-host-enable

cluster-host-enable uuid=cluster_uuid

Habilitar la pertenencia al clúster para un host de clúster deshabilitado.

cluster-host-force-destroy

cluster-host-force-destroy uuid=cluster_host

Destruir un objeto host de clúster con fuerza, dejando efectivamente el clúster.

cluster-pool-create

cluster-pool-create network-uuid=network_uuid [cluster-stack=cluster_stack] [token-timeout=token_timeout] [token-timeout-coefficient=token_timeout_coefficient]

Crear clúster en todo el grupo.

cluster-pool-destroy

cluster-pool-destroy cluster-uuid=cluster_uuid

Destruye el clúster de toda la piscina. El grupo continúa existiendo, pero ya no está agrupado y ya no puede usar SRs de GFS2.

cluster-pool-force-destroy

cluster-pool-force-destroy cluster-uuid=cluster_uuid

Fuerza destruir el racimo de toda la piscina.

cluster-pool-resync

cluster-pool-resync cluster-uuid=cluster_uuid

Resincronizar un clúster a través de un grupo.

Comandos de consola

Comandos para trabajar con consolas.

Los objetos de consola se pueden enumerar con el comando de lista de objetos estándar (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 la consola

Las consolas tienen los siguientes parámetros:

Nombre de parámetro Descripción Tipo
uuid La referencia única de identificador/objeto para la consola Sólo lectura
vm-uuid La referencia única de identificador/objeto de la máquina virtual en la que está abierta esta consola Sólo lectura
vm-name-label El nombre de la máquina virtual en la que está abierta esta consola Sólo lectura
protocol Protocolo que utiliza esta consola. Los valores posibles sonvt100: Terminal VT100,rfb: Protocolo de búfer remoto (como se usa en VNC) ordp: Protocolo de escritorio remoto Sólo lectura
location URI para el servicio de consola Sólo 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

console

Adjuntar a una consola en particular.

Comandos de diagnóstico

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

diagnostic-compact

diagnostic-compact

Realice una colección GC importante y compactación del montón.

diagnostic-db-log

diagnostic-db-log

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

diagnostic-db-stats

diagnostic-db-stats

Imprimir estadísticas de base de datos.

diagnostic-gc-stats

diagnostic-gc-stats

Imprimir estadísticas de GC.

diagnostic-license-status

diagnostic-license-status

Ayude a diagnosticar problemas de licencias en todo el grupo.

diagnostic-net-stats

diagnostic-net-stats [uri=uri] [method=method] [params=param1,param2...]

Imprimir estadísticas de red.

diagnostic-timing-stats

diagnostic-timing-stats

Estadísticas de tiempo de impresión.

diagnostic-vdi-status

diagnostic-vdi-status uuid=vdi_uuid

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

diagnostic-vm-status

diagnostic-vm-status uuid=vm_uuid

Consulte los hosts en los que la máquina virtual puede arrancar, compruebe el estado de compartimiento/bloqueo de todos los VBD.

Comandos de recuperación ante desastres

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

drtask-create

drtask-create type=type sr-whitelist=sr-white-list device-config=device-config

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

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

Nota:

El comandosr-whitelist enumera los UUID SR. El drtask-create comando sólo introduce y se conecta a un SR que tiene uno de los UUID de la lista blanca

drtask-destroy

drtask-destroy uuid=dr-task-uuid

Destruye una tarea de recuperación ante desastres y olvida la SR introducida.

vm-assert-can-be-recovered

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

Comprueba si el almacenamiento está disponible para recuperar esta VM.

appliance-assert-can-be-recovered

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

Comprueba si el almacenamiento (que contiene el disco VApp o del dispositivo) está visible.

appliance-recover

appliance-recover uuid=appliance-uuid database:vdi-uuid=vdi-uuid [force=true|false]

Recupere un Appliance/VApp de la base de datos contenida en el VDI suministrado.

vm-recover

vm-recover uuid=vm-uuid database:vdi-uuid=vdi-uuid [force=true|false]

Recupera una máquina virtual de la base de datos contenida en el VDI suministrado.

sr-enable-database-replication

sr-enable-database-replication uuid=sr_uuid

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

sr-disable-database-replication

sr-disable-database-replication uuid=sr_uuid

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

Ejemplo de uso

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

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

xe sr-database-replication uuid=sr=uuid

Después de un desastre, en el sitio secundario, conéctese al SR. Eldevice-config comando tiene los mismos campos quesr-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

Busque VDI de base de datos en el SR:

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

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

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

Recuperar una VM:

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

Destruye la tarea DR. Los SRs introducidos por la tarea DR y no requeridos por las VM se destruyen:

xe drtask-destroy uuid=drtask-uuid

Comandos de evento

Comandos para trabajar con eventos.

Clases de eventos

Las clases de eventos se enumeran en la tabla siguiente:

Nombre de la clase Descripción
pool Un grupo 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 de información
vdi Una imagen de disco virtual
vbd Un dispositivo de bloque virtual
pbd Los dispositivos de bloques físicos a través de los cuales los hosts acceden a SRs

event-wait

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

Bloquea la ejecución de otros comandos hasta que exista un objeto que satisfaga las condiciones dadas en la línea de comandos. El argumentox=y significa «esperar a que el campo x tome el valor y» yx=/=y significa «esperar a que el campo x tome cualquier valor que no sea y».

Ejemplo: espere a que se esté ejecutando una VM específica.

xe event-wait class=vm name-label=myvm power-state=running

Bloquea otros comandos hasta que una máquina virtual llamadamyvm esté en ejecución.power-state «

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)

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

El nombre de la clase puede ser cualquiera de losclases de eventosenumerados al principio de esta sección. Los parámetros pueden ser cualquiera de los parámetros enumerados en la clasede comando CLI -param-list.

Comandos de GPU

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

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

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

Nombre de parámetro Descripción Tipo
uuid La referencia única de identificador/objeto para la PGPU Sólo lectura
vendor-name El nombre del proveedor de la PGPU Sólo lectura
device-name El nombre asignado por el proveedor a este modelo de PGPU Sólo lectura
gpu-group-uuid Referencia única de identificador/objeto para el grupo de GPU al que Citrix Hypervisor ha asignado automáticamente esta PGPU. Se agrupan PGPU idénticas en los hosts de un grupo Sólo lectura
gpu-group-name-label El nombre del grupo de GPU al que se asigna la PGPU Sólo lectura
host-uuid La referencia única de identificador/objeto para el servidor Citrix Hypervisor al que está conectado la PGPU Sólo lectura
host-name-label El nombre del servidor Citrix Hypervisor al que está conectado la PGPU Sólo lectura
pci-id Identificador PCI Sólo lectura
dependencies Enumera los dispositivos PCI dependientes que pasan a través de la misma máquina virtual 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 admitidos por el hardware subyacente Sólo 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 Sólo lectura

pgpu-disable-dom0-access

pgpu-disable-dom0-access uuid=uuid

Deshabilite el acceso PGPU a dom0.

pgpu-enable-dom0-access

pgpu-enable-dom0-access uuid=uuid

Habilite el acceso PGPU a dom0.

Parámetros de grupo de GPU

Los grupos de GPU tienen los siguientes parámetros:

Nombre de parámetro Descripción Tipo
uuid La referencia única de identificador/objeto para el grupo de GPU Sólo lectura
name-label El nombre del grupo de GPU Lectura/Escritura
name-description El texto descriptivo del grupo GPU Lectura/Escritura
VGPU-uuids Enumera las referencias únicas de identificador/objeto para las GPU virtuales en el grupo de GPU Parámetro de conjunto de sólo lectura
PGPU-uuids Enumera las referencias únicas de identificador/objeto para las PGPU en el grupo de GPU Parámetro de conjunto de sólo 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 soportados por el hardware subyacente Sólo lectura
enabled-VGPU-types Unión de todos los tipos de GPU virtuales que se han habilitado en las PGPU subyacentes Sólo lectura
allocation-algorithm Configuración de profundidad/primera amplitud para la asignación de GPU virtuales en PGPU dentro del grupo Parámetro enum de lectura y escritura

Operaciones de grupo de GPU

Comandos para trabajar con grupos de GPU

gpu-group-create
gpu-group-create name-label=name_for_group [name-description=description]

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

gpu-group-destroy
gpu-group-destroy uuid=uuid_of_group

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

gpu-group-get-remaining-capacity
gpu-group-get-remaining-capacity uuid=uuid_of_group vgpu-type-uuid=uuid_of_vgpu_type

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

gpu-group-param-set
gpu-group-param-set uuid=uuid_of_group allocation-algorithm=breadth-first|depth-first

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

gpu-group-param-get-uuid
gpu-group-param-get-uuid uuid=uuid_of_group param-name=supported-vGPU-types|enabled-vGPU-types

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

Parámetros de GPU virtual

Las GPU virtuales tienen los siguientes parámetros:

Nombre de parámetro Descripción Tipo
uuid La referencia única de identificador/objeto para la GPU virtual Sólo lectura
vm-uuid La referencia única de identificador/objeto para la máquina virtual a la que está asignada la GPU virtual Sólo lectura
vm-name-label El nombre de la máquina virtual a la que está asignada la GPU virtual Sólo lectura
gpu-group-uuid La referencia única de identificador/objeto para el grupo de GPU en el que se encuentra la GPU virtual Sólo lectura
gpu-group-name-label El nombre del grupo de GPU en el que está contenida la GPU virtual Sólo lectura
currently-attached True si se está ejecutando una máquina virtual con GPU PassThrough, false en caso contrario Sólo 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 con el tipo de GPU virtual Sólo lectura

Parámetros de tipo de GPU virtual

Nota:

GPU Passthrough y GPU virtuales no son compatibles con la migración en vivo, la migración en vivo del almacenamiento o la suspensión de VM 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 acerca de la compatibilidad de NVIDIA vGPU con la migración en vivo, la migración en vivo del almacenamiento y la suspensión de VM, consulteGráficos.

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

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

Operaciones de GPU virtual

vgpu-create

vgpu-create vm-uuid=uuid_of_vm gpu_group_uuid=uuid_of_gpu_group [vgpu-type-uuid=uuid_of_vgpu-type]

Crea una GPU virtual. Este comando adjunta la máquina virtual al grupo de GPU especificado y, opcionalmente, especifica el tipo de GPU virtual. Si no se especifica ningún tipo de GPU virtual, se asume el tipo «pass-through».

vgpu-destroy

vgpu-destroy uuid=uuid_of_vgpu

Destruye la GPU virtual especificada.

Deshabilitar VNC para máquinas virtuales con GPU virtual

xe vm-param-add uuid=uuid_of_vmparam-name=platform vgpu_vnc_enabled=true|false

El usofalse deshabilita la consola VNC para una máquina virtual a medida quedisablevnc=1 pasa al emulador de pantalla. De forma predeterminada, VNC está habilitado.

Comandos de host

Comandos para interactuar con el servidor Citrix Hypervisor.

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

Los objetos del servidor Citrix Hypervisor se pueden enumerar con los comandos estándar de lista de objetos:xe host-listxe host-cpu-list````, yxe 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 Citrix Hypervisor en los que realizar la operación. Lo más simple es proporcionar el argumentohost=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 seenabled=true seleccionan todos los servidores Citrix Hypervisor cuyoenabled campo sea igual atrue . Si coinciden varios servidores Citrix Hypervisor y la operación se puede realizar en varios servidores Citrix Hypervisor, debe especificar--multiple para realizar la operación. La lista completa de parámetros que se pueden comparar se describe al principio de esta sección. Puede obtener esta lista de comandos ejecutando el comandoxe host-list params=all. Si no se proporcionan parámetros para seleccionar servidores Citrix Hypervisor, la operación se realiza en todos los servidores Citrix Hypervisor.

Parámetros de host

Los servidores Citrix Hypervisor tienen los siguientes parámetros:

Nombre de parámetro Descripción Tipo
uuid La referencia única de identificador/objeto para el servidor Citrix Hypervisor Sólo lectura
name-label El nombre del servidor Citrix Hypervisor Lectura/Escritura
name-description La cadena de descripción del servidor Citrix Hypervisor Sólo lectura
enabled El valor esfalse si está deshabilitado. Esto impide que las máquinas virtuales nuevas se inicien en los hosts y prepara los hosts para que se apaguen o reinicien. El valor estrue si el host está habilitado Sólo lectura
API-version-major Número de versión principal Sólo lectura
API-version-minor Número de versión secundaria Sólo lectura
API-version-vendor Identificación del proveedor de API Sólo lectura
API-version-vendor-implementation Detalles de la implementación del proveedor Parámetro de mapa de sólo lectura
logging Configuración de registro 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 bloqueo Lectura/Escritura
software-version Lista de parámetros de control de versiones y sus valores Parámetro de mapa de sólo lectura
capabilities Lista de versiones Xen que el servidor Citrix Hypervisor puede ejecutar Parámetro de conjunto de sólo lectura
other-config Una lista de pares clave/valor que especifican parámetros de configuración adicionales para el servidor Citrix Hypervisor Parámetro de mapa de lectura y escritura
chipset-info Una lista de pares clave/valor que especifican información sobre el chipset Parámetro de mapa de sólo lectura
hostname Nombre de host del servidor de Citrix Hypervisor Sólo lectura
address Dirección IP del servidor de Citrix Hypervisor Sólo 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 productos Citrix es 27000. Para obtener información sobre cómo cambiar los números de puerto debido a conflictos, consulteCambiar números de puerto Parámetro de mapa de sólo lectura
supported-bootloaders Lista de cargadores de arranque que admite el servidor Citrix Hypervisor, por ejemplo, pygrub, eliloader Parámetro de conjunto de sólo lectura
memory-total Cantidad total de RAM física en el servidor Citrix Hypervisor, en bytes Sólo lectura
memory-free Cantidad total de RAM física restante que se puede asignar a las VM, en bytes Sólo lectura
host-metrics-live True si el host está operativo Sólo lectura
logging Lasyslog_destination clave 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 sólo 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 sólo lectura
current-operations Enumera las operaciones actualmente en curso. Esta lista es sólo 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 sólo lectura
patches Conjunto de parches de host Parámetro de conjunto de sólo lectura
blobs Almacén de datos binario Sólo lectura
memory-free-computed Una estimación conservadora de la cantidad máxima de memoria libre en un host Sólo lectura
ha-statefiles Los UUID de todos los archivos de estado HA Sólo lectura
ha-network-peers Los UUID de todos los hosts que podrían alojar las VM en este host si hay un error Sólo lectura
external-auth-type Tipo de autenticación externa, por ejemplo, Active Directory. Sólo lectura
external-auth-service-name El nombre del servicio de autenticación externo Sólo lectura
external-auth-configuration Información de configuración para el servicio de autenticación externo. Parámetro de mapa de sólo lectura

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

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

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

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

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

host-all-editions

host-all-editions

Obtener una lista de todas las ediciones disponibles

host-apply-edition

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

Asigna la licencia de Citrix Hypervisor a un servidor host. Cuando asigna una licencia, Citrix Hypervisor se pone en contacto con el servidor de licencias y solicita el tipo de licencia especificado. Si una licencia está disponible, se desactiva del servidor de licencias.

Para las ediciones de Citrix Hypervisor para Citrix Virtual Desktops, use"xendesktop".

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

host-backup

host-backup file-name=backup_filename host=host_name

Descargue una copia de seguridad del dominio de control del servidor Citrix Hypervisor especificado en el equipo desde el que se invoca el comando. Guárdelo allí como un archivo con el nombrefile-name.

Importante:

Mientras que elxe host-backup comando funciona si se ejecuta en el host local (es decir, sin un nombre de host específico especificado), no lo use de esta manera. Hacerlo llenaría la partición de dominio de control con el archivo de copia de seguridad. Utilice únicamente el comando de un equipo remoto fuera del host donde tenga espacio para guardar el archivo de copia de seguridad.

host-bugreport-upload

host-bugreport-upload [host-selector=host_selector_value...] [url=destination_url http-proxy=http_proxy_name]

Genera un nuevo informe de errores (usando xen-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 debe realizar esta operación se seleccionan utilizando el mecanismo de selección estándar (ver selectores de host arriba). Los argumentos opcionales pueden ser cualquier número de los parámetros de host enumerados al principio de esta sección.

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

host-call-plugin

host-call-plugin host-uuid=host_uuid plugin=plugin fn=function [args=args]

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

host-compute-free-memory

host-compute-free-memory

Calcula la cantidad de memoria libre en el host.

host-compute-memory-overhead

host-compute-memory-overhead

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

host-cpu-info

host-cpu-info [uuid=uuid]

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

host-crashdump-destroy

host-crashdump-destroy uuid=crashdump_uuid

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

host-crashdump-upload

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

Cargue un crashdump 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 son http-proxy: utilizar proxy http especificado y url: cargar a esta URL de destino.

host-declare-dead

host-declare-dead uuid=host_uuid

Declarar que el host está muerto sin ponerse en contacto con él explícitamente.

Advertencia:

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

host-disable

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

Deshabilita los servidores Citrix Hypervisor especificados, lo que impide que las máquinas virtuales nuevas se inicien en ellos. Esta acción prepara los servidores Citrix Hypervisor para que se apaguen o reinicien.

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

host-disable-display

host-disable-display uuid=host_uuid

Deshabilitar la visualización para el host.

host-disable-local-storage-caching

host-disable-local-storage-caching

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

host-dmesg

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

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

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

host-emergency-ha-disable

host-emergency-ha-disable  [--force]

Deshabilite HA en el host local. Sólo para ser utilizado para recuperar un grupo con una configuración de HA rota.

host-emergency-management-reconfigure

host-emergency-management-reconfigure interface=uuid_of_management_interface_pif

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

host-enable

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

Habilita los servidores Citrix Hypervisor especificados, lo que permite que se inicien nuevas máquinas virtuales en ellos.

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

host-enable-display

host-enable-display uuid=host_uuid

Habilitar la visualización para el host.

host-enable-local-storage-caching

host-enable-local-storage-caching  sr-uuid=sr_uuid

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

host-evacuate

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

Live migra todas las máquinas virtuales en ejecución a otros hosts adecuados de un grupo. Primero, desbale el host mediante elhost-disable comando.

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

Con HA habilitada, su ú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 apagado del host.

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

host-forget

host-forget uuid=host_uuid

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

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

Advertencia:

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

Este comando es útil si el servidor Citrix Hypervisor para «olvidar» está muerto. Sin embargo, si el servidor Citrix Hypervisor está activo y forma parte del grupo, utilicexe pool-eject en su lugar.

host-get-cpu-features

host-get-cpu-features {features=pool_master_cpu_features} [uuid=host_uuid]

Imprime una representación hexadecimal de las características físicas de CPU del host.

host-get-server-certificate

host-get-server-certificate

Obtener el certificado SSL del servidor instalado.

host-get-sm-diagnostics

host-get-sm-diagnostics uuid=uuid

Mostrar información de diagnóstico de SM por host.

host-get-system-status

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

Descargue la información de estado del sistema en el archivo especificado. El parámetro opcionalentries es una lista separada por comas de entradas de estado del sistema, tomada del fragmento XML de capacidades devuelto por elhost-get-system-status-capabilities comando. 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ámetrooutput puede ser tar.bz2 (el valor predeterminado) o zip . Si no se especifica este parámetro, el archivo se guarda entar.bz2 forma.

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

host-get-system-status-capabilities

host-get-system-status-capabilities [host-selector=host_selector_value...]

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

Cada entidad de capacidad puede tener los siguientes atributos.

  • keyIdentificador único para la capacidad.
  • content-type Puede ser texto/plano o aplicación/datos. Indica si una interfaz de usuario puede representar las entradas para consumo humano.
  • default-checked Puede ser sí o no. Indica si una interfaz de usuario debe seleccionar esta entrada de forma predeterminada.
  • min-size,max-sizeIndica un rango aproximado para el tamaño, en bytes, de esta entrada. -1 indica que el tamaño no es importante.
  • min-time,max-timeIndique un rango aproximado para el tiempo, en segundos, tomado para recoger esta entrada. -1 indica que el tiempo no es importante.
  • Información depii 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 siguientes valores:

    • no: no hay PII en estas entradas
    • yes: PII probable o ciertamente está en estas entradas
    • maybe: es posible que desee auditar estas entradas para PII
    • if_customized si los archivos no están modificados, entonces no contienen PII. Sin embargo, debido a que alentamos la edición de estos archivos, PII podría haber sido introducido por dicha personalización. Este valor se utiliza 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 PII.

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

host-get-thread-diagnostics

host-get-thread-diagnostics uuid=uuid

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

host-get-vms-which-prevent-evacuation

host-get-vms-which-prevent-evacuation uuid=uuid

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

host-is-in-emergency-mode

host-is-in-emergency-mode

Devuelvetrue si el host con el que está hablando la CLI está en modo de emergencia, defalse lo contrario. Este comando CLI funciona directamente en hosts esclavos incluso sin host maestro presente.

host-license-add

host-license-add [license-file=path/license_filename] [host-uuid=host_uuid]

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

host-license-remove

host-license-remove [host-uuid=host_uuid]

Quitar cualquier licencia aplicada a un host.

host-license-view

host-license-view [host-uuid=host_uuid]

Muestra el contenido de la licencia del servidor Citrix Hypervisor.

host-logs-download

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

Descargue una copia de los registros de los servidores Citrix Hypervisor especificados. La copia se guarda de forma predeterminada en un archivo con marca de tiempo denominadohostname-yyyy-mm-dd T hh:mm:ssZ.tar.gz. Puede especificar un nombre de archivo diferente utilizando el parámetro opcional nombre-archivo.

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

Importante:

Mientras que elxe host-logs-download comando funciona si se ejecuta en el host local (es decir, sin un nombre de host específico especificado), no lo use de esta manera. Al hacerlo, la partición del dominio de control se confunde con la copia de los registros. El comando solo debe usarse desde un equipo remoto fuera del host donde tenga espacio para guardar la copia de los registros.

host-management-disable

host-management-disable

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

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

host-management-reconfigure [interface=device] [pif-uuid=uuid]

Reconfigura el servidor Citrix Hypervisor para que utilice la interfaz de red especificada como interfaz de administración, que es la interfaz que se utiliza 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 Citrix Hypervisor se revincula inmediatamente. Este comando funciona tanto en modo normal como de emergencia.

Si se especifica el UUID de un objeto PIF, el servidor Citrix Hypervisor determina qué dirección IP se reenlazar a sí mismo. No debe estar en modo de emergencia cuando se ejecuta este comando.

Advertencia:

Tenga cuidado al usar este comando CLI fuera del host y asegúrese de tener conectividad de red en la nueva interfaz. Utilícelo xe pif-reconfigure para configurar uno primero. De lo contrario, los comandos de CLI posteriores no pueden llegar al servidor Citrix Hypervisor.

host-power-on

host-power-on [host=host_uuid]

Activa los servidores Citrix Hypervisor con la función Host Power On habilitada. Antes de utilizar este comando, habilite host-set-power-on en el host.

host-reboot

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

Reinicie los servidores Citrix Hypervisor especificados. Los hosts especificados deben deshabilitarse primero mediante elxe host-disable comando; de lo contrario, se mostrará un mensaje deHOST_IN_USE error.

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

Si los servidores Citrix Hypervisor especificados son miembros de un grupo, la pérdida de conectividad al apagar se controla y el grupo se recupera cuando los servidores Citrix Hypervisor vuelven. Los demás miembros y el maestro continúan funcionando.

Si cierra el maestro, el grupo estará fuera de acción hasta que se produzca una de las siguientes acciones:

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

host-restore [file-name=backup_filename] [host-selector=host_selector_value...]

Restaure una copiafile-name de seguridad denominada del software de control de servidor 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 unxe 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 debe realizar esta operación se seleccionan utilizando el mecanismo de selección estándar (ver selectores de host arriba). Los argumentos opcionales pueden ser cualquier número de los parámetros de host enumerados al principio de esta sección.

host-send-debug-keys

host-send-debug-keys  host-uuid=host_uuid keys=keys

Enviar claves de depuración de hipervisor especificadas al host especificado.

host-set-hostname-live

host-set-hostname host-uuid=uuid_of_host hostname=new_hostname

Cambie el nombre de host del servidor Citrix Hypervisor especificado porhost-uuid. Este comando establece de forma persistente tanto el nombre de host en la base de datos de dominio de control como el nombre de host de Linux real del servidor Citrix Hypervisor. El valor de hostname**no es el mismo que el valor del campo name_label .

host-set-power-on-mode

host-set-power-on-mode host=host_uuid power-on-mode={"" | "wake-on-lan" | "iLO" | "DRAC" | "custom"} \
    [ power-on-config:power_on_ip=ip-address power-on-config:power_on_user=user power-on-config:power_on_password_secret=secret-uuid ]

Utilícelo para habilitar la función Host Power On en hosts Citrix Hypervisor compatibles con soluciones de alimentación remota. Al utilizar elhost-set-power-on comando, 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 utilizando 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

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

Apague los servidores Citrix Hypervisor especificados. Los servidores Citrix Hypervisor especificados deben deshabilitarse primero mediante elxe host-disable comando; de lo contrario, se mostrará un mensaje deHOST_IN_USE error.

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

Si los servidores Citrix Hypervisor especificados son miembros de un grupo, la pérdida de conectividad al apagar se controla y el grupo se recupera cuando los servidores Citrix Hypervisor vuelven. Los demás miembros y el maestro continúan funcionando.

Si cierra el maestro, el grupo estará fuera de acción hasta que se produzca una de las siguientes acciones:

  • Usted convierte 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 HA está habilitada para el grupo, uno de los miembros se convierte automáticamente en maestro. Si HA está deshabilitada, debe designar manualmente el servidor deseado como maestro con elpool-designate-new-master comando. Para obtener más información, consulte designar-pool-nuevo-maestro.

host-sm-dp-destroy

host-sm-dp-destroy uuid=uuid dp=dp [allow-leak=true|false]

Intentar destruir y limpiar una ruta de datos de almacenamiento en un host. Siallow-leak=true se proporciona, eliminará todos los registros de la ruta de datos incluso si no se pudo cerrar limpiamente.

host-sync-data

host-sync-data

Sincronice los datos que no son de base de datos almacenados en el maestro de grupos con el host con nombre asignado.

host-syslog-reconfigure

host-syslog-reconfigure [host-selector=host_selector_value...]

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

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

host-data-source-list

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

Enumera los orígenes de datos que se pueden grabar para un host.

Select los hosts en los que desea 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 proporcionan parámetros para seleccionar hosts, la operación se realiza en todos los hosts.

Las fuentes de datos tienen dos parámetros —standard yenabled . Este comando genera los valores de los parámetros:

  • Si un origen de datos se ha enabled establecido en true, las métricas se están registrando actualmente en la base de datos de rendimiento.
  • Si un origen de datos se hastandard establecido entrue , 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 se hastandard establecido enfalse , 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 comenzar a grabar métricas de origen de datos en la base de datos de rendimiento, ejecute el comando host-data-source-record. Este comando se establece enabled en true. Para detener, ejecutar el host-data-source-forget. Este comando se establece enabled en false.

host-data-source-record

host-data-source-record data-source=name_description_of_data_source [host-selectors=host_selector_value...]

Registre el origen de datos especificado para un host.

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

Select los hosts en los que desea 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 proporcionan parámetros para seleccionar hosts, la operación se realiza en todos los hosts.

host-data-source-forget

host-data-source-forget data-source=name_description_of_data_source [host-selectors=host_selector_value...]

Detenga la grabación del origen de datos especificado para un host y olvide todos los datos grabados.

Select los hosts en los que desea 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 proporcionan parámetros para seleccionar hosts, la operación se realiza en todos los hosts.

host-data-source-query

host-data-source-query data-source=name_description_of_data_source [host-selectors=host_selector_value...]

Muestra el origen de datos especificado para un host.

Select los hosts en los que desea 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 proporcionan parámetros para seleccionar hosts, la operación se realiza en todos los hosts.

Comandos de registro

Comandos para trabajar con registros.

log-get

log-get

Devuelve el registro almacenado actualmente en el registrador de cadenas.

log-get-keys

log-get-keys

Enumere las claves conocidas por el registrador.

log-reopen

log-reopen

Vuelva a abrir todos los registradores (use esto para rotar archivos).

log-set-output

log-set-output output=output [key=key] [level=level]

Establezca todos los registradores en la salida especificada (nil, stderr, string, file:filename, syslog:something).

Comandos de mensajes

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

Los objetos de mensaje se pueden enumerar con el comando estándar de lista 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 mensaje

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

message-create

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

Crea un mensaje.

message-destroy

message-destroy [uuid=message_uuid]

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

Comandos de red

Comandos para trabajar con redes.

Los objetos de red se pueden enumerar con el comando de lista de objetos estándar (xe network-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 red

Las redes tienen los siguientes parámetros:

Nombre de parámetro Descripción Tipo
uuid La referencia única de identificador/objeto para la red Sólo lectura
name-label El nombre de la red Lectura/Escritura
name-description El texto de descripción de la red Lectura/Escritura
VIF-uuids Una lista de identificadores únicos de los VIFs (interfaces de red virtual) que están conectados desde máquinas virtuales a esta red Parámetro de conjunto de sólo lectura
PIF-uuids Una lista de identificadores únicos de las interfaces de red físicas (PIF) conectadas desde los servidores Citrix Hypervisor a esta red Parámetro de conjunto de sólo lectura
bridge Nombre del puente correspondiente a esta red en el servidor local de Citrix Hypervisor Sólo lectura
default-locking-mode Objeto de red utilizado con objetos VIF para el filtrado ARP. Establezca esta opciónunlocked para eliminar todas las reglas de filtrado asociadas al VIF. Ajuste paradisabled que el VIF deje caer todo el tráfico. Lectura/Escritura
purpose Conjunto de propósitos para los que el servidor Citrix Hypervisor utiliza esta red. Se establecenbd en para utilizar la red para realizar conexiones NBD. Lectura/Escritura
other-config:staticroutes Lista separada por comas de entradas con formato de subred/máscarade red/puerta de enlaceque especifica la dirección de la puerta de enlace a través de la cual se enrutan las subredes. Por ejemplo, si se estableceother-config:static-routes en 172.16.0.0/15/192.168.0.3,172.18.0.0/16/192.168.0.4, el tráfico en 172.16.0.0/15 se enruta a través de 192.168.0.3 y el tráfico en 172.18.0.0/16 se enruta a través de 192.168.0.4. Lectura/Escritura
other-config:ethtoolautoneg Establezca en no para deshabilitar la negociación automática de la interfaz física o el puente. El valor predeterminado es sí. Lectura/Escritura
other-config:ethtool-rx Establecer en activado para habilitar la suma de comprobación de recepción, desactivado para deshabilitar Lectura/Escritura
other-config:ethtool-tx Establecer en activado para habilitar la suma de comprobación de transmisión, desactivado para deshabilitar Lectura/Escritura
other-config:ethtool-sg Establecer en activado para habilitar la recopilación de dispersión, desactivado para deshabilitar Lectura/Escritura
other-config:ethtool-tso Establecer en activado para habilitar la descarga de segmentación tcp, desactivado para deshabilitar Lectura/Escritura
other-config:ethtool-ufo Establecer en activado para habilitar la descarga de fragmentos UDP, desactivado para deshabilitar Lectura/Escritura
other-config:ethtool-gso Establecer en activado para habilitar la descarga de segmentación genérica, desactivado para deshabilitar Lectura/Escritura
blobs Almacén de datos binario Sólo lectura

network-create

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

Crea una red.

network-destroy

network-destroy uuid=network_uuid

Destruye una red existente.

Comandos SR-IOV

Comandos para trabajar con SR-IOV.

Los objetos network-sriov se pueden enumerar con el comando estándar de lista de objetos (xe network-sriov-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 SR-IOV

SR-IOV tiene los siguientes parámetros:

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

network-sriov-create

network-sriov-create network-uuid=network_uuid pif-uuid=physical_pif_uuid

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

network-sriov-destroy

network-sriov-destroy uuid=network_sriov_uuid

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

Asignar un VF SR-IOV

xe vif-create device=device_index mac=vf_mac_address network-uuid=sriov_network vm-uuid=vm_uuid

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

Comandos del Controller SDN

Comandos para trabajar con el controlador SDN.

sdn-controller-forget

sdn-controller-introduce [address=address] [protocol=protocol] [tcp-port=tcp_port]

Introducir un controlador SDN.

sdn-controller-introduce

sdn-controller-forget uuid=uuid

Retire una controladora SDN.

Comandos de túnel

Comandos para trabajar con túneles.

tunnel-create

tunnel-create pif-uuid=pif_uuid network-uuid=network_uuid

Crear un nuevo túnel en un host.

tunnel-destroy

tunnel-destroy uuid=uuid

Destruye un túnel.

Comandos de parche

Comandos para trabajar con parches.

patch-apply

patch-apply uuid=patch_uuid host-uuid=host_uuid

Aplique el parche cargado anteriormente al host especificado.

patch-clean

patch-clean uuid=uuid

Eliminar un archivo de revisión cargado anteriormente.

patch-destroy

patch-destroy uuid=uuid

Quite un registro de parche no aplicado y archivos del servidor.

patch-pool-apply

patch-pool-apply uuid=uuid

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

patch-pool-clean

patch-pool-clean uuid=uuid

Eliminar un archivo de parche cargado anteriormente en todos los hosts del grupo.

patch-precheck

patch-precheck uuid=uuid host-uuid=host_uuid

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

patch-upload

patch-upload file-name=file_name

Cargar un archivo de revisión en el servidor.

Comandos PBD

Comandos para trabajar con PBD (Physical Block Devices). Los PBD son los objetos de software a través de los cuales el servidor Citrix Hypervisor accede a los repositorios de almacenamiento (SRs).

Los objetos PBD se pueden enumerar con el comando estándar de lista 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 PBD

Los PBD tienen los siguientes parámetros:

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

pbd-create

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

Cree un PBD en su servidor Citrix Hypervisor. Eldevice-config parámetro de sólo lectura sólo se puede establecer en el momento de la creación.

Para agregar una asignación de ‘path’ a ‘/tmp’, la línea de comandos debe contener el argumentodevice-config:path=/tmp

Para obtener una lista completa de pares clave/valor de configuración de dispositivo compatibles en cada tipo SR, consulteAlmacenamiento.

pbd-destroy

pbd-destroy uuid=uuid_of_pbd

Destruye el PBD especificado.

pbd-plug

pbd-plug uuid=uuid_of_pbd

Intenta conectar el PBD al servidor Citrix Hypervisor. Si este comando se ejecuta correctamente, el SR al que se hace referencia (y los VDI contenidos en) deberían ser visibles para el servidor Citrix Hypervisor.

pbd-unplug

pbd-unplug uuid=uuid_of_pbd

Intente desconectar la PBD del servidor Citrix Hypervisor.

Comandos PIF

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

Los objetos 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 de parámetro Descripción Tipo
uuid La referencia única de identificador/objeto para el PIF Sólo lectura
device machine-readable Nombre de la interfaz (por ejemplo, eth0) Sólo lectura
MAC La dirección MAC del PIF Sólo lectura
other-config name:value`` Pares de configuración PIF adicionales. Parámetro de mapa de lectura y escritura
physical Si es true, el PIF apunta a una interfaz de red física real Sólo lectura
currently-attached ¿Está el PIF conectado actualmente a este host? true ofalse Sólo lectura
MTU Unidad máxima de transmisión del PIF en bytes. Sólo 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 Sólo lectura
bond-master-of El UUID del enlace que este PIF es el maestro de (si lo hay) Sólo lectura
bond-slave-of El UUID del enlace que este PIF es el esclavo de (si lo hay) Sólo lectura
management ¿Se designa este PIF para ser una interfaz de administración para el dominio de control? Sólo lectura
network-uuid La referencia única de identificador/objeto de la red virtual a la que está conectado este PIF Sólo lectura
network-name-label El nombre de la red virtual a la que está conectado este PIF Sólo lectura
host-uuid La referencia única de identificador/objeto del servidor Citrix Hypervisor al que está conectado este PIF Sólo lectura
host-name-label El nombre del servidor Citrix Hypervisor al que está conectado este PIF Sólo lectura
IP-configuration-mode Tipo de configuración de dirección de red utilizada; DHCP o estática Sólo lectura
IP Dirección IP del PIF. Definido aquí cuando el modo de configuración IP es estático; no definido cuando DHCP Sólo lectura
netmask Máscara de red del PIF. Definido aquí cuando el modo de configuración IP es estático; no definido cuando es suministrado por DHCP Sólo lectura
gateway Dirección de puerta de enlace de la PIF. Definido aquí cuando el modo de configuración IP es estático; no definido cuando es suministrado por DHCP Sólo lectura
DNS Dirección DNS del PIF. Definido aquí cuando el modo de configuración IP es estático; no definido cuando es suministrado por DHCP Sólo lectura
io_read_kbs Velocidad media de lectura en KB/s para el dispositivo Sólo lectura
io_write_kbs Velocidad media de escritura en KB/s para el dispositivo Sólo lectura
carrier Estado del enlace para este dispositivo Sólo lectura
vendor-id El ID asignado al proveedor de NIC Sólo lectura
vendor-name Nombre del proveedor de NIC Sólo lectura
device-id El identificador asignado por el proveedor a este modelo de NIC Sólo lectura
device-name El nombre asignado por el proveedor a este modelo de NIC Sólo lectura
speed Velocidad de transferencia de datos de la NIC Sólo lectura
duplex Modo de dúplex de la NIC; completo o medio Sólo lectura
pci-bus-path Dirección de ruta del bus PCI Sólo lectura
other-config:ethtoolspeed Establece la velocidad de conexión en Mbps Lectura/Escritura
other-config:ethtoolautoneg Establezca en no para deshabilitar 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 del PIF, ya sea completa o media. Lectura/Escritura
other-config:ethtool-rx Establecer en activado para habilitar la suma de comprobación de recepción, desactivado para deshabilitar Lectura/Escritura
other-config:ethtool-tx Establecer en activado para habilitar la suma de comprobación de transmisión, desactivado para deshabilitar Lectura/Escritura
other-config:ethtool-sg Establecer en activado para habilitar la recopilación de dispersión, desactivado para deshabilitar Lectura/Escritura
other-config:ethtool-tso Establecer en activado para habilitar la descarga de segmentación tcp, desactivado para deshabilitar Lectura/Escritura
other-config:ethtool-ufo Establecer en activado para habilitar la descarga de fragmentos udp, desactivado para deshabilitar Lectura/Escritura
other-config:ethtool-gso Establecer en activado para habilitar la descarga de segmentación genérica, desactivado para deshabilitar Lectura/Escritura
other-config:domain Lista separada por comas utilizada para establecer la ruta de búsqueda DNS Lectura/Escritura
other-config:bondmiimon Intervalo entre comprobaciones de capacidad de enlace, en milisegundos Lectura/Escritura
other-config:bonddowndelay Número de milisegundos a esperar después de que el enlace se pierde antes de considerar realmente el enlace que se ha ido. Este parámetro permite la pérdida transitoria de enlaces Lectura/Escritura
other-config:bondupdelay Número de milisegundos a esperar después de que aparezca el enlace antes de realmente considerarlo. Permite que los enlaces se aleten. El valor predeterminado es31s permitir que los conmutadores comiencen a reenviar tráfico. Lectura/Escritura
disallow-unplug True si este PIF es una NIC de almacenamiento dedicado, false en caso contrario Lectura/Escritura

Nota:

Los cambios realizados en losother-config campos de un PIF solo surtirán efecto después de un reinicio. Alternativamente, utilice losxe pif-unplug comandosxe pif-plug y para hacer que la configuración PIF se vuelva a escribir.

pif-forget

pif-forget uuid=uuid_of_pif

Destruye el objeto PIF especificado en un host determinado.

pif-introduce

pif-introduce host-uuid=host_uuid mac=mac_address_for_pif device=interface_name

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

pif-plug

pif-plug uuid=uuid_of_pif

Intentar que se haga aparecer la interfaz física especificada.

pif-reconfigure-ip

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

Modifique la dirección IP del PIF. Para la configuración de IP estática, establezca el parámetro modeen static con los parámetros gateway, IP y netmask establecidos en los valores apropiados. Para utilizar DHCP, establezca elmode parámetroDHCP y deje los parámetros estáticos indefinidos.

Nota:

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

pif-reconfigure-ipv6

pif-reconfigure-ipv6 uuid=uuid_of_pif mode=mode [gateway=network_gateway_address] [IPv6=static_ip_for_this_pif] [DNS=dns_address]

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

pif-scan

pif-scan host-uuid=host_uuid

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

pif-set-primary-address-type

pif-set-primary-address-type  uuid=uuid primary_address_type=address_type

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

pif-unplug

pif-unplug uuid=uuid_of_pif

Intentar bajar la interfaz física especificada.

Comandos de grupo

Comandos para trabajar con grupos. Un grupo es un agregado de uno o más servidores Citrix Hypervisor. Un grupo utiliza uno o más repositorios de almacenamiento compartido 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 máquina virtual todavía se está ejecutando, sin necesidad de cerrarla y volver a poner en marcha. Cada servidor Citrix Hypervisor es realmente un grupo compuesto por un solo miembro de forma predeterminada. Cuando el servidor Citrix Hypervisor se une a un grupo, se designa como miembro y el grupo al que se ha unido se convierte en el principal del grupo.

El objeto de grupo singleton se puede enumerar con el comando estándar de lista 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 del grupo

Los grupos tienen los siguientes parámetros:

Nombre de parámetro Descripción Tipo
uuid La referencia única de identificador/objeto para el grupo Sólo lectura
name-label El nombre del grupo Lectura/Escritura
name-description La cadena de descripción del grupo Lectura/Escritura
master La referencia única de identificador/objeto del servidor Citrix Hypervisor designado como maestro del grupo Sólo 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 bloqueo para miembros del grupo Lectura/Escritura
metadata-vdis Todos los VDI de metadatos conocidos para el grupo Sólo lectura
suspend-image-SR La referencia única de identificador/objeto del SR donde se guardan las VM suspendidas en 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 SR que este grupo puede usar Sólo lectura
ha-enabled True si HA está habilitado para el grupo, false en caso contrario Sólo lectura
ha-configuration Reservado para uso futuro. Sólo lectura
ha-statefiles Enumera los UUID de los VDI que está utilizando HA para determinar el estado del almacenamiento de información Sólo lectura
ha-host-failures-to-tolerate El número 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 manejar, de acuerdo con los cálculos del algoritmo HA Sólo 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 Sólo lectura
blobs Almacén de datos binario Sólo lectura
live-patching-disabled Establezca el valor False para habilitar la aplicación de parches en tiempo real. Establezca en True para deshabilitar la aplicación de parches en vivo. Lectura/Escritura
igmp-snooping-enabled Establezca en True para habilitar la indagación IGMP. Establezca el valor False para deshabilitar la indagación IGMP. Lectura/Escritura

pool-apply-edition

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

Aplicar una edición en todo el grupo.

pool-certificate-install

pool-certificate-install filename=file_name

Instale un certificado SSL, en todo el grupo.

pool-certificate-list

pool-certificate-list

Enumere todos los certificados SSL instalados.

pool-certificate-sync

pool-certificate-sync

Sincronizar certificados SSL y listas de revocación de certificados de maestro a esclavos.

pool-certificate-uninstall

pool-certificate-uninstall name=name

Desinstale un certificado SSL.

pool-crl-install

pool-crl-install filename=file_name

Instale una lista de revocación de certificados SSL, en todo el grupo.

pool-crl-list

pool-crl-list

Enumere todas las listas de revocación de certificados SSL instaladas.

pool-crl-uninstall

pool-crl-uninstall name=name

Desinstale una lista de revocación de certificados SSL.

pool-deconfigure-wlb

pool-deconfigure-wlb

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

pool-designate-new-master

pool-designate-new-master host-uuid=uuid_of_new_master

Indique al miembro del servidor Citrix Hypervisor especificado que se convierta en el maestro de un grupo existente. Este comando realiza una transferencia ordenada de la función de host maestro a otro host del fondo de recursos. Este comando sólo funciona cuando el maestro actual está en línea. No es un reemplazo de los comandos de modo de emergencia que se enumeran a continuación.

pool-disable-external-auth

pool-disable-external-auth [uuid=uuid] [config=config]

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

pool-disable-local-storage-caching

pool-disable-local-storage-caching uuid=uuid

Deshabilite el almacenamiento en caché local en el grupo.

pool-disable-redo-log

pool-disable-redo-log

Deshabilite el redo log si está en uso, a menos que HA esté habilitado.

pool-disable-ssl-legacy

pool-disable-ssl-legacy [uuid=uuid]

Establezca ssl-legacy en False en cada host.

pool-dump-database

pool-dump-database file-name=filename_to_dump_database_into_(on_client)

Descargue una copia de toda la base de datos del grupo y volque en un archivo en el cliente.

pool-enable-external-auth

pool-enable-external-auth  auth-type=auth_type service-name=service_name [uuid=uuid] [config:=config]

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

pool-enable-local-storage-caching

pool-enable-local-storage-caching uuid=uuid

Habilite el almacenamiento en caché local en el grupo.

pool-enable-redo-log

pool-ensable-redo-log sr-uuid=sr_uuid

Habilite el redo log en el SR dado si está en uso, a menos que HA esté habilitado.

pool-enable-ssl-legacy

pool-enable-ssl-legacy [uuid=uuid]

Establezca ssl-legacy en True en cada host. «

pool-eject

pool-eject host-uuid=uuid_of_host_to_eject

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

pool-emergency-reset-master

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

Indique a un miembro esclavo del servidor Citrix Hypervisor que restablezca su dirección maestra al nuevo valor e intente conectarse a él. No ejecute este comando en hosts maestros.

pool-emergency-transition-to-master

pool-emergency-transition-to-master

Indique a un servidor miembro de Citrix Hypervisor que se convierta en el maestro de grupo. El servidor Citrix Hypervisor acepta este comando sólo después de que el host haya pasado al modo de emergencia. El modo de emergencia significa que es un miembro de un grupo cuyo maestro ha desaparecido de la red y no puede ser contactado después de algunos intentos.

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

pool-ha-enable

pool-ha-enable heartbeat-sr-uuids=uuid_of_heartbeat_sr

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

pool-ha-disable

pool-ha-disable

Deshabilita la característica de alta disponibilidad en el fondo de recursos.

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

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

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

pool-ha-compute-hypothetical-max-host-failures-to-tolerate [vm-uuid=vm_uuid] [restart-priority=restart_priority]

Calcule el número máximo de errores de host que se deben tolerar con las VM protegidas propuestas suministradas.

pool-initialize-wlb

pool-initialize-wlb wlb_url=url wlb_username=wlb_username wlb_password=wlb_password xenserver_username=username xenserver_password=password

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

pool-join

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

Indique al servidor Citrix Hypervisor que se una a un grupo existente.

pool-management-reconfigure

pool-management-reconfigure [network-uuid=network-uuid]

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

Si se especifica el nombre del dispositivo de una interfaz (que debe tener una dirección IP), el host maestro de Citrix Hypervisor se revincula inmediatamente. Este comando funciona tanto en modo normal como de emergencia.

Desde el UUID de red especificado, el UUID del objeto PIF se identifica y asigna al servidor Citrix Hypervisor, que determina qué dirección IP se reenlazar a sí mismo. No debe estar en modo de emergencia cuando se ejecuta este comando.

Advertencia:

Tenga cuidado al usar este comando CLI fuera del host y asegúrese de tener conectividad de red en la nueva interfaz. Utilícelo xe pif-reconfigure para configurar uno primero. De lo contrario, los comandos de CLI posteriores no pueden llegar al servidor Citrix Hypervisor.

pool-recover-slaves

pool-recover-slaves

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 utiliza normalmente después de que sepool-emergency-transition-to-master ha utilizado para establecer uno de los miembros como el nuevo maestro.

pool-restore-database

pool-restore-database file-name=filename_to_restore_from_on_client [dry-run=true|false]

Cargar una copia de seguridad de base de datos (creada conpool-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 verificar que la base de datos del grupo se puede restaurar sin realizar realmente la operación. De forma predeterminada,dry-run se establece en false.

pool-retrieve-wlb-configuration

pool-retrieve-wlb-configuration

Recupera los criterios de optimización del grupo desde el servidor de Equilibrio de carga de trabajo.

pool-retrieve-wlb-diagnostics

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

Recupera diagnósticos desde el servidor Equilibrio de carga de trabajo.

pool-retrieve-wlb-recommendations

pool-retrieve-wlb-recommendations

Recupera recomendaciones de migración de VM para el grupo desde el servidor de Equilibrio de carga de trabajo.

pool-retrieve-wlb-report

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

Recupera informes del servidor Equilibrio de carga de trabajo.

pool-send-test-post

pool-send-test-post dest-host=destination_host dest-port=destination_port body=post_body

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

pool-send-wlb-configuration

pool-send-wlb-configuration [config:=config]

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

pool-sync-database

pool-sync-database

Forzar la base de datos del grupo para que se sincronice en todos los hosts del fondo de recursos. Este comando no es necesario en el funcionamiento normal, ya que la base de datos se replica automáticamente regularmente. Sin embargo, el comando puede ser útil para garantizar que los cambios se replican rápidamente después de realizar un conjunto significativo de operaciones CLI.

Conjunto de grupoigmp-snooping

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

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

Comandos del Acelerador de PVS

Comandos para trabajar con el Acelerador PVS.

pvs-cache-storage-create

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

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

pvs-cache-storage-destroy

pvs-cache-storage-destroy uuid=uuid

Eliminar una caché PVS.

pvs-proxy-create

pvs-proxy-create pvs-site-uuid=pvs_site_uuid vif-uuid=vif_uuid

Configure un VM/VIF para utilizar un proxy PVS.

pvs-proxy-destroy

pvs-proxy-destroy uuid=uuid

Elimine (o desactive) un proxy PVS para este VIF/VM.

pvs-server-forget

pvs-server-forget uuid=uuid

Olvide un servidor PVS.

pvs-server-introduce

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

Introducir nuevo servidor PVS.

pvs-site-forget

pvs-site-forget uuid=uuid

Olvídate de un sitio PVS.

pvs-site-introduce

pvs-site-introduce name-label=name_label [name-description=name_description] [pvs-uuid=pvs_uuid]

Introducir nuevo sitio PVS.

Comandos del Administrador de almacenamiento

Comandos para controlar los complementos de Storage Manager.

Los objetos del administrador de almacenamiento se pueden enumerar con el comando estándar de lista 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 SMS tienen los siguientes parámetros:

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

Comandos de instantáneas

Comandos para trabajar con instantáneas.

snapshot-clone

snapshot-clone new-name-label=name_label [uuid=uuid] [new-name-description=description]

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

snapshot-copy

snapshot-copy new-name-label=name_label [uuid=uuid] [new-name-description=name_description] [sr-uuid=sr_uuid]

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

snapshot-destroy

snapshot-destroy  [uuid=uuid] [snapshot-uuid=snapshot_uuid]

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

snapshot-disk-list

snapshot-disk-list [uuid=uuid] [snapshot-uuid=snapshot_uuid] [vbd-params=vbd_params] [vdi-params=vdi_params]

Enumere los discos de la máquina virtual (s) seleccionada (s).

snapshot-export-to-template

snapshot-export-to-template filename=file_name snapshot-uuid=snapshot_uuid  [preserve-power-state=true|false]

Exportar una instantánea a nombre de archivo.

snapshot-reset-powerstate

snapshot-reset-powerstate [uuid=uuid] [snapshot-uuid=snapshot_uuid] [--force]

Force que el powerstate de VM se detenga sólo en la base de datos de la pila de herramientas de administración. Este comando se utiliza para recuperar una instantánea que está marcada como «suspendida». Esta es una operación potencialmente peligrosa: debe asegurarse de que ya no necesita la imagen de memoria (es decir, ya no podrá reanudar su instantánea).

snapshot-revert

snapshot-revert [uuid=uuid] [snapshot-uuid=snapshot_uuid]

Revertir una máquina virtual existente a un estado de punto de comprobación o instantánea anterior.

snapshot-uninstall

snapshot-uninstall [uuid=uuid] [snapshot-uuid=snapshot_uuid] [--force]

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

Comandos SR

Comandos para controlar SRs (repositorios de almacenamiento).

Los objetos 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 SR

Los SRs tienen los siguientes parámetros:

Nombre de parámetro Descripción Tipo
uuid El identificador único y la referencia del objeto para el SR Sólo lectura
name-label El nombre de la SR Lectura/Escritura
name-description La cadena de descripción del SR Lectura/Escritura
allowed-operations Lista de las operaciones permitidas en el SR en este estado Parámetro de conjunto de sólo lectura
current-operations Lista de las operaciones actualmente en curso en esta SR Parámetro de conjunto de sólo lectura
VDIs Referencia única de identificador/objeto para los discos virtuales en este SR Parámetro de conjunto de sólo lectura
PBDs Identificador/referencia única de objeto para los PBD adjuntos a esta SR Parámetro de conjunto de sólo lectura
physical-utilisation Espacio físico utilizado actualmente en este SR, en bytes. Para formatos de disco de aprovisionamiento ligero, la utilización física puede ser menor que la asignación virtual Sólo lectura
physical-size Tamaño físico total del SR, en bytes Sólo lectura
type Tipo de SR, utilizado para especificar el controlador de back-end SR que se va a utilizar Sólo lectura
introduced-by El drtask (en su caso) que introdujo la SR Sólo lectura
content-type El tipo de contenido de la SR. Se utiliza para distinguir bibliotecas ISO de otras SRs. Para los repositorios de almacenamiento que almacenan una biblioteca de ISOs, el tipo de contenido debe establecerse en iso. En otros casos, le recomendamos que establezca este parámetro en vacío o en el usuario de cadena. Sólo lectura
shared True si este SR se puede compartir entre varios servidores Citrix Hypervisor; False en caso contrario Lectura/Escritura
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
host El nombre del host del repositorio de almacenamiento de información Sólo lectura
virtual-allocation Suma de los valores de tamaño virtual de todos los VDI en este repositorio de almacenamiento (en bytes) Sólo lectura
sm-config Datos dependientes de SM Parámetro de mapa de sólo lectura
blobs Almacén de datos binario Sólo lectura

sr-create

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

Crea un SR en el disco, lo introduce en la base de datos y crea un PBD adjuntando el SR al servidor Citrix Hypervisor. Sishared se establece entrue , se crea un PBD para cada servidor Citrix Hypervisor del grupo. Si noshared se especifica o se establece enfalse , sólo se crea un PBD para el servidor Citrix Hypervisor especificado conhost-uuid .

Los parámetros device-config exactos difieren según el dispositivo type. Para obtener información detallada sobre estos parámetros en los diferentes back-ends de almacenamiento de información, consulte Almacenamiento.

sr-data-source-forget

sr-data-source-forget data-source=data_source

Detenga la grabación del origen de datos especificado para un SR y olvide todos los datos grabados.

sr-data-source-list

sr-data-source-list"

Enumere los orígenes de datos que se pueden grabar para una SR.

sr-data-source-query

sr-data-source-query data-source=data_source

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

sr-data-source-record

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

Registre el origen de datos especificado para un SR.

sr-destroy

sr-destroy uuid=sr_uuid

Destruye el SR especificado en el servidor Citrix Hypervisor.

sr-enable-database-replication

sr-enable-database-replication uuid=sr_uuid

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

sr-disable-database-replication

sr-disable-database-replication uuid=sr_uuid

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

sr-forget

sr-forget uuid=sr_uuid

El agente XAPI olvida una SR especificada en el servidor Citrix Hypervisor. Cuando el agente XAPI olvida un SR, el SR se separa y no se puede acceder a los VDI en él, pero permanece intacto en el medio de origen (los datos no se pierden).

sr-introduce

sr-introduce name-label=name physical-size=physical_size type=type content-type=content_type uuid=sr_uuid

Simplemente coloca un registro SR en la base de datos. Utilícelodevice-config para especificar parámetros adicionales en su formadevice-config:parameter_key=parameter_value , por ejemplo:

xe sr-introduce device-config:device=/dev/sdb1

Nota:

Este comando nunca se utiliza en el 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 escenarios de error.

sr-probe

sr-probe type=type [host-uuid=host_uuid] [device-config:config_name=value]

Realiza un análisis específico de back-end, utilizando lasdevice-config claves proporcionadas. Si eldevice-config está completo para el back-end SR, este comando devuelve una lista de los SRs presentes en el dispositivo, si los hay. Si losdevice-config parámetros son sólo 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 de back-end, impreso en la CLI.

Los parámetros device-config exactos difieren según el dispositivo type. Para obtener información detallada sobre estos parámetros en los diferentes back-ends de almacenamiento de información, consulte Almacenamiento.

sr-probe-ext

sr-probe-ext type=type [host-uuid=host_uuid] [device-config:=config] [sm-config:-sm_config]

Realice un sondeo 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 SR.

sr-scan

sr-scan uuid=sr_uuid

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

sr-update

sr-update uuid=uuid

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

lvhd-enable-thin-provisioning

lvhd-enable-thin-provisioning  sr-uuid=sr_uuid initial-allocation=initial_allocation allocation-quantum=allocation_quantum

Habilite el aprovisionamiento ligero en una SR LVHD.

Comandos de asunto

Comandos para trabajar con sujetos.

session-subject-identifier-list

session-subject-identifier-list

Devuelve una lista de todos los identificadores de sujeto de usuario de todas las sesiones existentes autenticadas externamente.

session-subject-identifier-logout

session-subject-identifier-logout subject-identifier=subject_identifier

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

session-subject-identifier-logout-all

session-subject-identifier-logout-all

Cierre la sesión de todas las sesiones autenticadas externamente.

subject-add

subject-add subject-name=subject_name

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

subject-remove

subject-remove subject-uuid=subject_uuid

Elimine un asunto de la lista de sujetos que pueden acceder al grupo.

subject-role-add

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

Agregar un rol a un asunto.

subject-role-remove

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

Quitar un rol de un sujeto.

secret-create

secret-create value=value

Crea un secreto.

secret-destroy

secret-destroy uuid=uuid

Destruye un secreto.

Comandos de tarea

Comandos para trabajar con tareas asincrónicas de larga duración. Estos comandos son tareas como iniciar, detener y suspender una máquina virtual. Las tareas se componen normalmente de un conjunto de otras subtareas atómicas que en conjunto realizan la operación solicitada.

Los objetos de tarea se pueden enumerar con el comando estándar de lista 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 tarea

Las tareas tienen los siguientes parámetros:

Nombre de parámetro Descripción Tipo
uuid La referencia única de identificador/objeto para la tarea Sólo lectura
name-label El nombre de la tarea Sólo lectura
name-description La cadena de descripción de la tarea Sólo lectura
resident-on La referencia única de identificador/objeto del host en el que se ejecuta la tarea Sólo lectura
status Estado de la tarea Sólo lectura
progress Si la tarea sigue pendiente, este campo contiene el porcentaje estimado completado, de 0 a 1. Si la tarea se ha completado correctamente o sin éxito, el valor es 1. Sólo lectura
type Si la tarea se ha completado correctamente, este parámetro contiene el tipo del resultado codificado. El tipo es el nombre de la clase cuya referencia está en el campo de resultado. De lo contrario, el valor de este parámetro no está definido Sólo lectura
result Si la tarea se ha completado correctamente, este campo contiene el valor de resultado, ya sea Vacío o una referencia de objeto; de lo contrario, el valor de este parámetro no está definido Sólo 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 Sólo lectura
allowed_operations Lista de las operaciones permitidas en este estado Sólo lectura
created Hora de creación de la tarea Sólo lectura
finished Tarea de tiempo finalizada (es decir, correcta o fallida). Si el estado de la tarea está pendiente, entonces el valor de este campo no tiene significado Sólo lectura
subtask_of Contiene el UUID de las tareas que esta tarea es una subtarea de Sólo lectura
subtasks Contiene los UUID de todas las subtareas de esta tarea Sólo lectura

task-cancel

task-cancel [uuid=task_uuid]

Dirija la tarea especificada a cancelar y devolver.

Comandos de plantilla

Comandos para trabajar con plantillas de VM.

Las plantillas son esencialmente máquinas virtuales con elis-a-template parámetro establecido entrue . 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 «raw» genéricas que pueden arrancar un CD de instalación de un 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 su uso futuro en la implementación de máquinas virtuales.

Los objetos de plantilla se pueden enumerar con el comando de lista de objetos estándar (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 elis-a-template parámetro enfalse . Nois-a-template se admite la configuración delfalse parámetro en 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 ( sólo lectura) la referencia de identificador/objeto única para la plantilla
  • name-label ( lectura/escritura) el nombre de la plantilla
  • name-description ( lectura/escritura) la cadena descriptiva 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 máquinas virtuales de plantilla nunca se pueden iniciar, solo se utilizan para clonar otras máquinas virtuales. Después de que este valor se ha establecido en true, no se puede restablecer en false. Las máquinas virtuales de plantilla no se pueden convertir en máquinas virtuales mediante este parámetro.
  • is-control-domain ( sólo lectura) true si se trata de un dominio de control (dominio 0 o dominio de controlador)
  • power-state ( sólo lectura) estado de energía actual. El valor siempre se detiene para una plantilla
  • memory-dynamic-max ( sólo lectura) memoria máxima dinámica en bytes. Actualmente no utilizado, pero si se cambia la siguiente restricción debe ser obedecido:memory_static_max>=memory_dynamic_max>=``````` -memory_dynamic_min>=memory_static_min```` Sí.`
  • memory-dynamic-min ( lectura/escritura) memoria mínima dinámica en bytes. Actualmente no utilizado, pero si se cambian las mismas restricciones paramemory-dynamic-max deben ser obedecidas.
  • memory-static-max ( lectura/escritura) establecer estáticamente la memoria máxima (absoluta) en bytes. Este campo es el valor principal utilizado para determinar la cantidad de memoria asignada a una VM.
  • memory-static-min ( lectura/escritura) establecer estáticamente la memoria mínima (absoluta) en bytes. Este campo representa la memoria mínima absoluta ymemory-static-min debe ser menor quememory-static-max . Este valor no se utiliza en el funcionamiento normal, pero se debe obedecer la restricción anterior.
  • suspend-VDI-uuid ( sólo lectura) el VDI en el que se almacena una imagen de suspensión (no tiene significado 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
    

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

    También puede ajustar la prioridad de 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
    

    Una VM 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 contenido. Los pesos legales oscilan entre 1 y 65535 y el valor predeterminado es 256.

    Opcionalmente, el límite corrige la cantidad máxima de CPU que una máquina virtual basada en esta plantilla puede consumir, incluso si el servidor 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 es 4 CPU, etc. El valor predeterminado, 0, significa que no hay límite superior.

  • VCPUs-max ( lectura/escritura) número máximo de vCPU
  • VCPUs-at-startup ( lectura/escritura) número de inicio 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 sólo lectura) dispositivos de consola virtual
  • configuración específica de la plataformaplatform (parámetro de mapa de lectura/escritura)

    Para deshabilitar la emulación de un puerto paralelo para invitados HVM (por ejemplo, invitados de Windows):

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

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

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

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

     xe vm-param-set uuid=<vm_uuid> platform:usb=false
     xe vm-param-set uuid=<vm_uuid> platform:usb_tablet=false
    
  • allowed-operations ( parámetro de conjunto de sólo lectura) lista de las operaciones permitidas en este estado
  • current-operations ( parámetro de conjunto de sólo lectura) de las operaciones que están actualmente en curso en esta plantilla
  • allowed-VBD-devices ( parámetro conjunto de sólo lectura) de identificadores VBD disponibles para su uso, representados por enteros del rango 0—15. Esta lista es sólo informativa y se pueden usar otros dispositivos (pero puede que no funcionen).
  • allowed-VIF-devices ( parámetro conjunto de sólo lectura) de identificadores VIF disponibles para su uso, representados por enteros del rango 0—15. Esta lista es sólo 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 del BIOS o una cadena vacía.
  • HVM-boot-params ( parámetro de mapa de lectura/escritura), la clave de orden controla el orden de inicio invitado HVM, representado como una cadena donde cada carácter es un método de arranque: d para el CD/DVD, c para el disco raíz y n para el arranque PXE de red. El valor predeterminado es dc.
  • PV-kernel ( lectura/escritura) al núcleo
  • PV-ramdisk ( lectura/escritura) al initrd
  • PV-args ( lectura/escritura) de argumentos de línea de comandos del núcleo
  • PV-legacy-args ( lectura/escritura) de argumentos para crear máquinas virtuales heredadas basadas en este arranque de plantilla
  • 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 ( sólo lectura) describe los indicadores de CPU en los que se inició por última vez una máquina virtual basada en esta plantilla; no se rellenó para una plantilla
  • resident-on ( sólo lectura) el servidor 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 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 ( sólo lectura) marca de tiempo de la fecha y hora en que se leyeron las métricas de una máquina virtual basada en esta plantilla, en el formularioyyyymmddThh:mm:ss z , donde z es el indicador de zona horaria militar de una sola letra, por ejemplo, Z para UTC (GMT). Establecer en1 Jan 1970 Z (comienzo de la época UNIX/POSIX) para una plantilla
  • install-time ( sólo lectura) marca de tiempo de la fecha y hora en que se leyeron las métricas de una máquina virtual basada en esta plantilla, en el formularioyyyymmddThh:mm:ss z , donde z es el indicador de zona horaria militar de una sola letra, por ejemplo, Z para UTC (GMT). Establecer en1 Jan 1970 Z (comienzo de la época UNIX/POSIX) para una plantilla
  • memory-actual ( sólo lectura) la memoria real que utiliza una máquina virtual basada en esta plantilla; 0 para una plantilla
  • VCPUs-number ( sólo 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 mapa de sólo lectura) de CPU virtuales y su peso parámetro de mapa de sólo lectura os-versión de 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 sólo 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 ( sólo lectura) para la versión más reciente de los controladores paravirtualizados para una VM basada en esta plantilla. Aparece como not in database para una plantilla
  • métricas de memoriamemory (parámetro de mapa de sólo lectura) notificadas por el agente en una máquina virtual basada en esta plantilla. Aparece como not in database para una plantilla
  • métricas de discodisks (parámetro de mapa de sólo lectura) notificadas por el agente en una máquina virtual basada en esta plantilla. Aparece como not in database para una plantilla
  • métricas de rednetworks (parámetro de mapa de sólo lectura) notificadas 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 sólo 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 ( sólo lectura) marca de tiempo cuando el agente invitado realizó la última escritura en estos campos. En el formularioyyyymmddThh: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 ( de sólo lectura) de hosts que potencialmente podrían alojar la VM
  • HVM-shadow-multiplier ( lectura/escritura) aplicado a la cantidad de sombra que se pone a disposición del huésped
  • dom-id ( sólo lectura) ID de dominio (si está disponible, -1 en caso contrario)
  • recommendations ( sólo lectura) Especificación XML de valores y rangos recomendados para las propiedades de esta máquina virtual
  • xenstore-data ( parámetro de mapa de lectura/escritura) que se insertarán en el árbol de xenstore (/local/domain/domid /vmdata) después de crear la máquina virtual.
  • is-a-snapshot ( sólo lectura) True si esta plantilla es una instantánea de VM
  • snapshot_of ( sólo lectura) el UUID de la VM que esta plantilla es una instantánea de
  • snapshots ( sólo lectura) los UUID de cualquier instantánea que se haya tomado de esta plantilla
  • snapshot_time ( sólo lectura) la marca de tiempo de la instantánea de VM más reciente tomada
  • memory-target ( sólo lectura) la cantidad de memoria objetivo establecida para esta plantilla
  • blocked-operations ( parámetro de mapa de lectura/escritura) enumera las operaciones que no se pueden realizar en esta plantilla
  • last-boot-record ( sólo 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 hay un error en el host en el que reside. Este parámetro está ahora en desuso. Utilice el parámetro ha-restartpriority en su lugar.
  • ha-restart-priority ( sólo lectura) reiniciar o el mejor esfuerzo de lectura/escritura blobs binario data store
  • live ( sólo lectura) relevante sólo para una máquina virtual en ejecución.

template-export

template-export template-uuid=uuid_of_existing_template filename=filename_for_new_template

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

template-uninstall

template-uninstall template-uuid=template_uuid [--force]

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 Citrix Hypervisor.

Los objetos de actualización se pueden enumerar con el comando de lista de objetos estándar (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

Actualizar parámetros

Las actualizaciones del servidor Citrix Hypervisor tienen los siguientes parámetros:

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

update-upload

update-upload file-name=update_filename

Cargue un archivo de actualización especificado en el servidor Citrix Hypervisor. Este comando prepara una actualización que se aplicará. En caso de éxito, se imprime el UUID de la actualización cargada. Si la actualización se ha cargado anteriormente, se devuelveUPDATE_ALREADY_EXISTS el error en su lugar y el parche no se carga de nuevo.

update-precheck

update-precheck uuid=update_uuid host-uuid=host_uuid

Ejecute las comprobaciones previas contenidas en la actualización especificada en el servidor Citrix Hypervisor especificado.

update-destroy

update-destroy uuid=update_file_uuid

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

update-apply

update-apply host-uuid=host_uuid uuid=update_file_uuid

Aplique el archivo de actualización especificado.

update-pool-apply

update-pool-apply uuid=update_uuid

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

update-introduce

update-introduce vdi-uuid=vdi_uuid

Introducir actualización VDI.

update-pool-clean

update-pool-clean uuid=uuid

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

Comandos de usuario

user-password-change

user-password-change old=old_password new=new_password

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 VBD

Comandos para trabajar con VBD (Virtual Block Devices).

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

Los objetos 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 de VBD

Los VBD tienen los siguientes parámetros:

Nombre de parámetro Descripción Tipo
uuid La referencia única de identificador/objeto para el VBD Sólo lectura
vm-uuid La referencia única de identificador/objeto para la VM a la que se adjunta este VBD Sólo lectura
vm-name-label El nombre de la máquina virtual a la que se adjunta este VBD Sólo lectura
vdi-uuid La referencia única de identificador/objeto para el VDI al que se asigna este VBD Sólo lectura
vdi-name-label El nombre del VDI al que se asigna este VBD Sólo lectura
empty Sitrue, este VBD representa una unidad vacía Sólo lectura
device El dispositivo visto por el invitado, por ejemplohda Sólo lectura
userdevice Número de dispositivo especificado por el parámetro de dispositivo durantevbd-create, por ejemplo, 0 para hda, 1 para hdb, etc. Lectura/Escritura
bootable True si este VBD es de arranque Lectura/Escritura
mode El modo en el que se debe montar el VBD con Lectura/Escritura
type Cómo aparece el VBD en la VM, por ejemplo disco o CD Lectura/Escritura
currently-attached True si el VBD está conectado a este host, false en caso contrario Sólo lectura
storage-lock True si se adquirió un bloqueo de nivel de almacenamiento Sólo lectura
status-code Código de error/éxito asociado con la última operación de conexión Sólo lectura
status-detail Información de error/éxito asociada con el último estado de la operación de enlace Sólo lectura
qos_algorithm_type El algoritmo QoS que se va a utilizar Lectura/Escritura
qos_algorithm_params Parámetros para el algoritmo QoS elegido Parámetro de mapa de lectura y escritura
qos_supported_algorithms Algoritmos QoS soportados para este VBD Parámetro de conjunto de sólo lectura
io_read_kbs Tasa media de lectura en kB por segundo para este VBD Sólo lectura
io_write_kbs Tasa media de escritura en kB por segundo para este VBD Sólo lectura
allowed-operations Lista de las operaciones permitidas en este estado. Esta lista es sólo de carácter consultivo y el estado del servidor puede haber cambiado cuando un cliente lea este campo. Parámetro de conjunto de sólo lectura
current-operations Vincula cada una de las tareas en ejecución utilizando este objeto (por referencia) a una enumeración current_operation que describe la naturaleza de la tarea. Parámetro de conjunto de sólo lectura
unpluggable True si este VBD admite desconexión en caliente Lectura/Escritura
attachable True si el dispositivo se puede conectar Sólo lectura
other-config Configuración adicional Parámetro de mapa de lectura y escritura

vbd-create

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

Cree un VBD en una VM.

Los valores permitidos para eldevice campo son enteros 0—15, y el número debe ser único para cada máquina virtual. Los valores permitidos actuales se pueden ver en elallowed-VBD-devices parámetro de la VM especificada. Esto se ve comouserdevice en losvbd parámetros.

Si eltype esDisk ,vdi-uuid es necesario. El modo puede serRO oRW para un disco.

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

vbd-destroy

vbd-destroy uuid=uuid_of_vbd

Destruye el VBD especificado.

Si el VBD tiene suother-config:owner parámetro establecido entrue , también se destruye el VDI asociado.

vbd-eject

vbd-eject uuid=uuid_of_vbd

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

vbd-insert

vbd-insert uuid=uuid_of_vbd vdi-uuid=uuid_of_vdi_containing_media

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

vbd-plug

vbd-plug uuid=uuid_of_vbd

Intente adjuntar el VBD mientras la máquina virtual está en ejecución.

vbd-unplug

vbd-unplug uuid=uuid_of_vbd

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

Comandos de VDI

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

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

Los objetos 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 de VDI

Los VDI tienen los siguientes parámetros:

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

vdi-clone

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

Cree una nueva copia grabable del VDI especificado que se pueda utilizar directamente. Es una variante devdi-copy que puede exponer instalaciones de clonación de imágenes de alta velocidad donde existen.

Utilice el parámetro de driver-params mapa 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

vdi-copy uuid=uuid_of_the_vdi sr-uuid=uuid_of_the_destination_sr

Copie un VDI en un SR especificado.

vdi-create

vdi-create sr-uuid=uuid_of_sr_to_create_vdi_on name-label=name_for_the_vdi type=system|user|suspend|crashdump virtual-size=size_of_virtual_disk sm-config-*=storage_specific_configuration_data

Cree un VDI.

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

Nota:

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

Algunos tipos SR pueden redondear elvirtual-size valor para que sea divisible por un tamaño de bloque configurado.

vdi-data-destroy

vdi-data-destroy uuid=uuid_of_vdi

Destruye los datos asociados con el VDI especificado, pero conserva los metadatos de seguimiento de bloques modificados.

Nota:

Si utiliza el seguimiento de bloques modificado para realizar copias de seguridad incrementales del VDI, asegúrese de utilizar elvdi-data-destroy comando para eliminar 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

vdi-destroy uuid=uuid_of_vdi

Destruye el VDI especificado.

Nota:

Si utiliza el seguimiento de bloques modificado para realizar copias de seguridad incrementales del VDI, asegúrese de utilizar elvdi-data-destroy comando para eliminar 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 locales de VHD y NFS SR, el espacio en disco no se libera inmediatamentevdi-destroy, sino periódicamente durante una operación de análisis del repositorio de almacenamiento. Si debe forzar que el espacio en disco eliminado esté disponible, llame a [sr-scan] (#sr -scan) manualmente.

vdi-disable-cbt

vdi-disable-cbt uuid=uuid_of_vdi

Deshabilite el seguimiento de bloques cambiado para el VDI.

vdi-enable-cbt

vdi-enable-cbt uuid=uuid_of_vdi

Habilite el seguimiento de bloques modificado para el VDI.

Nota:

Sólo puede habilitar el seguimiento de bloques modificado en instancias con licencia de Citrix Hypervisor Premium Edition.

vdi-export

vdi-export uuid=uuid_of_vdi filename=filename_to_export_to [format=format] [base=uuid_of_base_vdi] [--progress]

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

  • raw
  • vhd

El formato VHD puede ser escaso. Si hay bloques sin asignar dentro del VDI, estos bloques pueden omitirse en el archivo VHD, por lo que el archivo VHD es más pequeño. Puede exportar a formato VHD desde todos los tipos de almacenamiento basados en VHD compatibles (EXT, NFS).

Si especifica elbase parámetro, este comando exporta sólo los bloques que han cambiado entre el VDI exportado y el VDI base.

vdi-forget

vdi-forget uuid=uuid_of_vdi

Elimina incondicionalmente un registro VDI de la base de datos sin tocar el back-end de almacenamiento. En funcionamiento normal, debería usar [vdi-destroy] (#vdi -destroy) en su lugar.

vdi-import

vdi-import uuid=uuid_of_vdi filename=filename_to_import_from [format=format] [--progress]

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

  • raw
  • vhd

vdi-introduce

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

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

vdi-list-changed-blocks

vdi-list-changed-blocks vdi-from-uuid=first-vdi-uuid vdi-to-uuid=second-vdi-uuid

Compare dos VDI y devuelva la lista de bloques que han cambiado entre los dos como una cadena codificada en base64. Este comando sólo funciona para los VDI que han cambiado el seguimiento de bloques habilitado.

Para obtener más información, consulte Se ha cambiado el seguimiento de bloques.

vdi-pool-migrate

vdi-pool-migrate uuid=VDI_uuid sr-uuid=destination-sr-uuid

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

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

vdi-resize

vdi-resize uuid=vdi_uuid disk-size=new_size_for_disk

Cambie el tamaño del VDI especificado por UUID.

vdi-snapshot

vdi-snapshot uuid=uuid_of_the_vdi [driver-params=params]

Produce una versión de lectura y escritura de un VDI que se puede utilizar como referencia para copias de seguridad o creación de plantillas, o ambos. Utilice la instantánea para realizar una copia de seguridad en lugar de instalar y ejecutar software de copia de seguridad dentro de la máquina virtual. La máquina virtual continúa ejecutándose mientras el software de copia de seguridad externa transmite el contenido de la instantánea al medio de copia de seguridad. Del mismo modo, una instantánea se puede utilizar como una «imagen dorada» en la que basar una plantilla. Se puede crear una plantilla utilizando cualquier VDI.

Utilice el parámetro de driver-params mapa 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 debe producir un VDI grabable.

vdi-unlock

vdi-unlock uuid=uuid_of_vdi_to_unlock [force=true]

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

vdi-update

vdi-update uuid=uuid

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

Comandos VIF

Comandos para trabajar con VIFs (interfaces de red virtual).

Los objetos 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 de VIF

Los VIF tienen los siguientes parámetros:

  • uuid ( sólo lectura) la referencia de identificador/objeto única para el VIF
  • vm-uuid ( sólo lectura) la referencia de identificador/objeto única para la VM en la que reside este VIF
  • vm-name-label ( sólo lectura) el nombre de la máquina virtual en la que reside este VIF
  • allowed-operations ( parámetro establecido de sólo lectura) una lista de las operaciones permitidas en este estado
  • current-operations ( parámetro establecido de sólo lectura) una lista de las operaciones que están actualmente en curso en este VIF
  • device ( sólo lectura) etiqueta entera de este VIF, que indica el orden en el que se crearon los back-ends VIF
  • MAC ( sólo lectura) Dirección MAC de VIF, tal como se expone a la VM
  • MTU ( sólo lectura) Unidad máxima de transmisión del VIF en bytes.

    Este parámetro es de sólo lectura, pero puede anular la configuración de MTU con lamtu clave mediante el parámetro deother-config mapa. Por ejemplo, para restablecer la MTU en una NIC virtual para utilizar tramas jumbo:

     xe vif-param-set \
         uuid=<vif_uuid> \
         other-config:mtu=9000
    
  • currently-attached ( sólo lectura) true si el dispositivo está conectado
  • Algoritmo QoSqos_algorithm_type (lectura/escritura) para usar
  • qos_algorithm_params ( parámetro de mapa de lectura/escritura) para el algoritmo QoS elegido
  • qos_supported_algorithms ( parámetro de conjunto de sólo lectura) soporta algoritmos QoS para este VIF
  • MAC-autogenerated ( sólo lectura) True si la dirección MAC del VIF se generó automáticamente
  • other-config ( parámetro de mapa de lectura/escritura)key:value pares de configuración adicionales
  • other-config:ethtoolrx ( lectura/escritura) establecido en activado para habilitar la suma de comprobación de recepción, desactivado para deshabilitar
  • other-config:ethtooltx ( lectura/escritura) se establece en activado para habilitar la suma de comprobación de transmisión, desactivado para deshabilitar
  • other-config:ethtoolsg ( lectura/escritura) se establece en activado para habilitar la recopilación de dispersión, desactivado para deshabilitar
  • other-config:ethtooltso ( lectura/escritura) establecido en activado para habilitar la descarga de segmentación tcp, desactivado para deshabilitar
  • other-config:ethtoolufo ( lectura/escritura) establecido en activado para habilitar la descarga de fragmentos udp, desactivado para deshabilitar
  • other-config:ethtoolgso ( lectura/escritura) establecido en activado para habilitar la descarga de segmentación genérica, desactivado para deshabilitar
  • other-config:promiscuous ( lectura/escritura) true a un VIF para ser promiscuo en el puente, de modo que vea todo el tráfico sobre el puente. Útil para ejecutar un sistema de detección de intrusiones (IDS) o similar en una máquina virtual.
  • network-uuid ( sólo lectura) la referencia única de identificador/objeto de la red virtual a la que está conectado este VIF
  • network-name-label ( sólo lectura) el nombre descriptivo de la red virtual a la que está conectado este VIF
  • io_read_kbs ( sólo lectura) velocidad media de lectura en KB/s para este VIF
  • io_write_kbs ( sólo lectura) tasa media de escritura en KB/s para este VIF
  • locking_mode ( lectura/escritura) Afecta a la capacidad de los VIF para filtrar tráfico a/desde una lista de direcciones MAC e IP. Requiere parámetros adicionales.
  • locking_mode:default ( lectura/escritura) Varía según el modo de bloqueo predeterminado para la red VIF.

    Si el modo de bloqueo predeterminado está establecido endisabled, 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 enunlocked, 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) Sólo se permite el tráfico enviado a o enviado desde las direcciones MAC e IP especificadas en el VIF. Si no se especifica ninguna dirección IP, no se permite 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 que se aplica para que el VIF borre todo el tráfico.

vif-create

vif-create vm-uuid=uuid_of_the_vm device=see below network-uuid=uuid_of_network_to_connect_to [mac=mac_address]

Cree un VIF en una VM.

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

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

vif-destroy

vif-destroy uuid=uuid_of_vif

Destruye un VIF.

vif-move

vif-move uuid=uuid network-uuid=network_uuid

Mueva el VIF a otra red.

vif-plug

vif-plug uuid=uuid_of_vif

Intente adjuntar el VIF mientras la máquina virtual está en ejecución.

vif-unplug

vif-unplug uuid=uuid_of_vif

Intenta separar el VIF de la VM mientras se está ejecutando.

vif-configure-ipv4

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

vif-configure-ipv4 uuid=uuid_of_vif mode=static address=CIDR_address gateway=gateway_address

Por ejemplo:

VIF.configure_ipv4(vifObject,"static", " 192.168.1.10/24", " 192.168.1.1")

Limpie la configuración IPv4 como se muestra a continuación:

vif-configure-ipv4 uuid=uuid_of_vif mode=none

vif-configure-ipv6

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

vif-configure-ipv6 uuid=uuid_of_vif mode=static address=IP_address gateway=gateway_address

Por ejemplo:

VIF.configure_ipv6(vifObject,"static", "fd06:7768:b9e5:8b00::5001/64", "fd06:7768:b9e5:8b00::1")

Limpie la configuración de IPv6 como se indica a continuación:

vif-configure-ipv6 uuid=uuid_of_vif mode=none

Comandos de VLAN

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

vlan-create

vlan-create pif-uuid=uuid_of_pif vlan=vlan_number network-uuid=uuid_of_network

Cree una VLAN en su servidor Citrix Hypervisor.

pool-vlan-create

pool-vlan-create pif-uuid=uuid_of_pif vlan=vlan_number network-uuid=uuid_of_network

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 uno de cada host en consecuencia.

vlan-destroy

vlan-destroy uuid=uuid_of_pif_mapped_to_vlan

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 simple es proporcionar el argumentovm=name_or_uuid. Una forma fácil de obtener el uuid de una VM real es, por ejemplo, ejecutarxe vm-list power-state=running. ( Obtenga la lista completa de campos que se pueden hacer coincidir mediante el comando)xe vm-list params=all. Por ejemplo, al especificar máquinas virtualespower-state=haltedseleccionadas cuyopower-stateparámetro es igual a -haltedSí. Si hay varias máquinas virtuales coincidentes, especifique la opción--multiple para realizar la operación. La lista completa de parámetros que se pueden comparar se describe al principio de esta sección.

Los objetos de VM se pueden enumerar con el comando estándar de lista de objetos (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 de VM

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

Nota:

Todos los valores de parámetros de VM grabables se pueden cambiar mientras se ejecuta la VM, 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 ( sólo lectura) la referencia única de identificador/objeto para la VM
  • name-label ( lectura/escritura) el nombre de la máquina virtual
  • name-description ( lectura/escritura) la cadena de descripción de la máquina virtual
  • order start order ( lectura/escritura) para el inicio/apagado de vApp y para el inicio después de la conmutación por error de HA
  • version ( sólo lectura) el número de veces que se ha recuperado esta máquina virtual. Si desea sobrescribir una nueva VM con una versión anterior, llame avm-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 máquinas virtuales de plantilla nunca se pueden iniciar, solo se utilizan para clonar otras máquinas virtuales Una vez establecido este valor en true, no se puede restablecer a false. Las máquinas virtuales de plantilla no se pueden convertir en máquinas virtuales mediante este parámetro.
  • is-control-domain ( sólo lectura) True si se trata de un dominio de control (dominio 0 o dominio de controlador)
  • power-state ( sólo lectura) estado de energía actual
  • start-delay ( lectura/escritura) el retraso a esperar antes de que una llamada para iniciar la VM retorna
  • shutdown-delay ( lectura/escritura) el retraso a esperar antes de que una llamada para apagar la VM retorna
  • memory-dynamic-max ( lectura/escritura) máximo dinámico en bytes
  • memory-dynamic-min ( lectura/escritura) dinámico mínimo en bytes
  • memory-static-max ( lectura/escritura) establecido estáticamente (absoluto) máximo en bytes. Si desea cambiar este valor, la máquina virtual debe cerrarse.
  • memory-static-min ( lectura/escritura) establecido estáticamente (absoluto) como mínimo en bytes. Si desea cambiar este valor, la máquina virtual debe cerrarse.
  • suspend-VDI-uuid ( sólo lectura) el VDI en el que se almacena una imagen de suspensión
  • 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
    

    A continuación, la máquina virtual seleccionada se ejecuta únicamente en las CPU físicas 1, 2 y 3.También puede ajustar la prioridad de 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
    

    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 Citrix Hypervisor. Los pesos legales oscilan entre 1 y 65535 y el valor predeterminado es 256. El límite corrige opcionalmente la cantidad máxima de CPU que una máquina virtual podrá consumir, incluso si el servidor 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 es 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 inicio de CPU virtuales
  • actions-after-crash ( lectura/escritura) que se debe realizar si la máquina virtual se bloquea. Para los invitados fotovoltaicos, los parámetros válidos son:
    • preserve ( sólo 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 reiniciar VM)
    • destroy ( sin volcado de núcleo y deje la VM detenida)
  • console-uuids ( parámetro establecido de sólo lectura) dispositivos de consola virtual
  • platform ( parámetro de mapa de lectura/escritura) configuración específica de la plataforma

    Para deshabilitar Virtual Desktop Agent (VDA) para cambiar Windows 10 al modo Tablet:

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

    Para permitir que VDA cambie Windows 10 al modo Tablet:

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

    Para comprobar el estado actual:

     xe vm-param-get uuid=<vm_uuid> param-name=platform param-key=acpi_laptop_slate
    
  • allowed-operations ( parámetro de conjunto de sólo lectura) lista de las operaciones permitidas en este estado
  • current-operations ( parámetro establecido de sólo lectura) una lista de las operaciones que están actualmente en curso en la VM
  • allowed-VBD-devices ( parámetro conjunto de sólo lectura) de identificadores VBD disponibles para su uso, representados por enteros del rango 0—15. Esta lista es sólo informativa y se pueden usar otros dispositivos (pero es posible que no funcionen).
  • allowed-VIF-devices ( parámetro conjunto de sólo lectura) de identificadores VIF disponibles para su uso, representados por enteros del rango 0—15. Esta lista es sólo 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 del BIOS o una cadena vacía.
  • HVM-boot-params ( parámetro de mapa de lectura/escritura), la clave de orden controla el orden de inicio invitado HVM, representado como una cadena donde cada carácter es un método de arranque: d para el CD/DVD, c para el disco raíz y n para el arranque PXE de red. El valor predeterminado es dc.
  • HVM-shadow-multiplier ( lectura/escritura) Valor de punto flotante que controla la cantidad de sobrecarga de memoria de sombra para otorgar a la VM. El valor predeterminado es 1.0 (el valor mínimo) y sólo los usuarios avanzados deben cambiar este valor.
  • PV-kernel ( lectura/escritura) al núcleo
  • PV-ramdisk ( lectura/escritura) al initrd
  • PV-args ( lectura/escritura) de argumentos de línea de comandos del núcleo
  • PV-legacy-args ( lectura/escritura) de argumentos para que las máquinas virtuales heredadas 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 ( sólo lectura) describe los indicadores de CPU en los que se inició por última vez la VM
  • resident-on ( sólo lectura) el servidor Citrix Hypervisor en el que reside una VM
  • affinity ( lectura/escritura) El servidor 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) Lista de pares clave/valor que especifican parámetros de configuración adicionales para la VM. Por ejemplo, una VM se inicia automáticamente después del arranque del host cuando elother-config parámetro incluye el parauto_poweron: true clave/valor
  • start-time ( sólo 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 ( sólo 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 ( sólo lectura) la memoria real utilizada por una VM
  • VCPUs-number ( sólo lectura) el número de CPU virtuales asignadas a la máquina virtual para una máquina virtual de Linux PV (paravirtual) o HVM (máquina virtual de hardware). Este número puede diferir deVCPUS-max y puede cambiarse sin reiniciar la máquina virtual mediante elvm-vcpu-hotplug comando. Para obtener más información, consulte [vm-vcpu-hotplug] (#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 bruscamente cuandoVCPUs-number se establece en un valor mayor que el número de CPU físicas en el servidor Citrix Hypervisor.
  • VCPUs-Utilization ( parámetro de mapa de sólo lectura) una lista de CPU virtuales y su peso
  • os-version ( parámetro de mapa de sólo lectura) la versión del sistema operativo para la máquina virtual
  • PV-drivers-version ( parámetro de mapa de sólo lectura) las versiones de los controladores paravirtualizados para la VM
  • PV-drivers-detected ( sólo lectura) para la última versión de los controladores paravirtualizados para la VM
  • métricas de memoriamemory (parámetro de mapa de sólo lectura) notificadas por el agente en la máquina virtual
  • métricas de discodisks (parámetro de mapa de sólo lectura) notificadas por el agente en la máquina virtual
  • métricas de rednetworks (parámetro de mapa de sólo lectura) notificadas por el agente en la máquina virtual
  • other ( parámetro de mapa de sólo lectura) otras métricas notificadas por el agente en la máquina virtual
  • guest-metrics-lastupdated ( sólo lectura) marca de tiempo cuando el agente invitado realizó la última escritura en estos campos. La marca de tiempo tiene el formatoyyyymmddThh: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
  • hostspossible-hosts potenciales de esta máquina virtual de sólo lectura
  • dom-id ( sólo lectura) ID de dominio (si está disponible, -1 en caso contrario)
  • recommendations ( sólo lectura) Especificación XML de valores y rangos recomendados para las propiedades de esta máquina virtual
  • xenstore-data ( parámetro de mapa de lectura/escritura) que se insertarán en el árbol de xenstore (/local/domain/domid /vm-data) después de crear la VM
  • is-a-snapshot ( sólo lectura) True si esta máquina virtual es una instantánea
  • snapshot_of ( sólo lectura) el UUID de la VM de la que esta instantánea es de
  • snapshots ( sólo lectura) los UUID de todas las instantáneas de esta VM
  • snapshot_time ( de sólo lectura) la marca de tiempo de la operación de instantánea que creó esta instantánea de VM
  • memory-target ( sólo lectura) la cantidad de memoria objetivo establecida para esta VM
  • blocked-operations ( parámetro de mapa de lectura/escritura) enumera las operaciones que no se pueden realizar en esta máquina virtual
  • last-boot-record ( sólo 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 siempre se reinicia en otro host si hay un error en el host en el que reside. Este parámetro está ahora en desuso. Utilice el parámetro ha-restart-priority en su lugar.
  • ha-restart-priority ( lectura/escritura) reinicio o mejor esfuerzo
  • blobs ( sólo lectura) almacén de datos binarios
  • live ( sólo lectura) True si la máquina virtual se está ejecutando. False si HA sospecha que la máquina virtual no se está ejecutando.

vm-assert-can-be-recovered

vm-assert-can-be-recovered uuid [database] vdi-uuid

Comprueba si el almacenamiento está disponible para recuperar esta VM.

vm-call-plugin

vm-call-plugin vm-uuid=vm_uuid plugin=plugin fn=function [args:key=value]

Llama a la función dentro del complemento en la vm dada con argumentos opcionales (args:key=value). Para pasar una cadena de «valor» con caracteres especiales en ella (por ejemplo, nueva línea), se puede usar una sintaxis alternativa args:key:file=local_file, donde el contenido de local_file será recuperado y asignado a «key» como un todo.

vm-cd-add

vm-cd-add cd-name=name_of_new_cd device=integer_value_of_an_available_vbd [vm-selector=vm_selector_value...]

Agregue un nuevo CD virtual a la VM seleccionada. Eldevice parámetro debe seleccionarse del valor delallowed-VBD-devices parámetro de la VM.

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

vm-cd-eject [vm-selector=vm_selector_value...]

Extraiga un CD de la unidad de CD virtual. Este comando sólo funciona si se adjunta exactamente un CD a la máquina virtual. Cuando haya dos o más CDs, utilice el comandoxe 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

vm-cd-insert cd-name=name_of_cd [vm-selector=vm_selector_value...]

Inserte un CD en la unidad de CD virtual. Este comando sólo funciona si hay exactamente un dispositivo de CD vacío conectado a la máquina virtual. Cuando haya dos o más dispositivos CD vacíos, utilice elxe vbd-insert comando y especifique los UUID del VBD y del VDI que desea 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

vm-cd-list [vbd-params] [vdi-params] [vm-selector=vm_selector_value...]

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 desea enumerar.

vm-cd-remove

vm-cd-remove cd-name=name_of_cd [vm-selector=vm_selector_value...]

Quite 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

vm-checkpoint new-name-label=name_label [new-name-description=description]

Controle una VM existente, utilizando la operación rápida de instantáneas de disco a nivel de almacenamiento cuando esté disponible.

vm-clone

vm-clone new-name-label=name_for_clone [new-name-description=description_for_clone] [vm-selector=vm_selector_value...]

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

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

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

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

Por ejemplo:

xe vm-compute-maximum-memory vm=testvm total=`xe host-list params=memory-free --minimal`

Este comando utiliza el valor delmemory-free parámetro devuelto por elxe host-list comando para establecer la memoria máxima de la máquina virtual denominadatestvm .

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

vm-compute-memory-overhead

Calcula la sobrecarga de memoria de virtualización de una VM.

vm-copy

vm-copy new-name-label=name_for_copy [new-name-description=description_for_copy] [sr-uuid=uuid_of_sr] [vm-selector=vm_selector_value...]

Copie una VM existente, pero sin utilizar la operación de clonación de disco rápida 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 son imágenes completas, es decir, no forman parte de una cadena de copia en escritura (CoW).

Especifique el nombre y la descripción opcional de la VM copiada resultante utilizando losnew-name-label argumentosnew-name-description y.

Especifique el SR de destino para la VM copiada resultante mediantesr-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

vm-copy-bios-strings host-uuid=host_uuid

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

vm-crashdump-list

vm-crashdump-list [vm-selector=vm selector value...]

Enumera los vertederos asociados a las máquinas virtuales especificadas.

Cuando se utiliza el argumento opcionalparams, el valor de params es una cadena que contiene una lista de parámetros de este objeto que desea mostrar. Alternativamente, puede usar la palabra clave all para mostrar todos los parámetros. Si noparams se utiliza, 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

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

Enumere los orígenes de datos que se pueden grabar para una VM.

Select las máquinas virtuales en las que desea 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 realiza en todas las máquinas virtuales.

Las fuentes de datos tienen dos parámetros,standard yenabled , que se pueden ver en la salida de este comando. Si un origen de datos se ha enabled establecido en true, las métricas se están registrando actualmente en la base de datos de rendimiento. Si un origen de datos se hastandard establecido entrue , las métricas se registran en la base de datos de rendimiento de forma predeterminada (y tambiénenabled se establece entrue para este fuente de datos). Si un origen de datos se hastandard establecido enfalse , las métricas *no* se registran en la base de datos de rendimiento de forma predeterminada (y tambiénenabled se establece en falsepara esta fuente de datos).

Para comenzar a grabar métricas de origen de datos en la base de datos de rendimiento, ejecute el comando vm-data-source-record. Este comando se establece enabled en true. Para detener, ejecutar el vm-data-source-forget. Este comando se establece enabled en false.

vm-data-source-record

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

Registre el origen de datos especificado para una VM.

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

Select las máquinas virtuales en las que desea 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 realiza en todas las máquinas virtuales.

vm-data-source-forget

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

Detenga la grabación del origen de datos especificado para una VM y olvide todos los datos grabados.

Select las máquinas virtuales en las que desea 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 realiza en todas las máquinas virtuales.

vm-data-source-query

vm-data-source-query data-source=name_description_of_data-source [vm-selector=vm_selector_value...]

Muestra el origen de datos especificado para una máquina virtual.

Select las máquinas virtuales en las que desea 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 realiza en todas las máquinas virtuales.

vm-destroy

vm-destroy uuid=uuid_of_vm

Destruye la máquina virtual especificada. Esto deja intacto el almacenamiento asociado con la VM. Para eliminar el almacenamiento también, usexe vm-uninstall.

vm-disk-add

vm-disk-add disk-size=size_of_disk_to_add device=uuid_of_device [vm-selector=vm_selector_value...]

Agregue un disco a las máquinas virtuales especificadas. Select eldevice parámetro del valor delallowed-VBD-devices parámetro de las máquinas virtuales.

El parámetro disk-size se puede especificar en bytes o utilizando 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

vm-disk-list [vbd-params] [vdi-params] [vm-selector=vm_selector_value...]

Muestra los discos conectados a las máquinas virtuales especificadas. Losvbd-params parámetrosvdi-params y controlan los campos de los objetos respectivos a la salida. Indique los parámetros como una lista separada por comas, o la clave especialall 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

vm-disk-remove device=integer_label_of_disk [vm-selector=vm_selector_value...]

Quitar un disco de las máquinas virtuales especificadas y destruirlo.

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

vm-export filename=export_filename [metadata=true|false] [vm-selector=vm_selector_value...]

Exporte las máquinas virtuales especificadas (incluidas las imágenes de disco) a un archivo del equipo local. Especifique el nombre de archivo al que exportar la máquina virtual utilizando elfilename parámetro. Por convención, el nombre de archivo debe tener una.xva extensión.

Si elmetadata parámetro estrue , los discos no se exportan. Sólo los metadatos de VM se escriben en el archivo de salida. Utilice este parámetro cuando el almacenamiento subyacente se transfiera a través de otros mecanismos y permita volver a crear la información de la máquina virtual. 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

vm-import filename=export_filename [metadata=true|false] [preserve=true|false][sr-uuid=destination_sr_uuid]

Importe una máquina virtual desde un archivo exportado anteriormente. Sipreserve se establece entrue , se conserva la dirección MAC de la máquina virtual original. Elsr-uuid determina el SR de destino en el que se va a importar la máquina virtual. Si no se especifica este parámetro, se utiliza el SR predeterminado.

Elfilename parámetro también puede apuntar a una máquina virtual con formato XVA, que es el formato de exportación heredado de Citrix Hypervisor 3.2. Algunos proveedores externos utilizan este formato para proporcionar dispositivos virtuales. El formato XVA utiliza un directorio para almacenar los datos de la máquina virtual, por lo que se establecefilename en el directorio raíz de la exportación XVA y no en un archivo real. Las exportaciones posteriores del invitado heredado importado se actualizan automáticamente al nuevo formato basado en el archivo, que almacena muchos más datos sobre la configuración de la máquina virtual.

Nota:

El formato XVA basado en directorios anterior no conserva completamente todos los atributos de VM. En particular, las máquinas virtuales importadas no tienen interfaces de red virtuales conectadas de forma predeterminada. Si es necesario establecer redes, cree una usandovif-create yvif-plug .

Si elmetadata estrue , 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 yVDI.location) a menos que se especifique la--forceopción, 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 máquinas virtuales entre grupos disjuntos. Por ejemplo, como parte de un plan de recuperación ante desastres.

Nota:

Varias importaciones de VM se realizan más rápido en serie que en paralelo.

vm-install

vm-install new-name-label=name [template-uuid=uuid_of_desired_template] [template=template_uuid_or_name] [sr-uuid=sr_uuid | sr-name-label=name_of_sr][copy-bios-strings-from=host_uuid]

Instalar o clonar una máquina virtual desde una plantilla. Especifique el nombre de la plantilla mediante eltemplate-uuid argumentotemplate o. Especifique un SR utilizando elsr-uuid argumentosr-name-label o. Especifique para instalar medios bloqueados por BIOS utilizando elcopy-bios-strings-from argumento.

Nota:

Al instalar desde una plantilla que tiene discos existentes, de forma predeterminada, se crean nuevos discos en el mismo SR que estos discos existentes. Donde el SR lo admite, estos discos son copias rápidas. Si se especifica un SR diferente en la línea de comandos, los nuevos discos se crean allí. En este caso, no es posible una copia rápida y los discos son copias completas.

Cuando se instala desde una plantilla que no tiene discos existentes, se crean discos nuevos en el SR especificado o en el SR predeterminado del grupo cuando no se especifica un SR.

vm-is-bios-customized

vm-is-bios-customized

Indica si las cadenas de BIOS de la VM se han personalizado.

vm-memory-balloon

vm-memory-balloon target=target

Establezca el destino de memoria para una VM en ejecución. El valor dado debe estar dentro del rango definido por los valores memory_dynamic_min y memory_dynamic_max de la máquina virtual.

vm-memory-dynamic-range-set

vm-memory-dynamic-range-set min=min max=max

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 máquina virtual. Es posible cambiar estos campos cuando una máquina virtual se está ejecutando o se detiene. El rango dinámico debe encajar dentro del rango estático.

vm-memory-limits-set

vm-memory-limits-set static-min=static_min static-max=static_max dynamic-min=dynamic_min dynamic-max=dynamic_max

Configure los límites de memoria de una VM.

vm-memory-set

vm-memory-set memory=memory

Configure la asignación de memoria de una VM.

vm-memory-shadow-multiplier-set

vm-memory-shadow-multiplier-set [vm-selector=vm_selector_value...] [multiplier=float_memory_multiplier]

Establezca el multiplicador de la memoria de sombra para la máquina virtual especificada.

Esta es una opción avanzada que modifica la cantidad de memoria instantánea asignada a una máquina virtual asistida por hardware.

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

Esta memoria se considera una sobrecarga. Está separado de los cálculos de memoria normales para la memoria de contabilidad a una máquina virtual. Cuando se invoca este comando, la cantidad de memoria de host libre disminuye según el multiplicador y elHVM_shadow_multiplier campo se actualiza con el valor que Xen ha asignado a la VM. Si no hay suficiente memoria libre del servidor Citrix Hypervisor, se devuelve un error.

Las máquinas virtuales en las que se debe 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

vm-memory-static-range-set min=min max=max

Configure el rango de memoria estática de una VM. El rango de memoria estática define límites inferiores y superiores 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

vm-memory-target-set target=target

Establezca el destino de memoria para una máquina virtual 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-memory-target-wait

vm-memory-target-wait

Espere a que una máquina virtual en ejecución alcance su objetivo de memoria actual.

vm-migrate

vm-migrate [copy=true|false] [host-uuid=destination_host_uuid] [host=name_or_ uuid_of_destination_host] [force=true|false] [live=true|false] [vm-selector=vm_selector_value...] [remote-master=destination_pool_master_uuid] [remote-username=destination_pool_username] [remote-password=destination_pool_password] [remote-network=destination_pool_network_uuid ][vif:=vif_uuid] [vdi=vdi_uuid]

Este comando migra las VM especificadas entre hosts físicos. Elhost parámetro puede ser el nombre o el UUID del servidor Citrix Hypervisor. Por ejemplo, para migrar la VM a otro host del grupo, donde los discos de VM están en almacenamiento compartido por ambos hosts:

xe vm-migrate uuid=vm_uuid host-uuid=host_uuid

Para mover máquinas virtuales entre hosts del mismo grupo, que no comparten almacenamiento (migración en vivo de almacenamiento):

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

Puede elegir el SR donde se almacena cada VDI:

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

Además, puede elegir la red que adjuntar la VM después de la migración:

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

Para la migración entre pool:

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

Para obtener más información acerca de la migración en vivo del almacenamiento, la migración en vivo y la migración de VDI en vivo, consulteMigrar máquinas virtuales.

De forma predeterminada, la máquina virtual se suspende, migra y se reanuda en el otro host. Ellive parámetro selecciona la migración en vivo. La migración en vivo mantiene la máquina virtual en ejecución mientras realiza la migración, lo que minimiza el tiempo de inactividad de la máquina virtual a menos de un segundo. En algunas circunstancias, como cargas de trabajo extremadamente pesadas de memoria en la VM, la migración en vivo vuelve al modo predeterminado y suspende la VM por un corto tiempo antes de completar la transferencia de memoria.

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

vm-pause

vm-pause

Pausar una máquina virtual en ejecución. Tenga en cuenta que esta operación no libera la memoria asociada (consultevm-suspend).

vm-query-services

vm-query-services

Consulte los servicios del sistema ofrecidos por las máquinas virtuales dadas.

vm-reboot

vm-reboot [vm-selector=vm_selector_value...] [force=true]

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

Use elforce argumento para provocar un reinicio implacable. Donde el apagado es similar a tirar del enchufe en un servidor físico.

vm-recover

vm-recover vm-uuid [database] [vdi-uuid] [force]

Recupera una máquina virtual de la base de datos contenida en el VDI suministrado.

vm-reset-powerstate

vm-reset-powerstate [vm-selector=vm_selector_value...] {force=true}

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 sólo se utiliza cuando un host miembro de un grupo se desactiva. Puede utilizar este comando para forzar al maestro de grupo a restablecer el estado de alimentación de las máquinas virtualeshalted. Esencialmente, este comando fuerza el bloqueo en la máquina virtual y sus discos para que pueda iniciarse a continuación en otro host de grupo. Esta llamada requiere que se especifique el indicador de fuerza, y falla si no está en la línea de comandos.

vm-resume

vm-resume [vm-selector=vm_selector_value...] [force=true|false] [on=host_uuid]

Reanudar 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 elon argumento para especificar en qué miembro del grupo se va a iniciar. De forma predeterminada, el sistema determina un host apropiado, que podría ser cualquiera de los miembros del grupo.

vm-retrieve-wlb-recommendations

vm-retrieve-wlb-recommendations

Recupere las recomendaciones de equilibrio de carga de trabajo para la VM seleccionada.

vm-shutdown

vm-shutdown [vm-selector=vm_selector_value...] [force=true|false]

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 elforce argumento para provocar un apagado incorrecto, similar a tirar del enchufe en un servidor físico.

vm-snapshot

vm-snapshot new-name-label=name_label [new-name-description+name_description]

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

vm-snapshot-with-quiesce

vm-snapshot-with-quiesce new-name-label=name_label [new-name-description+name_description]

Instantánea de una máquina virtual existente con reposo, utilizando la operación de instantánea de disco rápida a nivel de almacenamiento cuando esté disponible.

vm-start

vm-start [vm-selector=vm_selector_value...] [force=true|false] [on=host_uuid] [--multiple]

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 elon argumento 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 podría ser cualquiera de los miembros del grupo.

vm-suspend

vm-suspend [vm-selector=vm_selector_value...]

Suspender 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

vm-uninstall [vm-selector=vm_selector_value...] [force=true|false]

Desinstale una máquina virtual, destruyendo sus discos (los VDI marcados como RW y conectados a esta máquina virtual solamente), así como su registro de metadatos. Para destruir solo los metadatos de VM, usexe 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

vm-unpause

Anule la pausa de una máquina virtual en pausa.

vm-vcpu-hotplug

vm-vcpu-hotplug new-vcpus=new_vcpu_count [vm-selector=vm_selector_value...]

Ajuste dinámicamente el número de vCPU disponibles para una máquina virtual PV o HVM Linux en ejecución. El número de vCPU está limitado por el parámetroVCPUs-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.

Las VM o VM de Linux PV o HVM 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 virtualroot para asegurarse de que se utilizan las vCPU 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

vm-vif-list [vm-selector=vm_selector_value...]

Muestra los 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 operan 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 instantáneas shceduled de VM y sus atributos.

Los objetos vmss se pueden enumerar con el comando estándar de lista de objetos (xe vmss-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

vmss-create

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

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

Las programaciones de instantáneas tienen los siguientes parámetros:

Nombre de 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 Instantánea de disco; Instantánea de memoria; Instantánea en reposo Lectura/Escritura
frequency Hora; Diario; Semanal Lectura/Escritura
retained-snapshots Instantáneas que se conservarán. Rango: 1-10. Lectura/Escritura
schedule schedule:days ( Lunes a Domingo),schedule:hours (0 a 23),schedule:minutes (0, 15, 30, 45) Lectura/Escritura

vmss-destroy

vmss-destroy uuid=uuid

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

Passthrough USB

Activación/desactivación de transferencia USB

pusb-param-set uuid=pusb_uuid passthrough-enabled=true/false

Activar/desactivar la transferencia USB.

pusb-scan

pusb-scan host-uuid=host_uuid

Escanea PUSB y actualiza.

vusb-create

vusb-create usb-group-uuid=usb_group_uuid vm-uuid=vm_uuid

Crea un USB virtual en el grupo. Inicie la VM para pasar a través del USB a la VM.

vusb-unplug

vusb-unplug uuid=vusb_uuid

Desconecta el USB de la VM.

vusb-destroy

vusb-destroy uuid=vusb_uuid

Quita la lista USB virtual de la VM.