Lantronix 900-560 User Manual

XPort Pro
User Guide
Part Number 900-560
Revision D April 2012

Copyright & Trademark

© 2012 Lantronix. All rights reserved. No part of the contents of this book may be transmitted or reproduced in any form or by any means without the wr itten permission of Lantron ix. Printed in the United States of America.
Ethernet is a trademark of XEROX Corporation. UNIX is a registered trademark of The Open Group. Windows is a trademark of Microsoft Corporation.

Warranty

For details on the Lantronix warranty replacement policy, please go to our web site at
www.lantronix.com/support/warranty

Patents

Patent #4,972,470; other patents pending.

Contacts

Lantronix Corporate Headquarters
167 Technology Drive Irvine, CA 92618, USA
Toll Free: 800-526-8766 Phone: 949-453-3990 Fax: 949-450-7249
.
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

Note: This product has been designed to comply with the limits for a Class B digital
device pursuant to Part 15 of FCC and EN5502 2:1998 Rules when pr operly enclosed and grounded. These limits are designed to provide reasonable protection against such intererence radio interference in a residential installation. This equipm ent generates, uses, and can radiate radio frequency energy, and if not installed and used in accordance with this guide, may cause interference to radio communications. See Appendix C -
Compliance on page 148.
The information in this guide may change without notice. The manufacturer assumes no responsibility for any errors that may appear in this guide.For the latest revision of this product document, please check our online documentation at www.lantronix.com/support/documentation
.
.
XPort Pro User Guide 2

Revision History

Date Rev. Comments
September 2009 A Initial Document December 2010 B Updated for firmware version 5.2.0.0R20. Added support for Modbus
protocol, configurable MTU, and additional VIP tunnel connect
protocols; as well as improvements to SNMP, logging, and SSL. March 2011 C Updated SDRAM information. April 2012 D Added part number information. Updated for firmware version
5.2.0.1R5.
XPort Pro User Guide 3

Table of Contents

List of Figures _____________________________________________________________9 List of Tables _____________________________________________________________11
1: About This Guide 13
Chapter and Appendix Summaries ____________________________________________13 Additional Documentation ___________________________________________________14
2: Introduction 15
Key Features _____________________________________________________________15 Applications ______________________________________________________________16 Protocol Support _________________________________________________________16 Evolution OS™ __________________ _________________________________________16 Additional Features ________________________________________________________17
Modem Emulation ______________________________________________________17 Web-Based Configuration and Troubleshooting _______________________________17 Command-Line Interface (CLI) ____________________________________________17 VIP Access ___________________________________________________________17 SNMP Management ____________________________________________________17 XML-Based Architecture and Device Control _________________________________17 Really Simple Syndication (RSS) __________________________________________17 Enterprise-Grade Security _______________________________________________18 Terminal Server/Device Management ______________________________________18
Troubleshooting Capabilities _____________________________________________18 Configuration Methods _____________________________________________________19 Addresses and Port Numbers ________________________________________________19
Hardware Address _____________________________________________________19
IP Address ___________________________________________________________19
Port Numbers _________________________________________________________19 Product Information Label _________________________________________________ __20
3: Using DeviceInstaller 21
Accessing XPort Pro Using DeviceInstaller _____________________________________21 Device Details Summary ____________________________________________________21
4: Configuration Using Web Manager 23
Accessing Web Manager _________________________________________ __________23
Device Status Page ____________________________________________________24 Web Manager Page Components _____________________________________________25 Navigating the Web Manager ________________________________________________26
XPort Pro User Guide 4
5: Network Settings 28
Network 1 (eth0) Interface Status _____________________________________________28 Network 1 (eth0) Interface Configuration _______________________________________29 Network 1 Ethernet Link ____________________________________________________31
6: Line and Tunnel Settings 32
Line Settings _____________________________________________________________32
Line Statistics _________________________________________________________32
Line Configuration _____________________________________________________33
Line Command Mode ___________________________________________________35 Tunnel Settings __________________________________________________________ 36
Tunnel – Statistics _____________________________________________________37
Tunnel – Serial Settings _________________________________________________39
Tunnel – Packing Mode _________________________________________________40
Tunnel – Accept Mode __________________________________________________43
Tunnel – Connect Mode _________________________________________________46
Tunnel – Disconnect Mode _______________________________________________51
Tunnel – Modem Emulation ______________________________________________52
7: Terminal and Host Settings 55
Terminal Settings _________________________________________________________55
Line Terminal Configuration ______________________________________________55
Network Terminal Configuration ___________________________________________56 Host Configuration ________________________________________________________57
8: Configurable Pin Manager 59
Overview ________________________________________________________________59
Default Groups ________________________________________________________59
Custom Groups _______________________________________________________59 CPM: CP (Configurable Pins) ________________________________________________59
View CPs ____________________________________________________________60 CPM: Groups ____________________________________________________________62
View Groups __________________________________________________________62
9: Service Settings 66
DNS Settings _____________________________________________________________66 PPP Settings ____________________________________________________________ 67 SNMP Settings ___________________________________________________________69 FTP Settings ____________________________________________________________70 TFTP Settings ___________________________________________________________ 71 Syslog Settings ___________________________________________________________72 HTTP Settings ____________________________________________________________73
XPort Pro User Guide 5
HTTP Statistics ________________________________________________________74
HTTP Configuration ____________________________________________________75
HTTP Authentication ___________________________________________________77 RSS Settings _____________________________________________________________78 LPD Settings _____________________________________________________________79
LPD Statistics _________________________________________________________79
LPD Configuration _____________________________________________________80
10: Security Settings 82
SSH Settings _____________________________________________________________82
SSH Server Host Keys _________________________________________________83
SSH Server Authorized Users ____________________________________________ 87
SSH Client Known Hosts ________________________________________________89
SSH Client Users ______________________________________________________90 SSL Settings _____________________________________________________________92
SSL Cipher Suites _____________________________________________________92
SSL Certificates _______________________________________________________93
SSL RSA or DSA ______________________________________________________93
SSL Certificates and Private Keys _________________________________________93
SSL Utilities __________________________________________________________94
SSL Configuration _____________________________________________________95
11: Modbus 98
CP Control via Modbus _____________________________________________________98 Serial Transmission Mode __________________________________________________100 Modbus Statistics ________________________________________________________101 Modbus Configuration _____________________________________________________102
12: Maintenance and Diagnostics Settings 103
Filesystem Settings _______________________________________________________103
Filesystem Statistics ___________________________________________________103
Filesystem Browser ___________________________________________________104 Protocol Stack Settings ____________________________________________________106
TCP Settings ________________________________________________________107
IP Settings __________________________________________________________108
ICMP Settings ________________________________________________________109
ARP Settings ________________________________________________________110
SMTP Settings _______________________________________________________111 IP Address Filter _________________________________________________________112 Query Port _____________________________________________________________113 Diagnostics _____________________________________________________________114
Hardware ___________________________________________________________114
XPort Pro User Guide 6
MIB-II Statistics _______________________________________________________115
IP Sockets __________________________________________________________116
Ping _______________________________________________________________116
Traceroute __________________________________________________________117
Log ________________________________________________________________118
Memory _____________________________________________________________ 120
Buffer Pools _________________________________________________________ 121
Processes ___________________________________________________________121 System Settings _________________________________________________________123
13: Advanced Settings 125
Email Settings ___________________________________________________________125
Email Statistics _______________________________________________________125
Email Configuration ___________________________________________________126 Command Line Interface Settings ____________________________________________128
CLI Statistics _________________________________________________________128
CLI Configuration _____________________________________________________128 XML Settings ____________________________________________________________130
XML: Export Configuration ______________________________________________131
XML: Export Status ____________________________________________________132
XML: Import Configuration ______________________________________________133
14: VIP Settings 139
Obtaining a Bootstrap File __________________________________________________139 Importing the Bootstrap File ________________________________________________139 Enabling VIP ____________________________________________________________140 Configuring Tunnels to Use VIP _____________________________________________140 Virtual IP (VIP) Statistics ___________________________________________________140 Virtual IP (VIP) Counters ___________________________________________________141 Virtual IP (VIP) Configuration _______________________________________________141
15: Branding the XPort Pro 143
Web Manager Customization _______________________________________________143 Short and Long Name Customization _________________________________________143
16: Updating Firmware 144
Obtaining Firmware _______________________________________________________144 Loading New Firmware ____________________________________________________144
XPort Pro User Guide 7
Appendix A - Technical Support 145
Appendix B - Binary to Hexadecimal Conversions 146
Converting Binary to Hexadecimal ___________________________________________146
Conversion Table _____________________________________________________146
Scientific Calculator ___________________________________________________147
Appendix C - Compliance 148
Index 150
XPort Pro User Guide 8

