Scroll to navigation

OCF_HEARTBEAT_VARNIS(7) OCF resource agents OCF_HEARTBEAT_VARNIS(7)

NAME

ocf_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)
02/21/2014 resource-agents UNKNOWN