virt-xml - Dalam talian di Awan

JADUAL:

NAMA

virt-xml - Edit libvirt XML menggunakan pilihan baris arahan.

SINOPSIS

virt-xml DOMAIN XML-ACTION XML-OPTION [OUTPUT-OPTION] [PILIHAN-PILIHAN] ...

DESCRIPTION

virt-xml ialah alat baris arahan untuk mengedit libvirt XML menggunakan baris arahan eksplisit
pilihan. Lihat bahagian CONTOH di penghujung dokumen ini untuk terus masuk.

setiap virt-xml invocation memerlukan 3 perkara: nama domain sedia ada untuk diubah (atau XML
diluluskan pada stdin), tindakan pada XML dan perubahan XML untuk dibuat. tindakan adalah salah satu daripada:

--add-device: Tambahkan definisi peranti baharu pada XML --remove-device: Alih keluar
definisi peranti sedia ada --edit: Edit blok XML sedia ada --build-xml: Bina sahaja
meminta blok XML dan mencetaknya (tiada domain atau input XML diperlukan di sini).

Perubahan XML ialah satu contoh daripada mana-mana pilihan XML yang disediakan oleh virt-xml, sebagai contoh
--cakera atau --boot.

virt-xml hanya membenarkan satu tindakan dan pasangan XML setiap seruan. Jika anda perlu membuat berbilang
suntingan, gunakan arahan itu beberapa kali.

PILIHAN

-c URI
--sambung=URI
Sambung ke hipervisor bukan lalai. Lihat install-install(1) untuk butiran

domain
domain ialah nama, UUID atau ID VM sedia ada. Ini boleh ditinggalkan jika menggunakan
--build-xml, atau jika XML dihantar pada stdin.

Apabila domain ditentukan, tindakan output lalai ialah --define, walaupun VM adalah
berlari. Untuk mengemas kini konfigurasi VM yang sedang berjalan, tambahkan pilihan --update (tetapi bukan semua
pilihan/peranti menyokong mengemas kini konfigurasi VM yang sedang berjalan).

Jika XML dihantar pada stdin, output lalai ialah --print-xml.

XML TINDAKAN

--edit [EDIT-OPSYEN]
Edit blok XML yang ditentukan. EDIT-OPTIONS beritahu virt-xml blok mana yang hendak diedit. Jenis
XML yang sedang kami sunting ditentukan oleh pilihan XML yang dihantar kepada virt-xml. Jadi kalau
--disk diluluskan, EDIT-OPTIONS pilih yang mana blok untuk mengedit.

Pilihan XML tertentu hanya pernah dipetakan ke blok XML tunggal, seperti --cpu, --security,
--boot, --clock, dan beberapa yang lain. Dalam kes tersebut, virt-xml tidak akan merungut jika a
blok XML yang sepadan belum wujud, ia akan menciptanya untuk anda.

Kebanyakan pilihan XML menyokong nilai khas 'clearxml=yes'. Apabila digabungkan dengan --edit, ia
akan mengosongkan sepenuhnya blok XML yang sedang diedit sebelum menggunakan yang diminta
perubahan. Ini membenarkan membina semula blok XML sepenuhnya. Lihat CONTOH untuk beberapa kegunaan.

EDIT-OPTIONS contoh:

--edit
--edit tanpa sebarang pilihan membayangkan 'edit blok pertama'. Jadi '--edit --disk
DISK-OPTIONS' bermaksud 'edit yang pertama '.

Untuk pilihan blok XML tunggal yang dinyatakan di atas, '--edit' biasa tanpa sebarang
pilihan adalah perkara yang anda sentiasa mahu gunakan.

--edit #
Pilih nombor blok XML yang ditentukan. Jadi '--edit 2 --disk DISK-OPTS' bermaksud 'edit
yang kedua '. Pilihan ini hanya benar-benar digunakan untuk XML peranti.