List of Figures

Figure 2-2 Sample Hardware Address ________________________________________________19 Figure 2-3 Product Label___________________________________________________________20 Figure 4-1 Prompt for User Name and Password________________________________________23 Figure 4-2 Web Manager Home Page ________________________________________________24 Figure 4-3 Components of the Web Manager Page______________________________________25 Figure 5-1 Network 1 (eth0) Interface Status ___________________________________________28 Figure 5-2 Network 1 (eth0) Interface Configuration______________________________________29 Figure 5-4 Network 1 Ethernet Link __________________________________________________31 Figure 6-1 Line 1 Statistics _________________________________________________________32 Figure 6-2 Line 1 Configuration______________________________________________________33 Figure 6-4 Line 1 Command Mode___________________________________________________35 Figure 6-6 Tunnel 1 Statistics_____________________________ __________________________38 Figure 6-7 Tunnel 1 Serial Settings___________________________________________________39 Figure 6-9 Tunnel 1 Packing Mode (Mode = Disable) ____________________________________40 Figure 6-10 Tunnel 1 Packing Mode (Mode = Timeout)___________________________________41 Figure 6-11 Tunnel 1 Packing Mode (Mode = Send Character)_____________________________41 Figure 6-13 Tunnel 1 Accept Mode___________________________________________________44 Figure 6-15 Tunnel 1 - Connect _____________________________________________________47 Figure 6-17 Host 1, Host 2, Host 3 Exchanged__________________________________________50 Figure 6-18 Tunnel 1 Disconnect Mode _______________________________________________51 Figure 6-21 Tunnel 1 Modem Emulation_______________________________________________54 Figure 7-1 Terminal on Line Configuration_____________________________________________55 Figure 7-3 Terminal on Network Configuration__________________________________________56 Figure 7-5 Host Configuration_______________________________________________________57 Figure 8-1 CPM: CPs _____________________________________________________________60 Figure 8-4 CPM: Groups____________________________________ _______________________62 Figure 8-6 CPM: Group Status ______________________________________________________63 Figure 9-1 DNS Settings___________________________________________________________66 Figure 9-2 PPP Configuration Settings________________________________________________68 Figure 9-4 SNMP Configuration _____________________________________________________69 Figure 9-6 FTP Configuration _______________________________________________________70 Figure 9-8 TFTP Configuration______________________________________________________71 Figure 9-10 Syslog _______________________________________________________________73 Figure 9-12 HTTP Statistics ________________________________________________________74 Figure 9-13 HTTP Configuration_____________________________________________________75 Figure 9-15 HTTP Authentication ____________________________________________________77 Figure 9-17 RSS_________________________________________________________________79 Figure 9-19 LPD Statistics _________________________________________________________80 Figure 9-20 LPD Configuration______________________________________________________80 Figure 10-1 SSH Server: Host Keys (Upload Keys) ______________________________________83 Figure 10-3 SSH Server: Host Keys (Upload Keys) ______________________________________85 Figure 10-5 SSH Server: Host Keys (Create New Keys) __________________________________86 Figure 10-7 SSH Server: Authorized Users ____________________________________________88 Figure 10-9 SSH Client: Known Hosts ________________________________________________89 Figure 10-11 SSH Client: Users _____________________________________________________90 Figure 10-14 SSL ______________________________________________________ __________95 Figure 11-5 Modbus Statistics______________________________________________________101 Figure 11-6 Modbus Configuration __________________________________________________102 Figure 12-1 Filesystem Statistics _____________________________________________ ______103 Figure 12-2 Filesystem Browser____________________________________________________105
XPort Pro User Guide 9
Figure 12-4 TCP Protocol_________________________________________________________107 Figure 12-6 IP Protocol _______________________________________________ ___________108 Figure 12-8 ICMP Protocol ________________________________________________________109 Figure 12-10 ARP Protocol Page ___________________________________________________110 Figure 12-12 SMTP______________________________________________________________111 Figure 12-14 IP Address Filter Configuration __________________________________________112 Figure 12-16 Query Port Configuration_______________________________________________113 Figure 12-17 Diagnostics: Hardware_________________ ________________________________114 Figure 12-18 MIB-II Network Statistics _______________________________________________115 Figure 12-20 IP Sockets __________________________________________________________116 Figure 12-21 Diagnostics: Ping_____________________________________________________117 Figure 12-23 Diagnostics: Traceroute________________________________________________118 Figure 12-25 Diagnostics: Log _____________________________________________________119 Figure 12-26 Diagnostics: Log (Filesystem) ___________________________________________119 Figure 12-27 Diagnostics: Log (Line 1)_______________________________________________119 Figure 12-28 Diagnostics: Memory__________________________________________________120 Figure 12-29 Diagnostics: Buffer Pools_________________ ______________________________121 Figure 12-30 Diagnostics: Processes________________________________________________122 Figure 12-31 System_____________________________________________________________123 Figure 13-1 Email Statistics _______________________________________________________125 Figure 13-2 Email Configuration____________________________________________________126 Figure 13-4 CLI Statistics _________________________________________________________128 Figure 13-5 CLI Configuration_____________________________________________ _________129 Figure 13-7 XML: Export Configuration_______________________________________________131 Figure 13-9 XML: Export Status ____________________________________________________132 Figure 13-11 XML: Import Configuration______________________________________________133 Figure 13-12 XML: Import Configuration from External File _______________________________134 Figure 13-13 XML: Import from Filesystem ___________________________________________135 Figure 13-14 XML: Import Configuration from Filesystem ________________________________136 Figure 13-15 XML: Import Line(s) from Single Line Settings on the Filesystem________________137 Figure 14-1 VIP Status ___________________________________________________________140 Figure 14-2 VIP Counters_________________________________________________________141 Figure 14-4 VIP Configuration Page________________________________ _________________141 Figure 16-1 Update Firmware______________________________________________________144
XPort Pro User Guide 10

