ocf_heartbeat_pound(7)
Manage a Pound instance
Description
OCF_HEARTBEAT_POUND
NAME
ocf_heartbeat_pound - Manage a Pound instance
SYNOPSIS
|
pound [start | stop | status | monitor | meta-data | validate-all] |
DESCRIPTION
The Pound Resource Agent can manage Pound instances.
SUPPORTED PARAMETERS
config
The Pound configuration file that Pound should manage, for example "/etc/pound.cfg".
(unique, required, string, no default)
name
Override the name of the instance that should be given to Pound (defaults to the resource identifier).
(unique, optional, string, default "RESOURCE_ID")
pid
Write the process's PID to the specified file. The default will include the specified name, i.e.: "/var/run/pound_production.pid". Unlike what this help message shows, it is most likely not necessary to change this parameter.
(unique, optional, string, default "/var/run/pound_RESOURCE_ID.pid")
binary
This is used to start Pound server. Normally use pound.
(optional, string, default "pound")
ctl_binary
This is used to watch Pound status via Unix socket. Normally use poundctl.
(optional, string, default "poundctl")
socket_path
Write the process's Unix socket. This parameter is same 'Control' parameter in configuration file, i.e.: Control "/var/lib/pound/pound.cfg".
(optional, string, default "/var/lib/pound/pound.cfg")
maxfiles
Determines how many files pound is allowed to open at a time. Helps to fix the 'Too many open files' error message.
(optional, integer, no default)
SUPPORTED ACTIONS
This resource agent supports the following actions (operations):
start
Starts the resource. Suggested minimum timeout: 20s.
stop
Stops the resource. Suggested minimum timeout: 20s.
monitor
Performs a detailed status check. Suggested minimum timeout: 20s. Suggested interval: 10s.
status
Performs a status check. Suggested minimum timeout: 20s.
meta-data
Retrieves resource agent metadata (internal use only). Suggested minimum timeout: 5s.
validate-all
Performs a validation of the resource configuration. Suggested minimum timeout: 20s.
EXAMPLE CRM SHELL
The following is an example configuration for a pound resource using the crm(8) shell:
primitive
p_pound ocf:heartbeat:pound \
params \
config=string \
op monitor timeout="20s" interval="10s"
depth="0"
EXAMPLE PCS
The following is an example configuration for a pound resource using pcs(8)
pcs resource
create p_pound ocf:heartbeat:pound \
config=string \
op monitor timeout="20s" interval="10s"
OCF_CHECK_LEVEL="0"
SEE ALSO
http://clusterlabs.org/
AUTHOR
ClusterLabs contributors (see the resource agent source for information about individual authors)