Lantronix PremierWave 2050 Installation manual

Part Number 900-767-R
Revision G August 2019
PremierWave® 2050
Enterprise Wi-Fi® IoT Module
Command Reference

PremierWave® 2050 Enterprise Wi-Fi® IoT Module Command Reference 2
Intellectual Property
© 2019 Lantronix, Inc. All rights reserved. No part of the contents of this publication may be
transmitted or reproduced in any form or by any means without the written permission of Lantronix.
Lantronix and PremierWave are registered trademarks of Lantronix, Inc. in the United States and
other countries. DeviceInstaller is a trademarks of Lantronix, Inc.
Patented: http://patents.lantronix.com; additional patents pending.
Windows is a registered trademark of Microsoft Corporation. Wi-Fi is registered trademark of Wi-Fi
Alliance Corporation. All other trademarks and trade names are the property of their respective
holders.
Warranty
For details on the Lantronix warranty policy, please go to our web site at
www.lantronix.com/support/warranty.
Contacts
Lantronix, Inc.
7535 Irvine Center Drive
Suite 100
Irvine, CA 92618, USA
Toll Free: 800-526-8766
Phone: [phone]
Fax: [phone]
Technical Support Online: www.lantronix.com/support
Sales Offices
For a current list of our domestic and international sales offices, go to the Lantronix web site at
www.lantronix.com/about/contact.
Disclaimer
All information contained herein is provided “AS IS.” Lantronix undertakes no obligation to
update the information in this publication. Lantronix does not make, and specifically disclaims,
all warranties of any kind (express, implied or otherwise) regarding title, non-infringement, fitness,
quality, accuracy, completeness, usefulness, suitability or performance of the information provided
herein. Lantronix shall have no liability whatsoever to any user for any damages, losses and
causes of action (whether in contract or in tort or otherwise) in connection with the user’s access or
usage of any of the information or content contained herein. The information and specifications
contained in this document are subject to change without notice.

PremierWave® 2050 Enterprise Wi-Fi® IoT Module Command Reference 3
Open Source Software
Some applications are Open Source software licensed under the Berkeley Software Distribution
(BSD) license, the GNU General Public License (GPL) as published by the Free Software
Foundation (FSF), and the Python Software Foundation (PSF) License Agreement for Python
2.7.6 (Python License). Lantronix grants you no right to receive source code to the Open Source
software. Your use of each Open Source component or software is subject to the terms of the
applicable license. The BSD license is available at http://opensource.org/licenses. The GNU
General Public License is available at http://www.gnu.org/licenses/. The Python License is
available at https://www.python.org/download/releases/2.7/license/.Your use of each Open
Source component or software is subject to the terms of the applicable license.
wpa_supplicant: http://w1.fi/cgit/hostap/plain/wpa_supplicant/README
Openssl : http://openssl.org/source/license.html
Busybox: http://busybox.net/license.html
Dropbear: https://secure.ucc.asn.au/hg/dropbear/raw-file/tip/LICENSE
VSFTPD: https://security.appspot.com/vsftpd.html#about
Bootstrap: https://github.com/twbs/bootstrap/blob/master/LICENSE
Python: https://www.python.org/download/releases/2.7/license/
Linux kernel version 3.10.0. https://www.kernel.org/pub/linux/kernel/COPYING
OPEN SOURCE SOFTWARE IS DISTRIBUTED WITHOUT ANY WARRANTY, INCLUDING ANY
IMPLIED WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
SEE THE APPLICABLE LICENSE AGREEMENT FOR ADDITIONAL INFORMATION.

PremierWave® 2050 Enterprise Wi-Fi® IoT Module Command Reference 4
Revision History
Date Rev. Comments
February 2016 A Initial Document.
July 2016 B Updated for firmware revision 1.0.0.1. Changes include the following:
Group item additions to the “access point” group include: “mode”, “first
client connect timeout”, “last client disconnect timeout”, “channel
selection” and “channel”.
Group item addition to the “bridge” group include “transparent mode.”
Value name “max length” deletion for “diagnostic” group.
Group item deletion to the “interface” group includes “bootp.”
Group item deletion to the “line” group includes “interface.”
Group item addition to the “wlan” group include “band.”
January 2018 C Updated for firmware revision 8.1.0.0R16.
January 2019 D Updated for firmware revision 8.2.0.3R4.
April 2019 E Updated for firmware revision 8.4.0.0.
May 2019 F Updated for firmware revision 8.5.0.0.
August 2019 G Updated for firmware revision 8.7.0.0.