List of Tables

Table 2-1 XPort Pro Part Numbers___________________________________________________15 Table 3-1 Device Details Summary___________________________________________________21 Table 4-4 Summary of Web Manager Pages ___________________________________________26 Table 5-3 Network 1 (eth0) Interface Configuration ______________________________________30 Table 5-5 Network 1 Ethernet Link ___________________________________________________31 Table 6-3 Line Configuration________________________________________________________34 Table 6-5 Line Command Mode _____________________________________________________ 35 Table 6-8 Tunnel - Serial Settings____________________________________________________39 Table 6-12 Tunnel Packing Mode____________________________________________________42 Table 6-14 Tunnel Accept Mode_____________________________________________________44 Table 6-16 Tunnel Connect Mode____________________________________________________48 Table 6-19 Tunnel Disconnect Mode _________________________________________________51 Table 6-20 Modem Emulation Commands and Descriptions _______________________________52 Table 6-22 Tunnel Modem Emulation_________________________________________________54 Table 7-2 Terminal on Line 1 Configuration ____________________________________________56 Table 7-4 Terminal on Network Configuration __________________________________________57 Table 7-6 Host Configuration _______________________________________________________ 58 Table 8-2 CPM CPs Current Configuration_____________________________________________60 Table 8-3 CPM CPs Status_________________________________________________________61 Table 8-5 CPM Groups Current Configuration __________________________________________63 Table 8-7 Group Status____________________________________________________________64 Table 9-3 PPP Configuration _______________________________________________________68 Table 9-5 SNMP _________________________________________________________________69 Table 9-7 FTP Settings____________________________________________________________70 Table 9-9 TFTP Server____________________________________________________________72 Table 9-11 Syslog________________________________________________________________73 Table 9-14 HTTP Configuration _____________________________________________________75 Table 9-16 HTTP Authentication_____________________________________________________ 77 Table 9-18 RSS__________________________________________________________________79 Table 9-21 LPD Configuration_______________________________________________________81 Table 10-2 SSH Server Host Keys Settings - Upload Keys Method__________________________84 Table 10-4 SSH Server Host Keys Settings - Upload Keys Method__________________________85 Table 10-6 SSH Server Host Keys Settings - Create New Keys Method______________________86 Table 10-8 SSH Server Authorized User Settings _______________________________________88 Table 10-10 SSH Client Known Hosts ________________________________________________89 Table 10-12 SSH Client Users ______________________________________________________91 Table 10-13 Supported Cipher Suites_________________________________________________92 Table 10-15 SSL_________________________________________________________________96 Table 11-1 6 Byte Header of Modbus Application Protocol ________________________________98 Table 11-2 Modbus Local Slave Functions - Query ______________________________________98 Table 11-3 Modbus Local Slave Functions - Response ___________________________________99 Table 11-4 Modbus Transmission Modes_____________________________________________100 Table 11-7 Modbus Configuration_____________________________________________ ______102 Table 12-3 Filesystem Browser_____________________________________________________106 Table 12-5 TCP Protocol Settings___________________________________________________107 Table 12-7 IP Protocol Settings____________________________________________________108 Table 12-9 ICMP Settings_________________________________________________________109 Table 12-11 ARP Settings_________________________________________________________110 Table 12-13 SMTP Settings _______________________________________________________111 Table 12-15 IP Address Filter Settings_______________________________________________112
XPort Pro User Guide 11
Table 12-19 Requests for Comments (RFCs)__________________________________________115 Table 12-22 Diagnostics: Ping _____________________________________________________ 117 Table 12-24 Diagnostics: Traceroute ________________________________________________118 Table 12-32 System _____________________________________________________________123 Table 13-3 Email Configuration_____________________________________________________127 Table 13-6 CLI Configuration ______________________________________________________129 Table 13-8 XML Export Configuration________________________________________________131 Table 13-10 XML Export Status ____________________________________________________132 Table 13-16 XML: Import Line(s) from Single Line Settings_______________________________138 Table 14-3 VIP Counters__________________________________________________________141 Table 14-5 VIP Settings __________________________________________________________142 Table 18-1 Binary to Hexadecimal Conversion Table____________________________________146
XPort Pro User Guide 12

