ocf_heartbeat_lxc(7) - Linux man page

Name

ocf_heartbeat_lxc - Manages LXC containers

Synopsis

lxc [start | stop | monitor | meta-data | validate-all]

Description

Allows LXC containers to be managed by the cluster. If the container is running "init" it will also perform an orderly shutdown. It is 'assumed' that the 'init' system will do an orderly shudown if presented with a 'kill -PWR' signal. On a 'sysvinit' this would require the container to have an inittab file containing "p0::powerfail:/sbin/init 0" I have absolutly no idea how this is done with 'upstart' or 'systemd', YMMV if your container is using one of them.

Supported Parameters

container

The unique name for this 'Container Instance' e.g. 'test1'. (unique, required, string, no default)

config

Absolute path to the file holding the specific configuration for this container e.g. '/etc/lxc/test1/config'. (required, string, no default)

log

Absolute path to the container log file (optional, string, default /var/run/heartbeat/rsctmp/default.log)

use_screen

Provides the option of capturing the 'root console' from the container and showing it on a separate screen. To see the screen output run 'screen -r {container name}' The default value is set to 'false', change to 'true' to activate this option (optional, boolean, default false)

Supported Actions

This resource agent supports the following actions (operations):

start

Starts the resource. Suggested minimum timeout: 10.

stop

Stops the resource. Suggested minimum timeout: 30.

monitor

Performs a detailed status check. Suggested minimum timeout: 20. Suggested interval: 60.

validate-all

Performs a validation of the resource configuration. Suggested minimum timeout: 20.

meta-data

Retrieves resource agent metadata (internal use only). Suggested minimum timeout: 5.

Example

The following is an example configuration for a lxc resource using the crm(8) shell:

primitive p_lxc ocf:heartbeat:lxc \
  params \
    container=string \
    config=string \
  op monitor timeout="20" interval="60" depth="0"

See Also

http://www.linux-ha.org/wiki/lxc_(resource_agent)

Author

Linux-HA contributors (see the resource agent source for information about individual authors)