OCF_HEARTBEAT_XEN(7)
NAME
ocf_heartbeat_Xen - Manages Xen unprivileged domains (DomUs)
SYNOPSIS
Xen [start | stop | migrate_from | migrate_to | monitor | meta-data |
validate-all]
DESCRIPTION
Resource Agent for the Xen Hypervisor. Manages Xen virtual machine
instances by mapping cluster resource start and stop, to Xen create and
shutdown, respectively. A note on names We will try to extract the name
from the config file (the xmfile attribute). If you use a simple
assignment statement, then you should be fine. Otherwise, if there's
some python acrobacy involved such as dynamically assigning names
depending on other variables, and we will try to detect this, then
please set the name attribute. You should also do that if there is any
chance of a pathological situation where a config file might be
missing, for example if it resides on a shared storage. If all fails,
we finally fall back to the instance id to preserve backward
compatibility. Para-virtualized guests can also be migrated by enabling
the meta_attribute allow-migrate.
SUPPORTED PARAMETERS
- xmfile
- Absolute path to the Xen control file, for this virtual machine.
(required, string, no default) - name
- Name of the virtual machine. (optional, string, no default)
- shutdown_timeout
- The Xen agent will first try an orderly shutdown using xm shutdown.
Should this not succeed within this timeout, the agent will
escalate to xm destroy, forcibly killing the node. If this is not
set, it will default to two-third of the stop action timeout.
Setting this value to 0 forces an immediate destroy. (optional,
boolean, no default) - allow_mem_management
- This parameter enables dynamic adjustment of memory for start and
stop actions used for Dom0 and the DomUs. The default is to not
adjust memory dynamically. (optional, boolean, default 0) - reserved_Dom0_memory
- In case memory management is used, this parameter defines the
minimum amount of memory to be reserved for the dom0. The default
minimum memory is 512MB. (optional, string, default 512) - monitor_scripts
- To additionally monitor services within the unprivileged domain,
add this parameter with a list of scripts to monitor. (optional,
string, no default)
SUPPORTED ACTIONS
This resource agent supports the following actions (operations):
- start
- Starts the resource. Suggested minimum timeout: 60.
- stop
- Stops the resource. Suggested minimum timeout: 40.
- migrate_from
- Executes steps necessary for migrating the resource away from the node. Suggested minimum timeout: 120.
- migrate_to
- Executes steps necessary for migrating the resource to the node. Suggested minimum timeout: 120.
- monitor
- Performs a detailed status check. Suggested minimum timeout: 30.
Suggested interval: 10. - meta-data
- Retrieves resource agent metadata (internal use only). Suggested
minimum timeout: 5. - validate-all
- Performs a validation of the resource configuration. Suggested
minimum timeout: 5.
EXAMPLE
- The following is an example configuration for a Xen resource using the
crm(8) shell:
- primitive example_Xen ocf:heartbeat:Xen \
params \xmfile=string \meta allow-migrate="true" \
op monitor depth="0" timeout="30" interval="10"
SEE ALSO
http://www.linux-ha.org/wiki/Xen_(resource_agent)
AUTHOR
- Linux-HA contributors (see the resource agent source for information about individual authors)