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/resource-agents/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 CRM SHELL

       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"

EXAMPLE PCS

       The following is an example configuration for a lxc resource using pcs(8)

           pcs resource create p_lxc ocf:heartbeat:lxc \
             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)