--edit semua
Ubah suai setiap blok XML jenis pilihan XML. Jadi '--edit semua --disk DISK-OPTS'
bermaksud 'edit pernah blok'. Pilihan ini hanya benar-benar digunakan untuk XML peranti.

--edit PILIHAN PERANTI
Ubah suai setiap blok XML yang sepadan dengan pilihan peranti yang diluluskan. Pilihan peranti
berada dalam format yang sama seperti yang akan dihantar kepada pilihan XML.

Jadi '--edit path=/tmp/foo --disk DISK-OPTS' bermaksud 'edit every dengan laluan
/tmp/foo'. Pilihan ini hanya benar-benar digunakan untuk XML peranti.

--Tambah peranti
Tambahkan pilihan XML yang ditentukan pada XML senarai. Contoh: '--tambah-peranti
--disk DISK-OPTIONS' akan mencipta yang baharu blok dan tambahkannya pada XML.

Pilihan ini akan ralat jika dinyatakan dengan pilihan XML bukan peranti (lihat bahagian --edit
untuk senarai separa).

--alih keluar-peranti
Alih keluar peranti yang ditentukan daripada XML. Peranti untuk dialih keluar dipilih oleh XML
pilihan, yang mengambil hujah dalam format yang sama seperti --edit. Contoh

--alih keluar-peranti --cakera 2
Keluarkan peranti cakera kedua

--alih keluar-peranti --rangkaian semua
Alih keluar semua peranti rangkaian

--alih keluar-peranti --bunyi pcspk
Alih keluar semua peranti bunyi dengan model='pcspk'

Pilihan ini akan ralat jika dinyatakan dengan pilihan XML bukan peranti (lihat bahagian --edit
untuk senarai separa).

--build-xml
Hanya bina XML yang ditentukan, dan cetak ke stdout. Tiada domain input atau input XML
diperlukan. Contoh: '--build-xml --disk DISK-OPTIONS' hanya akan mencetak yang baharu
peranti.

Pilihan ini akan ralat jika dinyatakan dengan pilihan XML yang tidak dipetakan dengan bersih ke a
blok XML tertentu, seperti --vcpus atau --memory.

OUTPUT PILIHAN

Pilihan ini menentukan tindakan yang perlu diambil selepas mengubah XML. Dalam kes biasa ini
tidak perlu dinyatakan, kerana 'tindakan XML' akan membayangkan tindakan keluaran lalai,
diterangkan secara terperinci di atas. Ini hanya diperlukan jika anda ingin mengubah suai output lalai.

- kemas kini
Jika domain yang ditentukan sedang berjalan, cuba ubah konfigurasi VM yang sedang berjalan. Jika
digabungkan dengan --edit, ini ialah operasi kemas kini. Jika digabungkan dengan --add-device, ini
ialah palam panas peranti. Jika digabungkan dengan --remove-device, ini ialah palam hotunplug peranti.

Perlu diingat, kebanyakan sifat dan peranti XML tidak menyokong operasi kemas kini secara langsung,
jadi jangan harap ia berjaya dalam semua kes.

--takrifkan
Tentukan perubahan XML yang diminta. Ini biasanya lalai jika tiada pilihan output
ditentukan, tetapi jika pilihan --print ditentukan, --define diperlukan untuk memaksa
berubah.

--cetak-perbezaan
Cetak perubahan XML yang dijana dalam format perbezaan bersatu. Jika hanya pilihan output ini
ditentukan, semua pilihan output lain dilumpuhkan dan tiada perubahan berterusan dibuat.

--print-xml
Cetak XML yang dijana secara keseluruhannya. Jika hanya pilihan output ini ditentukan, semua
pilihan keluaran lain dilumpuhkan dan tiada perubahan berterusan dibuat.

--confirm
Sebelum mentakrifkan atau mengemas kini domain, tunjukkan perbezaan XML yang dijana dan secara interaktif
minta pengesahan.

