 |
Index for
Section 8 |
|
 |
Alphabetical
listing for C |
|
 |
Bottom of
page |
|
clu_get_info(8)
NAME
clu_get_info - Gets information about a cluster and its members
SYNOPSIS
/usr/sbin/clu_get_info [-full] [-q] [-m memberid] [-raw] [-state]
OPTIONS
-full
The -full option 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.
-raw
The -raw option returns detailed information about the cluster and all
members in the cluster in raw output, which is intended to be used as
input to scripts.
-state
The -state option returns the state of all members in the cluster in
raw output. The states returned are: UP, DOWN, or NOT_CONF (not
configured).
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 -- Number of votes expected when all configured
cluster members are up and any configured quorum disk is present.
· Current votes -- The number of votes contributed by current cluster
members and the quorum disk as seen by this member.
· Quorum votes -- 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. Implies that all features in the
installed software are fully functional.
-- BELOW INSTALLED -- one version below the current running version
returned in member cluster version. Useful when performing a
rolling upgrade. Implies that those features in the installed
software that are active only after the version switch occurs are
disabled.
-- UNKNOWN -- the running version is unknown.
· Member name -- The member name used by the connection manager (CNX) as
a member identifier.
· Node 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.
The clu_get_info -raw option displays detailed information, in raw output,
about all members in the cluster. This output is intended to be used as
input to scripts. Data is unlabeled, and data fields are separated by
colons. The fields returned are the same as if specifying the -full option
only data is in raw format.
The clu_get_info -raw option returns a clusterwide information record and
member-specific information records. A clusterwide information record
begins with the initiator C and returns data in the following order:
1. Cluster name
2. Number of members configured in this cluster
3. Member ID for this member
4. Cluster incarnation
5. Cluster expected votes
6. Current votes
7. Votes required for quorum
8. Quorum disk
9. Quorum disk votes
A member-specific information record begins with the initiator M and
returns data in the following order:
1. Member ID
2. Host name
3. Cluster interconnect IP name
4. Cluster interconnect IP address
5. Member state
6. Member base O/S version
7. Member cluster version
8. Member running version
9. Member name
10. Member votes
11. Csid
The clu_get_info -state option displays the state of all members in the
cluster. Output is intended to be used by a script to determine which
cluster members are up, down, or not configured. Data is unlabeled, and
data fields are separated by colons.
A state information record begins with the initiator S and returns the
following output based on the configuration state of all members in the
cluster:
· UP -- The member ID is configured and up.
· DOWN -- The member ID is configured and down.
· NOT_CONF -- The member ID is not configured in the 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 deli
Number of members configured in this cluster = 3
Memberid for this member = 1
Quorum disk = dsk4h
Quorum disk votes = 1
Information on each cluster member
Cluster memberid = 1
Hostname = polishham.zk4.com
Cluster interconnect IP name = polishham-ics0
Member state = UP
Cluster memberid = 2
Hostname = provolone.zk4.com
Cluster interconnect IP name = provolone-ics0
Member state = UP
Cluster memberid = 3
Hostname = swiss.zk4.com
Cluster interconnect IP name = swiss-ics0
Member state = UP
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
2. The following command displays general information about one member:
# clu_get_info -m 1
Cluster memberid = 1
Hostname = polishham.zk4.com
Cluster interconnect IP name = polishham-ics0
Member state = UP
3. The following command displays more information about all members in
the cluster:
# clu_get_info -full
Cluster information for cluster deli
Number of members configured in this cluster = 3
Memberid for this member = 1
Cluster incarnation = 0x7b5c2
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 = polishham.zk4.com
Cluster interconnect IP name = polishham-ics0
Cluster interconnect IP address = 10.0.0.1
Member state = UP
Member base O/S version = Compaq Tru64 UNIX V5.1A
Member cluster version = TruCluster Server V5.1A
Member running version = INSTALLED
Member name: polishham
Member votes = 1
csid = 0x10001
Cluster memberid = 2
Hostname = provolone.zk4.com
Cluster interconnect IP name = provolone-ics0
Cluster interconnect IP address = 10.0.0.2
Member state = UP
Member base O/S version = Compaq Tru64 UNIX V5.1A
Member cluster version = TruCluster Server V5.1A
Member running version = INSTALLED
Member name: provolone
Member votes: 1
csid = 0x10002
Cluster memberid = 3
Hostname = swiss.zk4.com
Cluster interconnect IP name = swiss-ics0
Cluster interconnect IP address = 10.0.0.3
Member state = UP
Member base O/S version = Compaq Tru64 UNIX V5.1A
Member cluster version = TruCluster Server V5.1A
Member running version = INSTALLED
Member name: swiss
Member votes: 1
csid = 0x10003
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
4. The following command displays more information about a particular
member of the cluster:
# clu_get_info -full -m 1
Cluster memberid = 1
Hostname = polishham.zk4.com
Cluster interconnect IP name = polishham-ics0
Cluster interconnect IP address = 10.0.0.1
Member state = UP
Member base O/S version = Compaq Tru64 UNIX V5.1A
Member cluster version = TruCluster Server V5.1A
Member running version = INSTALLED
Member name: polishham
Member votes: 1
csid = 0x10001
5. The following command displays detailed information about all members
in the cluster in raw output:
# clu_get_info -raw
C:deli:3:2:0x7b5c2:3:3:2:(null):0
M:1:polishham.zk4.com:polishham-ics0:10.0.0.1:UP:Compaq Tru64 UNIX V5.1A:
TruCluster Server V5.1A:INSTALLED:polishham:1:0x10001
M:2:provolone.zk4.com:provolone-ics0:10.0.0.2:UP:Compaq Tru64 UNIX V5.1A:
TruCluster Server V5.1A:INSTALLED:provolone:1:0x10002
M:3:swiss.zk4.com:swiss-ics0:10.0.0.3:UP:Compaq Tru64 UNIX V5.1A:
TruCluster Server V5.1A:INSTALLED:swiss:1:0x10003
6. The following command displays the state of all members in the
cluster:
# clu_get_info -state
S:NOT_CONF:UP:UP:UP:NOT_CONF:NOT_CONF:NOT_CONF:NOT_CONF
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 Cluster Administration
|
Index for
Section 8 |
|
|
Alphabetical
listing for C |
|
 |
Top of
page |
|