virt-xml: en línea en la nube

PROGRAMA:

NOMBRE

virt-xml: edita el XML de libvirt mediante las opciones de la línea de comandos.

SINOPSIS

virt-xml DOMINIO XML-ACCIÓN XML-OPCIÓN [SALIDA-OPCIÓN] [MISC-OPCIONES] ...

DESCRIPCIÓN

virt-xml es una herramienta de línea de comando para editar libvirt XML usando una línea de comando explícita
opciones. Vea la sección de EJEMPLOS al final de este documento para comenzar.

Cada virt-xml la invocación requiere 3 cosas: el nombre de un dominio existente para alterar (o XML
pasado en stdin), una acción en el XML y un cambio XML para realizar. las acciones son una de:

--add-device: agrega una nueva definición de dispositivo al XML --remove-device: elimina una
definición de dispositivo existente --edit: Edite un bloque XML existente --build-xml: simplemente cree el
bloque XML solicitado e imprímalo (aquí no se requiere dominio ni XML de entrada).

Un cambio XML es una instancia de cualquiera de las opciones XML proporcionadas por virt-xml, por ejemplo
--disco o --boot.

virt-xml solo permite una acción y un par XML por invocación. Si necesita hacer varios
ediciones, invoque el comando varias veces.

OPCIONES

-c URI
--conectar= URI
Conéctese a un hipervisor no predeterminado. Ver virt-instalar(1) para más detalles

dominio
dominio es el nombre, UUID o ID de la VM existente. Esto se puede omitir si se usa
--build-xml, o si se pasa XML en stdin.

Cuando se especifica un dominio, la acción de salida predeterminada es --define, incluso si la VM es
corriendo. Para actualizar la configuración de la máquina virtual en ejecución, agregue la opción --update (pero no todas
las opciones / dispositivos admiten la actualización de la configuración de la máquina virtual en ejecución).

Si se pasa XML en stdin, la salida predeterminada es --print-xml.

XML ACCIONES

--editar [OPCIONES DE EDICIÓN]
Edite el bloque XML especificado. OPCIONES DE EDICIÓN decir virt-xml qué bloque editar. El tipo
de XML que estamos editando se decide por la opción XML que se pasa a virt-xml. Así que si
- se pasa el disco, EDIT-OPTIONS seleccione qué bloque para editar.

Ciertas opciones XML solo se asignan a un único bloque XML, como --cpu, --security,
--boot, --clock y algunos otros. En esos casos, virt-xml no se quejará si un
El bloque XML correspondiente aún no existe, lo creará por usted.

La mayoría de las opciones XML admiten un valor especial 'clearxml = yes'. Cuando se combina con --editar,
borrará completamente el bloque XML que se está editando antes de aplicar la solicitud
cambios. Esto permite reconstruir completamente un bloque XML. Vea EJEMPLOS para algunos usos.

Ejemplos de opciones de edición:

--editar
--editar sin opciones implica 'editar el primer bloque'. Entonces '--edit --disk
DISK-OPTIONS 'significa' editar el primero '.

Para las opciones de bloque XML único mencionadas anteriormente, simple '--edit' sin ningún
opciones es lo que siempre quieres usar.

--editar #
Seleccione el número de bloque XML especificado. Entonces '--edit 2 --disk DISK-OPTS' significa 'editar
el segundo '. Esta opción solo se aplica realmente a XML de dispositivo.

--editar todos
Modifique todos los bloques XML del tipo de opción XML. Entonces '--editar todo --disk DISK-OPTS'
significa 'editar siempre cuadra'. Esta opción solo se aplica realmente a XML de dispositivo.

--editar OPCIONES DEL DISPOSITIVO
Modifique todos los bloques XML que coincidan con las opciones de dispositivo aprobadas. Las opciones del dispositivo
están en el mismo formato que se pasaría a la opción XML.

Entonces '--edit path = / tmp / foo --disk DISK-OPTS' significa 'editar cada con camino
/ tmp / foo '. Esta opción solo se aplica realmente a XML de dispositivo.

--añadir dispositivo
Anexar las opciones XML especificadas al XML lista. Ejemplo: '--add-device
--disk DISK-OPTIONS 'creará un nuevo bloquear y agregarlo al XML.

Esta opción generará un error si se especifica con una opción XML que no sea del dispositivo (consulte la sección --editar
para una lista parcial).

--retire el dispositivo
Elimina el dispositivo especificado del XML. El dispositivo a eliminar es elegido por el XML
opción, que toma argumentos en el mismo formato que --edit. Ejemplos de

--retire el dispositivo --disco 2
Retire el segundo dispositivo de disco

--retire el dispositivo - red todo
Eliminar todos los dispositivos de red

--retire el dispositivo --sonido pcspk
Elimina todos los dispositivos de sonido con model = 'pcspk'

Esta opción generará un error si se especifica con una opción XML que no sea del dispositivo (consulte la sección --editar
para una lista parcial).

--construir-xml
Simplemente cree el XML especificado e imprímalo en stdout. No hay dominio de entrada ni XML de entrada
requerido. Ejemplo: '--build-xml --disk DISK-OPTIONS' simplemente imprimirá el nuevo
.

Esta opción generará un error si se especifica con una opción XML que no se asigna limpiamente a un
bloque XML específico, como --vcpus o --memory.

SALIDA OPCIONES

Estas opciones deciden qué acción tomar después de alterar el XML. En el caso común, estos
no es necesario especificarlo, ya que las 'acciones XML' implicarán una acción de salida predeterminada,
descrito en detalle arriba. Estos solo son necesarios si desea modificar la salida predeterminada.

