'\" t .\" Title: ocf_heartbeat_corosync-qnetd .\" Author: ClusterLabs contributors (see the resource agent source for information about individual authors) .\" Generator: DocBook XSL Stylesheets vsnapshot .\" Date: 03/13/2024 .\" Manual: OCF resource agents .\" Source: resource-agents 4.13.0-1+b1 .\" Language: English .\" .TH "OCF_HEARTBEAT_COROSY" "7" "03/13/2024" "resource-agents 4.13.0-1+b1" "OCF resource agents" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .\" http://bugs.debian.org/507673 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" ----------------------------------------------------------------- .\" * set default formatting .\" ----------------------------------------------------------------- .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only) .ad l .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- .SH "NAME" ocf_heartbeat_corosync-qnetd \- Corosync QNet daemon resource agent .SH "SYNOPSIS" .HP \w'\fBcorosync\-qnetd\fR\ 'u \fBcorosync\-qnetd\fR [start | stop | status | monitor | meta\-data | validate\-all] .SH "DESCRIPTION" .PP OCF Resource script for corosync\-qnetd\&. It manages a corosync\-qnetd instance as a HA resource\&. It is required to copy nss db directory (usually /etc/corosync/qnetd/nssdb) across all nodes (only once \- after database is initialized)\&. .SH "SUPPORTED PARAMETERS" .PP \fBbinary\fR .RS 4 Location of the corosync\-qnetd binary .sp (optional, string, default "/usr/bin/corosync\-qnetd") .RE .PP \fBqnetd_opts\fR .RS 4 Additional options for corosync\-qnetd binary\&. "\-4" for example\&. .sp (optional, string, no default) .RE .PP \fBqnetd_tool_binary\fR .RS 4 The absolute path to the corosync\-qnetd\-tool for monitoring with OCF_CHECK_LEVEL greater zero\&. .sp (optional, string, default "/usr/bin/corosync\-qnetd\-tool") .RE .PP \fBip\fR .RS 4 IP address to listen on\&. By default the daemon listens on all addresses (wildcard)\&. .sp (optional, string, no default) .RE .PP \fBport\fR .RS 4 TCP port to listen on\&. Default port is 5403\&. .sp (optional, string, no default) .RE .PP \fBnss_db_dir\fR .RS 4 Location of the corosync\-qnetd nss db directory (empty for default \- usually /etc/corosync/qnetd/nssdb) .sp (optional, string, no default) .RE .PP \fBpid\fR .RS 4 Location of the corosync\-qnetd pid/lock .sp (optional, string, default "/var/run/corosync\-qnetd/corosync\-qnetd\-RESOURCE_ID\&.pid") .RE .PP \fBipc_sock\fR .RS 4 Location of the corosync\-qnetd ipc socket .sp (optional, string, default "/var/run/corosync\-qnetd/corosync\-qnetd\-RESOURCE_ID\&.sock") .RE .PP \fBuser\fR .RS 4 User running corosync\-qnetd .sp (optional, string, default "coroqnetd") .RE .PP \fBgroup\fR .RS 4 Group running corosync\-qnetd .sp (optional, string, default "coroqnetd") .RE .SH "SUPPORTED ACTIONS" .PP This resource agent supports the following actions (operations): .PP \fBstart\fR .RS 4 Starts the resource\&. Suggested minimum timeout: 20s\&. .RE .PP \fBstop\fR .RS 4 Stops the resource\&. Suggested minimum timeout: 20s\&. .RE .PP \fBstatus\fR .RS 4 Performs a status check\&. Suggested minimum timeout: 20s\&. .RE .PP \fBmonitor\fR .RS 4 Performs a detailed status check\&. Suggested minimum timeout: 20s\&. Suggested interval: 10s\&. .RE .PP \fBvalidate\-all\fR .RS 4 Performs a validation of the resource configuration\&. Suggested minimum timeout: 20s\&. .RE .PP \fBmeta\-data\fR .RS 4 Retrieves resource agent metadata (internal use only)\&. Suggested minimum timeout: 20s\&. .RE .SH "EXAMPLE CRM SHELL" .PP The following is an example configuration for a corosync\-qnetd resource using the \fBcrm\fR(8) shell: .sp .if n \{\ .RS 4 .\} .nf primitive p_corosync\-qnetd ocf:heartbeat:corosync\-qnetd \e op monitor depth="0" timeout="20s" interval="10s" start\-delay="10s" .fi .if n \{\ .RE .\} .SH "EXAMPLE PCS" .PP The following is an example configuration for a corosync\-qnetd resource using \fBpcs\fR(8) .sp .if n \{\ .RS 4 .\} .nf pcs resource create p_corosync\-qnetd ocf:heartbeat:corosync\-qnetd \e op monitor OCF_CHECK_LEVEL="0" timeout="20s" interval="10s" start\-delay="10s" .fi .if n \{\ .RE .\} .SH "SEE ALSO" .PP \m[blue]\fB\%http://clusterlabs.org/\fR\m[] .SH "AUTHOR" .PP \fBClusterLabs contributors (see the resource agent source for information about individual authors)\fR