virt-xml - ออนไลน์ใน Cloud

โครงการ:

ชื่อ

virt-xml - แก้ไข libvirt XML โดยใช้ตัวเลือกบรรทัดคำสั่ง

เรื่องย่อ

คุณธรรม xml DOMAIN XML-ACTION XML-OPTION [OUTPUT-OPTION] [ตัวเลือกเบ็ดเตล็ด] ...

DESCRIPTION

คุณธรรม xml เป็นเครื่องมือบรรทัดคำสั่งสำหรับแก้ไข libvirt XML โดยใช้บรรทัดคำสั่งที่ชัดเจน
ตัวเลือก. ดูส่วนตัวอย่างที่ส่วนท้ายของเอกสารนี้เพื่อข้ามไป

แต่ละ คุณธรรม xml การเรียกต้องการ 3 สิ่ง: ชื่อของโดเมนที่มีอยู่เพื่อแก้ไข (หรือ XML
ส่งผ่านบน stdin) การดำเนินการกับ XML และการเปลี่ยนแปลง XML ที่ต้องทำ การกระทำเป็นหนึ่งใน:

--add-device: ผนวกข้อกำหนดอุปกรณ์ใหม่เข้ากับ XML --remove-device: Remove an
คำจำกัดความอุปกรณ์ที่มีอยู่ --แก้ไข: แก้ไขบล็อก XML ที่มีอยู่ --build-xml: เพียงแค่สร้าง
ขอบล็อก XML และพิมพ์ (ไม่จำเป็นต้องมีโดเมนหรืออินพุต XML ที่นี่)

การเปลี่ยนแปลง XML เป็นอินสแตนซ์หนึ่งของตัวเลือก XML ที่จัดเตรียมโดย virt-xml ตัวอย่างเช่น
--disk หรือ --boot

คุณธรรม xml อนุญาตเพียงหนึ่งการกระทำและคู่ XML ต่อการเรียกใช้ หากคุณต้องการทำหลายรายการ
แก้ไข เรียกใช้คำสั่งหลายครั้ง

OPTIONS

-c URI
--เชื่อมต่อ=ยูริ
เชื่อมต่อกับไฮเปอร์ไวเซอร์ที่ไม่ใช่ค่าเริ่มต้น ดู คุณธรรมติดตั้ง(1) สำหรับรายละเอียด

โดเมน
โดเมนคือชื่อ, UUID หรือ ID ของ VM ที่มีอยู่ สามารถละเว้นได้หากใช้
--build-xml หรือถ้าส่งผ่าน XML บน stdin

เมื่อระบุโดเมน การดำเนินการเอาต์พุตเริ่มต้นคือ --define แม้ว่า VM จะเป็น
วิ่ง. หากต้องการอัปเดตการกำหนดค่า VM ที่ทำงานอยู่ ให้เพิ่มตัวเลือก --update (แต่ไม่ใช่ทั้งหมด
ตัวเลือก/อุปกรณ์รองรับการอัปเดตการกำหนดค่า VM ที่ทำงานอยู่)

หากส่ง XML บน stdin เอาต์พุตเริ่มต้นคือ --print-xml

XML การกระทำ

--แก้ไข [แก้ไข-ตัวเลือก]
แก้ไขบล็อก XML ที่ระบุ แก้ไข-ตัวเลือก บอก คุณธรรม xml บล็อกที่จะแก้ไข ประเภท
ของ XML ที่เรากำลังแก้ไขนั้นตัดสินโดยตัวเลือก XML ที่ส่งผ่านไปยัง คุณธรรม xml. ดังนั้นถ้า
--disk ถูกส่งผ่าน EDIT-OPTIONS เลือก which บล็อกที่จะแก้ไข

ตัวเลือก XML บางตัวจะจับคู่กับบล็อก XML เดียวเท่านั้น เช่น --cpu, --security,
--boot, --clock และอื่น ๆ อีกสองสามรายการ ในกรณีดังกล่าว คุณธรรม xml จะไม่บ่นถ้า
บล็อก XML ที่เกี่ยวข้องไม่มีอยู่แล้ว มันจะสร้างบล็อกให้คุณ

