virt-xml - Online na nuvem

PROGRAMA:

NOME

virt-xml - Edite libvirt XML usando opções de linha de comando.

SINOPSE

virt-xml DOMÍNIO XML-AÇÃO XML-OPÇÃO [OPÇÃO DE SAÍDA] [OPÇÕES DIVERSAS] ...

DESCRIÇÃO

virt-xml é uma ferramenta de linha de comando para editar libvirt XML usando linha de comando explícita
opções. Consulte a seção EXEMPLOS no final deste documento para começar imediatamente.

Cada virt-xml invocação requer 3 coisas: nome de um domínio existente para alterar (ou XML
transmitido stdin), uma ação para no XML e uma mudança XML a ser feita. as ações são uma das seguintes:

--add-device: acrescenta uma nova definição de dispositivo ao XML --remove-device: remove um
definição de dispositivo existente --edit: Editar um bloco XML existente --build-xml: Basta construir o
bloco XML solicitado e imprimi-lo (nenhum domínio ou XML de entrada são necessários aqui).

Uma mudança XML é uma instância de qualquer uma das opções XML fornecidas por virt-xml, por exemplo
--disk ou --boot.

virt-xml permite apenas uma ação e par XML por chamada. Se você precisar fazer vários
edições, invoque o comando várias vezes.

OPÇÕES

-c URI
--conectar= URI
Conecte-se a um hipervisor não padrão. Ver virt-instalar(1) para detalhes

domínio
domínio é o nome, UUID ou ID da VM existente. Isso pode ser omitido se usar
--build-xml, ou se XML é passado em stdin.

Quando um domínio é especificado, a ação de saída padrão é --define, mesmo se a VM for
correndo. Para atualizar a configuração da VM em execução, adicione a opção --update (mas nem todas
opções / dispositivos suportam a atualização da configuração VM em execução).

Se XML é passado em stdin, a saída padrão é --print-xml.

XML AÇÕES

--editar [EDITAR OPÇÕES]
Edite o bloco XML especificado. EDITAR OPÇÕES contar virt-xml qual bloco editar. O tipo
de XML que estamos editando é decidido pela opção XML que é passada para virt-xml. Então se
--disk foi aprovado, EDIT-OPTIONS selecione qual bloco para editar.

Certas opções XML sempre mapeiam para um único bloco XML, como --cpu, --security,
--boot, --clock e alguns outros. Nesses casos, virt-xml não reclamará se um
bloco XML correspondente ainda não existe, ele irá criá-lo para você.

A maioria das opções XML suporta um valor especial 'clearxml = yes'. Quando combinado com --edit,
irá apagar completamente o bloco XML que está sendo editado antes de aplicar o
alterar. Isso permite reconstruir completamente um bloco XML. Veja EXEMPLOS para algum uso.

Exemplos de EDIT-OPTIONS:

--editar
--editar sem nenhuma opção significa 'editar o primeiro bloco'. Então '--edit --disk
DISK-OPTIONS 'significa' editar o primeiro '.

Para as opções de bloco XML único mencionadas acima, basta '--edit' sem qualquer
options é o que você sempre deseja usar.

--editar #
Selecione o número do bloco XML especificado. Portanto, '--edit 2 --disk DISK-OPTS' significa 'editar
o segundo '. Esta opção só se aplica realmente ao XML do dispositivo.

--editar todos os
Modifique cada bloco XML do tipo de opção XML. Então '--edit all --disk DISK-OPTS'
significa 'editar sempre bloquear'. Esta opção só se aplica realmente ao XML do dispositivo.

--editar OPÇÕES DO DISPOSITIVO
Modifique cada bloco XML que corresponda às opções de dispositivo passadas. As opções do dispositivo
estão no mesmo formato que seriam passados ​​para a opção XML.

Portanto, '--edit path = / tmp / foo --disk DISK-OPTS' significa 'editar cada com caminho
/ tmp / foo '. Esta opção só se aplica realmente ao XML do dispositivo.

--Adicionar Dispositivo
Anexe as opções de XML especificadas ao XML Lista. Exemplo: '--add-device
--disk DISK-OPTIONS 'criará um novo bloquear e adicioná-lo ao XML.

Esta opção irá apresentar um erro se for especificada com uma opção XML sem dispositivo (veja a seção --edit
para uma lista parcial).

--remover dispositivo
Remova o dispositivo especificado do XML. O dispositivo a ser removido é escolhido pelo XML
opção, que recebe argumentos no mesmo formato que --edit. Exemplos

--remover dispositivo --disco 2
Remova o segundo dispositivo de disco

--remover dispositivo --rede todos
Remova todos os dispositivos de rede

--remover dispositivo --som pcspk
Remova todos os dispositivos de som com model = 'pcspk'

Esta opção irá apresentar um erro se for especificada com uma opção XML sem dispositivo (veja a seção --edit
para uma lista parcial).

--build-xml
Basta construir o XML especificado e imprimi-lo em stdout. Nenhum domínio de entrada ou XML de entrada é
obrigatório. Exemplo: '--build-xml --disk DISK-OPTIONS' imprimirá apenas o novo
dispositivo.