1: About This Guide

This guide provides the information needed to configure, use, and update the XPort Pro device server. It is intended for software developers and system integrators who are embedding th e XPort Pro in their designs.

Chapter and Appendix Summaries

A summary of each chapter is provided below.
Chapter Description
Chapter 2: Introduction Main features of the product and the protocols it supports.
Includes technical specifications.
Chapter 3: Using DeviceInstaller Instructions for viewing the current configuration using
DeviceInstaller.
Chapter 4: Configuration Using Web Manager Instructions for accessing Web Manager and using it to
configure settings for the device.
Chapter 5: Network Settings Instructions for using the web interface to configure
Ethernet settings.
Chapter 6: Line and Tunnel Settings Instructions for using the web interface to configure line and
tunnel settings.
Chapter 7: Terminal and Host Settings Instructions for using the web interface to configure terminal
and host settings.
Chapter 8: Configurable Pin Manager Information about the Configurable Pin Manager (CPM) and
how to set the configurable pins to work with a device.
Chapter 9: Service Settings Instructions for using the web interface to configure settings
for DNS, SNMP, FTP, and other services.
Chapter 10: Security Settings Instructions for using the web interface to configure SSH
and SSL security settings.
Chapter 11: Modbus Instructions for using the web interface to configure
Modbus.
Chapter 12: Maintenance and Diagnostics Settings Instructions for using the web interface to maintain the
device, view statistics, files, and logs, and diagnose problems.
Chapter 13: Advanced Settings Instructions for using the web interface to configure email,
CLI, and XML settings.
Chapter 14: VIP Settings Information about Virtual IP (VIP) features available on the
device and instructions for using the web interface to configure the VIP settings.
Chapter 15: Branding the XPort Pro Instructions for customizing the device. Chapter 16: Updating Firmware Instructions for obtaining the latest firmware and updating
the device.
Appendix A - Technical Support Instructions for contacting Lantronix Technical Support. Appendix B - Binary to Hexadecimal Conversions Instructions for converting binary values to hexadecimals. Appendix C - Compliance Lantronix compliance information.
XPort Pro User Guide 13

Additional Documentation

Visit the Lantronix web site at www.lantronix.com/support/documentation for the latest documentation and the following additional documentation.
Document Description
XPort Pro Integration Guide Information about the XPort Pro hardware, testing the XPort Pro
XPort Pro Command Reference
XPort Pro Universal Demo Board Quick Start
XPort Pro Universal Demo Board User Guide
DeviceInstaller Online Help Instructions for using the Lantronix Windows-based utility to locate
Com Port Redirector Quick Start and Online Help
1: About This Guide
using the demonstration board, and integrating the XPort Pro into your product.
Instructions for accessing Command Mode (the command line interface) using a Telnet connection or through the serial port. Detailed information about the commands. Also provides details for XML configuration and status.
Instructions for getting the XPort Pro demonstration board up and running.
Information for using the XPort Pro on the demo board.
the device and to view its current settings. Instructions for using the Lantronix Windows-based utility to create
virtual com ports.
Secure Com Port Redirector User Guide
Instructions for using the Lantronix Windows-based utility to create secure virtual com ports.
XPort Pro User Guide 14

2: Introduction

Table 2-1 XPort Pro Part Numbers
Part Numbers SDRAM Operating System
XPP1002000-01R 8 MB Evolution XPP100200S-01R 8 MB Evolution XPPDK1000-EVO-01 8 MB Evolution XPP1002000-02R 16 MB Evolution XPP100200S-02R 16 MB Evolution XPPDK1000-EVO-02 16 MB Evolution XPP1003000-01R 8 MB Linux XPP100300S-01R 8 MB Linux XPPDK1000-LNX-01 8 MB Linux XPP1003000-02R 16 MB Linux XPP100300S-02R 16 MB Linux XPPDK1000-LNX-02 16 MB Linux
This chapter introduces the Lantronix . It provides an overview of the products, lists their key features, and describes the applications for which they are suited.
The
XPort Pro embedded Ethernet Device Server is a complete network-enabling solution in a
13.50 (0.531) X 16.25 (0.640) X 33.90 (1.335) package. This miniature device server empowers original equipment manufacturers (OEMs) to go to market quickly and easily with Ethernet networking and web page serving capabilities built into their products. [DIMS = mm (in.)]
This chapter contains the following sections:
Applications Protocol Support Evolution OS™ Additional Features Configuration Methods Addresses and Port Numbers Product Information Label

