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)