Esta opção irá apresentar um erro se especificada com uma opção XML que não mapeia de forma limpa para um
bloco XML específico, como --vcpus ou --memory.

SAÍDA OPÇÕES

Essas opções decidem qual ação tomar após alterar o XML. No caso comum, estes
não precisam ser especificados, pois 'ações XML' implicarão em uma ação de saída padrão,
descrito em detalhes acima. Eles são necessários apenas se você quiser modificar a saída padrão.

--atualizar
Se o domínio especificado estiver em execução, tente alterar a configuração da VM em execução. Se
combinado com --edit, esta é uma operação de atualização. Se combinado com --add-device, este
é um hotplug de dispositivo. Se combinado com --remove-device, é um hotunplug de dispositivo.

Lembre-se de que a maioria das propriedades e dispositivos XML não oferecem suporte a operações de atualização ao vivo,
portanto, não espere que tenha sucesso em todos os casos.

--definir
Defina a mudança XML solicitada. Este é normalmente o padrão se nenhuma opção de saída for
especificado, mas se uma opção --print for especificada, --define é necessário para forçar o
alterar.

--print-diff
Imprima a mudança XML gerada no formato diff unificado. Se apenas esta opção de saída for
especificado, todas as outras opções de saída são desabilitadas e nenhuma alteração persistente é feita.

--print-xml
Imprima o XML gerado em sua totalidade. Se apenas esta opção de saída for especificada, todos
outras opções de saída são desabilitadas e nenhuma mudança persistente é feita.

--confirme
Antes de definir ou atualizar o domínio, mostre o diff XML gerado e interativamente
solicitar confirmação.

XML OPÇÕES

--disco
--rede
--gráficos
--metadados
--memória
--vcpus
--CPU
--segurança
--numatune
--recursos
--relógio
--PM
--Bota
--sistema de arquivo
--controlador
--entrada
--serial
--paralelo
--canal
--console
--hostdev
--som
- watchdog
--vídeo
--cartão inteligente
--redirdev
--membalão
--tpm
--rng
--pânico
Essas opções alteram o XML para uma única classe de elementos XML. Mais completo
documentação é encontrada em virt-instalar(1).

Geralmente, essas opções são mapeadas diretamente para o XML libvirt, documentado em
<http://libvirt.org/formatdomain.html>

As strings de opções estão no formato de: --option opt = val, opt2 = val2, ... exemplo: --disk
caminho = / tmp / foo, compartilhável = ativado. As propriedades podem ser usadas com '--option opt =,', para limpar
uma configuração de cache de disco que você pode usar '--disk cache =,'

Para qualquer opção, use --option =? para ver uma lista de todas as subopções disponíveis, por exemplo:
--disk =? ou --boot =?

A saída --help também lista alguns exemplos gerais. Veja a seção EXEMPLOS abaixo para
alguns exemplos comuns.

DIVERSOS OPÇÕES

-h
--Socorro
Mostre a mensagem de ajuda e saia

--versão
Mostra o número da versão do programa e sai

-q
--quieto
Evite a saída detalhada.

-d
--depurar
Imprimir informações de depuração

EXEMPLOS

Veja uma lista de todas as subopções que --disk e --network usam

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

Mudar o do domínio 'EXEMPLO':

# virt-xml EXEMPLO --edit --metadata description = "minha nova descrição"

# Habilite o menu do dispositivo de inicialização para o domínio 'EXEMPLO':

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

Limpar o anterior definição de domínio 'winxp', altere para 'modelo de host', mas
confirme a diferença interativamente antes de salvar:

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

Mude a segunda placa de som para model = ich6 em 'fedora19', mas apenas exiba o diff:

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

Atualize a senha de cada dispositivo gráfico para 'foo' da VM em execução 'rhel6':

# virt-xml rhel6 --edit all --graphics senha = foo --update

Remova o caminho do disco do dispositivo de disco hdc:

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

Altere todos os dispositivos de disco do tipo 'disco' para usar cache = nenhum, usando XML de stdin, impressão
o novo XML para stdout.

# gato | virt-xml --edit device = disco --disk cache = nenhum

Mude o disco 'hda' IO para nativo e use a política de inicialização como 'opcional'.

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

Mude todos os dispositivos host para usar driver_name = vfio para VM 'fedora20' na conexão remota

# virt-xml --connect qemu + ssh: // remotehost / system \
fedora20 --edit all --hostdev driver_name = vfio

Dispositivo USB host Hotplug 001.003 para o domínio em execução 'fedora19':

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

Adicione um canal spicevmc ao domínio 'winxp', que estará disponível após a próxima VM
desligamento.

#virt-xml winxp --add-device --channel Spicevmc

Crie uma imagem de disco qcow10 2G e anexe-a ao 'fedora18' para a próxima inicialização da VM:

# virt-xml fedora18 --add-device\
--disk /var/lib/libvirt/images/newimage.qcow2,format=qcow2,tamanho=10

Hotunplug o disco vdb do domínio em execução 'rhel7':

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

Remova todos os dispositivos gráficos da VM 'rhel7' após o próximo desligamento:

# virt-xml rhel7 --remove-device --graphics todos

Gere XML para um dispositivo de console virtio e imprima em stdout:

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

Use virt-xml online usando serviços onworks.net