Key Features

Note: Consult the Integration Guide for more detailed hardware information.
Power Supply: Regulated 3.3V input
required.
Controller: A Lantronix DSTni-EX CPU
with 256 kilobytes (KB) zero wait state SRAM and 16 KB of boot ROM.
Memory: 16 MB Flash and 8/16 MB
SDRAM (see Table 2-1 to the right).
Temperature Range: Operates over an
extended temperature range of -40°C to +85°C.
XPort Pro User Guide 15
Ethernet: 10/100 megabits per second
(Mbps) Ethernet transceiver
Serial Ports: One full RS232-supporting
high-speed serial port with all hardware handshaking signals. Baud rate is software selectable
Note: The standard baud rate of 460800 bps is not supported.
Configurable IO Pins (CPs): Up to three pins are configurable as general purpose I/Os if no
modem control signal is used on serial ports. Not 5V tolerant.
Interface Signals: 3.3V-level interface signals.
(300 bps to 921600 bps).

Applications

The XPort Pro device server connects serial devices such as those listed below to Ethernet
networks using the IP protocol family.
ATM machines CNC controllers Data collection devices Universal Power Supply (UPS) management unit Telecommunications equipment Handheld instruments Data display devices Security alarms and access control devices Modems Time/attendance clocks and terminals
2: Introduction

Protocol Support

The XPort Pro device server contains a full-featured TCP/IP stack. Supported protocols include:
ARP, IP, UDP, TCP, ICMP, BOOTP, DHCP, AutoIP, Telnet, DNS, FTP, TFTP, HTTP/HTTPS,
SSH, SSL/TLS, SNMP, SMTP, RSS, PPP and Syslog for network communications and management.
TCP, UDP, TCP/AES, UDP/AES, Telnet, SSH and SSL/TLS for tunneling to the serial port. TFTP, FTP, and HTTP for firmware upgrades and uploading files.

Evolution OS™

The XPort Pro incorporates the Lantronix Evolution OS™. Key features of the Evolution OS™ include:
Built-in Web server for configuration and troubleshooting from Web-based browsers CLI configurability SNMP management XML data transport and configurability Really Simple Syndication (RSS) information feeds Enterprise-grade security with SSL and SSH Comprehensive troubleshooting tools
XPort Pro User Guide 16

Additional Features

Modem Emulation

In modem emulation mode, the XPort Pro can replace dial-up modems. The unit accepts modem AT commands on the serial port, and then establishes a network connection to the end device, leveraging network connections and bandwidth to eliminate dedicated modems and phone lines.

Web-Based Configuration and Troubleshooting

Built upon Internet-based standards, the XPort Pro enables you to configure, manage, and troubleshoot through a browser-based interface accessible anytime from anywhere. All configuration and troubleshooting options are launched from a web interface. You can access all functions via a Web browser, for remote access. As a result, you de crease downtime (using the troubleshooting tools) and implement configuration changes (using the configuration tools).

Command-Line Interface (CLI)

Making the edge-to-enterprise vision a reality, the XPort Pro with the Evolution OS™ uses industry-standard tools for configuration, communication, and control. For example, the Evolution OS™ uses a Command Line Interface (CLI) whose syntax is very similar to that used by data center equipment such as routers and hubs.
2: Introduction

VIP Access

Virtual IP Access is the Lantronix technology that solves the access-through-firewall problem. With VIP Access, the XPort Pro can act as a ManageLinx DSC and provide direct access to your equipment behind a firewall.

SNMP Management

The XPort Pro supports full SNMP management, making it ideal for applications where device management and monitoring are critical. These features allow networks with SNMP capabilities to correctly diagnose and monitor XPort Pro device servers.

XML-Based Architecture and Device Control

XML is a fundamental building block for the future growth of M2M networks. The XPort Pro supports XML-based configuration setup records that make device configuration transparent to users and administrators. The XML is easily editable with a standard text or XML editor.

Really Simple Syndication (RSS)

The XPort Pro supports Really Simple Syndication (RSS) for streaming and managing on-line content. RSS feeds all the configuration changes that occur on the device. An RSS aggregator then reads (polls) the feed. More powerful than simple email alerts, RSS uses XML as an underlying Web page transport and adds intelligence to the networked device, while not taxing already overloaded email systems.
XPort Pro User Guide 17
2: Introduction

Enterprise-Grade Security

Evolution OS™ provides the XPort Pro the highest level of networking security possible. This ‘data center grade’ protection ensures that each device on the M2M network carries the same level of security as traditional IT networking equipment in the corporate data center.
With built-in SSH and SSL, secure communications can be established between the serial ports and the remote end device or application. By protecting the privacy of serial data transmitte d across public networks, users can maintain their existing investment in serial technology, while taking advantage of the highest data-protection levels possible.
SSH and SSL are able to do the following:
Verify the data received came from the proper source Validate that the data transferred from the source over the network has not changed when it
arrives at its destination (shared secret and hashing)
Encrypt d ata to protect it from prying eyes and nefarious individuals Provide the ability to run popular M2M protocols over a secure SSH or SSL connection
In addition to keeping data safe and accessible, the XPort Pro has robust defenses to hostile Internet attacks such as denial of service (DoS), which can be used to take down the network. Moreover, the XPort Pro cannot be used to bring down other devices on the network.
You can use the XPort Pro with the Lantronix Secure Com Port Redirector (SCPR) to encrypt COM port-based communications between PCs and virtually any electronic device. SCPR is a Windows application that creates a secure communications path over a network between the computer and serial-based devices that are traditionally controlled via a COM port. With SCPR installed at each computer, computers that were formerly “h ard-wired” by serial cabling for security purposes or to accommodate applications that only understood serial data can instead communicate over an Ethernet network or the Internet.

