cmcheckconf(1m) 														   cmcheckconf(1m)

NAME

       cmcheckconf - check high availability cluster configuration and/or package configuration files

SYNOPSIS

       cmcheckconf [-v] [[-k|-K] -C cluster_ascii_file]
       [[-p pkg_reference_file] | [-P pkg_ascii_file]...]

DESCRIPTION

       cmcheckconf  verifies  the cluster configuration as specified by the cluster_ascii_file and/or the package configuration files specified by
       each pkg_ascii_file in the command.  If the cluster has already been configured previously, the cmcheckconf command will compare  the  con-
       figuration in the cluster_ascii_file against the previously configuration information stored in the binary configuration file and validates
       the changes. The same rules apply to the pkg_ascii_file.  It is not necessary to halt either the cluster or any of the packages to run  the
       cmcheckconf command.

       Only a superuser, whose effective user ID is zero (see id(1) and su(1)), can verify the configuration.

       cmcheckconf verifies any configured external script program in each pkg_ascii_file for the package run and halt function by calling it with
       a "validate" parameter. A non-zero return value from any external script program will cause the command to fail.

       If the cluster_ascii_file specifies a quorum server as the cluster tie-breaker service, the quorum server must be running and all nodes	in
       the  cluster  configuration  must  be  authorized  to access it. If more than one IP address is specified for the quorum server, the quorum
       server must be reachable from all configured nodes through all the IP addresses. Otherwise the cmcheckconf command will fail.

       If the cluster_ascii_file specifies the lock lun devices as the cluster tie breaking service, all nodes must be accessing the same physical
       device.	The  lock  lun device file must be a block device file. The cluster must be down before you can modify a cluster tie-breaking ser-
       vice.

   Options
       cmcheckconf supports the following options:

	      -v	Verbose output will be displayed.

	      -k	Using the -k option means that cmcheckconf only checks disk connectivity to the LVM volume group that  are  identified	in
			the  ASCII file. This option does not exist on Linux. Omitting the -k option (the default behavior) means that cmcheckconf
			tests the connectivity of all LVM volume groups on all the cluster nodes. Using -k  can  result  in  significantly  faster
			operation of the command.  -k must be used with -C and can not be used with -K

	      -K	Using the -K option means that cmcheckconf only checks disk connectivity for cluster lock volume groups. For all other LVM
			volume groups no connectivity will be checked. This option does not exist on Linux.  Omitting the -K option  (the  default
			behavior)  means  that	cmcheckconf tests the connectivity of all LVM volume groups on all the cluster nodes. Using -K can
			result in significantly faster operation of the command.  -K can be used only when cluster is already  configured  and	is
			used with -C -K can not be used with -k.

	      -C cluster_ascii_file
			Name  of  the  cluster	ASCII file to use.  This file can be created by either the cmquerycl command or cmgetconf command.
			See cmquerycl(1m) or cmgetconf(1m).  This is a required parameter if the cluster has never been configured before. If  not
			specified, the local cluster configuration is used.

	      -P pkg_ascii_file...
			Name  of  the  package	configuration  file(s)	to use.  A package configuration template file can be created by using the
			cmmakepkg command and must be customized to include specific information for the package.  See cmmakepkg(1m).  A  configu-
			ration	file  for  an existing package can be generated by using the cmgetconf command. See cmgetconf(1m).  Once a package
			configuration file is generated from the existing configuration using cmgetconf, it can be modified to reflect the desired
			changes for that package.  The package configuration file will be scanned for the purpose of validation.

	      -p  pkg_reference_file
			Name  of the file containing a list of package configuration file(s) to be used.  This file may be necessary if the number
			of pkg_ascii_file names given with multiple -P options do not fit on the command line.	This option cannot  be	used  with
			the -P option.

RETURN VALUE

       Upon completion, cmcheckconf returns one of the following values:

	       0   Successful completion.
	       1   Command failed.

EXAMPLES

       The  high  availability environment contains an ASCII cluster configuration file, and two packages, pkg1 and pkg2, specified in ASCII files
       pkg1.config and pkg1.config.

       To verify the cluster configuration and package files, do the following:

	      cmcheckconf -C clusterA.config -P pkg1.config -P pkg2.config

       To verify the cluster configuration while restricting the connectivity check to the volume groups specified in the clusterA.config file,

	      cmcheckconf -k -C clusterA.config -P pkg1.config -P pkg2.config

       To verify the cluster configuration while restricting the connectivity check to the cluster lock volume groups,

	      cmcheckconf -K -C clusterA.config -P pkg1.config -P pkg2.config

       To specify a long list of package configuration files do the following:

	      cmcheckconf -C clusterA.config -p myfile

       where myfile contains:

	      pkg1.config
	      pkg2.config
	      pkg3.config

       The cluster is up and running, with both packages pkg1, pkg2 running as well.  The package  configuration  file	pkg1.config  contains  the
       changes to the package pkg1.  To verify the package configuration changes made for pkg1, do the following:

		     cmcheckconf -P pkg1.config

AUTHOR

       cmcheckconf was developed by HP.

SEE ALSO

       cmapplyconf(1m), cmdeleteconf(1m), cmgetconf(1m), cmmakepkg(1m), cmquerycl(1m).

						      Requires Optional Serviceguard Software					   cmcheckconf(1m)