cmscancl(1m)															      cmscancl(1m)

NAME

       cmscancl - gather system configuration information from nodes with Serviceguard installed.

SYNOPSIS

       cmscancl [-n node_name]...  [-s|-o output_file]

DESCRIPTION

       cmscancl is a configuration report and diagnostic tool intended only for use by HP Support Personnel.  It gathers system software and hard-
       ware configuration information from a list of nodes, or from all the nodes in a	cluster.   The	information  that  this  command  displays
       includes  LAN  device  configuration,  network status and interfaces, file systems, LVM configuration, link-level connectivity (HPUX only),
       IPv4/IPv6 connectivity, and the data from the binary cluster configuration file.  This command can be used as a troubleshooting tool or	as
       a data collection tool.

       This command is a Perl script which gathers system configuration information by executing various OS commands or tools.	It uses the cmexec
       command to gather information from remote nodes.

       The -n option can be used to specify a list of nodes to be scanned, the nodes to be scanned do not need to be a member of  a  cluster.	If
       the -n option is not specified, it will scan all the nodes in the local cluster.

       By  default, the output of this command will go to the file /tmp/scancl.out.  If the file /tmp/scancl.out already exists, the old file will
       be saved in /tmp/scancl.out.old.

       The -o option can be used to redirect output to a specified output file.  If the -o option is not specified, output will go to the  default
       output file /tmp/scancl.out.

       The -s option can be used to direct all output to the screen, instead of to an output file.

   Options
       cmscancl supports the following options:

	      -n node_name...  Specify	the  node(s)  to  be  scanned.	If this option is not specified and there is a cluster configured, all the
			       nodes in the cluster will be scanned.  If this option is not specified and there is no cluster configured, only the
			       local node will be scanned.

	      -o  output_file  Write  configuration information to a specified output file.  If this option is not specified, the information will
			       be directed to stdout.

	      -s	       Display the configuration information to the screen only.  This option cannot be used in conjunction  with  the	-o
			       option.

       The output from this command contains the following information:

	      LAN device configuration	    (On HP-UX, output from lanscan; On Linux, output from ifconfig)

	      network status and interfaces (output from netstat)

	      file systems		    (output from mount)

	      LVM configuration 	    (contents of /etc/lvmtab file)

	      LVM physical vg information   (contents of /etc/lvmpvg file)

	      link-level connectivity (HP-UX only)
					    (output from linkloop)

	      IPv4/IPv6 connectivity	    (results from ping (and ping6 on Linux))

	      binary configuration file data
					    (output from cmviewconf)

RETURN VALUE

       cmscancl returns the following value:

	      0    Successful completion.
	      1    Command failed.

EXAMPLES

       To gather the configuration information from node1 and node2 and to save the output in file /tmp/scancl.log:

		 cmscancl -n node1 -n node2 -o /tmp/myscancl.log

       To gather the configuration information from all the nodes in the cluster and save the output to the file: /tmp/scancl.log:

		 cmscancl -o /tmp/myscancl.log

       To gather the configuration information from all the nodes in the cluster and display the output on the screen:

		 cmscancl -s

       To gather the configuration information from all the nodes in the cluster and save the output to the file /tmp/scancl.out:

		 cmscancl

AUTHOR

       cmscancl was developed by HP.

SEE ALSO

       Linux:
	 cmviewcl(1), mount(8), netstat(8), ping(8), ping6(8)
       HP-UX:
	 cmviewcl(1m), lanscan(1m), linkloop(1m), mount(1m), netstat(1), ping(1m)

						      Requires Optional Serviceguard Software					      cmscancl(1m)