clu_get_info man page on Tru64

Man page or keyword search:  
man Server   12896 pages
apropos Keyword Search (all sections)
Output format
Tru64 logo
[printable version]

clu_get_info(8)						       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
       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 clus‐
       ter  The	 -m  option  returns information about the member specified by
       memberid.  The -raw option returns detailed information about the clus‐
       ter  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).

DESCRIPTION
       When invoked on a member of a cluster, the  clu_get_info	 command  dis‐
       plays general information about the cluster and its members. The infor‐
       mation includes: The name of the cluster and the number of members con‐
       figured	in  the cluster.  The member ID of the member issuing the com‐
       mand.  The device name and number of votes of the quorum disk, if  con‐
       figured.	  For each member, its member ID, host name, cluster intercon‐
       nect 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 out‐
       put, about all members in the cluster.  This output is intended	to  be
       used  as input to scripts. Data is unlabeled, and data fields are sepa‐
       rated 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 inter‐
       connect 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.

EXIT STATUS
       Success.	 The system is not a cluster member or an error has occurred.

EXAMPLES
       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 con‐
	      tains 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 informa‐
	      tion 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 con‐
	      tains 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 informa‐
	      tion  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:polish‐
	      ham-ics0:10.0.0.1:UP:Compaq Tru64 UNIX V5.1A: TruCluster	Server
	      V5.1A:INSTALLED:polishham:1:0x10001   M:2:provolone.zk4.com:pro‐
	      volone-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  The
	      following command displays the state of all members in the clus‐
	      ter: # clu_get_info -state

	      S:NOT_CONF:UP:UP:UP:NOT_CONF:NOT_CONF:NOT_CONF:NOT_CONF

FILES
       Run-time configuration file for each cluster member.

SEE ALSO
       Functions: clu_get_info(3)

       Files: rc.config(8)

       TruCluster Server Cluster Administration

							       clu_get_info(8)
[top]
                             _         _         _ 
                            | |       | |       | |     
                            | |       | |       | |     
                         __ | | __ __ | | __ __ | | __  
                         \ \| |/ / \ \| |/ / \ \| |/ /  
                          \ \ / /   \ \ / /   \ \ / /   
                           \   /     \   /     \   /    
                            \_/       \_/       \_/ 
More information is available in HTML format for server Tru64

List of man pages available for Tru64

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]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net