OPENNEBULA(8) System Administration Utilities OPENNEBULA(8) NAME OpenNebula - OpenNebula Virtual Machine command SYNOPSIS onevm [<options>] <command> [<parameters>] DESCRIPTION This command enables the user to manage virtual machines in the ONE server. The user can allocate, deploy, migrate, suspend, resume and shutdown a virâ< tual machine with the functionality present in onevm. OPTIONS -l, --list x,y,z Selects columns to display with list command --list-columns Information about the columns available to display, order or filter -o, --order x,y,z Order by these columns, column starting with - means decreasing order -f, --filter x,y,z Filter data. An array is specified with column=value pairs. -d, --delay seconds Sets the delay in seconds for top command -x, --xml Returns xml instead of human readable text -t, --type type Image type -v, --verbose Tells more information if the command is successful -h, --help Shows this help message --version Shows version and copyright information COMMANDS create (Submits a new virtual machine, adding it to the ONE VM pool) onevm create <template> template is a file name where the VM description is located deploy (Start a previously submitted VM in an 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> hold (Sets a VM to hold state, scheduler will not deploy it) onevm hold <vm_id> release (Releases a VM from hold state) onevm release <vm_id> stop (Stops a running VM) onevm stop <vm_id> cancel (Cancels a running VM) onevm cancel <vm_id> suspend (Saves a running VM) onevm suspend <vm_id> resume (Resumes the execution of a saved VM) onevm resume <vm_id> saveas (Set the specified vms disk to be saved in a new image (image_name) when the vm shuts down) onevm saveas <vm_id> <disk_id> <image_name> (Set a different type for the new Image) onevm saveas <vm_id> <disk_id> <image_name> -t/--type <type> delete (Deletes a VM from the pool and DB) onevm delete <vm_id> restart (Resubmits the VM after failure) onevm restart <vm_id> list (Shows VMs in the pool) onevm list <filter_flag> where filter_flag can be a, all --> all the known VMs m, mine --> the VMs belonging to the user in ONE_AUTH uid --> VMs of the user identified by this uid user --> VMs of the user identified by the username show (Gets information about a specific VM) onevm show <vm_id> top (Lists VMs continuously) onevm top history (Gets history from VMs) onevm history [<vm_id> <vm_id> ...] if no vm_id is provided it will list history for all known VMs Information Columns: ID ONE VM identifier USER Username of the VM owner NAME Name of the ONE STAT Status of the VM CPU CPU percentage 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 fail failed COPYRIGHT Copyright 2002-2010, OpenNebula Project Leads (OpenNebula.org) Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 OpenNebula 2.0.1 November 2010 OPENNEBULA(8)