4: Configuration Using XML
XPort Pro™ Command Reference
70
xcr import xcr_file "tunnel accept, tunnel connect, tunnel
disconnect, tunnel modem, tunnel packing, tunnel serial,
tunnel start, tunnel stop, line"
The following example exports only accept mode tunneling settings on serial port 1, and
line settings on serial port 4 to a file named tunnel_config_t1_l4.xcr on the device server
filesystem.
xcr export tunnel_config_t1_l4.xcr "tunnel accept:1, line:4"
The following example exports connect mode tunneling and line settings for all ports to
the file tunnel_config.xcr on the device server filesystem:
xcr export tunnel_config.xcr "tunnel, line"
CAUTION:
Do not edit an XCR with Microsoft Word—you will not be able to
import the file, even if you save the document as Plain Text (.txt) or XML
Document (.xml) file. Use Microsoft Notepad instead.
Including Passwords in the XML File
If you log in to a device server to which you will be pasting an XML configuration record,
you do not need to include passwords in the file, since you are already logged in to the
device. However, if you will be sending an XML configuration record to one or more
device server devices that are password protected, you can include the appropriate
passwords in the XML configuration record and forego the usual login steps.
The “xml paste passwords” <configgroup> name is used with the “passwords”
<configitem> name and “cli login” and “cli enable level” values to specify the passwords
to use when the device has been configured with password protection. The password
value is clear text. To protect the password, establish an SSH connection to the device
server.
<!—To supply passwords when importing via cli capture -->
<configgroup name = "xml paste passwords">
<configitem name = "passwords">
<value name = "cli login"></value>
<value name = "cli enable level"></value>
</configitem>
</configgroup>
Special XCR Items
The XML configuration record has several items that do not directly affect the device’s
configuration. These items generally provide functionality to control the device behavior
during XCR importing and are not exported (or are exported with blank values) when an
XCR is generated. Entries that are not exported are marked as Import only in the
“Import/Export column.”
XML Configuration Groups
Table 4-1 lists the XPort XML configuration record groups in alphabetical order. This
table indicates whether each item can be imported, exported, or exported with the
placeholder:
<!--configured and ignored-->.