Interfaz de línea de comandos
La CLI xe le permite ejecutar scripts y automatizar tareas de administración del sistema. Utilice la CLI para integrarse en una infraestructura de TI existente.
La interfaz de línea de comandos xe se instala de forma predeterminada en los hosts y se incluye con . Una CLI remota independiente también está disponible para Linux.
En Windows, elxe.exe
comando se instala junto con .
Para utilizar elxe.exe
comando, abra un símbolo del sistema de Windows y cambie los directorios al directorio donde se encuentra elxe.exe
archivo (normalmenteC:\Program Files\\
). Si agrega la ubicación dexe.exe
instalación a la ruta del sistema, puede usar el comando sin tener que cambiar al directorio.
En distribuciones basadas en RPM (como Red Hat), puede instalar el comando xe independiente desde el RPM nombradoxe-cli-6.00-BUILD.i386.rpm
en la ISO de instalación principal. Utilice el siguiente comando:
rpm -ivh XE-CLI-6.00-construir.I386.rpm
La ayuda básica está disponible para los comandos de CLI en el host escribiendo:
comando xe help
Se muestra una lista de los comandos xe más utilizados si escribe:
ayuda de xe
O se muestra una lista de todos los comandos xe si escribe:
xe help — todos
Sintaxis básica xe
La sintaxis básica de todos los comandos de xe CLI es:
argumento de nombre de comando xe = argumento valor = valor
Cada comando específico contiene su propio conjunto de argumentos que son del formularioargument=value
. Algunos comandos tienen argumentos requeridos, y la mayoría tienen algún conjunto de argumentos opcionales. Normalmente, un comando asume valores predeterminados para algunos de los argumentos opcionales cuando se invoca sin ellos.
Si el comando xe se ejecuta de forma remota, se utilizan argumentos adicionales para conectarse y autenticarse. Estos argumentos también toman la formaargument=argument_value
.
Elserver
argumento se utiliza para especificar el nombre de host o la dirección IP. Losusername
argumentospassword
y se utilizan para especificar credenciales. Se puede especificar unpassword-file
argumento en lugar de la contraseña directamente. En este caso, el comando xe intenta leer la contraseña del archivo especificado y usa esa contraseña para conectarse. (Todos los CRs y LFs finales al final del archivo se eliminan). Este método es más seguro que especificar la contraseña directamente en la línea de comandos.
Elport
argumento opcional se puede utilizar para especificar el puerto del agente en el host remoto (el valor predeterminado es 443).
Ejemplo: En el host local:
xe vm-list
Ejemplo: En el host remoto:
xe vm-list -user username -password password -server hostname
La sintaxis de taquigrafía también está disponible para argumentos de conexión remota:
-
-u
nombre de usuario -
-pw
contraseña - archivo de
-pwf
contraseña -
-p
puerto -
-s
servidor
Ejemplo: En un host remoto:
xe vm-list -u myuser -pw mypassword -s hostname
Los argumentos también se toman de la variable de entorno XE_EXTRA_ARGS, en forma de pares clave/valor separados por comas. Por ejemplo, para introducir comandos que se ejecutan en un host remoto, ejecute primero el siguiente comando:
export XE_EXTRA_ARGS = “server = jeffbeck, port = 443, username = root, password = pass”
Después de ejecutar este comando, ya no es necesario especificar los parámetros de host remoto en cada comando xe que ejecute.
El uso de la variable de entorno XE_EXTRA_ARGS también habilita la finalización por tabulación de comandos xe cuando se emiten contra un host remoto, que está deshabilitado de forma predeterminada.
Caracteres especiales y sintaxis
Para especificar pares de argumento/valor en la línea dexe
comando, escriba:
argumento = valor
A menos que el valor incluya espacios, no utilice comillas. No debe haber espacios entre el nombre del argumento, el signo igual (=) y el valor. Cualquier argumento que no se ajuste a este formato se ignora.
Para valores que contengan espacios, escriba:
argumento = “valor con espacios”
Cuando utiliza la CLI en su host, los comandos tienen una función de finalización de pestañas similar a la característica en el shell bash estándar de Linux. Por ejemplo, si escribexe vm-l
y, a continuación, presiona la tecla TAB , se muestra el resto del comando. Si se inicia más de un comandovm-l
, al presionar TABuna segunda vez se muestran las posibilidades. Esta función resulta útil al especificar UUID de objeto en los comandos.
Nota:
La finalización de tabulaciones normalmente no funciona cuando se ejecutan comandos en un host 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 tabulaciones. Para obtener más información, vea Sintaxis básica xe.
Tipos de comandos
Los comandos CLI se pueden dividir en dos mitades. Los comandos de bajo nivel se ocupan de enumerar y manipular parámetros de objetos API. Los comandos de nivel superior se utilizan para interactuar con máquinas virtuales o hosts en un nivel más abstracto.
Los comandos de bajo nivel son:
-
clase-lista
-
clase-paramget
-
clase-param-set
-
clase-param-list
-
clase-param-add
-
clase-param-remove
-
clase-param-clear
Donde la clase es una de:
-
bond
-
console
-
host
-
host-crashdump
-
host-cpu
-
network
-
patch
-
pbd
-
pif
-
pool
-
sm
-
sr
-
task
-
template
-
vbd
-
vdi
-
vif
-
vlan
-
vm
No todos los valores de clase tienen el conjunto completo de comandos class -param-action . Algunos valores de clase tienen un conjunto más pequeño de comandos.
Tipos de parámetros
Los objetos que se abordan con los comandos xe tienen conjuntos de parámetros que los identifican y definen sus estados.
La mayoría de los parámetros toman un solo valor. Por ejemplo, elname-label
parámetro de una máquina virtual contiene un único valor de cadena. En la salida de comandos de lista de parámetros, comoxe vm-param-list
, un valor entre paréntesis indica si los parámetros son de lectura y escritura (RW) o de sólo lectura (RO).
La salida dexe vm-param-list
en una máquina virtual especificada puede tener las siguientes líneas:
versión de usuario (RW): 1
dominio de control (RO): false
El primer parámetro,user-version
, es grabable y tiene el valor 1. El segundo,is-control-domain
, es de sólo lectura y tiene un valor de false.
Los otros dos tipos de parámetros son multivalor. Un parámetro set contiene una lista de valores. Un parámetro de mapa es un conjunto de pares clave/valor. Como ejemplo, observe la siguiente pieza de muestra de salida de laxe vm-param-list
en una máquina virtual especificada:
plataforma (MRW): acpi: true; apic: true; pae: true; nx: false
operaciones permitidas (SRO): pausa; clean_shutdown; clean_reboot; \
hard_shutdown; hard_reboot; suspender
Elplatform
parámetro tiene una lista de elementos que representan pares clave/valor. Los nombres de clave van seguidos de un carácter de dos puntos (:). Cada par clave/valor está separado del siguiente por un carácter de punto y coma (;). La M que precede al RW indica que este parámetro es un parámetro de mapa y es legible y grabable. Elallowed-operations
parámetro tiene una lista que compone un conjunto de elementos. La S que precede a la RO indica que se trata de un parámetro de conjunto y que es legible pero no se puede escribir.
Para filtrar un parámetro de mapa o establecer un parámetro de mapa, utilice dos puntos (:) para separar el nombre del parámetro de mapa y el par clave/valor. Por ejemplo, para establecer el valor de lafoo
clave delother-config
parámetro de una máquina virtual enbaa
, el comando sería
xe vm-param-set uuid = VM uuid other-config: foo = baa
Nota:
En versiones anteriores, se utilizó el carácter de guión (-) para especificar parámetros de mapa. Esta sintaxis sigue funcionando, pero está obsoleta.
Comandos de parámetros de bajo nivel
Hay varios comandos para operar sobre parámetros de objetos: class-param-get, class-param-set, class-param-add, class-param-remove, class-param-clear y class-param-list. Cada uno de estos comandos toma unuuid
parámetro para especificar el objeto en particular. Dado que estos comandos se consideran comandos de bajo nivel, deben utilizar el UUID y no la etiqueta de nombre de máquina virtual.
-
class-param-list uuid=uuid
Muestra todos los parámetros y sus valores asociados. A diferencia del comando class-list, este comando enumera los valores de campos “caros”.
-
class-param-get uuid=uuid param-name=parameter param-key=key
Devuelve el valor de un parámetro determinado. Para un parámetro de mapa, al especificar la clave param-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 del mapa.
-
class-param-set uuid=uuid param=value
Establece el valor de uno o más parámetros.
-
class-param-add uuid=uuid param-name=parameter key=value param-key=key
Se agrega a un mapa o a un parámetro de conjunto. Para un parámetro de mapa, agregue pares clave/valor utilizando la sintaxis clave = valor. Si el parámetro es un conjunto, agregue claves con la sintaxis param-key = key.
-
class-param-remove uuid=uuid param-name=parameter param-key=key
Elimina un par clave/valor de un mapa o una clave de un conjunto.
-
class-param-clear uuid=uuid param-name=parameter
Borra completamente un conjunto o un mapa.
Comandos de lista de bajo nivel
El comando class-list enumera los objetos de type class. 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 produzca un subconjunto
- Los parámetros que se imprimen se pueden modificar.
Para cambiar los parámetros que se imprimen, especifique los parámetros de argumento como una lista separada por comas de los parámetros requeridos. Por ejemplo:
xe vm-list params = nombre-etiqueta, other-config
Alternativamente, para enumerar todos los parámetros, utilice la sintaxis:
xe vm-list params = todos
El comando list no muestra algunos parámetros que son costosos de calcular. Estos parámetros se muestran como, por ejemplo:
< expensive field >Dispositivos VBD-permitidos (SRO):
Para obtener estos campos, utilice el comando class-param-list o class-paramget
Para filtrar la lista, la CLI hace coincidir los valores de los parámetros con los valores especificados en la línea de comandos, imprimiendo sólo objetos que coincidan con todas las restricciones especificadas. Por ejemplo:
xe vm-list HVM-boot-policy = “Orden del BIOS” power-state = detenido
Este comando enumera sólo aquellas máquinas virtuales para las que el campopower-state
tiene el valor detenido y el campoHVM-boot-policy
tiene el orden del BIOS del valor.
También puede filtrar la lista por el valor de las claves en los mapas o por la existencia de valores en un conjunto. La sintaxis para el filtrado basado en claves en mapas esmap-name:key=value
. La sintaxis para filtrar en función de los valores existentes en un conjunto esset-name:contains=value
.
Al crear secuencias de comandos, una técnica útil está--minimal
pasando en la línea de comandos, haciendoxe
que se imprima solo el primer campo de una lista separada por comas. Por ejemplo, el comandoxe vm-list --minimal
en un host con tres máquinas virtuales instaladas proporciona los tres UUID de las máquinas virtuales:
a85d6717-7264-d00e-069b-3b1d19d56ad9,aaa3eec5-9499-bcf3-4c03-af10baea96b7, \
42c044de-df69-4b30-89d9-2c199564581d
referencia de comando xe
Esta sección agrupa los comandos por los objetos a los que se dirige el comando. Estos objetos se enumeran alfabéticamente.
Comandos del dispositivo
Comandos para crear y modificar dispositivos de VM (también conocidos como VAPP). Para obtener más información, consulte VAPP.
Parámetros del equipo
Los comandos del dispositivo tienen los siguientes parámetros:
Nombre del parámetro | Descripción | Tipo |
---|---|---|
uuid |
El dispositivo uuid | Necesario |
name-description |
Descripción del dispositivo | Opcional |
paused |
Opcional | |
force |
Forzar apagado | Opcional |
appliance-assert-can-be-recovered
apliance-asert-puede-ser recuperado uuid = base de datos de appliance-uuid: vdi-uuid = vdi-uuid
Comprueba si el almacenamiento está disponible para recuperar esta VM Appliance/VApp.
appliance-create
appliance-create name-label = name-label [name-description = name-description]
Crea un Appliance/vApp. Por ejemplo:
xe appliance-create name-label = my_appliance
Agregue máquinas virtuales al dispositivo:
xe vm-param-set uuid = dispositivo VM-UUID = dispositivo-uuid \
xe vm-param-set uuid = dispositivo VM-UUID = dispositivo-uuid
appliance-destroy
appliance-destroy uuid = appliance-uuid
Destruye un Appliance/VApp. Por ejemplo:
xe appliance-destroy uuid = appliance-uuid
appliance-recover
appliance-recover uuid = appliance-uuid database: vdi-uuid = vdi-uuid \[paused = true | false]
Recuperar un Appliance/VApp de VM de la base de datos contenida en el VDI suministrado.
appliance-shutdown
apliance-shutdown uuid = appliance-uuid \[force = true | false]
Apaga todas las máquinas virtuales de un Appliance/vApp. Por ejemplo:
xe appliance-shutdown uuid = appliance-uuid
appliance-start
appliance-start uuid = appliance-uuid \[paused = true | false]
Inicia un Appliance/vApp. Por ejemplo:
xe appliance-start uuid = appliance-uuid
Comandos de auditoría
Los comandos de auditoría descargan todos los registros disponibles del archivo de auditoría RBAC en el grupo. Si el parámetro opcionalsince
está presente, solo descarga los registros de ese punto específico en el tiempo.
audit-log-get
parámetros
audit-log-get
tiene los siguientes parámetros
Nombre del parámetro | Descripción | Tipo |
---|---|---|
filename |
Escribir el registro de auditoría del grupo en nombre de archivo | Necesario |
since |
Punto de fecha/hora específico | Opcional |
audit-log-get
audit-logget [since = timestamp] filename = nombre de archivo
Por ejemplo, para obtener registros de auditoría del grupo desde una marca de tiempo precisa de milisegundos, ejecute el siguiente comando:
Ejecute el siguiente comando:
xe audit-log-get since = 2009-09-24T 17:56:20 .530Z filename = / tmp/auditlog -pool-actions.out
Comandos de unió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 Redes.
El objeto de enlace es un objeto de referencia que pega entre sí PIF maestro y miembro . El PIF maestro es la interfaz de unión que debe utilizarse como el PIF general para referirse a la unión. Los PIF miembros son un conjunto de dos o más interfaces físicas que se han combinado en la interfaz enlazada de alto nivel.
Parámetros de enlace
Los bonos tienen los siguientes parámetros:
Nombre del parámetro | Descripción | Tipo |
---|---|---|
uuid |
Identifiador/referencia de objeto único para el vínculo | Sólo lectura |
master |
UUID para el PIF de bonos maestros | Sólo lectura |
members |
Conjunto de UUID para los PIF enlazados subyacentes | Sólo lectura |
bond-create
bond-create network-uuid = network_uuid pif-uids = pif_uuid_1, pif_uuid_2,...
Cree una interfaz de red unida en la red especificada a partir de una lista de objetos PIF existentes. El comando falla en cualquiera de los siguientes casos:
- Si los PIF ya están en otro vínculo
- Si algún miembro tiene un conjunto de etiquetas VLAN
- Si los PIFs a los que se hace referencia no están en el mismo host
- Si se suministran menos de 2 PIF
bond-destroy
bond-destroy uuid = bond_uuid
Elimina de un host una interfaz unida especificada por su UUID.
bond-set-mode
bond-set-mode uuid = bond_uuid mode = bond_mode
Cambie el modo de enlace.
Comandos de CD
Comandos para trabajar con unidades de CD/DVD físicas en hosts.
Parámetros de CD
Los CD tienen los siguientes parámetros:
Nombre del parámetro | Descripción | Tipo |
---|---|---|
uuid |
Identifiador/referencia de objeto único para el CD | Sólo lectura |
name-label |
Nombre del CD | Lectura/Escritura |
name-description |
Texto de descripción del CD | Lectura/Escritura |
allowed-operations |
Una lista de las operaciones que se pueden realizar en este CD | Parámetro de conjunto de sólo lectura |
current-operations |
Una lista de las operaciones actualmente en curso en este CD | Parámetro de conjunto de sólo lectura |
sr-uuid |
La referencia única de identificador/objeto para el SR de este CD es parte de | Sólo lectura |
sr-name-label |
El nombre de la SR de este CD es parte de | Sólo lectura |
vbd-uuids |
Una lista de los identificadores únicos para los VBD en las máquinas virtuales que se conectan a este CD | Parámetro de conjunto de sólo lectura |
crashdump-uuids |
No se utiliza en CDs. Debido a que los crashdumps no se pueden escribir en CD | Parámetro de conjunto de sólo lectura |
virtual-size |
Tamaño del CD tal como aparece en las VM (en bytes) | Sólo lectura |
physical-utilisation |
Cantidad de espacio físico que ocupa la imagen del CD en el SR (en bytes) | Sólo lectura |
type |
Establecer como usuario para CDs | Sólo lectura |
sharable |
Si la unidad de CD es o no compartible. El valor predeterminado esfalse . |
Sólo lectura |
read-only |
Si el CD es de sólo lecturafalse , si el dispositivo es grabable. Siempre es cierto para CDs. |
Sólo lectura |
storage-lock |
El valor estrue si este disco está bloqueado en el nivel de almacenamiento. |
Sólo lectura |
parent |
Referencia al disco principal, si este CD forma parte de una cadena. | Sólo lectura |
missing |
El valor estrue si la operación de exploración SR informó que este CD no está presente en el disco |
Sólo lectura |
other-config |
Una lista de pares clave/valor que especifican parámetros de configuración adicionales para el CD | Parámetro de mapa de lectura y escritura |
location |
La ruta en la que está montado el dispositivo | Sólo lectura |
managed |
El valor estrue si el dispositivo se administra |
Sólo lectura |
xenstore-data |
Datos que se insertarán en el árbol de xenstore | Parámetro de mapa de sólo lectura |
sm-config |
Nombres y descripciones de las claves de configuración del dispositivo del administrador de almacenamiento | Parámetro de mapa de sólo lectura |
is-a-snapshot |
El valor estrue si esta plantilla es una instantánea de CD |
Sólo lectura |
snapshot_of |
El UUID del CD que esta plantilla es una instantánea de | Sólo lectura |
snapshots |
Los UUID de cualquier instantánea que se haya tomado de este CD | Sólo lectura |
snapshot_time |
La marca de tiempo de la operación de instantánea | Sólo lectura |
cd-list
cd-list [params = param1, param2,...] [parámetro = valor_parámetro]
Enumere los CDs e ISOS (archivos de imagen de CD) en el host o grupo, filtrando el argumento opcionalparams
.
Si separams
utiliza el argumento opcional, el valor de params es una cadena que contiene una lista de parámetros de este objeto que desea mostrar. Alternativamente, puede usar la palabra claveall
para mostrar todos los parámetros. Cuando noparams
se utiliza, la lista devuelta muestra un subconjunto predeterminado de todos los parámetros disponibles.
Los argumentos opcionales pueden ser cualquier número de parámetros de CDenumerados 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 SRs de GFS2. Para obtener más información, consulte [Grupos/en-us/xenserver/current-release/command-line-interface.html()agrupados]
Los objetos cluster y cluster-host se pueden enumerar con los comandos estándar de lista de objetos (xe cluster-list
yxe cluster-host-list
) y los parámetros se pueden manipular con los comandos de parámetros estándar. Para obtener más información, consulte Comandos de parámetros de nivel bajo.
Comandos para trabajar con grupos agrupados.
Parámetros de clúster
Los clústeres tienen los siguientes parámetros:
Nombre del parámetro | Descripción | Tipo |
---|---|---|
uuid |
El identificador único o referencia de objeto para el clúster | Sólo lectura |
cluster-hosts |
Una lista de identificadores/referencias de objeto únicos para los hosts del clúster | Parámetro de conjunto de sólo lectura |
cluster-token |
La clave secreta utilizada por xapi-clusterd cuando habla consigo misma en otros hosts | Sólo lectura |
cluster-stack |
La pila de tecnología que proporciona las capacidades de clustering. Los valores posibles soncorosync . |
Sólo lectura |
allowed-operations |
Muestra las operaciones permitidas en este estado. Esta lista es sólo de carácter consultivo y el estado del clúster puede haber cambiado en el momento en que un cliente lee este campo. | Parámetro de conjunto de sólo lectura |
current-operations |
Muestra las operaciones actualmente en proceso. Esta lista es sólo de carácter consultivo y el estado del clúster puede haber cambiado en el momento en que un cliente lee este campo. | Parámetro de conjunto de sólo lectura |
token-timeout |
El tiempo de espera del token corosync en segundos | Sólo lectura |
token-timeout-coefficient |
El coeficiente de tiempo de espera del token corosync en segundos | Sólo lectura |
pool-auto-join |
True si se unen automáticamente nuevos miembros del grupo al clúster. Esto está configurado paratrue . |
Sólo lectura |
cluster-config |
Una lista de pares clave/valor que especifican parámetros de configuración adicionales para el clúster. | Parámetro de mapa de sólo lectura |
other-config |
Una lista de pares clave/valor que especifican parámetros de configuración adicionales para el clúster. | Parámetro de mapa de lectura y escritura |
cluster-host-create
cluster-host-create cluster-uuid = cluster_uuid host-uuid = host_uuid pif-uuid = pif_uuid
Agregar un host a un clúster existente.
cluster-host-destroy
cluster-host-destroy uuid = host_uuid
Destruye un host de clúster, dejando efectivamente el clúster.
cluster-host-disable
cluster-host-disable uuid = cluster_uuid
Deshabilite la pertenencia al clúster para un host de clúster habilitado.
cluster-host-enable
cluster-host-enable uuid = cluster_uuid
Habilite la pertenencia al clúster para un host de clúster deshabilitado.
cluster-host-force-destroy
cluster-host-force-destroy uuid = cluster_host
Destruye un objeto host de clúster con fuerza, dejando efectivamente el clúster.
cluster-pool-create
cluster-pool-create network-uuid = network_uuid [cluster-stack = cluster_stack] [token-timeout = token_timeout] [token-timeout-coefficient = token_timeout_coefficient]
Cree un clúster de todo el grupo.
cluster-pool-destroy
cluster-pool-destroy cluster-uuid = cluster_uuid
Destruye el cúmulo en toda la agrupación. El grupo sigue existiendo, pero ya no está agrupado y ya no puede utilizar SRs de GFS2.
cluster-pool-force-destroy
cluster-pool-force-destroy cluster-uuid = cluster_uuid
Fuerza destruir el cúmulo en toda la agrupación.
cluster-pool-resync
cluster-pool-resync cluster-uuid = cluster_uuid
Resincronizar un clúster a través de un grupo.
Comandos de consola
Comandos para trabajar con consolas.
Los objetos de consola se pueden enumerar con el comando estándar de lista de objetos (xe console-list
) y los parámetros se pueden manipular con los comandos de parámetros estándar. Para obtener más información, consulte Comandos de parámetros de nivel bajo.
Parámetros de consola
Las consolas tienen los siguientes parámetros:
Nombre del parámetro | Descripción | Tipo |
---|---|---|
uuid |
La referencia única de identificador/objeto para la consola | Sólo lectura |
vm-uuid |
La referencia única de identifiador/objeto de la máquina virtual en la que está abierta esta consola | Sólo lectura |
vm-name-label |
El nombre de la máquina virtual en la que está abierta esta consola | Sólo lectura |
protocol |
Protocolo que utiliza esta consola. Los valores posibles sonvt100 : Terminal VT100,rfb : Protocolo de búfer remoto (como se utiliza en VNC) ordp : Protocolo de escritorio remoto |
Sólo lectura |
location |
URI para el servicio de consola | Sólo lectura |
other-config |
Una lista de pares clave/valor que especifican parámetros de configuración adicionales para la consola. | Parámetro de mapa de lectura y escritura |
console
consola
Adjuntar a una consola en particular.
Comandos de diagnóstico
Comandos para recopilar información de diagnóstico de .
diagnostic-compact
diagnóstico-compacto
Realice una recopilación de GC importante y compactación del montón.
diagnostic-db-log
diagnostic-db-log
Inicie el registro de las operaciones de la base de datos. Advertencia: una vez iniciado, esto no se puede detener.
diagnostic-db-stats
diagnóstico-db-stats
Imprimir estadísticas de la base de datos.
diagnostic-gc-stats
diagnóstico-gc-estadísticas
Imprimir estadísticas de GC.
diagnostic-license-status
diagnostic-estado de licencia
Ayudar a diagnosticar problemas de licencias en toda la agrupación.
diagnostic-net-stats
diagnostic-net-stats [uri = uri] [método = método] [params = param1, param2...]
Imprimir estadísticas de red.
diagnostic-timing-stats
diagnóstico-temporización-estadísticas
Imprimir estadísticas de temporización.
diagnostic-vdi-status
diagnostic-vdi-status uuid = vdi_uuid
Consulte el estado de bloqueo y uso compartido de un VDI.
diagnostic-vm-status
diagnostic-vm-status uuid = vm_uuid
Consulte los hosts en los que puede arrancar la máquina virtual, compruebe el estado de compartir/bloqueo de todos los VBD.
Comandos de recuperación ante desastres
Comandos para recuperar máquinas virtuales después de un desastre
drtask-create
drtask-create type = type sr-whitelist = sr-white-list device-config = device-config
Crea una tarea de recuperación ante desastres. Por ejemplo, para conectarse a un SR iSCSI en preparación para la recuperación ante desastres:
xe drtask-create type = lvmoiscsi device-config: target = dirección-IP de \ destino device-config: targetIqN = targetIqn device-config: scsiId = scsiId \
sr-whitelist = sr-uuid-list
Nota:
El comando
sr-whitelist
enumera los UUID SR. Eldrtask-create
comando solo introduce y se conecta a un SR que tiene uno de los UUID de la lista blanca
drtask-destroy
drtask-destroy uuid = dr-task-uuid
Destruye una tarea de recuperación ante desastres y olvida la SR introducida.
vm-assert-can-be-recovered
vm-assert-puede-ser recuperado uuid = base de datos vm-uuid: vdi-uuid = vdi-uuid
Comprueba si el almacenamiento está disponible para recuperar esta máquina virtual.
appliance-assert-can-be-recovered
apliance-asert-puede-ser recuperado uuid = base de datos de appliance-uuid: vdi-uuid = vdi-uuid
Comprueba si el almacenamiento (que contiene el disco S/vApp del dispositivo) está visible.
appliance-recover
appliance-recover uuid = appliance-uuid database: vdi-uuid = vdi-uuid \[force = true | false]
Recuperar un Appliance/VApp de la base de datos contenida en el VDI suministrado.
vm-recover
vm-recover uuid = base de datos vm-uuid: vdi-uuid = vdi-uuid \[force = true | false]
Recupera una máquina virtual de la base de datos contenida en el VDI suministrado.
sr-enable-database-replication
sr-enable-database-replication uuid = sr_uuid
Habilita la replicación de bases de datos XAPI en el SR (compartido) especificado. Por ejemplo:
xe sr-enable-database-replication uuid = sr-uuid
sr-disable-database-replication
sr-disable-database-replication uuid = sr_uuid
Deshabilita la replicación de base de datos XAPI en el SR especificado. Por ejemplo:
xe sr-enable-database-replication uuid = sr-uuid
Ejemplo de uso
El siguiente ejemplo muestra los comandos CLI de DR en contexto:
En el sitio principal, habilite la replicación de la base de datos:
xe sr-database-replication uuid = sr = uuid
Después de un desastre, en el sitio secundario, conéctese al SR. Eldevice-config
comando tiene los mismos campos quesr-probe
.
xe drtask-create type = lvmoiscsi \
device-config: target = dirección IP de \ destino device-config: targetIqn = target-iqn \
device-config: scsiId = scsi-id \
sr-whitelist = sr-uuid
Busque VDIS de base de datos en SR:
xe vdi-list sr-uuid = sr-uuid type = Metadatos
Consulte un VDI de base de datos para máquinas virtuales presentes:
xe base de datos vm-list: vdi-uuid = vdi-uuid
Recuperar una VM:
xe vm-recover uuid = base de datos vm-uuid: vdi-uuid = vdi-uuid
Destruye la tarea DR. Los SRs introducidos por la tarea DR y no requeridos por las VM se destruyen:
xe drtask-destroy uuid = drtask-uuid
Comandos de evento
Comandos para trabajar con eventos.
Clases de eventos
Las clases de evento se enumeran en la tabla siguiente:
Nombre de 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 |
Dispositivos de bloque físico a través de los cuales los hosts acceden a SRs |
event-wait
event-wait class = class_name [param-name = param_value] [param-name = / = valor_param]
Bloquea la ejecución de otros comandos hasta que exista un objeto que satisfaga las condiciones dadas en la línea de comandos. El argumentox=y
significa “esperar a que el campo x tome el valor y” yx=/=y
significa “esperar a que el campo x tome cualquier valor que no sea y”.
Ejemplo: espere a que se ejecute una máquina virtual específica.
xe event-wait class = vm name-label = myvm power-state = ejecutar
Bloquea otros comandos hasta que una máquina virtual llamadamyvm
está en elpower-state
“ejecución. ”
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 = $parámetros de VM = tiempo de inicio — mínimo)
Bloquea otros comandos hasta que se reinicie una máquina virtual con UUID $VM . El comando utiliza el valor destart-time
para decidir cuándo se reinicia la máquina virtual.
El nombre de la clase puede ser cualquiera de las clases de eventoenumeradas al principio de esta sección. Los parámetros pueden ser cualquiera de los parámetros enumerados en la clasede comando CLI -param-list.
Comandos GPU
Comandos para trabajar con GPU físicas, grupos de GPU y GPU virtuales.
Los objetos GPU se pueden enumerar con los comandos estándar de lista de objetos:xe pgpu-listxe gpu-group-list````, yxe vgpu-list``. Los parámetros se pueden manipular con los comandos de parámetros estándar. Para obtener más información, consulte Comandos de parámetros de nivel bajo.
Parámetros de GPU física
Las GPU físicas (PGPUs) tienen los siguientes parámetros:
Nombre del parámetro | Descripción | Tipo |
---|---|---|
uuid |
La referencia única de identificador/objeto para la PGPu | Sólo lectura |
vendor-name |
El nombre del proveedor del PGPu | Sólo lectura |
device-name |
El nombre asignado por el proveedor a este modelo PGPu | Sólo lectura |
gpu-group-uuid |
Referencia de objeto o identificador único para el grupo de GPU al que se ha asignado automáticamente esta PGPu . Se agrupan las PGPU idénticas entre los hosts de un grupo | Sólo lectura |
gpu-group-name-label |
El nombre del grupo de GPU al que se asigna la PGPu | Sólo lectura |
host-uuid |
La referencia única de identificador/objeto para el host al que está conectado el PGPu | Sólo lectura |
host-name-label |
El nombre del host al que está conectado el PGPu | Sólo lectura |
pci-id |
Identificador PCI | Sólo lectura |
dependencies |
Enumera los dispositivos PCI dependientes que se han pasado a la misma máquina virtual | Parámetro de mapa de lectura y escritura |
other-config |
Una lista de pares clave/valor que especifican parámetros de configuración adicionales para el PGPu | Parámetro de mapa de lectura y escritura |
supported-VGPU-types |
Lista de tipos de GPU virtuales admitidos por el hardware subyacente | Sólo lectura |
enabled-VGPU-types |
Lista de tipos de GPU virtuales que se han habilitado para este PGPu | Lectura/Escritura |
resident-VGPUs |
Lista de vGPU ejecutándose en este PGPu | Sólo lectura |
pgpu-disable-dom0-access
pgpu-disable-dom0-access uuid = uuid
Deshabilite el acceso PGPU a dom0.
pgpu-enable-dom0-access
pgpu-enable-dom0-access uuid = uuid
Habilite el acceso PGPU a dom0.
Parámetros de grupo de GPU
Los grupos de GPU tienen los siguientes parámetros:
Nombre del parámetro | Descripción | Tipo |
---|---|---|
uuid |
La referencia única de identifiador/objeto para el grupo GPU | Sólo lectura |
name-label |
El nombre del grupo GPU | Lectura/Escritura |
name-description |
El texto descriptivo del grupo GPU | Lectura/Escritura |
VGPU-uuids |
Enumera las referencias de objetos o identificadores únicos para las GPU virtuales del grupo GPU | Parámetro de conjunto de sólo lectura |
PGPU-uuids |
Enumera las referencias de objetos o identificadores únicos para las PGPU en el grupo GPU | Parámetro de conjunto de sólo lectura |
other-config |
Una lista de pares clave/valor que especifican parámetros de configuración adicionales para el grupo GPU | Parámetro de mapa de lectura y escritura |
supported-VGPU-types |
Unión de todos los tipos de GPU virtuales compatibles con el hardware subyacente | Sólo lectura |
enabled-VGPU-types |
Unión de todos los tipos de GPU virtuales que se han habilitado en las PGPU subyacentes | Sólo lectura |
allocation-algorithm |
Configuración de Depth-primer/Breadth -first para la asignación de GPU virtuales en PGPU dentro del grupo | Parámetro enum de lectura y escritura |
Operaciones de grupo GPU
Comandos para trabajar con grupos de GPU
gpu-group-create
gpu-group-create name-label = name_for_group [name-description = description]
Crea un nuevo grupo de GPU (vacío) al que se pueden mover las PGPU.
gpu-group-destroy
gpu-group-destroy uuid = uuid_of_group
Destruye el grupo GPU; solo se permite para grupos vacíos.
gpu-group-get-remaining-capacity
gpu-group-get-remaining-capacity uuid = uuid_of_group vgpu-type-uuid = uuid_of_vgpu_type
Devuelve cuántas GPU virtuales más del tipo especificado se pueden crear instancias en este grupo de GPU.
gpu-group-param-set
gpu-group-param-set uuid = uuid_of_group asignación algorithm = breadth-first | depth-first
Cambia el algoritmo que el grupo de GPU utiliza para asignar GPU virtuales a PGPU.
gpu-group-param-get-uuid
gpu-group-param-get-uuid uuid = uuid_of_group param-name = Supported-VGPU-types | Enabled-VGPU-types
Devuelve los tipos admitidos o habilitados para este grupo de GPU.
Parámetros de GPU virtual
Las GPU virtuales tienen los siguientes parámetros:
Nombre del parámetro | Descripción | Tipo |
---|---|---|
uuid |
La referencia única de identificador/objeto para la GPU virtual | Sólo lectura |
vm-uuid |
La referencia única de identifiador/objeto para la máquina virtual a la que se asigna la GPU virtual | Sólo lectura |
vm-name-label |
El nombre de la máquina virtual a la que se asigna la GPU virtual | Sólo lectura |
gpu-group-uuid |
Referencia de objeto o identificador único para el grupo de GPU en el que está contenida la GPU virtual | Sólo lectura |
gpu-group-name-label |
El nombre del grupo de GPU en el que está contenida la GPU virtual | Sólo lectura |
currently-attached |
True si se está ejecutando una máquina virtual con GPU PassThrough, false en caso contrario | Sólo lectura |
other-config |
Una lista de pares clave/valor que especifican parámetros de configuración adicionales para la GPU virtual | Parámetro de mapa de lectura y escritura |
type-uuid |
La referencia única de identifiador/objeto para el tipo de GPU virtual de esta GPU virtual | Parámetro de mapa de lectura y escritura |
type-model-name |
Nombre del modelo asociado con el tipo de GPU virtual | Sólo lectura |
Parámetros de tipo GPU virtual
Nota:
GPU Passthrough y GPU virtuales no son compatibles con , Almacenamiento o VM Suspender a menos que el software y las tarjetas gráficas compatibles de los proveedores de GPU estén presentes. Las máquinas virtuales sin este soporte no se pueden migrar para evitar el tiempo de inactividad. Para obtener información acerca de la compatibilidad de NVIDIA vGPU con , Almacenamiento y VM Suspender, consulte [Gráficos/en-us/xenserver/current-release/graphics.html()].
Los tipos de GPU virtuales tienen los siguientes parámetros:
Nombre del parámetro | Descripción | Tipo |
---|---|---|
uuid |
La referencia única de identifiador/objeto para el tipo de GPU virtual | Sólo lectura |
vendor-name |
Nombre del proveedor de GPU virtual | Sólo lectura |
model-name |
Nombre del modelo asociado con el tipo de GPU virtual | Sólo lectura |
freeze-frame |
Tamaño de framebuffer del tipo de GPU virtual, en bytes | Sólo lectura |
max-heads |
Número máximo de pantallas admitidas por el tipo de GPU virtual | Sólo lectura |
supported-on-PGPUs |
Lista de PGPU que admiten este tipo de GPU virtual | Sólo lectura |
enabled-on-PGPUs |
Lista de PGPUs que tienen habilitado este tipo de GPU virtual | Sólo lectura |
VGPU-uuids |
Lista de GPU virtuales de este tipo | Sólo lectura |
Operaciones de GPU virtual
vgpu-create
vgpu-create vm-uuid = uuid_of_vm gpu_group_uuid = uuid_of_gpu_group [vgpu-type-uuid = uuid_of_vgpu-type]
Crea una GPU virtual. Este comando adjunta la máquina virtual al grupo de GPU especificado y, opcionalmente, especifica el tipo de GPU virtual. Si no se especifica ningún tipo de GPU virtual, se asume el tipo ‘pass-through’.
vgpu-destroy
vgpu-destroy uuid = uuid_of_vgpu
Destruye la GPU virtual especificada.
Deshabilitar VNC para máquinas virtuales con GPU virtual
xe vm-param-add uuid=uuid_of_vmparam-name=platform vgpu_vnc_enabled=true|false.
El usofalse
deshabilita la consola VNC para una máquina virtual a medida quedisablevnc=1
pasa al emulador de pantalla. De forma predeterminada, VNC está habilitado.
Comandos de host
Comandos para interactuar con el host.
son los servidores físicos que ejecutan software. Tienen máquinas virtuales ejecutándose bajo el control de una máquina virtual con privilegios especiales, conocida como dominio de control o dominio 0.
Los objetos host se pueden enumerar con los comandos estándar de lista de objetos:xe host-listxe host-cpu-list ````, yxe host-crashdump-list``). Los parámetros se pueden manipular con los comandos de parámetros estándar. Para obtener más información, consulte Comandos de parámetros de nivel bajo.
Selectores de host
Varios de los comandos enumerados aquí tienen un mecanismo común para seleccionar uno o más hosts en los que realizar la operación. El más simple es suministrando el argumentohost=uuid_or_name_label
. También puede especificar filtr ando la lista completa de hosts en los valores de los campos. Por ejemplo, al especificar seenabled=true
seleccionan todos los hosts cuyoenabled
campo es igual atrue
. Cuando coincidan varios hosts y la operación se puede realizar en varios hosts, debe especificar--multiple
para realizar la operación. A lista completa de parâmetros que podem ser correspondados é descrita no início deste seção. Puede obtener esta lista de comandos ejecutando el comandoxe host-list params=all
. Si no se proporcionan parámetros para seleccionar hosts, la operación se realiza en todos los hosts.
Parámetros de host
tienen los siguientes parámetros :
Nombre del parámetro | Descripción | Tipo |
---|---|---|
uuid |
La referencia única de identificador/objeto para el host | Sólo lectura |
name-label |
El nombre del host | Lectura/Escritura |
name-description |
La cadena descriptiva del host | Sólo lectura |
enabled |
El valor esfalse si está deshabilitado. Esto evita que las máquinas virtuales nuevas se inicien en los hosts y prepara los hosts para que se apaguen o se reinicien. El valor estrue si el host está habilitado |
Sólo lectura |
API-version-major |
Número de versión principal | Sólo lectura |
API-version-minor |
Número de versión secundaria | Sólo lectura |
API-version-vendor |
Identificación del proveedor de API | Sólo lectura |
API-version-vendor-implementation |
Detalles de la implementación del proveedor | Parámetro de mapa de sólo lectura |
logging |
Configuración de registro | Parámetro de mapa de lectura y escritura |
suspend-image-sr-uuid |
La referencia única de identificador/objeto para el SR donde se colocan imágenes suspendidas | Lectura/Escritura |
crash-dump-sr-uuid |
La referencia única de identificador/objeto para el SR donde se colocan volcados de bloqueo | Lectura/Escritura |
software-version |
Lista de parámetros de versionado y sus valores | Parámetro de mapa de sólo lectura |
capabilities |
Lista de versiones de Xen que el host puede ejecutar | Parámetro de conjunto de sólo lectura |
other-config |
Una lista de pares clave/valor que especifican parámetros de configuración adicionales para el host | Parámetro de mapa de lectura y escritura |
chipset-info |
Una lista de pares clave/valor que especifican información sobre el chipset | Parámetro de mapa de sólo lectura |
hostname |
nombre de host | Sólo lectura |
address |
dirección IP del host | Sólo lectura |
license-server |
Una lista de pares clave/valor que especifican información sobre el servidor de licencias. | Parámetro de mapa de sólo lectura |
supported-bootloaders |
Lista de cargadores de arranque que o host suporta, por exemplo, pygrub, eliloader | Parámetro de conjunto de sólo lectura |
memory-total |
Cantidad total de RAM física en el host, en bytes | Sólo lectura |
memory-free |
Cantidad total de RAM física restante que se puede asignar a las VM, en bytes | Sólo lectura |
host-metrics-live |
True si el host está operativo | Sólo lectura |
logging |
Lasyslog_destination clave se puede establecer en el nombre de host de un servicio syslog de escucha remota. |
Parámetro de mapa de lectura y escritura |
allowed-operations |
Muestra las operaciones permitidas en este estado. Esta lista es sólo de carácter consultivo y el estado del servidor puede haber cambiado en el momento en que un cliente lee este campo. | Parámetro de conjunto de sólo lectura |
current-operations |
Muestra las operaciones actualmente en proceso. Esta lista es sólo de carácter consultivo y el estado del servidor puede haber cambiado en el momento en que un cliente lee este campo. | Parámetro de conjunto de sólo lectura |
patches |
Conjunto de parches de host | Parámetro de conjunto de sólo lectura |
blobs |
Almacén de datos binario | Sólo lectura |
memory-free-computed |
Una estimación conservadora de la cantidad máxima de memoria libre en un host | Sólo lectura |
ha-statefiles |
Los UUID de todos los archivos de estado HA | Sólo lectura |
ha-network-peers |
UUID de todos los hosts que podrían alojar las VM en este host si hay un error | Sólo lectura |
external-auth-type |
Tipo de autenticación externa, por ejemplo, Active Directory. | Sólo lectura |
external-auth-service-name |
El nombre del servicio de autenticación externa | Sólo lectura |
external-auth-configuration |
Información de configuración para el servicio de autenticación externa. | Parámetro de mapa de sólo lectura |
contienen otros objetos que también tienen listas de parámetros .
Las CPU de los hosts tienen los siguientes parámetros:
Nombre del parámetro | Descripción | Tipo |
---|---|---|
uuid |
La referencia única de identificador/objeto para la CPU | Sólo lectura |
number |
El número del núcleo físico de la CPU dentro del host | Sólo lectura |
vendor |
La cadena de proveedor para el nombre de CPU | Sólo lectura |
speed |
La velocidad del reloj de la CPU, en Hz | Sólo lectura |
modelname |
La cadena de proveedor para el modelo de CPU, por ejemplo, “Intel (R) Xeon (TM) CPU 3.00 GHz” | Sólo lectura |
stepping |
El número de revisión de la CPU | Sólo lectura |
flags |
Las banderas de la CPU física (una versión decodificada del campo de características) | Sólo lectura |
Utilisation |
La utilización actual de la CPU | Sólo lectura |
host-uuid |
El UUID si el host en el que se encuentra la CPU | Sólo lectura |
model |
El número de modelo de la CPU física | Sólo lectura |
family |
El número de familia de CPU física | Sólo lectura |
Los volcados de fallos en los hosts tienen los siguientes parámetros:
Nombre del parámetro | Descripción | Tipo |
---|---|---|
uuid |
La referencia única de identifiador/objeto para el volcado de choque | Sólo lectura |
host |
el crashdump corresponde a | Sólo lectura |
timestamp |
Marca de hora de la fecha y hora en que se produjo el volcado de choque, en el formularioyyyymmdd-hhmmss-ABC , donde ABCes el indicador de zona horaria, por ejemplo, GMT |
Sólo lectura |
size |
Tamaño del crash dump, en bytes | Sólo lectura |
host-all-editions
todas las ediciones de host
Obtener una lista de todas las ediciones disponibles
host-apply-edition
host-apply-edition [host-uuid = host_uuid] [edition = xenserver_edition = “free” "per-socket" “xendesktop”]
Asigna la licencia a un servidor host. Cuando asigna una licencia, se pone en contacto con el servidor de licencias y solicita el tipo de licencia especificado. Si hay una licencia disponible, se extraen del servidor de licencias.
Para obtener información sobre la configuración inicial de licencias, consulte tambiénlicense-server-address
ylicense-server-port
.
host-backup
host-backup file-name = backup_filename host = host_name
Descargue una copia de seguridad del dominio de control del host especificado en el equipo desde el que se invoca el comando. Guárdelo allí como un archivo con el nombrefile-name
.
Importante:
Mientras que el
xe host-backup
comando funciona si se ejecuta en el host local (es decir, sin un nombre de host específico especificado), no lo use de esta manera. Si lo hace, llenaría la partición del dominio de control con el archivo de copia de seguridad. Utilice únicamente el comando desde un equipo remoto fuera del host donde tenga espacio para guardar el archivo de copia de seguridad.
host-bugreport-upload
host-bugreport-upload [host-selector = valor_selector_host...] [url = destination_url http-proxy = http_proxy_nombre]
Genera un nuevo informe de errores (usando xen-bugtool, con todos los archivos opcionales incluidos) y súbelo al sitio FTP de soporte o a alguna otra ubicación.
Los hosts en los que se debe realizar esta operación se seleccionan utilizando el mecanismo de selección estándar (consulte los selectores de hostmás arriba). Los argumentos opcionales pueden ser cualquier número de parámetros de hostenumerados al principio de esta sección.
Los parámetros opcionales sonhttp-proxy
: usar proxy http especificado yurl
: upload a esta URL de destino. Si no se utilizan parámetros opcionales, no se identifica ningún servidor proxy y el destino es el sitio FTP de soporte predeterminado.
host-call-plugin
host-call-plugin host-uuid = plugin_uuid = plugin fn = función [args = args]
Llama a la función dentro del complemento en el host dado con argumentos opcionales.
host-compute-free-memory
host-compute-libre-memoria
Calcula la cantidad de memoria libre en el host.
host-compute-memory-overhead
sobrecarga de memoria de cómputo-host
Calcula la sobrecarga de memoria de virtualización de un host.
host-cpu-info
host-cpu-info [uuid = uuid]
Muestra información sobre las CPU físicas del host.
host-crashdump-destroy
host-crashdump-destroy uuid = crashdump_uuid
Elimine un volcado de choque de host especificado por su UUID del host.
host-crashdump-upload
host-crashdump-upload uuid = crashdump_uuid [url = destination_url] [http-proxy = http_proxy_name]
Cargue un “crash dump” en el sitio FTP de soporte u otra ubicación. Si no se utilizan parámetros opcionales, no se identifica ningún servidor proxy y el destino es el sitio FTP de soporte predeterminado. Los parámetros opcionales sonhttp-proxy
: usar proxy http especificado yurl
: upload a esta URL de destino.
host-declare-dead
host-declare-dead uuid = host_uuid
Declarar que el host está muerto sin ponerse en contacto con él explícitamente.
Advertencia:
Esta llamada es peligrosa y puede causar pérdida de datos si el host no está realmente muerto.
host-disable
host-disable [host-selector = valor_selector_host...]
Deshabilita los hosts especificados, lo que impide que las máquinas virtuales nuevas se inicien en ellos. Esta acción prepara los hosts para que se apaguen o se reinicien.
Los hosts en los que se debe realizar esta operación se seleccionan mediante el mecanismo de selección estándar (consulte selectores de host). Los argumentos opcionales pueden ser cualquier número de parámetros de hostenumerados al principio de esta sección.
host-disable-display
host-disable-display uuid = host_uuid
Deshabilite la visualización para el host.
host-disable-local-storage-caching
host-disable-local-storage-cache
Deshabilite el almacenamiento en caché local en el host especificado.
host-dmesg
host-dmesg [host-selector = valor_selector_host...]
Obtener un Xendmesg
(la salida del búfer de anillo del núcleo) de los hosts especificados.
Los hosts en los que se debe realizar esta operación se seleccionan utilizando el mecanismo de selección estándar (consulte los selectores de hostmás arriba). Los argumentos opcionales pueden ser cualquier número de parámetros de hostenumerados al principio de esta sección.
host-emergency-ha-disable
host-emergency-ha-disable [— force]
Deshabilite HA en el host local. Sólo se utiliza para recuperar un grupo con una configuración de HA rota.
host-emergency-management-reconfigure
host-emergency-management-reconfigure interface = uuid_of_management_interface_pif
Vuelva a configurar la interfaz de administración de este host. Utilice este comando sólo si el host está en modo de emergencia. El modo de emergencia significa que el host es un miembro de un fondo de recursos cuyo maestro ha desaparecido de la red y no se puede contactar después de varios reintentos.
host-enable
host-enable [host-selector = host-selector_valor...]
Habilita los hosts especificados, lo que permite iniciar nuevas máquinas virtuales en ellos.
Los hosts en los que se debe realizar esta operación se seleccionan utilizando el mecanismo de selección estándar (consulte los selectores de hostmás arriba). Los argumentos opcionales pueden ser cualquier número de parámetros de hostenumerados al principio de esta sección.
host-enable-display
host-enable-display uuid = host_uuid
Habilite la visualización para el host.
host-enable-local-storage-caching
host-enable-local-storage-caching sr-uuid = sr_uuid
Habilite el almacenamiento en caché local en el host especificado.
host-evacuate
host-evacuar [host-selector = host-selector_valor...]
Live migra todas las máquinas virtuales en ejecución a otros hosts adecuados en un grupo. Primero, disbale el host mediante elhost-disable
comando.
Si el host evacuado es el maestro de grupo, se debe seleccionar otro host para que sea el maestro de grupo. Para cambiar el patrón de grupo con HA deshabilitado, utilice elpool-designate-new-master
comando. Para obtener más información, consulte pool-designate-new-master.
Con HA activada, la única opción es apagar el servidor, lo que hace que HA elija un nuevo maestro al azar. Para obtener más información, vea apagado de host.
Los hosts en los que se debe realizar esta operación se seleccionan utilizando el mecanismo de selección estándar (consulte los selectores de hostmás arriba). Los argumentos opcionales pueden ser cualquier número de parámetros de hostenumerados al principio de esta sección.
host-forget
host-forget uuid = host_uuid
El agente XAPI se olvida del host especificado sin ponerse en contacto con él explícitamente.
Utilice el--force
parámetro para evitar que se le pida que confirme que realmente desea realizar esta operación.
Advertencia:
No utilice este comando si HA está habilitado en el grupo. Desactive primero HA y, a continuación, vuelva a activarlo después de haber olvidado el host.
Consejo:
Este comando es útil si el host para “olvidar” está muerto. Sin embargo, si el host está activo y forma parte del grupo, úselo
xe pool-eject
en su lugar.
host-get-cpu-features
host-get-cpu-features {features = pool_master_cpu_features} [uuid = host_uuid]
Imprime una representación hexadecimal de las características físicas de CPU del host.
host-get-server-certificate
host-get-server-certificate
Obtener el certificado SSL del servidor instalado.
host-get-sm-diagnostics
host-get-sm-diagnostics uuid = uuid
Mostrar información de diagnóstico SM por host.
host-get-system-status
host-get-system-status filename = name\_for\_status\_file \[entries = comma\_separated\_list] \[output = tar.bz2 | zip] \[host-selector = valor\_selector\_host...]
Descargue la información de estado del sistema en el archivo especificado. El parámetro opcionalentries
es una lista separada por comas de las entradas de estado del sistema, tomada del fragmento XML de capacidades devuelto por elhost-get-system-status-capabilities
comando. Para obtener más información, vea host-get-system-status-capabilities. Si no se especifica, toda la información de estado del sistema se guarda en el archivo. El parámetrooutput
puede ser tar.bz2 (el valor predeterminado) o zip . Si no se especifica este parámetro, el archivo se guarda entar.bz2
forma.
Los hosts en los que se debe realizar esta operación se seleccionan utilizando el mecanismo de selección estándar (consulte los selectores de hostmás arriba).
host-get-system-status-capabilities
host-get-system-status-capabilities [host-selector = valor_selector_host...]
Obtenga capacidades de estado del sistema para los hosts especificados. Las capacidades se devuelven como un fragmento XML similar al siguiente ejemplo:
<!--NeedCopy-->
Cada entidad de capacidad puede tener los siguientes atributos.
-
key
Un identificador único para la capacidad. -
content-type
Puede ser texto/simple o aplicación/datos. Indica si una interfaz de usuario puede representar las entradas para consumo humano. -
default-checked
Puede ser sí o no. Indica si una interfaz de usuario debe seleccionar esta entrada de forma predeterminada. -
min-size
,max-size
Indica un rango aproximado para el tamaño, en bytes, de esta entrada. -1 indica que el tamaño no es importante. -
min-time
,max-time
Indique un rango aproximado para el tiempo, en segundos, tomado para recoger esta entrada. -1 indica que el tiempo no es importante. -
Información de
pii
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 -
yes
: PII probablemente o ciertamente está en estas entradas -
maybe
: es posible que desee auditar estas entradas para la PII -
if_customized
si los archivos no están modificados, entonces no contienen PII. Sin embargo, debido a que alentamos la edición de estos archivos, la PII podría haber sido introducida por dicha personalización. Este valor se utiliza en particular para las secuencias de comandos de red en el dominio de control.
Las contraseñas nunca se incluirán en ningún informe de error, independientemente de cualquier declaración de PII.
-
Los hosts en los que se debe realizar esta operación se seleccionan utilizando el mecanismo de selección estándar (consulte los selectores de hostmás arriba).
host-get-thread-diagnostics
host-get-thread-diagnostics uuid = uuid
Mostrar información de diagnóstico de subprocesos por host.
host-get-vms-which-prevent-evacuation
host-get-vms-which-prevent-evacuation uuid = uuid
Devuelve una lista de máquinas virtuales que impiden la evacuación de un host específico y muestran los motivos de cada una de ellas.
host-is-in-emergency-mode
host está en modo de emergencia
Devuelvetrue
si el host con el que está hablando CLI está en modo de emergencia, defalse
lo contrario. Este comando CLI funciona directamente en hosts esclavos incluso sin host maestro presente.
host-license-add
host-license-add [license-file = ruta/license_filename] [host-uuid = host_uuid]
Para (edición gratuita), utilice para analizar un archivo de licencia local y agregarlo al host especificado.
host-license-remove
host-license-remove [host-uuid = host_uuid]
Elimine cualquier licencia aplicada a un host.
host-license-view
host-license-view [host-uuid = host_uuid]
Muestra el contenido de la licencia de host.
host-logs-download
host-logs-download [file-name = logfile_name] [host-selector = valor_selector_host...]
Descargue una copia de los registros de los hosts especificados. La copia se guarda de forma predeterminada en un archivo con sello de hora denominadohostname-yyyy-mm-dd T hh:mm:ssZ.tar.gz
. Puede especificar un nombre de archivo diferente utilizando el parámetro opcional nombre-archivo.
Los hosts en los que se debe realizar esta operación se seleccionan utilizando el mecanismo de selección estándar (consulte los selectores de hostmás arriba). Los argumentos opcionales pueden ser cualquier número de parámetros de hostenumerados al principio de esta sección.
Importante:
Mientras que el
xe host-logs-download
comando funciona si se ejecuta en el host local (es decir, sin un nombre de host específico especificado), no lo use de esta manera. Al hacerlo, se abarrota la partición del dominio de control con la copia de los registros. El comando solo debe usarse desde un equipo remoto fuera del host donde tenga espacio para guardar la copia de los registros.
host-management-disable
deshabilitación de gestión de host
Deshabilita la escucha del agente de host en una interfaz de red de administración externa y desconecta todos los clientes API conectados (como el ). Este comando opera directamente en el host al que está conectada la CLI. El comando no se reenvía al maestro de grupo cuando se aplica a un host miembro.
Advertencia:
Tenga cuidado al usar este comando CLI fuera del host. Después de ejecutar este comando, no puede conectarse al dominio de control remotamente a través de la red para volver a habilitar el agente de host.
host-management-reconfigure
host-management-reconfigure [interfaz = dispositivo] [pif-uuid = uuid]
Vuelve a configurar el host para que utilice la interfaz de red especificada como su interfaz de administración, que es la interfaz que se utiliza para conectarse al . El comando reescribe la clave MANAGEMENT_INTERFACE en/etc/xensource-inventory
.
Si se especifica el nombre de dispositivo de una interfaz (que debe tener una dirección IP), el host se vuelve a conectar inmediatamente. Este comando funciona tanto en modo normal como en modo de emergencia.
Si se especifica el UUID de un objeto PIF, el host determina qué dirección IP se va a enlazar. No debe estar en modo de emergencia cuando se ejecuta este comando.
Advertencia:
Tenga cuidado al usar este comando CLI fuera del host y asegúrese de tener conectividad de red en la nueva interfaz. Utilícelo
xe pif-reconfigure
para configurar uno primero. De lo contrario, los comandos de CLI posteriores llegan al host.
host-power-on
host-power-on [host = host_uuid]
Enciende los hosts con la función de encendido del host habilitada. Antes de utilizar este comando, habilite host-set-power-on
en el host.
host-reboot
host-reboot [host-selector = valor_selector_host...]
Reinicie los hosts especificados. Los hosts especificados deben deshabilitarse primero mediante elxe host-disable
comando; de lo contrario, se mostrará un mensaje deHOST_IN_USE
error.
Los hosts en los que se debe realizar esta operación se seleccionan utilizando el mecanismo de selección estándar (consulte los selectores de hostmás arriba). Los argumentos opcionales pueden ser cualquier número de parámetros de hostenumerados al principio de esta sección.
Si los hosts especificados son miembros de un grupo, se controla la pérdida de conectividad al apagar y el grupo se recupera cuando los hosts regresan. Los demás miembros y el maestro continúan funcionando.
Si cierra el patrón, el grupo estará fuera de acción hasta que se produzca una de las siguientes acciones:
- Usted convierte a uno de los miembros en el maestro
-
El maestro original se reinicia y vuelve a estar en línea.
Cuando el maestro vuelve a estar en línea, los miembros se vuelven a conectar y sincronizan con el maestro.
host-restore
host-restore [nombreArchivo = nombreDeArchivo_copia de seguridad] [host-selector = valor_selector_host...]
Restaure una copiafile-name
de seguridad con el nombre del software de control de host. El uso de la palabra “restaurar” aquí no significa una restauración completa en el sentido habitual, simplemente significa que el archivo de copia de seguridad comprimido se ha descomprimido y desempaquetado en la partición secundaria. Después de haber hecho unxe host-restore
, debe iniciar el CD de instalación y utilizar su opción Restaurar desde copia de seguridad.
Los hosts en los que se debe realizar esta operación se seleccionan utilizando el mecanismo de selección estándar (consulte los selectores de hostmás arriba). Los argumentos opcionales pueden ser cualquier número de parámetros de hostenumerados al principio de esta sección.
host-send-debug-keys
host-send-debug-keys host-uuid = host_uuid claves = claves
Enviar claves de depuración del hipervisor especificadas al host especificado.
host-set-hostname-live
host-set-hostname host-uuid = uuid_of_host hostname = new_hostname
Cambie el nombre de host del host especificado porhost-uuid
. Este comando establece persistentemente tanto el nombre de host en la base de datos del dominio de control como el nombre de host de Linux real del host. El valor de hostname**no es el mismo que el valor del campo name_label .
host-set-power-on-mode
host-set-poweron-mode {host = host_uuid {power-on-mode = "" "“wake-on-lan”
“iLO” \"DRAC\" “custom”} | \[power-on-config = “power\_on\_ip” \"power\_on\_user\" “power\_on\_password\_secret”]}
Utilícelo para habilitar la función de encendido del host en hosts compatibles con soluciones de alimentación remota. Al usar elhost-set-power-on
comando, debe especificar el tipo de solución de administración de energía en el host (es decir, el modo de encendido). A continuación, especifique las opciones de configuración utilizando el argumento power-on-config y sus pares clave-valor asociados. Para utilizar la función de secretos para almacenar la contraseña, especifique la clave"power_on_password_secret"
.
host-shutdown
host-shutdown [host-selector = valor_selector_host...]
Apague los hosts especificados. Los hosts especificados deben deshabilitarse primero mediante elxe host-disable
comando; de lo contrario, se mostrará un mensaje deHOST_IN_USE
error.
Los hosts en los que se debe realizar esta operación se seleccionan utilizando el mecanismo de selección estándar (consulte los selectores de hostmás arriba). Los argumentos opcionales pueden ser cualquier número de parámetros de hostenumerados al principio de esta sección.
Si los hosts especificados son miembros de un grupo, se controla la pérdida de conectividad al apagar y el grupo se recupera cuando los hosts regresan. Los demás miembros y el maestro continúan funcionando.
Si cierra el patrón, el grupo estará fuera de acción hasta que se produzca una de las siguientes acciones:
- Usted convierte a uno de los miembros en el maestro
-
El maestro original se reinicia y vuelve a estar en línea.
Cuando el maestro vuelve a estar en línea, los miembros se vuelven a conectar y sincronizan con el maestro.
Si HA está habilitada para el grupo, uno de los miembros se convierte en un maestro automáticamente. Si HA está deshabilitado, debe designar manualmente el servidor deseado como maestro con elpool-designate-new-master
comando. Para obtener más información, consulte pool-designate-new-master.
host-sm-dp-destroy
host-sm-dp-destroy uuid = uuid dp = dp \[allow-leak = true | false]
Intentar destruir y limpiar una ruta de datos de almacenamiento en un host. Siallow-leak=true
se proporciona, eliminará todos los registros de la ruta de datos incluso si no se pudo apagar limpiamente.
host-sync-data
datos de sincronización de host
Sincronizar los datos que no son de base de datos almacenados en el maestro de grupo con el host con nombre.
host-syslog-reconfigure
host-syslog-reconfigure [host-selector = valor_selector_host...]
Vuelva a configurar elsyslog
daemon en los hosts especificados. Este comando aplica la información de configuración definida en ellogging
parámetro host.
Los hosts en los que se debe realizar esta operación se seleccionan utilizando el mecanismo de selección estándar (consulte los selectores de hostmás arriba). Los argumentos opcionales pueden ser cualquier número de parámetros de hostenumerados al principio de esta sección.
host-data-source-list
host-data-source-list [host-selectors = valor del selector de host...]
Enumere los orígenes de datos que se pueden registrar para un host.
Seleccione los hosts en los que desea realizar esta operación mediante el mecanismo de selección estándar (consulte selectores de host). Los argumentos opcionales pueden ser cualquier número de parámetros de hostenumerados al principio de esta sección. Si no se proporcionan parámetros para seleccionar hosts, la operación se realiza en todos los hosts.
Las fuentes de datos tienen dos parámetros —standard
yenabled
. Este comando genera los valores de los parámetros:
- Si un origen de datos se ha
enabled
establecido entrue
, las métricas se están registrando actualmente en la base de datos de rendimiento. - Si un origen de datos se ha
standard
establecido entrue
, las métricas se registran en la base de datos de rendimiento de forma predeterminada . El valor de tambiénenabled
se establece entrue
para este origen de datos. - Si un origen de datos se ha
standard
establecido enfalse
, las métricas no se registran en la base de datos de rendimiento de forma predeterminada. El valor de tambiénenabled
se establece enfalse
para este origen de datos.
Para comenzar a registrar métricas de origen de datos en la base de datos de rendimiento, ejecute elhost-data-source-record
comando. Este comando se estableceenabled
entrue
. Para detener, ejecute elhost-data-source-forget
. Este comando se estableceenabled
enfalse
.
host-data-source-record
host-data-source-record data-source = name_description_of_data_source [host-selectors = host_selector_valor...]
Registre el origen de datos especificado para un host.
Esta operación escribe la información del origen de datos en la base de datos de métricas de rendimiento persistentes de los hosts especificados. Por motivos de rendimiento, esta base de datos es distinta de la base de datos del agente normal.
Seleccione los hosts en los que desea realizar esta operación mediante el mecanismo de selección estándar (consulte selectores de host). Los argumentos opcionales pueden ser cualquier número de parámetros de hostenumerados al principio de esta sección. Si no se proporcionan parámetros para seleccionar hosts, la operación se realiza en todos los hosts.
host-data-source-forget
host-data-source-forget data-source = name_description_of_data_source [host-selectors = host_selector_valor...]
Detenga la grabación del origen de datos especificado para un host y olvide todos los datos registrados.
Seleccione los hosts en los que desea realizar esta operación mediante el mecanismo de selección estándar (consulte selectores de host). Los argumentos opcionales pueden ser cualquier número de parámetros de hostenumerados al principio de esta sección. Si no se proporcionan parámetros para seleccionar hosts, la operación se realiza en todos los hosts.
host-data-source-query
host-data-source-query data-source = name_description_of_data_source [host-selectors = host_selector_valor...]
Mostrar el origen de datos especificado para un host.
Seleccione los hosts en los que desea realizar esta operación mediante el mecanismo de selección estándar (consulte selectores de host). Los argumentos opcionales pueden ser cualquier número de parámetros de hostenumerados al principio de esta sección. Si no se proporcionan parámetros para seleccionar hosts, la operación se realiza en todos los hosts.
Comandos de registro
Comandos para trabajar con registros.
log-get
log-get
Devuelve el registro almacenado actualmente en el registrador de cadenas.
log-get-keys
log-get-keys
Enumere las claves conocidas por el registrador.
log-reopen
volver a abrir el registro
Vuelva a abrir todos los registradores (use esto para rotar archivos).
log-set-output
log-set-output output output = output [key = key] [level = level]
Establezca todos los registradores en la salida especificada (nil, stderr, string, file:filename, syslog:something).
Comandos de mensaje
Comandos para trabajar con mensajes. Los mensajes se crean para notificar a los usuarios de eventos significativos y se muestran como alertas.
Los objetos de mensaje se pueden enumerar con el comando estándar de lista de objetos (xe message-list
) y los parámetros se pueden manipular con los comandos de parámetros estándar. Para obtener más información, consulte [Comandos#low-level-parameter-commands()de parámetros de nivel bajo]
Parámetros del mensaje
Nombre del parámetro | Descripción | Tipo |
---|---|---|
uuid |
El identificador único o referencia de objeto para el mensaje | Sólo lectura |
name |
El nombre único del mensaje | Sólo lectura |
priority |
La prioridad del mensaje. Las cifras más altas indican una mayor prioridad | Sólo lectura |
class |
La clase de mensaje, por ejemplo VM. | Sólo lectura |
obj-uuid |
El uuid del objeto afectado. | Sólo lectura |
timestamp |
Hora en que se generó el mensaje. | Sólo lectura |
body |
El contenido del mensaje. | Sólo lectura |
message-create
message-create name = message\_name body = message\_text \[\[host-uuid = uuid\_of\_host] | \[sr-uuid = uuid\_of\_sr} | \[vm-uuid = uuid\_of\_vm] | \[pool-uuid = uuid\_of\_pool]]
Crea un mensaje.
message-destroy
message-destroy [uuid = message_uuid]
Destruye un mensaje existente. Puede crear un script para destruir todos los mensajes. Por ejemplo:
# Descartar todas las alertas \
IFS = “,”; for m in $(xe message-list params = uuid — minimal); do \
xe message-destroy uuid = $m \
hecho
Comandos de red
Comandos para trabajar con redes.
Los objetos de red se pueden enumerar con el comando estándar de lista de objetos (xe network-list
) y los parámetros se pueden manipular con los comandos de parámetros estándar. Para obtener más información, consulte [Comandos#low-level-parameter-commands()de parámetros de nivel bajo]
Parámetros de red
Las redes tienen los siguientes parámetros:
Nombre del parámetro | Descripción | Tipo |
---|---|---|
uuid |
El identificador único o referencia de objeto para la red | Sólo lectura |
name-label |
El nombre de la red | Lectura/Escritura |
name-description |
El texto de descripción de la red | Lectura/Escritura |
VIF-uuids |
Una lista de identificadores únicos de los VIF (interfaces de red virtual) que están conectados desde máquinas virtuales a esta red | Parámetro de conjunto de sólo lectura |
PIF-uuids |
Una lista de identificadores únicos de los PIF (interfaces de red físicas) que se adjuntan desde hosts a esta red | Parámetro de conjunto de sólo lectura |
bridge |
Nombre del puente correspondiente a esta red en el host local | Sólo lectura |
default-locking-mode |
Objeto de red utilizado con objetos VIF para el filtrado ARP. Definunlocked a para eliminar todas las reglas de filtrado asociadas al VIF. Establezca paradisabled que el VIF deje caer todo el tráfico. |
Lectura/Escritura |
purpose |
Conjunto de propósitos para los que el host utiliza esta red. Establezcanbd como para utilizar la red para realizar conexiones NBD. |
Lectura/Escritura |
other-config:staticroutes |
Lista separada por comas de entradas formateadas de subred/máscarade red /puerta de enlaceque especifican la dirección de puerta de enlace a través de la cual se enrutan las subredes. Por ejemplo,other-config:static-routes establecer en 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 sobre 192.168.0.3 y el tráfico de 172.18.0.0/16 se enrute sobre 192.168.0.4. |
Lectura/Escritura |
other-config:ethtoolautoneg |
Establezca en no para deshabilitar la negociación automática de la interfaz física o el puente. El valor predeterminado es sí. | Lectura/Escritura |
other-config:ethtool-rx |
Establezca en activado para habilitar la suma de comprobación de recepción, desactivado para deshabilitar | Lectura/Escritura |
other-config:ethtool-tx |
Establezca en activado para habilitar la suma de comprobación de transmisión, desactivado para deshabilitar | Lectura/Escritura |
other-config:ethtool-sg |
Establezca en activado para habilitar la recopilación de dispersión, desactivado para deshabilitar | Lectura/Escritura |
other-config:ethtool-tso |
Establezca en activado para habilitar descarga de segmentación tcp, desactivado para deshabilitar | Lectura/Escritura |
other-config:ethtool-ufo |
Establezca en activado para habilitar la descarga de fragmentos UDP, desactivado para deshabilitar | Lectura/Escritura |
other-config:ethtool-gso |
Establezca en activado para habilitar la descarga de segmentación genérica, desactivada para deshabilitar | Lectura/Escritura |
blobs |
Almacén de datos binario | Sólo lectura |
network-create
network-create name-label = name_for_network [name-description = text_descriptivo]
Crea una red.
network-destroy
network-destroy uuid = network_uuid
Destruye una red existente.
Comandos SR-IOV
Comandos para trabajar con SR-IOV.
Los objetos network-sriov se pueden enumerar con el comando estándar de lista de objetos (xe network-sriov-list
) y los parámetros se pueden manipular con los comandos de parámetros estándar. Para obtener más información, consulte [Comandos#low-level-parameter-commands()de parámetros de nivel bajo]
Parámetros SR-IOV
SR-IOV tiene los siguientes parámetros:
Nombre del parámetro | Descripción | Tipo |
---|---|---|
physical-PIF |
El PIF para habilitar SR-IOV. | Sólo lectura |
logical-PIF |
Un PIF lógico SR-IOV. Los usuarios pueden utilizar este parámetro para crear una red VLAN SR-IOV. | Sólo lectura |
requires-reboot |
Si se establece en True, se utiliza para reiniciar el host para activar SR-IOV. | Sólo lectura |
remaining-capacity |
Número de VF disponibles restantes. | Sólo lectura |
network-sriov-create
xe network-sriov-create network-uuid = network_uuid pif-uuid = physical_pif_uuid
Crea un objeto de red SR-IOV para un PIF físico determinado y habilita SR-IOV en el PIF físico.
network-sriov-destroy
xe network-sriov-destroy uuid = network_sriov_uuid
Elimina un objeto SR-IOV de red y deshabilita SR-IOV en su PIF físico.
Asignar una VF SR-IOV
xe vif-create device = device_index mac = vf_mac_address network-uuid = sriov_network vm-uuid = vm_uuid
Asigna una VF desde una red SR-IOV a una máquina virtual.
Comandos del controlador SDN
Comandos para trabajar con el controlador SDN.
sdn-controller-forget
sdn-controller-introduce [dirección = dirección] [protocolo = protocolo] [tcp-port = tcp_port]
Introducir un controlador SDN.
sdn-controller-introduce
sdn-controller-forget uuid = uuid
Retire un controlador SDN.
Comandos de túnel
Comandos para trabajar con túneles.
tunnel-create
tunel-create pif-uuid = pif_uuid network-uuid = network_uuid
Cree un nuevo túnel en un host.
tunnel-destroy
tunel-destroy uuid = uuid
Destruye un túnel.
Comandos de parche
Comandos para trabajar con parches.
patch-apply
patch-apply uuid = patch_uuid host-uuid = host_uuid
Aplique el parche cargado anteriormente al host especificado.
patch-clean
parche-clean uuid = uuid
Eliminar un archivo de parche cargado anteriormente.
patch-destroy
patch-destroy uuid = uuid
Quite un registro de revisión y archivos no aplicados del servidor.
patch-pool-apply
patch-pool-apply uuid = uuid
Aplique el parche cargado anteriormente a todos los hosts del grupo.
patch-pool-clean
patch-pool-clean uuid = uuid
Elimine un archivo de revisión cargado anteriormente en todos los hosts del grupo.
patch-precheck
patch-precheck uuid = uuid host-uuid = host_uuid
Ejecute las comprobaciones previas contenidas en el parche cargado anteriormente en el host especificado.
patch-upload
patch-upload nombre-archivo = nombreDeArchivo
Cargue un archivo de parche en el servidor.
Comandos PBD
Comandos para trabajar con PBD (dispositivos de bloqueo físico). Los PBD son los objetos de software a través de los cuales el host accede a los repositorios de almacenamiento (SRs).
Los objetos PBD se pueden enumerar con el comando estándar de lista de objetos (xe pbd-list
) y los parámetros se pueden manipular con los comandos de parámetros estándar. Para obtener más información, consulte [Comandos#low-level-parameter-commands()de parámetros de nivel bajo]
Parámetros PBD
Los PBD tienen los siguientes parámetros:
Nombre del parámetro | Descripción | Tipo |
---|---|---|
uuid |
La referencia única de identifiador/objeto para el PBD. | Sólo lectura |
sr-uuid |
El repositorio de almacenamiento al que apunta el PBD | Sólo lectura |
device-config |
Información adicional de configuración que se proporciona al controlador SR-Backend-de un host | Parámetro de mapa de sólo lectura |
currently-attached |
True si el SR está conectado en este host, False en caso contrario | Sólo lectura |
host-uuid |
UUID de la máquina física en la que está disponible el PBD | Sólo lectura |
host |
El campo host está obsoleto. Use host_uuid en su lugar. | Sólo lectura |
other-config |
Información adicional de configuración. | Parámetro de mapa de lectura y escritura |
pbd-create
pbd-create host-uuid = uuid_of_host sr-uuid = uuid_of_sr [device-config: clave = valor_correspondiente]
Cree un PBD en su host. Eldevice-config
parámetro de sólo lectura sólo se puede establecer en el momento de la creación.
Para agregar una asignación desde ‘path’ a ‘/ tmp’, la línea de comando debe contener el argumentodevice-config:path=/tmp
Para obtener una lista completa de los pares de clave/valor de configuración de dispositivo compatibles en cada tipo SR, consulte Almacenamiento.
pbd-destroy
pbd-destroy uuid = uuid_of_pbd
Destruye el PBD especificado.
pbd-plug
pbd-plug uuid = uuid_of_pbd
Intenta conectar el PBD al host. Si este comando se realiza correctamente, el SR de referencia (y los VDIS contenidos en) deberían ser visibles para el host.
pbd-unplug
pbd-unplug uuid = uuid_of_pbd
Intente desconectar el PBD del host.
Comandos PIF
Comandos para trabajar con PIF (objetos que representan las interfaces de red físicas).
Los objetos PIF se pueden enumerar con el comando estándar de lista de objetos (xe pif-list
) y los parámetros se pueden manipular con los comandos de parámetros estándar. Para obtener más información, consulte [Comandos#low-level-parameter-commands()de parámetros de nivel bajo]
Parámetros PIF
Los PIF tienen los siguientes parámetros:
Nombre del parámetro | Descripción | Tipo |
---|---|---|
uuid |
La referencia única de identificador/objeto para el PIF | Sólo lectura |
device machine-readable |
Nombre de la interfaz (por ejemplo, eth0) | Sólo lectura |
MAC |
La dirección MAC del PIF | Sólo lectura |
other-config |
name:value`` Pares de configuración PIF adicionales. | Parámetro de mapa de lectura y escritura |
physical |
Si es verdadero, el PIF apunta a una interfaz de red física real | Sólo lectura |
currently-attached |
¿Está el PIF adjunto actualmente a este host? true ofalse
|
Sólo lectura |
MTU |
Unidad de transmisión máxima del PIF en bytes. | Sólo lectura |
VLAN |
Etiqueta VLAN para todo el tráfico que pasa a través de esta interfaz. -1 indica que no se ha asignado ninguna etiqueta VLAN | Sólo lectura |
bond-master-of |
El UUID del vínculo de este PIF es el maestro (si lo hay) | Sólo lectura |
bond-slave-of |
El UUID del vínculo de este PIF es el esclavo (si lo hay) | Sólo lectura |
management |
¿Es este PIF designado para ser una interfaz de administración para el dominio de control | Sólo lectura |
network-uuid |
La referencia única de identificador/objeto de la red virtual a la que está conectado este PIF | Sólo lectura |
network-name-label |
El nombre de la red virtual a la que está conectado este PIF | Sólo lectura |
host-uuid |
La referencia única de identificador/objeto del host al que está conectado este PIF | Sólo lectura |
host-name-label |
El nombre del host al que está conectado este PIF | Sólo lectura |
IP-configuration-mode |
Tipo de configuración de dirección de red utilizada; DHCP o estática | Sólo lectura |
IP |
Dirección IP del PIF. Definido aquí cuando el modo de configuración IP es estático; indefinido cuando DHCP | Sólo lectura |
netmask |
Máscara de red del PIF. Definido aquí cuando el modo de configuración de IP es estático; indefinido cuando lo proporciona DHCP | Sólo lectura |
gateway |
Dirección de puerta de enlace del PIF. Definido aquí cuando el modo de configuración de IP es estático; indefinido cuando lo proporciona DHCP | Sólo lectura |
DNS |
Dirección DNS del PIF. Definido aquí cuando el modo de configuración de IP es estático; indefinido cuando lo proporciona DHCP | Sólo lectura |
io_read_kbs |
Velocidad media de lectura en KB/s para el dispositivo | Sólo lectura |
io_write_kbs |
Velocidad media de escritura en KB/s para el dispositivo | Sólo lectura |
carrier |
Estado del vínculo para este dispositivo | Sólo lectura |
vendor-id |
El ID asignado al proveedor de la NIC | Sólo lectura |
vendor-name |
Nombre del proveedor de NIC | Sólo lectura |
device-id |
El ID asignado por el proveedor a este modelo de NIC | Sólo lectura |
device-name |
El nombre asignado por el proveedor a este modelo de NIC | Sólo lectura |
speed |
Velocidad de transferencia de datos de la NIC | Sólo lectura |
duplex |
Modo dúplex de la NIC; completo o medio | Sólo lectura |
pci-bus-path |
Dirección de ruta de bus PCI | Sólo lectura |
other-config:ethtoolspeed |
Establece la velocidad de conexión en Mbps | Lectura/Escritura |
other-config:ethtoolautoneg |
Establezca en no para deshabilitar la negociación automática de la interfaz física o el puente. El valor predeterminado es sí. | Lectura/Escritura |
other-config:ethtoolduplex |
Establece la capacidad de duplexación del PIF, ya sea completa o a la mitad. | Lectura/Escritura |
other-config:ethtool-rx |
Establezca en activado para habilitar la suma de comprobación de recepción, desactivado para deshabilitar | Lectura/Escritura |
other-config:ethtool-tx |
Establezca en activado para habilitar la suma de comprobación de transmisión, desactivado para deshabilitar | Lectura/Escritura |
other-config:ethtool-sg |
Establezca en activado para habilitar la recopilación de dispersión, desactivado para deshabilitar | Lectura/Escritura |
other-config:ethtool-tso |
Establezca en activado para habilitar descarga de segmentación tcp, desactivado para deshabilitar | Lectura/Escritura |
other-config:ethtool-ufo |
Establezca en activado para habilitar la descarga de fragmentos udp, desactivado para deshabilitar | Lectura/Escritura |
other-config:ethtool-gso |
Establezca en activado para habilitar la descarga de segmentación genérica, desactivada para deshabilitar | Lectura/Escritura |
other-config:domain |
Lista separada por comas utilizada para establecer la ruta de búsqueda DNS | Lectura/Escritura |
other-config:bondmiimon |
Intervalo entre las comprobaciones de vida de enlace, en milisegundos | Lectura/Escritura |
other-config:bonddowndelay |
Número de milisegundos a esperar después de que el enlace se pierde antes de considerar realmente que el enlace se ha ido. Este parámetro permite la pérdida de enlaces transitorios | Lectura/Escritura |
other-config:bondupdelay |
Número de milisegundos que esperar después de que aparezca el enlace antes de considerarlo realmente. Permite que los enlaces se aleten hacia arriba. El valor predeterminado es31s permitir que los conmutadores comiencen a reenviar el tráfico. |
Lectura/Escritura |
disallow-unplug |
True si este PIF es una NIC de almacenamiento dedicada, falso en caso contrario | Lectura/Escritura |
Nota:
Los cambios realizados en los
other-config
campos de un PIF solo surtirán efecto después de un reinicio. Alternativamente, utilice losxe pif-unplug
comandosxe pif-plug
y para hacer que se reescriba la configuración de PIF.
pif-forget
pif-forget uuid = uuid_of_pif
Destruye el objeto PIF especificado en un host concreto.
pif-introduce
pif-introduce host-uuid = host_uuid mac = mac_address_for_pif device = interface_name
Cree un objeto PIF que represente una interfaz física en el host especificado.
pif-plug
pif-plug uuid = uuid_of_pif
Intente que se presente la interfaz física especificada.
pif-reconfigure-ip
pif-reconfigure-ip uuid = uuid_of_pif [mode = dhcp | mode = static] gateway = network_gateway_address IP = static_ip_for_this_pif netmask = máscara de red_for_this_pif [DNS = dirección_DNS]
Modifique la dirección IP del PIF. Para la configuración IP estática, establezca el mode parámetro enstatic
, congatewayIP```` , ynetmask`` se establecen en los valores apropiados. Para utilizar DHCP, establezca elmode
parámetro enDHCP
y deje los parámetros estáticos indefinidos.
Nota:
El uso de direcciones IP estáticas en interfaces de red físicas conectadas a un puerto en un conmutador mediante el protocolo de árbol de expansión con STP Fast Link desactivado (o no admitido) da como resultado un período durante el cual no hay tráfico.
pif-reconfigure-ipv6
pif-reconfigure-ipv6 uuid = uuid_of_pif mode = mode [gateway = network_gateway_address] [IPv6 = static_ip_for_this_pif] [DNS = dirección_DNS]
Vuelva a configurar la configuración de la dirección IPv6 en un PIF.
pif-scan
pif-scan host-uuid = host_uuid
Analice nuevas interfaces físicas en su host.
pif-set-primary-address-type
pif-set-primary-address-type uuid = uuid primary_address_type = address_type
Cambie el tipo de dirección principal utilizado por este PIF.
pif-unplug
pif-unplug uuid = uuid_of_pif
Intentar derribar la interfaz física especificada.
Comandos de grupo
Comandos para trabajar con grupos. Un grupo es un agregado de uno o más hosts. Un pool utiliza uno o más repositorios de almacenamiento compartido para que las máquinas virtuales que se ejecutan en un host del pool puedan migrarse casi en tiempo real a otro host del pool. Esta migración ocurre mientras la máquina virtual todavía está en ejecución, sin necesidad de apagarla y volver a encenderse. Cada host es realmente un grupo que consta de un solo miembro por defecto. Cuando el host se une a un grupo, se designa como miembro y el grupo al que se ha unido se convierte en el principal del grupo.
El objeto de grupo singleton se puede enumerar con el comando estándar de lista de objetos (xe pool-list
). Sus parámetros se pueden manipular con los comandos de parámetros estándar. Para obtener más información, consulte [Comandos#low-level-parameter-commands()de parámetros de nivel bajo]
Parámetros de la agrupación
Los grupos tienen los siguientes parámetros:
Nombre del parámetro | Descripción | Tipo |
---|---|---|
uuid |
La referencia única de identificador/objeto para el grupo | Sólo lectura |
name-label |
El nombre del grupo | Lectura/Escritura |
name-description |
La cadena descriptiva del grupo | Lectura/Escritura |
master |
La referencia única de identificador/objeto del host designado como maestro del grupo | Sólo lectura |
default-SR |
La referencia única de identificador/objeto del SR predeterminado para el grupo | Lectura/Escritura |
crash-dump-SR |
La referencia única de identificador/objeto de la SR donde se guardan los volcados de bloqueo para los miembros del grupo | Lectura/Escritura |
metadata-vdis |
Todos los VDIS de metadatos conocidos para el grupo | Sólo lectura |
suspend-image-SR |
Referencia única de identificador/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 y escritura |
supported-sr-types |
Tipos SR que este grupo puede usar | Sólo lectura |
ha-enabled |
True si HA está habilitado para el grupo, false en caso contrario | Sólo lectura |
ha-configuration |
Reservado para uso futuro. | Sólo lectura |
ha-statefiles |
Enumera los UUID de los VDI que utiliza HA para determinar el estado del almacenamiento de información | Sólo lectura |
ha-host-failures-to-tolerate |
Número de errores de host que se deben tolerar antes de enviar una alerta del sistema | Lectura/Escritura |
ha-plan-exists-for |
El número de fallos de hosts que realmente se pueden manejar, de acuerdo con los cálculos del algoritmo de HA | Sólo lectura |
ha-allow-overcommit |
True si se permite que el grupo se haya cometido en exceso, False en caso contrario | Lectura/Escritura |
ha-overcommitted |
True si el grupo está sobrecomprometido | Sólo lectura |
blobs |
Almacén de datos binario | Sólo lectura |
live-patching-disabled |
Establezca en False para habilitar la aplicación de revisiones activas. Establezca el valor True para deshabilitar la aplicación de parches en vivo. | Lectura/Escritura |
igmp-snooping-enabled |
Establezca el valor True para habilitar la indagación IGMP. Establezca en False para deshabilitar la indagación IGMP. | Lectura/Escritura |
pool-apply-edition
pool-apply-edition edition = edition [uuid = uuid] [license-server-address = address] [license-server-port = port]
Aplique una edición en todo el grupo.
pool-certificate-install
pool-certificate-install filename = nombre_archivo
Instale un certificado SSL, en toda la agrupación.
pool-certificate-list
lista de certificados de pool-
Enumere todos los certificados SSL instalados.
pool-certificate-sync
sincronización de certificado de grupo
Sincronizar certificados SSL y listas de revocación de certificados de maestro a esclavos.
pool-certificate-uninstall
pool-certificate-uninstall name = name
Desinstale un certificado SSL.
pool-crl-install
pool-crl-install filename = nombre_archivo
Instale una lista de revocación de certificados SSL, en todo el grupo.
pool-crl-list
pool-crl-list
Enumere todas las listas de revocación de certificados SSL instaladas.
pool-crl-uninstall
pool-crl-uninstall name = name
Desinstale una lista de revocación de certificados SSL.
pool-deconfigure-wlb
pool-desconfigure-wlb
Elimine permanentemente la configuración para el equilibrio de carga de trabajo.
pool-designate-new-master
pool-designate-nuevo-maestro host-uuid = uuid_of_new_master
Indique al host miembro especificado que se convierta en el maestro de un grupo existente. Este comando realiza una entrega ordenada de la función de host maestro a otro host del fondo de recursos. Este comando sólo funciona cuando el maestro actual está en línea. No es un reemplazo para los comandos de modo de emergencia que se enumeran a continuación.
pool-disable-external-auth
pool-disable-external-auth [uuid = uuid] [config = config]
Deshabilita la autenticación externa en todos los hosts de un grupo.
pool-disable-local-storage-caching
pool-disable-local-almacenamiento en caché uuid = uuid
Deshabilite el almacenamiento en caché de almacenamiento local en todo el grupo.
pool-disable-redo-log
pool-disable-redo-log
Deshabilite el redo log si está en uso, a menos que HA esté habilitado.
pool-disable-ssl-legacy
pool-disable-ssl-legacy [uuid = uuid]
Establezca ssl-legacy en False en cada host.
pool-dump-database
pool-dump-database file-name = filename_to_dump_database_into_( on_client)
Descargue una copia de toda la base de datos del grupo y volquete en un archivo en el cliente.
pool-enable-external-auth
pool-enable-external-auth auth-type = auth_type service-name = service_name [uuid = uuid] [config: = config]
Habilita la autenticación externa en todos los hosts de un grupo. Tenga en cuenta que algunos valores de auth-type requerirán una configuración particular: values.
pool-enable-local-storage-caching
pool-enable-local-storage-caching uuid = uuid
Habilite el almacenamiento en caché local en todo el grupo.
pool-enable-redo-log
pool-ensable-redo-log sr-uuid = sr_uuid
Habilite el redo log en el SR dado si está en uso, a menos que HA esté habilitado.
pool-enable-ssl-legacy
pool-enable-ssl-legacy [uuid = uuid]
Establezca ssl-legacy en True en cada host. ”
pool-eject
pool-eject host-uuid = uuid_of_host_to_eject
Indique al host especificado que abandone un grupo existente.
pool-emergency-reset-master
pool-emergency-reset-master master-address = address_of_pool_master
Indíquele a un host miembro esclavo que restablezca su dirección maestra al nuevo valor e intente conectarse a él. No ejecute este comando en hosts maestros.
pool-emergency-transition-to-master
pool-emergencia-transition-to master
Indique a un host miembro que se convierta en el maestro de grupo. El host acepta este comando sólo después de que el host haya transitado al modo de emergencia. El modo de emergencia significa que es un miembro de un grupo cuyo maestro ha desaparecido de la red y no puede ser contactado después de algunos 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
pool-ha-enable heartbeat-sr-uuids = uuid_of_heartbeat_sr
Habilite la alta disponibilidad en el fondo de recursos, utilizando el UUID SR especificado como repositorio central de latidos de almacenamiento.
pool-ha-disable
desactivación de pool-ha-
Deshabilita la característica de alta disponibilidad en el fondo de recursos.
pool-ha-compute-hypothetical-max-host-failures-to-tolerate
Calcule el número máximo de errores de host que se deben tolerar en la configuración de grupo actual.
pool-ha-compute-max-host-failures-to-tolerate
pool-ha-compute-hypothetical-max-host-failures-to-tolerar-[ vm-uuid = vm_uuid] [restart-priority = restart_priority]
Calcule el número máximo de errores de host que se deben tolerar con las máquinas virtuales protegidas propuestas y suministradas.
pool-initialize-wlb
pool-initialize-wlb wlb_url = url wlb_username = wlb_username wlb_password = wlb_password xenserver_username = nombre de usuario xenserver_password = contraseña
Inicialice el equilibrio de carga de trabajo para el grupo actual con el servidor WLB de destino.
pool-join
pool-join master-address = dirección master-username = nombre de usuario master-password = contraseña
Indique a su anfitrión que se una a una agrupación existente.
pool-management-reconfigure
pool-management-reconfigure [network-uuid = network-uuid]
Vuelve a configurar la interfaz de administración de todos los hosts del grupo para utilizar la interfaz de red especificada, que es la interfaz que se utiliza para conectarse al . El comando reescribe la clave MANAGEMENT_INTERFACE/etc/xensource-inventory
para todos los hosts del grupo.
Si se especifica el nombre de dispositivo de una interfaz (que debe tener una dirección IP), el host maestro se vuelve a enlaza inmediatamente. Este comando funciona tanto en modo normal como en modo de emergencia.
Desde el UUID de red especificado, el UUID del objeto PIF se identifica y se asigna al host, lo que determina qué dirección IP se va a enlazar a sí mismo. No debe estar en modo de emergencia cuando se ejecuta este comando.
Advertencia:
Tenga cuidado al usar este comando CLI fuera del host y asegúrese de tener conectividad de red en la nueva interfaz. Utilícelo
xe pif-reconfigure
para configurar uno primero. De lo contrario, los comandos de CLI posteriores no llegan al host.
pool-recover-slaves
pool-recuperación-esclavos
Indique al maestro de grupo que intente restablecer la dirección maestra de todos los miembros que se ejecutan actualmente en modo de emergencia. Este comando se utiliza normalmente después de que sepool-emergency-transition-to-master
haya utilizado para establecer uno de los miembros como el nuevo patrón.
pool-restore-database
pool-restore-database file-name = filename\_to\_restore\_from\_on\_client \[dry-run = true | false]
Cargue una copia de seguridad de base de datos (creada conpool-dump-database
) a un grupo. Al recibir la carga, el maestro se reinicia con la nueva base de datos.
También hay una opción de ejecución en seco , que le permite comprobar que la base de datos del grupo se puede restaurar sin realizar realmente la operación. De forma predeterminada,dry-run
se establece en false.
pool-retrieve-wlb-configuration
pool-retrieve-wlb-configuración
Recupera los criterios de optimización del grupo desde el servidor de Equilibrio de carga de trabajo.
pool-retrieve-wlb-diagnostics
pool-retrieve-wlb-diagnostics [nombre_archivo = nombre_archivo]
Recupera diagnósticos del servidor de Equilibrio de carga de trabajo.
pool-retrieve-wlb-recommendations
pool-retrieve-wlb-recommendations
Recupera recomendaciones de migración de VM para el grupo desde el servidor de Equilibrio de carga de trabajo.
pool-retrieve-wlb-report
pool-retrieve-wlb-report report = report [filename = file_name]
Recupera informes del servidor de Equilibrio de carga de trabajo.
pool-send-test-post
pool-send-test-post host-host = destination_host dest-port = destination_port body = post_body
Envíe el cuerpo dado al host y puerto dados, usando HTTPS, e imprima la respuesta. Esto se utiliza para depurar la capa SSL.
pool-send-wlb-configuration
pool-send-wlb-configuration [config: = config]
Establece los criterios de optimización del grupo para el servidor de Equilibrio de carga de trabajo.
pool-sync-database
base de datos de pool-sync-
Forzar a base de dados do pool para ser sincronizada em todos os hosts no pool de recursos. Este comando no es necesario en el funcionamiento normal ya que la base de datos se replica regularmente automáticamente. Howe3ver, el comando puede ser útil para garantizar que los cambios se replicen rápidamente después de realizar un conjunto significativo de operaciones de CLI.
Conjunto de agrupaciónigmp-snooping
pool-param-set \[uuid = pool-uuid] \[igmp-snooping-enabled = true | false]
Habilita o deshabilita la indagación IGMP en un grupo.
Comandos del Acelerador PVS
Comandos para trabajar con el Acelerador PVS.
pvs-cache-storage-create
pvs-cache-storage-create sr-uuid = sr_uuid pvs-site-uuid = pvs_site_uuid size = size
Configure una caché de PVS en un SR determinado para un host determinado.
pvs-cache-storage-destroy
pvs-cache-almacenamiento-destroy uuid = uuid
Retire una caché de PVS.
pvs-proxy-create
pvs-proxy-create pvs-site-uuid = pvs_site_uuid vif-uuid = vif_uuid
Configure un VM/VIF para utilizar un proxy PVS.
pvs-proxy-destroy
pvs-proxy-destroy uuid = uuid
Retire (o apague) un proxy PVS para este VIF/VM.
pvs-server-forget
pvs-server-forget uuid = uuid
Olvida un servidor PVS.
pvs-server-introduce
pvs-server-introduce direcciones = direcciones first-port = first_port last-port = last_port pvs-site-uuid = pvs_site_uuid
Introducir un nuevo servidor PVS.
pvs-site-forget
pvs-site-forget uuid = uuid
Olvida un sitio de PVS.
pvs-site-introduce
pvs-site-introduce name-label = name_label [name-description = name_description] [pvs-uuid = pvs_uuid]
Introducir el nuevo sitio PVS.
Comandos de Storage Manager
Comandos para controlar los complementos de Storage Manager.
Los objetos del administrador de almacenamiento se pueden enumerar con el comando estándar de lista de objetos (xe sm-list
). Los parámetros se pueden manipular con los comandos de parámetros estándar. Para obtener más información, consulte [Comandos#low-level-parameter-commands()de parámetros de nivel bajo]
Parámetros SM
Los SMS tienen los siguientes parámetros:
Nombre del parámetro | Descripción | Tipo |
---|---|---|
uuid |
La referencia única de identificador/objeto para el complemento SM | Sólo lectura |
name-label |
El nombre del complemento SM | Sólo lectura |
name-description |
La cadena descriptiva del complemento SM | Sólo lectura |
type |
El tipo SR al que se conecta este complemento | Sólo lectura |
vendor |
Nombre del proveedor que creó este complemento | Sólo lectura |
copyright |
Declaración de derechos de autor para este plugin SM | Sólo lectura |
required-api-version |
Versión mínima de SM API requerida en el host | Sólo lectura |
configuration |
Nombres y descripciones de las claves de configuración de dispositivos | Sólo lectura |
capabilities |
Capacidades del complemento SM | Sólo lectura |
driver-filename |
El nombre de archivo del controlador SR. | Sólo lectura |
Comandos de instantánea
Comandos para trabajar con instantáneas.
snapshot-clone
snapshot-clone new-name-label = name_label [uuid = uuid] [new-name-description = description]
Cree una nueva plantilla clonando una instantánea existente, utilizando la operación rápida de clon de disco a nivel de almacenamiento cuando esté disponible.
snapshot-copy
snapshot-copy new-name-label = name_label [uuid = uuid] [new-name-description = name_description] [sr-uuid = sr_uuid]
Cree una nueva plantilla copiando una máquina virtual existente, pero sin utilizar la operación de clon de disco rápido a nivel de almacenamiento (incluso si está disponible). Las imágenes de disco de la máquina virtual copiada están garantizadas para ser ‘imágenes completas’, es decir, no parte de una cadena CoW.
snapshot-destroy
snapshot-destroy [uuid = uuid] [snapshot-uuid = snapshot_uuid]
Destruye una instantánea. Esto deja intacto el almacenamiento asociado a la instantánea. Para eliminar el almacenamiento también, use snapshot-uninstall.
snapshot-disk-list
snapshot-disk-list [uuid = uuid] [snapshot-uuid = snapshot_uuid] [vbd-params = vbd_params] [vdi-params = vdi_params]
Enumere los discos de las máquinas virtuales seleccionadas.
snapshot-export-to-template
snapshot-export-to-template filename = file\_name snapshot-uuid = snapshot\_uuid \[preserve-power-state = true | false]
Exportar una instantánea a nombre de archivo.
snapshot-reset-powerstate
snapshot-reset-powerstate [uuid = uuid] [snapshot-uuid = snapshot_uuid] [— force]
Forzar que el estado de alimentación de la máquina virtual se detenga sólo en la base de datos de la pila de herramientas de administración. Este comando se utiliza para recuperar una instantánea marcada como ‘suspendida’. Esta es una operación potencialmente peligrosa: debe asegurarse de que ya no necesita la imagen de memoria (es decir, ya no podrá reanudar su instantánea).
snapshot-revert
snapshot-revert [uuid = uuid] [snapshot-uuid = snapshot_uuid]
Revertir una máquina virtual existente a un estado anterior de puntiagudo o Snapshoted.
snapshot-uninstall
snapshot-uninstall [uuid = uuid] [snapshot-uuid = snapshot_uuid] [— force]
Desinstale una instantánea. Esta operación destruirá los VDI marcados como RW y conectados únicamente a esta instantánea. Para simplemente destruir el registro de VM, use snapshot-destroy.
Comandos SR
Comandos para controlar SRs (repositorios de almacenamiento).
Los objetos SR se pueden enumerar con el comando estándar de lista de objetos (xe sr-list
) y los parámetros se pueden manipular con los comandos de parámetros estándar. Para obtener más información, consulte [Comandos#low-level-parameter-commands()de parámetros de nivel bajo]
Parámetros SR
Los SRs tienen los siguientes parámetros:
Nombre del parámetro | Descripción | Tipo |
---|---|---|
uuid |
La referencia única de identificador/objeto para el SR | Sólo lectura |
name-label |
El nombre de la SR | Lectura/Escritura |
name-description |
La cadena descriptiva del SR | Lectura/Escritura |
allowed-operations |
Lista de las operaciones permitidas en el SR en este estado | Parámetro de conjunto de sólo lectura |
current-operations |
Lista de las operaciones actualmente en curso en este SR | Parámetro de conjunto de sólo lectura |
VDIs |
Identifiador/referencia de objeto único para los discos virtuales en este SR | Parámetro de conjunto de sólo lectura |
PBDs |
Identifiador/referencia de objeto único para los PBD adjuntos a este SR | Parámetro de conjunto de sólo lectura |
physical-utilisation |
Espacio físico utilizado actualmente en este SR, en bytes. Para los formatos de disco con aprovisionamiento ligero, la utilización física puede ser inferior a la asignación virtual | Sólo lectura |
physical-size |
Tamaño físico total del SR, en bytes | Sólo lectura |
type |
Tipo de SR, utilizado para especificar el controlador de back-end SR que se va a utilizar | Sólo lectura |
introduced-by |
El drtask (en su caso) que introdujo el SR | Sólo lectura |
content-type |
Tipo de contenido del SR. Se utiliza para distinguir bibliotecas ISO de otros SRs. Para los repositorios de almacenamiento que almacenan una biblioteca de ISO, el tipo de contenido debe establecerse en iso. En otros casos, recomienda que establezca este parámetro en vacío o el usuario de cadena. | Sólo lectura |
shared |
True si este SR se puede compartir entre varios hosts; False en caso contrario | Lectura/Escritura |
other-config |
Lista de pares clave/valor que especifican parámetros de configuración adicionales para el SR | Parámetro de mapa de lectura y escritura |
host |
Nombre de host del repositorio de almacenamiento | Sólo lectura |
virtual-allocation |
Suma de los valores de tamaño virtual de todos los VDI en este repositorio de almacenamiento (en bytes) | Sólo lectura |
sm-config |
Datos dependientes de SM | Parámetro de mapa de sólo lectura |
blobs |
Almacén de datos binario | Sólo lectura |
sr-create
sr-create name-label = name physical-size = size type = type content-type = content\_type device-config: config\_name = value \[host-uuid = host\_uuid] \[shared = true | false]
Crea un SR en el disco, lo introduce en la base de datos y crea un PBD adjuntando el SR al host. Sishared
se establece entrue
, se crea un PBD para cada host del grupo. Si noshared
se especifica o se establece enfalse
, sólo se crea un PBD para el host especificado conhost-uuid
.
Losdevice-config
parámetros exactos difieren según el dispositivotype
. Para obtener detalles sobre estos parámetros en los diferentes back-end de almacenamiento, consulte Almacenamiento.
sr-data-source-forget
sr-data-source-forget data-source = data_source
Detenga la grabación del origen de datos especificado para un SR y olvide todos los datos registrados.
sr-data-source-list
sr-data-source-list "
Enumere los orígenes de datos que se pueden registrar para un SR.
sr-data-source-query
sr-data-source-query data-source = data_source
Consulte el último valor leído de un origen de datos SR.
sr-data-source-record
sr-data-source-record data-source = data_source
Registre el origen de datos especificado para un SR.
sr-destroy
sr-destroy uuid = sr_uuid
Destruye el SR especificado en el host.
sr-enable-database-replication
sr-enable-database-replication uuid = sr_uuid
Habilita la replicación de bases de datos XAPI en el SR (compartido) especificado. Por ejemplo:
xe sr-enable-database-replication uuid = sr-uuid
sr-disable-database-replication
sr-disable-database-replication uuid = sr_uuid
Deshabilita la replicación de base de datos XAPI en el SR especificado. Por ejemplo:
xe sr-enable-database-replication uuid = sr-uuid
sr-forget
sr-forget uuid = sr_uuid
El agente XAPI olvida un SR especificado en el host. Cuando el agente XAPI olvida un SR, el SR se separa y no se puede acceder a VDIS en él, pero permanece intacto en el medio de origen (los datos no se pierden).
sr-introduce
sr-introduce name-label = name physical-size = physical_size type = type content-type = content_type uuid = sr_uuid
Simplemente coloca un registro SR en la base de datos. Utilícelodevice-config
para especificar parámetros adicionales en formadevice-config:parameter_key=parameter_value
de ejemplo:
xe sr-introduce device-config: device = / dev/sdb1
Nota:
Este comando nunca se utiliza en el funcionamiento normal. Esta operación avanzada puede ser útil cuando se debe reconfigurar un SR como compartido después de que se creó o para ayudar a recuperarse de varios escenarios de falla.
sr-probe
sr-probe type = type [host-uuid = host_uuid] [device-config: config_name = valor]
Realiza un análisis específico de back-end, utilizando lasdevice-config
claves proporcionadas. Si eldevice-config
está completo para el back-end SR, este comando devuelve una lista de los SRs presentes en el dispositivo, si los hay. Si losdevice-config
parámetros son sólo parciales, se realiza un análisis específico de back-end, que devuelve resultados que le guían para mejorar losdevice-config
parámetros restantes. Los resultados del análisis se devuelven como XML específico del servidor, impreso en la CLI.
Losdevice-config
parámetros exactos difieren según el dispositivotype
. Para obtener detalles sobre estos parámetros en los diferentes back-end de almacenamiento, consulte Almacenamiento.
sr-probe-ext
sr-probe-ext type = type [host-uuid = host_uuid] [device-config: = config] [sm-config: -sm_config]
Realice una sonda 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 por humanos para cada tipo SR.
sr-scan
sr-scan uuid = sr_uuid
Forzar un escaneo SR, sincronizando la base de datos XAPI con VDI presentes en el sustrato de almacenamiento subyacente.
sr-update
sr-update uuid = uuid
Actualice los campos del objeto SR en la base de datos.
lvhd-enable-thin-provisioning
lvhd-enable-thin-provisioning sr-uuid = sr_uuid initial-allocation = initial_allocation asignación_quantum = allocation_quantum
Habilite el aprovisionamiento delgado en un LVHD SR.
Comandos de asunto
Comandos para trabajar con sujetos.
session-subject-identifier-list
lista de identificación de tema de sesión
Devuelve una lista de todos los identificadores de asunto de usuario de todas las sesiones existentes autenticadas externamente.
session-subject-identifier-logout
session-subject-identifier-cierre de sesión subject-identifier = subject_identifier
Cierre la sesión de todas las sesiones autenticadas externamente asociadas a un identificador de asunto de usuario.
session-subject-identifier-logout-all
sesion-subject-identifier-logout-all
Cierre la sesión todas las sesiones autenticadas externamente.
subject-add
subject -add subject -name = subject_name
Agregue un asunto a la lista de temas que pueden acceder al grupo.
subject-remove
sujeto-eliminar sujeto-uuid = subject_uuid
Elimine un asunto de la lista de temas que pueden acceder al grupo.
subject-role-add
sujeto-role-add uuid = uuid [nombre-de-función = nombre-de-función] [role-uuid = rol_uuid]
Agregar un rol a un asunto.
subject-role-remove
sujeto-role-remove uuid = uuid [role-name = role_name] [role-uuid = role_uuid]
Eliminar un rol de un asunto.
secret-create
secret-create value = value
Crea un secreto.
secret-destroy
secret-destroy uuid = uuid
Destruye un secreto.
Comandos de tareas
Comandos para trabajar con tareas asíncronas de ejecución prolongada. Estos comandos son tareas como iniciar, detener y suspender una máquina virtual. Las tareas se componen normalmente de un conjunto de otras subtareas atómicas que juntos realizan la operación solicitada.
Los objetos de tarea se pueden enumerar con el comando estándar de lista de objetos (xe task-list
) y los parámetros se pueden manipular con los comandos de parámetros estándar. Para obtener más información, consulte [Comandos#low-level-parameter-commands()de parámetros de nivel bajo]
Parámetros de tarea
Las tareas tienen los siguientes parámetros:
Nombre del parámetro | Descripción | Tipo |
---|---|---|
uuid |
La referencia única de identificador/objeto para la tarea | Sólo lectura |
name-label |
El nombre de la tarea | Sólo lectura |
name-description |
La cadena descriptiva de la tarea | Sólo lectura |
resident-on |
Referencia de objeto o identificador único del host en el que se ejecuta la tarea | Sólo lectura |
status |
Estado de la tarea | Sólo lectura |
progress |
Si la tarea sigue pendiente, este campo contiene el porcentaje estimado completado, de 0 a 1. Si la tarea se ha completado, correctamente o sin éxito, el valor es 1. | Sólo lectura |
type |
Si la tarea se ha completado correctamente, este parámetro contiene el tipo del resultado codificado. El tipo es el nombre de la clase cuya referencia está en el campo de resultado. De lo contrario, el valor de este parámetro no está definido | Sólo lectura |
result |
Si la tarea se ha completado correctamente, este campo contiene el valor de resultado, ya sea Vacío o una referencia de objeto; de lo contrario, el valor de este parámetro no está definido | Sólo lectura |
error_info |
Si la tarea ha fallado, este parámetro contiene el conjunto de cadenas de error asociadas. De lo contrario, el valor de este parámetro no está definido | Sólo lectura |
allowed_operations |
Lista de las operaciones permitidas en este estado | Sólo lectura |
created |
Hora de creación de la tarea | Sólo lectura |
finished |
La tarea de tiempo ha finalizado (es decir, se ha realizado correctamente o ha fallado). Si task-status está pendiente, entonces el valor de este campo no tiene significado | Sólo lectura |
subtask_of |
Contiene el UUID de las tareas que esta tarea es una subtarea de | Sólo lectura |
subtasks |
Contiene los UUID de todas las subtareas de esta tarea | Sólo lectura |
task-cancel
tareas-cancel [uuid = task_uuid]
Dirige la tarea especificada para cancelar y devolver.
Comandos de plantilla
Comandos para trabajar con plantillas de VM.
Las plantillas son esencialmente máquinas virtuales con elis-a-template
parámetro establecido entrue
. Una plantilla es una “imagen dorada” que contiene todos los ajustes de configuración para crear una instancia de una máquina virtual específica. incluye un conjunto base de plantillas, que son máquinas virtuales genéricas “sin procesar” que pueden arrancar un CD de instalación del proveedor del sistema operativo (por ejemplo: RHEL, CentOS, SLES, Windows). Puede crear máquinas virtuales, configurarlas en formularios estándar para sus necesidades particulares y guardar una copia de ellas como plantillas para su uso futuro en la implementación de máquinas virtuales.
Los objetos de plantilla se pueden enumerar con el comando estándar de lista de objetos (xe template-list
) y los parámetros se pueden manipular con los comandos de parámetros estándar. Para obtener más información, consulte [Comandos#low-level-parameter-commands()de parámetros de nivel bajo]
Nota:
Las plantillas no se pueden convertir directamente en VM estableciendo el
is-a-template
parámetro enfalse
. Nois-a-template
se admite la configuración delfalse
parámetro como y da como resultado una máquina virtual que no se puede iniciar.
Parámetros de plantilla de VM
Las plantillas tienen los siguientes parámetros:
-
uuid
( sólo lectura) la referencia única de identificador/objeto para la plantilla -
name-label
( lectura/escritura) el nombre de la plantilla -
name-description
( lectura/escritura) la cadena descriptiva de la plantilla -
user-version
( lectura/escritura) cadena para los creadores de máquinas virtuales y plantillas para poner información de versión -
is-a-template
( lectura/escritura) true si esta máquina virtual es una plantilla.Las máquinas virtuales de plantilla nunca se pueden iniciar, solo se utilizan para clonar otras máquinas virtuales. Después de que este valor se haya establecido en true, no se puede restablecer a false. Las máquinas virtuales de plantilla no se pueden convertir en máquinas virtuales mediante este parámetro. -
is-control-domain
( sólo lectura) true si se trata de un dominio de control (dominio 0 o dominio de controlador) -
power-state
( sólo lectura) estado de energía actual. El valor siempre se detiene para una plantilla -
memory-dynamic-max
( sólo lectura) memoria máxima dinámica en bytes.Actualmente no se utiliza, pero si se cambia se debe obedecer la siguiente restricción:memory_static_max>=memory_dynamic_max>=<!--NeedCopy-->
````-memory_dynamic_min>=memory_static_min<!--NeedCopy-->
` Sí.` -
memory-dynamic-min
( lectura/escritura) memoria mínima dinámica en bytes. Actualmente no se utiliza, pero si se cambian las mismas restricciones paramemory-dynamic-max
deben ser obedecidas. -
memory-static-max
( lectura/escritura) de memoria máxima establecida estáticamente (absoluta) en bytes. Este campo es el valor principal utilizado para determinar la cantidad de memoria asignada a una máquina virtual. -
memory-static-min
( lectura/escritura) de memoria mínima establecida estáticamente (absoluta) en bytes. Este campo representa la memoria mínima absoluta ymemory-static-min
debe ser menor quememory-static-max
. Este valor no se utiliza en el funcionamiento normal, pero se debe obedecer la restricción anterior. -
suspend-VDI-uuid
( sólo lectura) el VDI en el que se almacena una imagen de suspensión (no tiene significado para una plantilla) -
VCPUs-params
( parámetro de mapa de lectura/escritura) para la directiva de vCPU seleccionada.Puede ajustar la fijación de una vCPU con:
xe template-param-set uuid = < template_uuid > VCPUS-params: máscara = 1,2,3
Una máquina virtual creada a partir de esta plantilla se ejecuta sólo en CPU físicas 1, 2 y 3.
También puede ajustar la prioridad de vCPU (programación xen) con los parámetros de límite y peso. Por ejemplo:
xe template-param-set uuid = < template_uuid > VCPUS-params: peso = 512 xe template-param-set uuid = < template_uuid > VCPUS-params: cap = 100
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 contendido. Los pesos legales oscilan entre 1 y 65535 y el valor predeterminado es 256.
El límite corrige opcionalmente la cantidad máxima de CPU que una máquina virtual basada en esta plantilla puede consumir, incluso si el host 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 es 4 CPU, etc. El valor predeterminado, 0, significa que no hay límite superior.
-
VCPUs-max
( lectura/escritura) número máximo de vCPU -
VCPUs-at-startup
( lectura/escritura) número de arranque de vCPU -
actions-after-crash
( lectura/escritura) que se debe realizar cuando se bloquea una máquina virtual basada en esta plantilla -
console-uuids
( parámetro de configuración de sólo lectura) dispositivos de consola virtual -
platform
( parámetro de mapa de lectura/escritura) configuración específica de la plataformaPara deshabilitar la emulación de un puerto paralelo para invitados HVM (por ejemplo, invitados de Windows):
xe vm-param-set uuid = < vm_uuid > plataforma: paralelo = ninguno
Para deshabilitar la emulación de un puerto serie para invitados HVM:
xe vm-param-set uuid = < vm_uuid > plataforma: hvm_serial = none
Para deshabilitar la emulación de un controlador USB y un dispositivo de tableta USB para huéspedes HVM:
xe vm-param-set uuid = < vm_uuid > plataforma: usb = false xe vm-param-set uuid = < vm_uuid > plataforma: usb_tablet = false
Para usar qemu-upstream para USB Passthrough:
xe vm-param-set uuid = < vm_uuid > plataforma: device-model = qemu-upstream-compat
-
allowed-operations
( sólo lectura parámetro conjunto) lista de las operaciones permitidas en este estado -
current-operations
( parámetro de conjunto de sólo lectura) lista de las operaciones que están actualmente en curso en esta plantilla -
allowed-VBD-devices
( parámetro de conjunto de sólo lectura) lista de identificadores VBD disponibles para su uso, representados por enteros del rango 0 — 15. Esta lista es de carácter informativo y se pueden utilizar otros dispositivos (pero puede que no funcionen). -
allowed-VIF-devices
( parámetro de conjunto de sólo lectura) lista de identificadores VIF disponibles para su uso, representados por enteros del rango 0 — 15. Esta lista es de carácter informativo y se pueden utilizar otros dispositivos (pero puede que no funcionen). -
HVM-boot-policy
( lectura/escritura) la directiva de arranque para los invitados HVM. Orden del BIOS o una cadena vacía. -
HVM-boot-params
( parámetro de mapa de lectura/escritura) la clave de orden controla el orden de arranque invitado de HVM, representado como una cadena donde cada carácter es un método de arranque: d para el CD/DVD, c para el disco raíz y n para el arranque PXE de red. El valor predeterminado es dc. -
PV-kernel
( lectura/escritura) al núcleo -
PV-ramdisk
( lectura/escritura) ruta al initrd -
PV-args
( lectura/escritura) cadena de argumentos de línea de comandos del núcleo -
PV-legacy-args
( lectura/escritura) cadena de argumentos para hacer que las VM heredadas se basen en este arranque de plantilla -
PV-bootloader
( lectura/escritura) nombre o ruta al gestor de arranque -
PV-bootloader-args
( lectura/escritura) cadena de argumentos varios para el gestor de arranque -
last-boot-CPU-flags
( sólo lectura) describe los indicadores de CPU en los que se inició por última vez una máquina virtual basada en esta plantilla; no se rellenó para una plantilla -
resident-on
( sólo lectura) el host en el que reside una máquina virtual basada en esta plantilla. Aparece comonot in database
para una plantilla -
affinity
( lectura/escritura) el host en el que una máquina virtual basada en esta plantilla tiene preferencia para ejecutarse. Utilizado por elxe vm-start
comando para decidir dónde ejecutar la máquina virtual -
other-config
( parámetro de mapa de lectura/escritura) lista de pares clave/valor que especifican parámetros de configuración adicionales para la plantilla -
start-time
( sólo lectura) marca de tiempo de la fecha y hora en que se leyeron las métricas de una máquina virtual basada en esta plantilla, en el formularioyyyymmddThh:mm:ss z
, donde z es el indicador de zona horaria militar de una sola letra, por ejemplo, Z para UTC (GMT). Establecido en1 Jan 1970 Z
(comienzo de la época UNIX/POSIX) para una plantilla -
install-time
( sólo lectura) marca de tiempo de la fecha y hora en que se leyeron las métricas de una máquina virtual basada en esta plantilla, en el formularioyyyymmddThh:mm:ss z
, donde z es el indicador de zona horaria militar de una sola letra, por ejemplo, Z para UTC (GMT). Establecido en1 Jan 1970 Z
(comienzo de la época UNIX/POSIX) para una plantilla -
memory-actual
( sólo lectura) la memoria real que utiliza una máquina virtual basada en esta plantilla; 0 para una plantilla -
VCPUs-number
( sólo lectura) el número de CPU virtuales asignadas a una máquina virtual basada en esta plantilla; 0 para una plantilla -
VCPUs-Utilization
( parámetro de mapa de sólo lectura) lista de CPU virtuales y su peso sólo lectura parámetro de mapa os-versión versión del sistema operativo para una máquina virtual basada en esta plantilla. Aparece comonot in database
para una plantilla -
PV-drivers-version
( parámetro de mapa de sólo lectura) las versiones de los controladores paravirtualizados para una máquina virtual basada en esta plantilla. Aparece comonot in database
para una plantilla -
PV-drivers-detected
( sólo lectura) para la última versión de los controladores paravirtualizados para una máquina virtual basada en esta plantilla. Aparece comonot in database
para una plantilla -
memory
( parámetro de mapa de sólo lectura) métricas de memoria notificadas por el agente en una máquina virtual basada en esta plantilla. Aparece comonot in database
para una plantilla -
disks
( parámetro de mapa de sólo lectura) métricas de disco notificadas por el agente en una máquina virtual basada en esta plantilla. Aparece comonot in database
para una plantilla -
networks
( parámetro de mapa de sólo lectura) métricas de red notificadas por el agente en una máquina virtual basada en esta plantilla. Aparece comonot in database
para una plantilla -
other
( parámetro de mapa de sólo lectura) otras métricas notificadas por el agente en una máquina virtual basada en esta plantilla. Aparece comonot in database
para una plantilla -
guest-metrics-last-updated
( sólo lectura) marca de tiempo cuando el agente invitado realizó la última escritura en estos campos. En el formularioyyyymmddThh:mm:ss z
, donde z es el indicador de zona horaria militar de una sola letra, por ejemplo, Z para UTC (GMT) -
actions-after-shutdown
( lectura/escritura) que se debe realizar después de que la máquina virtual se haya apagado -
actions-after-reboot
( lectura/escritura) que se debe realizar después de reiniciar la máquina virtual -
possible-hosts
( sólo lectura) lista de hosts que podrían alojar potencialmente la máquina virtual -
HVM-shadow-multiplier
( lectura/escritura) aplicado a la cantidad de sombra que se pone a disposición del huésped -
dom-id
( sólo lectura) ID de dominio (si está disponible, -1 en caso contrario) -
recommendations
( sólo lectura) especificación XML de los valores y rangos recomendados para las propiedades de esta máquina virtual -
xenstore-data
( parámetro de mapa de lectura/escritura) que se insertarán en el árbol de xenstore (/ local/domain/domid /vmdata) después de crear la máquina virtual. -
is-a-snapshot
( sólo lectura) True si esta plantilla es una instantánea de VM -
snapshot_of
( sólo lectura) el UUID de la máquina virtual que esta plantilla es una instantánea de -
snapshots
( sólo lectura) los UUID de cualquier instantánea que se haya tomado de esta plantilla -
snapshot_time
( sólo lectura) la marca de tiempo de la instantánea de VM más reciente tomada -
memory-target
( sólo lectura) la cantidad de memoria de destino establecida para esta plantilla -
blocked-operations
( parámetro de mapa de lectura/escritura) enumera las operaciones que no se pueden realizar en esta plantilla -
last-boot-record
( sólo lectura) registro de los últimos parámetros de arranque para esta plantilla, en formato XML -
ha-always-run
( lectura/escritura) True si una instancia de esta plantilla se reinicia siempre en otro host si hay un error en el host en el que reside. Este parámetro está ahora en desuso. Utilice elha-restartpriority
parámetro en su lugar. -
ha-restart-priority
( solo lectura) reiniciar o almacenar datos binarios blobs de lectura/escritura con el mejor esfuerzo -
live
( solo lectura) relevante solo para una máquina virtual en ejecución.
template-export
template-export template-uuid = uuid_of_existing_template filename = filename_for_new_template
Exporta una copia de una plantilla especificada a un archivo con el nuevo nombre de archivo especificado.
template-uninstall
template-uninstall template-uuid = template_uuid [— force]
Desinstale una plantilla personalizada. Esta operación destruirá los VDI marcados como ‘propiedad’ por esta plantilla.
Actualizar comandos
La siguiente sección contiene comandos de actualización de host.
Los objetos de actualización se pueden enumerar con el comando estándar de lista de objetos (xe update-list
) y los parámetros se pueden manipular con los comandos de parámetros estándar. Para obtener más información, consulte [Comandos#low-level-parameter-commands()de parámetros de nivel bajo]
Actualizar parámetros
tienen los siguientes parámetros :
Nombre del parámetro | Descripción | Tipo |
---|---|---|
uuid |
La referencia única de identificador/objeto para la actualización | Sólo lectura |
host |
La lista de hosts a los que se aplica esta actualización a | Sólo lectura |
host-uuid |
El identificador único para el host a consultar | Sólo lectura |
name-label |
El nombre de la actualización | Sólo lectura |
name-description |
La cadena descriptiva de la actualización | Sólo lectura |
applied |
Si la actualización se ha aplicado o no; true o false | Sólo lectura |
installation-size |
El tamaño de la actualización en bytes | Sólo lectura |
after-apply-guidance |
Si la pila de herramientas XAPI o el host requieren un reinicio | Sólo lectura |
version |
La versión de la actualización | Sólo lectura |
update-upload
update-upload file-name = update_filename
Cargue un archivo de actualización especificado en el host. Este comando prepara una actualización para ser aplicada. En caso de éxito, se imprime el UUID de la actualización cargada. Si la actualización se ha cargado anteriormente, se devuelveUPDATE_ALREADY_EXISTS
un error en su lugar y el parche no se vuelve a cargar.
update-precheck
update-precheck uuid = update_uuid host-uuid = host_uuid
Ejecute las comprobaciones previas contenidas en la actualización especificada en el host especificado.
update-destroy
update-destroy uuid = update_file_uuid
Elimina un archivo de actualización que no se ha aplicado del grupo. Se puede utilizar para eliminar un archivo de actualización que no se puede aplicar a los hosts.
update-apply
update-apply host-uuid = host_uuid uuid = update_file_uuid
Aplique el archivo de actualización especificado.
update-pool-apply
update-pool-apply uuid = update_uuid
Aplique la actualización especificada a todos los hosts del grupo.
update-introduce
update-introduce vdi-uuid = vdi_uuid
Introducir la actualización de VDI.
update-pool-clean
update-pool-clean uuid = uuid
Elimina los archivos de la actualización de todos los hosts del grupo.
Comandos de usuario
user-password-change
user-password-change old = old_password new = new_password
Cambia la contraseña del usuario que ha iniciado sesión. El campo de contraseña anterior no está marcado porque se requiere el privilegio de supervisor para utilizar este comando.
Comandos VBD
Comandos para trabajar con VBD (Virtual Block Devices).
Un VBD es un objeto de software que conecta una máquina virtual al VDI, que representa el contenido del disco virtual. El VBD tiene los atributos que vinculan el VDI a la VM (es iniciable, sus métricas de lectura/escritura, etc.). El VDI tiene la información sobre los atributos físicos del disco virtual (qué tipo de SR, si el disco es compartible, si el medio es de lectura/escritura o de sólo lectura, etc.).
Los objetos VBD se pueden enumerar con el comando estándar de lista de objetos (xe vbd-list
) y los parámetros se pueden manipular con los comandos de parámetros estándar. Para obtener más información, consulte [Comandos#low-level-parameter-commands()de parámetros de nivel bajo]
Parámetros de VBD
Los VBD tienen los siguientes parámetros:
Nombre del parámetro | Descripción | Tipo |
---|---|---|
uuid |
La referencia única de identificador/objeto para el VBD | Sólo lectura |
vm-uuid |
La referencia única de identificador/objeto para la máquina virtual a la que se adjunta este VBD | Sólo lectura |
vm-name-label |
El nombre de la máquina virtual a la que se adjunta este VBD | Sólo lectura |
vdi-uuid |
La referencia única de identificador/objeto para el VDI a que se asigna este VBD | Sólo lectura |
vdi-name-label |
El nombre de la VDI a la que se asigna este VBD | Sólo lectura |
empty |
Sitrue , este VBD representa una unidad vacía |
Sólo lectura |
device |
El dispositivo visto por el invitado, por ejemplohda
|
Sólo lectura |
userdevice |
Número de dispositivo especificado por el parámetro de dispositivo durantevbd-create , por ejemplo, 0 para hda, 1 para hdb, etc. |
Lectura/Escritura |
bootable |
True si este VBD es de arranque | Lectura/Escritura |
mode |
El modo con el que el VBD debe montarse | Lectura/Escritura |
type |
Cómo aparece el VBD en la máquina virtual, por ejemplo, disco o CD | Lectura/Escritura |
currently-attached |
True si el VBD está conectado en este host, false en caso contrario | Sólo lectura |
storage-lock |
True si se adquirió un bloqueo de nivel de almacenamiento | Sólo lectura |
status-code |
Código de error/éxito asociado a la última operación de enlace | Sólo lectura |
status-detail |
Información de error/éxito asociado con el estado de la última operación de conexión | Sólo lectura |
qos_algorithm_type |
El algoritmo QoS a usar | Lectura/Escritura |
qos_algorithm_params |
Parámetros para el algoritmo QoS elegido | Parámetro de mapa de lectura y escritura |
qos_supported_algorithms |
Algoritmos QoS suportados para este VBD | Parámetro de conjunto de sólo lectura |
io_read_kbs |
Tasa media de lectura en kB por segundo para este VBD | Sólo lectura |
io_write_kbs |
Tasa media de escritura en kB por segundo para este VBD | Sólo lectura |
allowed-operations |
Lista de las operaciones permitidas en este estado. Esta lista es sólo de carácter consultivo y el estado del servidor puede haber cambiado en el momento en que un cliente lea este campo. | Parámetro de conjunto de sólo lectura |
current-operations |
Vincula cada una de las tareas en ejecución mediante este objeto (por referencia) a una enumeración current_operation que describe la naturaleza de la tarea. | Parámetro de conjunto de sólo lectura |
unpluggable |
True si este VBD admite la desconexión en marcha | Lectura/Escritura |
attachable |
True si el dispositivo se puede conectar | Sólo lectura |
other-config |
Configuración adicional | Parámetro de mapa de lectura y escritura |
vbd-create
vbd-create vm-uuid = uuid_of_the_vm device = device_value vdi-uuid = uuid_of_vdi_to_connect_to [bootable = true] [type = Disk | CD] [mode = RW | RO]
Cree un VBD en una máquina virtual.
Los valores permitidos para eldevice
campo son enteros 0 — 15, y el número debe ser único para cada máquina virtual. Los valores permitidos actuales se pueden ver en elallowed-VBD-devices
parámetro de la máquina virtual especificada. Esto se ve comouserdevice
en losvbd
parámetros.
Si eltype
esDisk
,vdi-uuid
es necesario. El modo puede serRO
oRW
para un disco.
Si eltype
esCD
,vdi-uuid
es opcional. Si no se especifica ningún VDI, se crea un VBD vacío para el CD. El modo debe serRO
para un CD.
vbd-destroy
vbd-destroy uuid = uuid_of_vbd
Destruye el VBD especificado.
Si el VBD tiene suother-config:owner
parámetro establecido entrue
, el VDI asociado también se destruye.
vbd-eject
vbd-eject uuid = uuid_of_vbd
Retire el medio de la unidad representada por un VBD. Este comando sólo funciona si el medio es de un tipo extraíble (un CD físico o un ISO). De lo contrario,VBD_NOT_REMOVABLE_MEDIA
se devuelve un mensaje de error.
vbd-insert
vbd-insert uuid = uuid_of_vbd vdi-uuid = uuid_of_vdi_containing_media
Inserte nuevos medios en la unidad representada por un VBD. Este comando sólo funciona si el medio es de un tipo extraíble (un CD físico o un ISO). De lo contrario,VBD_NOT_REMOVABLE_MEDIA
se devuelve un mensaje de error.
vbd-plug
vbd-plug uuid = uuid_of_vbd
Intente conectar el VBD mientras la máquina virtual está en estado de ejecución.
vbd-unplug
vbd-unplug uuid = uuid_of_vbd
Intenta separar el VBD de la VM mientras está en estado de ejecución.
Comandos VDI
Comandos para trabajar con VDIS (Imágenes de disco virtual).
Un VDI es un objeto de software que representa el contenido del disco virtual visto por una máquina virtual. Esto es diferente al VBD, que es un objeto que vincula una máquina virtual con el VDI. El VDI tiene la información sobre los atributos físicos del disco virtual (qué tipo de SR, si el disco es compartible, si el medio es de lectura/escritura o de sólo lectura, etc.). El VBD tiene los atributos que vinculan el VDI a la VM (es iniciable, 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 se pueden manipular con los comandos de parámetros estándar. Para obtener más información, consulte [Comandos#low-level-parameter-commands()de parámetros de nivel bajo]
Parámetros de VDI
Los VDI tienen los siguientes parámetros:
Nombre del parámetro | Descripción | Tipo |
---|---|---|
uuid |
La referencia única de identificador/objeto para el VDI | Sólo lectura |
name-label |
El nombre del VDI | Lectura/Escritura |
name-description |
La cadena descriptiva del VDI | Lectura/Escritura |
allowed-operations |
Una lista de las operaciones permitidas en este estado | Parámetro de conjunto de sólo lectura |
current-operations |
Una lista de las operaciones que están actualmente en curso en este VDI | Parámetro de conjunto de sólo lectura |
sr-uuid |
SR en el que reside el VDI | Sólo lectura |
vbd-uuids |
Una lista de VBD que hacen referencia a este VDI | Parámetro de conjunto de sólo lectura |
crashdump-uuids |
Lista de volcados de bloqueo que hacen referencia a este VDI | Parámetro de conjunto de sólo lectura |
virtual-size |
Tamaño del disco tal como se presenta en la máquina virtual, en bytes. Dependiendo del tipo de back-end de almacenamiento, el tamaño puede no ser respetado exactamente | Sólo lectura |
physical-utilisation |
Cantidad de espacio físico que el VDI ocupa en el SR, en bytes | Sólo lectura |
type |
Tipo de VDI, por ejemplo, Sistema o Usuario | Sólo lectura |
sharable |
True si se puede compartir este VDI | Sólo lectura |
read-only |
True si este VDI sólo se puede montar sólo lectura | Sólo lectura |
storage-lock |
True si este VDI está bloqueado en el nivel de almacenamiento | Sólo lectura |
parent |
Hace referencia al VDI principa cuando este VDI forma parte de una cadena | Sólo lectura |
missing |
True si la operación de exploración SR informó que este VDI no está presente | Sólo lectura |
other-config |
Información adicional de configuración para este VDI | Parámetro de mapa de lectura y escritura |
sr-name-label |
Nombre del repositorio de almacenamiento que contiene | Sólo lectura |
location |
Información de ubicación | Sólo lectura |
managed |
True si se administra el VDI | Sólo lectura |
xenstore-data |
Los datos que se insertarán en el árbol de xenstore (/ local/domain/0/backend/ vbd /domid/device-id/smdata) después de adjuntar el VDI. Los back-ends SM generalmente establecen este campo envdi_attach . |
Parámetro de mapa de sólo lectura |
sm-config |
Datos dependientes de SM | Parámetro de mapa de sólo lectura |
is-a-snapshot |
True si este VDI es una instantánea de almacenamiento de VM | Sólo lectura |
snapshot_of |
El UUID del almacenamiento de este VDI es una instantánea de | Sólo lectura |
snapshots |
Los UUID de todas las instantáneas de este VDI | Sólo lectura |
snapshot_time |
La marca de tiempo de la operación de instantánea que creó este VDI | Sólo lectura |
metadata-of-pool |
El uuid del grupo que creó este VDI de metadatos | Sólo lectura |
metadata-latest |
Indicador que indica si el VDI contiene los últimos metadatos conocidos para este grupo | Sólo lectura |
cbt-enabled |
Indicador que indica si el seguimiento de bloques modificados está habilitado para el VDI | Lectura/Escritura |
vdi-clone
vdi-clone uuid = uuid_of_the_vdi [driver-params: clave = valor]
Cree una copia nueva y grabable del VDI especificado que se pueda utilizar directamente. Es una variante devdi-copy
que puede exponer instalaciones clon de imagen de alta velocidad donde existen.
Utilice el parámetro dedriver-params
mapa opcional para pasar información de configuración específica del proveedor adicional al controlador de almacenamiento de información back-end en el que se basa el VDI. Para obtener más información, consulte la documentación del controlador del proveedor de almacenamiento de información.
vdi-copy
vdi-copy uuid = uuid_of_the_vdi sr-uuid = uuid_of_the_destination_sr
Copie un VDI en un SR especificado.
vdi-create
vdi-create sr-uuid = uuid_of_sr_to_create_vdi_on name-label = name_for_the_vdi type = system | user | suspend | crashdump virtual-size = size_of_virtual_disk sm-config- * = storage_specific_configuration_data
Cree un VDI.
Elvirtual-size
parámetro se puede especificar en bytes o utilizando los sufijos estándar IEC KiB, MiB, GiB y TiB.
Nota:
Los tipos SR que admiten aprovisionamiento ligero de discos (como VHD local y NFS) no aplican la asignación virtual de discos. Tenga mucho cuidado al asignar demasiado espacio en disco virtual en un SR. Si un SR sobreasignado se llena, debe estar disponible espacio en disco en el sustrato de destino SR o eliminando los VDI no utilizados en el SR.
Nota:
Algunos tipos SR pueden redondear el
virtual-size
valor para que sea divisible por un tamaño de bloque configurado.
vdi-data-destroy
vdi-data-destroy uuid = uuid_of_vdi
Destruya los datos asociados con el VDI especificado, pero mantenga los metadatos de seguimiento de bloques modificados.
Nota:
Si utiliza el seguimiento de bloques modificado para realizar copias de seguridad incrementales del VDI, asegúrese de utilizar el
vdi-data-destroy
comando para eliminar instantáneas pero conservar los metadatos. No lo utilicevdi-destroy
en instantáneas de VDI que hayan cambiado el seguimiento de bloques habilitado.
vdi-destroy
vdi-destroy uuid = uuid_of_vdi
Destruye el VDI especificado.
Nota:
Si utiliza el seguimiento de bloques modificado para realizar copias de seguridad incrementales del VDI, asegúrese de utilizar el
vdi-data-destroy
comando para eliminar instantáneas pero conservar los metadatos. No lo utilicevdi-destroy
en instantáneas de VDI que hayan cambiado el seguimiento de bloques habilitado.Nota:
Para los tipos de SR local VHD y NFS, el espacio en disco no se libera inmediatamente en
vdi-destroy
, sino periódicamente durante una operación de exploración del repositorio de almacenamiento. Si debe forzar la disponibilidad de espacio en disco eliminado, llame a [sr-scan
] (#sr -scan) manualmente.
vdi-disable-cbt
vdi-disable-cbt uuid = uuid_of_vdi
Deshabilitar el seguimiento de bloques cambiados para el VDI.
vdi-enable-cbt
vdi-enable-cbt uuid = uuid_of_vdi
Habilitar el seguimiento de bloques modificados para el VDI.
Nota:
Puede habilitar el seguimiento de bloques modificados sólo en instancias con licencia de .
vdi-export
vdi-export uuid = uuid_of_vdi filename = filename_to_export_to [format = format] [base = uuid_of_base_vdi] [— progress]
Exportar un VDI al nombre de archivo especificado. Puede exportar un VDI en uno de los siguientes formatos:
raw
vhd
El formato VHD puede ser escaso. Si hay bloques sin asignar dentro del VDI, estos bloques pueden omitirse del archivo VHD, por lo que el archivo VHD es más pequeño. Puede exportar al formato VHD desde todos los tipos de almacenamiento basados en VHD compatibles (EXT, NFS).
Si especifica elbase
parámetro, este comando exporta sólo los bloques que han cambiado entre el VDI exportado y el VDI base.
vdi-forget
vdi-forget uuid = uuid_of_vdi
Elimina incondicionalmente un registro VDI de la base de datos sin tocar el back-end de almacenamiento. En funcionamiento normal, debería usar [vdi-destroy
] (#vdi -destroy) en su lugar.
vdi-import
vdi-import uuid = uuid_of_vdi filename = filename_to_import_from [format = format] [— progress]
Importar un VDI. Puede importar un VDI desde uno de los siguientes formatos:
raw
vhd
vdi-introduce
vdi-introduce uuid = uuid_of_vdi sr-uuid = uuid_of_sr name-label = name_of_new_vdi type = system | user | suspend | crashdump location = device_location_( varía_por_storage_type) [name-description = description_of_vdi] [sharable = yes | no] [solo lectura = sí | no] [other-config = map_to store_mis-store c_user_specific_data] [xenstore-data = map_to_of_additional_xenstore_keys] [sm-config = storage_specific_configuration_data]
Cree un objeto VDI que represente un dispositivo de almacenamiento existente, sin modificar ni crear ningún almacenamiento. Este comando se utiliza principalmente internamente para introducir automáticamente dispositivos de almacenamiento con conexión en marcha.
vdi-list-changed-blocks
vdi-list-changed-blocks vdi-from-uuid = first-vdi-uuid vdi-to-uuid = segundo-vdi-uuid
Compare dos VDI y devuelva la lista de bloques que han cambiado entre los dos como una cadena codificada en base64. Este comando sólo funciona para VDI que han cambiado el seguimiento de bloques habilitado.
Para obtener más información, vea Seguimiento de bloques modificados.
vdi-pool-migrate
vdi-pool-migrate uuid = VDI_uuid sr-uuid = destination-sr-uuid
Migrar un VDI a un SR especificado, mientras que el VDI está conectado a un invitado en ejecución. (Almacenamiento )
Para obtener más información, vea Migrar máquinas virtuales.
vdi-resize
vdi-resize uuid = vdi_uuid disk-size = new_size_for_disk
Cambie el tamaño del VDI especificado por UUID.
vdi-snapshot
vdi-snapshot uuid = uuid_of_the_vdi [driver-params = params]
Produce una versión de lectura y escritura de un VDI que se puede utilizar como referencia para la creación de copias de seguridad o plantillas, o ambos. Utilice la instantánea para configurar 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 al medio de copia de seguridad. Del mismo modo, una instantánea se puede utilizar como una “imagen dorada” en la que basar una plantilla. Se puede crear una plantilla utilizando cualquier VDI.
Utilice el parámetro dedriver-params
mapa opcional para pasar información de configuración específica del proveedor adicional al controlador de almacenamiento de información back-end en el que se basa el VDI. Para obtener más información, consulte la documentación del controlador del proveedor de almacenamiento de información.
Un clon de una instantánea siempre debe producir un VDI grabable.
vdi-unlock
vdi-unlock uuid = uuid_of_vdi_to_unlock [force = true]
Intenta desbloquear los VDI especificados. Siforce=true
se pasa al comando, fuerza la operación de desbloqueo.
vdi-update
vdi-update uuid = uuid
Actualice los campos del objeto VDI en la base de datos.
Comandos VIF
Comandos para trabajar con VIFs (interfaces de red virtual).
Los objetos VIF se pueden enumerar con el comando estándar de lista de objetos (xe vif-list
) y los parámetros se pueden manipular con los comandos de parámetros estándar. Para obtener más información, consulte [Comandos#low-level-parameter-commands()de parámetros de nivel bajo]
Parámetros VIF
Los VIF tienen los siguientes parámetros:
-
uuid
( solo lectura) la referencia única de identificador/objeto para el VIF -
vm-uuid
( solo lectura) la referencia única de identifiador/objeto para la VM en la que reside este VIF -
vm-name-label
( sólo lectura) el nombre de la máquina virtual en la que reside este VIF -
allowed-operations
( sólo lectura parámetro conjunto) una lista de las operaciones permitidas en este estado -
current-operations
( parámetro de conjunto de sólo lectura) una lista de las operaciones que están actualmente en curso en este VIF -
device
( sólo lectura) etiqueta entera de este VIF, indicando el orden en el que se crearon los back-ends VIF -
MAC
( sólo lectura) dirección MAC de VIF, tal como se expone a la máquina virtual -
MTU
( sólo lectura) Unidad de transmisión máxima del VIF en bytes.Este parámetro es de sólo lectura, pero puede anular la configuración de MTU con la
mtu
clave utilizando el parámetro deother-config
mapa. Por ejemplo, para restablecer la MTU en una NIC virtual para usar tramas jumbo:xe vif-param-set \ < vif_uuid >uuid = \ other-config:mtu=9000
-
currently-attached
( sólo lectura) true si el dispositivo está conectado - Algoritmo QoS
qos_algorithm_type
(lectura/escritura) para usar -
qos_algorithm_params
( parámetro de mapa de lectura/escritura) para el algoritmo QoS elegido -
qos_supported_algorithms
( parámetro de solo lectura) compatibles con algoritmos QoS para este VIF -
MAC-autogenerated
( sólo lectura) True si la dirección MAC del VIF se generó automáticamente -
other-config
( parámetro de mapa de lectura/escritura)key:value
pares de configuración adicionales -
other-config:ethtoolrx
( lectura/escritura) establecido en activado para habilitar la suma de comprobación de recepción, desactivado para deshabilitar -
other-config:ethtooltx
( lectura/escritura) establecido en activado para habilitar la suma de comprobación de transmisión, desactivado para deshabilitar -
other-config:ethtoolsg
( lectura/escritura) establecido en activado para habilitar la recopilación de dispersión, desactivado para deshabilitar -
other-config:ethtooltso
( lectura/escritura) establecido en activado para habilitar descarga de segmentación tcp, desactivado para deshabilitar -
other-config:ethtoolufo
( lectura/escritura) establecido en activado para habilitar la descarga de fragmentos udp, desactivado para deshabilitar -
other-config:ethtoolgso
( lectura/escritura) establecido en activado para habilitar la descarga de segmentación genérica, desactivado para deshabilitar -
other-config:promiscuous
( lectura/escritura) verdadero 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 intrusiones (IDS) o similar en una máquina virtual. -
network-uuid
( sólo lectura) la referencia única de identificador/objeto de la red virtual a la que está conectado este VIF -
network-name-label
( sólo lectura) el nombre descriptivo de la red virtual a la que está conectado este VIF -
io_read_kbs
( solo lectura) tasa media de lectura en KB/s para este VIF -
io_write_kbs
( sólo lectura) tasa media de escritura en KB/s para este VIF -
locking_mode
( lectura/escritura) Afecta a la capacidad de los VIF para filtrar tráfico a/desde una lista de direcciones MAC e IP. Requiere parámetros adicionales. -
locking_mode:default
( lectura/escritura) Varía según el modo de bloqueo predeterminado para la red VIF.Si el modo predeterminado de bloqueo está establecido en
disabled
, aplica una regla de filtrado para que el VIF no pueda enviar ni recibir tráfico. Si el modo de bloqueo predeterminado está establecido enunlocked
, quita todas las reglas de filtrado asociadas con el VIF. Para obtener más información, consulte Comandos de red. -
locking_mode:locked
( lectura/escritura) Sólo se permite el tráfico enviado a o desde las direcciones MAC e IP especificadas en el VIF. Si no se especifican direcciones IP, no se permite tráfico. -
locking_mode:unlocked
( lectura/escritura) No se aplican filtros a ningún tráfico que vaya hacia o desde el VIF. -
locking_mode:disabled
( lectura/escritura) aplica una regla de filtrado para que el VIF deje caer todo el tráfico.
vif-create
vif-create vm-uuid = uuid_of_the_vm device = ver abajo network-uuid = uuid_of_network_to_connect_to [mac = mac_address]
Cree un VIF en una máquina virtual.
Los valores apropiados para eldevice
campo se enumeran en el parámetroallowed-VIF-devices
de la máquina virtual especificada. Antes de que exista algún VIF allí, los valores permitidos son enteros de 0-15.
Elmac
parámetro es la dirección MAC estándar del formularioaa:bb:cc:dd:ee:ff
. Si lo deja sin especificar, se crea una dirección MAC aleatoria apropiada. También puede establecer explícitamente una dirección MAC aleatoria especificandomac=random
.
vif-destroy
vif-destroy uuid = uuid_of_vif
Destruye un VIF.
vif-move
vif-move uuid = uuid network-uuid = network_uuid
Mueva el VIF a otra red.
vif-plug
vif-plug uuid = uuid_of_vif
Intente conectar el VIF mientras la máquina virtual está en estado de ejecución.
vif-unplug
vif-unplug uuid = uuid_of_vif
Intenta separar el VIF de la máquina virtual mientras se está ejecutando.
vif-configure-ipv4
Configure la configuración de IPv4 para esta interfaz virtual. Establezca la configuración de IPv4 de la siguiente manera:
vif-configure-ipv4 uuid = uuid_of_vif mode = dirección estática = puerta de enlace_dirección_puerta de enlace = dirección_puerta de enlace
Por ejemplo:
VIF.configure_ipv4 (VIFObject, “estática”, “192.168.1.10/24”, "192.168.1.1")
Limpie la configuración IPv4 de la siguiente manera:
vif-configure-ipv4 uuid = uuid_of_vif mode = none
vif-configure-ipv6
Configure la configuración de IPv6 para esta interfaz virtual. Establezca la configuración de IPv6 de la siguiente manera:
vif-configure-ipv6 uuid = uuid_of_vif mode = dirección estática = puerta de enlace_IP = dirección_puerta de enlace
Por ejemplo:
VIF.configure_ipv6 (VIFObject, “estática”, “fd 06:7768: b9e 5:8 b00:: 5001/64”, "fd 06:7768: b9e 5:8 b00:: 1")
Limpie la configuración de IPv6 de la siguiente manera:
vif-configure-ipv6 uuid = uuid_of_vif mode = none
Comandos de VLAN
Comandos para trabajar con VLAN (redes virtuales). Para enumerar y editar interfaces virtuales, consulte los comandos PIF, que tienen un parámetro VLAN para indicar que tienen una red virtual asociada. Para obtener más información, consulte Comandos PIF. Por ejemplo, para enumerar las VLAN, usexe pif-list
.
vlan-create
vlan-create pif-uuid = uuid_of_pif vlan = vlan_number network-uuid = uuid_of_network
Cree una VLAN en su host.
pool-vlan-create
pool-vlan-create pif-uuid = uuid_of_pif vlan = vlan_number network-uuid = uuid_of_network
Cree una VLAN en todos los hosts de un grupo, determinando en qué interfaz (por ejemplo,eth0
) está la red especificada (en cada host) y creando y conectando un nuevo objeto PIF uno cada host en consecuencia.
vlan-destroy
vlan-destroy uuid = uuid_of_pif_mapping_to_vlan
Destruye una VLAN. Requiere el UUID del PIF que representa la VLAN.
Comandos de VM
Comandos para controlar máquinas virtuales y sus atributos.
Selectores de VM
Varios de los comandos enumerados aquí tienen un mecanismo común para seleccionar una o más máquinas virtuales en las que realizar la operación. La forma más simple es suministrando el argumentovm=name_or_uuid
. Una forma fácil de obtener el uuid de una VM real es, por ejemplo, ejecutarxe vm-list power-state=running
. ( Obtenga la lista completa de campos que se pueden hacer coincidir mediante el comandoxe vm-list params=all
.) Por ejemplo, al especificar las máquinas virtualespower-state=halted
seleccionadas cuyopower-state
parámetro es igual a -haltedSí.
En los casos en que coincidan varias máquinas virtuales, especifique la opción--multiple
para realizar la operación. A lista completa de parâmetros que podem ser correspondados é descrita no início deste seção.
Los objetos VM se pueden enumerar con el comando estándar de lista de objetos (xe vm-list
) y los parámetros se pueden manipular con los comandos de parámetros estándar. Para obtener más información, consulte [Comandos#low-level-parameter-commands()de parámetros de nivel bajo]
Parámetros de VM
Las VM tienen los siguientes parámetros:
Nota:
Todos los valores de parámetros de VM grabables se pueden cambiar mientras se ejecuta la máquina virtual, pero los nuevos parámetros no se aplican dinámicamente y no se pueden aplicar hasta que se reinicie la máquina virtual.
-
appliance
( lectura/escritura) el Appliance/vApp al que pertenece la VM -
uuid
( sólo lectura) la referencia única de identificador/objeto para la VM -
name-label
( lectura/escritura) el nombre de la máquina virtual -
name-description
( lectura/escritura) la cadena de descripción de la máquina virtual -
order start order
( lectura/escritura) para inicio/apagado de vApp y para el inicio después de la conmutación por error de alta disponibilidad -
version
( sólo lectura) el número de veces que se ha recuperado esta máquina virtual. Si desea sobrescribir una máquina virtual nueva con una versión anterior, llame avm-recover
-
user-version
( lectura/escritura) cadena para los creadores de máquinas virtuales y plantillas para poner información de versión -
is-a-template
( lectura/escritura) False a menos que esta máquina virtual sea una plantilla. Las máquinas virtuales de plantilla nunca se pueden iniciar, sólo se utilizan 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 mediante este parámetro. -
is-control-domain
( sólo lectura) True si se trata de un dominio de control (dominio 0 o dominio de controlador) -
power-state
( sólo lectura) estado de la energía actual -
start-delay
( lectura/escritura) el retraso para esperar antes de que una llamada para iniciar la VM devuelve -
shutdown-delay
( lectura/escritura) el retraso para esperar antes de que una llamada para apagar la máquina virtual devuelve -
memory-dynamic-max
( lectura/escritura) máximo dinámico en bytes -
memory-dynamic-min
( lectura/escritura) mínimo dinámico en bytes -
memory-static-max
( lectura/escritura) establecido estáticamente (absoluto) máximo en bytes. Si desea cambiar este valor, la máquina virtual debe cerrarse. -
memory-static-min
( lectura/escritura) establecido estáticamente (absoluto) mínimo en bytes. Si desea cambiar este valor, la máquina virtual debe cerrarse. -
suspend-VDI-uuid
( sólo lectura) el VDI en el que se almacena una imagen de suspensión en -
VCPUs-params
( parámetro de mapa de lectura/escritura) para la directiva de vCPU seleccionada.Puede ajustar la fijación de una vCPU con
xe vm-param-set uuid = < vm_uuid > VCPUS-params: máscara = 1,2,3
A continuación, la máquina virtual seleccionada se ejecuta únicamente en CPU físicas 1, 2 y 3.También puede ajustar la prioridad de vCPU (programación xen) con los parámetros de límite y peso. Por ejemplo:
xe vm-param-set uuid = < vm_uuid > VCPUS-params: peso = 512 xe vm-param-set uuid = < vm_uuid > VCPUS-params: cap = 100
Una máquina virtual con un peso de 512 obtiene el doble de CPU que un dominio con un peso de 256 en un host contendido. Los pesos legales oscilan entre 1 y 65535 y el valor predeterminado es 256. El límite corrige opcionalmente la cantidad máxima de CPU que una máquina virtual podrá consumir, incluso si el host 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 es 4 CPU, etc. El valor predeterminado, 0, significa que no hay límite superior.
-
VCPUs-max
( lectura/escritura) número máximo de CPU virtuales. -
VCPUs-at-startup
( lectura/escritura) número de arranque de CPU virtuales -
actions-after-crash
( lectura/escritura) que se debe realizar si se bloquea la máquina virtual. Para los huéspedes PV, los parámetros válidos son:-
preserve
( sólo para análisis) -
coredump_and_restart
( grabar un coredump y reiniciar la máquina virtual) -
coredump_and_destroy
( grabar un coredump y dejar la VM detenida) -
restart
( sin coredump y reiniciar VM) -
destroy
( sin coredump y dejar VM detenida)
-
-
console-uuids
( parámetro de configuración de sólo lectura) dispositivos de consola virtual -
platform
( parámetro de mapa de lectura/escritura) configuración específica de la plataformaPara deshabilitar Virtual Desktop Agent (VDA) para cambiar Windows 10 al modo Tablet:
xe vm-param-set uuid = < vm_uuid > plataforma: acpi_laptop_slate = 0
Para habilitar VDA para cambiar Windows 10 al modo Tablet:
xe vm-param-set uuid = < vm_uuid > plataforma: acpi_laptop_slate = 1
Para comprobar el estado actual:
xe vm-param-get uuid = < vm_uuid > param-name = plataforma param-key = acpi_laptop_slate
-
allowed-operations
( sólo lectura parámetro conjunto) lista de las operaciones permitidas en este estado -
current-operations
( parámetro de conjunto de sólo lectura) una lista de las operaciones que están actualmente en curso en la máquina virtual -
allowed-VBD-devices
( parámetro de conjunto de sólo lectura) lista de identificadores VBD disponibles para su uso, representados por enteros del rango 0 — 15. Esta lista es de carácter informativo y se pueden utilizar otros dispositivos (pero es posible que no funcionen). -
allowed-VIF-devices
( parámetro de conjunto de sólo lectura) lista de identificadores VIF disponibles para su uso, representados por enteros del rango 0 — 15. Esta lista es de carácter informativo y se pueden utilizar otros dispositivos (pero es posible que no funcionen). -
HVM-boot-policy
( lectura/escritura) la directiva de arranque para los invitados HVM. Orden del BIOS o una cadena vacía. -
HVM-boot-params
( parámetro de mapa de lectura/escritura) la clave de orden controla el orden de arranque invitado de HVM, representado como una cadena donde cada carácter es un método de arranque: d para el CD/DVD, c para el disco raíz y n para el arranque PXE de red. El valor predeterminado es dc. -
HVM-shadow-multiplier
( lectura/escritura) Valor de coma flotante que controla la cantidad de sobrecarga de memoria de sombra para conceder a la máquina virtual. El valor predeterminado es 1.0 (el valor mínimo), y sólo los usuarios avanzados deben cambiar este valor. -
PV-kernel
( lectura/escritura) al núcleo -
PV-ramdisk
( lectura/escritura) ruta al initrd -
PV-args
( lectura/escritura) cadena de argumentos de línea de comandos del núcleo -
PV-legacy-args
( lectura/escritura) cadena de argumentos para hacer que las VM heredadas inicien -
PV-bootloader
( lectura/escritura) nombre o ruta al gestor de arranque -
PV-bootloader-args
( lectura/escritura) cadena de argumentos varios para el gestor de arranque -
last-boot-CPU-flags
( sólo lectura) describe los indicadores de CPU en los que se inició la máquina virtual por última vez -
resident-on
( sólo lectura) el host en el que reside una máquina virtual -
affinity
( lectura/escritura) El host en el que la máquina virtual tiene preferencia para ejecutarse. Utilizado por elxe vm-start
comando para decidir dónde ejecutar la máquina virtual -
other-config
( parámetro de mapa de lectura/escritura) Lista de pares clave/valor que especifican parámetros de configuración adicionales para la máquina virtual. Por ejemplo, una máquina virtual se inicia automáticamente después del arranque del host cuando elother-config
parámetro incluye el parauto_poweron: true
clave/valor -
start-time
( sólo lectura) marca de tiempo de la fecha y hora en que se leyeron las métricas de la máquina virtual. Esta marca de tiempo está en el formularioyyyymmddThh:mm:ss z
, donde z es el indicador de zona horaria militar de una sola letra, por ejemplo, Z para UTC (GMT) -
install-time
( sólo lectura) marca de tiempo de la fecha y hora en que se leyeron las métricas de la máquina virtual. Esta marca de tiempo está en el formularioyyyymmddThh:mm:ss z
, donde z es el indicador de zona horaria militar de una sola letra, por ejemplo, Z para UTC (GMT) -
memory-actual
( sólo lectura) la memoria real utilizada por una máquina virtual -
VCPUs-number
( sólo lectura) el número de CPU virtuales asignadas a la máquina virtual para una VM Linux PV (paravirtual) o HVM (máquina virtual de hardware). Este número puede diferirVCPUS-max
y se puede cambiar sin reiniciar la máquina virtual mediante elvm-vcpu-hotplug
comando. Para obtener más información, consulte [vm-vcpu-hotplug
] (#vm -vcpu-hotplug). Las VM de Windows siempre se ejecutan con el número de vCPU establecido enVCPUsmax
y deben reiniciarse para cambiar este valor. El rendimiento disminuye considerablemente cuandoVCPUs-number
se establece en un valor mayor que el número de CPU físicas en el host. -
VCPUs-Utilization
( sólo lectura parámetro de mapa) una lista de CPU virtuales y su peso -
os-version
( sólo lectura parámetro de mapa) la versión del sistema operativo para la máquina virtual -
PV-drivers-version
( sólo lectura parámetro de mapa) las versiones de los controladores paravirtualizados para la máquina virtual -
PV-drivers-detected
( solo lectura) para la última versión de los controladores paravirtualizados para la máquina virtual -
memory
( parámetro de mapa de sólo lectura) métricas de memoria notificadas por el agente en la máquina virtual -
disks
( parámetro de mapa de sólo lectura) métricas de disco notificadas por el agente en la máquina virtual -
networks
( parámetro de mapa de sólo lectura) métricas de red notificadas por el agente en la máquina virtual -
other
( parámetro de mapa de sólo lectura) otras métricas notificadas por el agente en la máquina virtual -
guest-metrics-lastupdated
( sólo lectura) marca de tiempo cuando el agente invitado realizó la última escritura en estos campos. La marca de tiempo está en el formularioyyyymmddThh:mm:ss z
, donde z es el indicador de zona horaria militar de una sola letra, por ejemplo, Z para UTC (GMT) -
actions-after-shutdown
( lectura/escritura) que se debe realizar después de que la máquina virtual se haya apagado -
actions-after-reboot
( lectura/escritura) que se debe realizar después de reiniciar la máquina virtual - hosts
possible-hosts
potenciales de esta máquina virtual de sólo lectura -
dom-id
( sólo lectura) ID de dominio (si está disponible, -1 en caso contrario) -
recommendations
( sólo lectura) especificación XML de los valores y rangos recomendados para las propiedades de esta máquina virtual -
xenstore-data
( parámetro de mapa de lectura/escritura) datos que se insertarán en el árbol de xenstore (/ local/domain/domid /vm-data) después de crear la máquina virtual -
is-a-snapshot
( sólo lectura) True si esta máquina virtual es una instantánea -
snapshot_of
( sólo lectura) el UUID de la máquina virtual de la que esta instantánea es de -
snapshots
( solo lectura) los UUID de todas las instantáneas de esta VM -
snapshot_time
( sólo lectura) la marca de tiempo de la operación de instantánea que creó esta instantánea de VM -
memory-target
( sólo lectura) la cantidad de memoria de destino establecida para esta máquina virtual -
blocked-operations
( parámetro de mapa de lectura/escritura) enumera las operaciones que no se pueden realizar en esta máquina virtual -
last-boot-record
( sólo lectura) registro de los últimos parámetros de arranque para esta plantilla, en formato XML -
ha-always-run
( lectura/escritura) True si esta máquina virtual se reinicia siempre en otro host si hay un error en el host en el que reside. Este parámetro está ahora en desuso. Utilice elha-restart-priority
parámetro en su lugar. -
ha-restart-priority
( lectura/escritura) reiniciar o hacer el mejor esfuerzo -
blobs
( sólo lectura) almacén de datos binario -
live
( sólo lectura) True si la máquina virtual se está ejecutando. False si HA sospecha que la máquina virtual no se está ejecutando.
vm-assert-can-be-recovered
vm-assert-puede-ser recuperado uuid [base de datos] vdi-uuid
Comprueba si el almacenamiento está disponible para recuperar esta máquina virtual.
vm-call-plugin
vm-call-plugin vm-uuid = plugin vm_uuid = plugin fn = function [args: key = value]
Llama a la función dentro del complemento en la vm dada con argumentos opcionales (args: key = value). Para pasar una cadena de “valor” con caracteres especiales en ella (por ejemplo, nueva línea), se puede usar una sintaxis alternativa args: key: file = local_file, donde el contenido de local_file se recuperará y se asignará a “key” como un todo.
vm-cd-add
vm-cd-add cd-name = nombre_of_new_cd device = integer_value_of_an_available_vbd [vm-selector = vm_selector_valor...]
Agregue un nuevo CD virtual a la máquina virtual seleccionada. Eldevice
parámetro debe seleccionarse del valor delallowed-VBD-devices
parámetro 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, vea Selectores de VM. Los argumentos opcionales pueden ser cualquier número de parámetros de VMenumerados al principio de esta sección.
vm-cd-eject
vm-cd-eject [vm-selector = vm_selector_valor...]
Expulse un CD de la unidad de CD virtual. Este comando sólo funciona si exactamente un CD está conectado a la máquina virtual. Cuando haya dos o más CD, utilice el comandoxe vbd-eject
y especifique el UUID del VBD.
La máquina virtual o las máquinas virtuales en las que se realiza esta operación se seleccionan mediante el mecanismo de selección estándar. Para obtener más información, vea Selectores de VM. Los argumentos opcionales pueden ser cualquier número de parámetros de VMenumerados al principio de esta sección.
vm-cd-insert
vm-cd-insert cd-name = nombre_of_cd [vm-selector = vm_selector_valor...]
Inserte un CD en la unidad de CD virtual. Este comando sólo funciona si hay exactamente un dispositivo de CD vacío conectado a la máquina virtual. Cuando haya dos o más dispositivos de CD vacíos, utilice elxe vbd-insert
comando y especifique los UUID del VBD y del VDI que desea insertar.
La máquina virtual o las máquinas virtuales en las que se realiza esta operación se seleccionan mediante el mecanismo de selección estándar. Para obtener más información, vea Selectores de VM. Los argumentos opcionales pueden ser cualquier número de parámetros de VMenumerados al principio de esta sección.
vm-cd-list
vm-cd-list [vbd-params] [vdi-params] [vm-selector = vm_selector_valor...]
Muestra 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, vea Selectores de VM. Los argumentos opcionales pueden ser cualquier número de parámetros de VMenumerados al principio de esta sección.
También puede seleccionar qué parámetros VBD y VDI desea enumerar.
vm-cd-remove
vm-cd-remove cd-name = name_of_cd [vm-selector = vm_selector_valor...]
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, vea Selectores de VM. Los argumentos opcionales pueden ser cualquier número de parámetros de VMenumerados al principio de esta sección.
vm-checkpoint
vm-checkpoint new-name-label = name_label [new-name-description = description]
Controle una máquina virtual existente, utilizando la operación rápida de instantáneas de disco en el nivel de almacenamiento cuando esté disponible.
vm-clone
vm-clone new-name-label = name_for_clone [new-name-description = description_for_clone] [vm-selector = vm_selector_valor...]
Clonar una máquina virtual existente, utilizando la operación de clon de disco rápido a nivel de almacenamiento cuando esté disponible. Especifique el nombre y la descripción opcional de la máquina virtual clonada resultante utilizando losnew-name-label
argumentosnew-name-description
y.
La máquina virtual o las máquinas virtuales en las que se realiza esta operación se seleccionan mediante el mecanismo de selección estándar. Para obtener más información, vea Selectores de VM. Los argumentos opcionales pueden ser cualquier número de parámetros de VMenumerados al principio de esta sección.
vm-compute-maximum-memory
vm-compute-maximum-memory total = amount_of_available_physical_ram_in_bytes [approximate = agregar memoria de sobrecarga para vCPU adicionales? true | false] [vm_selector = vm_selector_valor...]
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 opcionalapproximate
reserva suficiente memoria extra en el cálculo para tener en cuenta la adición de vCPU adicionales en la máquina virtual más adelante.
Por ejemplo:
xe vm-compute-maximum-memory vm = testvm total = `xe host-list params = memória — minimal`
Este comando utiliza el valor delmemory-free
parámetro devuelto por elxe host-list
comando para establecer la memoria máxima de la máquina virtual denominadatestvm
.
La máquina virtual o las máquinas virtuales en las que se realiza esta operación se seleccionan mediante el mecanismo de selección estándar. Para obtener más información, vea Selectores de VM. Los argumentos opcionales pueden ser cualquier número de parámetros de VMenumerados al principio de esta sección.
vm-compute-memory-overhead
vm-compute-memoria sobrecarga
Calcula la sobrecarga de memoria de virtualización de una máquina virtual.
vm-copy
vm-copy new-name-label = name_for_copy [new-name-description = description_for_copy] [sr-uuid = uuid_of_sr] [vm-selector = vm_selector_valor...]
Copie una máquina virtual existente, pero sin utilizar la operación de clon de disco rápido a nivel de almacenamiento (incluso si esta opción está disponible). Se garantiza que las imágenes de disco de la máquina virtual copiada sean imágenes completas, es decir, no parte de una cadena de copia en escritura (CoW).
Especifique el nombre y la descripción opcional de la máquina virtual copiada resultante utilizando losnew-name-label
argumentosnew-name-description
y.
Especifique el SR de destino para la máquina virtual copiada resultante utilizando elsr-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, vea Selectores de VM. Los argumentos opcionales pueden ser cualquier número de parámetros de VMenumerados al principio de esta sección.
vm-copy-bios-strings
vm-copy-bios-strings host-uuid = host_uuid
Copie las cadenas de BIOS del host dado en la máquina virtual.
vm-crashdump-list
vm-crashdump-list [vm-selector = valor del selector de VM...]
Enumere los volcados asociados a las máquinas virtuales especificadas.
Cuando se utiliza el argumento opcionalparams
, el valor de params es una cadena que contiene una lista de parámetros de este objeto que desea mostrar. Alternativamente, puede usar la palabra claveall
para mostrar todos los parámetros. Si noparams
se utiliza, la lista devuelta muestra un subconjunto predeterminado de todos los parámetros disponibles.
La máquina virtual o las máquinas virtuales en las que se realiza esta operación se seleccionan mediante el mecanismo de selección estándar. Para obtener más información, vea Selectores de VM. Los argumentos opcionales pueden ser cualquier número de parámetros de VMenumerados al principio de esta sección.
vm-data-source-list
vm-data-source-list [vm-selector = valor del selector de VM...]
Enumere los orígenes de datos que se pueden grabar 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, vea Selectores de VM. Los argumentos opcionales pueden ser cualquier número de parámetros de VMenumerados 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ámetrosstandard
—enabled
y — que se pueden ver en la salida de este comando. Si un origen de datos se haenabled
establecido entrue
, las métricas se están registrando actualmente en la base de datos de rendimiento. Si un origen de datos se hastandard
establecido entrue
, las métricas se registran en la base de datos de rendimiento de forma predeterminada (y tambiénenabled
se establece entrue
para esta fuente de datos). Si un origen de datos se hastandard
establecido enfalse
, las métricas *no* se registran en la base de datos de rendimiento de forma predeterminada (y tambiénenabled
se establece en falsepara esta fuente de datos).
Para comenzar a registrar métricas de origen de datos en la base de datos de rendimiento, ejecute elvm-data-source-record
comando. Este comando se estableceenabled
entrue
. Para detener, ejecute elvm-data-source-forget
. Este comando se estableceenabled
enfalse
.
vm-data-source-record
vm-data-source-record data-source = name_description_of_data-source [vm-selector = valor de selector de máquina virtual...]
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 persistentes de las máquinas virtuales especificadas. Por motivos de rendimiento, esta base de datos es distinta de la base de datos del agente normal.
Seleccione las máquinas virtuales en las que desea realizar esta operación mediante el mecanismo de selección estándar. Para obtener más información, vea Selectores de VM. Los argumentos opcionales pueden ser cualquier número de parámetros de VMenumerados al principio de esta sección. Si no se proporcionan parámetros para seleccionar hosts, la operación se realiza en todas las máquinas virtuales.
vm-data-source-forget
vm-data-source-forget data-source = name_description_of_data-source [vm-selector = valor del selector de VM...]
Detenga la grabación del origen de datos especificado 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, vea Selectores de VM. Los argumentos opcionales pueden ser cualquier número de parámetros de VMenumerados al principio de esta sección. Si no se proporcionan parámetros para seleccionar hosts, la operación se realiza en todas las máquinas virtuales.
vm-data-source-query
vm-data-source-query data-source = name_description_of_data-source [vm-selector = vm_selector_value...]
Mostrar 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, vea Selectores de VM. Los argumentos opcionales pueden ser cualquier número de parámetros de VMenumerados al principio de esta sección. Si no se proporcionan parámetros para seleccionar hosts, la operación se realiza en todas las máquinas virtuales.
vm-destroy
vm-destroy uuid = uuid_of_vm
Destruye la máquina virtual especificada. Esto deja intacto el almacenamiento asociado a la máquina virtual. Para eliminar el almacenamiento también, usexe vm-uninstall
.
vm-disk-add
vm-disk-add disk-size = size_of_disk_to_add device = uuid_of_device [vm-selector = vm_selector_valor...]
Agregue un disco a las máquinas virtuales especificadas. Seleccione eldevice
parámetro del valor delallowed-VBD-devices
parámetro de las VM.
Eldisk-size
parámetro se puede especificar en bytes o utilizando los sufijos estándar IEC KiB, MiB, GiB y TiB.
La máquina virtual o las máquinas virtuales en las que se realiza esta operación se seleccionan mediante el mecanismo de selección estándar. Para obtener más información, vea Selectores de VM. Los argumentos opcionales pueden ser cualquier número de parámetros de VMenumerados al principio de esta sección.
vm-disk-list
vm-disk-list [vbd-params] [vdi-params] [vm-selector = vm_selector_valor...]
Muestra los discos conectados a las máquinas virtuales especificadas. Losvbd-params
parámetrosvdi-params
y controlan los campos de los objetos respectivos que se van a generar. Indique los parámetros como una lista separada por comas o la clave especialall
para la lista completa.
La máquina virtual o las máquinas virtuales en las que se realiza esta operación se seleccionan mediante el mecanismo de selección estándar. Para obtener más información, vea Selectores de VM. Los argumentos opcionales pueden ser cualquier número de parámetros de VMenumerados al principio de esta sección.
vm-disk-remove
vm-disk-remove device = integer_label_of_disk [vm-selector = vm_selector_valor...]
Retire un disco de las máquinas virtuales especificadas y destruirlo.
La máquina virtual o las máquinas virtuales en las que se realiza esta operación se seleccionan mediante el mecanismo de selección estándar. Para obtener más información, vea Selectores de VM. Los argumentos opcionales pueden ser cualquier número de parámetros de VMenumerados al principio de esta sección.
vm-export
vm-export filename = export_filename [metadata = true | false] [vm-selector = vm_selector_value...]
Exporte las máquinas virtuales especificadas (incluidas las imágenes de disco) a un archivo del equipo local. Especifique el nombre de archivo al que exportar la máquina virtual utilizando elfilename
parámetro. Por convención, el nombre de archivo debe tener una.xva
extensión.
Si elmetadata
parámetro estrue
, los discos no se exportan. Sólo los metadatos de VM se escriben en el archivo de salida. Utilice este parámetro cuando el almacenamiento subyacente se transfiera a través de otros mecanismos y permita que se vuelva a crear la información de la máquina virtual. Para obtener más información, consulte vm-import.
La máquina virtual o las máquinas virtuales en las que se realiza esta operación se seleccionan mediante el mecanismo de selección estándar. Para obtener más información, vea Selectores de VM. Los argumentos opcionales pueden ser cualquier número de parámetros de VMenumerados al principio de esta sección.
vm-import
vm-import filename = export_filename [metadata = true | false] [preserve = true | false] [sr-uuid = destination_sr_uuid]
Importe una máquina virtual desde un archivo exportado anteriormente. Sipreserve
se establece entrue
, se conserva la dirección MAC de la máquina virtual original. Elsr-uuid
determina el SR de destino en el que se va a importar la máquina virtual. Si no se especifica este parámetro, se utiliza el SR predeterminado.
Elfilename
parámetro también puede apuntar a una máquina virtual con formato XVA, que es el formato de exportación heredado de 3.2. Este formato es utilizado por algunos proveedores externos para proporcionar dispositivos virtuales. El formato XVA utiliza un directorio para almacenar los datos de VM, por lo quefilename
se establece en el directorio raíz de la exportación XVA y no en un archivo real. Las exportaciones posteriores del huésped heredado importado se actualizan automáticamente al nuevo formato basado en el archivo, que almacena muchos más datos sobre la configuración de la máquina virtual.
Nota:
El formato XVA basado en directorio anterior no conserva completamente todos los atributos de VM. En particular, las máquinas virtuales importadas no tienen ninguna interfaz de red virtual conectada de forma predeterminada. Si se requiere una red, cree una usando
vif-create
yvif-plug
.
Si elmetadata
estrue
, puede importar un conjunto de metadatos previamente exportado sin sus bloques de disco asociados. La importación sólo de metadatos falla si no se puede encontrar ningún VDIS (nombrado por SR yVDI.location
) a menos que se especifique la--force
opción, en cuyo caso la importación procede independientemente. Si los discos se pueden reflejar o mover fuera de banda, la importación/exportación de metadatos es una forma rápida de mover máquinas virtuales entre grupos disjuntos. Por ejemplo, como parte de un plan de recuperación ante desastres.
Nota:
Varias importaciones de VM se realizan más rápido en serie que en paralelo.
vm-install
vm-install new-name-label = name [template-uuid = uuid_of_desired_template] [template = template_uuid_or_name] [sr-uuid = sr_uuid | sr-name-label = name_of_sr] [copy-bios-strings-from = host_uuid]
Instale o clone una máquina virtual desde una plantilla. Especifique el nombre de la plantilla utilizando eltemplate-uuid
argumentotemplate
o. Especifique un SR utilizando elsr-uuid
argumentosr-name-label
o. Especifique la instalación de medios bloqueados con BIOS utilizando elcopy-bios-strings-from
argumento.
Nota:
Al instalar desde una plantilla que tiene discos existentes, de forma predeterminada, se crean discos nuevos en el mismo SR que estos discos existentes. Donde SR lo admite, estos discos son copias rápidas. Si se especifica un SR diferente en la línea de comandos, los nuevos discos se crean allí. En este caso, no es posible una copia rápida y los discos son copias completas.
Al instalar desde una plantilla que no tiene discos existentes, se crean todos los discos nuevos en el SR especificado o el SR predeterminado del grupo cuando no se especifica un SR.
vm-is-bios-customized
vm-is-bios-personalizado
Indica si se han personalizado las cadenas de BIOS de la máquina virtual.
vm-memory-balloon
vm-memory-balloon target = objetivo
Establezca el destino de memoria para una máquina virtual en ejecución. El valor dado debe estar dentro del rango definido por los valores memory_dynamic_min y memory_dynamic_max de la VM.
vm-memory-dynamic-range-set
vm-memory-dynamic-range-set min = min max = max
Configure el rango de memoria dinámica de una máquina virtual. El rango de memoria dinámica define los límites inferiores y superiores suaves para la memoria de una máquina virtual. Es posible cambiar estos campos cuando una máquina virtual se está ejecutando o se detiene. El rango dinámico debe caber dentro del rango estático.
vm-memory-limits-set
vm-memory-limits-set static-min = static_min static-max = static_max dynamic-min = dynamic_min dynamic-max = dynamic_max
Configure los límites de memoria de una máquina virtual.
vm-memory-set
memoria vm-memory-set = memoria
Configure la asignación de memoria de una máquina virtual.
vm-memory-shadow-multiplier-set
vm-memory-shadow-multiplier-set [vm-selector = vm_selector_valor...] [multiplicador = float_memory_multiplier]
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 de sombra asignada a una máquina virtual asistida por hardware.
Esta memoria se considera una sobrecarga. Se separa de los cálculos de memoria normales para la memoria de contabilidad a una máquina virtual. Cuando se invoca este comando, la cantidad de memoria de host libre disminuye según el multiplicador y elHVM_shadow_multiplier
campo se actualiza con el valor que Xen ha asignado a la máquina virtual. Si no hay suficiente memoria de host libre, se devuelve un error.
Las máquinas virtuales en las que se debe realizar esta operación se seleccionan mediante el mecanismo de selección estándar. Para obtener más información, vea Selectores de VM.
vm-memory-static-range-set
vm-memory-static-range-set min = min max = max
Configure el rango de memoria estática de una máquina virtual. El rango de memoria estática define los límites inferiores y superiores de la memoria de una máquina virtual. Es posible cambiar estos campos solo cuando se detiene una máquina virtual. El rango estático debe abarcar el rango dinámico.
vm-memory-target-set
vm-memory-target-set target = objetivo
Establezca el destino de memoria para una máquina virtual detenida o en ejecución. El valor dado debe estar dentro del rango definido por los valores memory_static_min y memory_static_max de la VM.
vm-memory-target-wait
vm-memory-target-wait
Espere a que una máquina virtual en ejecución alcance su objetivo de memoria actual.
vm-migrate
vm-migrate [copy = true | false] [host-uuid = destination_host_uuid] [host = name_or_uuid_of_destination_host] [force = true | false] [live = true | false] [vm-selector = vm_selector_valor...] [remote-master = destination_pool_master_uuid] [nombredeusuario remoto = nombre_grupo_destino] [contraseña remota = contraseña_grupo_destino] [red remota = destino_grupo_red_uuid] [vif: = vif_uuid] [vdi = vdi_uuid]
Este comando migra las máquinas virtuales especificadas entre hosts físicos. Elhost
parámetro puede ser el nombre o el UUID del host. Por ejemplo, para migrar la máquina virtual a otro host del grupo, donde los discos de máquina virtual están en almacenamiento compartido por ambos hosts:
xe vm-migrate uuid = vm_uuid host-uuid = host_uuid
Para mover máquinas virtuales entre hosts del mismo grupo, que no comparten almacenamiento (almacenamiento ):
xe vm-migrate uuid = vm_uuid remote-master = 12.34.56.78 \
remote-username = nombre de usuario remote-password = contraseña \
host-uuid = desination_host_uuid vdi = vdi_uuid
Puede elegir el SR donde se almacena cada VDI:
xe vm-migrate uuid = vm_uuid host-uuid = destination_host_uuid \
vdi1: vdi_1_uuid = destination_sr_uuid \
vdi2:vdi_2_uuid=destination_sr2_uuid \
vdi3:vdi_3_uuid=destination_sr3_uuid
Además, puede elegir la red que desea conectar la máquina virtual después de la migración:
xe vm-migrate uuid = vm_uuid \
vdi1: vdi_1_uuid = destination_sr_uuid \
vdi2:vdi_2_uuid=destination_sr2_uuid \
vdi3:vdi_3_uuid=destination_sr3_uuid \
vif: vif_uuid = network_uuid
Para la migración entre pool:
xe vm-migrate uuid = vm_uuid remote-master = 12.34.56.78
remote-username = nombre de usuario remote-password = contraseña \
host-uuid = desination_host_uuid vdi = vdi_uuid
Para obtener más información sobre almacenamiento y migración de VDI en vivo, vea [Migrar máquinas virtuales con y almacenamiento /en-us/xenserver/current-release/vms/migrate.html()].
De forma predeterminada, la máquina virtual se suspende, migra y se reanuda en el otro host. Ellive
parámetro selecciona . mantiene la máquina virtual en funcionamiento mientras realiza la migración, minimizando así el tiempo de inactividad de la máquina virtual a menos de un segundo. En algunas circunstancias, como cargas de trabajo extremadamente pesadas en la máquina virtual, vuelve al modo predeterminado y suspende la máquina virtual durante un corto tiempo antes de completar la transferencia de memoria.
La máquina virtual o las máquinas virtuales en las que se realiza esta operación se seleccionan mediante el mecanismo de selección estándar. Para obtener más información, vea Selectores de VM. Los argumentos opcionales pueden ser cualquier número de parámetros de VMenumerados al principio de esta sección.
vm-pause
vm-pause
Pausa una máquina virtual en ejecución. Tenga en cuenta que esta operación no libera la memoria asociada (consultevm-suspend
).
vm-query-services
vm-query-services
Consulte los servicios del sistema ofrecidos por las máquinas virtuales dadas.
vm-reboot
vm-reboot [vm-selector = vm_selector_valor...] [fuerza = verdadero]
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, vea Selectores de VM. Los argumentos opcionales pueden ser cualquier número de parámetros de VMenumerados al principio de esta sección.
Utilice elforce
argumento para provocar un reinicio ingrácil. Donde el apagado es similar a tirar del enchufe de un servidor físico.
vm-recover
vm-recover vm-uuid [base de datos] [vdi-uuid] [fuerza]
Recupera una máquina virtual de la base de datos contenida en el VDI suministrado.
vm-reset-powerstate
vm-reset-powerstate [vm-selector = vm_selector_valor...] {force = true}
La máquina virtual o las máquinas virtuales en las que se realiza esta operación se seleccionan mediante el mecanismo de selección estándar. Para obtener más información, vea Selectores de VM. Los argumentos opcionales pueden ser cualquier número de parámetros de VMenumerados al principio de esta sección.
Este es un comando avanzado que sólo se utiliza cuando un host miembro de un grupo cae. Puede utilizar este comando para forzar al maestro de grupo a restablecer el estado de energía de las máquinas virtuales que se van ahalted
. Básicamente, este comando fuerza el bloqueo en la máquina virtual y sus discos para que pueda iniciarse a continuación en otro host de grupo. Esta llamada requiere que se especifique el indicador force y falla si no está en la línea de comandos.
vm-resume
vm-resume [vm-selector = valor_selector_valor...] [force = true | false] [on = host_uuid]
Reanudar las máquinas virtuales especificadas.
La máquina virtual o las máquinas virtuales en las que se realiza esta operación se seleccionan mediante el mecanismo de selección estándar. Para obtener más información, vea Selectores de VM. Los argumentos opcionales pueden ser cualquier número de parámetros de VMenumerados al principio de esta sección.
Si la máquina virtual está en un SR compartido en un grupo de hosts, utilice elon
argumento para especificar en qué miembro del grupo se iniciará. De forma predeterminada, el sistema determina un host adecuado, que puede ser cualquiera de los miembros del grupo.
vm-retrieve-wlb-recommendations
vm-retrieve-wlb-recommendations
Recupere las recomendaciones de equilibrio de carga de trabajo para la máquina virtual seleccionada.
vm-shutdown
vm-shutdown [vm-selector = vm_selector_valor...] [force = true | false]
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, vea Selectores de VM. Los argumentos opcionales pueden ser cualquier número de parámetros de VMenumerados al principio de esta sección.
Utilice elforce
argumento para provocar un apagado ingrácil, similar a tirar del enchufe en un servidor físico.
vm-snapshot
vm-snapshot new-name-label = name_label [new-name-description + name_description]
Instantánea de una máquina virtual existente, utilizando una operación rápida de instantáneas de disco en el nivel de almacenamiento cuando esté disponible.
vm-snapshot-with-quiesce
vm-snapshot-with-quiesce new-name-label = name_label [new-name-description + name_description]
Instantánea de una máquina virtual existente con inactividad, utilizando la operación rápida de instantáneas de disco en el nivel de almacenamiento cuando esté disponible.
vm-start
vm-start [vm-selector = valor_selector_valor...] [force = true | false] [on = host_uuid] [— multiple]
Inicie las máquinas virtuales especificadas.
La máquina virtual o las máquinas virtuales en las que se realiza esta operación se seleccionan mediante el mecanismo de selección estándar. Para obtener más información, vea Selectores de VM. Los argumentos opcionales pueden ser cualquier número de parámetros de VMenumerados al principio de esta sección.
Si las máquinas virtuales están en un SR compartido en un grupo de hosts, utilice elon
argumento para especificar en qué miembro del grupo 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
vm-suspend [vm-selector = valor_selector_valor...]
Suspender 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, vea Selectores de VM. Los argumentos opcionales pueden ser cualquier número de parámetros de VMenumerados al principio de esta sección.
vm-uninstall
vm-uninstall [vm-selector = vm_selector_valor...] [force = true | false]
Desinstale una máquina virtual, destruyendo sus discos (los VDI que están marcados como RW y conectados a esta máquina virtual solamente), así como su registro de metadatos. Para destruir solo los metadatos de VM, usexe vm-destroy
.
La máquina virtual o las máquinas virtuales en las que se realiza esta operación se seleccionan mediante el mecanismo de selección estándar. Para obtener más información, vea Selectores de VM. Los argumentos opcionales pueden ser cualquier número de parámetros de VMenumerados al principio de esta sección.
vm-unpause
vm-unpause
Anule la pausa de una máquina virtual en pausa.
vm-vcpu-hotplug
vm-vcpu-hotplug new-vcpus = new_vcpu_count [vm-selector = vm_selector_valor...]
Ajuste dinámicamente el número de vCPU disponibles para una VM Linux PV o HVM en ejecución. El número de vCPU está limitado por el parámetroVCPUs-max
. Las VM de Windows siempre se ejecutan con el número de vCPU establecido enVCPUs-max
y deben reiniciarse para cambiar este valor.
La VM o VM Linux PV o HVM en la que se realiza esta operación se seleccionan mediante el mecanismo de selección estándar. Para obtener más información, vea Selectores de VM. Los argumentos opcionales pueden ser cualquier número de parámetros de VMenumerados al principio de esta sección.
Nota:
Cuando ejecute VM Linux sin instalar, ejecute el siguiente comando en la máquina virtual
root
para asegurarse de que se utilicen las VCPU recién conectadas:# for i in /sys/devices/system/cpu/cpu[1-9]*/online; do if [ "$(cat $i)" = 0 ]; then echo 1 > $i; fi; done
vm-vif-list
vm-vif-list [vm-selector = valor_selector_valor...]
Muestra los VIF de las máquinas virtuales especificadas.
La máquina virtual o las máquinas virtuales en las que se realiza esta operación se seleccionan mediante el mecanismo de selección estándar. Para obtener más información, vea Selectores de VM. Los selectores funcionan en los registros de VM al filtrar, y no en los valores VIF. Los argumentos opcionales pueden ser cualquier número de parámetros de VMenumerados al principio de esta sección.
Instantáneas programadas
Comandos para controlar instantáneas shceduled de VM y sus atributos.
Los objetos vmss se pueden enumerar con el comando estándar de lista de objetos (xe vmss-list
) y los parámetros se pueden manipular con los comandos de parámetros estándar. Para obtener más información, consulte [Comandos#low-level-parameter-commands()de parámetros de nivel bajo]
vmss-create
vmss-create enabled = True /False name-label = name type = type frequency = frequency retained-snapshots = value name-description = description schedule: schedule
Crea una programación de instantáneas en el grupo.
Por ejemplo:
xe vmss-create retained-snapshots = 9 activado = true frequency = daily \
name-description = sample name-label = samplepolicy type = snapshot \
horario: hora = 10 horario: min = 30
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; Instantánea de memoria; Instantánea en reposo | Lectura/Escritura |
frequency |
Hora; Diariamente; Semanal | Lectura/Escritura |
retained-snapshots |
Instantáneas que se conservarán. Rango: 1-10. | Lectura/Escritura |
schedule |
schedule:days ( Lunes a Domingo),schedule:hours (0 a 23),schedule:minutes (0, 15, 30, 45) |
Lectura/Escritura |
vmss-destroy
vmss-destroy uuid = uuid
Destruye una programación de instantáneas en el grupo.
Passthrough USB
Activación/desactivación de paso USB
pusb-param-set uuid = pusb_uuid passthrough-enabled = true/false
Habilite o deshabilite el paso USB.
pusb-scan
pusb-scan host-uuid = host_uuid
Escanea PUSB y actualiza.
vusb-create
vusb-create usb-group-uuid = usb_group_uuid vm-uuid = vm_uuid
Crea un USB virtual en el grupo. Inicie la máquina virtual para pasar a través del USB a la máquina virtual.
vusb-unplug
vusb-unplug uuid = vusb_uuid
Desconecta USB de VM.
vusb-destroy
vusb-destroy uuid = vusb_uuid
Quita la lista de USB virtual de la VM.
En este artículo
- Sintaxis básica xe
- Caracteres especiales y sintaxis
- Tipos de comandos
- referencia de comando xe
- Comandos del dispositivo
- Comandos de auditoría
- Comandos de unió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 GPU
- Comandos de host
- Comandos de registro
- Comandos de mensaje
- Comandos de red
- Comandos del controlador SDN
- Comandos de túnel
- Comandos de parche
- Comandos PBD
- Comandos PIF
- Comandos de grupo
- Comandos del Acelerador PVS
- Comandos de Storage Manager
- Comandos de instantánea
- Comandos SR
- Comandos de asunto
- Comandos de tareas
- Comandos de plantilla
- Actualizar comandos
- Comandos de usuario
- Comandos VBD
- Comandos VDI
- Comandos VIF
- Comandos de VLAN
- Comandos de VM