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