Terminal Server/Device Management

Remote offices can have routers, PBXs, servers and other networking equipment that require remote management from the corporate facility. The XPort Pro easily attaches to the serial ports on a server, Private Branch Exchange (PBX), or other networking equipment to deliver central, remote monitoring and management capability.

Troubleshooting Capabilities

The XPort Pro offers a comprehensive diagnostic toolset that lets you troubleshoot problems quickly and easily. Available from the Web Manager, CLI, and XML interfaces, the diagnostic to ols let you:
View critical hardware, memory, MIB-II, buffer pool, and IP socket info rmation. Perform ping and traceroute operations. Conduct forward or backup DNS lookup operations. View all processes currently running on the XPort Pro, including CPU utilization and total stack
space available.
XPort Pro User Guide 18

Configuration Methods

After installation, the XPort Pro requires configuration. For the unit to operate correctly on a network, it must have a unique IP address on the network. There are four basic methods for logging into the XPort Pro and assigning IP addresses and other configurable settings:
DeviceInstaller: Configure the IP address and related settings and view current settings on the XPort Pro using a Graphical User Interface (GUI) on a PC attached to a network. See Using
DeviceInstaller (on page 21).
Web Manager: Through a web browser, configure the XPort Pro settings using the La ntronix Web Manager. See Configuration Using Web Manager (on page 23).
Command Mode: There are two methods for accessing Command Mode (CLI): making a Telnet connection or connecting a terminal (or a PC running a terminal emulation program) to the unit’s serial port. (See the XPort Pro Command Reference Guide for instructions and available commands.)
XML: The XPort Pro supports XML-based configuration and setup records that make device configuration transparent to users and administrators. XML is easily editable with a standard text or XML editor. (See the XPort Pro Command Reference Guide for instructions and commands.)
2: Introduction

Addresses and Port Numbers

Hardware Address

The hardware address is also referred to as the Ethernet address or M AC addre s s. The first thr ee bytes of the Ethernet address are fixed and read 00-20-4A, identifying the unit as a Lantronix product. The fourth, fifth, and sixth bytes are unique numbers assigned to each unit.
Figure 2-2 Sample Hardware Address
00-20-4A-14-01-18 or 00:20:4A:14:01:18

IP Address

Every device connected to an IP network must have a unique IP add ress. This address references the specific unit.

Port Numbers

Every TCP connection and every UDP datagram is defined by a destination and source IP address, and a destination and source port nu mber. For example, a Telnet serv er commonly u ses port number 23.
The following is a list of the default server port numbers running on the XPort Pro:
TCP Port 22: SSH Server (Command Mode configuration) TCP Port 23: Telnet Server (Command Mode configuration) TCP Port 80: HTTP (Web Manager configuration) TCP Port 443: HTTPS (Web Manager configuration) UDP Port 161: SNMP TCP Port 21: FTP
XPort Pro User Guide 19
UDP Port 69: TFTP
Part Number
Product ID (name)
MAC Address
Revision
UDP Port 30718: LDP (Lantronix Discovery Protocol) port TCP/UDP Port 10001: Tunnel 1
Note: Multi-port products include one or more additional supported ports and tunnels
with default sequential numbering. For instance: TCP/UDP Port 10002: Tunnel 2, TCP/ UDP Port 10003: Tunnel 3, etc.

Product Information Label

The product information label on the unit contains the following information about the specific unit:
Bar Code Product ID (name) Produ ct Revision Part Number Hardware Address (MAC Address or Serial Number)
2: Introduction
Figure 2-3 Product Label
XPort Pro User Guide 20

3: Using DeviceInstaller

This chapter covers the steps for locating a device and viewing its properties and details.
DeviceInstaller is a free utility program provided by Lantronix that discovers, configures, upgrades and manages Lantronix Device Servers. It can be downloaded from the Lantronix website at
www.lantronix.com/support/downloads.html
the IP address, related settings or for more advanced features, see the DeviceInstaller online help.
Note: AutoIP generates a random IP address in the range of 169.254.0.1 to
169.254.255.254 if no BOOTP or DHCP server is found.

Accessing XPort Pro Using DeviceInstaller

Note: Make note of the MAC address. It is needed to locate the XPort Pro using
DeviceInstaller.
1. Click Start > All Programs > Lantronix > DeviceInstaller > DeviceInstaller. When DeviceInstaller starts, it will perform a network device search.
2. Click Search to perform additional searches, as desired.
3. Expand the XPort Pro folder by clicking the + symbol next to the XPort Pro folder icon. The list of available Lantronix XPort Pro devices appears.
. For instructions on using DeviceInstaller to configure
4. Select the XPort Pro unit by expanding its entry and clicking on its hardware (MAC) address to view its configuration.
5. On the right page, click the Device Details tab. The current XPort Pro configuration appears. This is only a subset of the full configuration; the complete configuration may be accessed via Web Manager, CLI, or XML.

Device Details Summary