--actualizar
Si el dominio especificado se está ejecutando, intente modificar la configuración de la máquina virtual en ejecución. Si
combinado con --edit, esta es una operación de actualización. Si se combina con --add-device, este
es un dispositivo hotplug. Si se combina con --remove-device, se trata de un dispositivo de desconexión en caliente.

Tenga en cuenta que la mayoría de las propiedades y dispositivos XML no admiten operaciones de actualización en vivo,
así que no espere que tenga éxito en todos los casos.

--definir
Defina el cambio XML solicitado. Por lo general, es el valor predeterminado si no hay ninguna opción de salida.
especificado, pero si se especifica una opción --print, se requiere --define para forzar la
a través del cambio.

--imprimir-diferencia
Imprima el cambio XML generado en formato diff unificado. Si solo esta opción de salida es
especificado, todas las demás opciones de salida están deshabilitadas y no se realizan cambios persistentes.

--imprimir-xml
Imprima el XML generado en su totalidad. Si solo se especifica esta opción de salida, todos
otras opciones de salida están deshabilitadas y no se realizan cambios persistentes.

--confirmar
Antes de definir o actualizar el dominio, muestre la diferencia XML generada e interactivamente
solicitar confirmación.

XML OPCIONES

--disco
--la red
--gráficos
--metadatos
--memoria
--vcpus
--UPC
--seguridad
--numatune
--características
--reloj
--pm
--bota
- sistema de archivos
--controlador
--aporte
--de serie
--paralelo
--canal
--consola
--hostdev
--sonido
--perro guardián
--video
--tarjeta electrónica
--redirdev
--membalón
--tpm
--rng
--pánico
Estas opciones alteran el XML para una sola clase de elementos XML. Más completo
la documentación se encuentra en virt-instalar(1).

Generalmente, estas opciones se asignan de manera bastante directa al XML de libvirt, documentado en
<http://libvirt.org/formatdomain.html>

Las cadenas de opciones tienen el formato: --option opt = val, opt2 = val2, ... ejemplo: --disk
ruta = / tmp / foo, compartible = activado. Las propiedades se pueden usar con '--option opt =,', para borrar
una configuración de caché de discos que podría usar '--disk cache =,'

Para cualquier opción, use --option =? para ver una lista de todas las subopciones disponibles, ejemplo:
--disco =? o --boot =?

--help output también enumera algunos ejemplos generales. Consulte la sección de EJEMPLOS a continuación para
algunos ejemplos comunes.

OTRO OPCIONES

-h
--ayuda
Muestre el mensaje de ayuda y salga

--versión
Mostrar el número de versión del programa y salir

-q
--tranquilo
Evite la salida detallada.

-d
--depurar
Imprimir información de depuración

EJEMPLOS

Vea una lista de todas las subopciones que toman --disk y --network

# virt-xml --disk =? --network =?

Cambiar el del dominio 'EJEMPLO':

# virt-xml EJEMPLO --edit --metadata description = "mi nueva descripción"

# Habilite el menú del dispositivo de arranque para el dominio 'EJEMPLO':

# virt-xml EJEMPLO --edit --boot menu = on

Borrar lo anterior definición de dominio 'winxp', cámbielo a 'modelo de host', pero
confirme interactivamente la diferencia antes de guardar:

# virt-xml winxp --edit --cpu host-model, clearxml = yes --confirm

Cambie la segunda tarjeta de sonido a model = ich6 en 'fedora19', pero solo genere el diff:

# virt-xml fedora19 --edit 2 --sound model = ich6 --print-diff

Actualice la contraseña de cada dispositivo gráfico a 'foo' de la máquina virtual en ejecución 'rhel6':

# virt-xml rhel6 --editar todo --graphics password = foo --update

Elimine la ruta del disco del dispositivo de disco hdc:

# virt-xml rhel6 --edit target = hdc --disk path =

Cambie todos los dispositivos de disco de tipo 'disco' para usar cache = none, usando XML de stdin, imprimiendo
el nuevo XML a stdout.

# gato | virt-xml --edit device = disk --disk cache = none

Cambie la E / S del disco 'hda' a nativo y use la política de inicio como 'opcional'.

# virt-xml fedora20 --edit target = hda \
--disk io = native, startup_policy = opcional

Cambie todos los dispositivos host para usar driver_name = vfio para VM 'fedora20' en la conexión remota

# virt-xml --connect qemu + ssh: // host remoto / sistema \
fedora20 --editar todo --hostdev driver_name = vfio

Conecte en caliente el dispositivo USB host 001.003 al dominio en ejecución 'fedora19':

# virt-xml fedora19 --update --add-device --hostdev 001.003

Agregue un canal spicevmc al dominio 'winxp', que estará disponible después de la próxima VM
apagado.

# virt-xml winxp --agregar dispositivo --channel spicevmc

Cree una imagen de disco 10G qcow2 y adjúntela a 'fedora18' para el próximo inicio de VM:

# virt-xml fedora18 --agregar dispositivo \
--disco /var/lib/libvirt/images/newimage.qcow2,format=qcow2,size=10

Desenchufe en caliente el disco vdb del dominio en ejecución 'rhel7':

# virt-xml rhel7 --update --remove-device --disk target = vdb

Elimine todos los dispositivos gráficos de la VM 'rhel7' después del próximo apagado:

# virt-xml rhel7 --remove-device --gráficos todos

Genere XML para un dispositivo de consola virtio e imprímalo en stdout:

# virt-xml --build-xml --console pty, target_type = virtio

Utilice virt-xml en línea utilizando los servicios de onworks.net