PremierWave® 2050 Enterprise Wi-Fi® IoT Module Command Reference 5
Table of Contents
Intellectual Property ________________________________________________________2
Warranty _________________________________________________________________2
Contacts _________________________________________________________________2
Disclaimer ________________________________________________________________2
Open Source Software ______________________________________________________3
Revision History ___________________________________________________________4
1: About This Guide 8
Chapter Summaries ________________________________________________________8
Conventions ______________________________________________________________8
Additional Documentation ____________________________________________________9
2: Overview 10
XML Architecture and Control ________________________________________________10
Command Line Interface ____________________________________________________10
3: Command Line Interface 11
Configuration Using Telnet __________________________________________________11
Configuration Using the Serial Lines ___________________________________________11
Navigating the CLI Hierarchy ________________________________________________12
Using Keyboard Shortcuts and CLI ____________________________________________13
Understanding the CLI Level Hierarchy ________________________________________13
4: Configuration Using XML 16
XML Configuration Record Document Type Definition _____________________________16
Quick Tour of XML Syntax __________________________________________________17
Record, Group, Item, and Value Tags _________________________________________18
Importing and Exporting an XML Configuration File _______________________________20
Best Practices ____________________________________________________________20
XML Configuration Groups __________________________________________________21
XML Status Record Groups and Items _________________________________________44
5: Commands and Levels 58

PremierWave® 2050 Enterprise Wi-Fi® IoT Module Command Reference 6
List of Figures
Figure 3-1 CLI Level Hierarchy ______________________________________________________14
Figure 3-2 Login Level Commands___________________________________________________15
Figure 3-3 Enable Level Commands__________________________________________________15
Figure 4-4 DTD for XCRs __________________________________________________________16
Figure 4-5 XML Example __________________________________________________________17
Figure 4-6 XML Example __________________________________________________________18
Figure 4-7 XML Example of Multiple Named Values _____________________________________18
Figure 4-8 XML Example of Multiple Items _____________________________________________19
Figure 4-9 XML Example with Multiple Groups__________________________________________19

PremierWave® 2050 Enterprise Wi-Fi® IoT Module Command Reference 7
List of Tables
Table 3-1 Keyboard Shortcuts _____________________________________________________ 13
Table 4-2 XCR Groups __________________________________________________________ 21
Table 4-3 XSR Group and Items___________________________________________________ 44
Table 5-4 Commands and Levels __________________________________________________ 69

PremierWave® 2050 Enterprise Wi-Fi® IoT Module Command Reference 8
1: About This Guide
This document describes how to configure the Lantronix® PremierWave® 2050 enterprise Wi-Fi®
IoT module using the Command Line Interface (CLI) and/or Extensible Markup Language (XML).
CLI provides an interactive mode for accessing the module configuration and management
interface. It is most suited for system and network administrators comfortable with using similar
interfaces on enterprise IT and networking products. It is also helpful as a quick tool for access via
the product's serial ports or console/management ports. XML provides an extensible mode for
software developers interfacing with the module and system integrators performing batch
provisioning/updates.
Chapter Summaries
This table lists and summarizes the content of each chapter.
Conventions
The table below lists and describes the conventions used in this book.
Chapter Summary
2: Overview Gives an overview of CLI and XML.
3: Command Line Interface Lists commands and describes how to use CLI to configure the
PremierWave 2050 module.
4: Configuration Using XML Lists XML Configuration Record (XCR) groups and items and describes
how to use XCRs to configure the PremierWave 2050 module.
5: Commands and Levels Provides an index of the CLI command hierarchy with hyperlinks to the
corresponding command details.
Convention Description
Bold text Default parameters
Italic text Required values for parameters.
Square Brackets [ ] Optional parameters.
Angle Brackets < > Possible values for parameters.
Pipe | Choice of parameters.
Warning Warning: Means that you are in a situation that could cause equipment
damage or bodily injury. Before you work on any equipment, you must be
aware of the hazards involved with electrical circuitry and be familiar with
standard practices for preventing accidents.
Note Note: Means take notice. Notes contain helpful suggestions, information, or
references to material not covered in the publication.
Caution Caution: Means you might do something that could result in faulty
equipment operation or loss of data.
Screen Font CLI terminal sessions and examples of CLI input are depicted in courier new
font.

