The kamailio binary

(optional, string, default "/usr/sbin/kamailio")

The kamailio configuration file name with full path. For example, "/etc/kamailio/kamailio.cfg" , which is the default value. Make sure to use unique names in case of having multiple instances.

(optional, string, default "/etc/kamailio/kamailio.cfg")

The kamailio PID file. The directory used must be writable by kamailio process user. Be sure to use unique name for running more than one instance. Try to use absolute path names. If empty, resource agent create a unique directory from the resource instance name for the PID file and assign it to the process user.

(optional, string, default "/var/run/kamailio_RESOURCE_ID/kamailio.pid")

SIP IP Address of the kamailio instance used for SIP OPTIONS polling monitoring. Usually the same IP address value as for parameter listen_address should be provided.

In order to respond with a 200 OK response to the SIP OOPTION requests, the kamailio.cfg file needs to contain following section: Note: The following "kamailio.cfg" code snippet is part of an XML section. Therefore it contains two & characters, which need to be replaced with two ampersand characters within "kamailio.cfg":

if (is_method("OPTIONS") && (=~"sip:monitor@.*")) { ## ## If the method is an OPTIONS we are simply going to respond ## with a 200 OK. # xlog("L_INFO", "Method is an OPTIONS, probably just monitoring\n"); sl_send_reply("200", "Kamailio is alive"); exit; }

(optional, string, default "127.0.0.1")

SIP IP address the kamailio will listen on.

(required, string, no default)

SIP port for the kamailio instance.

(optional, string, default "5060")

Extra options to add to kamailio start.

(optional, string, no default)

The protocol used for SIP proto = udp|tcp|udptcp|conf_udp|conf_tcp|conf_udptcp. Using the options "conf_*" does not add any "-l" parameters to the kamailio command, the "listen" parameters from kamailio.conf are used instead. The sipsak checks are performed depending what protocol is defined after the underscore.

(optional, string, default "udptcp")

The installation path of the sipsak tool, which is used for monitoring Kamailio via SIP OPTIONS polling.

(optional, string, default "/usr/bin/sipsak")

The installation path of the "kamctl" control tool.

(optional, string, default "/usr/bin/kamctl")

The location of the "kamctlrc" file for the Kamailio instance. The file "kamctlrc" is the Kamailio configuration file for its "kamctl" control tool.

This parameter only needs to be provided in case of using multiple Kamailio server instances on a single cluster node:

In case that the parameter "kamctlrc" is not empty, this resource agent monitors the health state of the Kamailio server via the command "kamctl monitor 1". This setting is recommended in case of using a single Kamailio server instance.

In case that the parameter "kamctlrc" is empty, the resource agent does not monitor the health state of the Kamailio server instance via the "kamctl" command.

Please note that the "kamctl" control command of Kamailio 4.x does not support running multiple Kamailio instances on one host. Nevertheless this resource agent does allow multiple Kamailio instances per host. The result of the "kamctl" limitation in terms of number of Kamailio server instances is that the health check via "kamctl monitor 1" can be configured for a single Kamailio instance only.

Please refer to the long description of this resource agent for an example of parameter combinations in case that multiple instances are to be configured per cluster node.

(optional, string, default "/etc/kamailio/kamctlrc")

The user account for kamailio process to run with. Uses the current user, if not specified or empty. There is no check, if running kamailio with the specified user account is possible.

(optional, string, no default)

The group for kamailio process to run with. Uses the current group, if not specified or empty.

(optional, string, no default)

Starts the resource. Suggested minimum timeout: 60s.

Stops the resource. Suggested minimum timeout: 30s.

Performs a status check. Suggested minimum timeout: 30s. Suggested interval: 10s.

Performs a detailed status check. Suggested minimum timeout: 30s. Suggested interval: 10s.

Retrieves resource agent metadata (internal use only). Suggested minimum timeout: 5s.

Performs a validation of the resource configuration. Suggested minimum timeout: 5s.

Suggested minimum timeout: 5s.

primitive p_kamailio ocf:heartbeat:kamailio \
  params \
    listen_address=string \
  op monitor timeout="30s" interval="10s" 

pcs resource create p_kamailio ocf:heartbeat:kamailio \
  listen_address=string \
  op monitor timeout="30s" interval="10s"