ตัวเลือก XML ส่วนใหญ่รองรับค่าพิเศษ 'clearxml=yes' เมื่อรวมกับ --edit, it
จะทำให้บล็อก XML ว่างเปล่าโดยสมบูรณ์ก่อนที่จะใช้คำขอ
การเปลี่ยนแปลง ซึ่งช่วยให้สร้างบล็อก XML ใหม่ได้อย่างสมบูรณ์ ดู ตัวอย่าง สำหรับการใช้งานบางอย่าง

แก้ไข-ตัวเลือก ตัวอย่าง:

--แก้ไข
--แก้ไขโดยไม่มีตัวเลือกใด ๆ หมายถึง 'แก้ไขบล็อกแรก' ดังนั้น '--edit --disk
DISK-OPTIONS' หมายถึง 'แก้ไขครั้งแรก '.

สำหรับตัวเลือกบล็อก XML เดียวที่กล่าวถึงข้างต้น ให้ '--แก้ไข' ธรรมดาโดยไม่มีใดๆ
ตัวเลือกคือสิ่งที่คุณต้องการใช้เสมอ

--แก้ไข #
เลือกหมายเลขบล็อก XML ที่ระบุ ดังนั้น '--edit 2 --disk DISK-OPTS' หมายถึง 'แก้ไข
ที่สอง '. ตัวเลือกนี้ใช้ได้กับ XML ของอุปกรณ์เท่านั้น

--แก้ไข ทั้งหมด
แก้ไขทุกบล็อก XML ของประเภทตัวเลือก XML ดังนั้น '--แก้ไขทั้งหมด --disk DISK-OPTS'
แปลว่า 'แก้ไขเลยทีเดียว บล็อก'. ตัวเลือกนี้ใช้ได้กับ XML ของอุปกรณ์เท่านั้น

--แก้ไข อุปกรณ์-ตัวเลือก
แก้ไขทุกบล็อก XML ที่ตรงกับตัวเลือกอุปกรณ์ที่ส่งผ่าน ตัวเลือกอุปกรณ์
อยู่ในรูปแบบเดียวกับที่จะถูกส่งไปยังตัวเลือก XML

ดังนั้น '--edit path=/tmp/foo --disk DISK-OPTS' หมายถึง 'แก้ไขทุกๆ กับเส้นทาง
/tmp/foo'. ตัวเลือกนี้ใช้ได้กับ XML ของอุปกรณ์เท่านั้น

--เพิ่มอุปกรณ์
ผนวกตัวเลือก XML ที่ระบุต่อท้าย XML รายการ. ตัวอย่าง: '--add-device
--disk DISK-OPTIONS' จะสร้างใหม่ บล็อกและเพิ่มลงใน XML

ตัวเลือกนี้จะเกิดข้อผิดพลาดหากระบุด้วยตัวเลือก XML ที่ไม่ใช่อุปกรณ์ (ดู -- แก้ไขส่วน
สำหรับรายการบางส่วน)

--remo-device
ลบอุปกรณ์ที่ระบุออกจาก XML XML . เลือกอุปกรณ์ที่จะนำออก
ตัวเลือกซึ่งรับอาร์กิวเมนต์ในรูปแบบเดียวกับ --edit ตัวอย่าง

--remo-device --disk2
ถอดอุปกรณ์ดิสก์ที่สอง

--remo-device --เครือข่ายทั้งหมด
ลบอุปกรณ์เครือข่ายทั้งหมด

--remo-device --เสียง pcspk
ถอดอุปกรณ์เสียงทั้งหมดที่มี model='pcspk'

ตัวเลือกนี้จะเกิดข้อผิดพลาดหากระบุด้วยตัวเลือก XML ที่ไม่ใช่อุปกรณ์ (ดู -- แก้ไขส่วน
สำหรับรายการบางส่วน)

--build-xml
เพียงสร้าง XML ที่ระบุ แล้วพิมพ์ไปที่ stdout ไม่มีโดเมนอินพุตหรืออินพุต XML is
ที่จำเป็น. ตัวอย่าง: '--build-xml --disk DISK-OPTIONS' จะพิมพ์ใหม่
เครื่อง

ตัวเลือกนี้จะเกิดข้อผิดพลาดหากระบุด้วยตัวเลือก XML ที่ไม่ได้แมปกับ a . อย่างหมดจด
บล็อก XML เฉพาะ เช่น --vcpus หรือ --memory

เอาท์พุท OPTIONS