1: About This Guide
PremierWave® 2050 Enterprise Wi-Fi® IoT Module Command Reference 9
Additional Documentation
Visit the Lantronix website at www.Lantronix.com/support/documentation for all latest Lantronix
documentation which includes the latest versions of the PremierWave 2050 module-related
documentation listed below.
Document Description
PremierWave 2050 Enterprise Wi-Fi IoT
Module User Guide
Describes how to configure and use the PremierWave 2050
module.
PremierWave 2050 Enterprise Wi-Fi IoT
Module Evaluation Kit User Guide
Information for using the PremierWave 2050 module on the
evaluation board.
PremierWave 2050 Evaluation Board
Quick Start Guide
Instructions for getting the PremierWave 2050 module up and
running.
PremierWave 2050 Enterprise Wi-Fi IoT
Module Product Brief
Provides key feature, SKU option, technical specifications,
and order information about the PremierWave 2050 module.
PremierWave 2050 Enterprise Wi-Fi IoT
Module Integration Guide
Contains information about the PremierWave 2050 hardware
and integrating the module into your product.
Com Port Redirector Quick Start and
Online Help
Instructions for using the Lantronix Windows® operating
system (OS) -based utility to create virtual com ports.
DeviceInstaller Online Help Instructions for using the Lantronix Windows OS-based utility
to locate and view the current settings of the PremierWave
2050 module.

PremierWave® 2050 Enterprise Wi-Fi® IoT Module Command Reference 10
2: Overview
The PremierWave 2050 module supports three convenient configuration methods: Web Manager,
CLI, and XML. For more information about Web Manager, see the PremierWave 2050 Enterprise
Wi-Fi IoT Module User Guide available at www.Lantronix.com/support/documentation.
XML Architecture and Control
XML is a fundamental building block for Machine-to-Machine (M2M) and Internet of Things (IoT)
networks. The PremierWave 2050 module supports XML configuration records that make
configuring the PremierWave 2050 module easy for users and administrators. XML configuration
records are easy to edit with a standard text editor or an XML editor.
For a brief overview of XML, see 4: Configuration Using XML. It provides guidelines for basic XML
syntax, the specific XML tags used, and XML configuration records.
Command Line Interface
Making the edge-to-enterprise vision a reality, the PremierWave 2050 module uses industry-
standard tools for configuration, communication, and control. For example, the PremierWave 2050
module uses a command line interface (CLI) whose syntax is very similar to that used by data
center equipment such as routers and hubs.
For details of the CLI, see 5: Commands and Levels. It provides an index of the CLI Command
Hierarchy with links to the corresponding command details. The CLI provides commands for
configuring, monitoring, and controlling the PremierWave 2050 module.

PremierWave® 2050 Enterprise Wi-Fi® IoT Module Command Reference 11
3: Command Line Interface
This chapter describes accessing the PremierWave 2050 enterprise Wi-Fi IoT module by using
Telnet, SSH, or serial ports to configure the module, navigating the CLI, typing keyboard shortcuts,
and moving between the levels.
It contains the following sections:
Configuration Using Telnet
Configuration Using the Serial Lines
Navigating the CLI Hierarchy
Using Keyboard Shortcuts and CLI
Understanding the CLI Level Hierarchy
Refer to Chapter 5: Commands and Levels for a complete list of levels, commands, and
descriptions.
Configuration Using Telnet
To access and configure the PremierWave 2050 module by using a Telnet session over the
network, you must first establish a Telnet connection. You can also establish a Telnet connection
by clicking the Telnet Configuration tab in the Lantronix® DeviceInstaller™ utility. See the
DeviceInstaller Online Help for more information.
To access the PremierWave 2050 module by using Telnet, perform the following steps.
1. Click Start > Run. The Run dialog box displays.
2. Type cmd in the dialog box and press OK.
3. Type telnet x.x.x.x (x.x.x.x is the IP address) in a Windows/Linux command prompt.
4. The PremierWave 2050 module is online when the command prompt (>) displays. You are at
the root level of the CLI.
Note: Depending on the level of security, a password may be required.
Configuration Using the Serial Lines
Serial Command Mode
The serial port can be configured to operate in command mode permanently or to be triggered
under specified conditions. See the line <line> Level command description for more information.
Serial Recovery
Serial Recovery mode will temporarily override line settings for the serial line to allow configuration
changes to be made. Line settings will be restored once the user exits the Serial Recovery mode
CLI.

