Index Index for
Section 8
Index Alphabetical
listing for C
Index Bottom of
page		 

clu_ivp(8)


NAME

  clu_ivp - Verifies that the TruCluster software product has been properly
  installed and that the cluster is correctly configured.


SYNOPSIS

  /usr/sbin/clu_ivp [-h] [-v]


FLAGS

  -h	    Displays help.

  -v	    Activates verbose mode.  In verbose mode, the clu_ivp utility
	    provides information about the progress and outcome of its
	    testing, in addition to the error conditions it reports by
	    default.


DESCRIPTION

  The clu_ivp utility verifies that the TruCluster Production Server
  Software, TruCluster Available Server Software, or TruCluster Memory
  Channel Software has been properly installed, and that the cluster is
  correctly configured.	 When it encounters a problem, the utility displays
  an error message and a suggested solution.  In those cases in which the
  utility's display does not help you to completely correct the problem,
  examine the system's error logs and console output for more information.

  Although you typically run the clu_ivp utility on a system immediately
  after the TruCluster software product has been installed, you can run it at
  any time after the installation.  It can be useful to run the clu_ivp
  utility to help identify problems in a cluster;  for example, if a required
  cluster daemon has stopped running.

  Because the clu_ivp utility tests only the cluster member on which it is
  running, you must run it on each cluster member to verify the operation of
  the entire cluster.

  The clu_ivp utility uses the -d and -v flags of the cnxshow utility to
  perform cluster membership and communications tests.	It calls the drd_ivp
  utility to perform tests relevant to the distributed raw disk (DRD)
  subsystem.  If the clu_ivp utility reports errors relating to cluster
  membership or the DRD subsystem, you may obtain additional information by
  running the cnxshow or drd_ivp utilities directly.

  When invoked with the -v option, clu_ivp displays a series of status
  messages and configuration information. The following is a sequential
  listing of the verification checks and configuration information provided
  by clu_ivp:

    ·  The /usr file system is mounted.

    ·  All required TruCluster software product subsets are installed.

    ·  The parameters in the /etc/rc.config file introduced by the TruCluster
       software installation are present and set to appropriate values:

	 --
	 For Production Server and Available Server, CLUSTER_NET is defined.

	 --
	 For Production Server and Memory Channel Software, mc0 is defined as
	 a NETDEV device and has an IP address.

	 --
	 For Available Server, if ASE="on", ASE_ID is set to 0.

	 --
	 For Production Server, if ASE="on", ASE_ID is set to one of the
	 following values (0, 1, ... 63).

    ·  The host entries in the /etc/hosts file introduced by the TruCluster
       software installation are present and set to appropriate values:

	 --
	 An entry for the network interface defined in rc.config is present.

	 --
	 For Production Server, an entry for the cluster_cnx service is
	 present.

    ·  In the /etc/svc.conf file, the resolution order for the hosts database
       lists local first.

    ·  For Production Server, a routing daemon is running. gated is
       recommended, unless ASEROUTING=yes in /etc/rc.config, in which case
       ogated is required. If ogated or gated is running, the clu_ivp utility
       checks the /etc/gated.conf or /etc/ogated.conf file to ensure that the
       Memory Channel interface (for instance, mc0) is set to passive.

    ·  The network interface is configured, and the system can ping the
       entity defined as CLUSTER_NET in /etc/rc.config. For Production
       Server, the system can ping thecluster_cnx service over the Memory
       Channel Software subnet.

    ·  The booted kernel contains TruCluster Software Products support, and
       the TruCluster Software Products kernel subsystems are configured.

    ·  In /etc/sysconfigtab, the value of the cluster_version attribute is
       that of the installed version of the TruCluster software, and the
       value of the cluster_disable attribute is not set to 1.

    ·  For Production Server, if ASE="on" in /etc/rc.config, an ASE
       membership list exists.

    ·  For Production Server and Available Server, all required ASE character
       device files exist.

    ·  A valid Product Authorization Key (PAK) is registered.

    ·  For Production Server and Available Server, the appropriate daemons
       are running and registered with the portmap daemon. The list of
       daemons includes cnxpingd, cnxmond, cnxagentd, asegentd, asehsm, and
       bssd. Which daemons are checked depends on the product and the
       configuration.

    ·  For Production Server, the cnxshow utility validates the connection
       manager subsystem. System clocks on each pair of cluster members are
       within 15 seconds of each other.

    ·  For Production Server, if ASE="on" in /etc/rc.config, the drd_ivp
       utility validates the distributed raw disk (DRD) subsystem. (For more
       information on drd_ivp, see drd_ivp(8).)

    ·  The value of the boot_reset console variable is on.

    ·  For Production Server and Memory Channel Software, all required Memory
       Channel Software character device files exist.

    ·  For Production Server and Available Server, if ASE="on" in
       /etc/rc.config, display a list of shared SCSI bus controllers from
       /sys/conf/HOSTNAME. If one or more controllers is found, display a
       list of configured SCSI devices.

    ·  Display a list of firmware and PALcode revisions.


