clu_get_info - Gets information about a cluster and its
members
/usr/sbin/clu_get_info [-full] [-q] [-m memberid] [-raw]
[-state]
The -full option returns detailed information about all
members in the cluster, or about one member if the -m memberid
option is specified. 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 The -m
option returns information about the member specified by
memberid. 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.
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).
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: Cluster name Number
of members configured in this cluster Member ID for
this member Cluster incarnation Cluster expected votes
Current votes Votes required for quorum Quorum disk Quorum
disk votes
A member-specific information record begins with the initiator
M and returns data in the following order: Member
ID Host name Cluster interconnect IP name Cluster interconnect
IP address Member state Member base O/S version
Member cluster version Member running version Member name
Member votes 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.
Success. The system is not a cluster member or an error
has occurred.
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 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 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 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 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:provoloneics0:10.0.0.2:UP:Compaq
Tru64 UNIX V5.1A:
TruCluster Server V5.1A:INSTALLED:provolone:1:0x10002
M:3:swiss.zk4.com:swissics0:10.0.0.3:UP:Compaq
Tru64 UNIX V5.1A: TruCluster
Server V5.1A:INSTALLED:swiss:1:0x10003 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
Run-time configuration file for each cluster member.
Functions: clu_get_info(3)
Files: rc.config(8)
TruCluster Server Cluster Administration
clu_get_info(8)
[ Back ] |