3: Command Line Interface
PremierWave® 2050 Enterprise Wi-Fi® IoT Module Command Reference 12
To configure the PremierWave 2050 module locally using a serial port:
1. Connect a terminal or a PC running a terminal emulation program to one of the module's serial
ports.
2. Configure the terminal to the following settings:
9600 baud
8-bit
No parity
1 stop bit
No flow control.
3. Power off the module.
4. Press and hold down the exclamation point (!) key.
5. Power on the module. After about 10 seconds, the exclamation point will display on the
terminal or PC screen.
6. Type xyz within 5 seconds to display the CLI prompt.
Navigating the CLI Hierarchy
The CLI is organized into a hierarchy of levels. Each level has a group of commands for a specific
purpose. For example, to configure a setting for the FTP server, one would navigate to the FTP
level, which is under the configuration level.
To move to a different level—Enter the name of the level from within its parent level. For
example, to enter the line level, type line <number> at the enable prompt. This displays:
<enable> line <number>#.
To exit and return to one level higher—Type exit and press the Enter key. Typing exit at
the login level or the enable level will close the CLI session.
To view the current configuration at any level—Type show.
To view the list of commands available at the current level—Type the question mark "?". Items
within < > (e.g. <string>) are required parameters.
To view the available commands and explanations—Type the asterisk (*).
To view the list of commands available for a partial command—Type the partial command
followed by the question mark "?". For example: <line 1>#show? displays a list of all show
commands at the line level.
To view available commands and their explanations for a partial command—Type the partial
command followed by the asterisk (*). For example: <line 1>#show* displays a list of all
show commands and descriptions at the line level.
To view the last 20 commands entered at the CLI—Type show history.

3: Command Line Interface
PremierWave® 2050 Enterprise Wi-Fi® IoT Module Command Reference 13
Using Keyboard Shortcuts and CLI
One useful shortcut built into the PremierWave 2050 module is that the complete text of a
command does not have to be entered to issue a command. Typing just enough characters to
uniquely identify a command, then hitting enter, can be used as a short cut for a command. For
example, at the enable level, "sh" can be used for the "show" command.
Tab Completion is also available using the Tab and Enter keys on the keyboard. Typing the first
few characters of a command, then hitting the Tab key displays the first command that begins with
those characters. Hitting the Tab key again displays the next command that begins with the
original characters typed. You can press Enter to execute the command or you can backspace to
edit any parameters.
The following key combinations are allowed when configuring the intelligent gateway using the
CLI:
Table 3-1 Keyboard Shortcuts
Understanding the CLI Level Hierarchy
The CLI hierarchy is a series of levels. Arranging commands in a hierarchy of levels provides a
way to organize and group similar commands, provide different levels of security, and reduce the
complexity and number commands and options presented to a user at one time.
When you start a command line session, you begin at the login level. This level can be password
protected and provides access to high level status, a few diagnostic commands, and the enable
level. Further module information and configuration are accessed via the enable level.
The enable level can also be password protected and is the gateway to full configuration and
management of the intelligent gateway. There are commands for gathering and effecting all
elements of module status and configuration, as well as commands that take you to additional
levels. For instance, network specific status and configuration commands are found under the
"configuration" level.
Key Combination Description
Ctrl + a Places cursor at the beginning of a line
Ctrl + b Backspaces one character
Ctrl + d Deletes one character
Ctrl + e Places cursor at the end of the line
Ctrl + f Moves cursor forward one character
Ctrl + k Deletes from the current position to the end of the line
Ctrl + l Redraws the command line
Ctrl + n Displays the next line in the history
Ctrl + p Displays the previous line in the history
Ctrl + u Deletes entire line and places cursor at start of prompt
Ctrl + w Deletes one word back
Ctrl + z Exits the current CLI level
Esc + b Moves cursor back one word
Esc + f Moves cursor forward one word

3: Command Line Interface
PremierWave® 2050 Enterprise Wi-Fi® IoT Module Command Reference 14
An overview of the levels in the PremierWave 2050 module is presented in Figure 3-1 CLI Level
Hierarchy.
Figure 3-1 CLI Level Hierarchy
Commands at the login level (see Figure 3-2 Login Level Commands below) do not affect current
configuration settings and are not displayed initially. If you type ?, you will see the login
subcommands. These commands provide diagnostic and status information only.
(login) enable
syslog
terminal network
line <number>
configure
device
terminal <number>
ssl
bridge 1
access point
clock
diagnostics
gateway
ip
vpn 1
wlan profiles
user management
usb 1
credentials
trusted authorities
icmp
cli
arp
discovery
If 2
ftp
If 1
dns
email <number>
filesystem
ssh client
server
tunnel <number> accept
connect
disconnect
modem
packing
serial
gre 1
http
applications
mach10
modbus
rss
smtp
snmp
reboot schedule
mass storage
xml
action
icmp
If 3
host
http