Note: The settings are Display Only in this table unless otherwise noted.
Table 3-1 Device Details Summary
Current Settings Description
Name Name identifying the XPort Pro. DHCP Device Name Shows the name associated with the XPort Pro’ current IP address, if
Group Configurable field. Enter a group to categorize the XPort Pro. Double-
Comments Configurable field. Enter comments for the XPort Pro. Double-click the
the IP address was obtained dynamically.
click the field, type in the value, and press Enter to complete. This group name is local to this PC and is not visible on other PCs or laptops using DeviceInstaller.
field, type in the value, and press Enter to complete. This description or comment is local to this PC and is not visible on other PCs or laptops using DeviceInstaller.
XPort Pro User Guide 21
3: Using DeviceInstaller
Current Settings (continued) Description
Device Family Shows the XPort Pro device family type as “XPort”. Type Shows the specific device type, such as “XPort Pro”. ID Shows the XPort Pro ID embedded within the unit. Hardware Address Shows the XPort Pro hardware (MAC) address. Firmware Version Shows the firmware cu rren t ly i nst al l e d on th e XPort Pro. Extended Firmware Version Provides additional information on the firmware version. Online Status Shows the XPort Pro status as Online, Offline, Unreachable (the XPort
Pro is on a different subnet), or Busy (the XPort Pro is currently performing a task).
IP Address Shows the XPort Pro current IP address. To change the IP address,
click the Assign IP button on the DeviceInstaller menu bar.
IP Address was Obtained Displays “Dynamically” if the XPort Pro automatically received an IP
address (e.g., from DHCP). Displays “Statically” if the IP address was configured manually.
If the IP address was assigned dynamically, the following fields appear:
Obtain via DHCP with value of True or False.Obtain via BOOTP with value of True or False.
Subnet Mask Shows the subnet mask specifying the network segment on which the
XPort Pro resides.
Gateway Shows the IP address of the router of this network. There is no default. Number of Ports Shows the number of serial ports on this XPort Pro. Supports Configurable Pins Shows True, indicating configurable pins are available on the XPort
Pro.
Supports Email Triggers Shows True, indicating email triggers are available on the XPort Pro. Telnet Enabled Indicates whether Telnet is enabled on this XPort Pro. Telnet Port Shows th e XPort Pro port for Telnet sessions. Web Enabled Indicates whether Web Manager access is enabled on this XPort Pro. Web Port Shows the XPort Pro port for Web Manager configuration. Firmware Upgradable Shows True, indicating the XPort Pro firmware is upgradable as newer
versions become available.
XPort Pro User Guide 22

4: Configuration Using Web Manager

This chapter describes how to configure the XPort Pro using Web Manager, the Lantronix browser-based configuration tool. The unit’s configuration is stored in nonvolatile memory and is retained without power. All changes take effect immediately, unless otherwise noted. It contains the following sections:
Accessing Web Manager Web Manager Page Components Navigating the Web Manager Summary of Web Manager Pages

Accessing Web Manager

Note: You can also access the Web Manager by selecting the Web Configuration tab on
the DeviceInstaller window.

To access Web Manager, perform the following steps:

1. Open a standard web browser. Lantronix supports the latest version of Internet Explorer, Mozilla Suite, Mozilla Firefox, Safari, Chrome or Opera.
2. Enter the IP address of the XPort Pro in the address bar. The IP address may have been assigned manually using DeviceInstaller (see the XPort Pro Quick Start Guide) or automatically by DHCP.
Figure 4-1 Prompt for User Name and Pas s wo rd
3. Enter your username and password.The factory-default username is “admin” and the factory­default password is “PASS.” The Device Status web page shown in Figure 4-2 displays configuration, network settings, line settings, tunneling settings, and product information.
Note: The Logout button is available on any web page. Logging out of the web page
would force re-authentication to take place the next time the web page is accessed.
XPort Pro User Guide 23
4: Configuration Using Web Manager

Device Status Page

The Device Status page is the first page that appears after you log into the Web Manager. It also appears when you click Status in the Main Menu.
Figure 4-2 Web Manager Home Page
XPort Pro User Guide 24

Web Manager Page Components

Menu Bar
Links to subpages
Items to configure
Information and Help Area
Header
Configuration and/or Status Area
Footer
Logout button
The layout of a typical Web Manager page is below.
Figure 4-3 Components of the Web Manager Page
4: Configuration Using Web Manager
The menu bar always appears at the left side of the page, regardless of the page shown. The menu bar lists the names of the pages available in the Web Mana ger. To bring up a page, click it in the menu bar.
The main area of the page has these additional sections:
At the very top, many pages, such as the one in the example above, enable you to link to
sub pages. On some pages, you must also select the item you are configuring, such as a
XPort Pro User Guide 25
line or a tunnel.
In the middle of many pages, you can select or enter new configuration settings. Some
pages show status or statistics in this area rather than allow you to enter settings.
At the bottom of most pages, the current configuration is displayed. In some cases, you
can reset or clear a setting.
The information or help area shows information or instructions associated with the page. A Logout link is available at the upper right corner of every web page. In Chrome or
Safari, it is necessary to close out of the browser to logout. If necessary, reopen the browser to log back in.
The foote r ap pe ars a t the ve ry bottom of the page. It contains copyright information and a
link to the Lantronix home page.

Navigating the Web Manager