ตัวเลือกเหล่านี้กำหนดการดำเนินการหลังจากแก้ไข XML ในกรณีทั่วไปเหล่านี้
ไม่จำเป็นต้องระบุ เนื่องจาก 'การดำเนินการ XML' จะหมายถึงการดำเนินการเอาต์พุตเริ่มต้น
อธิบายไว้ในรายละเอียดข้างต้น สิ่งเหล่านี้จำเป็นเฉพาะในกรณีที่คุณต้องการแก้ไขเอาต์พุตเริ่มต้น

--อัปเดต
หากโดเมนที่ระบุกำลังทำงานอยู่ ให้พยายามแก้ไขการกำหนดค่า VM ที่ทำงานอยู่ ถ้า
รวมกับ --edit นี่คือการดำเนินการอัปเดต หากรวมกับ --add-device นี่
เป็นอุปกรณ์ฮ็อตปลั๊ก หากรวมกับ --remove-device นี่คือ hotunplug ของอุปกรณ์

โปรดทราบว่าคุณสมบัติและอุปกรณ์ XML ส่วนใหญ่ไม่รองรับการดำเนินการอัปเดตสด
ดังนั้นอย่าหวังว่าจะประสบความสำเร็จในทุกกรณี

--กำหนด
กำหนดการเปลี่ยนแปลง XML ที่ร้องขอ โดยทั่วไปจะเป็นค่าเริ่มต้นหากไม่มีตัวเลือกเอาต์พุตเป็น
ระบุ แต่ถ้ามีการระบุตัวเลือก --print --define จะต้องบังคับ
เปลี่ยนแปลง

--พิมพ์-diff
พิมพ์การเปลี่ยนแปลง XML ที่สร้างขึ้นในรูปแบบ diff แบบรวม หากตัวเลือกเอาต์พุตนี้เป็นเพียง
ระบุ ตัวเลือกเอาต์พุตอื่น ๆ ทั้งหมดถูกปิดใช้งานและไม่มีการเปลี่ยนแปลงถาวร

--พิมพ์-xml
พิมพ์ XML ที่สร้างขึ้นอย่างครบถ้วน หากระบุเฉพาะตัวเลือกเอาต์พุตนี้ all
ตัวเลือกเอาต์พุตอื่น ๆ ถูกปิดใช้งานและไม่มีการเปลี่ยนแปลงอย่างต่อเนื่อง

--ยืนยัน
ก่อนกำหนดหรืออัปเดตโดเมน ให้แสดงส่วนต่าง XML ที่สร้างขึ้นและโต้ตอบ
ขอคำยืนยัน

XML OPTIONS

--ดิสก์
--เครือข่าย
--กราฟิก
--ข้อมูลเมตา
--หน่วยความจำ
--vcpus
--ซีพียู
--ความปลอดภัย
--นุมาตุเนะ
--คุณสมบัติ
--นาฬิกา
--น
--บูต
--ระบบไฟล์
--ตัวควบคุม
--ป้อนข้อมูล
--ซีเรียล
--ขนาน
--ช่อง
--คอนโซล
--hostdev
--เสียง
--สุนัขเฝ้าบ้าน
--วิดีโอ
--สมาร์ทการ์ด
--redirdev
--เมมบอลลูน
--tpm
--รง
--ตื่นตกใจ
ตัวเลือกเหล่านี้เปลี่ยน XML สำหรับองค์ประกอบ XML คลาสเดียว สมบูรณ์ยิ่งขึ้น
พบเอกสารใน คุณธรรมติดตั้ง(1)

โดยทั่วไปตัวเลือกเหล่านี้แมปค่อนข้างตรงไปตรงมากับ libvirt XML ซึ่งบันทึกไว้ที่
<http://libvirt.org/formatdomain.html>

สตริงตัวเลือกอยู่ในรูปแบบ: --option opt=val,opt2=val2,... ตัวอย่าง: --disk
เส้นทาง=/tmp/foo,shareable=on. คุณสมบัติสามารถใช้กับ '--option opt=,' ดังนั้นเพื่อล้าง
การตั้งค่าแคชดิสก์ที่คุณสามารถใช้ '--disk cache=,'

สำหรับตัวเลือกใด ๆ ให้ใช้ --option=? เพื่อดูรายการตัวเลือกย่อยที่มีทั้งหมด เช่น
--disk=? หรือ --boot=?

--help output ยังแสดงตัวอย่างทั่วไปสองสามตัวอย่าง ดูส่วนตัวอย่างด้านล่างสำหรับ
ตัวอย่างทั่วไปบางส่วน

