'\" t .\" Title: cl_status .\" Author: Alan Robertson .\" Generator: DocBook XSL Stylesheets v1.79.1 .\" Date: 24 Nov 2009 .\" Manual: User commands .\" Source: Heartbeat 3.0.6 .\" Language: English .\" .TH "CL_STATUS" "1" "24 Nov 2009" "Heartbeat 3.0.6" "User commands" .\" ----------------------------------------------------------------- .\" * 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" cl_status \- Check status of the High\-Availability Linux (Linux\-HA) subsystem .SH "SYNOPSIS" .PP \fBcl_status\fR \fBsub\-command\fR \fBoptions\fR \fIparameters\fR .SH "DESCRIPTION" .PP \fBcl_status\fR is used to check the status of the High\-Availability Linux subsystem\&. .SH "SUPPORTED SUB\-COMMANDS" .PP \fBhbstatus\fR .RS 4 Indicate if heartbeat is running on the local system\&. .sp With \fB\-v\fR, gives more details, similar to: .sp .if n \{\ .RS 4 .\} .nf version: 3\&.0\&.6 (10e3f2130ea1) managed by: pacemaker (respawn) ccm membership with quorum instance 12 members 2 1 bob (born: 6) 0 alice (born: 12) member of partition bob active (nodetype: normal) eth1 dead eth0 up alice active (nodetype: normal) eth1 dead eth0 up 10\&.43\&.9\&.55 ping (nodetype: ping) 10\&.43\&.9\&.55 up .fi .if n \{\ .RE .\} .sp Note: it is not a concern if a certain link from some node to itself is reported "dead"\&. For example "mcast" directives usually don\*(Aqt see their own network packages\&. .RE .PP \fBlistnodes\fR .RS 4 List the nodes in the cluster\&. .RE .PP \fBnodetype\fR ping|normal .RS 4 List the nodes of the given type\&. .if n \{\ .sp .\} .RS 4 .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBNote\fR .ps -1 .br Ping nodes are obsolete in Pacemaker cluster, having been replaced with the pingd resource agent\&. .sp .5v .RE .RE .PP \fBlisthblinks\fR \fInode\fR .RS 4 List the network interfaces used as heartbeat links\&. \fInode\fR should be specified as listed in the \fBha.cf\fR(5) file for the cluster\&. .RE .PP \fBhblinkstatus\fR \fInode\fR \fIlink\fR .RS 4 Show the status of a heartbeat link\&. \fInode\fR should be specified as listed in the \fBha.cf\fR(5) file for the cluster\&. \fIlink\fR should be as per the output of the listhblinks subcommand\&. .RE .PP \fBclientstatus\fR \fInode\fR \fIclient\fR [\fItimeout\fR] .RS 4 Show the status of heartbeat clients\&. \fInode\fR and \fIclient\fR should be specified as listed in the \fBha.cf\fR(5) file for the cluster\&. Timeout is in milliseconds, the default is 100ms\&. .RE .PP \fBrscstatus\fR .RS 4 Show the status of cluster resources\&. Status will be one of: local, foreign, all or none\&. .if n \{\ .sp .\} .RS 4 .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBNote\fR .ps -1 .br This option is deprecated, it is obsolete in Pacemaker clusters\&. .sp .5v .RE .RE .PP \fBparameter\fR \fB\-p\fR \fIparameter\fR .RS 4 Retrieve the value of cluster parameters\&. The parameters may be one of the following: apiauth, auto_failback, baud, debug, debugfile, deadping, deadtime, hbversion, hopfudge, initdead, keepalive, logfacility, logfile, msgfmt, nice_failback, node, normalpoll, stonith, udpport, warntime, watchdog\&. .if n \{\ .sp .\} .RS 4 .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBNote\fR .ps -1 .br Some of these options are deprecated; see \fBha.cf\fR(5) .sp .5v .RE .RE .SH "OPTIONS" .PP The following options are supported by heartbeat: .PP \fB\-v\fR .RS 4 Report more details\&. Available with hbstatus, listnodes, and listhblinks\&. .RE .PP \fB\-m\fR .RS 4 Make the output more human readable\&. The default output should be easier for scripts to parse\&. Available with all commands\&. .RE .PP \fB\-p\fR .RS 4 List only \*(Aqping\*(Aq nodes\&. Available with listnodes sub\-command\&. .if n \{\ .sp .\} .RS 4 .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBNote\fR .ps -1 .br Ping nodes are obsolete in Pacemaker cluster, having been replaced with the pingd resource agent\&. .sp .5v .RE .RE .PP \fB\-n\fR .RS 4 List only \*(Aqnormal\*(Aq nodes\&. Available with listnodes sub\-command\&. .RE .SH "SEE ALSO" .PP \fBheartbeat\fR(8), \fBha.cf\fR(5), \fBauthkeys\fR(5) .SH "AUTHORS" .PP \fBAlan Robertson\fR <\&alanr@unix\&.sh\&> .RS 4 cl_status .RE .PP \fBLars Ellenberg\fR <\&lars\&.ellenberg@linbit\&.com\&> .RS 4 Heartbeat Maintainer; code fixes; documentation updates .RE .PP \fBJuan Pedro Paredes Caballero\fR <\&juampe@retemail\&.es\&> .RS 4 man page .RE .PP \fBSimon Horman\fR <\&horms@verge\&.net\&.au\&> .RS 4 man page .RE .PP \fBFlorian Haas\fR <\&florian\&.haas@linbit\&.com\&> .RS 4 man page .RE