Files

101 lines
2.5 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
## 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
```uci
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
```uci
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
```uci
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
```uci
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]