From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 4854 invoked by alias); 6 Mar 2009 16:56:45 -0000 Received: (qmail 4846 invoked by alias); 6 Mar 2009 16:56:44 -0000 X-SWARE-Spam-Status: No, hits=-1.8 required=5.0 tests=AWL,BAYES_00,SPF_HELO_PASS X-Spam-Status: No, hits=-1.8 required=5.0 tests=AWL,BAYES_00,SPF_HELO_PASS X-Spam-Check-By: sourceware.org X-Spam-Checker-Version: SpamAssassin 3.2.5 (2008-06-10) on bastion.fedora.phx.redhat.com Subject: cluster: master - man pages: sync cluster.conf from stable3 To: cluster-cvs-relay@redhat.com X-Project: Cluster Project X-Git-Module: cluster.git X-Git-Refname: refs/heads/master X-Git-Reftype: branch X-Git-Oldrev: ab37c04a983308130d5a4214aad92503e169c9ce X-Git-Newrev: d261c93b272d0512775055cb9040fbf191844abd From: David Teigland Message-Id: <20090306165621.50A1E1201C1@lists.fedorahosted.org> Date: Fri, 06 Mar 2009 16:56:00 -0000 X-Scanned-By: MIMEDefang 2.58 on 172.16.52.254 Mailing-List: contact cluster-cvs-help@sourceware.org; run by ezmlm Precedence: bulk List-Id: List-Subscribe: List-Post: List-Help: , Sender: cluster-cvs-owner@sourceware.org X-SW-Source: 2009-q1/txt/msg00717.txt.bz2 Gitweb: http://git.fedorahosted.org/git/cluster.git?p=cluster.git;a=commitdiff;h=d261c93b272d0512775055cb9040fbf191844abd Commit: d261c93b272d0512775055cb9040fbf191844abd Parent: ab37c04a983308130d5a4214aad92503e169c9ce Author: David Teigland AuthorDate: Fri Mar 6 10:53:32 2009 -0600 Committer: David Teigland CommitterDate: Fri Mar 6 10:53:32 2009 -0600 man pages: sync cluster.conf from stable3 Signed-off-by: David Teigland --- config/man/cluster.conf.5 | 191 +++++++++++++++++++++++++++++++++++++++----- 1 files changed, 169 insertions(+), 22 deletions(-) diff --git a/config/man/cluster.conf.5 b/config/man/cluster.conf.5 index b45d410..d9e50d4 100644 --- a/config/man/cluster.conf.5 +++ b/config/man/cluster.conf.5 @@ -5,30 +5,53 @@ cluster.conf - configuration file for cman, fence, dlm, gfs, rgmanager .SH DESCRIPTION -The \fBcluster.conf\fP file is located in the /etc/cluster directory. It -is the source of information used by cman, fence, dlm, gfs and rgmanager. -It's accessed indirectly through libccs (see \fBccs(7)\fP). This file -contains all the information needed for the cluster to operate, such as -what nodes are in the cluster and how to I/O fence those nodes. - -This man page describes the generic contents of the \fBcluster.conf\fP -file. For other information see man pages for cman(5), fenced(8) and -dlm_controld(8). - -\fBcluster.conf\fP is an XML file. It has one top-level \fIcluster\fP -section containing everything else. The cluster section has two mandatory +The /etc/cluster/cluster.conf file contains configuration for: + +.B cman(5) +for corosync and quorum configuration +.br +.B qdisk(5) +for quorum disk configuration +.br +.B groupd(8) +for daemon configuration +.br +.B fenced(8) +for daemon and fence device configuration +.br +.B dlm_controld(8) +for daemon configuration +.br +.B gfs_controld(8) +for daemon configuration +.br +.B rgmanager(8) +for daemon and resource configuration + +The same cluster.conf file must exist on each cluster node. + +When cman_tool starts corosync, the contents of cluster.conf are loaded into +the corosync in-memory configuration database (confdb). Daemons and programs +listed above use the libccs library to read cluster.conf data from the +corosync confdb. (The libconfdb library can also be used for more general, +non-xml confdb queries.) + +When cman configures corosync using cluster.conf, the corosync.conf file is +not used. + +.SS Cluster Nodes + +cluster.conf is an XML file. It has one top-level \fIcluster\fP section +containing everything else. The cluster section has two mandatory attributes: \fIname\fP and \fIconfig_version\fP. \fIname\fP can be up to -16 characters long and specifies the name of the cluster. It is important -that this name is unique from other clusters the user might set up. -\fIconfig_version\fP is a number used to identify the revision level of -the \fBcluster.conf\fP file. Given this information, your -\fBcluster.conf\fP file might look something like: +15 characters long (16 including terminating null) and specifies the name +of the cluster. It is important that this name be unique among clusters +on the same network. \fIconfig_version\fP is a number used to identify +the revision level of the cluster.conf file. -.SS Nodes - The set of nodes that make up the cluster are defined under the \fIclusternodes\fP section. A \fIclusternode\fP section defines each node. A clusternode has two mandatory attributes: @@ -53,9 +76,133 @@ communication. Nodeid's must be greater than zero and unique. -The next step in completing cluster.conf is adding fencing information; -see fenced(8). +.SS Logging +.br +All daemons listed above use the section to configure loggging. +Global settings apply to all: + + + +Per-daemon settings override the corresponding global setting. logging_daemon +names that can be configured include: corosync, qdiskd, groupd, fenced, +dlm_controld, gfs_controld, rgmanager. + + + + + + +corosync daemon settings apply to all corosync subsystems by default, but +subsystems can also be configured individually. These include CLM, CPG, MAIN, +SERV, CMAN, TOTEM, QUORUM, CONFDB, CKPT, EVT. + + + + + + +.B Settings +.br +The settings available at global, daemon and subsystem levels are: + +.B to_syslog +.br +enable/disable messages to syslog (yes/no) +.br +default "yes" + +.B to_logfile +.br +enable/disable messages to log file (yes/no) +.br +default "yes" + +.B syslog_facility +.br +facility used for syslog messages +.br +default "daemon" + +.B syslog_priority +.br +messages at this level and up will be sent to syslog +.br +default "info" + +.B logfile_priority +.br +messages at this level and up will be written to log file +.br +default "info" + +.B logfile +.br +the log file name, default /var/log/cluster/.log + +.B debug="on" +.br +is a shortcut for logfile_priority="debug" + +.B Defaults +.br +An explicit configuration for the default settings would be: + + +.br + +.br + +.br + +.br + +.br + +.br + +.br + +.br + + +.B Examples +.br +To include debug messages (and above) from all daemons in their default log files, either +.in +7 + or + +.in -7 + +To exclude all log messages from syslog +.in +7 + +.in -7 + +To disable logging to all log files +.in +7 + +.in -7 + +To include debug messages (and above) from all daemons in syslog +.in +7 + +.in -7 + +To limit syslog messages to error (and above), keeping info (and above) in +log files (this logfile_priority setting is the default so could be omitted) +.in +7 + +.in -7 + .SH SEE ALSO -ccs(7), ccs_tool(8), ccsd(8), cman(5), fenced(8), dlm_controld(8) +cman(5), qdisk(5), groupd(8), fenced(8), dlm_controld(8), gfs_controld(8), rgmanager(8)