cmgr.1m (2011 09)
CMGR(1M) CMGR(1M)
NAME
cmgr - Configuration synchronization manager
SYNOPSIS
cmgr -add -delete -list -replace -import -export -status
-t <template> [-b] [-p <prompt>] [-v] [-V] [-x <xpath>]
[-xfile <filename>] [-xml[output]]
[<variable>=<value>...]
cmgr -h[elp] [-t <template>] [-v] [-x <xpath>]
DESCRIPTION
The cmgr command is used to coordinate the configuration of multiple subsystems. Related configuration
changes can be added, viewed, replaced, or deleted as a set.
The cmgr command line arguments are combined with
XML based cmgr Synchronization Templates (see
cst documentation) that define the actual configuration operations to perform.
The cmgr command can be run as a command line, or in batch mode. Batch mode suppresses the guided
prompt-based processing of the specified template.
The cmgr can be used to coordinate the configuration of HP-UX compartments, Process Resource
Management (
PRM), IPFilter, IPSec, network interfaces, and subsystems managed via a command line
interface. Additional subsystem support can by added by implementing and deploying Perl based cmgr
handler libraries. See the cmgr administration and customization guide for additional information.
Template Processing
The cmgr templates include <head>, and optionally <prologue> and <body> XML elements.
Unless otherwise directed by the xpath argument, cmgr will process elements in the order encountered,
and nested sub elements using a tree-ordered traversal (process lowest order set of sub-elements first).
cmgr provides handler routines for each element type defined in the cst documentation. Additional ele-
ment types can be supported by providing new handler routines.
OPTIONS
The cmgr command accepts the following options:
-a, -add
Instructs cmgr to execute the add operation for the template elements specified by the xpath option
for the template.
The add operation is used to introduce a set of new configuration data specified by the template.
The cmgr command will exit when the first error is encountered during an add operation.
HP recom-
mends that you execute a -delete operation on the template to remove any subsystem configuration
applied before the failure occurred
-b, -batch
Run cmgr in batch mode. The cmgr command will not prompt for template variable values. If cmgr
encounters an unassigned variable that does not have a default, it will exit with an error.
-d, -delete
Instructs cmgr to execute the delete operation for the template elements specified by the xpath
option for the template specified by the template option.
The delete operation is used to remove a set of existing configuration data specified by the template.
The cmgr command will process all elements specified in the xpath option for a delete operation. If
an error occurs during the execution of any element, cmgr will return an error after processing all
elements. This allows cmgr to remove configuration sets that were only partially added before a
failure occurred.
-export
Instructs cmgr to execute the export operation for the template elements specified by the xpath
option for the template specified by the template option.
The export operation is used to export data in
XML format to the exchange file specified by the xfile
option.
HP-UX 11i Version 3: September 2011 − 1 − Hewlett-Packard Company 1