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 "RESOURCE_ID")
pid
Write the process's PID to the specified file. The default will include the specified name, i.e.: "/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_RESOURCE_ID.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
Specify a hard minimum time to live for cached documents.
(optional, integer, default 600)
varnish_user
Specify the name of an unprivileged user to which the child process should switch before it starts accepting connections.
(optional, string, default "varnish")
varnish_group
Specify 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/RESOURCE_ID.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")
maxfiles
Maximum number of open files (for ulimit -n)
(optional, string, default "131072")
max_locked_memory
Locked shared memory limit (for ulimit -l)
(optional, string, default "82000")

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 CRM SHELL

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"

EXAMPLE PCS

The following is an example configuration for a varnish resource using pcs(8) 
pcs resource create p_varnish ocf:heartbeat:varnish \
  config= string \
  mgmt_address= string \
  op monitor timeout="20" interval="10" depth="0"

SEE ALSO

http://clusterlabs.org/

AUTHOR

ClusterLabs contributors (see the resource agent source for information about individual authors)
06/07/2017 resource-agents 4.0.0~rc1-4~bp