3: Command Line Interface
PremierWave® 2050 Enterprise Wi-Fi® IoT Module Command Reference 15
Figure 3-2 Login Level Commands
pw2050-0080a3a0a4e4>?
clrscrn exit
iperf <params> ping <host>
ping <host> <count> ping <host> <count> <timeout>
ping6 <host> ping6 <host> <count>
ping6 <host> <count> <timeout> show
show history show lines
show multicast routes show routes
show rules tcpdump <parameters>
trace route <host> trace route <host> <protocol>
enable
pw2050-0080a3a0a4e4>
Note: To configure the PremierWave 2050 module, you must be in the enable level and
any of its sub-levels. Figure 3-3 Enable Level Commands below shows the enable level
commands.
Figure 3-3 Enable Level Commands
pw2050-0080a3a0a4e4(enable)#?
auto show interfaces auto show processes
clrscrn configure
connect connect line <line>
device disable
dns email <number>
exit filesystem
iperf <params> kill ssh <session>
kill telnet <session> line <line>
ping <host> ping <host> <count>
ping <host> <count> <timeout> ping6 <host>
ping6 <host> <count> ping6 <host> <count> <timeout>
reload reload factory defaults
show show history
show interfaces show ip sockets
show lines show multicast routes
show processes show routes
show rules show sessions
ssh ssh <optClientUsername> <host>
ssh <optClientUsername> <host> <port> ssl
tcpdump <parameters> telnet <host>
telnet <host> <port> trace route <host>
trace route <host> <protocol> tunnel <line>
usb <line> write
xml
pw2050-0080a3a0a4e4(enable)#
See the Chapter 5: Commands and Levels at the end of this document for a complete list of levels,
commands, and descriptions.