The Web Manager provides an intuitive point-and-click interface. A menu bar on the left side of each page provides links you can click to navigate from one page to another. Some pages are read-only, while others let you change configuration settings.
4: Configuration Using Web Manager
Note: There may be times when you must reboot the XPort Pro for the new
configuration settings to take effect. The chapters that follow indicate when a change requires a reboot.
Table 4-4 Summary of Web Manager Pages
Web Manager Page
Status Shows product information and network, line, and tunneling
CLI Shows Command Line Interface (CLI) statistics and lets you
CPM Shows information about the Configurable Pins Manager (CPM)
Diagnostics Lets you perform various diagnostic procedures. 114 DNS Shows the current configuration of the DNS subsystem and the
Email Shows email statistics and lets you clear th e email log, configure
Filesystem Shows file system statistics and lets you browse the file system to
FTP Shows statistics and lets you change the current configuration for
Host Lets you view and change settings for a host on the network. 57
Description See
Page
32
settings.
128
change the current CLI configuration settings.
59
and how to set the configurable pins and pin groups to work with a device.
66
DNS cache.
125
email settings, and send an email.
103
view a file, create a file or directory, upload files using HTTP, copy a file, move a file, or perform TFTP actions.
70
the File Transfer Protocol (FTP) server.
HTTP Shows HyperText Transfer Protocol (HTTP) statistics and lets you
change the current configuration and authentication settings.
73
XPort Pro User Guide 26
4: Configuration Using Web Manager
Web Manager Page (continued)
IP Address Filter Lets you specify all the IP addresses and subnets that are allowed
Line Shows statistics and lets you change the current configuration and
LPD Shows LPD (Line Printer Daemon) Queue statistics and lets you
Modbus Shows the current connection status of the Modbus servers
Network Shows status and lets you configure the network interface. 28 PPP Lets you configure a network link using Point-to-Point Protocol
Protocol Stack Lets you perform lower level network stack-specific activities. 106 Query Port Lets you change configuration settings for the query port. 113 RSS Lets you change current Really Simple Syndication (RSS)
SNMP Lets you change the current Simple Network Management
SSH Lets you change the configuration settings for SSH server host
SSL Lets you upload an existing certificate or create a new self-signed
Syslog Lets you specify the severity of events to log and the server and
System Lets you reboot device , restore fa ctory defaults, upload new
Terminal Lets you change current settings for a terminal. 55
Description See
Page
112
to send data to this device.
32
Command mode settings of a serial line.
79
configure the LPD and print a test page.
98
listening on the TCP ports and lets you configure the Modbus settings.
67
(PPP) over a serial line.
78
settings.
69
Protocol (SNMP) configuration settings.
82
keys, SSH server authorized users, SSH client known hosts, and SSH client users.
92
certificate.
72
ports to which the syslog should be sent.
123
firmware, and change the device long and short names.
TFTP Shows statistics and lets you change the current configuration for
the Trivial File Transfer Protocol (TFTP) server.
Tunnel Lets you change the current configuration settings for a tunnel. 36 VIP Lets you configure Virtual IP addresses to be used in Tunnel
Accept Mode and Tunnel Connect Mode.
XML Lets you export XML configuration and status records, and import
XML configuration records.
71
139
130
XPort Pro User Guide 27

5: Network Settings

This chapter describes how to access, view, and configure network settings from the Network web page. The Network web page contains sub-menus that enable you to view and configure the Ethernet network interface and link.
This chapter contains the following sections:
Network 1 (eth0) Interface Status Network 1 (eth0) Interface Configuration Network 1 Ethernet Lin k

Network 1 (eth0) Interface Status

This page shows the status of the Ethernet network interface.

To view the network interface status:

1. Click Network on the menu.
2. Then click Network 1, Interface, and Status at the top of the page. The Network 1 (eth0) Interface Status page appears.
Figure 5-1 Network 1 (eth0) Interface Status
XPort Pro User Guide 28

Network 1 (eth0) Interface Configuration

This page shows the configuration settings for the Ether net con nection and lets you change these settings.

To view and configure network interface settings:

1. Click Network 1 > Interface > Configuration at the top of the page. The Network 1 (eth0) Interface Configuration page appears.
Figure 5-2 Network 1 (eth0) Interface Configuration
5: Network Settings
2. Enter or modify the following settings:
XPort Pro User Guide 29
Table 5-3 Network 1 (eth0) Interface Configuration
5: Network Settings
Network 1 Interface
Description Configuration Settings
BOOTP Client Select On or Off. At boot up, the device will attempt to obtain an IP address from a
BOOTP server.
Notes:
Overrides the configured IP address, network mask, gateway, hostname, and
domain.
When DHCP is On, the system automatically uses DHCP, regardless of whether
BOOTP Client is On.
DHCP Client Select On or Off. At boot up, the device will attempt to lease an IP address from a
DHCP server and maintain the lease at regular intervals.
Note: Overrides BOOTP, the configured IP address, network mask, gateway,
hostname, and domain.
IP Address Enter the device static IP address.
You may enter it alone, in CIDR format, or with an explicit mask.
The IP address consists of four octets separated by a period and is used if BOOTP and
DHCP are both set to Off. Changing this value requires you to reboot the device.
Note: Whe n DHCP is enabled, the device tries to obtain an IP address from DHCP. If
it cannot, the device uses an AutoIP address in the range of 169.254.xxx.xxx.
Default Gateway Enter the IP address of the router for this network. Or, clear the field (appears as
<None>). This address is only used for static IP address configuration. Hostname Enter the device hostname. It must begin with a letter, continue with a sequence of
letters, numbers, and/or hyphens, and end with a letter or number.
Domain Enter the device domain name. DHCP Client ID Enter the ID if the DHCP server uses a DHCP ID. The DHCP server’s lease table
shows IP addresses and MAC addresses for devices. The lease table shows the Client
ID, in hexadecimal notation, instead of the device MAC address. Primary DNS IP address of the primary name server. This entry is required if you choose to configure
DNS (Domain Name Server) servers.
Secondary DNS IP address of the secondary name server. MTU When DHCP is enabled, the MTU size is (usually) provided with the IP address. When
not provided by the DHCP server, or using a static configuration, this value is used. The
MTU size can be from 576 to 1500 bytes.
3. Click Submit to save changes. Some changes to th e following settings require a reb oot for the changes to take effect:
BOOTP Client DHCP Client IP Address DHCP Client ID
Note: If DHCP or BOOTP fails, AutoIP intervenes and assigns an add ress.A new DHCP
negotiation is attempted every 5 minutes to obtain a new IP address. When the DHCP is enabled, any configured static IP address is ignored.
XPort Pro User Guide 30
Loading...
+ 124 hidden pages