Lantronix xport pro User Manual
  1. Manuals
  2. Brands
  3. Lantronix Manuals
  4. Server
  5. xport pro
  6. User manual

Lantronix xport pro User Manual

Embedded device server
Hide thumbs Also See for xport pro:
Table of Contents

Advertisement

Quick Links

Download this manual
XPort Pro
Embedded Device Server
User Guide
Part Number 900-560
Revision E May 2016

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the xport pro and is the answer not in the manual?

Questions and answers

Related Manuals for Lantronix xport pro

Summary of Contents for Lantronix xport pro

  • Page 1 XPort Pro Embedded Device Server User Guide Part Number 900-560 Revision E May 2016...

  • Page 2: Intellectual Property

    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 EN55022:1998 Rules when properly enclosed and grounded.

  • Page 3: Revision History

    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.

  • Page 4: Table Of Contents

    Hardware Address _____________________________________________________ 20 IP Address ___________________________________________________________ 20 Port Numbers _________________________________________________________ 20 Product Information Label ___________________________________________________ 21 3: Using DeviceInstaller Installing DeviceInstaller ____________________________________________________ 22 Accessing the XPort Pro Unit Using DeviceInstaller _______________________________ 22 XPort® Pro Embedded Device Server User Guide...
  • Page 5 4: Configuration Using Web Manager Accessing Web Manager ___________________________________________________ 24 Device Status Page ____________________________________________________ 25 Web Manager Page Components _____________________________________________ 26 Navigating the Web Manager ________________________________________________ 27 5: Network Settings Network 1 (eth0) Interface Status _____________________________________________ 29 Network 1 (eth0) Interface Configuration _______________________________________ 30 Network 1 Ethernet Link ____________________________________________________ 32 6: Line and Tunnel Settings Line Settings _____________________________________________________________ 33...
  • Page 6 9: Service Settings DNS Settings _____________________________________________________________ 66 Point-to-Point (PPP) Settings________________________________________________ 67 SNMP Settings ___________________________________________________________ 69 FTP Settings ____________________________________________________________ 70 TFTP Settings ____________________________________________________________ 71 Syslog Settings ___________________________________________________________ 72 HTTP Settings ____________________________________________________________ 73 HTTP Statistics ________________________________________________________ 73 HTTP Configuration ____________________________________________________ 75 HTTP Authentication ___________________________________________________ 77 RSS Settings _____________________________________________________________ 78 LPD Settings _____________________________________________________________ 79 LPD Statistics _________________________________________________________ 79...
  • Page 7 XML Settings ____________________________________________________________ 127 XML: Export Configuration ______________________________________________128 XML: Export Status ____________________________________________________ 129 XML: Import Configuration ______________________________________________131 14: Branding the XPort Pro Unit Web Manager Customization _______________________________________________ 136 Short and Long Name Customization _________________________________________ 136 15: Updating Firmware Obtaining Firmware _______________________________________________________ 137 Loading New Firmware ____________________________________________________ 137 XPort®...
  • Page 8 A: Technical Support B: Binary to Hexadecimal Conversions Converting Binary to Hexadecimal ___________________________________________ 139 Conversion Table _____________________________________________________ 139 Scientific Calculator ___________________________________________________ 140 C: Compliance RoHS, REACH and WEEE Compliance Statement ______________________________ 142 Index XPort® Pro Embedded Device Server User Guide...

  • Page 9: List Of Figures

    List of Figures Figure 2-2 Sample Hardware Address ________________________________________________ 20 Figure 2-3 Product Label___________________________________________________________ 21 Figure 4-1 Prompt for User Name and Password ________________________________________ 24 Figure 4-2 Web Manager Home Page ________________________________________________ 25 Figure 4-3 Components of the Web Manager Page ______________________________________ 26 Figure 5-1 Network 1 (eth0) Interface Status ___________________________________________ 29 Figure 5-2 Network 1 (eth0) Interface Configuration______________________________________ 30 Figure 5-4 Network 1 Ethernet Link __________________________________________________ 32...
  • Page 10 Figure 9-15 HTTP Authentication ____________________________________________________ 77 Figure 9-17 RSS _________________________________________________________________ 78 Figure 9-19 LPD Statistics _________________________________________________________ 80 Figure 9-20 LPD Configuration ______________________________________________________ 80 Figure 10-1 SSH Server: Host Keys (Upload Keys) ______________________________________ 83 Figure 10-5 SSH Server: Authorized Users ____________________________________________ 86 Figure 10-7 SSH Client: Known Hosts ________________________________________________ 87 Figure 10-9 SSH Client: Users______________________________________________________ 88 Figure 10-12 SSL ________________________________________________________________ 93...
  • Page 11 Figure 13-11 XML: Import Configuration from External File _______________________________ 131 Figure 13-12 XML: Import from Filesystem ___________________________________________ 132 Figure 13-13 XML: Import Configuration from Filesystem ________________________________ 133 Figure 13-14 XML: Import Line(s) from Single Line Settings on the Filesystem ________________ 134 Figure 15-1 Update Firmware ______________________________________________________ 137 XPort®...

  • Page 12: List Of Tables

    List of Tables Table 2-1 XPort Pro Part Numbers ___________________________________________________ 16 Table 3-1 Device Details Summary___________________________________________________ 22 Table 4-4 Summary of Web Manager Pages ___________________________________________ 27 Table 5-3 Network 1 (eth0) Interface Configuration ______________________________________ 30 Table 5-5 Network 1 Ethernet Link ___________________________________________________ 32...
  • Page 13 Table 10-10 SSH Client Users ______________________________________________________ 89 Table 10-11 Supported Cipher Suites_________________________________________________ 90 Table 10-13 SSL _________________________________________________________________ 94 Table 11-1 6 Byte Header of Modbus Application Protocol ________________________________ 96 Table 11-2 Modbus Local Slave Functions - Query ______________________________________ 96 Table 11-3 Modbus Local Slave Functions - Response ____________________________________________ 97 Table 11-4 Modbus Transmission Modes ______________________________________________ 98 Table 11-7 Modbus Configuration___________________________________________________ 100...

  • Page 14: 1: About This Guide

    About This Guide This user guide provides the information needed to configure, use, and update the Lantronix® XPort® Pro embedded device server. It is intended for software developers and system integrators who are embedding the XPort Pro device server in their designs.

  • Page 15: Additional Documentation

    Document Description XPort Pro Embedded Device Server Information about the XPort Pro hardware, testing the XPort Pro Integration Guide using the demonstration board, and integrating the XPort Pro into your product. XPort Pro Embedded Device Server...

  • Page 16: 2: Introduction

    Introduction This chapter introduces the Lantronix XPort Pro embedded device server. It provides an overview of the product, lists the 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.

  • Page 17: Applications

    Not 5V tolerant. Interface Signals: 3.3V-level interface signals.  Applications The XPort Pro device server connects serial devices such as those listed below to Ethernet networks using the IP protocol family. ATM machines ...

  • Page 18: Additional Features

    XPort Pro devices. 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.

  • Page 19: Terminal Server/Device Management

    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.

  • Page 20: Configuration Methods

    The hardware address is also referred to as the Ethernet address or MAC address. The first three bytes of the Ethernet address are fixed and read as either 00-20-4A or 00-80-A3, identifying the unit as a Lantronix product. The fourth, fifth, and sixth bytes are unique numbers assigned to each unit.

  • Page 21: Product Information Label

     UDP Port 161: SNMP  TCP Port 21: FTP  UDP Port 69: TFTP  UDP Port 30718: LDP (Lantronix Discovery Protocol) port  TCP/UDP Port 10001: Tunnel 1  TCP/UDP Port 10002: Tunnel 2  Note: Multi-port products include one or more additional supported ports and tunnels with default sequential numbering.

  • Page 22: 3: Using Deviceinstaller

    3. Expand the XPort folder by clicking the + symbol next to the XPort folder icon. The list of available Lantronix XPort Pro devices appear. 4. Select the XPort Pro unit by expanding its entry and clicking on its hardware (MAC) or IP address to view its configuration.
  • Page 23 Provides additional information on the firmware version. Online Status Shows the XPort Pro status as Online, Offline, Unreachable (if the XPort Pro is on a different subnet), or Busy (if the XPort Pro is currently performing a task). IP Address Shows the XPort Pro device’s current IP address.

  • Page 24: 4: Configuration Using Web Manager

    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 unit in the address bar. The IP address may have been assigned manually using the DeviceInstaller application (see...

  • Page 25: Device Status Page

    4: Configuration Using Web Manager Device Status Page The Device Status page is the first page that appears after you log into Web Manager. It also appears when you click Status in the menu bar (Figure 4-2). Figure 4-2 Web Manager Home Page XPort®...

  • Page 26: Web Manager Page Components

    4: Configuration Using Web Manager Web Manager Page Components The layout of a typical Web Manager page is below. Figure 4-3 Components of the Web Manager Page Logout Links to Items to button configure subpages Header Menu Bar Configuration and/or Status Area Footer Information...

  • Page 27: Navigating The Web Manager

    Some pages are read-only, while others let you change configuration settings. 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.
  • Page 28 4: Configuration Using Web Manager Web Manager Page Description (continued) Page Shows LPD (Line Printer Daemon) Queue statistics and lets you configure the LPD and print a test page. Modbus Shows the current connection status of the Modbus servers listening on the TCP ports and lets you configure the Modbus settings.

  • Page 29: 5: Network Settings

    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 ...

  • Page 30: Network 1 (Eth0) Interface Configuration

    5: Network Settings Network 1 (eth0) Interface Configuration This page shows the configuration settings for the Ethernet connection and lets you change these settings. To view and configure network interface settings: 1. Click Network on the menu bar and then Network 1 > Interface > Configuration at the top of the page.
  • Page 31 5: Network Settings Network 1 Interface Description Configuration Settings (continued) 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.

  • Page 32: Network 1 Ethernet Link

    5: Network Settings Network 1 Ethernet Link This page shows the current negotiated Ethernet settings and lets you change the speed and duplex settings. To view and configure the Ethernet link: 1. Click Network on the menu bar and then click Network 1 > Link at the top of the page. The Network 1 (eth0) Ethernet Link page appears.

  • Page 33: 6: Line And Tunnel Settings

    This chapter describes how to view and Note: The number of lines and tunnels available for configure lines and tunnels. It contains the viewing and configuration differ between Lantronix following sections: products. For example, the XPort® Pro embedded networking module and the EDS1100 device server Line Settings ...

  • Page 34: Line Configuration

    2. Select a line number at the top of the page. 3. Select Configuration. The Configuration page for the selected line appears. Figure 6-2 Line 1 Configuration Note: The Interface option is only supported in XPort Pro, EDS4100, EDS1100 and EDS2100 device servers. XPort® Pro Embedded Device Server User Guide...

  • Page 35: Table 6-3 Line Configuration

    Interface Select the interface type from the drop-down menu. The default is RS232. Note: This option is only supported in XPort Pro, EDS4100, EDS1100 and EDS2100 device servers. State Indicates whether the current line is enabled. To change the status, select Enabled or Disabled from the drop-down menu.

  • Page 36: Line Command Mode

    6: Line and Tunnel Settings Line Command Mode Figure 6-4 Line 1 Command Mode Setting the Command Mode enables the CLI on the serial line. To configure Command Mode on a specific line: 1. Select Line on the menu bar, if you are not already in the Line web page.

  • Page 37: Tunnel Settings

     network must listen for the Connect Mode’s connection. Connect Mode is disabled by default. Accept Mode: the XPort Pro device listens for a connection. A node on the network initiates  the connection. Accept Mode is enabled by default.

  • Page 38: Tunnel - Statistics

    These instructions also apply to additional tunnel menu options. Tunnel – Statistics The XPort Pro logs statistics for tunneling. The Dropped statistic shows connections ended by the remote location. The Disconnects statistic shows connections ended by the XPort Pro unit.

  • Page 39: Figure 6-6 Tunnel 1 Statistics

    6: Line and Tunnel Settings Figure 6-6 Tunnel 1 Statistics Additional information appears for each active tunnel connection including a link allowing you to terminate the connection. XPort® Pro Embedded Device Server User Guide...

  • Page 40: Tunnel - Serial Settings

    6: Line and Tunnel Settings Tunnel – Serial Settings Serial line settings are configurable for the corresponding serial line of the specific tunnel. Configure the buffer size to change the maximum amount of data the serial port stores. For any active connection, the device sends the data in the buffer.

  • Page 41: Tunnel - Packing Mode

    6: Line and Tunnel Settings Tunnel – Packing Mode Packing Mode takes data from the serial port, packs it together, and sends it over the network. Packing can be configured based on threshold (size in bytes, timeout (milliseconds), or a single character.

  • Page 42: Figure 6-10 Tunnel 1 Packing Mode (Mode = Timeout)

    6: Line and Tunnel Settings Figure 6-10 Tunnel 1 Packing Mode (Mode = Timeout) Figure 6-11 Tunnel 1 Packing Mode (Mode = Send Character) 4. Enter or modify the following settings: Table 6-12 Tunnel Packing Mode Tunnel - Packing Mode Description Settings Mode...

  • Page 43: Tunnel - Accept Mode

    Controls how a specific tunnel number behaves when a connection attempt originates from the network. In Accept Mode, the XPort Pro waits for a connection from the network. The configurable local port is the port the remote device connects to for this connection. There is no remote port or address.

  • Page 44: Figure 6-13 Tunnel 1 Accept Mode

    3. Select Accept Mode. The Accept Mode page for the specific tunnel appears. Figure 6-13 Tunnel 1 Accept Mode Note: The CP Output option is only supported in XPort Pro and XPort AR. 4. Enter or modify the following settings: XPort® Pro Embedded Device Server User Guide...

  • Page 45: Table 6-14 Tunnel Accept Mode

    6: Line and Tunnel Settings Table 6-14 Tunnel Accept Mode Tunnel - Accept Mode Description Settings Mode Select the method used to start a tunnel in Accept mode. Choices are:  Disable = do not accept an incoming connection.  Always = accept an incoming connection (default) ...

  • Page 46: Tunnel - Connect Mode

    Have a remote port configured  Enter the remote host address as an IP address or DNS name. The XPort Pro device will make a connection only if it can resolve the address. For DNS names, the XPort Pro will re-evaluate the address after being established for 4 hours.

  • Page 47: Figure 6-15 Tunnel 1 - Connect Mode

    Note: The Host Mode options is supported in all products except the XPort AR. Note: The CP Output option is only supported in MatchPort b/g Pro, XPort Pro and XPort AR device servers. XPort® Pro Embedded Device Server User Guide...

  • Page 48: Table 6-16 Tunnel Connect Mode

     Always = a connection is attempted until one is made. If the connection gets disconnected, the XPort Pro retries until it makes a connection. (default)  Any Character = a connection is attempted when any character is read on the serial line.
  • Page 49 5. Click Submit. The host is configured. A second host appears underneath the newly configured host. 6. Repeat these steps to configure additional hosts as necessary. XPort Pro supports configuration of up to sixteen hosts. XPort® Pro Embedded Device Server User Guide...

  • Page 50: Connecting Multiple Hosts

    Connecting Multiple Hosts If more than one host is configured, a Host Mode option appears. Host Mode controls how multiple hosts will be accessed. For XPort Pro, the Connect Mode supports up to sixteen Hosts. Hosts may be accessed sequentially or simultaneously: Sequential –...

  • Page 51: Tunnel - Disconnect Mode

    The XPort Pro receives the stop character.  The timeout period has elapsed and no activity is going in or out of the XPort Pro device. Both  Accept Mode and Connect Mode must be idle for the time frame.

  • Page 52: Tunnel - Modem Emulation

    AT?. Use ATDT, ATD, and ATDP to establish a connection. All of these commands behave like a modem. For commands that are valid but not applicable to the XPort Pro, an “OK” message is sent (but the command is silently ignored).
  • Page 53 When using ATDT and ATDP, enter 0.0.0.0 to switch to the Command Line Interface (CLI). Once the CLI is exited by using the CLI exit command, the XPort Pro reverts to modem emulation mode. By default, the +++ characters are not passed through the connection. Turn on this capability using the modem echo pluses command.

  • Page 54: Figure 6-21 Tunnel 1 Modem Emulation

    6: Line and Tunnel Settings Figure 6-21 Tunnel 1 Modem Emulation 4. Enter or modify the following settings: Table 6-22 Tunnel Modem Emulation Tunnel- Modem Description Emulation Settings Echo Pluses Select Enabled to echo +++ when entering modem Command Mode. Echo Commands Select Enabled to echo the modem commands to the console.

  • Page 55: 7: Terminal And Host Settings

    Host Configuration  The Terminal Login Connect Menu feature allows the XPort Pro embedded device server to present a menu of predefined connections when the device is accessed via telnet, ssh, or a serial port. From the menu, a user can choose one of the presented options and the device automatically makes the predefined connection.

  • Page 56: Terminal Line Configuration

    7: Terminal and Host Settings Table 7-2 Terminal on Network Configuration Terminal on Network Description Configuration Settings Terminal Type Enter text to describe the type of terminal. The text will be sent to a host via IAC. Note: IAC means, “interpret as command.” It is a way to send commands over the network such as send break or start echoing.

  • Page 57: Host Configuration

    2. Select a specific host number at the top of the page. The Host Configuration page for the selected host appears. Note: Number of hosts available differ among Lantronix products. Hosts available for selection may appear listed on the screen (see Figure 7-5) or within a drop-down menu above the Configuration button.

  • Page 58: Figure 7-5 Host Configuration

    7: Terminal and Host Settings Figure 7-5 Host Configuration 3. Enter or modify the following settings: Table 7-6 Host Configuration Host Settings Description Name Enter a name for the host. This name appears on the Login Connect Menu. To leave a host out of the menu, leave this field blank. Protocol Select the protocol to use to connect to the host.

  • Page 59: 8: Configurable Pin Manager

    CP into a group. Default Groups XPort Pro unit has several predefined CP groups used to assign a CP to a needed function. For instance, when working with an RS485 driver that requires a signal to be asserted when in half–...

  • Page 60: Cpm: Cp (Configurable Pins)

    8: Configurable Pin Manager CPM: CP (Configurable Pins) Each CP is associated with an external hardware pin. CPs can trigger an outside event, like sending an email message or starting Command Mode on a serial Line. The CPM web page is used to experimentally configure the state of the CPs. CPs can be changed to be a digital input or a digital output, and whether it is asserted high or low.

  • Page 61: Table 8-2 Cpm Cps Current Configuration

    8: Configurable Pin Manager The Current Configuration table shows the current settings for each CP. Table 8-2 CPM CPs Current Configuration CPM – CPs Current Description Configuration Indicates the configurable pin number. Indicates the hardware pin number associated with the CP. Configured As Shows the CP configuration.

  • Page 62: Cpm: Groups

    8: Configurable Pin Manager To change a CP configuration: 1. Select the CP number (in CP column) from the current configuration table. 2. Select the CP configuration from the Type drop-down list in the CP Status table. 3. (If necessary) Select the Assert Low checkbox. 4.

  • Page 63: Figure 8-6 Cpm: Group Status

    8: Configurable Pin Manager Table 8-5 CPM Groups Current Configuration CPM – Groups Current Description Configuration Group (Name) Shows the CP group’s name. State Indicates whether the group is enabled or disabled. CP Info Indicates the number of CPs assigned to this particular group. Figure 8-6 CPM: Group Status To display the status of a specific group:...

  • Page 64: Table 8-7 Group Status

    Group Status Name Shows the CP Group name. State Shows the current state of the CP group. Locked groups are Lantronix default groups and cannot be deleted. Use the button in this field to enable or disable the group. Value Shows the CP group’s current value.
  • Page 65 8: Configurable Pin Manager To enable or disable a CP group: 1. Select CPM > Groups. 2. Select the Group name in the table representing the group you wish to enable or disable. The Group Status information for this group appears in a table below. 3.

  • Page 66: 9: Service Settings

    When a DNS name is resolved using a forward lookup, the results are stored in the DNS cache temporarily. The XPort Pro checks this cache when performing forward lookups. Each item in the cache eventually times out and is removed automatically after a certain period, or you can delete it manually.

  • Page 67: Point-To-Point (Ppp) Settings

    (both of which are external devices). Use the XPort Pro Web Manager or CLI to configure a network link using PPP over a serial line. Turn off Connect Mode, Accept Mode, and Command mode before enabling PPP. The XPort Pro device acts as the server side of the PPP link;...

  • Page 68: Figure 9-2 Ppp Configuration Settings

    The following section describes the steps to configure PPP 1 (PPP on serial line 1); these steps also apply to any line instance of the device. Since the XPort Pro unit does not support NAPT (Network Address and Port Translation), static routing table entries must be added to both the serial-side and network-side devices (both of which are external to the XPort Pro embedded device server).

  • Page 69: Snmp Settings

    To configure SNMP: 1. Select SNMP on the menu bar. The SNMP page opens and shows the current SNMP configuration. Figure 9-4 SNMP Configuration Note: The system description string will reflect the specific Lantronix product. XPort® Pro Embedded Device Server User Guide...

  • Page 70: Ftp Settings

    9: Service Settings 2. Enter or modify the following settings: Table 9-5 SNMP SNMP Settings Description State Select Enabled to enable SNMP. Read Community Enter the SNMP read-only community string. Write Community Enter the SNMP read/write community string. System Contact Enter the name of the system contact.

  • Page 71: Tftp Settings

    9: Service Settings Table 9-7 FTP Settings FTP Settings Description State Select Enabled to enable the FTP server. Admin Username Enter the username to use when logging in via FTP. Admin Password Enter the password to use when logging in via FTP. 3.

  • Page 72: Syslog Settings

    9: Service Settings TFTP Settings (continued) Description Allow Firmware Update Specifies whether or not the TFTP Server is allowed to accept a firmware update for the device. An attempt to update firmware is recognized based on the name of the file. Note: TFTP cannot authenticate the client, so the device is open to malicious update.

  • Page 73: Http Settings

    HTTP Authentication enables the requirement of usernames and passwords for access to the XPort Pro device. This page has three links at the top for viewing statistics and for viewing and changing configuration and authentication settings.

  • Page 74: Figure 9-12 Http Statistics

    9: Service Settings Figure 9-12 HTTP Statistics Note: The HTTP log is a scrolling log, with the last Max Log Entries cached and viewable. You can change the maximum number of entries that can be viewed on the HTTP Configuration Page. XPort®...

  • Page 75: Http Configuration

    9: Service Settings HTTP Configuration On this page you may change HTTP configuration settings. To configure HTTP: 1. Select HTTP on the menu bar and then Configuration at the top of the page. The HTTP Configuration page opens. Figure 9-13 HTTP Configuration 2.
  • Page 76 9: Service Settings HTTP Configuration Description Settings (continued) Secure Protocols Select to enable or disable the following protocols:  SSL3 = Secure Sockets Layer version 3 TLS1.0 = Transport Layer Security version 1.0. TLS 1.0 is the successor of  SSL3 as defined by the IETF.

  • Page 77: Http Authentication

    HTTP Authentication HTTP Authentication enables you to require usernames and passwords to access specific web pages or directories on the XPort Pro built-in web server. To configure HTTP authentication settings: 1. Select HTTP on the menu bar and then Authentication at the top of the page. The HTTP Authentication page opens.

  • Page 78: Rss Settings

    Web users. Instead of actively searching for XPort Pro configuration changes, RSS feeds permit viewing only relevant and new information regarding changes made to the XPort Pro embedded device server via an RSS publisher. The RSS feeds may also be stored to the file system cfg_log.txt file.

  • Page 79: Lpd Settings

    4. In the Current Status table, view and clear stored RSS Feed entries, as necessary. LPD Settings The XPort Pro device acts as a print server if a printer gets connected to one of its serial ports. Selecting the Line Printer Daemon (LPD) link in the Main Menu displays the LPD web page. The LPD web page has three sub-menus for viewing print queue statistics, changing print queue configuration, and printing a test page.

  • Page 80: Lpd Configuration

    9: Service Settings Figure 9-19 LPD Statistics 4. Repeat above steps as desired, according to additional LPD(s) available on your product. LPD Configuration Here you can change LPD configuration settings. To configure LPD settings for a specific LPD line: 1. Select LPD on the menu bar, if you are not already at the LPD web page. 2.

  • Page 81: Print Test Page

    9: Service Settings Table 9-21 LPD Configuration LPD Configuration Description Settings Banner Select Enabled to print the banner even if the print job does not specify to do so. Selected by default. Binary Select Enabled for the device to pass the entire file to the printer unchanged. Otherwise, the device passes only valid ASCII and valid control characters to the printer.

  • Page 82: 10: Security Settings

    Two instances require configuration: when the XPort Pro unit is the SSH server and when it is an SSH client. The SSH server is used by the CLI (Command Mode) and for tunneling in Accept Mode.

  • Page 83: Ssh Server Host Keys

    10: Security Settings SSH Server Host Keys SSH Host Keys can be obtained in a few different ways: Uploading keys via PUTTY or other tools which generate RFC4716 format keys.  Creating keys through the device.  The steps for creating or uploading keys is described below. To upload SSH server host keys generated from PuTTY: 1.

  • Page 84: Table 10-2 Ssh Server Host Keys Settings - Upload Keys Method

    5. Click Submit. Note: SSH keys may be created on another computer and uploaded to the XPort Pro embedded device server. For example, use the following command using Open SSH to create a 1024-bit DSA key pair: ssh-keygen –b 1024 –t dsa...

  • Page 85: Ssh Server Authorized Users

    On this page you can change SSH server settings for Authorized Users. SSH Server Authorized Users are accounts on the XPort Pro device server that can be used to log into the XPort Pro using SSH. For instance, these accounts can be used to SSH into the CLI or open an SSH connection to a device port.

  • Page 86: Figure 10-5 Ssh Server: Authorized Users

    10: Security Settings To configure the SSH server for authorized users: 1. Select SSH on the menu bar and then Server Authorized Users at the top of the page. The SSH Server: Authorized Users page appears. Figure 10-5 SSH Server: Authorized Users 2.

  • Page 87: Ssh Client Known Hosts

    10: Security Settings SSH Client Known Hosts On this page you can change SSH client settings for known hosts. Note: You do not have to complete the fields on this page for communication to occur. However, completing them adds another layer of security that protects against Man-In- The-Middle (MITM) attacks.

  • Page 88: Ssh Client Users

    10: Security Settings SSH Client Users On this page you can change SSH client settings for users. To configure the XPort Pro device server as an SSH client, an SSH client user must be both configured and also exist on the remote SSH server.

  • Page 89: Table 10-10 Ssh Client Users

    10: Security Settings 2. Enter or modify the following settings: Table 10-10 SSH Client Users SSH Client: Users Description Settings Username Enter the name that the device uses to connect to a SSH server. Password Enter the password associated with the username. Remote Command Enter the command that can be executed remotely.

  • Page 90: Ssl Settings

    Sometimes only the server is authenticated; sometimes both server and client are authenticated. The XPort Pro device server can be server and/or client, depending on the application. Public key encryption systems exchange information and keys and set up the encrypted tunnel.

  • Page 91: Ssl Certificates

    RSA-style certificate. The RSA key exchange method can work with this style if an RSA certificate is stored in the XPort Pro unit. The creation of a self-signed SSL certificate supports MD5 hash algorithms with a 1024 bit key length.

  • Page 92: Ssl Utilities

    SBR changes the format it uses to store these strings and becomes incompatible with the current XPort Pro release. We will add support for this and other formats in future releases. Free RADIUS—Linux open-source RADIUS server. It is versatile, but complicated to configure.

  • Page 93: Ssl Configuration

    10: Security Settings SSL Configuration To configure SSL settings: 1. Select SSL from the main menu. The SSL page appears. Figure 10-12 SSL XPort® Pro Embedded Device Server User Guide...

  • Page 94: Table 10-13 Ssl

    10: Security Settings 2. Enter or modify the following settings: Table 10-13 SSL SSL Settings Description Upload Certificate New Certificate This certificate identifies the device to peers. It is used for HTTPS and SSL Tunneling. Enter the path and name of the certificate you want to upload, or use the Choose File button to select the certificate.
  • Page 95 10: Security Settings SSL Settings (continued) Description Common Name Enter the same name that the user will enter when requesting your web site. Example: If a user enters http://www.widgets.abccompany.com to access your web site, the Common Name would be www.widgets.abccompany.com. Expires Enter the expiration date, in mm/dd/yyyy format, for the new self-signed certificate.

  • Page 96: 11: Modbus

    11: Modbus Modbus ASCII/RTU based serial slave devices can be connected via the Ethernet through an existing Modbus TCP/IP network. Any device having access to a given Modbus implementation will be able to perform full range of operations that the implementation supports. Modbus/TCP uses a reserved TCP port of 502 and includes a single byte function code (1=255) preceded by a 6 byte header: Table 11-1 6 Byte Header of Modbus Application Protocol...

  • Page 97: Table 11-3 Modbus Local Slave Functions - Response

    11: Modbus Name Number Address Address Data Hi Data Lo Bytes Value [5] Hi [0] Lo [1] Count [4] Force Single Coil 0x05 0x00 0x00-0x02 0xff (set CPx 0x00 to 1) or Output CP 0x00 (set CPx CP1 – CP3 to 0) Preset Single 0x06...

  • Page 98: Serial Transmission Mode

    11: Modbus Name Number Byte Data [0] Data [1] Data Data [3] Data Data [5] Count Force 0x0F Echo query Echo query Echo query Echo Multiple query Coil Preset 0x10 Echo query Echo query Echo query Echo Multiple query Registers Read/ 0x17 0x02-0x06...

  • Page 99: Modbus Statistics

    11: Modbus Modbus Statistics This read-only web page displays the current connection status of the Modbus servers listening on the TCP ports. When a connection is active, the remote client information is displayed as well as the number of PDUs that have been sent and received. Additionally, a Kill link will be present which can be used to kill the connection.

  • Page 100: Modbus Configuration

    11: Modbus Modbus Configuration This web page shows the current negotiated Modbus settings and allows configuration changes. To view and configure the Modbus Server: 1. Click Modbus on the menu bar and then click Configuration at the top of the page. The Modbus Configuration page appears.

  • Page 101: 12: Maintenance And Diagnostics Settings

    System Settings  Filesystem Settings The XPort Pro embedded device server uses a flash filesystem to store files. Use the Filesystem option to view current file statistics or modify files. There are two subsections: Statistics and Browse. The Statistics section of the Filesystem web page shows current statistics and usage information of the flash filesystem.

  • Page 102: Filesystem Browser

    12: Maintenance and Diagnostics Settings 6. Click OK in the warning window which appears. Filesystem Browser To browse the filesystem: 1. Select Filesystem on the menu bar and then Browse at the top of the page. The Filesystem Browser page opens. Figure 12-2 Filesystem Browser XPort®...

  • Page 103: Table 12-3 Filesystem Browser

    12: Maintenance and Diagnostics Settings 2. Select a filename to view the contents. 3. Click the X next to a filename to delete the file or directory. You can only delete a directory if it is empty. 4. Enter or modify the following settings: Note: Changes apply to the current directory view.

  • Page 104: Protocol Stack Settings

    12: Maintenance and Diagnostics Settings Protocol Stack Settings In the Protocol Stack web page, you can configure TCP, IP, ICMP, SMTP and ARP. TCP Settings To configure the TCP network protocol: 1. Select Protocol Stack on the menu bar. 2. Select TCP. Figure 12-4 TCP Protocol 3.

  • Page 105: Ip Settings

    12: Maintenance and Diagnostics Settings Protocol Stack Description TCP Settings Max Retrans Enter the maximum number of retransmissions of a packet that will be attempted before failing. Max Retrans Syn/Ack Enter the maximum number of retransmissions of a SYN that will be attempted before failing.

  • Page 106: Icmp Settings

    12: Maintenance and Diagnostics Settings ICMP Settings To configure the ICMP network protocol: 1. Select Protocol Stack on the menu bar. 2. Select ICMP. Figure 12-8 ICMP Protocol 3. Select the appropriate state. Table 12-9 ICMP Settings Protocol Stack Description ICMP Settings State The State selection is used to turn on/off processing of ICMP messages.

  • Page 107: Arp Settings

    12: Maintenance and Diagnostics Settings ARP Settings To configure the ARP network protocol: 1. Select Protocol Stack on the menu bar. 2. Select ARP. Figure 12-10 ARP Protocol Page 3. Modify the following settings: Table 12-11 ARP Settings Protocol Stack Description ARP Settings ARP Timeout...

  • Page 108: Smtp Settings

    SMTP is configuration for a basic SMTP proxy. An SMTP proxy in this sense is a simple forwarding agent. Note: Lantronix does not support SMTP AUTH or any other authentication or encryption schemes for email. Please see Email Settings for additional information.

  • Page 109: Ip Address Filter

    12: Maintenance and Diagnostics Settings IP Address Filter The IP address filter specifies the hosts and subnets permitted to communicate with the XPort Pro device server. When the filter list is empty, then all IP addresses are allowed. Note: If using DHCP/BOOTP, ensure the DHCP/BOOTP server is in this list.

  • Page 110: Query Port

    12: Maintenance and Diagnostics Settings Query Port The query port (0x77FE) is used for the automatic discovery of the device by the DeviceInstaller utility. Only 0x77FE discover messages from DeviceInstaller are supported. For more information on DeviceInstaller, see Using DeviceInstaller (on page 22).

  • Page 111: Diagnostics

    12: Maintenance and Diagnostics Settings Diagnostics The XPort Pro device server has several tools to perform diagnostics and view device statistics. These include information on: Hardware  MIB-II Statistics  IP Sockets  Ping  Traceroute   Memory ...

  • Page 112: Mib-Ii Statistics

    MIB-II Statistics The MIB-II Network Statistics page shows the various SNMP-served Management Information Bases (MIBs) available on the XPort Pro device server. To view MIB-II statistics: 1. Select Diagnostics on the menu bar and then MIB-II at the top of the page menu. The MIB-II Network Statistics page opens.

  • Page 113: Ip Sockets

    Figure 12-20 IP Sockets Ping XPort Pro device server uses 56 bytes of data in a ping packet. Ping size is not configurable. To ping a remote device or computer: 1. Select Diagnostics on the menu bar and then Ping at the top of the page. The Diagnostics: Ping page opens.

  • Page 114: Traceroute

    Traceroute Here you can trace a packet from the XPort Pro unit to an Internet host, showing how many hops the packet requires to reach the host and how long each hop takes. If you visit a web site whose pages appear slowly, you can use traceroute to determine where the longest delays are occurring.

  • Page 115: Log

    12: Maintenance and Diagnostics Settings Here you can enable a diagnostics log of configuration items: To use diagnostics logging: 1. Select Diagnostics on the menu bar and then Log at the top of the page. The Diagnostics: Log page opens. Figure 12-25 Diagnostics: Log 2.

  • Page 116: Memory

    12: Maintenance and Diagnostics Settings Figure 12-27 Diagnostics: Log (Line 1) 3. Enter the Max Length in kilobytes (if filesystem output type is selected). 4. Select the Severity Level (if a line or filesystem output type is selected): Debug  Information ...

  • Page 117: Buffer Pools

    12: Maintenance and Diagnostics Settings Buffer Pools Several parts of the XPort Pro system use private buffer pools to ensure deterministic memory management. To display the buffer pools: 1. Select Diagnostics on the menu bar and then Buffer Pools at the top of the page. The Diagnostics: Buffer Pools page opens.

  • Page 118: Figure 12-30 Processes

    12: Maintenance and Diagnostics Settings Figure 12-30 Processes XPort® Pro Embedded Device Server User Guide...

  • Page 119: System Settings

    12: Maintenance and Diagnostics Settings System Settings The XPort Pro System web page allows for rebooting the device, restoring factory defaults, uploading new firmware, configuring the short and long name, and viewing the current system configuration. To configure system settings: 1.
  • Page 120 Changes take place upon the next reboot. Note: Additional information about long and short name customization is available in Short and Long Name Customization on page 136 Chapter 14: Branding the XPort Pro Unit. 3. Click Submit. XPort® Pro Embedded Device Server User Guide...

  • Page 121: 13: Advanced Settings

    Command Line Interface Settings  XML Settings  Email Settings The XPort Pro allows you to view and configure email alerts relating to the events occurring within the system. Please see SMTP Settings on page 108 for additional information. Note: The following section describes the steps to configure Email 1;...

  • Page 122: Figure 13-1 Email Statistics

    13: Advanced Settings Figure 13-1 Email Statistics XPort® Pro Embedded Device Server User Guide...

  • Page 123: Email Configuration

    13: Advanced Settings Email Configuration The XPort Pro device server allows you to view and configure email alerts relating to the events occurring within the system. To configure email settings: 1. Select Email on the menu bar, if you are not already at the Email web page.
  • Page 124 13: Advanced Settings Email – Configuration Description Settings (continued) From Enter the email address to list in the From field of the email alert. Required field if an email is to be sent. Reply-To Enter the email address to list in the Reply-To field of the email alert. Subject Enter the subject for the email alert.

  • Page 125: Command Line Interface Settings

    13: Advanced Settings Command Line Interface Settings The Command Line Interface (CLI) web page enables you to view statistics about the CLI servers listening on the Telnet and SSH ports and to configure CLI settings. CLI Statistics Figure 13-3 CLI Statistics This read-only page shows the current connection status of the CLI servers listening on the Telnet and...

  • Page 126: Table 13-5 Cli Configuration

    13: Advanced Settings 2. Enter or modify the following settings: Table 13-5 CLI Configuration Command Line Interface Description Configuration Settings Login Password Enter the password for Telnet access. Enable Level Password Enter the password for access to the Command Mode Enable level. There is no password by default.

  • Page 127: Xml Settings

    XML format. The generated XML file can be imported later to restore a configuration. It can also be modified and imported to update the configuration on this XPort Pro unit or another. The XML data can be exported to the browser window or to a file on the file system.

  • Page 128: Xml: Export Configuration

    Configuration 2. Enter or modify the following settings: Note: Number of lines and groups available for export configuration vary between Lantronix products. Table 13-7 XML Export Configuration XML Export Description Configuration Settings Export to browser Select this option to export the XCR data in the selected fields to a web browser.

  • Page 129: Xml: Export Status

    13: Advanced Settings XML Export Description Configuration Settings (continued) Lines to Export Select the instances you want to export in the line, LPD, PPP, tunnel, and terminal groups. Click Clear All to clear all Lines to Export checkboxes. Click Select All to select all Lines to Export checkboxes.

  • Page 130: Figure 13-8 Xml Export Status

    13: Advanced Settings Figure 13-8 XML Export Status Note: Number of lines and groups available for export vary between Lantronix products. Table 13-9 XML Export Status XML: Export System Description Status Settings Export to browser Select this option to export the XML status record to a web browser.

  • Page 131: Xml: Import Configuration

    13: Advanced Settings XML: Import Configuration Here you can import a system configuration from an XML file. The XML data can be imported from a file on the file system or uploaded using HTTP. The groups to import can be specified by toggling the respective group item or entering a filter string. When toggling a group item, all instances of that group will be imported.

  • Page 132: Figure 13-12 Xml: Import From Filesystem

    This selection shows a page for entering the filesystem and your import requirements – groups, lines, and instances. Note: Number of lines and groups available for import configuration vary between Lantronix products. Figure 13-12 XML: Import from Filesystem XPort® Pro Embedded Device Server User Guide...

  • Page 133: Figure 13-13 Xml: Import Configuration From Filesystem

    13: Advanced Settings 1. Enter or modify the following settings. Figure 13-13 XML: Import Configuration from Filesystem Import Configuration from Description Filesystem Settings Filename Enter the name of the file on the device (local to its filesystem) that contains XCR data. Lines to Import Select the lines or network whose settings you want to import.

  • Page 134: Figure 13-14 Xml: Import Line(S) From Single Line Settings On The Filesystem

    13: Advanced Settings Import Line(s) from Single Line Settings on the Filesystem This selection copies line settings from the single line instance in the input file to selected lines. The import file may only contain records from a single line instance; this is done by selecting a single Line to Export when exporting the file.

  • Page 135: Table 13-15 Xml: Import Line(S) From Single Line Settings

    13: Advanced Settings 1. Enter or modify the following settings: Table 13-15 XML: Import Line(s) from Single Line Settings Import Line(s) Settings Description Filename Provide the name of the file on the device (local to its file system) that contains XCR data. Lines to Import Select the line(s) whose settings you want to import.

  • Page 136: 14: Branding The Xport Pro Unit

    14: Branding the XPort Pro Unit This chapter describes how to brand your XPort Pro device server by using Web Manager and Command Line Interface (CLI). It contains the following sections on customization: Web Manager Customization  Short and Long Name Customization ...

  • Page 137: 15: Updating Firmware

    2. Click Choose File to browse to the firmware file. 3. Highlight the file and click Open. 4. Click Upload to install the firmware on the XPort Pro device server. The device automatically reboots on the installation of new firmware.

  • Page 138: A: Technical Support

    A: Technical Support Lantronix offers many resources to support our customers and products at http://www.lantronix.com/support. For instance, you can ask a question, find firmware downloads, access the FTP site and search through tutorials. At this site you can also find FAQs, bulletins, warranty information, extended support services and product documentation.

  • Page 139: Table B-1 Binary To Hexadecimal Conversion Table

    B: Binary to Hexadecimal Conversions Many of the unit’s configuration procedures require you to assemble a series of options (represented as bits) into a complete command (represented as a byte). The resulting binary value must be converted to a hexadecimal representation. Use this chapter to learn to convert binary values to hexadecimals or to look up hexadecimal values in the tables of configuration options.

  • Page 140: Scientific Calculator

    B: Binary to Hexadecimal Conversions Scientific Calculator Another simple way to convert binary to hexadecimal is to use a scientific calculator, such as the one available on the Windows operating systems. For example: 1. On the Windows Start menu, click Programs > Accessories > Calculator. 2.

  • Page 141: C: Compliance

    (According to ISO/IEC Guide 17050-1, 17050-2 and EN 45014) Manufacturer’s Name & Address: Lantronix, Inc. 7535 Irvine Center Drive, Suite 100, Irvine, CA 92618 USA Product Name Model: XPort® Pro Embedded Device Server Conform to the following standards or other normative documents:...

  • Page 142: Rohs, Reach And Weee Compliance Statement

    Lantronix, Inc. 7535 Irvine Center Drive, Suite 100 Irvine, CA 92618 USA Tel: 949-453-3990 Fax: 949-453-3995 RoHS, REACH and WEEE Compliance Statement Please visit http://www.lantronix.com/legal/rohs/ for Lantronix's statement about RoHS, REACH and WEEE compliance. XPort® Pro Embedded Device Server User Guide...

  • Page 143: Index

    Index CHAP 67 CLI 18 CLI Configuration 125 CLI Statistics 125 Command Line Interface Settings 125 Command Mode 20 Accept Mode 37 Command-Line Interface 18 Accept Mode 43 Common Name 95 Additional Documentation 15 Compliance 141 Additional TCP Server Port 100 Configurable Pin Manager 59 Address Configuration Methods 20...
  • Page 144 Key Type 84, 89 Firmware 137 Flush Serial Data 45, 49 Formfeed 81 FreeRADIUS 92 Label 21 FTP 17, 137 Lantronix Discovery Protocol 21 FTP Configuration 70 Level 61 Line 1 Configuration 34 Statistics 33 Groups to Export 129, 130...
  • Page 145 LPD Statistics 79 Persistent 79 Point-to-Point Protocol 67 Port 103 Port Numbers 20 Ports MAC Address 20, 21 Serial and Telnet 20 Maintenance and Diagnostics Settings Power Supply 16 Protocol Stack 104 PPP 17 Maintenance Settings 101 PPP Peer Device 67 Manufacturer’s Name &...
  • Page 146 Secure Com Port Redirector 19 Secure Shell 82 TCP 17 Secure Sockets Layer 82, 90 TCP Keep Alive 45 Security TCP Server State 100 Enterprise-Grade 18 TCP Settings 104 Settings 82 TCP/IP 96 Security Settings 82 Technical Support 138 SSL Certificates and Private Keys 91 Telnet 17 SSL Cipher Suites 90 Telnet Max Sessions 126...
  • Page 147 Web Manager Device Status Web Page 25 Navigating 27 Page Components 26 Page Summary 27 Web Manager Customization 136 Web Manager 24 Web-Based Configuration 18 Whole Groups to Import 133, 135 WLAN Settings Network 1 Ethernet Link 32 Write Community 70 XML 20 Export Configuration 128 Export Status 129...

Table of Contents