NAME
cluster.conf − configuration file for cman and related daemons
SYNOPSIS
/etc/cluster/cluster.conf
DESCRIPTION
When cman_tool(8) starts the corosync(8) daemon, the cluster.conf data is read into the corosync in-memory database (confdb). The configuration is used by corosync, cman and other related cluster daemons and programs. When cman configures corosync with cluster.conf, the corosync.conf(5) file is not used.
A basic cluster configuration is described below. Configuration options for other daemons/programs are described in their own man pages. ccs_tool(8) can be used to do some basic cluster.conf editing.
The cluster.rng schema is used to validate cluster.conf. Unrecognized items will produce a warning during cluster startup, and invalid xml structure will cause the cluster startup to fail. See ccs_config_validate(8) and ccs_config_dump(8).
Cluster
The top level cluster section contains all other
sections and has two required attributes:
name |
The name of the cluster can be up to 15 characters long (16 including terminating null). It is important that this name be unique among clusters on the same network. |
config_version
The config_version specifies the revision level of the file and should be increased each time the file is updated.
<cluster
name="alpha" config_version="1">
</cluster>
Cluster
Nodes
The set of nodes that make up the cluster are defined in the
clusternodes section which contains multiple
clusternode sections. A clusternode has two required
attributes:
name |
The node name should correspond to the hostname on the network interface to be used for cluster communication. | ||
nodeid |
The node id must be greater than zero and unique. |
<cluster
name="alpha" config_version="1">
<clusternodes>
<clusternode name="node-01"
nodeid="1">
</clusternode>
<clusternode
name="node-02" nodeid="2">
</clusternode>
<clusternode
name="node-03" nodeid="3">
</clusternode>
</clusternodes>
</cluster>
Logging
Cluster daemons use a common logging section to
configure their loggging behavior.
<cluster
name="alpha" config_version="1">
<logging/>
</cluster>
Global settings apply to all:
<logging debug="on"/>
Per-daemon logging_daemon subsections override the global settings. Daemon names that can be configured include: corosync, qdiskd, groupd, fenced, dlm_controld, gfs_controld, rgmanager.
<logging>
<logging_daemon name="qdiskd"
debug="on"/>
<logging_daemon name="fenced"
debug="on"/>
</logging>
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.
<logging>
<logging_daemon name="corosync"
subsys="QUORUM" debug="on"/>
<logging_daemon name="corosync"
subsys="CONFDB" debug="on"/>
</logging>
The attributes
available at global, daemon and subsystem levels are:
to_syslog
enable/disable messages to syslog (yes/no), default "yes"
to_logfile
enable/disable messages to log file (yes/no), default "yes"
syslog_facility
facility used for syslog messages, default "daemon"
syslog_priority
messages at this level and up will be sent to syslog, default "info"
logfile_priority
messages at this level and up will be written to log file, default "info"
logfile
the log file name, default /var/log/cluster/<daemon>.log
debug="on"
a shortcut for logfile_priority="debug"
EXAMPLE
An explicit configuration for the default settings would be:
<logging
to_syslog="yes" to_logfile="yes"
syslog_facility="daemon"
syslog_priority="info"
logfile_priority="info">
<logging_daemon name="qdiskd"
logfile="/var/log/cluster/qdiskd.log"/>
<logging_daemon name="fenced"
logfile="/var/log/cluster/fenced.log"/>
<logging_daemon name="dlm_controld"
logfile="/var/log/cluster/dlm_controld.log"/>
<logging_daemon name="gfs_controld"
logfile="/var/log/cluster/gfs_controld.log"/>
<logging_daemon name="rgmanager"
logfile="/var/log/cluster/rgmanager.log"/>
<logging_daemon name="corosync"
logfile="/var/log/cluster/corosync.log"/>
</logging>
To include debug messages (and above) from all daemons in their default log files, either of the following which are equivalent:
<logging
debug="on"/>
<logging logfile_priority="debug"/>
To exclude all log messages from syslog:
<logging to_syslog="no"/>
To disable logging to all log files:
<logging to_file="no"/>
To include debug messages (and above) from all daemons in syslog:
<logging syslog_priority="debug"/>
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):
<logging syslog_priority="error" logfile_priority="info"/>
FILES
/etc/cluster/cluster.conf
standard location of cluster configuration file
/usr/share/cluster/cluster.rng
standard location of cluster.conf schema
SEE ALSO
ccs_tool(8), ccs_config_dump(8), ccs_config_validate(8), cman_tool(8), cman(5), qdisk(5), fenced(8), fence_node(8), dlm_controld(8), gfs_controld(8), rgmanager(8)