cmgetconf(1m)															     cmgetconf(1m)

NAME

       cmgetconf - Get cluster or package configuration information

SYNOPSIS

       cmgetconf [-v {0 | 1 | 2}] [[-K] -c cluster_name] [-p package_name] [output_filename]
       cmgetconf [-v {0 | 1 | 2}] [[-K] -c cluster_name] [-P dirname]
       cmgetconf [-v {0 | 1 | 2}] [-K]

DESCRIPTION

       cmgetconf  obtains either the cluster configuration, not including the package configuration, and with or without the volume group informa-
       tion (-K option), or the specified package's configuration information (-p option), and writes to either the output_filename  file,  or	to
       stdout.	 With  the  -P	option,  cmgetconf obtains the configuration information for all packages and writes to the directory specified by
       dirname.  This command can be run whether the cluster is up or down.  If -c , -p , or -P are not specified, cmgetconf will obtain the local
       cluster's configuration.  Local cluster is the cluster containing the node where the cmgetconf command is issued.  If both cluster_name and
       package_name are specified, the package must be configured in cluster_name, and only the package configuration  for  package_name  will	be
       written	to  output_filename  or  to stdout. The dirname parameter is required with the -P option. If cluster_name is specified with the -P
       option, the configuration of all the packages configured in the cluster_name will be written out to the	directory  specified  by  dirname.
       Each  configured  package  configuration  will be written out to the the specified dirname in a separate file named by appending the suffix
       .ascii to the name of the package.  The -K option prevents probing of volume groups, reducing the time to  get  the  cluster  configuration
       file.

       NOTE:   When  this command is run by an authorized user who is not the superuser(UID=0), only those entries that match the user running the
       command and the node where the command is run are displayed.

       To view cluster or package information, a user must either be superuser(UID=0), or have an access policy of MONITOR allowed in the  cluster
       configuration  file, or have an access policy of PACKAGE_ADMIN allowed in one of the cluster package configuration files. See access policy
       in cmquerycl(1) or cmmakepkg(1).

       To modify the configuration of an existing cluster, the user needs to have the cluster's corresponding configuration file.  To get the cur-
       rent  cluster's configuration file, run cmgetconf first.  Once created, the output_filename can be edited to add or delete nodes.  The node
       configuration information should be retrieved from the cmquerycl command.  Some cut and paste may be necessary.

       To modify the configuration of an existing package, the user needs to have the package's corresponding configuration file first.  cmgetconf
       can  be	used  to  produce the package configuration file, then edit it to make the desired modifications, e.g.	changing the list of nodes
       that can run the package, changing the subnet, etc.

       The modified configuration file can then be used in the cmapplyconf command to update either the cluster configuration or the package  con-
       figuration.

   Options
       cmgetconf supports the following options:

	      -v 0|1|2	Verbose output will be displayed. The -v option applies only when cmgetconf is used to obtain package configuration infor-
			mation.  It is ignored if used to obtain cluster configuration information.

			0     (data_only mode) The package configuration file will include only the configured attribute values.

			1     (headline mode) The package configuration file will include the headline description and legal value for	each  con-
			      figured and configurable attribute for the package.

			2     (verbose	mode) The package configuration file will include the full description and legal value for each configured
			      and configurable attribute for the package.  This is the default.

	      -c cluster_name
			Name of the cluster for which to query cluster information.

	      -K	This option causes the probing of volume groups to be skipped, reducing the time for the command to complete.  This option
			is  not  available  for  Linux.  Note that if this option is used, cmgetconf will not add the list of cluster-aware volume
			groups to the resulting cluster configuration file.  You must add the cluster-aware volume groups to the cluster  configu-
			ration	file  before  running  cmapplyconf,  or use the -K option of cmapplyconf when applying the generated configuration
			file.  Failure to do so will result in all volume groups in the cluster being unusable in  packages  or  for  the  cluster
			lock.

	      -p package_name
			Name of an existing package for which to query package information.  This option is mutually exclusive to the -P option.

	      -P	This  option  will  write all package's configuration information to a specified output_filename.  This option is mutually
			exclusive to the -p option.

	      output_filename
			If -c and/or -p options are specified, the name of the file into which cmgetconf will copy cluster or  package	configura-
			tion  information.   If  this  parameter is not specified, the information will be directed to stdout. If the -P option is
			specified, the name of the directory into which cmgetconf will copy the configuration information for all  packages.  This
			parameter is required when -P option is specified.

RETURN VALUE

       Upon completion, cmgetconf returns one of the following values:

	       0   Successful completion.
	       1   Command failed.

EXAMPLES

       The high availability environment contains the cluster, clusterA , and packages pkg1 and pkg2.

       To generate the cluster configuration file for clusterA, and store the information in clusterA.conf, do the following:

	      cmgetconf -c clusterA clusterA.conf

       To  generate  the cluster configuration file for clusterA, skipping disk probing, and store the information in clusterA.config, do the fol-
       lowing:

	      cmgetconf -K -c clusterA clusterA.config

       To generate the package configuration file for pkg1, and store the information in pkg1.conf, do the following:

	      cmgetconf -c clusterA -p pkg1 pkg1.conf

       To generate the package configuration files for all packages in the cluster, and store the information in the directory /tmp/pkgconfig,	do
       the following:

	      mkdir /tmp/pkgconfig
	      cmgetconf -c clusterA -P /tmp/pkgconfig

       The directory /tmp/pkgconfig will contain two files, pkg1.ascii and pkg2.ascii.

AUTHOR

       cmgetconf was developed by HP.

SEE ALSO

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

						      Requires Optional Serviceguard Software					     cmgetconf(1m)