Importing And Exporting An Xml Configuration File; Best Practices - Lantronix SGX 5150 Command Reference Manual

Importing and Exporting an XML Configuration File

An XCR can be imported or exported using the following methods:
CLI

XCRs can be imported (captured) or exported (dumped) directly to a Telnet, SSH, or serial line
CLI session. Capturing an XCR can be started by pasting a valid XCR directly into the CLI
prompt. The SGX 5150 IoT device gateway immediately processes the configuration record,
changing any settings specified. 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

Web Manager can be used to import and export an XCR from an external source such as your
local hard drive.
FTP

The SGX 5150 IoT device gateway FTP server can export and import XCRs when an FTP get
or put command on the filename (sgx5150.xcr for export, sgx5150_import.xcr for
import; both are under the pwxcr directory) is requested. On export (FTP get of
sgx5150.xcr), the FTP server obtains the current XCR from the SGX 5150 IoT device
gateway and sends it as a file. On import (FTP put of sgx5150_import.xcr), the FTP
server processes the file by sending it directly to the XML engine. In both cases the SGX 5150
file system is not accessed. The files sgx5150.xcr and sgx5150_import.xcr are not
read from or written to the file system. See the FTP section in the SGX 5150 IoT Device
Gateway User Guide (available at www.Lantronix.com/support/documentation.)

Best Practices

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
Web. See Importing and Exporting an XML Configuration File
Web Manager, the CLI or FTP.
Caution: Using Microsoft Word to edit and save an XCR will change the format of
the file and make it incompatible with the SGX 5150 IoT device gateway.
This is true even if the file is saved as Plain Text (.txt) or an XML
Document (.xml). Notepad, a third party text editor, or a specialized XML
editor should be used instead.
Exporting
Using the Web Manager interface, select from "Lines to Export" and "Groups to Export" filters and
select from either "Export to Browser" or "Download (from link)" option. Save the output to your
local file system.
Importing
Modify the exported file by removing "configgroup" records and filling in any required secret data
such as passwords, and private keys. Using the Web Manager, import the updated clone by
uploading it from your local file system.
SGX TM 5150 IoT Device Gateway Command Reference
4: Configuration Using XML
above to import and export using
19