Name

ocf:VirtualDomain — Manages virtual domains through the libvirt virtualization framework

Synopsis

OCF_RESKEY_config=string [OCF_RESKEY_hypervisor=string] [OCF_RESKEY_force_stop=boolean] [OCF_RESKEY_migration_transport=string] [OCF_RESKEY_migration_network_suffix=string] [OCF_RESKEY_monitor_scripts=string] [OCF_RESKEY_dynamic_utilization=boolean] [OCF_RESKEY_set_utilization_cpu=boolean] [OCF_RESKEY_set_utilization_memory=boolean] VirtualDomain [start | stop | status | monitor | migrate_from | migrate_to | meta-data | validate-all]

Description

Resource agent for a virtual domain (a.k.a. domU, virtual machine, virtual environment etc., depending on context) managed by libvirtd.

Supported Parameters

OCF_RESKEY_config=Virtual domain configuration file

Absolute path to the libvirt configuration file, for this virtual domain.

OCF_RESKEY_hypervisor=Hypervisor URI

Hypervisor URI to connect to. See the libvirt documentation for details on supported URI formats. The default is system dependent.

OCF_RESKEY_force_stop=Always force shutdown on stop

Always forcefully shut down ("destroy") the domain on stop. The default behavior is to resort to a forceful shutdown only after a graceful shutdown attempt has failed. You should only set this to true if your virtual domain (or your virtualization backend) does not support graceful shutdown.

OCF_RESKEY_migration_transport=Remote hypervisor transport

Transport used to connect to the remote hypervisor while migrating. Please refer to the libvirt documentation for details on transports available. If this parameter is omitted, the resource will use libvirt's default transport to connect to the remote hypervisor.

OCF_RESKEY_migration_network_suffix=Migration network host name suffix

Use a dedicated migration network. The migration URI is composed by adding this parameters value to the end of the node name. If the node name happens to be an FQDN (as opposed to an unqualified host name), insert the suffix immediately prior to the first period (.) in the FQDN. At the moment Qemu/KVM and Xen migration via a dedicated network is supported. Note: Be sure this composed host name is locally resolveable and the associated IP is reachable through the favored network.

OCF_RESKEY_monitor_scripts=space-separated list of monitor scripts

To additionally monitor services within the virtual domain, add this parameter with a list of scripts to monitor. Note: when monitor scripts are used, the start and migrate_from operations will complete only when all monitor scripts have completed successfully. Be sure to set the timeout of these operations to accommodate this delay.

OCF_RESKEY_dynamic_utilization=Set utilization of resource when agent monitor

If set, the utilization parameter of resource will be reset if there are difference between resource parameters and system parameters when agent monitor. Otherwise, the resource parameters will be set once when agent start.

OCF_RESKEY_set_utilization_cpu=Enable setting cpu of utilization

Enable setting cpu of utilization.

OCF_RESKEY_set_utilization_memory=Enable setting memory of utilization

Enable setting memory of utilization.