XML PILIHAN

--cakera
--rangkaian
--grafik
--metadata
--ingatan
--vcpus
--CPU
--keselamatan
--numatune
--ciri-ciri
--jam
--pm
--but
--sistem fail
--pengawal
--input
--siri
--selari
--saluran
--konsol
--hostdev
--bunyi
--anjing pengawas
--video
--kad pintar
--redirdev
--membalun
--tpm
--rng
--panik
Pilihan ini mengubah XML untuk satu kelas elemen XML. Lebih lengkap
dokumentasi terdapat dalam install-install(1).

Secara amnya pilihan ini memetakan dengan jelas kepada XML libvirt, didokumenkan di
<http://libvirt.org/formatdomain.html>

Rentetan pilihan adalah dalam format: --option opt=val,opt2=val2,... contoh: --disk
path=/tmp/foo,shareable=on. Sifat boleh digunakan dengan '--option opt=,', jadi untuk mengosongkan
tetapan cache cakera yang anda boleh gunakan '--disk cache=,'

Untuk sebarang pilihan, gunakan --option=? untuk melihat senarai semua sub pilihan yang tersedia, contoh:
--cakera=? atau --boot=?

--help output juga menyenaraikan beberapa contoh umum. Lihat bahagian CONTOH di bawah untuk
beberapa contoh biasa.

PELBAGAI PILIHAN

-h
- membantu
Tunjukkan mesej bantuan dan keluar

--versi
Tunjukkan nombor versi program dan keluar

-q
--senyap
Elakkan keluaran bertele-tele.

-d
--nyahpepijat
Cetak maklumat penyahpepijatan

CONTOH

Lihat senarai semua subpilihan yang --disk dan --network ambil

# virt-xml --disk=? --rangkaian=?

Tukar domain 'CONTOH':

# virt-xml CONTOH --edit --metadata description="my new description"

# Dayakan menu peranti but untuk domain 'CONTOH':

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

Kosongkan yang sebelumnya takrif domain 'winxp', tukar kepada 'model hos', tetapi
secara interaktif mengesahkan perbezaan sebelum menyimpan:

# virt-xml winxp --edit --model hos cpu,clearxml=ya --sahkan

Tukar kad bunyi kedua kepada model=ich6 pada 'fedora19', tetapi hanya keluarkan perbezaannya:

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

Kemas kini setiap kata laluan peranti grafik kepada 'foo' VM 'rhel6' yang sedang berjalan:

# virt-xml rhel6 --edit semua --kata laluan grafik=foo --kemas kini

Alih keluar laluan cakera daripada hdc peranti cakera:

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

Tukar semua peranti cakera jenis 'cakera' untuk menggunakan cache=none, menggunakan XML dari stdin, percetakan
XML baharu untuk stdout.

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

Tukar cakera 'hda' IO kepada asli dan gunakan dasar permulaan sebagai 'pilihan'.

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

Tukar semua peranti hos untuk menggunakan driver_name=vfio untuk VM 'fedora20' pada sambungan jauh

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

Hotplug hos peranti USB 001.003 untuk menjalankan domain 'fedora19':

# virt-xml fedora19 --kemas kini --tambah-peranti --hostdev 001.003

Tambahkan saluran spicevmc pada domain 'winxp', yang akan tersedia selepas VM seterusnya
penutupan.

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

Buat imej cakera qcow10 2G dan lampirkan pada 'fedora18' untuk permulaan VM seterusnya:

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

Hotunplug cakera vdb dari domain yang sedang berjalan 'rhel7':

# virt-xml rhel7 --kemas kini --buang-peranti --sasaran cakera=vdb

Alih keluar semua peranti grafik daripada VM 'rhel7' selepas penutupan seterusnya:

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

Hasilkan XML untuk peranti konsol virtio dan cetaknya ke stdout:

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

Gunakan virt-xml dalam talian menggunakan perkhidmatan onworks.net