Introduction to CLI

OpenNEbula provides two commands to interact with the system:

  • onevm: to submit, control and monitor virtual machines
  • onehost: to add, delete and monitor hosts

onevm

This command enables the user to manage virtual machines in the Open Nebula server. The user can allocate, deploy, migrate, suspend, resume and shutdown a virtual machine with the functionality present in onevm.

    onevm <command> [<parameters>]

Command Summary

submit

Submits a new virtual machine, adding it to the ONE VM pool. It requires the filename of the VM template.

    onevm submit <template>

deploy

Starts a previously submitted VM on a specific host

    onevm deploy <vm_id> <host_id>

shutdown

Shutdown an already deployed VM

    onevm shutdown <vm_id>   

livemigrate

Migrates a running VM to another host without downtime

    onevm livemigrate <vm_id> <host_id>   

migrate

Saves a running VM and starts it again in the specified host

    onevm migrate <vm_id> <host_id>

suspend

Saves a running VM

    onevm suspend <vm_id> 

resume

Resumes the execution of a saved VM

    onevm resume <vm_id>   

list

Shows VMs in the pool

    onevm list   

show

Gets information about a specific VM

    onevm show <vm_id>

Information Columns

ID ONE VM identifier
NAME Name automatically given by ONE
STAT Status of the VM
CPU CPU percentile used by the VM
MEM Memory used by the VM
HOSTNAME Host where the VM is being or was run
TIME Time since the submission of the VM (days hours:minutes:seconds

VM States

pend pending
hold VM on hold (not runnable)
stop stopped
susp suspended
done finished
prol prolog
boot booting
runn running
migr migrating
save saving the VM to disk
epil epilog
shut shutting down

onehost

This command enables the user to manage hosts in the Open Nebula server. It provides functionality to allocate, get information and delete a particular host or to list all the available hosts.

    onehost <command> [<parameters>]

Command Summary

add

Adds a new machine to the pool

    onehost add <hostname> <im_mad> <vmm_mad>

im_mad and vmm_mad as written in oned.conf.

show

Gets info from a single host

    onehost show <host_id>

delete

Removes a machine from the pool

    onehost delete <host_id>

list

Lists machines in the pool

    onehost list

Information Columns

HID Host ID
NAME Host name
RVM Running VMs
TCPU Total CPU (percentage)
FCPU Free CPU (percentage)
ACPU Available CPU (not allocated by VMs)
TMEM Total memory
FMEM Free memory