VMS(1)

NAME

vms - a command for managing and creating virtual machines

SYNOPSIS

vms [option]

DESCRIPTION

The vms command is used for creating and managing qemu virtual machines. The configuration for all the user's virtual machines is stored under the ~/.vms directory. There is a per user configuration file ~/.vms/vms.conf that stores the settings for all the user's virtual machines. See vms.conf(5) for more information about virtual machine configuration.

OPTIONS

list
    List the current user's virtual machines

create vm
    Create a virtual machine named vm

info vm
    Display the configuration of vm as defined in ~/.vms/vms.conf

conf vm key value
    Edit the configuration of vm in ~/.vms/vms.conf. Add a new line or modify an existing line to this vm[key]=value. Use this syntax `vms conf vm key '"value"'` to create this line vm[key]="value". The special value -- can be used to delete the key line.

status vm
    Display the running status of vm

start vm
    Start the virtual machine named vm

stop vm [timeout]
    Stop the vm virtual machine by sending it an ACPI system shutdown event

restart vm [timeout]
    Restart vm by calling stop and start

kill vm
    Forcibly kill the qemu process for vm

vnc vm [-v]
    Connect to the VNC console, if vm is configured with one. If -v is specified, the stdout of vncviewer is shown

serial vm
    Connect to the serial console, if vm is configured with one

monitor vm
    Connect to the qemu monitor console, if vm is configured with one

log vm
    Show the vm's log, if vm is configured with one

EXAMPLES

As a normal user, create a virtual machine named bvm

    vms create bvm

Edit ~/.vms/vms.conf. See the example in vms.conf(5). Additionaly, the conf option can be used like this

    vms conf bvm mem 2048
    vms conf bvm smp 2
    vms conf bvm disk0 ~/.vms/bvm/disk0.img
    vms conf bvm bootcd '"$VAR_IN_VMS_CONF/install-dvd.iso"'

Any key can be deleted like this

    vms conf bvm bootcd --

Show information about bvm and it's running status

    vms info bvm
    vms status bvm

To start, stop or kill bvm

    vms start bvm
    vms stop bvm
    vms kill bvm

To connect to the qemu monitor or VNC server, if these are configured

    vms monitor bvm
    vms vnc bvm

DEDICATION

    Gb Z.
    gb lbh, zl ybir

SEE ALSO

vms.conf(5), rc.vms(8), vms-tutorial(7)

AUTHORS
Nikos Giotis <nikos.giotis@gmail.com>.