Hi folks I've converted the ccs manpages to the man package. Bastian -- Murder is contrary to the laws of man and God. -- M-5 Computer, "The Ultimate Computer", stardate 4731.3
=== man/ccs.7 ================================================================== --- man/ccs.7 (revision 321) +++ man/ccs.7 (local) @@ -4,16 +4,12 @@ .\" modify, copy, or redistribute it subject to the terms and conditions .\" of the GNU General Public License v.2. -.tl 'ccs(7)''ccs(7)' -'\" View with 'groff -t -e -mandoc -Tlatin1 ccs.7 | less' +.TH ccs 7 -\fBNAME\fP -.in +7 +.SH NAME ccs - Cluster Configuration System -.in -\fBDESCRIPTION\fP -.in +7 +.SH DESCRIPTION A cluster environment that shares resources has information that is essential to correct operation which must be available to every node in the cluster. This information may include: @@ -21,31 +17,24 @@ more. \fICCS\fP is the system that makes it possible for the nodes in a cluster to retrieve the information they need. -.sp -.in -\fBOVERVIEW\fP -.in +7 +.SH OVERVIEW The following is a generic description of the steps one should take to produce a working CCS environment. -\fBStep 1)\fP -.sp +.SS Step 1 Choose a cluster name. It is important to determine a name for the cluster before starting. The cluster name is what binds a machine to specific resources that can only be shared by machines that are members of the same cluster name. -\fBStep 2)\fP -.sp +.SS Step 2 Create the directory \fI/etc/cluster\fP. -\fBStep 3)\fP -.sp +.SS Step 3 Create the \fI/etc/cluster/cluster.conf\fP file, according to the \fBcluster.conf(5)\fP man page, on one node in your cluster. -\fBStep 4)\fP -.sp +.SS Step 4 Start \fBccsd\fP and test the cluster.conf file by using \fBccs_test\fP. If you haven't started a cluster manager yet, you should use the 'force' option to \fBccs_test\fP - see the \fBccs_test(8)\fP man page for more info. @@ -53,16 +42,9 @@ If a failure occurs while parsing the config file, \fBccs_test\fP should report "ccs_connect failed: No data available" and /var/log/messages should report "Unable to parse /etc/cluster/cluster.conf". -.sp -.in -\fBFORMAT OF THE CCS FILE\fP -.in +7 -.sp +.SH FORMAT OF THE CCS FILE See \fBcluster.conf(5)\fP -.sp -.in -\fBSEE ALSO\fP -.in +7 +.SH SEE ALSO ccsd(8), ccs_tool(8), ccs_test(8), cluster.conf(5) === man/ccs_test.8 ================================================================== --- man/ccs_test.8 (revision 321) +++ man/ccs_test.8 (local) @@ -4,33 +4,24 @@ .\" modify, copy, or redistribute it subject to the terms and conditions .\" of the GNU General Public License v.2. -.tl 'ccs_test(8)''ccs_test(8)' -'\" View with 'groff -t -e -mandoc -Tlatin1 ccs_test.8 | less' +.TH ccs_test 8 -\fBNAME\fP -.in +7 +.SH NAME ccs_test - The diagnostic tool for a running Cluster Configuration System. -.in -\fBSYNOPSIS\fP -.in +7 -\fBccs_test\fP <\fBcommand\fP> -.sp -.in -\fBDESCRIPTION\fP -.in +7 +.SH SYNOPSIS +.B ccs_test +<\fBcommand\fP> + +.SH DESCRIPTION \fBccs_test\fP is part of the Cluster Configuration System (CCS). It is a diagnostic tool designed to validate the correct operation of a running CCS system. It will communicate with the CCS daemon - \fBccsd\fP - to obtain any information stored in the system. -.sp -.in - -\fBCOMMANDS\fP -.in +7 +.SH COMMANDS +.TP \fBconnect\fP \fI[force]\fP \fI[block]\fP \fI[cluster name]\fP -.in +7 This command creates a connection to ccsd. It returns a descriptor, which is used as an parameter to other commands. @@ -44,10 +35,8 @@ only configuration files containing the given cluster name are valid possibilities. -.sp -.in +.TP \fBget\fP \fI<desc>\fP \fI<request>\fP -.in +7 Get the results of a given request. The 'desc' is the number returned from the \fBconnect\fP command. The 'request' is a valid Xpath request. @@ -55,89 +44,73 @@ Subsequent calls with the same 'request' will result in the subsequent matches. Once all the matches have been returned, a subsequent call will begin again with the first result. -.sp -.in +.TP \fBget_list\fP \fI<desc>\fP \fI<request>\fP -.in +7 Similar to the \fBget\fP command. However, issuing subsequent calls with the same 'request' will result in all matches being returned (one at a time), then null, then starting over with the first result. -.sp -.in +.TP \fBset\fP \fI<desc>\fP \fI<path>\fP \fI<value>\fP -.in +7 Sets a particular 'path' to the given 'value'. Not yet implemented. -.sp -.in +.TP \fBget_state\fP \fI<desc>\fP -.in +7 Get the state associated with a given connection. -.sp -.in +.TP \fBset_state\fP \fI<desc>\fP \fI<ncwp>\fP -.in +7 Set the current working path (cwp) to 'ncwp' for a given connection. -.sp -.in -.in -7 -\fBEXAMPLES\fP -.in +7 -\fBTo connect to ccsd:\fP -.sp +.SH EXAMPLES +.SS To connect to ccsd: + > ccs_test connect Connect successful. Connection descriptor = 0 -.sp + Or, if the cluster is not yet quorate and the name of the cluster is 'mycluster': -.sp + > ccs_test connect force block mycluster Connect successful. Connection descriptor = 0 -.sp -\fBTo get the cluster name from ccsd:\fP -.sp +.SS To get the cluster name from ccsd: + > ccs_test get 0 //cluster/@name Get successful. Value = <mycluster> -.sp -\fBTo get the connection state:\fP -.sp +.SS To get the connection state: + > ccs_test get_state 0 Get state successful. Current working path: Previous query : //cluster/@name -.sp -\fBTo set the connection state:\fP -.sp + +.SS To set the connection state: + > ccs_test set_state 0 //cluster Set state successful. -.sp -\fBAfter setting the connection state, note the change:\fP -.sp + +.SS After setting the connection state, note the change: + > ccs_test get_state 0 Get state successful. Current working path: //cluster Previous query : //cluster/@name -.sp -\fBAfter setting the connection state, you can now query with an absolute -or relative path:\fP -.sp +.SS After setting the connection state, you can now query with an absolute or relative path: + > ccs_test get 0 @name Get successful. @@ -147,16 +120,12 @@ Get successful. Value = <brassow> -.sp -\fBTo disconnect:\fP -.sp +.SS To disconnect: + > ccs_test disconnect 0 Disconnect successful. -.sp -.in -7 -\fBSEE ALSO\fP -.in +7 +.SH SEE ALSO ccs(7), ccsd(8), cluster.conf(5) === man/ccs_tool.8 ================================================================== --- man/ccs_tool.8 (revision 321) +++ man/ccs_tool.8 (local) @@ -4,48 +4,32 @@ .\" modify, copy, or redistribute it subject to the terms and conditions .\" of the GNU General Public License v.2. -.tl 'ccs_tool(8)''ccs_tool(8)' -'\" View with 'groff -t -e -mandoc -Tlatin1 ccs_tool.8 | less' +.TH ccs_tool 8 -\fBNAME\fP -.in +7 +.SH NAME ccs_tool - The tool used to make online updates of CCS config files. -.in -\fBSYNOPSIS\fP -.in +7 -\fBccs_tool\fP [\fBoptions\fP] <\fBcommand\fP> -.sp -.in -\fBDESCRIPTION\fP -.in +7 +.SH SYNOPSIS +.B ccs_tool +[\fIOPTION\fR].. <\fBcommand\fP> + +.SH DESCRIPTION \fBccs_tool\fP is part of the Cluster Configuration System (CCS). It is used to make online updates of CCS config files. Additionally, it can be used to upgrade old style (GFS <= 6.0) CCS archives to the new xml format. -.sp -.in -\fBOPTIONS\fP -.in +7 - +.SH OPTIONS +.TP \fB-h\fP -.in +7 Help. Print out the usage. -.sp -.in - +.TP \fB-V\fP -.in +7 Print the version information. -.sp -.in -.in -7 -\fBCOMMANDS\fP -.in +7 +.SH COMMANDS +.TP \fBupdate\fP \fI<xml file>\fP -.in +7 This command is used to update the config file that ccsd is working with while the cluster is operational (i.e. online). Run this on a single machine to update all instances of ccsd across the cluster. @@ -55,20 +39,12 @@ complete. Failure to do so will result in new nodes (or nodes rejoining after a failure) not being allowed to join the working set due to version number mismatches. - -.sp -.in +.TP \fBupgrade\fP \fI<location>\fP -.in +7 This command is used to upgrade an old CCS format archive to the new xml format. \fI<location>\fP is the location of the old archive, which can be either a block device archive or a file archive. The converted configuration will be printed to stdout. -.sp -.in - -.in -7 -\fBSEE ALSO\fP -.in +7 +.SH SEE ALSO ccs(7), ccsd(8), cluster.conf(5) === man/ccsd.8 ================================================================== --- man/ccsd.8 (revision 321) +++ man/ccsd.8 (local) @@ -5,67 +5,42 @@ .\" modify, copy, or redistribute it subject to the terms and conditions .\" of the GNU General Public License v.2. -.tl 'ccsd(8)''ccsd(8)' -'\" View with 'groff -t -e -mandoc -Tlatin1 ccsd.8 | less' +.TH ccsd 8 -\fBNAME\fP -.in +7 +.SH NAME ccsd - The daemon used to access CCS cluster configuration files. -.in -\fBSYNOPSIS\fP -.in +7 -\fBccsd\fP [\fBoptions\fP] -.sp -.in -\fBDESCRIPTION\fP -.in +7 +.SH SYNOPSIS +.B ccsd +[\fIOPTION\fR].. + +.SH DESCRIPTION \fBccsd\fP is part of the Cluster Configuration System (CCS). It is the daemon which accesses cluster the configuration file for other cluster applications. It must be run on each node that wishes to join a cluster. -.sp -.in - -\fBOPTIONS\fP -.in +7 - +.SH OPTIONS +.TP \fB-4\fP -.in +7 Use IPv4 for all communication. By default, IPv6 is tried, then IPv4. -.sp -.in - +.TP \fB-6\fP -.in +7 Use IPv6 for all communication. By default, IPv6 is tried, then IPv4. -.sp -.in - +.TP \fB-h\fP -.in +7 Help. Print out the usage syntax. -.sp -.in - +.TP \fB-m <multicast address>\fP -.in +7 Used to specify the multicast address. The keyword "default" can be used, in which case "ff02::3:1" is used for IPv6 and "224.0.2.5" is used for IPv4. If you are using IPv4, the default action is to use broadcast. Specifying this option will cause multicast to be used in that instance. -.sp -.in - +.TP \fB-n\fP -.in +7 No daemon. Run in the foreground. -.sp -.in - +.TP \fB-P <port identifier>:<port number>\fP -.in +7 You have the option of specifying the port numbers used by ccsd. The port identifier is either: b, c, or f. "b" is the port which ccsd attempts to communicate with ccsd processes on other machines, via broadcast/multicast, to @@ -76,22 +51,12 @@ from the CCS library (or programs using it). This is known as the frontend port. So, to change the frontend port one might specify \fI-P f:60000\fP. -.sp -.in - +.TP \fB-t <ttl>\fP -.in +7 Set the multicast threshold (aka time to live). -.sp -.in - +.TP \fB-V\fP -.in +7 Print the version information. -.sp -.in -.in -7 -\fBSEE ALSO\fP -.in +7 +.SH SEE ALSO ccs(7), ccs_tool(8), ccs_test(8), cluster.conf(5) === man/cluster.conf.5 ================================================================== --- man/cluster.conf.5 (revision 321) +++ man/cluster.conf.5 (local) @@ -2,19 +2,12 @@ .\" Copyright 2001-2003 Sistina Software, Inc. .\" Copyright (C) 2004 Red Hat, Inc. All rights reserved. -.\" groff -t -e -mandoc -Tlatin1 cluster.conf.5 | less +.TH cluster.conf 5 -.tl 'cluster.conf(5)' 'cluster.conf(5)' - -\fBNAME\fP -.in +7 +.SH NAME cluster.conf - The configuration file for cluster products -.sp -.in -7 - -\fBDESCRIPTION\fP -.in +7 +.SH DESCRIPTION The \fBcluster.conf\fP file is located in the /etc/cluster directory. It is the source of information used by the cluster products - accessed indirectly through CCS (see \fBccs(7)\fP). This file contains all the @@ -186,10 +179,6 @@ </fencedevices> </cluster> - -.sp -.in -7 -\fBSEE ALSO\fP -.in +7 +.SH SEE ALSO ccs(7), ccs_tool(8), lock_gulmd(5), cman(5)
Attachment:
signature.asc
Description: Digital signature
