 |
Index for
Section 8 |
|
 |
Alphabetical
listing for C |
|
 |
Bottom of
page |
|
clu_get_info(8)
NAME
clu_get_info - Get information about a cluster and its members
SYNOPSIS
/usr/sbin/clu_get_info [-full] [-q] [-m memberid]
OPTIONS
-full
Returns detailed information about all members in the cluster, or about
one member if the -m memberid option is specified.
-q Suppresses output. Use this option when only the return value is of
interest; for example, to determine whether the system is running as a
cluster member. When specified in combination with the -m option, the
-q option can be used to determine whether a particular member of a
cluster is up or down. For example:
# clu_get_info -q -m 2 && echo "Member 2 is a member of the cluster"
Member 2 is a member of the cluster
-m memberid
The -m option returns information about the member specified by
memberid.
DESCRIPTION
When invoked on a member of a cluster, the clu_get_info command displays
general information about the cluster and its members. The information
includes:
· The name of the cluster and the number of members configured in the
cluster.
· The member ID of the member issuing the command.
· The device name and number of votes of the quorum disk, if configured.
· For each member, its member ID, host name, cluster interconnect IP
name, and current state (UP or DOWN).
When invoked on a system that is not a cluster member, the clu_get_info
command prints an error message and exits.
The clu_get_info -full option displays additional information about the
cluster. The information includes:
· Cluster incarnation -- A hexadecimal number used to uniquely identify
the cluster.
· Cluster expected votes -- The votes assigned to this cluster, derived
from either the expected votes or the total number of votes (the
highest number is used).
· Current votes -- The number of votes contributed by current cluster
members and the quorum disk as seen by this member.
· Votes required for quorum -- The number of votes required for the
cluster to be up and running.
The clu_get_info -full command also displays the following information for
each member:
· Cluster interconnect IP address -- The IP address of the cluster
interconnect.
· Member base O/S version -- The version of the base operating system.
· Member cluster version -- The version of the TruCluster Server
software.
· Member running version -- The current running version of the
TruCluster software, which returns one of the following:
--
INSTALLED -- the current running version; same as the member cluster
version returned.
--
BELOW INSTALLED -- one version below the current running version
returned in member cluster version; useful when performing a rolling
upgrade.
--
UNKNOWN -- the running version is unknown.
· Member name -- The member name used by the connection manager (CNX) as
a member identifier.
· Member votes -- The votes assigned to this member (as set in the
cluster_node_votes kernel attribute for the clubase subsystem).
· csid -- The cluster system identifier, which is a unique hexadecimal
number that identifies each member in a cluster.
If a member of the cluster is down, clu_get_info displays UNKNOWN in
various member fields. If the member is down and its /etc/rc.config file
contains illegal values, clu_get_info displays CONFIGURATION_ERROR in the
related fields. An example is provided in the Examples section.
EXIT STATUS
0 (Zero)
Success.
1 The system is not a cluster member or an error has occurred.
EXAMPLES
1. The following command displays general information about the cluster
and its members:
# clu_get_info
Cluster information for cluster gallo
Number of members configured in this cluster = 2
Memberid for this member = 1
Quorum disk = dsk4h
Quorum disk votes = 1
Information on each cluster member
Cluster memberid = 1
Hostname = julio.zk3.dec.com
Cluster interconnect IP name = julio-mc0
Member state = UP
Cluster memberid = 2
Hostname = ernest.zk3.dec.com
Cluster interconnect IP name = ernest-mc0
Member state = UP
2. If one member of the cluster is down and its rc.config file contains
illegal values, the following is displayed:
Cluster memberid = 2
Hostname = CONFIGURATION_ERROR
Cluster interconnect IP name = CONFIGURATION_ERROR
Member state = DOWN
3. The following command displays general information about one member:
# clu_get_info -m 1
Cluster memberid = 1
Hostname = julio.zk3.dec.com
Cluster interconnect IP name = julio-mc0
Member state = UP
4. The following command displays more information about all members in
the cluster:
# clu_get_info -full
Cluster information for cluster gallo
Number of members configured in this cluster = 2
Memberid for this member = 1
Cluster incarnation = 0x896d4
Cluster expected votes = 3
Current votes = 3
Votes required for quorum = 2
Quorum disk = dsk4h
Quorum disk votes = 1
Information on each cluster member
Cluster memberid = 1
Hostname = julio.zk3.dec.com
Cluster interconnect IP name = julio-mc0
Cluster interconnect IP address = 10.0.0.1
Member state = UP
Member base O/S version = Compaq Tru64 UNIX T5.0-22 (Rev. 795.1)
Member cluster version = TruCluster Server X5.0-12 (Rev. 810)
Member running version = INSTALLED
Member name: julio
Member votes = 1
csid = 0x10001
Cluster memberid = 2
Hostname = ernest.zk3.dec.com
Cluster interconnect IP name = ernest-mc0
Cluster interconnect IP address = 10.0.0.2
Member state = UP
Member base O/S version = Compaq Tru64 UNIX T5.0-22 (Rev. 795.1)
Member cluster version = TruCluster Server X5.0-12 (Rev. 810)
Member running version = INSTALLED
Member name: ernest
Member votes: 1
csid = 0x10002
5. If one member of the cluster is down and its rc.config file contains
illegal values, the following is displayed:
Cluster memberid = 2
Hostname = CONFIGURATION_ERROR
Cluster interconnect IP name = CONFIGURATION_ERROR
Cluster interconnect IP address = CONFIGURATION_ERROR
Member state = DOWN
Member base O/S version = CONFIGURATION_ERROR
Member cluster version = CONFIGURATION_ERROR
Member running version = UNKNOWN
Member name = UNKNOWN
Member votes = UNKNOWN
csid = UNKNOWN
6. The following command displays more information about a particular
member of the cluster:
# clu_get_info -full -m 1
Cluster memberid = 1
Hostname = julio.zk3.dec.com
Cluster interconnect IP name = julio-mc0
Cluster interconnect IP address = 10.0.0.1
Member state = UP
Member base O/S version = Compaq Tru64 UNIX T5.0-22 (Rev. 795.1)
Member cluster version = TruCluster Server X5.0-12 (Rev. 810)
Member running version = INSTALLED
Member name: julio
Member votes: 1
csid = 0x10001
FILES
/etc/rc.config
Run-time configuration file for each cluster member.
SEE ALSO
Functions: clu_get_info(3)
Files: rc.config(8)
TruCluster Server Administration Guide
|
Index for
Section 8 |
|
|
Alphabetical
listing for C |
|
 |
Top of
page |
|