OCF_HEARTBEAT_VARNIS(7) OCF resource agents OCF_HEARTBEAT_VARNIS(7)NAMEocf_heartbeat_varnish - Manage a Varnish instance
SYNOPSIS
varnish [start | stop | status | monitor | meta-data | validate-all]
DESCRIPTION
The Varnish Resource Agent can manage several varnishd instances
throughout the cluster. It does so by creating a unique PID file and
requires a unique listen address and name for each instance.
SUPPORTED PARAMETERS
config
The VCL configuration file that varnish should manage, for example
"/etc/varnish/default.vcl".
(unique, required, string, no default)
name
Override the name of the instance that should be given to varnish
(defaults to the resource identifier).
(unique, optional, string, default "default")
pid
Write the process's PID to the specified file. The default will
include the specified name, ie.: "/var/run/varnish_production.pid".
Unlike what this help message shows. It is most likely not
necessary to change this parameter.
(unique, optional, string, default "/var/run/varnishd_default.pid")
listen_address
Listen on this address:port, for example "192.168.1.1:80"
(unique, optional, string, default "0.0.0.0:80")
mgmt_address
Provide a management interface, for example "127.0.0.1:2222"
(unique, required, string, no default)
ttl
Specifies a hard minimum time to live for cached documents.
(optional, integer, default 600)
varnish_user
Specifies the name of an unprivileged user to which the child
process should switch before it starts accepting connections.
(optional, string, default "varnish")
varnish_group
Specifies the name of an unprivileged group to which the child
process should switch before it starts accepting connections.
(optional, string, default "varnish")
backend_type
Use the specified storage backend. Valid options are 'malloc' for
memory and 'file' for a file backend.
(optional, string, default "malloc")
backend_size
Specify the size of the backend. For example "1G".
(optional, string, default "1G")
backend_file
Specify the backend filename if you use backend_type file. For
example /var/lib/varnish/mybackend.bin
(unique, optional, string, default "/var/lib/varnish/default.bin")
worker_threads
Start at least min but no more than max worker threads with the
specified idle timeout.
Syntax: min[,max[,timeout]] For example: 100,3000,120
(optional, string, default "100,3000,120")
client_binary
This is used to control varnish via a CLI. It's currently only used
to check the status of the running child process.
(optional, string, default "varnishadm")
SUPPORTED ACTIONS
This resource agent supports the following actions (operations):
start
Starts the resource. Suggested minimum timeout: 20.
stop
Stops the resource. Suggested minimum timeout: 20.
monitor
Performs a detailed status check. Suggested minimum timeout: 20.
Suggested interval: 10.
status
Performs a status check. Suggested minimum timeout: 20.
meta-data
Retrieves resource agent metadata (internal use only). Suggested
minimum timeout: 5.
validate-all
Performs a validation of the resource configuration. Suggested
minimum timeout: 20.
EXAMPLE
The following is an example configuration for a varnish resource using
the crm(8) shell:
primitive p_varnish ocf:heartbeat:varnish \
params \
config=string \
mgmt_address=string \
op monitor timeout="20" interval="10" depth="0"
SEE ALSO
http://www.linux-ha.org/wiki/varnish_(resource_agent)AUTHOR
Linux-HA contributors (see the resource agent source for information
about individual authors)
resource-agents UNKNOWN 03/24/2013 OCF_HEARTBEAT_VARNIS(7)