2.3.1. Command Line Options and Parameters of ovm

2.3.1. Command Line Options and Parameters of ovm_vmcontrol
Prev	2.3. Using Oracle VM Virtual Machine Control	Next

2.3.1. Command Line Options and Parameters of ovm_vmcontrol

The ovm_vmcontrol utility has the following command line options:

-u user name of an Oracle VM Manager admin user (required)
-p password corresponding with the admin user name (required)
-h host name of the server running Oracle VM Manager (required)
-X use SSL to connect to Oracle VM Manager
-v virtual machine name
-U virtual machine UUID
-t name of target Oracle VM Server for migration of a virtual machine (use together with -c migrate)
-s comma separated list of physical thread numbers to bind virtual CPUs to (use together with -c vcpuset)
-T tag list, a comma separated list of strings to be associated with a virtual machine as metadata (use together with -c settags)
-F force the virtual disks associated with a virtual machine to be deleted (use together with -c delete)
-A acknowledge virtual machine events (use together with -c events)
-c console command (required)
[commands: start, stop, suspend, resume, status, restart, kill, delete, info, fixcfg, events, lock, vcpuset, vcpuget, migrate, settags, gettags, list]

Note

As you can see, the ovm_vmcontrol console command list contains a lock command. This special command allows you to lock a virtual machine for a certain period of time. When a virtual machine is locked by the utility, it is not possible for other tools or users (through the Oracle VM Manager user interface) to perform operations on that specific VM. This is particularly useful if you are an administrator and need to make a VM backup while the VM is stopped: you want to prevent anyone starting the VM before the backup finishes.

The list command does not need a VM name or UUID argument. It lists every VM and its status.

The fixcfg command verifies the vm.cfg file of the virtual machine and attempts to correct invalid entries. For example, an entry for vncpasswd will be cleared with this command, because the virtual machine console does not support this setting.

The vcpuset command hard-binds or pins virtual CPUs to threads. For example, -c vcpuset -s (0,1,2) physically binds vcpu0 to thread0, vcpu1 to thread1, vcpu2 to thread2. Use the vcpuget command to retrieve information about pinned vCPUs for the selected virtual machine.

The settags and gettags commands are used to manage tag metadata for a given virtual machine.