op-packages/qemu-vms/README.md

QEMU-VMS

VMS - Virtual Machine Simple

Simple manager qemu virtual machines

UCI configuration

All setting stored in /etc/config/qemu-vms

config vm — virtual machine instanse

Option	Type	Desc	Default
enabled	boolean	Enable start	0
image	string	Image Disk path	–
cdrom	string	ISO-image path	–
memory	integer	RAM Size in MB	128
smp	integer	vCPU's	1
cpu*	string	CPU model	host
machine*	string	Chipset machine type	q35
disk_bus	string	Disk Bus	virtio
display_type	string	Console type	serial
vnc_port	integer	VNC-port if display_type=vnc	–
pci_passthrough	list	list pci devices passthrough	–
usb_passthrough	list	list usb devices passthrough	–
network	list	attached virtual network adapters	-
custom_arg	list	Addional QEMU cmd args	–

Example

config vm 'router'
    option enabled '1'
    option image '/path/to/disk.img'
    option memory '512'
    option smp '2'
    option cpu 'host'
    option machine 'q35'
    option disk_bus 'virtio'
    option display_type 'serial'
    list network 'example_lan'
    list pci_passthrough 'pci_example'
    list usb_passthrough 'usb_example'
    list custom_arg '-drive if=floppy,file=/mnt/disk/vm/floppy_xp.img,format=raw'

config network — virtual machine network adapters

Option	Type	Desc	Default
mac	string	adapter mac-address	-
bridge	string	assign to bridge name	-
ifname**	string	iface name in host	-
driver	string	guest network adapter driver	vfio-net-pci

Example

config network 'example_lan'
	option iface 'tap0'
	option bridge 'br-vm'
	option driver 'pcnet'

config pci_passthrough — Passthrough PCI devices

Option	Type	Desc
pci_id**	string	device BDF-addres
vendor_id	string	Vendor:Device ID

Example

config pci-passthrough 'pci_example'
    option pci_id '03:00.0'
    option vendor_id '8086 15f3'

config usb_passthrough — Passthrough USB devices

Option	Type	Desc
product_id**	string	Product device ID
vendor_id**	string	Vendor Device ID

Example

config usb_passthrough 'usb_example'
    option vendor_id '0bda'
    option product_id 'c811'

* - See help qemu for list all values **- Mandatory options

Usage init.d

• /etc/init.d/qemu-vms start|stop|restart [vm_instance]