ansible.virt_boot(3) - Linux man page
Name
virt_boot - Define libvirt boot parameters
Description
This module configures the boot order or boot media of a libvirt virtual machine. A guest can be configured to boot from network, hard disk, floppy, cdrom or a direct kernel boot. Specific media can be attached for cdrom, floppy and direct kernel boot.
This module requires the libvirt module.
Options
- kernel
The path of the kernel to boot.
domain
The name of the libvirt domain.(required)
- cmdline
- The command line to boot the kernel with.
- image
The image to connect to the cdrom/floppy device.
boot
Specify the boot order of the virtual machine. This is a comma-separated list of: fd, hd, cdrom and network.
start
Start the guest after configuration. Choices: yes,no. (default: True)
initrd
The path of the initrd to boot.
device
The libvirt device name of the cdrom/floppy. (default: hdc)
- bootmenu
- Enable or disable the boot menu. Choices: yes,no.."
Notes
Run this on the libvirt host.
kernel and boot are mutually exclusive.
This module does not change a running system. A shutdown/restart is required.
Examples
virt_boot domain=archrear image=/srv/rear/archrear/rear-archrear.iso boot=cdrom virt_boot domain=archrear boot=hd virt_boot domain=archrear kernel=$storage/kernel-archrear initrd=$storage/initramfs-archrear.img cmdline="root=/dev/ram0 vga=normal rw" virt_boot domain=archrear boot=hd,network virt_boot domain=archrear bootmenu=yes
Author
Jeroen Hoekx
See Also
ansible(1), http://ansible.github.com/modules.html#virt-boot