EXAMPLES

  # clu_ivp This command runs the clu_ivp utility, displaying only error
	    messages.  When successful, the utility displays the following:
		 Cluster Installation Verification Procedure (IVP)

		 Validation was succesful, no errors were detected.

  # clu_ivp -v
	    This command runs the clu_ivp utility, displaying the progress
	    and status of each of its tests as well as error messages.

	    The following output may be displayed at an unsuccessful run of
	    the utility on an Production Server configuration:
		 % clu_ivp -v
		 Cluster Installation Verification Procedure (IVP)
		 Running in verbose mode ...
		 Successfully verified that the TCRCOMMON subset is installed.
		 Successfully verified that the TCRCONF subset is installed.
		 Successfully verified that the TCRMCA subset is installed.
		 Successfully verified that the TCRASE subset is installed.
		 Successfully verified that the TCRDSVC subset is installed.
		 Successfully found CLUSTER_NET pikerm in /etc/rc.config
		 Successfully found mc0 interface configured in /etc/rc.config
		 Successfully found ASE_ID of 0 as a parameter in /etc/rc.config
		 Successfully found host entry in /etc/hosts.
		 Successfully found cluster_cnx in /etc/hosts.
		 Successfully verified host resolution order in /etc/svc.conf.
		 Successfully verified that routed is running.
		 Successfully pinged node pikerm over the cluster interconnect.
		 Successfully pinged alias cluster_cnx over the cluster interconnect.
		 Successfully verified that the booted kernel /vmunix contains required support.
		 Successfully verified that the clubase kernel subsystem is configured.
		 Successfully verified that the rm kernel subsystem is configured.
		 Successfully verified that the drd kernel subsystem is configured.
		 Successfully verified that the ccomsub kernel subsystem is configured.
		 Successfully verified that the dlmsl kernel subsystem is configured.
		 Successfully verified that the cnxagent kernel subsystem is configured.
		 Successfully verified that the dlm kernel subsystem is configured.
		 Successfully verified that the ccm kernel subsystem is configured.
		 Successfully verified that the mcs kernel subsystem is configured.
		 Successfully retrieved version:  Digital UNIX TruCluster T1.5-1 (Rev. 146.1); 05/29/97 17:47
		 Successfully verified that cluster_disable is 0.
		 Successfully verified an ASE member list.
		 Found device /dev/am_host01.
		 Found device /dev/am_host02.
		 Found device /dev/am_host03.
		 Found device /dev/am_host04.
		 Found device /dev/am_host05.
		 Found device /dev/am_host06.
		 Found device /dev/am_host07.
		 Found device /dev/rase.
		 Found device /dev/am.
		 Verified existence of all required ASE device files.
		 Successfully verified that the cluster LMF PAK is registered.
		 Successfully verified that the cnxpingd daemon is running.
		 Verified that the cnxpingd pid file is consistent.
		 Successfully verified that the cnxmond daemon is running.
		 Verified that the cnxmond pid file is consistent.
		 Successfully verified that the cnxagentd daemon is running.
		 Verified that the cnxagentd pid file is consistent.
		 Verified that the cnxagentd daemon is registered with the portmapper.
		 Successfully verified that the bssd daemon is running.
		 Verified that the bssd daemon is registered with the portmapper.
		 Successfully verified that the aseagent daemon is running.
		 Verified that the aseagent pid file is consistent.
		 Verified that the aseagent daemon is registered with the portmapper.
		 Successfully verified that the asehsm daemon is running.
		 Verified that the asehsm pid file is consistent.
		 Verified that the asehsm daemon is registered with the portmapper.
		 Calling cnxshow for configuration verification...
		 Successfully verified that a CNX director exists.
		 Successfully verified that the CNX director is not suspended.
		 Successfully verified CNX comm state of pikerm.
		 Successfully verified that pikerm is a CNX member.
		 CNX ivp tests exiting successfully with no errors found.
		 Successfully passed CNX validation tests.
		 Calling drd_ivp for DRD subsystem verification...

		 Cluster Configuration Information

		 Hostname		ASE_ID	 BSSD	BSSD	DRD    Lic
						  Reg	Resp   Conf    Reg
		 ----------------------------------------------------------
		 pikerm			     0	  Yes	 Yes	Yes    Yes

		 DRD configuration validation tests succeeded.
		 ASE_ID validation tests succeeded.
		 Successfully passed drd_ivp validation tests.
		 Successfully verified that the console variable boot_reset is ON.
		 Successfully found MC character device /dev/pmcs0.
		 Successfully found MC character device /dev/pmcs1.
		 Successfully found MC character device /dev/pmcs2.
		 Successfully verified existence of all required MC character device files.
		 Found these supported SCSI controllers:
		 ------------------------------
		   pza0 is scsi1
		   pza1 is scsi2
		 Scanning EDT............
		 Found these devices on bus scsi1:
		   device	       vendor	drive		 firmware
		   ------	       ------	-----		 --------
		   rrz9c	       DEC	RZ28M		 0466
		   rrz10c	       DEC	RZ28		 T436
		   rrz11c	       DEC	RZ28		 442D
		   rrz12c	       DEC	RZ26		 392A
		 Found these devices on bus scsi2:
		   device	       vendor	drive		 firmware
		   ------	       ------	-----		 --------
		   rrz17c	       DEC	RZ28		 D41C
		   rrz18c	       DEC	RZ28		 D41C
		   rrz19c	       DEC	RZ28		 442D
		   rrz20c	       DEC	RZ26L		 442D
		   rrz21c	       DEC	RZ28		 D41C
		 Please verify firmware levels against the release notes.

		 Firmware rev 4.7 for CPU type 2100
		 Firmware rev A10 on SCSI adapter pza0
		 Firmware rev A10 on SCSI adapter pza1
		 Please verify firmware levels against the release notes.

		 Validation was successful, no errors were detected.


FILE

  /usr/sbin/clu_ivp
	    Specifies the command path.


RELATED INFORMATION

  Commands: drd_ivp(8), cnxshow(8)

Index Index for
Section 8
Index Alphabetical
listing for C
Index Top of
page