เบ็ดเตล็ด OPTIONS

-h
--ช่วยด้วย
แสดงข้อความช่วยเหลือและออก

--รุ่น
แสดงหมายเลขเวอร์ชันของโปรแกรมและออก

-q
--เงียบ
หลีกเลี่ยงเอาต์พุตแบบละเอียด

-d
--debug
พิมพ์ข้อมูลการดีบัก

ตัวอย่าง

ดูรายการตัวเลือกย่อยทั้งหมดที่ --disk และ --network take

# virt-xml --disk=? --เครือข่าย=?

เปลี่ยน ของโดเมน 'ตัวอย่าง':

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

# เปิดใช้งานเมนูอุปกรณ์บูตสำหรับโดเมน 'ตัวอย่าง':

# virt-xml ตัวอย่าง --edit --boot menu=on

ล้างข้อมูลก่อนหน้านี้ คำจำกัดความของโดเมน 'winxp' เปลี่ยนเป็น 'host-model' แต่
ยืนยันส่วนต่างแบบโต้ตอบก่อนบันทึก:

# virt-xml winxp --แก้ไข --cpu โฮสต์โมเดล clearxml=yes --confirm

เปลี่ยนการ์ดเสียงตัวที่สองเป็น model=ich6 บน 'fedora19' แต่ส่งออกเฉพาะส่วนต่าง:

# virt-xml fedora19 --แก้ไข 2 --sound model=ich6 --print-diff

อัปเดตรหัสผ่านอุปกรณ์กราฟิกทุกตัวเป็น 'foo' ของ VM ที่รันอยู่ 'rhel6':

# virt-xml rhel6 - แก้ไขทั้งหมด -- รหัสผ่านกราฟิก = foo -- อัปเดต

ลบเส้นทางของดิสก์ออกจากอุปกรณ์ดิสก์ hdc:

# virt-xml rhel6 --แก้ไขเป้าหมาย = hdc --disk เส้นทาง =

เปลี่ยนอุปกรณ์ดิสก์ทั้งหมดประเภท 'disk' เพื่อใช้ cache=none โดยใช้ XML จาก stdin, printing
XML ใหม่เป็น stdout

# แมว | virt-xml --edit device=disk --disk cache=none

เปลี่ยนดิสก์ 'hda' IO เป็นเนทีฟและใช้นโยบายการเริ่มต้นเป็น 'ทางเลือก'

# virt-xml fedora20 --แก้ไขเป้าหมาย=hda \
--disk io=native,startup_policy=ทางเลือก

เปลี่ยนอุปกรณ์โฮสต์ทั้งหมดเพื่อใช้ driver_name=vfio สำหรับ VM 'fedora20' บนการเชื่อมต่อระยะไกล

# virt-xml -- เชื่อมต่อ qemu+ssh://remotehost/system \
fedora20 --แก้ไขทั้งหมด --hostdev driver_name=vfio

Hotplug อุปกรณ์โฮสต์ USB 001.003 เพื่อใช้งานโดเมน 'fedora19':

# virt-xml fedora19 -- อัปเดต -- เพิ่มอุปกรณ์ --hostdev 001.003

เพิ่มช่อง spicevmc ให้กับโดเมน 'winxp' ซึ่งจะใช้งานได้หลังจาก VM . ถัดไป
การปิด

# virt-xml winxp --เพิ่มอุปกรณ์ --channel Spicevmc

สร้างภาพดิสก์ 10G qcow2 และแนบไปกับ 'fedora18' สำหรับการเริ่มต้น VM ครั้งถัดไป:

# virt-xml fedora18 --เพิ่มอุปกรณ์ \
--disk /var/lib/libvirt/images/newimage.qcow2,format=qcow2,ขนาด=10

Hotunplug ดิสก์ vdb จากโดเมนที่ทำงานอยู่ 'rhel7':

# virt-xml rhel7 --update --remove-device --disk เป้าหมาย = vdb

ลบอุปกรณ์กราฟิกทั้งหมดออกจาก VM 'rhel7' หลังจากปิดระบบครั้งถัดไป:

# virt-xml rhel7 --remove-device -- กราฟิกทั้งหมด

สร้าง XML สำหรับอุปกรณ์คอนโซล virtio และพิมพ์ไปยัง stdout:

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

ใช้ virt-xml ออนไลน์โดยใช้บริการ onworks.net