table of contents
other versions
conflicting packages
OCF_HEARTBEAT_XEN(7) | OCF resource agents | 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¶
xmfileAbsolute 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): startStarts 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¶
AUTHOR¶
Linux-HA contributors (see the resource agent source for information about individual authors)02/03/2011 | resource-agents 1.0.3 |