Interfaz de línea de comandos
El Xe CLI le permite crear scripts y automatizar tareas de administración del sistema. Utilice la CLI para integrar XenServer en una infraestructura de TI existente.
Introducción a la CLI de xe
La interfaz de línea de comandos xe se instala de forma predeterminada en todos los hosts de XenServer. Se incluye una versión remota de Windows con XenCenter. También está disponible una CLI remota independiente para Linux.
En el host de XenServer
La interfaz de línea de comandos xe se instala de forma predeterminada en el host. Puede ejecutar comandos xe CLI en la consola dom0. Acceda a la consola dom0 de una de las siguientes maneras:
- En XenCenter, vaya a la Consola para el host donde desea ejecutar el comando.
- SSH en el host donde desea ejecutar el comando.
En Windows
En Windows, el xe.exe
se instala junto con XenCenter.
Para usar el método xe.exe
, abra un símbolo del sistema de Windows y cambie los directorios al directorio donde se encuentra el xe.exe
se encuentra el archivo (normalmente C:\Archivos de programa (x86)\XenServidor\XenCentro
). Si añades el atributo xe.exe
ubicación de instalación en la ruta de su sistema, puede usar el comando sin tener que cambiar al directorio.
En Linux
En distribuciones basadas en RPM (como Red Hat), puede instalar el comando xe independiente desde el RPM denominado client_install/xapi-xe-BUILD.x86_64.rpm
en la ISO de instalación principal de XenServer.
Para instalar desde el RPM, utilice el siguiente comando:
rpm -ivh xapi-xe-BUILD.x86_64.rpm
<!--NeedCopy-->
Puede utilizar los parámetros de la línea de comandos para definir el host, el nombre de usuario y la contraseña de XenServer que se van a utilizar al ejecutar comandos xe. Sin embargo, también tiene la opción de establecer esta información como una variable de entorno. Por ejemplo:
export XE_EXTRA_ARGS="server=<host name>,username=<user name>,password=<password>"
<!--NeedCopy-->
Nota: No
La CLI xe remota en Linux puede bloquearse al intentar ejecutar comandos a través de una conexión segura y estos comandos implican la transferencia de archivos. Si es así, puede utilizar la función
--no-ssl
para ejecutar el comando a través de una conexión no segura con el host de XenServer.
Obtener ayuda con los comandos xe
La ayuda básica está disponible para los comandos de CLI en el host escribiendo:
xe help command
<!--NeedCopy-->
Se muestra una lista de los comandos xe más utilizados si escribe:
xe help
<!--NeedCopy-->
O bien, se muestra una lista de todos los comandos xe si escribe:
xe help --all
<!--NeedCopy-->
Sintaxis básica de xe
La sintaxis básica de todos los comandos de la CLI de XenServer xe es la siguiente:
xe command-name argument=value argument=value
<!--NeedCopy-->
Cada comando específico contiene su propio conjunto de argumentos que tienen la forma argumento=valor
. Algunos comandos tienen argumentos obligatorios 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 argumento=argument_value
.
El servidor
se utiliza para especificar el nombre de host o la dirección IP. El nombre de usuario
y contraseña
Los argumentos se utilizan para especificar credenciales.
Un archivo-contraseña
se puede especificar 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. (Se eliminan los CR y LF finales al final del archivo). Este método es más seguro que especificar la contraseña directamente en la línea de comandos.
El opcional puerto
se puede utilizar para especificar el puerto del agente en el host remoto de XenServer (el valor predeterminado es 443).
Ejemplo: En el host local de XenServer:
xe vm-list
<!--NeedCopy-->
Ejemplo: En un host remoto de XenServer:
xe vm-list username=username password=password server=hostname
<!--NeedCopy-->
La sintaxis abreviada también está disponible para los argumentos de conexión remota:
-
-u
Nombre de usuario -
-prisionero de guerra
contraseña -
-PWF
Archivo de contraseña -
-p
puerto -
-s
servidor
Ejemplo: En un host remoto de XenServer:
xe vm-list -u myuser -pw mypassword -s hostname
<!--NeedCopy-->
Los argumentos también se toman de la variable de entorno XE_EXTRA_ARGS, en forma de pares clave/valor separados por comas. Por ejemplo, para introducir comandos que se ejecutan en un host XenServer remoto, primero ejecute el siguiente comando:
export XE_EXTRA_ARGS="server=jeffbeck,port=443,username=root,password=pass"
<!--NeedCopy-->
Después de ejecutar este comando, ya no es necesario especificar los parámetros del host remoto de XenServer en cada comando xe que ejecute.
El uso de la variable de entorno XE_EXTRA_ARGS también habilita la finalización con tabulación de los comandos xe cuando se emiten en un host XenServer remoto, que está deshabilitado de forma predeterminada.
Caracteres especiales y sintaxis
Para especificar pares argumento/valor en el Xe
línea de comandos, escriba: argumento=valor
A menos que el valor incluya espacios, no utilice comillas. No incluya espacios en blanco entre el nombre del argumento, el signo igual (=) y el valor. Cualquier argumento que no se ajuste a este formato se ignora.
Para los valores que contienen espacios, escriba: argument="valor con espacios"
Cuando se utiliza la CLI en el host de XenServer, los comandos tienen una función de finalización de tabulación similar a la función del shell bash estándar de Linux. Por ejemplo, si escribe xe vm-l
y, a continuación, pulse el botón PESTAÑA , se muestra el resto del comando. Si más de un comando comienza con VM-L
apremiante PESTAÑA una segunda vez enumera las posibilidades. Esta función es útil cuando se especifican UUID de objetos en comandos.
Nota: No
Normalmente, la finalización con tabulación no funciona cuando se ejecutan comandos en un host XenServer remoto. Sin embargo, si establece la variable XE_EXTRA_ARGS en el equipo en el que introduce los comandos, se habilita la finalización de tabulación. Para obtener más información, consulte Sintaxis básica de xe.
Tipos de comandos
Los comandos de CLI se pueden dividir en dos mitades. Los comandos de bajo nivel se ocupan de la enumeración y la manipulación de parámetros de los objetos de la API. Los comandos de nivel superior se usan para interactuar con máquinas virtuales o hosts en un nivel más abstracto.
Los comandos de bajo nivel son:
-
clase-lista
-
clase-param-get
-
clase-param-set
-
clase-lista-param
-
clase-param-add
-
clase-param-eliminar
-
clase-param-clear
Dónde clase es uno de los siguientes:
-
bond
-
console
-
host
-
host-crashdump
-
host-cpu
-
network
-
patch
-
pbd
-
pif
-
pool
-
sm
-
sr
-
task
-
template
-
vbd
-
vdi
-
vif
-
vlan
-
vm
No todos los valores de clase tiene el conjunto completo de clase-Param-acción Comandos. Algunos valores de clase tienen un conjunto más pequeño de comandos.
Tipos de parámetros
Los objetos que se direccionan con los comandos xe tienen conjuntos de parámetros que los identifican y definen sus estados.
La mayoría de los parámetros toman un solo valor. Por ejemplo, el nombre-etiqueta
de una máquina virtual contiene un único valor de cadena. En la salida de los comandos de la lista de parámetros, como xe vm-param-list
, un valor entre paréntesis indica si los parámetros son de lectura-escritura (RW) o de solo lectura (RO). La salida de xe vm-param-list
en una máquina virtual especificada puede tener las siguientes líneas:
user-version ( RW): 1
is-control-domain ( RO): false
El primer parámetro, versión-usuario
, se puede escribir y tiene el valor 1. El segundo, dominio-de-control-es
, es de solo lectura y tiene un valor de false.
Los otros dos tipos de parámetros son de varios valores. Un poner contiene una lista de valores. Un mapa es un conjunto de pares clave-valor. A modo de ejemplo, observe el siguiente fragmento de salida de muestra de la función xe vm-param-list
en una máquina virtual especificada:
platform (MRW): acpi: true; apic: true; pae: true; nx: false
allowed-operations (SRO): pause; clean_shutdown; clean_reboot; \
hard_shutdown; hard_reboot; suspend
El plataforma
tiene una lista de elementos que representan pares clave-valor. Los nombres de las claves van seguidos 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 escribible. El operaciones-permitidas
tiene una lista que conforma 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 por un parámetro de mapa o establecer un parámetro de mapa, utilice dos puntos (:) para separar el nombre del parámetro de mapa y el par clave-valor. Por ejemplo, para establecer el valor de la propiedad Foo
clave de la otra-configuración
de una máquina virtual para balar
, el comando sería
xe vm-param-set uuid=VM uuid other-config:foo=baa
<!--NeedCopy-->
Comandos de parámetros de bajo nivel
Hay varios comandos para operar con los parámetros de los objetos: clase-param-get, clase-param-set, clase-param-add, clase-param-eliminar, clase-param-clear, y clase-lista-param. Cada uno de estos comandos requiere un uuid
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 la máquina virtual.
-
xe class-param-list uuid=uuid
Enumera todos los parámetros y sus valores asociados. A diferencia de la clase-list, este comando enumera los valores de los campos “caros”.
-
xe class-param-get uuid=uuid param-name=parameter param-key=key
Devuelve el valor de un parámetro determinado. En el caso de un parámetro de mapa, al especificar la clave de parámetro, se obtiene el valor asociado a esa clave en el mapa. Si no se especifica param-key o si el parámetro es un conjunto, el comando devuelve una representación de cadena del conjunto o mapa.
-
xe class-param-set uuid=uuid param=value
Establece el valor de uno o varios parámetros.
-
xe class-param-add uuid=uuid param-name=parameter key=value param-key=key
Se agrega a un mapa o a un parámetro establecido. Para un parámetro de mapa, agregue pares clave-valor mediante la sintaxis clave=valor. Si el parámetro es un conjunto, agregue claves con la sintaxis param-key=key.
-
xe class-param-remove uuid=uuid param-name=parameter param-key=key
Elimina un par clave-valor de un mapa o una clave de un conjunto.
-
xe class-param-clear uuid=uuid param-name=parameter
Borra por completo un conjunto o un mapa.
Comandos de lista de bajo nivel
El clase-list enumera los objetos de tipo clase. De forma predeterminada, este tipo de comando enumera todos los objetos, imprimiendo un subconjunto de los parámetros. Este comportamiento se puede modificar de las siguientes maneras:
- Puede filtrar los objetos para que solo genere un subconjunto
- Los parámetros que se imprimen se pueden modificar.
Para cambiar los parámetros que se imprimen, especifique el argumento Parámetros como una lista separada por comas de los parámetros necesarios. Por ejemplo:
xe vm-list params=name-label,other-config
<!--NeedCopy-->
Como alternativa, para enumerar todos los parámetros, utilice la sintaxis:
xe vm-list params=all
<!--NeedCopy-->
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>
<!--NeedCopy-->
Para obtener estos campos, utilice el comando clase-lista-param o clase-param-get
Para filtrar la lista, la CLI hace coincidir los valores de los parámetros con los valores especificados en la línea de comandos, imprimiendo solo los objetos que coinciden con todas las restricciones especificadas. Por ejemplo:
xe vm-list HVM-boot-policy="BIOS order" power-state=halted
<!--NeedCopy-->
Este comando enumera solo las máquinas virtuales para las que ambos El campo estado-energía
tiene el valor detenido y el campo Política de arranque de HVM
tiene el valor Orden de la BIOS.
También puede filtrar la lista por el valor de las claves en los mapas o por la existencia de valores en un conjunto. La sintaxis para filtrar en función de las claves en los mapas es nombre-mapa:clave=valor
. La sintaxis para filtrar en función de los valores existentes en un conjunto es nombre-conjunto:contiene=valor
.
Al crear scripts, una técnica útil es pasar --mínimo
en la línea de comandos, lo que provoca Xe
para imprimir solo el primer campo de una lista separada por comas. Por ejemplo, el comando xe 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
<!--NeedCopy-->
Secretos
XenServer proporciona un mecanismo de secretos para evitar que las contraseñas se almacenen en texto sin formato, en el historial de la línea de comandos o en objetos de API. XenCenter utiliza esta función automáticamente y también se puede utilizar desde la CLI xe para cualquier comando que requiera una contraseña.
Nota: No
Los secretos de contraseña no se pueden utilizar para autenticarse con un host de XenServer desde una instancia remota de la CLI de xe.
Para crear un objeto secreto, ejecute el siguiente comando en el host de XenServer.
xe secret-create value=my-password
<!--NeedCopy-->
Se crea un secreto y se almacena en el host de XenServer. El comando genera el UUID del objeto secreto. Por ejemplo 99945d96-5890-de2a-3899-8c04ef2521db
. Añadir _secreto
al nombre del argumento password para pasar este UUID a cualquier comando que requiera una contraseña.
Ejemplo: En el host de XenServer donde creó el secreto, puede ejecutar el siguiente comando:
xe sr-create device-config:location=sr_address device-config:type=cifs device-config:username=cifs_username \
device-config:cifspassword_secret=secret_uuid name-label="CIFS ISO SR" type="iso" content-type="iso" shared="true"
<!--NeedCopy-->
Historial de comandos
Algunos comandos xe, por ejemplo xe vm-migrate
o xe pool-enable-external-auth
, toma secretos como las contraseñas como parámetros. Estos pueden terminar en el historial del shell y durante la ejecución del comando son visibles en la tabla de procesos. Por lo tanto, es importante ejecutar estos comandos solo en entornos de confianza.
Para el shell bash, puede usar el método HISTCONTROL
para controlar qué comandos se almacenan en el historial del shell.
Referencia de comandos xe
En esta sección se agrupan los comandos por los objetos a los que se dirige el comando. Estos objetos se enumeran alfabéticamente.
Comandos del dispositivo
Comandos para crear y modificar dispositivos de máquina virtual (también conocidos como vApps). Para obtener más información, consulte vApps.
Parámetros del aparato
Los comandos del dispositivo tienen los siguientes parámetros:
Nombre del parámetro | Descripción | Tipo |
---|---|---|
uuid |
El uuid del aparato | Si son necesarias |
name-description |
La descripción del aparato | Opcional |
paused |
Opcional | |
force |
Forzar apagado | Opcional |
appliance-assert-can-be-recovered
xe appliance-assert-can-be-recovered uuid=appliance-uuid database:vdi-uuid=vdi-uuid
<!--NeedCopy-->
Comprueba si el almacenamiento está disponible para recuperar este dispositivo de máquina virtual/vApp.
appliance-create
xe appliance-create name-label=name-label [name-description=name-description]
<!--NeedCopy-->
Crea un dispositivo/vApp. Por ejemplo:
xe appliance-create name-label=my_appliance
<!--NeedCopy-->
Agregue máquinas virtuales al dispositivo:
xe vm-param-set uuid=VM-UUID appliance=appliance-uuid
<!--NeedCopy-->
appliance-destroy
xe appliance-destroy uuid=appliance-uuid
<!--NeedCopy-->
Destruye un dispositivo/vApp. Por ejemplo:
xe appliance-destroy uuid=appliance-uuid
<!--NeedCopy-->
appliance-recover
xe appliance-recover uuid=appliance-uuid database:vdi-uuid=vdi-uuid [paused=true|false]
<!--NeedCopy-->
Recupere un dispositivo de máquina virtual/vApp de la base de datos contenida en el VDI suministrado.
appliance-shutdown
xe appliance-shutdown uuid=appliance-uuid [force=true|false]
<!--NeedCopy-->
Apaga todas las máquinas virtuales de un dispositivo o vApp. Por ejemplo:
xe appliance-shutdown uuid=appliance-uuid
<!--NeedCopy-->
appliance-start
xe appliance-start uuid=appliance-uuid [paused=true|false]
<!--NeedCopy-->
Inicia un dispositivo/vApp. Por ejemplo:
xe appliance-start uuid=appliance-uuid
<!--NeedCopy-->
Comandos de auditoría
Los comandos de auditoría descargan todos los registros disponibles del archivo de auditoría RBAC en el grupo. Si el parámetro opcional desde
está presente, descarga solo los registros de ese punto específico en el tiempo.
audit-log-get
Parámetros
audit-log-get
tiene los siguientes parámetros:
Nombre del parámetro | Descripción | Tipo |
---|---|---|
filename |
Escriba el registro de auditoría del grupo en nombre de archivo | Si son necesarias |
since |
Punto de fecha y hora específico | Opcional |
audit-log-get
xe audit-log-get [since=timestamp] filename=filename
<!--NeedCopy-->
Por ejemplo, para obtener registros de auditoría del grupo desde una marca de tiempo precisa de milisegundos, ejecute el siguiente comando:
Ejecute este comando:
xe audit-log-get since=2009-09-24T17:56:20.530Z filename=/tmp/auditlog-pool-actions.out
<!--NeedCopy-->
Comandos de vinculación
Comandos para trabajar con enlaces de red, para la resiliencia con conmutación por error de interfaz física. Para obtener más información, consulte Gestión de redes.
El objeto de enlace es un objeto de referencia que se pega entre sí maestro y miembro PIFs. El PIF maestro es la interfaz de enlace que se debe utilizar como PIF general para referirse al enlace. Los PIF miembro son un conjunto de dos o más interfaces físicas que se han combinado en la interfaz enlazada de alto nivel.
Parámetros de unión
Los bonos tienen los siguientes parámetros:
Nombre del parámetro | Descripción | Tipo |
---|---|---|
uuid |
Identificador único/referencia de objeto para el enlace | Solo lectura |
master |
UUID para el PIF del bono principal | Solo lectura |
members |
Conjunto de UUID para los PIF enlazados subyacentes | Solo lectura |
bond-create
xe bond-create network-uuid=network_uuid pif-uuids=pif_uuid_1,pif_uuid_2,...
<!--NeedCopy-->
Cree una interfaz de red enlazada en la red especificada a partir de una lista de objetos PIF existentes. El comando falla en cualquiera de los siguientes casos:
- Si los PIF ya están en otro bono
- Si algún miembro tiene un conjunto de etiquetas VLAN
- Si los PIF a los que se hace referencia no están en el mismo host de XenServer
- Si se suministran menos de 2 PIF
bond-destroy
xe bond-destroy uuid=bond_uuid
<!--NeedCopy-->
Elimina una interfaz enlazada especificada por su UUID de un host.
bond-set-mode
xe bond-set-mode uuid=bond_uuid mode=bond_mode
<!--NeedCopy-->
Cambie el modo de enlace.
Comandos de CD
Comandos para trabajar con unidades físicas de CD/DVD en hosts XenServer.
Parámetros de CD
Los CD tienen los siguientes parámetros:
Nombre del parámetro | Descripción | Tipo |
---|---|---|
uuid |
Identificador único/referencia de objeto para el CD | Solo lectura |
name-label |
Nombre del CD | Lectura/escritura |
name-description |
Texto descriptivo del CD | Lectura/escritura |
allowed-operations |
Una lista de las operaciones que se pueden realizar en este CD | Parámetro de conjunto de solo lectura |
current-operations |
Una lista de las operaciones que están actualmente en curso en este CD | Parámetro de conjunto de solo lectura |
sr-uuid |
El identificador único/referencia de objeto para el SR del que forma parte este CD | Solo lectura |
sr-name-label |
El nombre del SR del que forma parte este CD | Solo lectura |
vbd-uuids |
Una lista de los identificadores únicos de los VBD de las máquinas virtuales que se conectan a este CD | Parámetro de conjunto de solo lectura |
crashdump-uuids |
No se utiliza en CD. Porque los volcados de memoria no se pueden escribir en CD | Parámetro de conjunto de solo lectura |
virtual-size |
Tamaño del CD tal y como aparece en las máquinas virtuales (en bytes) | Solo lectura |
physical-utilisation |
Cantidad de espacio físico que ocupa la imagen de CD en el SR (en bytes) | Solo lectura |
type |
Establecer en Usuario para CD | Solo lectura |
sharable |
Si la unidad de CD se puede compartir o no. El valor predeterminado es falso . |
Solo lectura |
read-only |
Si el CD es de solo lectura, si falso , el dispositivo es escribible. Siempre es cierto para los CD. |
Solo lectura |
storage-lock |
El valor es verdadero si este disco está bloqueado en el nivel de almacenamiento. |
Solo lectura |
parent |
Referencia al disco padre, si este CD es parte de una cadena. | Solo lectura |
missing |
El valor es verdadero si la operación de escaneo SR informó que este CD no estaba presente en el disco |
Solo lectura |
other-config |
Una lista de pares clave-valor que especifican parámetros de configuración adicionales para el CD | Parámetro de mapa de lectura/escritura |
location |
La ruta en la que está montado el dispositivo | Solo lectura |
managed |
El valor es verdadero Si el dispositivo está administrado |
Solo lectura |
xenstore-data |
Los datos que se insertarán en el archivo Xenstore árbol |
Parámetro de mapa de solo lectura |
sm-config |
Nombres y descripciones de las claves de configuración del dispositivo del administrador de almacenamiento | Parámetro de mapa de solo lectura |
is-a-snapshot |
El valor es verdadero si esta plantilla es una instantánea de CD |
Solo lectura |
snapshot_of |
El UUID del CD del que esta plantilla es una instantánea | Solo lectura |
snapshots |
Los UUID de las instantáneas que se han tomado de este CD | Solo lectura |
snapshot_time |
La marca de tiempo de la operación de instantánea | Solo lectura |
cd-list
xe cd-list [params=param1,param2,...] [parameter=parameter_value]
<!--NeedCopy-->
Enumere los CD e ISO (archivos de imagen de CD) en el host o grupo de XenServer, filtrando por el argumento opcional Parámetros
.
Si el argumento opcional Parámetros
, 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 todo
para mostrar todos los parámetros. Cuando Parámetros
no 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 del 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 característica de agrupación en clústeres. Utilice estos grupos con SR GFS2. Para obtener más información, consulte Grupos agrupados
Los objetos cluster y cluster-host se pueden enumerar con los comandos estándar de lista de objetos (xe lista-clúster
y xe cluster-host-list
), y los parámetros manipulados con los comandos de parámetros estándar. Para obtener más información, consulte Comandos de parámetros de bajo nivel. Comandos para trabajar con grupos agrupados.
Parámetros del clúster
Los clústeres tienen los siguientes parámetros:
Nombre del parámetro | Descripción | Tipo |
---|---|---|
uuid |
El identificador único/referencia de objeto para el clúster | Solo lectura |
cluster-hosts |
Una lista de identificadores únicos/referencias de objetos para los hosts del clúster | Parámetro de conjunto de solo lectura |
cluster-token |
La clave secreta utilizada por xapi-clusterd cuando se habla a sí mismo en otros anfitriones |
Solo lectura |
cluster-stack |
La pila de tecnología que proporciona las capacidades de agrupación en clústeres. Los valores posibles son: Corosync . |
Solo lectura |
allowed-operations |
Enumera las operaciones permitidas en este estado. Esta lista es solo consultiva y es posible que el estado del clúster haya cambiado en el momento en que un cliente lee este campo. | Parámetro de conjunto de solo lectura |
current-operations |
Enumera las operaciones que se están llevando a cabo actualmente. Esta lista es solo consultiva y es posible que el estado del clúster haya cambiado en el momento en que un cliente lee este campo. | Parámetro de conjunto de solo lectura |
token-timeout |
El Corosync Tiempo de espera del token en segundos |
Solo lectura |
token-timeout-coefficient |
El Corosync Coeficiente de tiempo de espera del token en segundos |
Solo lectura |
pool-auto-join |
True si se unen automáticamente nuevos miembros del grupo al clúster. Esto se establece en verdadero . |
Solo lectura |
cluster-config |
Una lista de pares clave-valor que especifican parámetros de configuración adicionales para el clúster. | Parámetro de mapa de solo lectura |
other-config |
Una lista de pares clave-valor que especifican parámetros de configuración adicionales para el clúster. | Parámetro de mapa de lectura/escritura |
cluster-host-destroy
xe cluster-host-destroy uuid=host_uuid
<!--NeedCopy-->
Destruya un host de clúster, abandonando efectivamente el clúster.
cluster-host-disable
xe cluster-host-disable uuid=cluster_uuid
<!--NeedCopy-->
Deshabilite la pertenencia a clústeres para un host de clúster habilitado.
cluster-host-enable
xe cluster-host-enable uuid=cluster_uuid
<!--NeedCopy-->
Habilite la pertenencia a clústeres para un host de clúster deshabilitado.
cluster-host-force-destroy
xe cluster-host-force-destroy uuid=cluster_host
<!--NeedCopy-->
Destruya un objeto host de clúster a la fuerza, abandonando el clúster de forma efectiva.
cluster-pool-create
xe cluster-pool-create network-uuid=network_uuid [cluster-stack=cluster_stack] [token-timeout=token_timeout] [token-timeout-coefficient=token_timeout_coefficient]
<!--NeedCopy-->
Cree un clúster para todo el grupo.
cluster-pool-destroy
xe cluster-pool-destroy cluster-uuid=cluster_uuid
<!--NeedCopy-->
Destruya el clúster de todo el grupo. El grupo sigue existiendo, pero ya no está agrupado y ya no puede utilizar SR de GFS2.
cluster-pool-force-destroy
xe cluster-pool-force-destroy cluster-uuid=cluster_uuid
<!--NeedCopy-->
Forzar la destrucción del clúster de todo el grupo.
cluster-pool-resync
xe cluster-pool-resync cluster-uuid=cluster_uuid
<!--NeedCopy-->
Vuelva a sincronizar un clúster en un grupo.
Comandos de consola
Comandos para trabajar con consolas.
Los objetos de consola se pueden enumerar con el comando estándar de listado de objetos (Lista-de-consolas xe
), 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 del parámetro | Descripción | Tipo |
---|---|---|
uuid |
La referencia de objeto o identificador único para la consola | Solo lectura |
vm-uuid |
El identificador único/referencia de objeto de la máquina virtual en la que está abierta esta consola | Solo lectura |
vm-name-label |
El nombre de la máquina virtual en la que está abierta esta consola | Solo lectura |
protocol |
Protocolo que utiliza esta consola. Los valores posibles son: VT100 : Terminal VT100, Rfb : Protocolo de búfer de fotogramas remoto (como se utiliza en VNC), o Rdp : Protocolo de Escritorio Remoto |
Solo lectura |
location |
URI para el servicio de consola | Solo lectura |
other-config |
Una lista de pares clave-valor que especifican parámetros de configuración adicionales para la consola. | Parámetro de mapa de lectura/escritura |
console
xe console
<!--NeedCopy-->
Conéctalo a una consola en particular.
Comandos de diagnóstico
Comandos para recopilar información de diagnóstico de XenServer.
diagnostic-compact
xe diagnostic-compact
<!--NeedCopy-->
Realice una recopilación importante de GC y una compactación de montón.
diagnostic-db-stats
xe diagnostic-db-stats
<!--NeedCopy-->
Imprimir estadísticas de la base de datos.
diagnostic-gc-stats
xe diagnostic-gc-stats
<!--NeedCopy-->
Imprimir estadísticas de GC.
diagnostic-license-status
xe diagnostic-license-status
<!--NeedCopy-->
Ayude a diagnosticar problemas de licencias en todo el grupo.
diagnostic-net-stats
xe diagnostic-net-stats [uri=uri] [method=method] [params=param1,param2...]
<!--NeedCopy-->
Estadísticas de la red de impresión.
diagnostic-timing-stats
xe diagnostic-timing-stats
<!--NeedCopy-->
Imprima estadísticas de tiempo.
diagnostic-vdi-status
xe diagnostic-vdi-status uuid=vdi_uuid
<!--NeedCopy-->
Consultar el estado de bloqueo y uso compartido de una VDI.
diagnostic-vm-status
xe diagnostic-vm-status uuid=vm_uuid
<!--NeedCopy-->
Consulte los hosts en los que se puede iniciar la máquina virtual, verifique el estado de uso compartido/bloqueo de todos los VBD.
Comandos de recuperación ante desastres
Comandos para recuperar máquinas virtuales después de un desastre
drtask-create
xe drtask-create type=type sr-whitelist=sr-white-list device-config=device-config
<!--NeedCopy-->
Crea una tarea de recuperación ante desastres. Por ejemplo, para conectarse a un SR iSCSI en preparación para la recuperación ante desastres:
xe drtask-create type=lvmoiscsi device-config:target=target-ip-address \
device-config:targetIQN=targetIQN device-config:SCSIid=SCSIid \
sr-whitelist=sr-uuid-list
<!--NeedCopy-->
Nota: No
El comando
sr-whitelist
enumera los UUID de SR permitidos. Eldrtask-create
solo introduce y se conecta a un SR que tiene uno de los UUID permitidos
drtask-destroy
xe drtask-destroy uuid=dr-task-uuid
<!--NeedCopy-->
Destruye una tarea de recuperación ante desastres y olvida el SR introducido.
vm-assert-can-be-recovered
xe vm-assert-can-be-recovered uuid=vm-uuid database:vdi-uuid=vdi-uuid
<!--NeedCopy-->
Comprueba si el almacenamiento está disponible para recuperar esta máquina virtual.
appliance-assert-can-be-recovered
xe appliance-assert-can-be-recovered uuid=appliance-uuid database:vdi-uuid=vdi-uuid
<!--NeedCopy-->
Comprueba si el almacenamiento (que contiene el disco del dispositivo/vAPP) está visible.
appliance-recover
xe appliance-recover uuid=appliance-uuid database:vdi-uuid=vdi-uuid [force=true|false]
<!--NeedCopy-->
Recupere un dispositivo/vAPP de la base de datos contenida en el VDI suministrado.
vm-recover
xe vm-recover uuid=vm-uuid database:vdi-uuid=vdi-uuid [force=true|false]
<!--NeedCopy-->
Recupera una máquina virtual de la base de datos contenida en el VDI suministrado.
sr-enable-database-replication
xe sr-enable-database-replication uuid=sr_uuid
<!--NeedCopy-->
Habilita la replicación de bases de datos XAPI en el SR especificado (compartido).
sr-disable-database-replication
xe sr-disable-database-replication uuid=sr_uuid
<!--NeedCopy-->
Deshabilita la replicación de base de datos XAPI en el SR especificado.
Ejemplo de uso
En el ejemplo siguiente se muestran los comandos de la CLI de recuperación ante desastres en contexto:
En el sitio principal, habilite la replicación de base de datos:
xe sr-database-replication uuid=sr=uuid
<!--NeedCopy-->
Después de un desastre, en el sitio secundario, conéctese al SR. El configuración-dispositivo
tiene los mismos campos que sonda sr.
.
xe drtask-create type=lvmoiscsi \
device-config:target=target ip address \
device-config:targetIQN=target-iqn \
device-config:SCSIid=scsi-id \
sr-whitelist=sr-uuid
<!--NeedCopy-->
Busque VDI de base de datos en el SR:
xe vdi-list sr-uuid=sr-uuid type=Metadata
<!--NeedCopy-->
Consulte una VDI de base de datos para las máquinas virtuales presentes:
xe vm-list database:vdi-uuid=vdi-uuid
<!--NeedCopy-->
Recuperar una máquina virtual:
xe vm-recover uuid=vm-uuid database:vdi-uuid=vdi-uuid
<!--NeedCopy-->
Destruya la tarea de recuperación ante desastres. Los SR introducidos por la tarea de recuperación ante desastres y que no sean necesarios para las máquinas virtuales se destruyen:
xe drtask-destroy uuid=drtask-uuid
<!--NeedCopy-->
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 |
vdi |
Una imagen de disco virtual |
vbd |
Un dispositivo de bloque virtual |
pbd |
Los dispositivos de bloque físico a través de los cuales los hosts acceden a los SR |
event-wait
xe event-wait class=class_name [param-name=param_value] [param-name=/=param_value]
<!--NeedCopy-->
Bloquea la ejecución de otros comandos hasta que exista un objeto que cumpla las condiciones dadas en la línea de comandos. El argumento x=y
significa “esperar a que el campo x tome el valor y” y x=/=y
significa “esperar a que el campo x tome cualquier valor que no sea y”.
Ejemplo: espere a que se ejecute una máquina virtual específica.
xe event-wait class=vm name-label=myvm power-state=running
<!--NeedCopy-->
Bloquea otros comandos hasta que se llama a una máquina virtual myVM
se encuentra en el estado-energía
“Corriendo”.
Ejemplo: espere a que se reinicie una máquina virtual específica:
xe event-wait class=vm uuid=$VM start-time=/=$(xe vm-list uuid=$VM params=start-time --minimal)
<!--NeedCopy-->
Bloquea otros comandos hasta que aparezca una máquina virtual con UUID $VM Reinicios. El comando utiliza el valor de Hora de inicio
para decidir cuándo se reinicia la máquina virtual.
El nombre de la clase puede ser cualquiera de los Clases de eventos enumerados al principio de esta sección. Los parámetros pueden ser cualquiera de los parámetros enumerados en el comando CLI clase-lista-param.
Comandos de GPU
Comandos para trabajar con GPU físicas, grupos de GPU y GPU virtuales.
Los objetos de GPU se pueden enumerar con los comandos estándar de lista de objetos: xe pgpu-lista
, xe gpu-group-list
y xe vgpu-list
. Los parámetros se pueden manipular con los comandos de parámetros estándar. Para obtener más información, consulte Comandos de parámetros de bajo nivel.
Parámetros físicos de la GPU
Las GPU físicas (pGPU) tienen los siguientes parámetros:
Nombre del parámetro | Descripción | Tipo |
---|---|---|
uuid |
El identificador único/referencia de objeto para la pGPU | Solo lectura |
vendor-name |
El nombre del proveedor de la pGPU | Solo lectura |
device-name |
El nombre asignado por el proveedor a este modelo de pGPU | Solo lectura |
gpu-group-uuid |
El identificador único/referencia de objeto para el grupo de GPU al que XenServer ha asignado automáticamente esta pGPU. Se agrupan pGPU idénticas en los hosts de un grupo | Solo lectura |
gpu-group-name-label |
El nombre del grupo de GPU al que se asigna la pGPU | Solo lectura |
host-uuid |
El identificador único/referencia de objeto para el host XenServer al que está conectada la pGPU | Solo lectura |
host-name-label |
El nombre del host XenServer al que está conectada la pGPU | Solo lectura |
pci-id |
Identificador PCI | Solo lectura |
dependencies |
Enumera los dispositivos PCI dependientes que se pasan a la misma máquina virtual | Parámetro de mapa de lectura/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/escritura |
supported-VGPU-types |
Lista de tipos de GPU virtuales compatibles con el hardware subyacente | Solo lectura |
enabled-VGPU-types |
Lista de tipos de GPU virtuales que se han habilitado para esta pGPU | Lectura/Escritura |
resident-VGPUs |
Lista de vGPUs que se ejecutan en esta pGPU | Solo lectura |
pgpu-disable-dom0-access
xe pgpu-disable-dom0-access uuid=uuid
<!--NeedCopy-->
Deshabilite el acceso de PGPU a dom0.
pgpu-enable-dom0-access
xe pgpu-enable-dom0-access uuid=uuid
<!--NeedCopy-->
Habilite el acceso de PGPU a dom0.
Parámetros de grupo de GPU
Los grupos de GPU tienen los siguientes parámetros:
Nombre del parámetro | Descripción | Tipo |
---|---|---|
uuid |
El identificador único/referencia de objeto para el grupo de GPU | Solo lectura |
name-label |
El nombre del grupo de GPU | Lectura/escritura |
name-description |
El texto descriptivo del grupo de GPU | Lectura/escritura |
VGPU-uuids |
Enumera las referencias de identificador/objeto único para las GPU virtuales del grupo GPU | Parámetro de conjunto de solo lectura |
PGPU-uuids |
Enumera las referencias de identificador/objeto únicos para las pGPU del grupo GPU | Parámetro de conjunto de solo lectura |
other-config |
Una lista de pares clave-valor que especifican parámetros de configuración adicionales para el grupo de GPU | Parámetro de mapa de lectura/escritura |
supported-VGPU-types |
Unión de todos los tipos de GPU virtuales compatibles con el hardware subyacente | Solo lectura |
enabled-VGPU-types |
Unión de todos los tipos de GPU virtuales que se han habilitado en las pGPU subyacentes | Solo lectura |
allocation-algorithm |
Configuración de profundidad primero/amplitud para la asignación de GPU virtuales en pGPU dentro del grupo | Parámetro de enumeración de lectura/escritura |
Operaciones de grupo de GPU
Comandos para trabajar con grupos de GPU
gpu-group-create
xe gpu-group-create name-label=name_for_group [name-description=description]
<!--NeedCopy-->
Crea un nuevo grupo de GPU (vacío) al que se pueden mover las pGPU.
gpu-group-destroy
xe gpu-group-destroy uuid=uuid_of_group
<!--NeedCopy-->
Destruye el grupo de GPU; Solo se permite para grupos vacíos.
gpu-group-get-remaining-capacity
xe gpu-group-get-remaining-capacity uuid=uuid_of_group vgpu-type-uuid=uuid_of_vgpu_type
<!--NeedCopy-->
Devuelve cuántas GPU virtuales más del tipo especificado se pueden crear instancias en este grupo de GPU.
gpu-group-param-set
xe gpu-group-param-set uuid=uuid_of_group allocation-algorithm=breadth-first|depth-first
<!--NeedCopy-->
Cambia el algoritmo que utiliza el grupo de GPU para asignar GPU virtuales a pGPU.
Parámetros de GPU virtual
Las GPU virtuales tienen los siguientes parámetros:
Nombre del parámetro | Descripción | Tipo |
---|---|---|
uuid |
El identificador único/referencia de objeto para la GPU virtual | Solo lectura |
vm-uuid |
Identificador único/referencia de objeto para la máquina virtual a la que se asigna la GPU virtual | Solo lectura |
vm-name-label |
El nombre de la máquina virtual a la que se asigna la GPU virtual | Solo lectura |
gpu-group-uuid |
Referencia de objeto o identificador único para el grupo de GPU en el que se encuentra la GPU virtual | Solo lectura |
gpu-group-name-label |
Nombre del grupo de GPU en el que se encuentra la GPU virtual | Solo lectura |
currently-attached |
True si se está ejecutando una máquina virtual con paso a través de GPU, false en caso contrario | Solo lectura |
other-config |
Una lista de pares clave-valor que especifican parámetros de configuración adicionales para la GPU virtual | Parámetro de mapa de lectura/escritura |
type-uuid |
El identificador único/referencia de objeto para el tipo de GPU virtual de esta GPU virtual | Parámetro de mapa de lectura/escritura |
type-model-name |
Nombre del modelo asociado al tipo de GPU virtual | Solo lectura |
Parámetros de tipo de GPU virtual
Nota: No
El paso a través de GPU y las GPU virtuales no son compatibles con la migración en vivo, la migración en vivo de almacenamiento o la suspensión de máquinas virtuales, a menos que estén presentes el software y las tarjetas gráficas compatibles de los proveedores de GPU. Las máquinas virtuales sin esta compatibilidad no se pueden migrar para evitar el tiempo de inactividad. Para obtener información sobre la compatibilidad de NVIDIA vGPU con la migración en vivo, la migración en vivo de almacenamiento y la suspensión de máquinas virtuales, consulte Grafismo.
Los tipos de GPU virtual tienen los siguientes parámetros:
Nombre del parámetro | Descripción | Tipo |
---|---|---|
uuid |
La referencia de objeto o identificador único para el tipo de GPU virtual | Solo lectura |
vendor-name |
Nombre del proveedor de GPU virtual | Solo lectura |
model-name |
Nombre del modelo asociado al tipo de GPU virtual | Solo lectura |
freeze-frame |
Tamaño del búfer de fotogramas del tipo de GPU virtual, en bytes | Solo lectura |
max-heads |
Número máximo de pantallas admitidas por el tipo de GPU virtual | Solo lectura |
supported-on-PGPUs |
Lista de pGPUs que admiten este tipo de GPU virtual | Solo lectura |
enabled-on-PGPUs |
Lista de pGPUs que tienen habilitado este tipo de GPU virtual | Solo lectura |
VGPU-uuids |
Lista de GPUs virtuales de este tipo | Solo lectura |
Operaciones de GPU virtual
vgpu-create
xe vgpu-create vm-uuid=uuid_of_vm gpu_group_uuid=uuid_of_gpu_group [vgpu-type-uuid=uuid_of_vgpu-type]
<!--NeedCopy-->
Crea una GPU virtual. Este comando conecta la 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
xe vgpu-destroy uuid=uuid_of_vgpu
<!--NeedCopy-->
Destruya la GPU virtual especificada.
Deshabilitación de VNC para máquinas virtuales con GPU virtual
xe vm-param-add uuid=uuid_of_vmparam-name=platform vgpu_vnc_enabled=true|false
<!--NeedCopy-->
Usando falso
deshabilita la consola VNC para una máquina virtual a medida que pasa deshabilitarvnc=1
a través del emulador de pantalla. De forma predeterminada, VNC está habilitado.
Comandos de host
Comandos para interactuar con el host de XenServer.
Los hosts de XenServer son los servidores físicos que ejecutan el software de XenServer. Tienen máquinas virtuales que se ejecutan en ellas bajo el control de una máquina virtual con privilegios especiales, conocida como dominio de control o dominio 0.
Los objetos host de XenServer se pueden enumerar con los comandos estándar de lista de objetos: xe lista-de-host
, xe host-cpu-list
y xe host-crashdump-list
). Los parámetros se pueden manipular con los comandos de parámetros estándar. Para obtener más información, consulte Comandos de parámetros de bajo nivel.
Selectores de host
Varios de los comandos enumerados aquí tienen un mecanismo común para seleccionar uno o más hosts XenServer en los que realizar la operación. La más sencilla es proporcionando el argumento anfitrión=uuid_or_name_label
. También puede especificar XenServer filtrando la lista completa de hosts en los valores de los campos. Por ejemplo, especificando habilitado=verdadero
selecciona todos los hosts de XenServer cuyos Habilitado
campo es igual a verdadero
. Cuando coincidan varios hosts de XenServer y la operación se pueda realizar en varios hosts de XenServer, debe especificar --múltiple
para realizar la operación. La lista completa de parámetros que se pueden hacer coincidir se describe al principio de esta sección. Puede obtener esta lista de comandos ejecutando el comando xe host-list params=all
. Si no se proporciona ningún parámetro para seleccionar hosts de XenServer, la operación se realiza en todos los hosts de XenServer.
Parámetros de host
Los hosts de XenServer tienen los siguientes parámetros:
Nombre del parámetro | Descripción | Tipo |
---|---|---|
uuid |
La referencia de objeto o identificador único para el host de XenServer | Solo lectura |
name-label |
El nombre del host de XenServer | Lectura/escritura |
name-description |
La cadena de descripción del host de XenServer | Solo lectura |
enabled |
El valor es falso si está deshabilitado. Esto evita que se inicien nuevas máquinas virtuales en los hosts y prepara los hosts para apagarlos o reiniciarlos. El valor es verdadero Si el host está habilitado |
Solo lectura |
API-version-major |
Número de versión principal | Solo lectura |
API-version-minor |
Número de versión secundaria | Solo lectura |
API-version-vendor |
Identificación del proveedor de API | Solo lectura |
API-version-vendor-implementation |
Detalles de la implementación del proveedor | Parámetro de mapa de solo lectura |
logging |
Configuración de captura de registros | Parámetro de mapa de lectura/escritura |
suspend-image-sr-uuid |
El identificador único/referencia de objeto para el SR donde se colocan las imágenes suspendidas | Lectura/escritura |
crash-dump-sr-uuid |
El identificador único/referencia de objeto para el SR donde se colocan los volcados de memoria | Lectura/escritura |
software-version |
Lista de parámetros de control de versiones y sus valores | Parámetro de mapa de solo lectura |
capabilities |
Lista de versiones de Xen que puede ejecutar el host de XenServer | Parámetro de conjunto de solo lectura |
other-config |
Una lista de pares clave-valor que especifican parámetros de configuración adicionales para el host de XenServer | Parámetro de mapa de lectura/escritura |
chipset-info |
Una lista de pares clave-valor que especifican información sobre el chipset | Parámetro de mapa de solo lectura |
hostname |
Nombre de host de XenServer | Solo lectura |
address |
Dirección IP del host de XenServer | Solo lectura |
license-server |
Una lista de pares clave-valor que especifican información sobre el servidor de licencias. El puerto predeterminado para las comunicaciones con los productos Citrix es 27000. Para obtener información sobre cómo cambiar los números de puerto debido a conflictos, consulte Cambiar los números de puerto | Parámetro de mapa de solo lectura |
supported-bootloaders |
Lista de cargadores de arranque compatibles con el host XenServer, por ejemplo, Pygrub , Eliloader
|
Parámetro de conjunto de solo lectura |
memory-total |
Cantidad total de RAM física en el host de XenServer, en bytes | Solo lectura |
memory-free |
Cantidad total de RAM física restante que se puede asignar a las máquinas virtuales, en bytes | Solo lectura |
host-metrics-live |
True si el host está operativo | Solo lectura |
logging |
El syslog_destination key se puede establecer en el nombre de host de un servicio de syslog de escucha remota. |
Parámetro de mapa de lectura/escritura |
allowed-operations |
Enumera las operaciones permitidas en este estado. Esta lista es solo consultiva y es posible que el estado del host haya cambiado para cuando un cliente lea este campo. | Parámetro de conjunto de solo lectura |
current-operations |
Enumera las operaciones que se están llevando a cabo actualmente. Esta lista es solo consultiva y es posible que el estado del host haya cambiado para cuando un cliente lea este campo. | Parámetro de conjunto de solo lectura |
patches |
Conjunto de parches de host | Parámetro de conjunto de solo lectura |
blobs |
Almacén de datos binarios | Solo lectura |
memory-free-computed |
Una estimación conservadora de la cantidad máxima de memoria libre en un host | Solo lectura |
ha-statefiles |
Los UUID de todos los archivos de estado de alta disponibilidad | Solo lectura |
ha-network-peers |
Los UUID de todos los hosts que pueden alojar las máquinas virtuales en este host si se produce un error | Solo lectura |
external-auth-type |
Tipo de autenticación externa, por ejemplo, Active Directory. | Solo lectura |
external-auth-service-name |
El nombre del servicio de autenticación externo | Solo lectura |
external-auth-configuration |
Información de configuración para el servicio de autenticación externo. | Parámetro de mapa de solo lectura |
Los hosts de XenServer contienen otros objetos que también tienen listas de parámetros.
Las CPU de los hosts de XenServer tienen los siguientes parámetros:
Nombre del parámetro | Descripción | Tipo |
---|---|---|
uuid |
La referencia de identificador/objeto único para la CPU | Solo lectura |
number |
El número de núcleos de CPU físicos dentro del host de XenServer | Solo lectura |
vendor |
La cadena de proveedor para el nombre de CPU | Solo lectura |
speed |
La velocidad del reloj de la CPU, en Hz | Solo lectura |
modelname |
La cadena de proveedor para el modelo de CPU, por ejemplo, “Intel(R) Xeon(TM) CPU 3.00 GHz” | Solo lectura |
stepping |
El número de revisión de la CPU | Solo lectura |
flags |
Los indicadores de la CPU física (una versión decodificada del campo de características) | Solo lectura |
Utilisation |
La utilización actual de la CPU | Solo lectura |
host-uuid |
El UUID si el host en el que se encuentra la CPU | Solo lectura |
model |
El número de modelo de la CPU física | Solo lectura |
family |
El número de familia de la CPU física | Solo lectura |
Los volcados de memoria en hosts de XenServer tienen los siguientes parámetros:
Nombre del parámetro | Descripción | Tipo |
---|---|---|
uuid |
El identificador único/referencia de objeto para el volcado de memoria | Solo lectura |
host |
Host de XenServer al que corresponde el volcado de memoria | Solo lectura |
timestamp |
Marca de tiempo de la fecha y hora en que se produjo el volcado de memoria, con el formato aaaammdd-hhmmss-ABC Dónde ABECEDARIO es el indicador de zona horaria, por ejemplo, GMT |
Solo lectura |
size |
Tamaño del volcado de memoria, en bytes | Solo lectura |
host-all-editions
xe host-all-editions
<!--NeedCopy-->
Obtener una lista de todas las ediciones disponibles
host-apply-edition
xe host-apply-edition [host-uuid=host_uuid] [edition=xenserver_edition="free" "per-socket" "xendesktop"]
<!--NeedCopy-->
Asigna la licencia de XenServer a un servidor host. Cuando se asigna una licencia, XenServer se pone en contacto con el servidor de licencias y solicita el tipo de licencia especificado. Si hay una licencia disponible, se extrae del servidor de licencias.
Para la configuración inicial de licencias, consulte también dirección-servidor-de-licencia
y puerto-servidor-de-licencia
.
host-backup
xe host-backup file-name=backup_filename host=host_name
<!--NeedCopy-->
Descargue una copia de seguridad del dominio de control del host XenServer especificado en el equipo desde el que se invoca el comando. Guárdelo allí como un archivo con el nombre nombre-archivo
.
Importante:
Mientras que el
xe host-backup
El 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, se llenaría la partición del dominio de control con el archivo de copia de seguridad. Utilice el comando únicamente desde un equipo remoto fuera del host en el que tenga espacio para guardar el archivo de copia de seguridad.
host-bugreport-upload
xe host-bugreport-upload [host-selector=host_selector_value...] [url=destination_url http-proxy=http_proxy_name]
<!--NeedCopy-->
Genere un nuevo informe de errores (usando xen-bugtool
, con todos los archivos opcionales incluidos) y cárguelo en el sitio FTP de soporte o en alguna otra ubicación.
Los hosts en los que se va a realizar esta operación se seleccionan utilizando el mecanismo de selección estándar (véase 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: Proxy HTTP
: use el proxy HTTP especificado, y URL
: cargar a esta URL de destino. Si no se utilizan parámetros opcionales, no se identifica ningún servidor proxy y el destino es el sitio FTP de soporte predeterminado.
host-call-plugin
xe host-call-plugin host-uuid=host_uuid plugin=plugin fn=function [args=args]
<!--NeedCopy-->
Llama a la función dentro del complemento en el host dado con argumentos opcionales.
host-compute-free-memory
xe host-compute-free-memory
<!--NeedCopy-->
Calcula la cantidad de memoria libre en el host.
host-compute-memory-overhead
xe host-compute-memory-overhead
<!--NeedCopy-->
Calcula la sobrecarga de memoria de virtualización de un host.
host-cpu-info
xe host-cpu-info [uuid=uuid]
<!--NeedCopy-->
Enumera información sobre las CPU físicas del host.
host-crashdump-destroy
xe host-crashdump-destroy uuid=crashdump_uuid
<!--NeedCopy-->
Elimine un volcado de memoria de host especificado por su UUID del host de XenServer.
host-crashdump-upload
xe host-crashdump-upload uuid=crashdump_uuid [url=destination_url] [http-proxy=http_proxy_name]
<!--NeedCopy-->
Cargue un volcado de memoria en el sitio FTP de soporte técnico 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: Proxy HTTP
: use el proxy HTTP especificado, y URL
: cargar a esta URL de destino.
host-declare-dead
xe host-declare-dead uuid=host_uuid
<!--NeedCopy-->
Declarar que el host está muerto sin ponerse en contacto con él explícitamente.
Advertencia:
Esta llamada es peligrosa y puede provocar la pérdida de datos si el host no está realmente muerto.
host-disable
xe host-disable [host-selector=host_selector_value...]
<!--NeedCopy-->
Deshabilita los hosts de XenServer especificados, lo que impide que se inicien nuevas máquinas virtuales en ellos. Esta acción prepara los hosts de XenServer para que se apaguen o se reinicien. Después de que el host se reinicie, si se cumplen todas las condiciones para la habilitación (por ejemplo, el almacenamiento está disponible), el host se vuelve a habilitar automáticamente.
Los hosts en los que se va a realizar esta operación se seleccionan utilizando el mecanismo de selección estándar (véase Selectores de host). Los argumentos opcionales pueden ser cualquier número de los Parámetros de host enumerados al principio de esta sección.
host-disable-display
xe host-disable-display uuid=host_uuid
<!--NeedCopy-->
Deshabilite la visualización para el host.
host-disable-local-storage-caching
xe host-disable-local-storage-caching
<!--NeedCopy-->
Deshabilite el almacenamiento en caché del almacenamiento local en el host especificado.
host-dmesg
xe host-dmesg [host-selector=host_selector_value...]
<!--NeedCopy-->
Consigue un Xen dmesg
(la salida del búfer de anillo del kernel) de los hosts XenServer especificados.
Los hosts en los que se va a realizar esta operación se seleccionan utilizando el mecanismo de selección estándar (véase 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
xe host-emergency-ha-disable [--force]
<!--NeedCopy-->
Deshabilite HA en el host local. Solo se debe usar para recuperar un grupo con una configuración de alta disponibilidad rota.
host-emergency-management-reconfigure
xe host-emergency-management-reconfigure interface=uuid_of_management_interface_pif
<!--NeedCopy-->
Vuelva a configurar la interfaz de administración de este host de XenServer. Utilice este comando solo si el host de XenServer está en modo de emergencia. El modo de emergencia significa que el host es miembro de un grupo de recursos cuyo coordinador de grupo ha desaparecido de la red y no se puede contactar con él después de varios reintentos.
host-emergency-reset-server-certificate
xe host-emergency-reset-server-certificate
<!--NeedCopy-->
Instala un certificado autofirmado en el host de XenServer donde se ejecuta el comando.
host-enable
xe host-enable [host-selector=host_selector_value...]
<!--NeedCopy-->
Habilita los hosts de XenServer especificados, lo que permite iniciar nuevas máquinas virtuales en ellos.
Los hosts en los que se va a realizar esta operación se seleccionan utilizando el mecanismo de selección estándar (véase 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
xe host-enable-display uuid=host_uuid
<!--NeedCopy-->
Habilite la visualización para el host.
host-enable-local-storage-caching
xe host-enable-local-storage-caching sr-uuid=sr_uuid
<!--NeedCopy-->
Habilite el almacenamiento en caché de almacenamiento local en el host especificado.
host-evacuate
xe host-evacuate [host-selector=host_selector_value...]
<!--NeedCopy-->
Live migra todas las máquinas virtuales en ejecución a otros hosts adecuados en un grupo. En primer lugar, deshabilite el host mediante el comando deshabilitación de host
mandar.
Si el anfitrión evacuado es el coordinador del grupo, se debe seleccionar otro anfitrión para que sea el coordinador del grupo. Para cambiar el coordinador del grupo con HA deshabilitado, use el comando pool-designate-new-master
mandar. Para obtener más información, consulte pool-designate-new-master.
Con HA habilitado, la única opción es apagar el host de XenServer, lo que hace que HA elija un nuevo coordinador de grupo al azar. Para obtener más información, consulte apagado de host.
Los hosts en los que se va a realizar esta operación se seleccionan utilizando el mecanismo de selección estándar (véase 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
xe host-forget uuid=host_uuid
<!--NeedCopy-->
El agente XAPI se olvida del host XenServer especificado sin ponerse en contacto con él explícitamente.
Utilice la función --fuerza
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 la alta disponibilidad y, a continuación, vuelva a habilitarla después de haber olvidado el host.
Este comando es útil si el host de XenServer que se va a “olvidar” está inactivo. Sin embargo, si el host de XenServer está activo y forma parte del grupo, utilice xe pool-eject
en lugar de.
host-get-server-certificate
xe host-get-server-certificate
<!--NeedCopy-->
Obtenga el certificado TLS del servidor instalado.
host-get-sm-diagnostics
xe host-get-sm-diagnostics uuid=uuid
<!--NeedCopy-->
Mostrar información de diagnóstico de SM por host.
host-get-system-status
xe host-get-system-status filename=name_for_status_file [entries=comma_separated_list] [output=tar.bz2|zip] [host-selector=host_selector_value...]
<!--NeedCopy-->
Descargue la información de estado del sistema en el archivo especificado. El parámetro opcional Entradas
es una lista separada por comas de entradas de estado del sistema, tomada del fragmento XML de capacidades devuelto por el host-get-system-status-capabilities
mandar. Para obtener más información, consulte host-get-system-status-capabilities. Si no se especifica, toda la información de estado del sistema se guarda en el archivo. El parámetro salida
Quizás tar.bz2 (el valor predeterminado) o cremallera. Si no se especifica este parámetro, el archivo se guarda en tar.bz2
forma.
Los hosts en los que se va a realizar esta operación se seleccionan utilizando el mecanismo de selección estándar (véase Selectores de host arriba).
host-get-system-status-capabilities
xe host-get-system-status-capabilities [host-selector=host_selector_value...]
<!--NeedCopy-->
Obtenga las capacidades de estado del sistema para los hosts especificados. Las capacidades se devuelven como un fragmento XML similar al ejemplo siguiente:
<?xml version="1.0" ?>
<system-status-capabilities>
<capability content-type="text/plain" default-checked="yes" key="xenserver-logs" \
max-size="150425200" max-time="-1" min-size="150425200" min-time="-1" \
pii="maybe"/>
<capability content-type="text/plain" default-checked="yes" \
key="xenserver-install" max-size="51200" max-time="-1" min-size="10240" \
min-time="-1" pii="maybe"/>
...
</system-status-capabilities>
<!--NeedCopy-->
Cada entidad de capacidad puede tener los siguientes atributos.
-
llave
Un identificador único para la capacidad. -
tipo-contenido
Puede ser texto/sin formato o aplicación/datos. Indica si una interfaz de usuario puede representar las entradas para el consumo humano. -
Activado por defecto
Puede ser sí o no. Indica si una interfaz de usuario selecciona esta entrada de forma predeterminada. -
tamaño mínimo
,tamaño máximo
Indica un intervalo aproximado para el tamaño, en bytes, de esta entrada. -1 indica que el tamaño no es importante. -
Tiempo mínimo
,Tiempo máximo
Indique un intervalo aproximado del tiempo, en segundos, que se tarda en recopilar esta entrada. -1 indica que el tiempo no es importante. -
IIP
Información de identificación personal. Indica si la entrada tiene información que pueda 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 -
Sí
: Es probable o seguro que la PII se encuentre en estas entradas -
quizás
: es posible que desee auditar estas entradas para PII -
if_customized
si los archivos no están modificados, no contienen PII. Sin embargo, dado que recomendamos la edición de estos archivos, es posible que la información de identificación personal se haya introducido mediante dicha personalización. Este valor se utiliza en particular para los scripts de red en el dominio de control.
Las contraseñas nunca deben incluirse en ningún informe de error, independientemente de cualquier declaración de PII.
-
Los hosts en los que se va a realizar esta operación se seleccionan utilizando el mecanismo de selección estándar (véase Selectores de host arriba).
host-get-thread-diagnostics
xe host-get-thread-diagnostics uuid=uuid
<!--NeedCopy-->
Mostrar información de diagnóstico de subprocesos por host.
host-get-vms-which-prevent-evacuation
xe host-get-vms-which-prevent-evacuation uuid=uuid
<!--NeedCopy-->
Devuelve una lista de máquinas virtuales que impiden la evacuación de un host específico y muestra los motivos de cada una.
host-is-in-emergency-mode
xe host-is-in-emergency-mode
<!--NeedCopy-->
Devuelve verdadero
si el host con el que se comunica la CLI está en modo de emergencia, falso
de otra manera. Este comando de la CLI funciona directamente en los hosts de los miembros del grupo, incluso sin la presencia de un coordinador del grupo.
host-license-view
xe host-license-view [host-uuid=host_uuid]
<!--NeedCopy-->
Muestra el contenido de la licencia de host de XenServer.
host-logs-download
xe host-logs-download [file-name=logfile_name] [host-selector=host_selector_value...]
<!--NeedCopy-->
Descargue una copia de los registros de los hosts de XenServer especificados. La copia se guarda de forma predeterminada en un archivo con marca de tiempo llamado hostname-aaaa-mm-dd T hh:mm:ssZ.tar.gz
. Puede especificar un nombre de archivo diferente mediante el parámetro opcional nombre-archivo.
Los hosts en los que se va a realizar esta operación se seleccionan utilizando el mecanismo de selección estándar (véase 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 el
xe host-logs-download
funciona si se ejecuta en el host local (es decir, sin un nombre de host específico especificado), haga lo siguiente no Úsalo de esta manera. Al hacerlo, se satura la partición del dominio de control con la copia de los registros. Utilice únicamente el comando de un equipo remoto fuera del host en el que tenga espacio para guardar la copia de los registros.
host-management-disable
xe host-management-disable
<!--NeedCopy-->
Deshabilita la escucha del agente de host en una interfaz de red de administración externa y desconecta todos los clientes de API conectados (como XenCenter). Este comando funciona directamente en el host de XenServer al que está conectada la CLI. El comando no se reenvía al coordinador del grupo cuando se aplica a un host XenServer miembro.
Advertencia:
Tenga cuidado al utilizar este comando de la CLI fuera del host. Una vez ejecutado este comando, no puede conectarse al dominio de control de forma remota a través de la red para volver a habilitar el agente host.
host-management-reconfigure
xe host-management-reconfigure [interface=device] [pif-uuid=uuid]
<!--NeedCopy-->
Reconfigura el host de XenServer 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 tecla MANAGEMENT_INTERFACE en /etc/xensource-inventory
.
Si se especifica el nombre del dispositivo de una interfaz (que debe tener una dirección IP), el host de XenServer se vuelve a enlazar inmediatamente. Este comando funciona tanto en modo normal como en modo de emergencia.
Si se especifica el UUID de un objeto PIF, el host de XenServer determina qué dirección IP se va a volver a enlazar a sí mismo. No debe estar en modo de emergencia cuando se ejecute este comando.
Advertencia:
Tenga cuidado al utilizar este comando de la CLI fuera del host y asegúrese de tener conectividad de red en la nueva interfaz. Uso
xe pif-reconfigure
para configurar uno primero. De lo contrario, los comandos posteriores de la CLI no podrán acceder al host de XenServer.
host-power-on
xe host-power-on [host=host_uuid]
<!--NeedCopy-->
Enciende la alimentación de los hosts de XenServer con el Encendido del host Función habilitada. Antes de usar este comando, habilite host-set-power-on
en el anfitrión.
host-reboot
xe host-reboot [host-selector=host_selector_value...]
<!--NeedCopy-->
Reinicie los hosts de XenServer especificados. Los hosts especificados deben deshabilitarse primero mediante el comando xe host-disable
comando, de lo contrario, un HOST_IN_USE
se muestra un mensaje de error.
Los hosts en los que se va a realizar esta operación se seleccionan utilizando el mecanismo de selección estándar (véase Selectores de host arriba). Los argumentos opcionales pueden ser cualquier número de los Parámetros de host enumerados al principio de esta sección.
Si los hosts de XenServer especificados son miembros de un grupo, se controla la pérdida de conectividad al apagarse y el grupo se recupera cuando vuelven los hosts de XenServer. Los demás miembros y el coordinador de la piscina siguen funcionando.
Si apaga el coordinador del grupo, el grupo estará fuera de servicio hasta que se produzca una de las siguientes acciones:
- Convierte a uno de los miembros en el coordinador del grupo
-
El coordinador de grupo original se reinicia y vuelve a estar en línea.
Cuando el coordinador del grupo vuelve a estar en línea, los miembros se vuelven a conectar y sincronizan con el coordinador del grupo.
host-restore
xe host-restore [file-name=backup_filename] [host-selector=host_selector_value...]
<!--NeedCopy-->
Restaurar una copia de seguridad denominada nombre-archivo
del software de control de host XenServer. 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 descomprimido en la partición secundaria. Después de haber hecho un xe host-restore
, debe iniciar el CD de instalación y usar su opción Restaurar desde copia de seguridad.
Los hosts en los que se va a realizar esta operación se seleccionan utilizando el mecanismo de selección estándar (véase 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
xe host-send-debug-keys host-uuid=host_uuid keys=keys
<!--NeedCopy-->
Envíe las claves de depuración del hipervisor especificadas al host especificado.
host-server-certificate-install
xe host-server-certificate-install certificate=path_to_certificate_file private-key=path_to_private_key [certificate-chain=path_to_chain_file] [host=host_name | uuid=host_uuid]
<!--NeedCopy-->
Instale un certificado TLS en un host de XenServer.
host-set-hostname-live
xe host-set-hostname-live host-uuid=uuid_of_host host-name=new_hostname
<!--NeedCopy-->
Cambie el nombre de host del host de XenServer especificado por host-uuid
. Este comando establece de forma persistente tanto el nombre de host en la base de datos del dominio de control como el nombre de host de Linux real del host de XenServer. El valor de nombre-host
es no lo mismo que el valor de la propiedad name_label
campo.
host-set-power-on-mode
xe host-set-power-on-mode host=host_uuid power-on-mode={"" | "wake-on-lan" | "IPMI" | "custom"} \
[ power-on-config:power_on_ip=ip-address power-on-config:power_on_user=user power-on-config:power_on_password_secret=secret-uuid ]
<!--NeedCopy-->
Úselo para habilitar la función Encendido del host en hosts XenServer que son compatibles con soluciones de alimentación remota. Al utilizar el método host-set-power-on
, debe especificar el tipo de solución de administración de energía en el host (es decir, el modo de encendido). A continuación, especifique las opciones de configuración mediante el argumento power-on-config y sus pares clave-valor asociados.
Para usar la función de secretos para almacenar su contraseña, especifique la clave "power_on_password_secret"
. Para obtener más información, consulte Secretos.
host-shutdown
xe host-shutdown [host-selector=host_selector_value...]
<!--NeedCopy-->
Apague los hosts de XenServer especificados. Los hosts de XenServer especificados deben inhabilitarse primero mediante el comando xe host-disable
comando, de lo contrario, un HOST_IN_USE
se muestra un mensaje de error.
Los hosts en los que se va a realizar esta operación se seleccionan utilizando el mecanismo de selección estándar (véase Selectores de host arriba). Los argumentos opcionales pueden ser cualquier número de los Parámetros de host enumerados al principio de esta sección.
Si los hosts de XenServer especificados son miembros de un grupo, se controla la pérdida de conectividad al apagarse y el grupo se recupera cuando vuelven los hosts de XenServer. Los demás miembros y el coordinador de la piscina siguen funcionando.
Si apaga el coordinador del grupo, el grupo estará fuera de servicio hasta que se produzca una de las siguientes acciones:
- Convierte a uno de los miembros en el coordinador del grupo
-
El coordinador de grupo original se reinicia y vuelve a estar en línea.
Cuando el coordinador del grupo vuelve a estar en línea, los miembros se vuelven a conectar y sincronizan con el coordinador del grupo.
Si HA está habilitado para el grupo, uno de los miembros se convierte automáticamente en coordinador del grupo. Si HA está inhabilitado, debe designar manualmente el host de XenServer deseado como coordinador del grupo con el pool-designate-new-master
mandar. Para obtener más información, consulte pool-designate-new-master.
host-sm-dp-destroy
xe host-sm-dp-destroy uuid=uuid dp=dp [allow-leak=true|false]
<!--NeedCopy-->
Intente destruir y limpiar una ruta de datos de almacenamiento en un host. Si permitir-fuga=verdadero
a continuación, elimina todos los registros de la ruta de datos, incluso si no se cierra limpiamente.
host-sync-data
xe host-sync-data
<!--NeedCopy-->
Sincronice los datos almacenados en el coordinador del grupo con el host designado. Esto no incluye los datos de la base de datos).
host-syslog-reconfigure
xe host-syslog-reconfigure [host-selector=host_selector_value...]
<!--NeedCopy-->
Vuelva a configurar el syslog
demonio en los hosts de XenServer especificados. Este comando aplica la información de configuración definida en el host Registro
parámetro.
Los hosts en los que se va a realizar esta operación se seleccionan utilizando el mecanismo de selección estándar (véase 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
xe host-data-source-list [host-selectors=host selector value...]
<!--NeedCopy-->
Enumere las fuentes de datos que se pueden registrar para un host.
Seleccione los hosts en los que desea realizar esta operación utilizando el mecanismo de selección estándar (consulte Selectores de host). Los argumentos opcionales pueden ser cualquier número de los Parámetros de host enumerados al principio de esta sección. Si no se proporcionan parámetros para seleccionar hosts, la operación se realiza en todos los hosts.
Las fuentes de datos tienen dos parámetros: estándar
y Habilitado
. Este comando genera los valores de los parámetros:
- Si una fuente de datos tiene
Habilitado
Establézcalo enverdadero
, las métricas se están registrando actualmente en la base de datos de rendimiento. - Si una fuente de datos tiene
estándar
Establézcalo enverdadero
, las métricas se registran en la base de datos de rendimiento De forma predeterminada. El valor deHabilitado
también se establece enverdadero
para esta fuente de datos. - Si una fuente de datos tiene
estándar
Establézcalo enfalso
, las métricas son no registrado en la base de datos de rendimiento de forma predeterminada. El valor deHabilitado
también se establece enfalso
para esta fuente de datos.
Para empezar a registrar métricas de origen de datos en la base de datos de rendimiento, ejecute el comando registro-fuente-de-datos-host
mandar. Este comando establece Habilitado
Para verdadero
. Para detenerse, ejecute el comando host-data-source-forget
. Este comando establece Habilitado
Para falso
.
host-data-source-record
xe host-data-source-record data-source=name_description_of_data_source [host-selectors=host_selector_value...]
<!--NeedCopy-->
Registre la fuente de datos especificada para un host.
Esta operación escribe la información del origen de datos en la base de datos de métricas de rendimiento persistente de los hosts especificados. Por razones de rendimiento, esta base de datos es distinta de la base de datos de agente normal.
Seleccione los hosts en los que desea realizar esta operación utilizando el mecanismo de selección estándar (consulte Selectores de host). Los argumentos opcionales pueden ser cualquier número de los Parámetros de host enumerados al principio de esta sección. Si no se proporcionan parámetros para seleccionar hosts, la operación se realiza en todos los hosts.
host-data-source-forget
xe host-data-source-forget data-source=name_description_of_data_source [host-selectors=host_selector_value...]
<!--NeedCopy-->
Detenga la grabación de la fuente de datos especificada para un host y olvide todos los datos grabados.
Seleccione los hosts en los que desea realizar esta operación utilizando el mecanismo de selección estándar (consulte Selectores de host). Los argumentos opcionales pueden ser cualquier número de los Parámetros de host enumerados al principio de esta sección. Si no se proporcionan parámetros para seleccionar hosts, la operación se realiza en todos los hosts.
host-data-source-query
xe host-data-source-query data-source=name_description_of_data_source [host-selectors=host_selector_value...]
<!--NeedCopy-->
Muestra la fuente de datos especificada para un host.
Seleccione los hosts en los que desea realizar esta operación utilizando el mecanismo de selección estándar (consulte Selectores de host). Los argumentos opcionales pueden ser cualquier número de los Parámetros de host enumerados al principio de esta sección. Si no se proporcionan parámetros para seleccionar hosts, la operación se realiza en todos los hosts.
Comandos de mensaje
Comandos para trabajar con mensajes. Los mensajes se crean para notificar a los usuarios de eventos importantes y se muestran en XenCenter como alertas.
Los objetos de mensaje se pueden listar con el comando estándar de listado de objetos (xe lista de mensajes
), 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 del parámetro | Descripción | Tipo |
---|---|---|
uuid |
El identificador único/referencia de objeto para el mensaje | Solo lectura |
name |
El nombre único del mensaje | Solo lectura |
priority |
La prioridad del mensaje. Los números más altos indican una mayor prioridad | Solo lectura |
class |
La clase message, por ejemplo, VM. | Solo lectura |
obj-uuid |
El uuid del objeto afectado. | Solo lectura |
timestamp |
La hora a la que se generó el mensaje. | Solo lectura |
body |
El contenido del mensaje. | Solo lectura |
message-create
xe message-create name=message_name body=message_text [[host-uuid=uuid_of_host] | [sr-uuid=uuid_of_sr] | [vm-uuid=uuid_of_vm] | [pool-uuid=uuid_of_pool]]
<!--NeedCopy-->
Crea un mensaje.
message-destroy
xe message-destroy [uuid=message_uuid]
<!--NeedCopy-->
Destruye un mensaje existente. Puede crear un script para destruir todos los mensajes. Por ejemplo:
# Dismiss all alerts \
IFS=","; for m in $(xe message-list params=uuid --minimal); do \
xe message-destroy uuid=$m \
done
<!--NeedCopy-->
Comandos de red
Comandos para trabajar con redes.
Los objetos de red se pueden listar con el comando estándar de listado de objetos (xe lista-de-red
), 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 del parámetro | Descripción | Tipo |
---|---|---|
uuid |
El identificador único/referencia de objeto para la red | Solo lectura |
name-label |
El nombre de la red | Lectura/escritura |
name-description |
El texto descriptivo de la red | Lectura/escritura |
VIF-uuids |
Una lista de identificadores únicos de las VIF (interfaces de red virtual) que se conectan desde las máquinas virtuales a esta red | Parámetro de conjunto de solo lectura |
PIF-uuids |
Una lista de identificadores únicos de los PIF (interfaces de red físicas) que se conectan desde los hosts de XenServer a esta red | Parámetro de conjunto de solo lectura |
bridge |
Nombre del puente correspondiente a esta red en el host local de XenServer | Solo lectura |
default-locking-mode |
Objeto de red utilizado con objetos VIF para el filtrado ARP. Establézcalo en Desbloqueado para eliminar todas las reglas de filtrado asociadas con el VIF. Establézcalo en Deshabilitado por lo tanto, el VIF descarta todo el tráfico. |
Lectura/escritura |
purpose |
Conjunto de propósitos para los que el host de XenServer utiliza esta red. Establézcalo en NBD para utilizar la red para realizar conexiones NBD. |
Lectura/escritura |
other-config:staticroutes |
Lista separada por comas de subred/Máscara de red/entrada Entradas formateadas que especifican la dirección de puerta de enlace a través de la cual se enrutan las subredes. Por ejemplo, la configuración other-config:rutas-estáticas a 172.16.0.0/15/192.168.0.3,172.18.0.0/16/192.168.0.4 hace que el tráfico de 172.16.0.0/15 se enrute a través de 192.168.0.3 y el tráfico de 172.18.0.0/16 se enrute a través de 192.168.0.4. |
Lectura/escritura |
other-config:ethtoolautoneg |
Establézcalo 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 |
Establézcalo en activado para habilitar la suma de comprobación de recepción, desactivado para deshabilitar | Lectura/escritura |
other-config:ethtool-tx |
Establézcalo en activado para habilitar la suma de comprobación de transmisión, desactivado para deshabilitarlo | Lectura/escritura |
other-config:ethtool-sg |
Establézcalo en activado para habilitar la recolección de dispersión, desactivado para deshabilitar | Lectura/escritura |
other-config:ethtool-tso |
Establézcalo en activado para habilitar la descarga de segmentación TCP, desactivado para deshabilitar | Lectura/escritura |
other-config:ethtool-ufo |
Establézcalo en activado para habilitar la descarga de fragmentos UDP, desactivado para deshabilitar | Lectura/escritura |
other-config:ethtool-gso |
Establézcalo en activado para habilitar la descarga de segmentación genérica, desactivado para deshabilitar | Lectura/escritura |
blobs |
Almacén de datos binarios | Solo lectura |
network-create
xe network-create name-label=name_for_network [name-description=descriptive_text]
<!--NeedCopy-->
Crea una red.
network-destroy
xe network-destroy uuid=network_uuid
<!--NeedCopy-->
Destruye una red existente.
Comandos SR-IOV
Comandos para trabajar con SR-IOV.
El red-sriov
Los objetos se pueden enumerar con el comando estándar de listado 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 de SR-IOV
SR-IOV tiene los siguientes parámetros:
Nombre del parámetro | Descripción | Tipo |
---|---|---|
physical-PIF |
El PIF para habilitar SR-IOV. | Solo lectura |
logical-PIF |
Un PIF lógico de SR-IOV. Los usuarios pueden utilizar este parámetro para crear una red VLAN SR-IOV. | Solo lectura |
requires-reboot |
Si se establece en True, se usa para reiniciar el host para que entre en vigor la habilitación de SR-IOV. | Solo lectura |
remaining-capacity |
Número de VF disponibles restantes. | Solo lectura |
network-sriov-create
xe network-sriov-create network-uuid=network_uuid pif-uuid=physical_pif_uuid
<!--NeedCopy-->
Crea un objeto de red SR-IOV para un PIF físico determinado y habilita SR-IOV en el PIF físico.
network-sriov-destroy
xe network-sriov-destroy uuid=network_sriov_uuid
<!--NeedCopy-->
Quita un objeto SR-IOV de red y deshabilita SR-IOV en su PIF físico.
Asignación de un SR-IOV VF
xe vif-create device=device_index mac=vf_mac_address network-uuid=sriov_network vm-uuid=vm_uuid
<!--NeedCopy-->
Asigna una VF de una red SR-IOV a una máquina virtual.
Comandos del controlador SDN
Comandos para trabajar con el controlador SDN.
sdn-controller-forget
xe sdn-controller-introduce [address=address] [protocol=protocol] [tcp-port=tcp_port]
<!--NeedCopy-->
Introducción de un controlador SDN.
sdn-controller-introduce
xe sdn-controller-forget uuid=uuid
<!--NeedCopy-->
Retire un controlador SDN.
Comandos de túnel
Comandos para trabajar con túneles.
tunnel-create
xe tunnel-create pif-uuid=pif_uuid network-uuid=network_uuid
<!--NeedCopy-->
Cree un nuevo túnel en un host.
tunnel-destroy
xe tunnel-destroy uuid=uuid
<!--NeedCopy-->
Destruye un túnel.
Comandos de parches
Comandos para trabajar con parches.
patch-apply
xe patch-apply uuid=patch_uuid host-uuid=host_uuid
<!--NeedCopy-->
Aplique el parche cargado anteriormente al host especificado.
patch-clean
xe patch-clean uuid=uuid
<!--NeedCopy-->
Elimine un archivo de parche cargado anteriormente.
patch-destroy
xe patch-destroy uuid=uuid
<!--NeedCopy-->
Elimine un registro de parche y archivos no aplicados del host.
patch-pool-apply
xe patch-pool-apply uuid=uuid
<!--NeedCopy-->
Aplique el parche cargado anteriormente a todos los hosts del grupo.
patch-pool-clean
xe patch-pool-clean uuid=uuid
<!--NeedCopy-->
Elimine un archivo de parche cargado anteriormente en todos los hosts del grupo.
patch-precheck
xe patch-precheck uuid=uuid host-uuid=host_uuid
<!--NeedCopy-->
Ejecute las comprobaciones previas contenidas en el parche cargado previamente en el host especificado.
patch-upload
xe patch-upload file-name=file_name
<!--NeedCopy-->
Cargue un archivo de parche en el host.
Comandos PBD
Comandos para trabajar con PBDs (Dispositivos de Bloque Físico). Los PBD son los objetos de software a través de los cuales el host de XenServer accede a los repositorios de almacenamiento (SR).
Los objetos PBD se pueden enumerar con el comando estándar de listado de objetos (xe pbd-list
), y los parámetros manipulados con los comandos de parámetros estándar. Para obtener más información, consulte Comandos de parámetros de bajo nivel
Parámetros de PBD
Los PBD tienen los siguientes parámetros:
Nombre del parámetro | Descripción | Tipo |
---|---|---|
uuid |
El identificador único/referencia de objeto para el PBD. | Solo lectura |
sr-uuid |
El repositorio de almacenamiento al que apunta el PBD | Solo lectura |
device-config |
Información de configuración adicional que se proporciona al controlador SR-backend de un host | Parámetro de mapa de solo lectura |
currently-attached |
True si el SR está conectado en este host, False en caso contrario | Solo lectura |
host-uuid |
UUID de la máquina física en la que está disponible el PBD | Solo lectura |
host |
El campo host está en desuso. En su lugar, use host_uuid. | Solo lectura |
other-config |
Información adicional de configuración. | Parámetro de mapa de lectura/escritura |
pbd-create
xe pbd-create host-uuid=uuid_of_host sr-uuid=uuid_of_sr [device-config:key=corresponding_value]
<!--NeedCopy-->
Cree un PBD en el host de XenServer. El método de solo lectura configuración-dispositivo
El parámetro solo se puede establecer en la creación.
Para agregar una asignación de ‘ruta’ a ‘/tmp’, asegúrese de que la línea de comandos contenga el argumento device-config:path=/tmp
Para obtener una lista completa de los pares clave/valor de device-config admitidos en cada tipo de SR, consulte Almacenamiento.
pbd-destroy
xe pbd-destroy uuid=uuid_of_pbd
<!--NeedCopy-->
Destruya el PBD especificado.
pbd-plug
xe pbd-plug uuid=uuid_of_pbd
<!--NeedCopy-->
Intenta conectar el PBD al host de XenServer. Si este comando se ejecuta correctamente, el SR al que se hace referencia (y los VDI que contiene) pasa a ser visible para el host de XenServer.
pbd-unplug
xe pbd-unplug uuid=uuid_of_pbd
<!--NeedCopy-->
Intente desconectar el PBD del host de XenServer.
Comandos PIF
Comandos para trabajar con PIF (objetos que representan las interfaces de red físicas).
Los objetos PIF se pueden listar con el comando estándar de listado de objetos (Lista de pifs xe
), y los parámetros manipulados con los comandos de parámetros estándar. Para obtener más información, consulte Comandos de parámetros de bajo nivel
Parámetros PIF
Los PIF tienen los siguientes parámetros:
Nombre del parámetro | Descripción | Tipo |
---|---|---|
uuid |
El identificador único/referencia de objeto para el PIF | Solo lectura |
device machine-readable |
Nombre de la interfaz (por ejemplo, eth0) | Solo lectura |
MAC |
La dirección MAC del PIF | Solo lectura |
other-config |
Configuración PIF adicional nombre:valor Pares. |
Parámetro de mapa de lectura/escritura |
physical |
Si es true, el PIF apunta a una interfaz de red física real | Solo lectura |
currently-attached |
¿Está el PIF actualmente conectado en este host? true o false
|
Solo lectura |
MTU |
Unidad máxima de transmisión del PIF en bytes. | Solo lectura |
VLAN |
VLAN para todo el tráfico que pasa a través de esta interfaz. -1 indica que no se ha asignado ninguna etiqueta VLAN | Solo lectura |
bond-master-of |
El UUID del enlace este PIF es la interfaz principal de (si la hay) | Solo lectura |
bond-slave-of |
El UUID del bono del que forma parte este PIF (si lo hay) | Solo lectura |
management |
¿Está este PIF designado para ser una interfaz de administración para el dominio de control? | Solo lectura |
network-uuid |
Identificador único/referencia de objeto de la red virtual a la que está conectado este PIF | Solo lectura |
network-name-label |
Nombre de la red virtual a la que está conectado este PIF | Solo lectura |
host-uuid |
El identificador único/referencia de objeto del host XenServer al que está conectado este PIF | Solo lectura |
host-name-label |
El nombre del host XenServer al que está conectado este PIF | Solo lectura |
IP-configuration-mode |
Tipo de configuración de dirección de red utilizada; DHCP o estático | Solo lectura |
IP |
Dirección IP del PIF. Se define aquí cuando el modo de configuración IP es estático; undefined cuando DHCP | Solo lectura |
netmask |
Máscara de red del PIF. Se define aquí cuando el modo de configuración IP es estático; undefined cuando es suministrado por DHCP | Solo lectura |
gateway |
Dirección de puerta de enlace del PIF. Se define aquí cuando el modo de configuración IP es estático; undefined cuando es suministrado por DHCP | Solo lectura |
DNS |
Dirección DNS del PIF. Se define aquí cuando el modo de configuración IP es estático; undefined cuando es suministrado por DHCP | Solo lectura |
io_read_kbs |
Velocidad media de lectura en kB/s para el dispositivo | Solo lectura |
io_write_kbs |
Velocidad media de escritura en kB/s para el dispositivo | Solo lectura |
carrier |
Estado de enlace para este dispositivo | Solo lectura |
vendor-id |
El ID asignado al proveedor de NIC | Solo lectura |
vendor-name |
El nombre del proveedor de NIC | Solo lectura |
device-id |
El identificador asignado por el proveedor a este modelo de NIC | Solo lectura |
device-name |
El nombre asignado por el proveedor a este modelo de NIC | Solo lectura |
speed |
Velocidad de transferencia de datos de la NIC | Solo lectura |
duplex |
Modo dúplex de la NIC; Completo o medio | Solo lectura |
pci-bus-path |
Dirección de ruta de bus PCI | Solo lectura |
other-config:ethtoolspeed |
Establece la velocidad de conexión en Mbps | Lectura/escritura |
other-config:ethtoolautoneg |
Establézcalo 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 dúplex del PIF, ya sea completo o parcial. | Lectura/escritura |
other-config:ethtool-rx |
Establézcalo en activado para habilitar la suma de comprobación de recepción, desactivado para deshabilitar | Lectura/escritura |
other-config:ethtool-tx |
Establézcalo en activado para habilitar la suma de comprobación de transmisión, desactivado para deshabilitarlo | Lectura/escritura |
other-config:ethtool-sg |
Establézcalo en activado para habilitar la recolección de dispersión, desactivado para deshabilitar | Lectura/escritura |
other-config:ethtool-tso |
Establézcalo en activado para habilitar la descarga de segmentación TCP, desactivado para deshabilitar | Lectura/escritura |
other-config:ethtool-ufo |
Establézcalo en activado para habilitar la descarga de fragmentos UDP, desactivado para deshabilitar | Lectura/escritura |
other-config:ethtool-gso |
Establézcalo en activado para habilitar la descarga de segmentación genérica, desactivado para deshabilitar | Lectura/escritura |
other-config:domain |
Lista separada por comas que se utiliza para establecer la ruta de búsqueda de DNS | Lectura/escritura |
other-config:bondmiimon |
Intervalo entre comprobaciones de actividad de enlace, en milisegundos | Lectura/escritura |
other-config:bonddowndelay |
Número de milisegundos que se deben esperar después de que se pierde el enlace antes de considerar realmente que el enlace se ha ido. Este parámetro permite la pérdida transitoria del enlace | Lectura/escritura |
other-config:bondupdelay |
Número de milisegundos que hay que esperar después de que aparezca el enlace antes de considerarlo realmente. Permite que los enlaces se agiten hacia arriba. El valor predeterminado es 31 años para dar tiempo a que los switches comiencen a reenviar el tráfico. |
Lectura/escritura |
disallow-unplug |
True si este PIF es una NIC de almacenamiento dedicada, false en caso contrario | Lectura/escritura |
Nota: No
Los cambios realizados en el archivo
otra-configuración
Los campos de un PIF solo surtirán efecto después de un reinicio. Como alternativa, utilice el métodoXE PIF-Desenchufe
yEnchufe PIF XE
para hacer que se reescriba la configuración PIF.
pif-forget
xe pif-forget uuid=uuid_of_pif
<!--NeedCopy-->
Destruya el objeto PIF especificado en un host determinado.
pif-introduce
xe pif-introduce host-uuid=host_uuid mac=mac_address_for_pif device=interface_name
<!--NeedCopy-->
Cree un objeto PIF que represente una interfaz física en el host de XenServer especificado.
pif-plug
xe pif-plug uuid=uuid_of_pif
<!--NeedCopy-->
Intente abrir la interfaz física especificada.
pif-reconfigure-ip
xe pif-reconfigure-ip uuid=uuid_of_pif [mode=dhcp|mode=static] gateway=network_gateway_address IP=static_ip_for_this_pif netmask=netmask_for_this_pif [DNS=dns_address]
<!--NeedCopy-->
Modifique la dirección IP del PIF. Para la configuración de IP estática, establezca el parámetro modo
parámetro a estático
, con el entrada
, IP
y Máscara de red
parámetros establecidos en los valores adecuados. Para usar DHCP, establezca el parámetro modo
parámetro a DHCP
y deje los parámetros estáticos sin definir.
Nota: No
El uso de direcciones IP estáticas en interfaces de red físicas conectadas a un puerto en 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
xe pif-reconfigure-ipv6 uuid=uuid_of_pif mode=mode [gateway=network_gateway_address] [IPv6=static_ip_for_this_pif] [DNS=dns_address]
<!--NeedCopy-->
Vuelva a configurar la configuración de la dirección IPv6 en un PIF.
pif-scan
xe pif-scan host-uuid=host_uuid
<!--NeedCopy-->
Busque nuevas interfaces físicas en el host de XenServer.
pif-set-primary-address-type
xe pif-set-primary-address-type uuid=uuid primary_address_type=address_type
<!--NeedCopy-->
Cambie el tipo de dirección principal utilizada por este PIF.
pif-unplug
xe pif-unplug uuid=uuid_of_pif
<!--NeedCopy-->
Intente desactivar la interfaz física especificada.
Comandos de grupo
Comandos para trabajar con grupos. Un piscina es un agregado de uno o más hosts de XenServer. Un grupo utiliza uno o varios 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 aún se está ejecutando, sin necesidad de apagarla y volver a activarla.
Cada host de XenServer es en realidad un grupo que consta de un solo miembro de forma predeterminada. Cuando el host de XenServer se une a un grupo, se designa como miembro. Si el grupo al que se une el host consta de un solo miembro, ese miembro se convierte en el coordinador del grupo. Si el grupo al que está unido el host ya tiene varios miembros, uno de estos miembros ya es el coordinador del grupo y seguirá siéndolo cuando el nuevo anfitrión se una al 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 de la piscina
Los grupos tienen los siguientes parámetros:
Nombre del parámetro | Descripción | Tipo |
---|---|---|
uuid |
El identificador único/referencia de objeto para el grupo | Solo lectura |
name-label |
El nombre de la piscina | Lectura/escritura |
name-description |
La cadena de descripción del grupo | Lectura/escritura |
master |
El identificador único/referencia de objeto del host de XenServer designado como coordinador del grupo | Solo lectura |
default-SR |
El identificador único/referencia de objeto del SR predeterminado para el grupo | Lectura/escritura |
crash-dump-SR |
El identificador único/referencia de objeto del SR donde se guardan los volcados de memoria para los miembros del grupo | Lectura/escritura |
metadata-vdis |
Todas las VDI de metadatos conocidas para el grupo | Solo lectura |
suspend-image-SR |
Identificador único/referencia de objeto del SR donde se guardan las máquinas virtuales suspendidas en los miembros del grupo | Lectura/escritura |
other-config |
Una lista de pares clave-valor que especifican parámetros de configuración adicionales para el grupo | Parámetro de mapa de lectura/escritura |
other-config:default_ha_timeout |
Tiempo de espera de alta disponibilidad en segundos. | Lectura/escritura |
supported-sr-types |
Tipos de SR que puede usar este grupo | Solo lectura |
ha-enabled |
True si HA está habilitado para el grupo, false en caso contrario | Solo lectura |
ha-configuration |
Reservado para uso futuro. | Solo lectura |
ha-statefiles |
Enumera los UUID de los VDI que utiliza HA para determinar el estado del almacenamiento | Solo lectura |
ha-host-failures-to-tolerate |
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 errores de host que realmente se pueden manejar, de acuerdo con los cálculos del algoritmo de alta disponibilidad | Solo lectura |
ha-allow-overcommit |
True si se permite que el grupo se comprometa en exceso, False en caso contrario | Lectura/escritura |
ha-overcommitted |
True si el grupo está sobrecomprometido | Solo lectura |
blobs |
Almacén de datos binarios | Solo lectura |
live-patching-disabled |
Establézcalo en False para habilitar la aplicación de parches en vivo. Establézcalo en True para deshabilitar la aplicación de parches en vivo. | Lectura/escritura |
igmp-snooping-enabled |
Establézcalo en True para habilitar la indagación IGMP. Establézcalo en False para deshabilitar la indagación IGMP. | Lectura/escritura |
https-only |
Establézcalo en Falso para permitir que los clientes externos que utilizan la API de administración se conecten a XenServer mediante HTTPS a través del puerto 443 o HTTP a través del puerto 80. Establézcalo en True para bloquear el puerto 80 y requerir que los clientes se conecten exclusivamente mediante HTTPS a través del puerto 443. | Lectura/escritura |
migration-compression |
Establézcalo en True para habilitar la compresión de secuencias de migración para el grupo de XenServer. Establézcalo en False para deshabilitar la compresión del flujo de migración. El valor predeterminado es False. Puede ser anulado por vm-migrate de los comandos comprimir parámetro. |
Lectura/escritura |
pool-apply-edition
xe pool-apply-edition edition=edition [uuid=uuid] [license-server-address=address] [license-server-port=port]
<!--NeedCopy-->
Aplique una edición en todo el grupo.
pool-certificate-install
xe pool-certificate-install filename=file_name
<!--NeedCopy-->
Instale un certificado TLS en todo el grupo.
pool-certificate-list
xe pool-certificate-list
<!--NeedCopy-->
Enumere todos los certificados TLS instalados en un grupo.
pool-certificate-sync
xe pool-certificate-sync
<!--NeedCopy-->
Sincronice los certificados TLS y las listas de revocación de certificados del coordinador del grupo con los demás miembros del grupo.
pool-certificate-uninstall
xe pool-certificate-uninstall name=name
<!--NeedCopy-->
Desinstalar un certificado TLS.
pool-crl-install
xe pool-crl-install filename=file_name
<!--NeedCopy-->
Instale una lista de revocación de certificados TLS, en todo el grupo.
pool-crl-list
xe pool-crl-list
<!--NeedCopy-->
Enumere todas las listas de revocación de certificados TLS instaladas.
pool-crl-uninstall
xe pool-crl-uninstall name=name
<!--NeedCopy-->
Desinstalar una lista de revocación de certificados TLS.
pool-deconfigure-wlb
xe pool-deconfigure-wlb
<!--NeedCopy-->
Elimine permanentemente la configuración para el equilibrio de la carga de trabajo.
pool-designate-new-master
xe pool-designate-new-master host-uuid=uuid_of_new_master
<!--NeedCopy-->
Indique al host de XenServer miembro especificado que se convierta en el coordinador (anteriormente denominado “maestro”) de un grupo existente. Este comando realiza un traspaso ordenado de la función de coordinador del grupo a otro host del grupo de recursos. Este comando solo funciona cuando el coordinador del grupo 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
xe pool-disable-external-auth [uuid=uuid] [config=config]
<!--NeedCopy-->
Deshabilita la autenticación externa en todos los hosts de un grupo.
pool-disable-local-storage-caching
xe pool-disable-local-storage-caching uuid=uuid
<!--NeedCopy-->
Deshabilite el almacenamiento en caché de almacenamiento local en el grupo.
pool-disable-redo-log
xe pool-disable-redo-log
<!--NeedCopy-->
Deshabilite el registro de puesta al día si está en uso, a menos que HA esté habilitado.
pool-dump-database
xe pool-dump-database file-name=filename_to_dump_database_into_(on_client)
<!--NeedCopy-->
Descargue una copia de toda la base de datos del grupo y volque en un archivo en el cliente.
pool-enable-external-auth
xe pool-enable-external-auth auth-type=auth_type service-name=service_name [uuid=uuid] [config:=config]
<!--NeedCopy-->
Habilita la autenticación externa en todos los hosts de un grupo. Tenga en cuenta que algunos valores de Tipo de autenticación
requerirá un Configuración:
valores.
pool-enable-local-storage-caching
xe pool-enable-local-storage-caching uuid=uuid
<!--NeedCopy-->
Habilite el almacenamiento en caché de almacenamiento local en todo el grupo.
pool-enable-redo-log
xe pool-ensable-redo-log sr-uuid=sr_uuid
<!--NeedCopy-->
Habilite el registro de puesta al día en el SR especificado si está en uso, a menos que HA esté habilitado.
pool-eject
xe pool-eject host-uuid=uuid_of_host_to_eject
<!--NeedCopy-->
Indique al host de XenServer especificado que abandone un grupo existente.
pool-emergency-reset-master
xe pool-emergency-reset-master master-address=address_of_pool_master
<!--NeedCopy-->
Indique a un host miembro del grupo que restablezca su dirección de coordinador del grupo al nuevo valor e intente conectarse a él. No ejecute este comando en coordinadores de grupo.
pool-emergency-transition-to-master
xe pool-emergency-transition-to-master
<!--NeedCopy-->
Indique a un host de XenServer miembro que se convierta en el coordinador del grupo (anteriormente denominado “el maestro del grupo”). El host de XenServer acepta este comando solo 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 coordinador ha desaparecido de la red y no se puede contactar después de un cierto número de reintentos.
Si la contraseña del host se ha modificado desde que el host se unió al grupo, este comando puede hacer que se restablezca la contraseña del host. Para obtener más información, consulte (Comandos de usuario).
pool-ha-enable
xe pool-ha-enable heartbeat-sr-uuids=uuid_of_heartbeat_sr
<!--NeedCopy-->
Habilite la alta disponibilidad en el grupo de recursos, utilizando el UUID de SR especificado como repositorio de latidos de almacenamiento central.
pool-ha-disable
xe pool-ha-disable
<!--NeedCopy-->
Deshabilita la característica de alta disponibilidad en el grupo de recursos.
pool-ha-compute-hypothetical-max-host-failures-to-tolerate
Calcule el número máximo de errores de host que se tolerarán en la configuración actual del grupo.
pool-ha-compute-max-host-failures-to-tolerate
xe pool-ha-compute-hypothetical-max-host-failures-to-tolerate [vm-uuid=vm_uuid] [restart-priority=restart_priority]
<!--NeedCopy-->
Calcule el número máximo de errores de host que se tolerarán con las máquinas virtuales protegidas proporcionadas y propuestas.
pool-initialize-wlb
xe pool-initialize-wlb wlb_url=url wlb_username=wlb_username wlb_password=wlb_password xenserver_username=username xenserver_password=password
<!--NeedCopy-->
Inicialice el equilibrio de carga de trabajo para el grupo actual con el servidor de equilibrio de carga de trabajo de destino.
pool-join
xe pool-join master-address=address master-username=username master-password=password
<!--NeedCopy-->
Indique al host de XenServer que se una a un grupo existente.
pool-management-reconfigure
xe pool-management-reconfigure [network-uuid=network-uuid]
<!--NeedCopy-->
Reconfigura la interfaz de administración de todos los hosts del grupo para que utilicen la interfaz de red especificada, que es la interfaz que se utiliza para conectarse al XenCenter. El comando reescribe la tecla MANAGEMENT_INTERFACE en /etc/xensource-inventory
para todos los anfitriones de la piscina.
Si se especifica el nombre de dispositivo de una interfaz (que debe tener una dirección IP), el coordinador del grupo de XenServer se vuelve a enlazar inmediatamente. Este comando funciona tanto en modo normal como en modo de emergencia.
A partir del UUID de red especificado, el UUID del objeto PIF se identifica y se asigna al host de XenServer, que determina la dirección IP que se va a volver a enlazar a sí mismo. No debe estar en modo de emergencia cuando se ejecute este comando.
Advertencia:
Tenga cuidado al utilizar este comando de la CLI fuera del host y asegúrese de tener conectividad de red en la nueva interfaz. Uso
xe pif-reconfigure
para configurar uno primero. De lo contrario, los comandos posteriores de la CLI no podrán acceder al host de XenServer.
pool-recover-slaves
xe pool-recover-slaves
<!--NeedCopy-->
Indique al coordinador del grupo que intente restablecer la dirección de todos los miembros que se están ejecutando actualmente en modo de emergencia. Este comando se utiliza normalmente después de pool-emergency-transition-to-master
se ha utilizado para establecer a uno de los miembros como el nuevo coordinador del grupo.
pool-restore-database
xe pool-restore-database file-name=filename_to_restore_from_on_client [dry-run=true|false]
<!--NeedCopy-->
Cargue una copia de seguridad de la base de datos (creada con base de datos-de-volcado-de-pool
) a una piscina. Al recibir la carga, el coordinador del grupo se reinicia con la nueva base de datos.
También hay un Ejecución en seco , que le permite comprobar que la base de datos del grupo se puede restaurar sin realizar realmente la operación. De forma predeterminada, Funcionamiento en seco
se establece en false.
pool-retrieve-wlb-configuration
xe pool-retrieve-wlb-configuration
<!--NeedCopy-->
Recupera los criterios de optimización del grupo del servidor de equilibrio de carga de trabajo.
pool-retrieve-wlb-diagnostics
xe pool-retrieve-wlb-diagnostics [filename=file_name]
<!--NeedCopy-->
Recupera diagnósticos del servidor de equilibrio de carga de trabajo.
pool-retrieve-wlb-recommendations
xe pool-retrieve-wlb-recommendations
<!--NeedCopy-->
Recupera las recomendaciones de migración de máquinas virtuales para el grupo del servidor de equilibrio de carga de trabajo.
pool-retrieve-wlb-report
xe pool-retrieve-wlb-report report=report [filename=file_name]
<!--NeedCopy-->
Recupera informes del servidor de equilibrio de carga de trabajo.
pool-secret-rotate
xe pool-secret-rotate
<!--NeedCopy-->
Gire el secreto del grupo.
El secreto de grupo es un secreto compartido entre los hosts de XenServer de un grupo que permite al host demostrar su pertenencia a un grupo. Los usuarios con el rol de administrador de grupo pueden ver este secreto cuando se conectan al host a través de SSH. Rotar el secreto del grupo si uno de estos usuarios abandona la organización o pierde su rol de administrador del grupo.
pool-send-test-post
xe pool-send-test-post dest-host=destination_host dest-port=destination_port body=post_body
<!--NeedCopy-->
Envíe el cuerpo dado al host y puerto dados, usando HTTPS, e imprima la respuesta. Se utiliza para depurar la capa TLS.
pool-send-wlb-configuration
xe pool-send-wlb-configuration [config:=config]
<!--NeedCopy-->
Establece los criterios de optimización del grupo para el servidor de equilibrio de carga de trabajo.
pool-sync-database
xe pool-sync-database
<!--NeedCopy-->
Forzar la sincronización de la base de datos del grupo en todos los hosts del grupo de recursos. Este comando no es necesario en el funcionamiento normal, ya que la base de datos se replica automáticamente regularmente. Sin embargo, el comando puede ser útil para garantizar que los cambios se repliquen rápidamente después de realizar un conjunto significativo de operaciones de la CLI.
Poner Solo https
xe pool-param-set [uuid=pool-uuid] [https-only=true|false]
<!--NeedCopy-->
Habilita o inhabilita el bloqueo del puerto 80 en la interfaz de administración de los hosts de XenServer.
Comandos del acelerador PVS
Comandos para trabajar con el Acelerador PVS.
pvs-cache-storage-create
xe pvs-cache-storage-create sr-uuid=sr_uuid pvs-site-uuid=pvs_site_uuid size=size
<!--NeedCopy-->
Configure una caché PVS en un SR determinado para un host determinado.
pvs-cache-storage-destroy
xe pvs-cache-storage-destroy uuid=uuid
<!--NeedCopy-->
Eliminar una caché PVS.
pvs-proxy-create
xe pvs-proxy-create pvs-site-uuid=pvs_site_uuid vif-uuid=vif_uuid
<!--NeedCopy-->
Configure una máquina virtual/VIF para usar un proxy PVS.
pvs-proxy-destroy
xe pvs-proxy-destroy uuid=uuid
<!--NeedCopy-->
Quite (o desactive) un proxy PVS para esta VIF/VM.
pvs-server-forget
xe pvs-server-forget uuid=uuid
<!--NeedCopy-->
Olvídese de un servidor PVS.
pvs-server-introduce
xe pvs-server-introduce addresses=adresses first-port=first_port last-port=last_port pvs-site-uuid=pvs_site_uuid
<!--NeedCopy-->
Presentamos el nuevo servidor PVS.
pvs-site-forget
xe pvs-site-forget uuid=uuid
<!--NeedCopy-->
Olvídese de un sitio PVS.
pvs-site-introduce
xe pvs-site-introduce name-label=name_label [name-description=name_description] [pvs-uuid=pvs_uuid]
<!--NeedCopy-->
Presentación del nuevo sitio de PVS.
Comandos del Administrador de almacenamiento
Comandos para controlar los complementos del Administrador de almacenamiento.
Los objetos del gestor de almacenamiento se pueden listar con el comando estándar de listado de objetos (xe sm-list
). Los parámetros se pueden manipular con los comandos de parámetros estándar. Para obtener más información, consulte Comandos de parámetros de bajo nivel
Parámetros SM
Los SM tienen los siguientes parámetros:
Nombre del parámetro | Descripción | Tipo |
---|---|---|
uuid |
El identificador único/referencia de objeto para el complemento SM | Solo lectura |
name-label |
El nombre del plug-in SM | Solo lectura |
name-description |
La cadena de descripción del plug-in SM | Solo lectura |
type |
El tipo de SR al que se conecta este plug-in | Solo lectura |
vendor |
Nombre del proveedor que creó este complemento | Solo lectura |
copyright |
Declaración de derechos de autor de este plug-in SM | Solo lectura |
required-api-version |
Se requiere una versión mínima de la API de SM en el host de XenServer | Solo lectura |
configuration |
Nombres y descripciones de las claves de configuración del dispositivo | Solo lectura |
capabilities |
Capacidades del plug-in SM | Solo lectura |
driver-filename |
El nombre de archivo del controlador SR. | Solo lectura |
Comandos de instantánea
Comandos para trabajar con instantáneas.
snapshot-clone
xe snapshot-clone new-name-label=name_label [uuid=uuid] [new-name-description=description]
<!--NeedCopy-->
Cree una nueva plantilla clonando una instantánea existente, mediante la operación de clonación rápida de disco a nivel de almacenamiento cuando esté disponible.
snapshot-copy
xe snapshot-copy new-name-label=name_label [uuid=uuid] [new-name-description=name_description] [sr-uuid=sr_uuid]
<!--NeedCopy-->
Cree una nueva plantilla copiando una máquina virtual existente, pero sin usar la operación de clonación rápida de disco a nivel de almacenamiento (incluso si está disponible). Se garantiza que las imágenes de disco de la máquina virtual copiada son “imágenes completas”, es decir, no forma parte de una cadena de CoW.
snapshot-destroy
xe snapshot-destroy [uuid=uuid] [snapshot-uuid=snapshot_uuid]
<!--NeedCopy-->
Destruye una instantánea. Esto deja intacto el almacenamiento asociado a la instantánea. Para eliminar también el almacenamiento, use snapshot-uninstall.
snapshot-disk-list
xe snapshot-disk-list [uuid=uuid] [snapshot-uuid=snapshot_uuid] [vbd-params=vbd_params] [vdi-params=vdi_params]
<!--NeedCopy-->
Enumere los discos de las máquinas virtuales seleccionadas.
snapshot-export-to-template
xe snapshot-export-to-template filename=file_name snapshot-uuid=snapshot_uuid [preserve-power-state=true|false]
<!--NeedCopy-->
Exportar una instantánea a nombre de archivo.
snapshot-reset-powerstate
xe snapshot-reset-powerstate [uuid=uuid] [snapshot-uuid=snapshot_uuid] [--force]
<!--NeedCopy-->
Forzar el estado de energía de la máquina virtual a detenido solo 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’. Se trata de una operación potencialmente peligrosa: debe asegurarse de que ya no necesita la imagen de memoria. Ya no podrá reanudar la instantánea.
snapshot-revert
xe snapshot-revert [uuid=uuid] [snapshot-uuid=snapshot_uuid]
<!--NeedCopy-->
Revertir una máquina virtual existente a un estado de punto de control o instantánea anterior.
snapshot-uninstall
xe snapshot-uninstall [uuid=uuid] [snapshot-uuid=snapshot_uuid] [--force]
<!--NeedCopy-->
Desinstalar una instantánea. Esta operación destruirá los VDI marcados como RW y conectados solo a esta instantánea. Para destruir simplemente el registro de la máquina virtual, use snapshot-destroy.
Comandos SR
Comandos para controlar SR (repositorios de almacenamiento).
Los objetos SR se pueden enumerar con el comando estándar de listado 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 SR tienen los siguientes parámetros:
Nombre del parámetro | Descripción | Tipo |
---|---|---|
uuid |
El identificador único/referencia de objeto para el SR | Solo lectura |
name-label |
El nombre de la SR | Lectura/escritura |
name-description |
La cadena de descripción del SR | Lectura/escritura |
host |
El nombre de host del repositorio de almacenamiento | Solo lectura |
allowed-operations |
Lista de las operaciones permitidas en el SR en este estado | Parámetro de conjunto de solo lectura |
current-operations |
Lista de las operaciones que están actualmente en curso en este SR | Parámetro de conjunto de solo lectura |
VDIs |
Identificador único/referencia de objeto para los discos virtuales de este SR | Parámetro de conjunto de solo lectura |
PBDs |
Identificador único/referencia de objeto para los PBD adjuntos a este SR | Parámetro de conjunto de solo lectura |
virtual-allocation |
Suma de los valores de tamaño virtual de todos los VDI de este repositorio de almacenamiento (en bytes) | Solo lectura |
physical-utilisation |
Espacio físico utilizado actualmente en este SR, en bytes. En el caso de los formatos de disco de aprovisionamiento fino, la utilización física puede ser inferior a la asignación virtual. | Solo lectura |
physical-size |
Tamaño físico total del SR, en bytes | Solo lectura |
type |
Tipo de SR, que se usa para especificar el controlador back-end de SR que se va a usar | Solo lectura |
content-type |
El tipo de contenido del SR. Se utiliza para distinguir las bibliotecas ISO de otros SR. En el caso de los repositorios de almacenamiento que almacenan una biblioteca de ISO, el archivo tipo-contenido debe establecerse en ISO . En otros casos, se recomienda establecer este parámetro en vacío o en el usuario de cadena. |
Solo lectura |
shared |
True si este SR se puede compartir entre varios hosts. Falso, en caso contrario. | Lectura/escritura |
introduced-by |
El drtask (si los hubiera) que introdujeron el SR |
Solo lectura |
is-tools-sr |
True si este es el SR que contiene las VDI ISO de herramientas. Falso, en caso contrario. | Solo lectura |
other-config |
Lista de pares clave/valor que especifican parámetros de configuración adicionales para el SR | Parámetro de mapa de lectura/escritura |
sm-config |
Datos dependientes de SM | Parámetro de mapa de solo lectura |
blobs |
Almacén de datos binarios | Solo lectura |
local-cache-enabled |
True si este SR está asignado para ser la memoria caché local de su host. Falso, en caso contrario. | Solo lectura |
tags |
Etiquetas especificadas por el usuario con fines de categorización | Parámetro de conjunto de lectura/escritura |
clustered |
Es cierto que el SR está utilizando almacenamiento local agregado. Falso, en caso contrario. | Solo lectura |
sr-create
xe sr-create name-label=name physical-size=size type=type content-type=content_type device-config:config_name=value [host-uuid=host_uuid] [shared=true|false]
<!--NeedCopy-->
Crea un SR en el disco, lo introduce en la base de datos y crea un PBD que conecta el SR al host de XenServer. Si compartido
se establece en verdadero
, se crea un PBD para cada host de XenServer del grupo. Si compartido
no se especifica ni se establece en falso
, solo se crea un PBD para el host de XenServer especificado con host-uuid
.
El valor exacto configuración-dispositivo
Los parámetros difieren según el dispositivo tipo
. Para obtener más información sobre estos parámetros en los diferentes back-ends de almacenamiento, consulte Crear un SR.
sr-data-source-forget
xe sr-data-source-forget data-source=data_source
<!--NeedCopy-->
Deje de grabar la fuente de datos especificada para un SR y olvide todos los datos grabados.
sr-data-source-list
xe sr-data-source-list
<!--NeedCopy-->
Enumere las fuentes de datos que se pueden registrar para un SR.
sr-data-source-query
xe sr-data-source-query data-source=data_source
<!--NeedCopy-->
Consulte el último valor leído de un origen de datos SR.
sr-data-source-record
xe sr-data-source-record data-source=data_source
<!--NeedCopy-->
Registre la fuente de datos especificada para un SR.
sr-destroy
xe sr-destroy uuid=sr_uuid
<!--NeedCopy-->
Destruye el SR especificado en el host de XenServer.
sr-enable-database-replication
xe sr-enable-database-replication uuid=sr_uuid
<!--NeedCopy-->
Habilita la replicación de bases de datos XAPI en el SR especificado (compartido).
sr-disable-database-replication
xe sr-disable-database-replication uuid=sr_uuid
<!--NeedCopy-->
Deshabilita la replicación de base de datos XAPI en el SR especificado.
sr-forget
xe sr-forget uuid=sr_uuid
<!--NeedCopy-->
El agente XAPI se olvida de un SR especificado en el host de XenServer. Cuando el agente XAPI olvida un SR, el SR se desconecta 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
xe sr-introduce name-label=name physical-size=physical_size type=type content-type=content_type uuid=sr_uuid
<!--NeedCopy-->
Simplemente coloca un registro SR en la base de datos. Uso configuración-dispositivo
Para especificar parámetros adicionales en el formulario device-config:parameter_key=parameter_value
por ejemplo:
xe sr-introduce device-config:device=/dev/sdb1
<!--NeedCopy-->
Nota: No
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 haberlo creado o para ayudar a recuperarse de varios escenarios de error.
sr-probe
xe sr-probe type=type [host-uuid=host_uuid] [device-config:config_name=value]
<!--NeedCopy-->
Realiza un escaneo del backend, utilizando el archivo configuración-dispositivo
Llaves. Si el configuración-dispositivo
se completa para el back-end de SR, este comando devuelve una lista de los SR presentes en el dispositivo, si los hay. Si el configuración-dispositivo
Los parámetros son solo parciales, se realiza un escaneo específico del back-end, devolviendo resultados que lo guían en la mejora de los parámetros restantes. configuración-dispositivo
Parámetros. Los resultados del análisis se devuelven como XML específico del back-end, impresos en la CLI.
El valor exacto configuración-dispositivo
Los parámetros difieren según el dispositivo tipo
. Para obtener más información sobre estos parámetros en los diferentes back-ends de almacenamiento, consulte Almacenamiento.
sr-probe-ext
xe sr-probe-ext type=type [host-uuid=host_uuid] [device-config:=config] [sm-config:-sm_config]
<!--NeedCopy-->
Realice un sondeo de almacenamiento. Los parámetros device-config se pueden especificar mediante, por ejemplo, device-config:devs=/dev/sdb1. A diferencia de sr-probe, este comando devuelve resultados en el mismo formato legible para cada tipo de SR.
sr-scan
xe sr-scan uuid=sr_uuid
<!--NeedCopy-->
Forzar un análisis de SR, sincronizando la base de datos XAPI con las VDI presentes en el sustrato de almacenamiento subyacente.
sr-update
xe sr-update uuid=uuid
<!--NeedCopy-->
Actualice los campos del objeto SR en la base de datos.
lvhd-enable-thin-provisioning
xe lvhd-enable-thin-provisioning sr-uuid=sr_uuid initial-allocation=initial_allocation allocation-quantum=allocation_quantum
<!--NeedCopy-->
Habilite el aprovisionamiento fino en un SR de LVHD.
Comandos de asunto
Comandos para trabajar con sujetos.
session-subject-identifier-list
xe session-subject-identifier-list
<!--NeedCopy-->
Devuelve una lista de todos los ID de asunto de usuario de todas las sesiones existentes autenticadas externamente.
session-subject-identifier-logout
xe session-subject-identifier-logout subject-identifier=subject_identifier
<!--NeedCopy-->
Cierre la sesión de todas las sesiones autenticadas externamente asociadas a un ID de asunto de usuario.
session-subject-identifier-logout-all
xe session-subject-identifier-logout-all
<!--NeedCopy-->
Cierre la sesión de todas las sesiones autenticadas externamente.
subject-add
xe subject-add subject-name=subject_name
<!--NeedCopy-->
Agregue un asunto a la lista de sujetos que pueden acceder al grupo.
subject-remove
xe subject-remove subject-uuid=subject_uuid
<!--NeedCopy-->
Eliminar un asunto de la lista de asuntos que pueden acceder al grupo.
subject-role-add
xe subject-role-add uuid=uuid [role-name=role_name] [role-uuid=role_uuid]
<!--NeedCopy-->
Agregar un rol a un asunto.
subject-role-remove
xe subject-role-remove uuid=uuid [role-name=role_name] [role-uuid=role_uuid]
<!--NeedCopy-->
Eliminar un rol de un asunto.
secret-create
xe secret-create value=value
<!--NeedCopy-->
Crea un secreto.
secret-destroy
xe secret-destroy uuid=uuid
<!--NeedCopy-->
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. Normalmente, las tareas se componen de un conjunto de otras subtareas atómicas que, juntas, realizan la operación solicitada.
Los objetos de tarea se pueden enumerar con el comando estándar de lista de objetos (xe lista de tareas
), 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 tarea
Las tareas tienen los siguientes parámetros:
Nombre del parámetro | Descripción | Tipo |
---|---|---|
uuid |
El identificador único/referencia de objeto para la tarea | Solo lectura |
name-label |
El nombre de la tarea | Solo lectura |
name-description |
La cadena de descripción de la tarea | Solo lectura |
resident-on |
Identificador único/referencia de objeto del host en el que se ejecuta la tarea | Solo lectura |
status |
Estado de la tarea | Solo lectura |
progress |
Si la tarea aún está pendiente, este campo contiene el porcentaje estimado de completado, de 0 a 1. Si la tarea se ha completado, con éxito o sin éxito, el valor es 1. | Solo lectura |
type |
Si la tarea se ha completado correctamente, este parámetro contiene el tipo de resultado codificado. El tipo es el nombre de la clase cuya referencia se encuentra en el campo de resultados. De lo contrario, el valor de este parámetro es indefinido | Solo lectura |
result |
Si la tarea se ha completado correctamente, este campo contiene el valor del resultado, ya sea Void o una referencia a objeto; de lo contrario, el valor de este parámetro es indefinido | Solo lectura |
error_info |
Si se ha producido un error en la tarea, este parámetro contiene el conjunto de cadenas de error asociadas. De lo contrario, el valor de este parámetro es indefinido | Solo lectura |
allowed_operations |
Lista de las operaciones permitidas en este estado | Solo lectura |
created |
Hora en que se ha creado la tarea | Solo lectura |
finished |
Tarea de tiempo finalizada (es decir, correcta o fallida). Si el estado de la tarea es pendiente, el valor de este campo no tiene significado | Solo lectura |
subtask_of |
Contiene el UUID de las tareas, esta tarea es una subtarea de | Solo lectura |
subtasks |
Contiene los UUIDs de todas las subtareas de esta tarea | Solo lectura |
task-cancel
xe task-cancel [uuid=task_uuid]
<!--NeedCopy-->
Indique la tarea especificada para cancelarla y devolverla.
Comandos de plantilla
Comandos para trabajar con plantillas de máquina virtual.
Las plantillas son esencialmente máquinas virtuales con el atributo es-una-plantilla
parámetro establecido en verdadero
. Una plantilla es una “imagen dorada” que contiene todos los ajustes de configuración para crear una instancia de una máquina virtual específica. XenServer incluye un conjunto básico de plantillas, que son máquinas virtuales genéricas “sin procesar” que pueden arrancar un CD de instalación de un proveedor de sistemas operativos (por ejemplo: RHEL, CentOS, SLES, Windows). Puede crear máquinas virtuales, configurarlas en formularios estándar para sus necesidades particulares y guardar una copia de ellas como plantillas para usarlas en el futuro en la implementación de máquinas virtuales.
Los objetos de plantilla se pueden enumerar con el comando estándar de listado de objetos (xe lista-de-plantillas
), 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: No
Las plantillas no se pueden convertir directamente en máquinas virtuales configurando el parámetro
es-una-plantilla
parámetro afalso
. Ajustees-una-plantilla
parámetro afalso
no se admite y da como resultado una máquina virtual que no se puede iniciar.
Parámetros de plantilla de máquina virtual
Las plantillas tienen los siguientes parámetros:
-
uuid
(solo lectura) el identificador único/referencia de objeto para la plantilla -
nombre-etiqueta
(lectura/escritura) el nombre de la plantilla -
nombre-descripción
(lectura/escritura) la cadena de descripción de la plantilla -
versión-usuario
(lectura/escritura) para que los creadores de máquinas virtuales y plantillas coloquen información de versión -
es-una-plantilla
(lectura/escritura) true si esta máquina virtual es una plantilla. Las máquinas virtuales de plantilla nunca se pueden iniciar, solo se usan para clonar otras máquinas virtuales. Una vez que este valor se ha establecido en true, no se puede restablecer a false. Las máquinas virtuales de plantilla no se pueden convertir en máquinas virtuales con este parámetro.Puede convertir una máquina virtual en una plantilla con:
xe vm-param-set uuid=<vm uuid> is-a-template=true <!--NeedCopy-->
-
dominio-de-control-es
(solo lectura) true si se trata de un dominio de control (dominio 0 o dominio de controlador) -
estado-energía
(solo lectura) estado de energía actual. El valor siempre se detiene para una plantilla -
memoria-dinámica-max
(solo lectura) Memoria dinámica máxima en bytes. Actualmente no se utiliza, pero si se cambia, se debe obedecer la siguiente restricción:memory_static_max
>=
memory_dynamic_max
>=
memory_dynamic_min
>=
memory_static_min
. -
memoria-dinámica-min
(lectura/escritura) Memoria dinámica mínima en bytes. Actualmente no se utiliza, pero si se cambian las mismas restricciones paramemoria-dinámica-max
debe ser obedecido. -
memoria-estática-max
(lectura/escritura) establece estáticamente (absoluta) la memoria máxima en bytes. Este campo es el valor principal que se usa para determinar la cantidad de memoria asignada a una máquina virtual. -
memoria-estática-min
(lectura/escritura) establece estáticamente la memoria mínima (absoluta) en bytes. Este campo representa la memoria mínima absoluta, ymemoria-estática-min
debe ser inferior amemoria-estática-max
. Este valor no se utiliza en el funcionamiento normal, pero se debe obedecer la restricción anterior. -
suspend-VDI-uuid
(solo lectura) el VDI en el que se almacena una imagen de suspensión (no tiene ningún significado para una plantilla) -
VCPUs-params
(parámetro de mapa de lectura/escritura) para la política de vCPU seleccionada.Puede ajustar la fijación de una vCPU con:
xe template-param-set uuid=<template_uuid> vCPUs-params:mask=1,2,3 <!--NeedCopy-->
Una máquina virtual creada a partir de esta plantilla solo se ejecuta en las CPU físicas 1, 2 y 3.
También puede ajustar la prioridad de vCPU (programación xen) con los parámetros cap y weight. Por ejemplo:
xe template-param-set uuid=<template_uuid> VCPUs-params:weight=512 xe template-param-set uuid=<template_uuid> VCPUs-params:cap=100 <!--NeedCopy-->
Una máquina virtual basada en esta plantilla con un peso de 512 obtiene el doble de CPU que un dominio con un peso de 256 en un host en disputa. Los pesos legales oscilan entre 1 y 65535 y el valor predeterminado es 256.
Opcionalmente, el límite fija la cantidad máxima de CPU que puede consumir una máquina virtual basada en esta plantilla, incluso si el host de XenServer 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 la mitad de una CPU, 400 son 4 CPU, y así sucesivamente.
-
VCPUs-max
(lectura/escritura) número máximo de vCPU -
VCPU en inicio
(lectura/escritura) número de arranque de vCPU -
acciones-después-de-choque
(lectura/escritura) acción que se debe realizar cuando una máquina virtual basada en esta plantilla se bloquea -
console-uuids
(parámetro de conjunto de solo lectura) Dispositivos de consola virtual -
plataforma
(parámetro de mapa de lectura/escritura) configuración específica de la plataformaPara deshabilitar la emulación de un puerto paralelo para invitados:
xe vm-param-set uuid=<vm_uuid> platform:parallel=none <!--NeedCopy-->
Para desactivar la emulación de un puerto serie:
xe vm-param-set uuid=<vm_uuid> platform:hvm_serial=none <!--NeedCopy-->
Para deshabilitar la emulación de un controlador USB y una tableta USB:
xe vm-param-set uuid=<vm_uuid> platform:usb=false xe vm-param-set uuid=<vm_uuid> platform:usb_tablet=false <!--NeedCopy-->
-
operaciones-permitidas
(parámetro de conjunto de solo lectura) lista de las operaciones permitidas en este estado -
operaciones-actuales
(parámetro de conjunto de solo lectura) lista de las operaciones que están actualmente en curso en esta plantilla -
Dispositivos VBD permitidos
(parámetro de conjunto de solo lectura) lista de identificadores VBD disponibles para su uso, representados por números enteros del rango 0 a 15. Esta lista es solo informativa y se pueden usar otros dispositivos (pero es posible que no funcionen). -
Dispositivos VIF permitidos
(parámetro de conjunto de solo lectura) lista de identificadores VIF disponibles para su uso, representados por números enteros del rango 0 a 15. Esta lista es solo informativa y se pueden usar otros dispositivos (pero es posible que no funcionen). -
Política de arranque de HVM
(lectura/escritura) la política de arranque para los invitados. Orden del BIOS o una cadena vacía. -
HVM-boot-params
(parámetro de mapa de lectura/escritura) la tecla order controla el orden de arranque del invitado, representado como una cadena donde cada carácter es un método de arranque: d para el CD/DVD, c para el disco raíz y n para el arranque PXE de red. El valor predeterminado es dc. -
Kernel PV
(lectura/escritura) al kernel -
PV-ramdisk
(lectura/escritura) a la ruta de accesoinitrd
-
PV-args
(lectura/escritura) de argumentos de la línea de comandos del kernel -
PV-legacy-args
(lectura/escritura) de argumentos para hacer que las máquinas virtuales heredadas se basen en este arranque de plantilla -
Cargador de arranque PV
(lectura/escritura) nombre o ruta al gestor de arranque -
PV-bootloader-args
(lectura/escritura) cadena de argumentos misceláneos para el gestor de arranque -
banderas-de-CPU-de-last-boot
(solo lectura) describe las marcas de CPU en las que se inició por última vez una máquina virtual basada en esta plantilla; no se rellena para una plantilla -
Residente en
(solo lectura) el host de XenServer en el que reside una máquina virtual basada en esta plantilla. Aparece comoNo está en la base de datos
para una plantilla -
afinidad
(lectura/escritura) el host de XenServer en el que tiene preferencia ejecutar una máquina virtual basada en esta plantilla. Utilizado por elxe vm-start
para decidir dónde ejecutar la máquina virtual. También conocido como el servidor doméstico. -
grupos
(lectura/escritura) el grupo de máquinas virtuales al que pertenece esta máquina virtual. Un grupo de máquinas virtuales define dónde XenServer intenta iniciar la máquina virtual o evacuarla. -
otra-configuración
(parámetro de mapa de lectura/escritura) lista de pares clave/valor que especifican parámetros de configuración adicionales para la plantilla -
Hora de inicio
(solo 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 formularioaaaammddThh:mm:ss z
, donde z es el indicador de zona horaria militar de una sola letra, por ejemplo, Z para UTC(GMT). Establézcalo en1 de enero de 1970 Z
(comienzo de la época de Unix/POSIX) para una plantilla -
tiempo de instalación
(solo 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 formularioaaaammddThh:mm:ss z
, donde z es el indicador de zona horaria militar de una sola letra, por ejemplo, Z para UTC (GMT). Establézcalo en1 de enero de 1970 Z
(comienzo de la época de Unix/POSIX) para una plantilla -
memoria-real
(solo lectura) la memoria real que usa una máquina virtual basada en esta plantilla; 0 para una plantilla -
Número de VCPUs
(solo lectura) el número de CPU virtuales asignadas a una máquina virtual basada en esta plantilla; 0 para una plantilla -
Utilización de VCPUs
(parámetro de mapa de solo lectura) lista de CPU virtuales y su peso parámetro de mapa de solo lecturaversión-sistema operativo
la versión del sistema operativo de una máquina virtual basada en esta plantilla. Aparece comoNo está en la base de datos
para una plantilla -
Versión-de-controladores-PV
(parámetro de mapa de solo lectura) las versiones de los controladores paravirtualizados para una máquina virtual basada en esta plantilla. Aparece comoNo está en la base de datos
para una plantilla -
Controladores PV detectados
(solo lectura) para la versión más reciente de los controladores paravirtualizados para una máquina virtual basada en esta plantilla. Aparece comoNo está en la base de datos
para una plantilla -
memoria
(parámetro de mapa de solo lectura) métricas de memoria notificadas por el agente en una máquina virtual basada en esta plantilla. Aparece comoNo está en la base de datos
para una plantilla -
Discos
(parámetro de mapa de solo lectura) métricas de disco notificadas por el agente en una máquina virtual basada en esta plantilla. Aparece comoNo está en la base de datos
para una plantilla -
redes
(parámetro de mapa de solo lectura) métricas de red notificadas por el agente en una máquina virtual basada en esta plantilla. Aparece comoNo está en la base de datos
para una plantilla -
Otro
(parámetro de mapa de solo lectura) otras métricas notificadas por el agente en una máquina virtual basada en esta plantilla. Aparece comoNo está en la base de datos
para una plantilla -
guest-metrics-last-updated
(solo lectura) cuando el agente invitado realizó la última escritura en estos campos. En la formaaaaammddThh:mm:ss z
, donde z es el indicador de zona horaria militar de una sola letra, por ejemplo, Z para UTC (GMT) -
acciones-pos-apagado
(lectura/escritura) acción que se debe realizar después de que la máquina virtual se haya apagado -
acciones-después-de-reiniciar
(lectura/escritura) acción que se debe realizar después de que la máquina virtual se haya reiniciado -
anfitriones-posibles
(solo lectura) lista de hosts que potencialmente pueden alojar la máquina virtual -
HVM-shadow-multiplier
(lectura/escritura) se aplica a la cantidad de sombra que se pone a disposición del huésped -
Dom-ID
(solo lectura) ID de dominio (si está disponible, -1 en caso contrario) -
Recomendaciones
(solo lectura) Especificación XML de los valores y rangos recomendados para las propiedades de esta máquina virtual -
xenstore-datos
(parámetro de mapa de lectura/escritura) que se insertarán en elXenstore
árbol (/local/*domid*/vmdata
) después de crear la máquina virtual. -
es-una-instantánea
(solo lectura) True si esta plantilla es una instantánea de máquina virtual -
snapshot_of
(solo lectura) el UUID de la máquina virtual de la que esta plantilla es una instantánea -
Instantáneas
(solo lectura) los UUID de las instantáneas que se hayan tomado de esta plantilla -
snapshot_time
(solo lectura) la marca de tiempo de la instantánea de VM más reciente tomada -
objetivo-memoria
(solo lectura) la cantidad de memoria objetivo establecida para esta plantilla -
Operaciones bloqueadas
(parámetro de mapa de lectura/escritura) enumera las operaciones que no se pueden realizar en esta plantilla -
último-registro-de-arranque
(solo lectura) registro de los últimos parámetros de arranque para esta plantilla, en formato XML -
ha-siempre-correr
(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 ahora está en desuso. Utilice la funciónha-restartpriority
en su lugar. -
ha-restart-priority
(Solo lectura) Reiniciar o Almacén de datos binarios de blobs de lectura y escritura de mejor esfuerzo -
vivir
(solo lectura) relevante solo para una máquina virtual en ejecución.
template-export
xe template-export template-uuid=uuid_of_existing_template filename=filename_for_new_template
<!--NeedCopy-->
Exporta una copia de una plantilla especificada a un archivo con el nuevo nombre de archivo especificado.
template-uninstall
xe template-uninstall template-uuid=template_uuid [--force]
<!--NeedCopy-->
Desinstalar una plantilla personalizada. Esta operación destruirá los VDI marcados como “propiedad” de esta plantilla.
Comandos de actualización
La siguiente sección contiene los comandos de actualización del host de XenServer.
Los objetos de actualización se pueden enumerar con el comando estándar de listado de objetos (xe update-list
), y los parámetros manipulados con los comandos de parámetros estándar. Para obtener más información, consulte Comandos de parámetros de bajo nivel
Actualizar parámetros
Las actualizaciones de host de XenServer tienen los siguientes parámetros:
Nombre del parámetro | Descripción | Tipo |
---|---|---|
uuid |
El identificador único/referencia de objeto para la actualización | Solo lectura |
host |
La lista de hosts a los que se aplica esta actualización | Solo lectura |
host-uuid |
El identificador único del host de XenServer que se va a consultar | Solo lectura |
name-label |
El nombre de la actualización | Solo lectura |
name-description |
La cadena de descripción de la actualización | Solo lectura |
applied |
Si se ha aplicado o no la actualización; Verdadero o falso | Solo lectura |
installation-size |
El tamaño de la actualización en bytes | Solo lectura |
after-apply-guidance |
Si la pila de herramientas XAPI o el host requieren un reinicio | Solo lectura |
version |
La versión de la actualización | Solo lectura |
update-upload
xe update-upload file-name=update_filename
<!--NeedCopy-->
Cargue un archivo de actualización especificado en el host de XenServer. Este comando prepara una actualización que se va a aplicar. Si se realiza correctamente, se imprime el UUID de la actualización cargada. Si la actualización se ha cargado anteriormente, UPDATE_ALREADY_EXISTS
En su lugar, se devuelve un error y el parche no se vuelve a cargar.
update-precheck
xe update-precheck uuid=update_uuid host-uuid=host_uuid
<!--NeedCopy-->
Ejecute las comprobaciones previas contenidas en la actualización especificada en el host XenServer especificado.
update-destroy
xe update-destroy uuid=update_file_uuid
<!--NeedCopy-->
Elimina un archivo de actualización que no se ha aplicado del grupo. Se puede utilizar para eliminar un archivo de actualización que no se puede aplicar a los hosts.
update-apply
xe update-apply host-uuid=host_uuid uuid=update_file_uuid
<!--NeedCopy-->
Aplique el archivo de actualización especificado.
update-pool-apply
xe update-pool-apply uuid=update_uuid
<!--NeedCopy-->
Aplique la actualización especificada a todos los hosts de XenServer del grupo.
update-introduce
xe update-introduce vdi-uuid=vdi_uuid
<!--NeedCopy-->
Introducción de la actualización VDI.
update-pool-clean
xe update-pool-clean uuid=uuid
<!--NeedCopy-->
Quita los archivos de la actualización de todos los hosts del grupo.
Comandos de usuario
user-password-change
xe user-password-change old=old_password new=new_password
<!--NeedCopy-->
Cambia la contraseña del usuario que ha iniciado sesión. El campo de contraseña antigua no se marca porque necesita privilegios de supervisor para usar este comando.
Comandos VBD
Comandos para trabajar con VBDs (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 máquina virtual (si es de arranque, 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 se puede compartir, si el medio es de lectura/escritura o de solo lectura, etc.).
Los objetos VBD se pueden listar con el comando estándar de listado 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 del parámetro | Descripción | Tipo |
---|---|---|
uuid |
El identificador único/referencia de objeto para el VBD | Solo lectura |
vm-uuid |
La referencia de objeto o identificador único para la máquina virtual a la que se asocia este VBD | Solo lectura |
vm-name-label |
El nombre de la máquina virtual a la que está asociado este VBD | Solo lectura |
vdi-uuid |
La referencia de identificador/objeto único para el VDI al que se asigna este VBD | Solo lectura |
vdi-name-label |
El nombre de la VDI a la que se asigna este VBD | Solo lectura |
empty |
Si verdadero , este VBD representa una unidad vacía |
Solo lectura |
device |
El dispositivo visto por el huésped, por ejemplo Tenía
|
Solo lectura |
userdevice |
Número de dispositivo especificado por el parámetro device durante vbd-create , por ejemplo, 0 para Tenía , 1 para HDB , y así sucesivamente |
Lectura/escritura |
bootable |
Verdadero si este VBD es de arranque | Lectura/escritura |
mode |
El modo con el que se monta el VBD | Lectura/escritura |
type |
Cómo aparece el VBD en la máquina virtual, por ejemplo, disco o CD | Lectura/escritura |
currently-attached |
Verdadero si el VBD está conectado en este host, falso en caso contrario | Solo lectura |
storage-lock |
True si se adquirió un bloqueo de nivel de almacenamiento | Solo lectura |
status-code |
Código de error/éxito asociado a la última operación de adjuntar | Solo lectura |
status-detail |
Información de error/éxito asociada con el estado de la última operación de asociación | Solo lectura |
qos_algorithm_type |
El algoritmo de priorización que se va a utilizar | Lectura/escritura |
qos_algorithm_params |
Parámetros para el algoritmo de priorización elegido | Parámetro de mapa de lectura/escritura |
qos_supported_algorithms |
Algoritmos de priorización compatibles para este VBD | Parámetro de conjunto de solo lectura |
io_read_kbs |
Velocidad de lectura media en kB por segundo para este VBD | Solo lectura |
io_write_kbs |
Velocidad media de escritura en kB por segundo para este VBD | Solo lectura |
allowed-operations |
Lista de las operaciones permitidas en este estado. Esta lista es solo consultiva y es posible que el estado del servidor haya cambiado en el momento en que un cliente lea este campo. | Parámetro de conjunto de solo lectura |
current-operations |
Vincula cada una de las tareas en ejecución que utilizan este objeto (por referencia) a una enumeración current_operation que describe la naturaleza de la tarea. | Parámetro de conjunto de solo lectura |
unpluggable |
True si este VBD admite la desconexión en caliente | Lectura/escritura |
attachable |
True si el dispositivo se puede conectar | Solo lectura |
other-config |
Configuración adicional | Parámetro de mapa de lectura/escritura |
vbd-create
xe vbd-create vm-uuid=uuid_of_the_vm device=device_value vdi-uuid=uuid_of_vdi_to_connect_to [bootable=true] [type=Disk|CD] [mode=RW|RO]
<!--NeedCopy-->
Cree un VBD en una máquina virtual.
Los valores permitidos para el dispositivo
son números enteros del 0 al 15 y el número debe ser único para cada máquina virtual. Los valores permitidos actuales se pueden ver en el archivo Dispositivos VBD permitidos
en la máquina virtual especificada. Esto se ve como Dispositivo de usuario
En vbd
Parámetros.
Si el tipo
es Disco
, vdi-uuid
es necesario. El modo puede ser RO
o RW
para un disco.
Si el tipo
es CD
, vdi-uuid
es opcional. Si no se especifica ningún VDI, se crea un VBD vacío para el CD. El modo debe ser RO
para un CD.
vbd-destroy
xe vbd-destroy uuid=uuid_of_vbd
<!--NeedCopy-->
Destruya el VBD especificado.
Si el VBD tiene su otro-config:propietario
parámetro establecido en verdadero
, también se destruye la VDI asociada.
vbd-eject
xe vbd-eject uuid=uuid_of_vbd
<!--NeedCopy-->
Retire los medios de la unidad representados por un VBD. Este comando solo funciona si el medio es de tipo extraíble (un CD físico o una ISO). De lo contrario, aparecerá un mensaje de error VBD_NOT_REMOVABLE_MEDIA
se devuelve.
vbd-insert
xe vbd-insert uuid=uuid_of_vbd vdi-uuid=uuid_of_vdi_containing_media
<!--NeedCopy-->
Inserte nuevos medios en la unidad representada por un VBD. Este comando solo funciona si el medio es de tipo extraíble (un CD físico o una ISO). De lo contrario, aparecerá un mensaje de error VBD_NOT_REMOVABLE_MEDIA
se devuelve.
vbd-plug
xe vbd-plug uuid=uuid_of_vbd
<!--NeedCopy-->
Intente conectar el VBD mientras la máquina virtual está en estado de ejecución.
vbd-unplug
xe vbd-unplug uuid=uuid_of_vbd
<!--NeedCopy-->
Intenta desasociar el VBD de la máquina virtual mientras está en estado de ejecución.
Comandos VDI
Comandos para trabajar con VDIs (Imágenes de Disco Virtual).
Una 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 se puede compartir, si el medio es de lectura/escritura o de solo lectura, etc.). El VBD tiene los atributos que vinculan el VDI a la máquina virtual (si es de arranque, 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
Las VDI tienen los siguientes parámetros:
Nombre del parámetro | Descripción | Tipo |
---|---|---|
uuid |
El identificador único/referencia de objeto para el VDI | Solo lectura |
name-label |
El nombre de la VDI | Lectura/escritura |
name-description |
La cadena de descripción de la VDI | Lectura/escritura |
allowed-operations |
Una lista de las operaciones permitidas en este estado | Parámetro de conjunto de solo lectura |
current-operations |
Una lista de las operaciones que están actualmente en curso en esta VDI | Parámetro de conjunto de solo lectura |
sr-uuid |
SR en el que reside la VDI | Solo lectura |
vbd-uuids |
Una lista de VBD que hacen referencia a esta VDI | Parámetro de conjunto de solo lectura |
crashdump-uuids |
Lista de volcados de memoria que hacen referencia a esta VDI | Parámetro de conjunto de solo lectura |
virtual-size |
Tamaño del disco tal como se presenta a la máquina virtual, en bytes. Dependiendo del tipo de back-end de almacenamiento, es posible que el tamaño no se respete exactamente | Solo lectura |
physical-utilisation |
Cantidad de espacio físico que ocupa la VDI en el SR, en bytes | Solo lectura |
type |
Tipo de VDI, por ejemplo, Sistema o Usuario | Solo lectura |
sharable |
True si esta VDI se puede compartir | Solo lectura |
read-only |
True si esta VDI solo se puede montar en modo de solo lectura | Solo lectura |
storage-lock |
True si esta VDI está bloqueada en el nivel de almacenamiento | Solo lectura |
parent |
Hace referencia al VDI principal cuando este VDI forma parte de una cadena | Solo lectura |
missing |
True si la operación de escaneo SR informó que este VDI no estaba presente | Solo lectura |
other-config |
Información de configuración adicional para esta VDI | Parámetro de mapa de lectura/escritura |
sr-name-label |
Nombre del repositorio de almacenamiento contenedor | Solo lectura |
location |
Información de ubicación | Solo lectura |
managed |
True si se administra la VDI | Solo lectura |
xenstore-data |
Los datos que se insertarán en el archivo Xenstore árbol (/local/dominio/0/backend/ vbd/domid/id-dispositivo/smdata) después de adjuntar la VDI. Los back-ends de SM generalmente establecen este campo en vdi_attach . |
Parámetro de mapa de solo lectura |
sm-config |
Datos dependientes de SM | Parámetro de mapa de solo lectura |
is-a-snapshot |
True si esta VDI es una instantánea de almacenamiento de VM | Solo lectura |
snapshot_of |
El UUID del almacenamiento de este VDI es una instantánea de | Solo lectura |
snapshots |
Los UUID de todas las instantáneas de esta VDI | Solo lectura |
snapshot_time |
La marca de tiempo de la operación de instantánea que creó esta VDI | Solo lectura |
metadata-of-pool |
UUID del grupo que creó este VDI de metadatos | Solo lectura |
metadata-latest |
Marca que indica si la VDI contiene los metadatos conocidos más recientes para este grupo | Solo lectura |
cbt-enabled |
Indicador que indica si el seguimiento de bloques modificados está habilitado para la VDI | Lectura/escritura |
vdi-clone
xe vdi-clone uuid=uuid_of_the_vdi [driver-params:key=value]
<!--NeedCopy-->
Cree una nueva copia grabable de la VDI especificada que se pueda utilizar directamente. Es una variante de Copia VDI
es decir, pueden exponer instalaciones de clonación de imágenes de alta velocidad donde existan.
Utilice la opción parámetros del controlador
map para pasar información de configuración adicional específica del proveedor al controlador de almacenamiento back-end en el que se basa la VDI. Para obtener más información, consulte la documentación del controlador del proveedor de almacenamiento.
vdi-copy
xe vdi-copy uuid=uuid_of_the_vdi sr-uuid=uuid_of_the_destination_sr
<!--NeedCopy-->
Copie una VDI en un SR especificado.
vdi-create
xe vdi-create sr-uuid=uuid_of_sr_to_create_vdi_on name-label=name_for_the_vdi type=system|user|suspend|crashdump virtual-size=size_of_virtual_disk sm-config-\*=storage_specific_configuration_data
<!--NeedCopy-->
Cree una VDI.
El tamaño virtual
se puede especificar en bytes o mediante los sufijos estándar IEC KiB, MiB, GiB y TiB.
Nota: No
Los tipos de SR que admiten el aprovisionamiento fino de discos (como VHD local y NFS) no aplican la asignación virtual de discos. Tenga mucho cuidado al asignar en exceso el espacio de disco virtual en un SR. Si un SR sobreasignado se llena, el espacio en disco debe estar disponible en el sustrato de destino del SR o mediante la eliminación de los VDI no utilizados en el SR.
Algunos tipos de SR pueden redondear el
tamaño virtual
para que sea divisible por un tamaño de bloque configurado.
vdi-data-destroy
xe vdi-data-destroy uuid=uuid_of_vdi
<!--NeedCopy-->
Destruya los datos asociados con el VDI especificado, pero conserve los metadatos de seguimiento de bloques modificados.
Nota: No
Si utiliza el seguimiento de bloques modificados para realizar copias de seguridad incrementales de la VDI, asegúrese de utilizar el
vdi-destrucción-de-datos
para eliminar instantáneas pero conservar los metadatos. No utilizarvdi-destruir
en instantáneas de VDI que tienen habilitado el seguimiento de bloques modificado.
vdi-destroy
xe vdi-destroy uuid=uuid_of_vdi
<!--NeedCopy-->
Destruya el VDI especificado.
Nota: No
Si utiliza el seguimiento de bloques modificados para realizar copias de seguridad incrementales de la VDI, asegúrese de utilizar el
vdi-destrucción-de-datos
para eliminar instantáneas pero conservar los metadatos. No utilizarvdi-destruir
en instantáneas de VDI que tienen habilitado el seguimiento de bloques modificado.En el caso de los tipos SR de VHD local y NFS, el espacio en disco no se libera inmediatamente en
vdi-destruir
, pero 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 aEscaneo SR
manualmente.
vdi-disable-cbt
xe vdi-disable-cbt uuid=uuid_of_vdi
<!--NeedCopy-->
Deshabilite el seguimiento de bloques modificados para la VDI.
vdi-enable-cbt
xe vdi-enable-cbt uuid=uuid_of_vdi
<!--NeedCopy-->
Habilite el seguimiento de bloques modificados para la VDI.
Nota: No
Solo puede habilitar el seguimiento de bloques modificados en instancias con licencia de XenServer Premium Edition.
vdi-export
xe vdi-export uuid=uuid_of_vdi filename=filename_to_export_to [format=format] [base=uuid_of_base_vdi] [--progress]
<!--NeedCopy-->
Exporte una VDI al nombre de archivo especificado. Puede exportar una VDI en uno de los siguientes formatos:
raw
vhd
El formato VHD puede ser escaso. Si hay bloques sin asignar dentro del VDI, es posible que estos bloques se omitan del archivo VHD, lo que hace que el archivo VHD sea más pequeño. Puede exportar a formato VHD desde todos los tipos de almacenamiento basados en VHD compatibles (EXT3/EXT4, NFS).
Si especifica el parámetro base
, este comando exporta solo los bloques que han cambiado entre el VDI exportado y el VDI base.
vdi-forget
xe vdi-forget uuid=uuid_of_vdi
<!--NeedCopy-->
Elimina incondicionalmente un registro VDI de la base de datos sin tocar el back-end de almacenamiento. En funcionamiento normal, utilice vdi-destruir
en lugar de.
vdi-import
xe vdi-import uuid=uuid_of_vdi filename=filename_to_import_from [format=format] [--progress]
<!--NeedCopy-->
Importar una VDI. Puede importar una VDI desde uno de los siguientes formatos:
raw
vhd
vdi-introduce
xe vdi-introduce uuid=uuid_of_vdi sr-uuid=uuid_of_sr name-label=name_of_new_vdi type=system|user|suspend|crashdump location=device_location_(varies_by_storage_type) [name-description=description_of_vdi] [sharable=yes|no] [read-only=yes|no] [other-config=map_to_store_misc_user_specific_data] [xenstore-data=map_to_of_additional_xenstore_keys] [sm-config=storage_specific_configuration_data]
<!--NeedCopy-->
Cree un objeto VDI que represente un dispositivo de almacenamiento existente, sin modificar ni crear ningún almacenamiento. Este comando se utiliza principalmente internamente para introducir automáticamente dispositivos de almacenamiento conectados en caliente.
vdi-list-changed-blocks
xe vdi-list-changed-blocks vdi-from-uuid=first-vdi-uuid vdi-to-uuid=second-vdi-uuid
<!--NeedCopy-->
Compare dos VDI y devuelva la lista de bloques que han cambiado entre los dos como una cadena codificada en base64. Este comando solo funciona para las VDI que tienen habilitado el seguimiento de bloques modificado.
Para obtener más información, consulte Seguimiento de bloques modificado.
vdi-pool-migrate
xe vdi-pool-migrate uuid=VDI_uuid sr-uuid=destination-sr-uuid
<!--NeedCopy-->
Migre una VDI a un SR especificado, mientras la VDI está asociada a un invitado en ejecución. (Migración en vivo de almacenamiento)
Para obtener más información, consulte Migración de máquinas virtuales.
vdi-resize
xe vdi-resize uuid=vdi_uuid disk-size=new_size_for_disk
<!--NeedCopy-->
Cambie el tamaño de la VDI especificada por UUID.
vdi-snapshot
xe vdi-snapshot uuid=uuid_of_the_vdi [driver-params=params]
<!--NeedCopy-->
Produce una versión de lectura y escritura de una VDI que se puede utilizar como referencia para fines de copia 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 externo transmite el contenido de la instantánea a los medios de copia de seguridad. Del mismo modo, una instantánea se puede utilizar como una “imagen de oro” en la que basar una plantilla. Se puede crear una plantilla utilizando cualquier VDI.
Utilice la opción parámetros del controlador
map para pasar información de configuración adicional específica del proveedor al controlador de almacenamiento back-end en el que se basa la VDI. Para obtener más información, consulte la documentación del controlador del proveedor de almacenamiento.
Un clon de una instantánea siempre genera una VDI grabable.
vdi-unlock
xe vdi-unlock uuid=uuid_of_vdi_to_unlock [force=true]
<!--NeedCopy-->
Intenta desbloquear los VDI especificados. Si fuerza=verdadero
se pasa al comando, fuerza la operación de desbloqueo.
vdi-update
xe vdi-update uuid=uuid
<!--NeedCopy-->
Actualice los campos del objeto VDI en la base de datos.
Comandos VIF
Comandos para trabajar con VIF (interfaces de red virtual).
Los objetos VIF se pueden enumerar con el comando estándar de listado 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
Las VIF tienen los siguientes parámetros:
-
uuid
(solo lectura) el identificador único/referencia de objeto para el VIF -
vm-uuid
(solo lectura) el identificador único/referencia de objeto para la máquina virtual en la que reside esta VIF -
etiqueta-de-nombre-vm
(solo lectura) el nombre de la máquina virtual en la que reside esta VIF -
operaciones-permitidas
(parámetro set de solo lectura) una lista de las operaciones permitidas en este estado -
operaciones-actuales
(parámetro de conjunto de solo lectura) una lista de las operaciones que están actualmente en curso en esta VIF -
dispositivo
(solo lectura) de este VIF, que indica el orden en el que se crearon los back-ends de VIF -
MAC
(solo lectura) Dirección MAC de VIF, tal como se expone a la máquina virtual -
MTU
(solo lectura) Unidad máxima de transmisión del VIF en bytes.Este parámetro es de solo lectura, pero puede anular la configuración de MTU con el parámetro
Mtu
usando la teclaotra-configuración
map. Por ejemplo, para restablecer la MTU en una NIC virtual para usar tramas gigantes:xe vif-param-set \ uuid=<vif_uuid> \ other-config:mtu=9000 <!--NeedCopy-->
-
Adjunto actualmente
(solo lectura) true si el dispositivo está conectado -
qos_algorithm_type
(lectura/escritura) Algoritmo QoS a utilizar -
qos_algorithm_params
(parámetro de mapa de lectura/escritura) para el algoritmo QoS elegido -
qos_supported_algorithms
(parámetro de conjunto de solo lectura) algoritmos de QoS compatibles para este VIF -
MAC autogenerado
(solo lectura) True si la dirección MAC de la VIF se generó automáticamente -
otra-configuración
(parámetro de mapa de lectura/escritura) configuración adicionalclave:valor
Pares -
otro-config:ethtoolrx
(lectura/escritura) establézcalo en activado para habilitar la suma de comprobación de recepción, desactivado para deshabilitar -
otro-config:ethtooltx
(lectura/escritura) establézcalo en activado para habilitar la suma de comprobación de transmisión, desactivado para deshabilitar -
otro-config:ethtoolsg
(lectura/escritura) Establézcalo en Activado para habilitar la recolección de dispersión, Desactivado para Deshabilitar -
otro-config:ethtooltso
(lectura/escritura) establecido en on para habilitar la descarga de segmentación TCP, off para deshabilitar -
other-config:ethtoolufo
(lectura/escritura) establecido en on para habilitar la descarga de fragmentos UDP, off para deshabilitar -
otro-config:ethtoolgso
(lectura/escritura) establézcalo en activado para habilitar la descarga de segmentación genérica, desactivado para deshabilitar -
other-config:promiscuous
(lectura/escritura) true a un VIF para que sea promiscuo en el puente, de modo que vea todo el tráfico sobre el puente. Útil para ejecutar un sistema de detección de intrusos (IDS) o similar en una máquina virtual. -
red-uuid
(solo lectura) el identificador único/referencia de objeto de la red virtual a la que está conectada esta VIF -
etiqueta-de-nombre-de-red
(solo lectura) el nombre descriptivo de la red virtual a la que está conectada esta VIF -
io_read_kbs
Velocidad de lectura media (solo lectura) en kB/s para este VIF -
io_write_kbs
Velocidad media de escritura (solo lectura) en kB/s para este VIF -
locking_mode
(lectura/escritura) Afecta a la capacidad de las VIF para filtrar el tráfico hacia/desde una lista de direcciones MAC e IP. Requiere parámetros adicionales. -
locking_mode:por defecto
(lectura/escritura) Varía según el modo de bloqueo predeterminado para la red VIF.Si el default-locking-mode se establece en
Deshabilitado
, XenServer aplica una regla de filtrado para que la VIF no pueda enviar ni recibir tráfico. Si default-lockingmode se establece enDesbloqueado
, XenServer elimina todas las reglas de filtrado asociadas con el VIF. Para obtener más información, consulte Comandos de red. -
locking_mode:bloqueado
(lectura/escritura) Solo se permite el tráfico enviado o enviado desde las direcciones MAC e IP especificadas en el VIF. Si no se especifica ninguna dirección IP, no se permite ningún tráfico. -
locking_mode:desbloqueado
(lectura/escritura) No se aplican filtros a ningún tráfico que vaya hacia o desde el VIF. -
locking_mode:deshabilitado
(lectura/escritura) XenServer aplica una regla de filtrado para que el VIF descarte todo el tráfico.
vif-create
xe vif-create vm-uuid=uuid_of_the_vm device=see below network-uuid=uuid_of_network_to_connect_to [mac=mac_address]
<!--NeedCopy-->
Cree una VIF en una máquina virtual.
Los valores apropiados para el dispositivo
se enumeran en el parámetro Dispositivos VIF permitidos
en la máquina virtual especificada. Antes de que exista ningún VIF allí, los valores permitidos son enteros de 0 a 15.
El Mac
es la dirección MAC estándar en el formulario aa:bb:cc:dd:ee:ff
. Si lo deja sin especificar, se crea una dirección MAC aleatoria adecuada. También puede establecer explícitamente una dirección MAC aleatoria especificando mac=aleatorio
.
vif-destroy
xe vif-destroy uuid=uuid_of_vif
<!--NeedCopy-->
Destruye un VIF.
vif-move
xe vif-move uuid=uuid network-uuid=network_uuid
<!--NeedCopy-->
Mueva el VIF a otra red.
vif-plug
xe vif-plug uuid=uuid_of_vif
<!--NeedCopy-->
Intente conectar la VIF mientras la máquina virtual está en estado de ejecución.
vif-unplug
xe vif-unplug uuid=uuid_of_vif
<!--NeedCopy-->
Intenta desasociar la VIF de la máquina virtual mientras se está ejecutando.
vif-configure-ipv4
Configure los ajustes de IPv4 para esta interfaz virtual. Establezca la configuración de IPv4 de la siguiente manera:
xe vif-configure-ipv4 uuid=uuid_of_vif mode=static address=CIDR_address gateway=gateway_address
<!--NeedCopy-->
Por ejemplo:
VIF.configure_ipv4(vifObject,"static", " 192.168.1.10/24", " 192.168.1.1")
<!--NeedCopy-->
Limpie la configuración de IPv4 de la siguiente manera:
xe vif-configure-ipv4 uuid=uuid_of_vif mode=none
<!--NeedCopy-->
vif-configure-ipv6
Configure los ajustes de IPv6 para esta interfaz virtual. Establezca la configuración de IPv6 de la siguiente manera:
xe vif-configure-ipv6 uuid=uuid_of_vif mode=static address=IP_address gateway=gateway_address
<!--NeedCopy-->
Por ejemplo:
VIF.configure_ipv6(vifObject,"static", "fd06:7768:b9e5:8b00::5001/64", "fd06:7768:b9e5:8b00::1")
<!--NeedCopy-->
Limpie la configuración de IPv6 de la siguiente manera:
xe vif-configure-ipv6 uuid=uuid_of_vif mode=none
<!--NeedCopy-->
Comandos VLAN
Comandos para trabajar con VLAN (redes virtuales). Para enumerar y editar interfaces virtuales, consulte los comandos PIF, que tienen un parámetro VLAN para indicar que tienen una red virtual asociada. Para obtener más información, consulte Comandos PIF. Por ejemplo, para enumerar las VLAN, utilice Lista de pifs xe
.
vlan-create
xe vlan-create pif-uuid=uuid_of_pif vlan=vlan_number network-uuid=uuid_of_network
<!--NeedCopy-->
Cree una VLAN en el host de XenServer.
pool-vlan-create
xe pool-vlan-create pif-uuid=uuid_of_pif vlan=vlan_number network-uuid=uuid_of_network
<!--NeedCopy-->
Cree una VLAN en todos los hosts de un grupo, determinando qué interfaz (por ejemplo, eth0
) la red especificada está activada (en cada host) y creando y conectando un nuevo objeto PIF en cada host en consecuencia.
vlan-destroy
xe vlan-destroy uuid=uuid_of_pif_mapped_to_vlan
<!--NeedCopy-->
Destruye una VLAN. Requiere el UUID del PIF que representa la VLAN.
Comandos de VM
Comandos para controlar las máquinas virtuales y sus atributos.
Selectores de VM
Varios de los comandos enumerados aquí tienen un mecanismo común para seleccionar una o varias máquinas virtuales en las que realizar la operación. La forma más sencilla es proporcionando el argumento vm=name_or_uuid
. Una manera sencilla de obtener el uuid de una máquina virtual real es, por ejemplo, ejecutar xe vm-list power-state=en ejecución
. (Obtenga la lista completa de campos que se pueden hacer coincidir mediante el comando xe vm-list params=all
. ) Por ejemplo, especificando estado-de-energía=detenido
selecciona las máquinas virtuales cuya estado-energía
El parámetro es igual a detenido
. Cuando coincidan varias máquinas virtuales, especifique la opción --múltiple
para realizar la operación. La lista completa de parámetros que se pueden hacer coincidir se describe al principio de esta sección.
Los objetos 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: No
Todos los valores de los parámetros de máquina virtual grabables se pueden cambiar mientras la máquina virtual se está ejecutando, pero los nuevos parámetros se no se aplica dinámicamente y no se puede aplicar hasta que se reinicie la máquina virtual.
-
aparato
(lectura/escritura) el dispositivo/vApp al que pertenece la máquina virtual -
uuid
(solo lectura) el identificador único/referencia de objeto para la máquina virtual -
nombre-etiqueta
(lectura/escritura) el nombre de la máquina virtual -
nombre-descripción
(lectura/escritura) la cadena de descripción de la máquina virtual -
orden
(lectura/escritura) para el inicio/apagado de vApp y para el inicio después de la conmutación por error de alta disponibilidad. Las máquinas virtuales con un valor de pedido de 0 (cero) se inician primero, luego las máquinas virtuales con un valor de pedido de 1, y así sucesivamente. -
Versión
(solo lectura) el número de veces que se ha recuperado esta máquina virtual. Si desea sobrescribir una nueva máquina virtual con una versión anterior, llame aRecuperación de VM
-
versión-usuario
(lectura/escritura) para que los creadores de máquinas virtuales y plantillas coloquen información de versión -
es-una-plantilla
(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 usan para clonar otras máquinas virtuales. Una vez que este valor se ha establecido en true, no se puede restablecer a false. Las máquinas virtuales de plantilla no se pueden convertir en máquinas virtuales con este parámetro.Puede convertir una máquina virtual en una plantilla con:
xe vm-param-set uuid=<vm uuid> is-a-template=true <!--NeedCopy-->
-
dominio-de-control-es
(solo lectura) True si se trata de un dominio de control (dominio 0 o dominio de controlador) -
estado-energía
(solo lectura) estado de energía actual -
retardo de inicio
(lectura/escritura) el retraso que se debe esperar antes de que una llamada para iniciar la máquina virtual se devuelva en segundos -
retardo de apagado
(lectura/escritura) el retraso que se debe esperar antes de que una llamada para apagar la máquina virtual se devuelva en segundos -
memoria-dinámica-max
(lectura/escritura) dinámico máximo en bytes -
memoria-dinámica-min
(lectura/escritura) dinámico mínimo en bytes -
memoria-estática-max
(lectura/escritura) establece estáticamente el máximo (absoluto) en bytes. Si desea cambiar este valor, la máquina virtual debe estar apagada. -
memoria-estática-min
(lectura/escritura) establece estáticamente el mínimo (absoluto) en bytes. Si desea cambiar este valor, la máquina virtual debe estar apagada. -
suspend-VDI-uuid
(solo lectura) el VDI en el que se almacena una imagen de suspensión -
VCPUs-params
(parámetro de mapa de lectura/escritura) para la política de vCPU seleccionada.Puede ajustar el anclaje de una vCPU con
xe vm-param-set uuid=<vm_uuid> VCPUs-params:mask=1,2,3 <!--NeedCopy-->
A continuación, la máquina virtual seleccionada solo se ejecuta en las CPU físicas 1, 2 y 3. También puede ajustar la prioridad de vCPU (programación xen) con los parámetros cap y weight. Por ejemplo:
xe vm-param-set uuid=<vm_uuid> VCPUs-params:weight=512 xe vm-param-set uuid=<vm_uuid> VCPUs-params:cap=100 <!--NeedCopy-->
Una máquina virtual con un peso de 512 obtiene el doble de CPU que un dominio con un peso de 256 en un host de XenServer en disputa. Los pesos legales oscilan entre 1 y 65535 y el valor predeterminado es 256. El límite fija opcionalmente la cantidad máxima de CPU que una máquina virtual podrá consumir, incluso si el host de XenServer 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 la mitad de una CPU, 400 son 4 CPU, y así sucesivamente.
-
VCPUs-max
(lectura/escritura) número máximo de CPU virtuales. -
VCPU en inicio
(lectura/escritura) número de arranque de las CPU virtuales -
actions-after-crash
(read/write) action to take if the VM crashes. For PV guests, valid parameters are:-
preservar
(solo para análisis) -
coredump_and_restart
(grabar un volcado de memoria y reiniciar la máquina virtual) -
coredump_and_destroy
(grabar un volcado de memoria y dejar la máquina virtual detenida) -
reanudar
(sin volcado de núcleo y reinicio de la máquina virtual) -
destruir
(sin volcado de núcleo y deje la máquina virtual detenida)
-
-
console-uuids
(parámetro de conjunto de solo lectura) Dispositivos de consola virtual -
plataforma
(parámetro de mapa de lectura/escritura) Configuración específica de la plataformaPara inhabilitar el VDA para cambiar Windows 10 al modo Tableta:
xe vm-param-set uuid=<vm_uuid> platform:acpi_laptop_slate=0 <!--NeedCopy-->
Para permitir que el VDA cambie Windows 10 al modo Tableta:
xe vm-param-set uuid=<vm_uuid> platform:acpi_laptop_slate=1 <!--NeedCopy-->
Para comprobar el estado actual:
xe vm-param-get uuid=<vm_uuid> param-name=platform param-key=acpi_laptop_slate <!--NeedCopy-->
-
operaciones-permitidas
(parámetro de conjunto de solo lectura) lista de las operaciones permitidas en este estado -
operaciones-actuales
(parámetro set de solo lectura) una lista de las operaciones que están actualmente en curso en la máquina virtual -
Dispositivos VBD permitidos
(parámetro de conjunto de solo lectura) lista de identificadores VBD disponibles para su uso, representados por números enteros del rango 0 a 15. Esta lista es solo informativa y se pueden usar otros dispositivos (pero es posible que no funcionen). -
Dispositivos VIF permitidos
(parámetro de conjunto de solo lectura) lista de identificadores VIF disponibles para su uso, representados por números enteros del rango 0 a 15. Esta lista es solo informativa y se pueden usar otros dispositivos (pero es posible que no funcionen). -
Política de arranque de HVM
(lectura/escritura) la política de arranque para los invitados. Orden del BIOS o una cadena vacía. -
HVM-boot-params
(parámetro de mapa de lectura/escritura) la tecla order controla el orden de arranque del invitado, representado como una cadena donde cada carácter es un método de arranque: d para el CD/DVD, c para el disco raíz y n para el arranque PXE de red. El valor predeterminado es dc. -
HVM-shadow-multiplier
(lectura/escritura) Valor de punto flotante que controla la cantidad de sobrecarga de memoria de sombra que se va a conceder a la máquina virtual. El valor predeterminado es 1.0 (el valor mínimo) y solo cambia este valor si es un usuario avanzado. -
Kernel PV
(lectura/escritura) al kernel -
PV-ramdisk
(lectura/escritura) a la ruta de accesoinitrd
-
PV-args
(lectura/escritura) de argumentos de la línea de comandos del kernel -
PV-legacy-args
(lectura/escritura) de argumentos para hacer que las máquinas virtuales heredadas arranquen -
Cargador de arranque PV
(lectura/escritura) nombre o ruta al gestor de arranque -
PV-bootloader-args
(lectura/escritura) cadena de argumentos misceláneos para el gestor de arranque -
banderas-de-CPU-de-last-boot
(solo lectura) describe las marcas de CPU en las que se arrancó la máquina virtual por última vez -
Residente en
(solo lectura) el host de XenServer en el que reside una máquina virtual -
afinidad
(lectura/escritura) El host de XenServer en el que la máquina virtual tiene preferencia para ejecutarse. Utilizado por elxe vm-start
para decidir dónde ejecutar la máquina virtual. También conocido como el servidor doméstico. -
grupos
(lectura/escritura) el grupo de máquinas virtuales al que pertenece esta máquina virtual. Un grupo de máquinas virtuales define dónde XenServer intenta iniciar la máquina virtual o evacuarla. -
otra-configuración
(parámetro de mapa de lectura/escritura) Una lista de pares clave-valor que especifican parámetros de configuración adicionales para la máquina virtual.Por ejemplo, el
otra-configuración
Par clave/valorauto_poweron: Verdadero
solicitudes para iniciar la máquina virtual automáticamente después de que se inicie cualquier host en el grupo. También debe establecer este parámetro en el archivootra-configuración
. Estos parámetros ahora están en desuso. Utilice la funciónha-restart-priority
en su lugar. -
Hora de inicio
(solo lectura) marca de tiempo de la fecha y hora en que se leyeron las métricas de la máquina virtual. Esta marca de tiempo está en el formularioaaaammddThh:mm:ss z
, donde z es el indicador de zona horaria militar de una sola letra, por ejemplo, Z para UTC (GMT) -
tiempo de instalación
(solo lectura) marca de tiempo de la fecha y hora en que se leyeron las métricas de la máquina virtual. Esta marca de tiempo está en el formularioaaaammddThh:mm:ss z
, donde z es el indicador de zona horaria militar de una sola letra, por ejemplo, Z para UTC (GMT) -
memoria-real
(solo lectura) la memoria real que usa una máquina virtual -
Número de VCPUs
(solo lectura) el número de CPU virtuales asignadas a la máquina virtual para una máquina virtual Linux. Este número puede diferir deVCPUS-max
y se puede cambiar sin reiniciar la máquina virtual mediante el comandovm-vcpu-hotplug
mandar. Para obtener más información, consultevm-vcpu-hotplug
. Las máquinas virtuales Windows siempre se ejecutan con el número de vCPU establecido enVCPUsmax
y debe reiniciarse para cambiar este valor. El rendimiento cae bruscamente cuando se configuraNúmero de VCPUs
a un valor mayor que el número de CPU físicas en el host de XenServer. -
Utilización de VCPUs
(parámetro de mapa de solo lectura) una lista de CPU virtuales y su peso -
versión-sistema operativo
(parámetro de mapa de solo lectura) la versión del sistema operativo para la máquina virtual -
Versión-de-controladores-PV
(parámetro de mapa de solo lectura) las versiones de los controladores paravirtualizados para la máquina virtual -
Controladores PV detectados
(solo lectura) para la versión más reciente de los controladores paravirtualizados para la máquina virtual -
memoria
(parámetro de mapa de solo lectura) métricas de memoria notificadas por el agente en la máquina virtual -
Discos
(parámetro de mapa de solo lectura) métricas de disco notificadas por el agente en la máquina virtual -
redes
(parámetro de mapa de solo lectura) métricas de red notificadas por el agente en la máquina virtual -
Otro
(parámetro de mapa de solo lectura) otras métricas notificadas por el agente en la máquina virtual -
guest-metrics-lastupdated
(solo lectura) cuando el agente invitado realizó la última escritura en estos campos. La marca de tiempo está en el formularioaaaammddThh:mm:ss z
, donde z es el indicador de zona horaria militar de una sola letra, por ejemplo, Z para UTC (GMT) -
acciones-pos-apagado
(lectura/escritura) acción que se debe realizar después de que la máquina virtual se haya apagado -
acciones-después-de-reiniciar
(lectura/escritura) acción que se debe realizar después de que la máquina virtual se haya reiniciado -
anfitriones-posibles
hosts potenciales de esta máquina virtual de solo lectura -
Dom-ID
(solo lectura) ID de dominio (si está disponible, -1 en caso contrario) -
Recomendaciones
(solo lectura) Especificación XML de los valores y rangos recomendados para las propiedades de esta máquina virtual -
xenstore-datos
(parámetro de mapa de lectura/escritura) que se insertarán en elXenstore
árbol (/local/*domid*/vm-data
) después de crear la máquina virtual -
es-una-instantánea
(solo lectura) True si esta máquina virtual es una instantánea -
snapshot_of
(solo lectura) el UUID de la máquina virtual de la que procede esta instantánea -
Instantáneas
(solo lectura) los UUID de todas las instantáneas de esta máquina virtual -
snapshot_time
(solo lectura) la marca de tiempo de la operación de instantánea que creó esta instantánea de máquina virtual -
objetivo-memoria
(solo lectura) la cantidad de memoria de destino establecida para esta máquina virtual -
Operaciones bloqueadas
(parámetro de mapa de lectura/escritura) enumera las operaciones que no se pueden realizar en esta máquina virtual -
último-registro-de-arranque
(solo lectura) registro de los últimos parámetros de arranque para esta plantilla, en formato XML -
ha-siempre-correr
(lectura/escritura) True si esta máquina virtual siempre se reinicia en otro host si se produce un error en el host en el que reside. Este parámetro ahora está en desuso. Utilice la funciónha-restart-priority
en su lugar. -
ha-restart-priority
(lectura/escritura) reinicio o mejor esfuerzo -
Blobs
(solo lectura) Almacén de datos binarios -
vivir
(solo 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
xe vm-assert-can-be-recovered uuid [database] vdi-uuid
<!--NeedCopy-->
Comprueba si el almacenamiento está disponible para recuperar esta máquina virtual.
vm-call-plugin
xe vm-call-plugin vm-uuid=vm_uuid plugin=plugin fn=function [args:key=value]
<!--NeedCopy-->
Llama a la función dentro del complemento en la máquina virtual dada con argumentos opcionales (args:key=value). Para pasar una cadena "value" con caracteres especiales (por ejemplo, new line), se puede usar una sintaxis alternativa args:key:file=local_file en su lugar, donde el contenido de local_file se recuperará y se asignará a "key" como un todo.
vm-cd-add
xe vm-cd-add cd-name=name_of_new_cd device=integer_value_of_an_available_vbd [vm-selector=vm_selector_value...]
<!--NeedCopy-->
Agregue un nuevo CD virtual a la máquina virtual seleccionada. Seleccione la opción dispositivo
del parámetro del parámetro Dispositivos VBD permitidos
de la máquina virtual.
La máquina virtual o las máquinas virtuales en las que se realiza esta operación se seleccionan mediante el mecanismo de selección estándar. Para obtener más información, consulte Selectores de VM. Los argumentos opcionales pueden ser cualquier número de los Parámetros de VM enumerados al principio de esta sección.
vm-cd-eject
xe vm-cd-eject [vm-selector=vm_selector_value...]
<!--NeedCopy-->
Expulse un CD de la unidad de CD virtual. Este comando solo funciona si hay exactamente un CD conectado a la máquina virtual. Cuando haya dos o más CD, utilice el comando xe vbd-eject
y especifique el UUID del VBD.
La máquina virtual o las máquinas virtuales en las que se realiza esta operación se seleccionan mediante el mecanismo de selección estándar. Para obtener más información, consulte Selectores de VM. Los argumentos opcionales pueden ser cualquier número de los Parámetros de VM enumerados al principio de esta sección.
vm-cd-insert
xe vm-cd-insert cd-name=name_of_cd [vm-selector=vm_selector_value...]
<!--NeedCopy-->
Inserte un CD en la unidad de CD virtual. Este comando solo funciona si hay exactamente un dispositivo de CD vacío conectado a la máquina virtual. Cuando haya dos o más dispositivos de CD vacíos, utilice el botón xe vbd-inserto
y especifique los UUID del VBD y del VDI que se van a insertar.
La máquina virtual o las máquinas virtuales en las que se realiza esta operación se seleccionan mediante el mecanismo de selección estándar. Para obtener más información, consulte Selectores de VM. Los argumentos opcionales pueden ser cualquier número de los Parámetros de VM enumerados al principio de esta sección.
vm-cd-list
xe vm-cd-list [vbd-params] [vdi-params] [vm-selector=vm_selector_value...]
<!--NeedCopy-->
Enumera los CD conectados 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 de VBD y VDI que desea enumerar.
vm-cd-remove
xe vm-cd-remove cd-name=name_of_cd [vm-selector=vm_selector_value...]
<!--NeedCopy-->
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
xe vm-checkpoint new-name-label=name_label [new-name-description=description]
<!--NeedCopy-->
Establezca un punto de control en una máquina virtual existente, mediante la operación de instantánea de disco rápida a nivel de almacenamiento cuando esté disponible.
vm-clone
xe vm-clone new-name-label=name_for_clone [new-name-description=description_for_clone] [vm-selector=vm_selector_value...]
<!--NeedCopy-->
Clonar una máquina virtual existente mediante la operación de clonación rápida de disco a nivel de almacenamiento, cuando esté disponible. Especifique el nombre y la descripción opcional de la máquina virtual clonada resultante mediante el comando nueva-etiqueta-de-nombre
y nuevo-nombre-de-de-cambio
Argumentos.
La máquina virtual o las máquinas virtuales en las que se realiza esta operación se seleccionan mediante el mecanismo de selección estándar. Para obtener más información, consulte Selectores de VM. Los argumentos opcionales pueden ser cualquier número de los Parámetros de VM enumerados al principio de esta sección.
vm-compute-maximum-memory
xe vm-compute-maximum-memory total=amount_of_available_physical_ram_in_bytes [approximate=add overhead memory for additional vCPUS? true|false] [vm_selector=vm_selector_value...]
<!--NeedCopy-->
Calcule la cantidad máxima de memoria estática que se puede asignar a una máquina virtual existente, utilizando la cantidad total de RAM física como límite superior. El parámetro opcional aproximado
reserva suficiente memoria adicional en el cálculo para tener en cuenta la adición de vCPU adicionales a la máquina virtual más adelante.
Por ejemplo:
xe vm-compute-maximum-memory vm=testvm total=`xe host-list params=memory-free --minimal`
<!--NeedCopy-->
Este comando utiliza el valor de la propiedad Sin memoria
parámetro devuelto por el parámetro xe lista-de-host
para establecer la memoria máxima de la máquina virtual denominada testvm
.
La máquina virtual o las máquinas virtuales en las que se realiza esta operación se seleccionan mediante el mecanismo de selección estándar. Para obtener más información, consulte Selectores de VM. Los argumentos opcionales pueden ser cualquier número de los Parámetros de VM enumerados al principio de esta sección.
vm-compute-memory-overhead
xe vm-compute-memory-overhead
<!--NeedCopy-->
Calcula la sobrecarga de memoria de virtualización de una máquina virtual.
vm-copy
xe vm-copy new-name-label=name_for_copy [new-name-description=description_for_copy] [sr-uuid=uuid_of_sr] [vm-selector=vm_selector_value...]
<!--NeedCopy-->
Copie una máquina virtual existente, pero sin usar la operación de clonación rápida de disco a nivel de almacenamiento (incluso si esta opción está disponible). Se garantiza que las imágenes de disco de la máquina virtual copiada son Imágenes completas, es decir, que no forma parte de una cadena de copia en escritura (CoW).
Especifique el nombre y la descripción opcional de la máquina virtual copiada resultante mediante el comando nueva-etiqueta-de-nombre
y nuevo-nombre-de-de-cambio
Argumentos.
Especifique el SR de destino para la máquina virtual copiada resultante mediante el comando sr-uuid
. Si no se especifica este parámetro, el destino es el mismo SR en el que se encuentra la máquina virtual original.
La máquina virtual o las máquinas virtuales en las que se realiza esta operación se seleccionan mediante el mecanismo de selección estándar. Para obtener más información, consulte Selectores de VM. Los argumentos opcionales pueden ser cualquier número de los Parámetros de VM enumerados al principio de esta sección.
vm-copy-bios-strings
xe vm-copy-bios-strings host-uuid=host_uuid
<!--NeedCopy-->
Copie las cadenas del BIOS del host especificado en la máquina virtual.
Nota: No
Después de iniciar una máquina virtual por primera vez, no puede cambiar sus cadenas de BIOS. Asegúrese de que las cadenas del BIOS sean correctas antes de iniciar la máquina virtual por primera vez.
vm-crashdump-list
xe vm-crashdump-list [vm-selector=vm selector value...]
<!--NeedCopy-->
Enumere los volcados de memoria asociados a las máquinas virtuales especificadas.
Cuando se utiliza el argumento opcional Parámetros
, 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 todo
para mostrar todos los parámetros. Si Parámetros
no 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
xe vm-data-source-list [vm-selector=vm selector value...]
<!--NeedCopy-->
Enumere los orígenes de datos que se pueden registrar para una máquina virtual.
Seleccione 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: estándar
y Habilitado
– que se puede ver en la salida de este comando. Si una fuente de datos tiene Habilitado
Establézcalo en verdadero
, las métricas se están registrando actualmente en la base de datos de rendimiento. Si una fuente de datos tiene estándar
Establézcalo en verdadero
, las métricas se registran en la base de datos de rendimiento de forma predeterminada (y Habilitado
también se establece en verdadero
para esta fuente de datos). Si una fuente de datos tiene estándar
Establézcalo en falso
, las métricas son no registrado en la base de datos de rendimiento de forma predeterminada (y Habilitado
también se establece en falso
para esta fuente de datos).
Para empezar a registrar métricas de origen de datos en la base de datos de rendimiento, ejecute el comando vm-registro-fuente-de-datos
mandar. Este comando establece Habilitado
Para verdadero
. Para detenerse, ejecute el comando vm-data-source-forget
. Este comando establece Habilitado
Para falso
.
vm-data-source-record
xe vm-data-source-record data-source=name_description_of_data-source [vm-selector=vm selector value...]
<!--NeedCopy-->
Registre el origen de datos especificado para una máquina virtual.
Esta operación escribe la información del origen de datos en la base de datos de métricas de rendimiento persistente de las máquinas virtuales especificadas. Por razones de rendimiento, esta base de datos es distinta de la base de datos de agente normal.
Seleccione 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
xe vm-data-source-forget data-source=name_description_of_data-source [vm-selector=vm selector value...]
<!--NeedCopy-->
Detenga la grabación de la fuente de datos especificada para una máquina virtual y olvide todos los datos registrados.
Seleccione 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
xe vm-data-source-query data-source=name_description_of_data-source [vm-selector=vm_selector_value...]
<!--NeedCopy-->
Muestra el origen de datos especificado para una máquina virtual.
Seleccione 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
xe vm-destroy uuid=uuid_of_vm
<!--NeedCopy-->
Destruya la máquina virtual especificada. Esto deja intacto el almacenamiento asociado a la máquina virtual. Para eliminar también el almacenamiento, use xe vm-uninstall
.
vm-disk-add
xe vm-disk-add disk-size=size_of_disk_to_add device=uuid_of_device [vm-selector=vm_selector_value...]
<!--NeedCopy-->
Agregue un disco a las máquinas virtuales especificadas. Seleccione la opción dispositivo
del parámetro del parámetro Dispositivos VBD permitidos
de las máquinas virtuales.
El tamaño de disco
se puede especificar en bytes o mediante los sufijos estándar IEC KiB, MiB, GiB y TiB.
La máquina virtual o las máquinas virtuales en las que se realiza esta operación se seleccionan mediante el mecanismo de selección estándar. Para obtener más información, consulte Selectores de VM. Los argumentos opcionales pueden ser cualquier número de los Parámetros de VM enumerados al principio de esta sección.
vm-disk-list
xe vm-disk-list [vbd-params] [vdi-params] [vm-selector=vm_selector_value...]
<!--NeedCopy-->
Enumera los discos conectados a las máquinas virtuales especificadas. El vbd-params
y Parámetros vdi
Los parámetros controlan los campos de los objetos respectivos que se van a generar. Proporcione los parámetros como una lista separada por comas, o la clave especial todo
para ver la lista completa.
La máquina virtual o las máquinas virtuales en las que se realiza esta operación se seleccionan mediante el mecanismo de selección estándar. Para obtener más información, consulte Selectores de VM. Los argumentos opcionales pueden ser cualquier número de los Parámetros de VM enumerados al principio de esta sección.
vm-disk-remove
xe vm-disk-remove device=integer_label_of_disk [vm-selector=vm_selector_value...]
<!--NeedCopy-->
Quite un disco de las máquinas virtuales especificadas y destrúyalo.
La máquina virtual o las máquinas virtuales en las que se realiza esta operación se seleccionan mediante el mecanismo de selección estándar. Para obtener más información, consulte Selectores de VM. Los argumentos opcionales pueden ser cualquier número de los Parámetros de VM enumerados al principio de esta sección.
vm-export
xe vm-export filename=export_filename [metadata=true|false] [vm-selector=vm_selector_value...]
<!--NeedCopy-->
Exporte las máquinas virtuales especificadas (incluidas las imágenes de disco) a un archivo del equipo local. Especifique el nombre de archivo al que se exportará la máquina virtual mediante el comando Nombre
parámetro. Por convención, el nombre del archivo tiene un .xva
extensión.
Si el metadatos
El parámetro es verdadero
, los discos no se exportan. Solo los metadatos de la máquina virtual 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 Importación de 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-import
xe vm-import filename=export_filename [metadata=true|false] [preserve=true|false][sr-uuid=destination_sr_uuid]
<!--NeedCopy-->
Importar una máquina virtual desde un archivo exportado anteriormente. Si preservar
se establece en verdadero
, se conserva la dirección MAC de la máquina virtual original. El sr-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.
Si el metadatos
es verdadero
, puede importar un conjunto de metadatos exportados previamente sin sus bloques de disco asociados. Se produce un error en la importación de solo metadatos si no se encuentra ningún VDI (denominado por SR y VDI.location
) a menos que el --fuerza
se especifica la opción, en cuyo caso la importación procede 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 inconexos. Por ejemplo, como parte de un plan de recuperación ante desastres.
Nota: No
Las importaciones de varias máquinas virtuales se realizan más rápido en serie que en paralelo.
vm-install
xe vm-install new-name-label=name [template-uuid=uuid_of_desired_template] [template=template_uuid_or_name] [sr-uuid=sr_uuid | sr-name-label=name_of_sr][copy-bios-strings-from=host_uuid]
<!--NeedCopy-->
Instale o clone una máquina virtual a partir de una plantilla. Especifique el nombre de la plantilla mediante la opción plantilla-uuid
o plantilla
argumento. Especifique un SR utilizando el sr-uuid
o sr-nombre-etiqueta
argumento. Especifique la instalación de medios bloqueados por el BIOS mediante el comando copiar-bios-cadenas-desde
argumento.
Nota: No
Al instalar desde una plantilla que tiene discos existentes, de forma predeterminada, los nuevos discos se crean en el mismo SR que estos discos existentes. Cuando el SR lo admite, estos discos son copias rápidas. Si se especifica un SR diferente en la línea de comandos, los nuevos discos se crean allí. En este caso, una copia rápida no es posible y los discos son copias completas.
Al instalar desde una plantilla que no tiene discos existentes, los discos nuevos se crean en el SR especificado o en el SR predeterminado del grupo cuando no se especifica un SR.
vm-is-bios-customized
xe vm-is-bios-customized
<!--NeedCopy-->
Indica si las cadenas del BIOS de la máquina virtual se han personalizado.
vm-memory-dynamic-range-set
xe vm-memory-dynamic-range-set min=min max=max
<!--NeedCopy-->
Configure el rango de memoria dinámica de una máquina virtual. El rango de memoria dinámica define los límites inferior y superior suaves para la memoria de una máquina virtual. Es posible cambiar estos campos cuando una máquina virtual se está ejecutando o detenida. El rango dinámico debe ajustarse al rango estático.
vm-memory-limits-set
xe vm-memory-limits-set static-min=static_min static-max=static_max dynamic-min=dynamic_min dynamic-max=dynamic_max
<!--NeedCopy-->
Configure los límites de memoria de una máquina virtual.
vm-memory-set
xe vm-memory-set memory=memory
<!--NeedCopy-->
Configure la asignación de memoria de una máquina virtual.
vm-memory-shadow-multiplier-set
xe vm-memory-shadow-multiplier-set [vm-selector=vm_selector_value...] [multiplier=float_memory_multiplier]
<!--NeedCopy-->
Establezca el multiplicador de memoria de sombra para la máquina virtual especificada.
Esta es una opción avanzada que modifica la cantidad de Memoria en la sombra asignada a una máquina virtual asistida por hardware.
En algunas cargas de trabajo de aplicaciones especializadas, como Citrix Virtual Apps, se requiere memoria de sombra adicional para lograr el rendimiento completo.
Esta memoria se considera una sobrecarga. Se separa de los cálculos de memoria normales para contabilizar la memoria de una máquina virtual. Cuando se invoca este comando, la cantidad de memoria libre del host disminuye según el multiplicador y el HVM_shadow_multiplier
se actualiza con el valor que Xen ha asignado a la máquina virtual. Si no hay suficiente memoria libre del host de XenServer, se devuelve un error.
Las máquinas virtuales en las que se va a realizar esta operación se seleccionan mediante el mecanismo de selección estándar. Para obtener más información, consulte Selectores de VM.
vm-memory-static-range-set
xe vm-memory-static-range-set min=min max=max
<!--NeedCopy-->
Configure el intervalo de memoria estática de una máquina virtual. El intervalo de memoria estática define los límites superior e inferior estricto de la memoria de una máquina virtual. Solo es posible cambiar estos campos cuando se detiene una máquina virtual. El rango estático debe abarcar el rango dinámico.
vm-memory-target-set
xe vm-memory-target-set target=target
<!--NeedCopy-->
Establezca el destino de memoria para una máquina virtual detenida o en ejecución. El valor especificado debe estar dentro del intervalo definido por los valores de memory_static_min y memory_static_max de la máquina virtual.
vm-migrate
xe vm-migrate [compress=true|false] [copy=true|false] [host-uuid=destination_host_uuid] [host=name_or_ uuid_of_destination_host] [force=true|false] [live=true|false] [vm-selector=vm_selector_value...] [remote-master=destination_pool_master_uuid] [remote-username=destination_pool_username] [remote-password=destination_pool_password] [remote-network=destination_pool_network_uuid ][vif:source_vif_uuid=destination_network_uuid] [vdi:vdi_uuid=destination_sr_uuid]
<!--NeedCopy-->
Este comando migra las máquinas virtuales especificadas entre hosts físicos.
El comprimir
anula el parámetro migración-compresión
pool para xe pool-param-set
.
El anfitrión
en el parámetro vm-migrate
puede ser el nombre o el UUID del host de XenServer. Por ejemplo, para migrar la máquina virtual a otro host del grupo, donde los discos de la máquina virtual están en el almacenamiento compartido por ambos hosts:
xe vm-migrate uuid=vm_uuid host-uuid=destination_host_uuid
<!--NeedCopy-->
Para mover máquinas virtuales entre hosts del mismo grupo que no comparten almacenamiento (migración en vivo de almacenamiento):
xe vm-migrate uuid=vm_uuid host-uuid=destination_host_uuid \
remote-master=192.0.2.35 remote-username=username remote-password=password
<!--NeedCopy-->
Para la migración en vivo de almacenamiento, debe proporcionar el nombre de host o la dirección IP, el nombre de usuario y la contraseña del coordinador del grupo, incluso cuando se migra dentro del mismo grupo.
Puede elegir el SR en el que se almacena cada VDI:
xe vm-migrate uuid=vm_uuid remote-master=192.0.2.35 remote-username=username remote-password=password host-uuid=destination_host_uuid \
vdi:vdi_1=destination_sr1_uuid \
vdi:vdi_2=destination_sr2_uuid \
vdi:vdi_3=destination_sr3_uuid
<!--NeedCopy-->
Además, puede elegir la red a la que se va a conectar la máquina virtual después de la migración:
xe vm-migrate uuid=vm_uuid \
vdi1:vdi_1_uuid=destination_sr1_uuid \
vdi2:vdi_2_uuid=destination_sr2_uuid \
vdi3:vdi_3_uuid=destination_sr3_uuid \
vif:source_vif_uuid=destination_network_uuid
<!--NeedCopy-->
Para la migración entre grupos:
xe vm-migrate uuid=vm_uuid remote-master=192.0.2.35 \
remote-username=username remote-password=password \
host-uuid=destination_host_uuid \
vif:source_vif_uuid=destination_network_uuid \
vdi:vdi_uuid=destination_sr_uuid
<!--NeedCopy-->
Para obtener más información sobre la migración en vivo de almacenamiento, la migración en vivo y la migración de VDI en vivo, consulte Migración de máquinas virtuales.
Nota: No
Si está actualizando desde una versión anterior de XenServer o Citrix Hypervisor, es posible que deba apagar y arrancar todas las máquinas virtuales después de migrarlas, para asegurarse de que se seleccionan las nuevas funciones de virtualización.
De forma predeterminada, la máquina virtual se suspende, se migra y se reanuda en el otro host. El vivir
selecciona la migración en vivo. La migración en vivo mantiene la máquina virtual en ejecución mientras se realiza la migración, lo que minimiza el tiempo de inactividad de la máquina virtual. En algunas circunstancias, como las cargas de trabajo con mucha memoria en la máquina virtual, la migración en vivo vuelve al modo predeterminado y suspende la máquina virtual durante un breve período de 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
xe vm-pause
<!--NeedCopy-->
Pausar una máquina virtual en ejecución. Tenga en cuenta que esta operación no libera la memoria asociada (consulte vm-suspender
).
vm-reboot
xe vm-reboot [vm-selector=vm_selector_value...] [force=true]
<!--NeedCopy-->
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.
Utilice la función fuerza
para provocar un reinicio poco agraciado. Donde el apagado es similar a desconectar un servidor físico.
vm-recover
xe vm-recover vm-uuid [database] [vdi-uuid] [force]
<!--NeedCopy-->
Recupera una máquina virtual de la base de datos contenida en el VDI suministrado.
vm-reset-powerstate
xe vm-reset-powerstate [vm-selector=vm_selector_value...] {force=true}
<!--NeedCopy-->
La 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 avanzado solo se utilizará cuando un host miembro de un grupo deje de funcionar. Puede usar este comando para obligar al coordinador del grupo a restablecer el estado de energía de las máquinas virtuales para que sea detenido
. Básicamente, este comando fuerza el bloqueo en la máquina virtual y sus discos para que se pueda iniciar a continuación en otro host de grupo. Esta convocatoria Requiere la marca force que se va a especificar y se produce un error si no está en la línea de comandos.
vm-restart-device-models
xe vm-restart-device-models [vm-selector=vm_selector_value...]
<!--NeedCopy-->
Reinicie el modelo de dispositivo para esta máquina virtual en el host. Mientras se reinicia el modelo de dispositivo, no puede detener, iniciar ni migrar la máquina virtual. Es posible que el usuario final de la máquina virtual vea una ligera pausa y reanudación en su sesión.
Nota: No
Para que la acción de reiniciar el modelo de dispositivo sea compatible con una máquina virtual Windows, la máquina virtual debe tener instaladas las herramientas de máquina virtual de XenServer para Windows.
vm-resume
xe vm-resume [vm-selector=vm_selector_value...] [force=true|false] [on=host_uuid]
<!--NeedCopy-->
Reanude las máquinas virtuales especificadas.
La máquina virtual o las máquinas virtuales en las que se realiza esta operación se seleccionan mediante el mecanismo de selección estándar. Para obtener más información, consulte Selectores de VM. Los argumentos opcionales pueden ser cualquier número de los Parámetros de VM enumerados al principio de esta sección.
Si la máquina virtual se encuentra en un SR compartido en un grupo de hosts, use el comando en
para especificar en qué miembro del grupo se va a iniciar. De forma predeterminada, el sistema determina un host adecuado, que puede ser cualquiera de los miembros del grupo.
vm-retrieve-wlb-recommendations
xe vm-retrieve-wlb-recommendations
<!--NeedCopy-->
Recupere las recomendaciones de equilibrio de carga de trabajo para la máquina virtual seleccionada.
vm-shutdown
xe vm-shutdown [vm-selector=vm_selector_value...] [force=true|false]
<!--NeedCopy-->
Apague la máquina virtual 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 la función fuerza
para provocar un apagado incorrecto, similar a desconectar un servidor físico.
vm-snapshot
xe vm-snapshot new-name-label=name_label [new-name-description+name_description]
<!--NeedCopy-->
Tome una instantánea de una máquina virtual existente, mediante la operación de instantánea de disco rápida a nivel de almacenamiento cuando esté disponible.
vm-start
xe vm-start [vm-selector=vm_selector_value...] [force=true|false] [on=host_uuid] [--multiple]
<!--NeedCopy-->
Inicie las máquinas virtuales especificadas.
La máquina virtual o las máquinas virtuales en las que se realiza esta operación se seleccionan mediante el mecanismo de selección estándar. Para obtener más información, consulte Selectores de VM. Los argumentos opcionales pueden ser cualquier número de los Parámetros de VM enumerados al principio de esta sección.
Si las máquinas virtuales están en un SR compartido en un grupo de hosts, use el comando en
para especificar el miembro del grupo en el que se van a iniciar las máquinas virtuales. De forma predeterminada, el sistema determina un host adecuado, que puede ser cualquiera de los miembros del grupo.
vm-suspend
xe vm-suspend [vm-selector=vm_selector_value...]
<!--NeedCopy-->
Suspenda la máquina virtual especificada.
La máquina virtual o las máquinas virtuales en las que se realiza esta operación se seleccionan mediante el mecanismo de selección estándar. Para obtener más información, consulte Selectores de VM. Los argumentos opcionales pueden ser cualquier número de los Parámetros de VM enumerados al principio de esta sección.
vm-uninstall
xe vm-uninstall [vm-selector=vm_selector_value...] [force=true|false]
<!--NeedCopy-->
Desinstale una máquina virtual, destruyendo sus discos (los VDI marcados como RW y conectados solo a esta máquina virtual) además de su registro de metadatos. Para destruir solo los metadatos de la máquina virtual, use xe vm-destroy
.
La máquina virtual o las máquinas virtuales en las que se realiza esta operación se seleccionan mediante el mecanismo de selección estándar. Para obtener más información, consulte Selectores de VM. Los argumentos opcionales pueden ser cualquier número de los Parámetros de VM enumerados al principio de esta sección.
vm-unpause
xe vm-unpause
<!--NeedCopy-->
Reanudar una máquina virtual en pausa.
vm-vcpu-hotplug
xe vm-vcpu-hotplug new-vcpus=new_total_vcpu_count [vm-selector=vm_selector_value...]
<!--NeedCopy-->
Ajuste dinámicamente el número de vCPU disponibles para una máquina virtual Linux en ejecución. El número de vCPU está limitado por el parámetro VCPUs-max
. Las máquinas virtuales Windows siempre se ejecutan con el número de vCPU establecido en VCPUs-max
y debe reiniciarse para cambiar este valor.
Utilice la función nuevas-vcpus
para definir el nuevo parámetro total número de vCPU que desea tener después de ejecutar este comando. No utilice este parámetro para pasar el número de vCPU que desea agregar. Por ejemplo, si tiene dos vCPU existentes en la máquina virtual y desea agregar dos vCPU más, especifique nuevo-vcpus=4
.
Las máquinas virtuales Linux o Windows en las que se realiza esta operación se seleccionan mediante el mecanismo de selección estándar. Para obtener más información, consulte Selectores de VM. Los argumentos opcionales pueden ser cualquier número de los Parámetros de VM enumerados al principio de esta sección.
Nota: No
Al ejecutar máquinas virtuales Linux sin XenServer VM Tools instalado, ejecute el siguiente comando en la máquina virtual como
raíz
para asegurarse de que se utilizan las vCPU recién conectadas en caliente:# para i en /sys/devices/system/cpu/cpu[1-9]*/online; do if [ "$(cat $i)" = 0 ]; A continuación, Echo 1 > $i; Fi; hecho
vm-vif-list
xe vm-vif-list [vm-selector=vm_selector_value...]
<!--NeedCopy-->
Enumera las VIF de las máquinas virtuales especificadas.
La máquina virtual o las máquinas virtuales en las que se realiza esta operación se seleccionan mediante el mecanismo de selección estándar. Para obtener más información, consulte Selectores de VM. Los selectores operan en los registros de la máquina virtual 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 programadas de VM y sus atributos.
El VMS
Los objetos se pueden enumerar con el comando estándar de listado 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
xe vmss-create enabled=True/False name-label=name type=type frequency=frequency retained-snapshots=value name-description=description schedule:schedule
<!--NeedCopy-->
Crea una programación de instantáneas en el grupo.
Por ejemplo:
xe vmss-create retained-snapshots=9 enabled=true frequency=daily \
name-description=sample name-label=samplepolicy type=snapshot \
schedule:hour=10 schedule:min=30
<!--NeedCopy-->
Las programaciones de instantáneas tienen los siguientes parámetros:
Nombre del parámetro | Descripción | Tipo |
---|---|---|
name-label |
Nombre de la programación de instantáneas. | Lectura/escritura |
name-description |
Descripción de la programación de instantáneas. | Lectura/escritura |
type |
Instantánea de disco o instantánea de memoria. | Lectura/escritura |
frequency |
Cada hora; Diario; Semanal | Lectura/escritura |
retained-snapshots |
Instantáneas que se van a conservar. Rango: 1-10. | Lectura/escritura |
schedule |
Horario:Días (Lunes a Domingo), Horario:Horas (de 0 a 23), Horario:Minutos (0, 15, 30, 45) |
Lectura/escritura |
vmss-destroy
xe vmss-destroy uuid=uuid
<!--NeedCopy-->
Destruye una programación de instantáneas en el grupo.
Paso a través de USB
El paso a través de USB es compatible con las siguientes versiones de USB: 1.1, 2.0 y 3.0.
Activación/desactivación de paso USB
xe pusb-param-set uuid=pusb_uuid passthrough-enabled=true/false
<!--NeedCopy-->
Habilite/deshabilite el paso a través de USB.
pusb-scan
xe pusb-scan host-uuid=host_uuid
<!--NeedCopy-->
Escanee PUSB y actualice.
vusb-create
xe vusb-create usb-group-uuid=usb_group_uuid vm-uuid=vm_uuid
<!--NeedCopy-->
Crea un USB virtual en el grupo. Inicie la máquina virtual para que pase a través del USB a la máquina virtual.
vusb-unplug
xe vusb-unplug uuid=vusb_uuid
<!--NeedCopy-->
Desconecta el USB de la máquina virtual.
vusb-destroy
xe vusb-destroy uuid=vusb_uuid
<!--NeedCopy-->
Quita la lista de USB virtuales de la máquina virtual.
Comandos de grupo de máquinas virtuales
Comandos para controlar grupos de máquinas virtuales y sus atributos.
Parámetros del grupo de máquinas virtuales
-
uuid
(solo lectura) el identificador único/referencia de objeto para la máquina virtual -
nombre-etiqueta
(lectura/escritura) el nombre de la máquina virtual -
nombre-descripción
(lectura/escritura) la cadena de descripción de la máquina virtual -
colocación
(solo lectura) el tipo de reglas de ubicación que se aplicarán a las máquinas virtuales del grupo. Los valores disponibles son:Anti-afinidad
ynormal
.
lista-de-grupo-vm
xe vm-group-list
<!--NeedCopy-->
Enumera todos los grupos de máquinas virtuales de este grupo.
vm-grupo-create
xe vm-group-create placement=anti-affinity|normal name-label=<name-label> [name-description=<name-description>]
<!--NeedCopy-->
Crea un grupo de máquinas virtuales.
vm-grupo-destruir
xe vm-group-destroy uuid=<vm-group-uuid>
<!--NeedCopy-->
Elimina este grupo de máquinas virtuales. Si elimina un grupo de máquinas virtuales que tiene máquinas virtuales, las máquinas virtuales ya no están asociadas a un grupo, pero no se ven afectadas de otro modo.
En este artículo
- Introducción a la CLI de xe
- Obtener ayuda con los comandos xe
- Sintaxis básica de xe
- Caracteres especiales y sintaxis
- Tipos de comandos
- Secretos
- Historial de comandos
- Referencia de comandos xe
- Comandos del dispositivo
- Comandos de auditoría
- Comandos de vinculación
- Comandos de CD
- Comandos de clúster
- Comandos de consola
- Comandos de diagnóstico
- Comandos de recuperación ante desastres
- Comandos de evento
- Comandos de GPU
- Comandos de host
- Comandos de mensaje
- Comandos de red
- Comandos del controlador SDN
- Comandos de túnel
- Comandos de parches
- Comandos PBD
- Comandos PIF
- Comandos de grupo
- Comandos del acelerador PVS
- Comandos del Administrador de almacenamiento
- Comandos de instantánea
- Comandos SR
- Comandos de asunto
- Comandos de tarea
- Comandos de plantilla
- Comandos de actualización
- Comandos de usuario
- Comandos VBD
- Comandos VDI
- Comandos VIF
- Comandos VLAN
- Comandos de VM
- Comandos de grupo de máquinas virtuales