Cisco Systems OL-27172-01 Mobility Aid User Manual


 
5-23
Cisco Broadband Access Center 3.8 Administrator Guide
OL-27172-01
Chapter 5 Configuration Templates Management
Using the Configuration Utility
Running the Configuration Utility
In subsequent procedures and examples, the phrase running the configuration utility means to enter the
runCfgUtil.sh command from the directory specified. To run the configuration utility, run this command
from the <BPR_HOME>/rdu/bin directory:
runCfgUtil.sh options
The available options include:
-cwmp—Specifies the input file is to be processed as a CWMP technology configuration template
file. Use -cwmp with the -a option.
-a {sc | gc}—Specifies a required action, which could be either:
sc—To specify a syntax check to test if the XML template and dictionary are well-formed. Use
sc with the –l option.
gc—To process a configuration template the same way as the Instruction Generation Service
(IGS) would. Use gc with the (–l and –data), or the (-l and -i) options.
-l filename—Identifies the input file to be on the local file system. For example, if the name of your
input file is any_file, enter -l any_file.
Note Do not use -l with the -r option.
-o filename—Saves the output of template processing in XML format into the specified file. For
example, to save the output in a file called op_file, enter -o op_file This is an optional element.
-i device id—Specifies the device to use for variable substitution when processing the template.
Variable values are retrieved by using the device’s properties. Use with the -r option.
-r filename—Specifies name of template stored in the RDU. Use this option instead of the -l option.
-u username—Specifies the username to be used when connecting to the RDU.
-p password—Specifies the password to be used when connecting to the RDU.
-firmware—Specifies the input file to be a firmware rule template. Otherwise, assume configuration
template.
Adding a Template to Cisco BAC
To use the configuration utility to test BAC templates:
Step 1 Develop the template as described in Authoring Configuration Templates, page 5-14. If the template
includes other templates, make sure all the referenced templates are in the same directory.
Step 2 Run the configuration utility on the local file system. You can check the syntax for the template, or have
the configuration utility process template as IGS would, and return XML output.
If the processed template uses
VAR() constructs to reference a device property, the resulting output will
contain the defaultValues for those
VAR() constructs.
Step 3 Add the template (and any included templates that are used) to the RDU.