unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Page:
Section:
Apropos / Subsearch:
optional field



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

  -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 mem-
      berid.

  -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 config-
      ured).

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 TruClus-
       ter 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 rol-
	    ling upgrade.

	 -- 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	clus-
  ter 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 fol-
  lowing output	based on the configuration state of all	members	in the clus-
  ter:

    +  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 vari-
  ous member fields. If	the member is down and its /etc/rc.config file con-
  tains	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 clus-
       ter:
	    # 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