ocfs2.cluster.conf man page on OpenSuSE
[printable version]
/etc/ocfs2/cluster.conf(5) OCFS2 Manual Pages /etc/ocfs2/cluster.conf(5)
NAME
/etc/ocfs2/cluster.conf - Cluster configuration file for the o2cb clus‐
ter stack.
SYNOPSIS
The cluster layout of the o2cb cluster stack is specified in
/etc/ocfs2/cluster.conf. It lists the name of the cluster, the nodes
comprising that cluster and its heartbeat regions. The cluster stack
expects this file to be the same on all nodes in that cluster.
This file should be populated using the o2cb(8) cluster configuration
utility. A sample of the same is shown in the example section.
DESCRIPTION
The configuration file is divided into three types of stanzas, each
with a list of parameters and values. The three stanza types are clus‐
ter, node and heartbeat. While a configuration file can store defini‐
tions of multiple clusters, the o2cb cluster stack allows only one
cluster to be active at any one time. The name of this active cluster
is stored in /etc/sysconfig/o2cb [o2cb.sysconfig(5)].
The cluster stanza specifies the name of the cluster, number of nodes
and the heartbeat mode. The cluster name can include upto 16 alphanu‐
meric characters [0-9A-Za-z]. No special characters are allowed.
┌───────────────┬───────────────────────────────────────────────────────┐
│Parameters │ Description │
├───────────────┼───────────────────────────────────────────────────────┤
│node_count │ Number of nodes in the cluster │
├───────────────┼───────────────────────────────────────────────────────┤
│heartbeat_mode │ local or global heartbeat │
├───────────────┼───────────────────────────────────────────────────────┤
│name │ Cluster name (upto 16 alphanumeric chars [0-9A-Za-z]) │
└───────────────┴───────────────────────────────────────────────────────┘
The node stanza specifies the node name that is part of the cluster
alongwith its IPv4 address, port and node number. The node name must
match the hostname. The domain name is not required. For example,
appserver1.company.com can be appserver1. The IPv4 address need not be
the one associated with that hostname. As in, any valid IPv4 address on
that node can be used. The o2cb cluster stack will not attempt to match
the node name (hostname) with the specified IPv4 address. A low-latency
private interconnect address is recommended for best performance.
┌───────────┬────────────────────────────────────────────────────────────┐
│Parameters │ Description │
├───────────┼────────────────────────────────────────────────────────────┤
│ip_port │ IPv4 port │
├───────────┼────────────────────────────────────────────────────────────┤
│ip_address │ IPv4 address (private interconnect recommended) │
├───────────┼────────────────────────────────────────────────────────────┤
│number │ Node number (0 - 254) │
├───────────┼────────────────────────────────────────────────────────────┤
│name │ Node name (hostname without the domain name) │
├───────────┼────────────────────────────────────────────────────────────┤
│cluster │ Cluster name (should match the name in the cluster stanza) │
└───────────┴────────────────────────────────────────────────────────────┘
The heartbeat stanza specifies the global heartbeat region UUIDs. A
cluster can have upto 32 heartbeat regions. This is an optional stanza
and is only required if the global heartbeat mode is enabled. In other
words, the regions are only used if heartbeat_mode = global is in the
cluster stanza. If not, this stanza is ignored.
┌───────────┬────────────────────────────────────────────────────────────┐
│Parameters │ Description │
├───────────┼────────────────────────────────────────────────────────────┤
│region │ Heartbeat region UUID │
├───────────┼────────────────────────────────────────────────────────────┤
│cluster │ Cluster name (should match the name in the cluster stanza) │
└───────────┴────────────────────────────────────────────────────────────┘
While manual editing is not recommended, users doing so must follow the
format strictly. The stanza should start at the first column and end
with a colon. The parameters must start after a tab. A blank line must
demarcate each stanza. Care should be taken to avoid stray white-spa‐
ces.
EXAMPLE
The example below illustrates populating a cluster.conf with a cluster
called webcluster, having 3 nodes and 3 global heartbeat regions, using
the o2cb(8) utility.
$ o2cb add-cluster webcluster
$ o2cb add-node webcluster node7 --ip 192.168.0.107 --number 7
$ o2cb add-node webcluster node6 --ip 192.168.0.106 --number 6
$ o2cb add-node webcluster node10 --ip 192.168.0.110 --number 10
$ o2cb add-heartbeat webcluster /dev/sdg1
$ o2cb add-heartbeat webcluster /dev/sdk1
$ o2cb add-heartbeat webcluster /dev/sdh1
$ o2cb heartbeat-mode webcluster global
$ o2cb list-cluster webcluster
heartbeat:
region = 77D95EF51C0149D2823674FCC162CF8B
cluster = webcluster
heartbeat:
region = DCDA2845177F4D59A0F2DCD8DE507CC3
cluster = webcluster
heartbeat:
region = BBA1DBD0F73F449384CE75197D9B7098
cluster = webcluster
node:
ip_port = 7777
ip_address = 192.168.0.107
number = 7
name = node7
cluster = webcluster
node:
ip_port = 7777
ip_address = 192.168.0.106
number = 6
name = node6
cluster = webcluster
node:
ip_port = 7777
ip_address = 192.168.0.110
number = 10
name = node10
cluster = webcluster
cluster:
node_count = 3
heartbeat_mode = global
name = webcluster
SEE ALSO
o2cb(7) o2cb(8) o2cb.sysconfig(5)
AUTHORS
Oracle Corporation
COPYRIGHT
Copyright © 2004, 2012 Oracle. All rights reserved.
Version 1.8.2 January 2012 /etc/ocfs2/cluster.conf(5)
[top]
List of man pages available for OpenSuSE
Copyright (c) for man pages and the logo by the respective OS vendor.
For those who want to learn more, the polarhome community provides shell access and support.
[legal]
[privacy]
[GNU]
[policy]
[cookies]
[netiquette]
[sponsors]
[FAQ]
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
|
Vote for polarhome
|