4: Configuration Using XML
PremierWave® XC Intelligent Gateway Command Reference
15
Note:
The name for each <configgroup> (specified with the name attribute) is the group
name listed in the Web Manager XCR groups or with the "xcr list" CLI command. See
the PremierWave XC Intelligent Gateway User Guide for more information about the
XCR groups.
An empty or missing <value> element in each present <configgroup> clears the
setting to its default.
Quick Tour of XML Syntax
Declaration
The first line,
<?xml version="1.0" standalone="yes"?>
, is called the XML declaration.
It is required and indicates the XML version in use (normally version 1.0). The remainder of the file
consists of nested XML elements, some of which have attributes and content.
Element Start and End Tags
An element typically consists of two tags: start tag and an end tag that surrounds text and other
elements (element content). The start tag consists of a name surrounded by angle brackets, for
example
<configrecord>
. The end tag consists of the same name surrounded by angle
brackets, but with a forward slash preceding the name, for example
</configrecord>
. The
element content can also contain other "child" elements.
Element Attributes
The XML element attributes that are name-value pairs included in the start tag after the element
name. The values must always be quoted, using single or double quotes. Each attribute name
should appear only once in an element.
Figure 4-2
shows an XML example which consists of a declaration (first line), nested elements with
attributes and content.
Figure 4-2 XML Example
<?xml version=”1.0” standalone=”yes”?>
<configrecord>
<configgroup name = “serial command mode” instance = “1”>
<configitem name = “mode serial string”>
<value>disable</value>
</configitem>
</configgroup>
</configrecord>
The PremierWave XC device uses the attributes in the following subsections to label the group
configuration settings.
