4: Configuration Using XML
XPort Pro™ Command Reference
68
<configitem name = "allow file creation">
<value>disable</value>
</configitem>
</configgroup>
Importing and Exporting an XML Configuration File
An XML configuration record can be imported or exported using the following methods:
Filesystem
XCRs can be saved to the device server’s file system and imported or
accessed as needed. See the Best Practices section below or the File System
Browser Page in the User Guide.
CLI
an XML configuration record can be imported (captured) or exported
(dumped) directly to a Telnet, SSH, or serial line CLI session. Capturing an XML
configuration record can be started by pasting a valid XCR directly into the CLI
prompt. Evolution OS will immediately process the configuration record, changing
any settings specified in the XCR. This can be done on any level, including the root.
Special tags in the XML allow for providing root and enable level passwords so that
this can also be done at the password prompt.
Web browser
the Web interface can be used to import and export an XCR to the
device server’s file system. It can also be used to import an XCR from an external
source such as your local hard drive.
FTP
The device server’s FTP server will export and import XCRs when a get or a
put on the file xport_pro.xcr is requested. On export (FTP get of xport_pro.xcr), the
FTP server obtains the current XCR from Evolution OS™ and sends it as a file. On
import (FTP put of xport_pro.xcr), the FTP server processes the file by sending it
directly to the XML engine. In both cases the device server’s filesystem is not
accessed. The file xport_pro.xcr is not read from, or written to the file system. See
the FTP Page in the User Guide.
Note:
The Trivial File Transfer Protocol (TFTP) is not supported for importing
XML configuration files because it does not provide any security features.
Best Practices
Importing and Exporting Partial Configurations
You can import or export an entire XCR, or just a portion of it, by specifying the group
name and/or group instances. In the examples below, import and export operations are
performed from the CLI on the local filesystem and require a XCR on the local filesystem.
The Web Manager provides the same functionality.
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.
The following syntax can be used to import configurations from a file on the device
server’s file system: