ocf_heartbeat_lxc(7)

1OCF_HEARTBEAT_LXC(7)          OCF resource agents         OCF_HEARTBEAT_LXC(7)
2
3
4

NAME

6       ocf_heartbeat_lxc - Manages LXC containers
7

SYNOPSIS

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

DESCRIPTION

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

SUPPORTED PARAMETERS

22       container
23           The unique name for this 'Container Instance' e.g. 'test1'.
24
25           (unique, required, string, no default)
26
27       config
28           Absolute path to the file holding the specific configuration for
29           this container e.g. '/etc/lxc/test1/config'.
30
31           (required, string, no default)
32
33       log
34           Absolute path to the container log file
35
36           (optional, string, default
37           "/var/run/resource-agents/RESOURCE_ID.log")
38
39       use_screen
40           Provides the option of capturing the 'root console' from the
41           container and showing it on a separate screen. To see the screen
42           output run 'screen -r {container name}' The default value is set to
43           'false', change to 'true' to activate this option
44
45           (optional, boolean, default false)
46

SUPPORTED ACTIONS

48       This resource agent supports the following actions (operations):
49
50       start
51           Starts the resource. Suggested minimum timeout: 10s.
52
53       stop
54           Stops the resource. Suggested minimum timeout: 30s.
55
56       monitor
57           Performs a detailed status check. Suggested minimum timeout: 20s.
58           Suggested interval: 60s.
59
60       validate-all
61           Performs a validation of the resource configuration. Suggested
62           minimum timeout: 20s.
63
64       meta-data
65           Retrieves resource agent metadata (internal use only). Suggested
66           minimum timeout: 5s.
67

EXAMPLE CRM SHELL

69       The following is an example configuration for a lxc resource using the
70       crm(8) shell:
71
72           primitive p_lxc ocf:heartbeat:lxc \
73             params \
74               container=string \
75               config=string \
76             op monitor timeout="20s" interval="60s" depth="0"
77

EXAMPLE PCS

79       The following is an example configuration for a lxc resource using
80       pcs(8)
81
82           pcs resource create p_lxc ocf:heartbeat:lxc \
83             container=string \
84             config=string \
85             op monitor timeout="20s" interval="60s" depth="0"
86

AUTHOR

91       ClusterLabs contributors (see the resource agent source for information
92       about individual authors)
93
94
95
96resource-agents UNKNOWN           10/24/2018              OCF_HEARTBEAT_LXC(7)