cmdeleteconf(1m)cmdeleteconf(1m)NAMEcmdeleteconf - Delete either the cluster or the package configuration
SYNOPSIScmdeleteconf [-f] [-v] [-c cluster_name] [[-p package_name]...]
DESCRIPTIONcmdeleteconf deletes either the entire cluster configuration, including
all its packages, or only the specified package configuration. If nei‐
ther cluster_name nor package_name is specified, cmdeleteconf will
delete the local cluster's configuration and all its packages. If the
local node's cluster configuration is outdated, cmdeleteconf without
any argument will only delete the local node's configuration. If only
the package_name is specified, the configuration of package_name in the
local cluster is deleted. If both cluster_name and package_name are
specified, the package must be configured in the cluster_name, and only
the package package_name will be deleted. cmdeleteconf with only clus‐
ter_name specified will delete the entire cluster configuration on all
the nodes in the cluster, regardless of the configuration version. The
local cluster is the cluster that the node running the cmdeleteconf
command belongs to.
Only a superuser, whose effective user ID is zero (see id (1) and su
(1)), can delete the configuration.
To delete the cluster configuration, halt the cluster first. To delete
a package configuration you must halt the package first, but you do not
need to halt the cluster (it may remain up or be brought down). To
delete the package VxVM-CVM-pkg (HP-UX only), you must first delete all
packages with STORAGE_GROUP defined.
While deleting the cluster, if any of the cluster nodes are powered
down, the user can choose to continue deleting the configuration. In
this case, the cluster configuration on the down node will remain in
place and, therefore, be out of sync with the rest of the cluster. If
the powered-down node ever comes up, the user should execute the
cmdeleteconf command with no argument on that node to clean up the con‐
figuration before doing any other Serviceguard command.
Options
cmdeleteconf supports the following options:
-f Force the deletion of either the cluster configuration
or the package configuration.
-v Verbose output will be displayed.
-c cluster_name
Name of the cluster to delete. The cluster must be
halted already, if intending to delete the cluster.
-p package_name
Name of an existing package to delete from the clus‐
ter. The package must be halted already. There
should not be any packages in the cluster with STOR‐
AGE_GROUP defined before having a package_name of
VxVM-CVM-pkg (HP-UX only).
RETURN VALUE
Upon completion, cmdeleteconf returns one of the following values:
0 Successful completion.
1 Command failed.
EXAMPLES
The high availability environment contains the cluster, clusterA , and
a package, pkg1.
To delete package pkg1 in clusterA, do the following:
cmdeleteconf-f -c clusterA -p pkg1
To delete the cluster clusterA and all its packages, do the following:
cmdeleteconf-f -c clusterA
AUTHORcmdeleteconf was developed by HP.
SEE ALSOcmcheckconf(1m), cmapplyconf(1m), cmgetconf(1m), cmmakepkg(1m),
cmquerycl(1m).
Requires Optional Serviceguard Software cmdeleteconf(1m)