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 "/run/resource-agents/RESOURCE_ID.log")
37
38       use_screen
39           Provides the option of capturing the 'root console' from the
40           container and showing it on a separate screen. To see the screen
41           output run 'screen -r {container name}' The default value is set to
42           'false', change to 'true' to activate this option
43
44           (optional, boolean, default false)
45

SUPPORTED ACTIONS

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

EXAMPLE CRM SHELL

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

EXAMPLE PCS

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

AUTHOR

90       ClusterLabs contributors (see the resource agent source for information
91       about individual authors)
92
93
94
95resource-agents UNKNOWN           03/15/2019              OCF_HEARTBEAT_LXC(7)