Linux Certif

Toute la documentation sur la certification Linux LPI

cluster.conf

NAME

cluster.conf - configuration file for cman, fence, dlm, gfs, rgmanager

DESCRIPTION

The cluster.conf 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 ccs(7)). 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 cluster.conf file. For other information see man pages for cman(5), fenced(8) and dlm_controld(8).

cluster.conf is an XML file. It has one top-level cluster section containing everything else. The cluster section has two mandatory attributes: name and config_version. name 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. config_version is a number used to identify the revision level of the cluster.conf file. Given this information, your cluster.conf file might look something like:

  <cluster name="alpha" config_version="1">
  </cluster>

Nodes

The set of nodes that make up the cluster are defined under the clusternodes section. A clusternode section defines each node. A clusternode has two mandatory attributes: name and nodeid

The name should correspond to the hostname (the fully qualified name is generally not necessary) on the network interface to be used for cluster communication. Nodeid's 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>

The next step in completing cluster.conf is adding fencing information; see fenced(8).

SEE ALSO

ccs(7), ccs_tool(8), ccsd(8), cman(5), fenced(8), dlm_controld(8)