PremierWave® 2050 Enterprise Wi-Fi® IoT Module Command Reference 16
4: Configuration Using XML
The PremierWave 2050 module provides an XML interface that you can use to configure
PremierWave 2050 modules. Every configuration setting that can be issued from the module’s
Web Manager interface and CLI can be specified using XML.
The PremierWave 2050 module can import and export configuration settings as an XML document
known as an XML Configuration Record (XCR). An XCR can be imported or exported via the CLI,
a Web browser, or FTP. An XCR can contain many configuration settings or just a few. For
example, it might change all of the configurable parameters for a PremierWave 2050 module, or it
may only change the baud rate for a single serial line. Using XCRs is a straightforward and flexible
way to manage the configuration of multiple PremierWave 2050 modules.
XML Configuration Record Document Type Definition
An XML document type definition (DTD) is a description of the structure and content of an XML
document. It verifies that a document is valid. XCRs are exported using the DTD as shown in
Figure 4-4 DTD for XCRs.
Figure 4-4 DTD for XCRs
<!DOCTYPE configrecord [
<!ELEMENT configrecord (configgroup+)>
<!ELEMENT configgroup (configitem+,configgroup*)>
<!ELEMENT configitem (value+)>
<!ELEMENT value (#PCDATA)>
<!ATTLIST configrecord version CDATA #IMPLIED>
<!ATTLIST configgroup name CDATA #IMPLIED>
<!ATTLIST configgroup instance CDATA #IMPLIED>
<!ATTLIST configitem name CDATA #IMPLIED>
<!ATTLIST value name CDATA #IMPLIED>
]>
The PremierWave 2050 DTD rules state the following:
The XML document element is a <configrecord> element. This is the root element.
A <configrecord> must have one or more <configgroup> elements and can have a
version attribute.
A <configgroup> must have one or more <configitem> elements and can have name
and instance attributes.
A <configitem> element must have one or more <value> elements and can have a name
attribute.
A <value> element can have only data and can have a name attribute.
The name attribute identifies a group, item, or value. It is always a quoted string.
The instance attribute identifies the specific option, like the serial port number. The "instance"
attribute is always a quoted string.

4: Configuration Using XML
PremierWave® 2050 Enterprise Wi-Fi® IoT Module Command Reference 17
Notes:
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 2050 Enterprise Wi-Fi IoT Module User Guide (available at
www.Lantronix.com/support/documentation) 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-5 XML Example shows an XML example which consists of a declaration (first line),
nested elements with attributes and content.
Figure 4-5 XML Example
<configrecord version=”0.1.0.0T0”>
<configgroup name = “diagnostics”>
<configitem name = “log”>
<value name=”output”>Disable</value>
</configitem>
</configgroup>
</configrecord>
The PremierWave 2050 module uses the attributes in the following subsections to label the group
configuration settings.

4: Configuration Using XML
PremierWave® 2050 Enterprise Wi-Fi® IoT Module Command Reference 18
Record, Group, Item, and Value Tags
A<configgroup> is a logical grouping of configuration parameters and must contain one or
more <configitem> elements. It must have a name attribute and may have an instance attribute.
A <configitem> is a specific grouping of configuration parameters relevant to its parent group.
An item takes the name attribute and must contain one or more value elements. For example, the
line group might have parameters such as baud rate, data bits, and parity.
A value may specify the value of a configuration parameter. It may contain the name attribute. In
this example, a value of 9600 might be specified for baud rate; 7 may be specified for data bits,
and even may be specified for parity.
A name attribute identifies the group, item, or value. It is always quoted (as are all XML attributes).
For example, a group that contains serial port parameters has the name "line".
An instance attribute identifies which of several instances is being addressed. It is always quoted.
For example, the serial port name (in the line configgroup) has the instance "1" to indicate serial
port 1 or "2" to specify serial port 2..
The following figures show examples of XML configuration records and the use of the
<configrecord>, <configgroup>, <configitem>, and <value> XML elements.
Figure 4-6 XML Example
<configrecord version=”0.1.0.0T0”>
<configgroup name = “diagnostics”>
<configitem name = “log”>
<value name=”output”>Disable</value>
</configitem>
</configgroup>
</configrecord>
Figure 4-7 XML Example of Multiple Named Values
<configrecord version="0.1.0.0T0">
<configgroup name=“xml import control">
<configitem name=“restore factory configuration">
<value>disable</value>
</configitem>
<configitem name=“delete http authentication uris">
<value>disable</value>
</configitem>
<configitem name=“http authentication uri delete">
<value name=“name"/>
</configitem>
<configitem name=“reboot">
<value>disable</value>
</configitem>
</configgroup>

4: Configuration Using XML
PremierWave® 2050 Enterprise Wi-Fi® IoT Module Command Reference 19
Figure 4-8 XML Example of Multiple Items
<configrecord version="0.1.0.0T0">
<configgroup name="device">
<configitem name="short name">
<value>premierwave_2050</value>
</configitem>
<configitem name="long name">
<value>Lantronix PremierWave 2050</value>
</configitem>
<configitem name="serial number">
<value>0080A3946149</value>
</configitem>
</configitem><configitem name="firmware version">
<value>8.1.0.1R16</value>
</configitem><configitem name="lantronix iot gateway os version">
<value>1.0</value>
</configitem>
</configgroup>
Figure 4-9 XML Example with Multiple Groups
<configrecord version="0.1.0.0T0">
<configgroup name="diagnostics">
<configitem name="log">
<value name="output">Disable</value>
</configitem>
</configgroup>
<configgroup name=“discovery">
<configitem name=“state">
<value>enable</value>
</configitem>
<configitem name=“upnp state">
<value>enable</value>
</configitem>
<configitem name=“upnp port">
<value>30179</value>
</configitem>
</configgroup>
<configgroup name=“ethernet" instance="eth0">
<configitem name=“speed">
<value>Auto</value>
</configitem>
<configitem name=“duplex">
<value>Auto</value>
</configitem>
</configgroup>
<configgroup name=“ftp server">
<configitem name=“state">
<value>enable</value>
</configitem>
</configgroup>

4: Configuration Using XML
PremierWave® 2050 Enterprise Wi-Fi® IoT Module Command Reference 20
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 PremierWave 2050 module 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 PremierWave 2050 module FTP server can export and import XCRs when an FTP get or
put command on the filename (PW2050.xcr for export, PW2050_import.xcr for import;
both are under the pwxcr directory) is requested. On export (FTP get of PW2050.xcr), the
FTP server obtains the current XCR from the PremierWave 2050 module and sends it as a
file. On import (FTP put of PW2050_import.xcr), the FTP server processes the file by
sending it directly to the XML engine. In both cases the PremierWave 2050 file system is not
accessed. The files PW2050.xcr and PW2050_import.xcr are not read from or written to
the file system. See the FTP section in the PremierWave 2050 Enterprise Wi-Fi IoT Module
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 above to import and export using
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 PremierWave 2050 module.
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.