Lantronix XPort AR User Manual
  1. Manuals
  2. Brands
  3. Lantronix Manuals
  4. Network Card
  5. XPort AR
  6. User manual
Lantronix XPort AR User Manual

Lantronix XPort AR User Manual

Lantronix network adapter user guide
Hide thumbs Also See for XPort AR:
Table of Contents

Advertisement

Quick Links

Download this manual
XPort AR
User Guide
Part Number 900-405
Revision F May 2010

Advertisement

Table of Contents
loading

Related Manuals for Lantronix XPort AR

Summary of Contents for Lantronix XPort AR

  • Page 1 XPort AR User Guide Part Number 900-405 Revision F May 2010...
  • Page 2 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 and Revisions The information in this guide may change without notice. The manufacturer assumes no responsibility for any errors that may appear in this guide.

  • Page 3: Revision History

    Date Rev. June 2005 November 2005 December 2006 March 2007 June 2009 May 2010 XPort AR User Guide Comments Initial document. Added V2.0 software information. Added V3.0 information. Corrected pin numbers. Update to firmware v4.0.0.0R16. Updated for firmware release 5.1.0.0R10.

  • Page 4: Table Of Contents

    IP Address ____________________________________________________________ 19 Port Numbers _________________________________________________________ 19 Product Information Label ___________________________________________________ 19 3: Using DeviceInstaller Accessing XPort AR using DeviceInstaller_______________________________________ 21 Device Details Summary ____________________________________________________ 21 4: Configuration Using Web Manager Accessing Web Manager ____________________________________________________ 23 Web Manager_____________________________________________________________ 25...
  • Page 5 Remove CPs from CP Groups_____________________________________________ 65 9: Services Settings DNS Status and Cache _____________________________________________________ 66 PPP Configuration _________________________________________________________ 67 SNMP Configuration _______________________________________________________ 69 FTP ____________________________________________________________________71 TFTP ___________________________________________________________________ 72 Syslog __________________________________________________________________ 73 HTTP ___________________________________________________________________ 75 HTTP Statistics ________________________________________________________ 75 XPort AR User Guide Table of Contents...
  • Page 6 Ping ________________________________________________________________ 107 Traceroute ___________________________________________________________ 109 DNS Lookup _________________________________________________________ 110 Memory _____________________________________________________________ 111 Buffer Pools __________________________________________________________ 112 Processes ___________________________________________________________ 112 System _________________________________________________________________ 114 12: Advanced Settings Email Statistics___________________________________________________________ 116 Email Configuration _______________________________________________________ 117 XPort AR User Guide Table of Contents...
  • Page 7 Import Configuration from External File _________________________________ 125 Import Configuration from Filesystem ___________________________________ 126 Import Line(s) from Single Line Settings on the Filesystem __________________ 128 13: Branding the XPort AR Web Manager Customization________________________________________________ 131 Short and Long Name Customization _________________________________________ 131...
  • Page 8 List of Figures Figure 2-1 XPort AR Product Information Label _________________________________________ 20 Figure 4-1 XPort AR Web Manager Home Page ________________________________________ 24 Figure 4-2 Components of a Typical Web Manager Page _________________________________ 25 Figure 5-1 Network 1 (eth0) Interface Status Web Page __________________________________ 28...
  • Page 9 Figure 12-10 Import Lines from Single Line Settings on the Filesystem Web Page _____________ 129 Figure 13-1 System Branding Web Page _____________________________________________ 132 Figure 14-1 System Web Page _____________________________________________________ 133 Figure B-1 Scientific Calculator_____________________________________________________ 136 Figure B-2 Hex Display ___________________________________________________________ 136 XPort AR User Guide...
  • Page 10 Table 10-5 Supported Cipher Suites__________________________________________________ 88 Table 10-6 SSL Fields_____________________________________________________________ 92 Table 11-1 Filesystem Browser Fields ________________________________________________ 97 Table 11-2 TCP Fields ____________________________________________________________ 98 Table 11-3 ARP Web Page Fields __________________________________________________ 101 Table 11-4 IP Address Filter Fields__________________________________________________ 103 XPort AR User Guide...
  • Page 11 Table 12-3 XML Export Configuration Fields __________________________________________ 122 Table 12-4 XML Export Status Fields ________________________________________________ 124 Table 12-5 Import Configuration from Filesystem Fields _________________________________ 128 Table 12-6 Import Lines from Single Line Settings Fields_________________________________ 129 Table B-1 Conversion Values ______________________________________________________ 135 XPort AR User Guide...

  • Page 12: 1: About This Guide

    1: About This Guide This guide describes how to configure, use, and update the XPort AR. It is for software developers and original equipment manufacturers who are embedding the XPort AR in their designs. This chapter contains the following sections: Chapter and Appendix Summaries ...

  • Page 13: Conventions

    Telnet connection or through the serial port. Detailed information about the commands. Also provides details for XML configuration and status. XPort AR Getting Started Guide—Instructions for getting the XPort AR on the evaluation  board up and running.
  • Page 14 Com Port Redirector Quick Start and Online Help—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.

  • Page 15: 2: Overview

    Product Information Label  Key Product Features The XPort AR is designed with additional features above and beyond the original XPort, including: The Evolution OS operating system.  Two full serial ports with all hardware handshaking signals or three serial ports without ...

  • Page 16: Protocol Support

    TFTP, FTP, and HTTP for firmware upgrades and uploading files.  Evolution OS™ The XPort AR features 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 ...

  • Page 17: Command-Line Interface (Cli)

    XPort AR. XML-Based Architecture and Device Control XML is a fundamental building block for the future growth of M2M networks. The XPort AR 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 18: Terminal Server/Device Management

    You can use the XPort AR 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.

  • Page 19: Addresses And Port Numbers

    For example, a Telnet server commonly uses port number 23. The following is a list of the default server port numbers running on the XPort AR: TCP Port 22—SSH Server (Command Mode configuration) ...

  • Page 20: Figure 2-1 Xport Ar Product Information Label

    Bar code  Part number  Serial number (which is the hardware address, also referred to as Ethernet or MAC address)  Figure 2-1 XPort AR Product Information Label XPort AR User Guide 2: Overview...

  • Page 21: 3: Using Deviceinstaller

    3: Using DeviceInstaller This chapter covers the steps for locating a XPort AR unit and viewing its properties and device details. It contains the following sections: Accessing XPort AR using DeviceInstaller  Device Details Summary  DeviceInstaller is a free utility program provided by Lantronix that discovers, configures, upgrades, and manages Lantronix Device Servers.
  • Page 22 Provides additional information on the firmware version. Shows the XPort AR status as Online, Offline, Unreachable (the XPort AR is on a different subnet), or Busy (the XPort AR is currently performing a task). Shows the XPort AR current IP address. To change the IP address, click the Assign IP button on the DeviceInstaller menu bar.

  • Page 23: 4: Configuration Using Web Manager

    Mozilla Suite, Mozilla Firefox, Safari, or Opera. 2. Enter the IP address of the XPort AR in the address bar. The IP address may have been assigned manually using DeviceInstaller or the serial port (see the XPort AR Demo Kit Quick Start Guide) or automatically by DHCP.

  • Page 24: Figure 4-1 Xport Ar Web Manager Home Page

    The Home page is also the Device Status page which appears after you log into the Web Manager. It also appears when you click Status in the Main Menu. Figure 4-1 XPort AR Web Manager Home Page XPort AR User Guide...

  • Page 25: Web Manager

    At the bottom, the current configuration displays. In some cases, you can reset or clear a  setting. At the very bottom, the copyright information displays with a link to the Lantronix home page.  XPort AR User Guide 4: Configuration Using Web Manager...

  • Page 26: Navigating The Web Manager

    Note: There may be times when you must reboot the XPort AR for the new configuration settings to take effect. The chapters that follow indicate when a change requires a reboot. Table 4-1...
  • Page 27 System Lets you reboot the XPort AR, restore factory defaults, upload new firmware, and change the XPort AR long and short names. Terminal Lets you change current settings for a terminal. TFTP Shows statistics and lets you change the current configuration for the Trivial File Transfer Protocol (TFTP) server.

  • Page 28: 5: Network Settings

    To view the Network 1 interface status, click Network on the Main Menu. page that displays. Using this page, you can view the status on your network interfaces. Figure 5-1 Network 1 (eth0) Interface Status Web Page XPort AR User Guide Figure 5-1 shows the...

  • Page 29: Network 1 Interface Configuration

    XPort AR User Guide Figure 5-2 Table 5-1. Description Select On or Off. At boot up the XPort AR will attempt to obtain an IP address from a BOOTP server. Notes:  Overrides the configured IP address, network mask, gateway, hostname, and domain.

  • Page 30: Network 1 Ethernet Link

    XPort AR User Guide Description Select On or Off. At boot up the XPort AR 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 31: Figure 5-3 Network 1 (Eth0) Ethernet Link Web Page

    3. Enter or modify the fields in Table 5-2 Network 1 (eth0) Ethernet Link Fields Field Speed Duplex Click Submit. XPort AR User Guide Figure 5-3 shows the page that displays. Table 5-2. Description Select the Ethernet link speed. Auto is the default.

  • Page 32: 6: Line And Tunnel Settings

    Line 2 button. The XPort AR supports software and hardware flow control on Lines 1 and 2. Line 3 can be configured for software flow control. Tunnels can only be configured on Lines 1 and 2 and not Line 3.

  • Page 33: Line Configuration

    6: Line and Tunnel Settings 1. Click Line on the Main Menu. Figure 6-1 shows the page that displays. Figure 6-1 Line 1 Statistics Web Page Line Configuration To configure a line, perform the following steps. XPort AR User Guide...

  • Page 34: Figure 6-2 Line 1 Configuration Web Page

    State Protocol Baud Rate Parity Data Bits Stop Bits XPort AR User Guide Figure 6-2 Line 1 Configuration Web Page Table 6-1. Description Enter a name for the line. Indicates whether the current line is enabled. To change the status, select Enabled or Disabled from the drop-down menu.

  • Page 35: Line Command Mode

    Line Command Mode To configure the Command Mode, perform the following steps. 1. Click Line > Line 1 > Command Mode. XPort AR User Guide Description Select the flow control from the drop-down menu. The default is None. Specify the character to use to start the flow of data when Flow Control is set to Software.

  • Page 36: Tunnel Settings

    When any character is transmitted to the serial port, it gets copied to the network connection.Tunneling parameters are configured using the Web Manager or CLI Tunnel Menu (refer to the XPort AR Command Reference for the full list of commands).

  • Page 37: Tunnel Statistics

    The XPort AR supports two connections simultaneously per serial port. One of the connections is Connect Mode and the other connection is Accept Mode. The connections on one serial port are separate from those on the other serial port. Connect Mode—Makes an active connection. The receiving node on the network must listen ...

  • Page 38: Serial Settings

    The modem control signal DTR on the Line may be continually asserted or asserted only while either an Accept Mode tunnel or a Connect Mode tunnel is connected. To configure the serial settings, perform the following steps. XPort AR User Guide...

  • Page 39: Figure 6-5 Tunnel 1 Serial Settings Web Page

    2. View or modify the fields in Table 6-3 Tunnel 1 Serial Settings Fields Fields Line Settings Protocol Buffer Size XPort AR User Guide Figure 6-5 Figure 6-5 Tunnel 1 Serial Settings Web Page Table 6-3. Description Display only field. Current serial settings for the line.

  • Page 40: Packing Mode

    It can be a single printable character or a control character. To configure the tunnel packing mode, perform the following steps. 1. Click Tunnel > Tunnel 1 > Packing Mode. Figure 6-6 shows the page that displays. Figure 6-6 Tunnel 1 Packing Mode Web Page XPort AR User Guide...

  • Page 41: Packing Mode Using Timeout

    Description Send the queued data when the number of queued bytes reaches the threshold value. Enter a time, in milliseconds, for the XPort AR to send the queued data after the first character was received. 6: Line and Tunnel Settings...

  • Page 42: Packing Mode Using Send Character

    Tunnel Packing Mode (Send Character) Fields Field Threshold Send Character Trailing Character 2. Click Submit. XPort AR User Guide Table 6-5. Description Send the queued data when the number of queued bytes reaches the threshold value. Enter a single character, either a printable character or control character, for the send character.

  • Page 43: Accept Mode

    The default local port is 10001 for serial port 1 and 10002 for serial port 2. Accept Mode supports the following protocols: SSH (XPort AR acts as the server). When using SSH, the SSH server host keys and at least ...

  • Page 44: Figure 6-9 Tunnel 1 Accept Mode Web Page

    1. Click Tunnel 1 > Accept Mode. 2. Enter or modify the fields in Table 6-6 Tunnel Accept Mode Fields Field Mode XPort AR User Guide Figure 6-9 shows the page displays. Figure 6-9 Tunnel 1 Accept Mode Web Page Table 6-6.

  • Page 45: Connect Mode

    UDP). When enabled, Connect Mode is always on. Enter the remote host address station as an IP address or DNS name. The XPort AR will not make a connection unless it can resolve the address. For DNS names, after 4 hours of an active connection, the XPort AR will re-evaluate the address.
  • Page 46 SSH (the XPort AR is the SSH client)   UDP (available only in Connect Mode because it is a connectionless protocol).  Telnet  Note: The Local Port in Connect Mode is independent of the port configured in Accept Mode.

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

    Select the method to be used to attempt a connection to a remote host or device. Choices are: Always—A connection is attempted until one is made. If the connection  gets disconnected, the XPort AR retries until it makes a connection. (default)  Disable—An outgoing connection is never attempted.
  • Page 48 Modem Control (DSR) is asserted, until a connection is made. Configure the Modem Control Asserted setting (for DSR or DTR) to start a connection when the signal is asserted. The XPort AR will try to make a connection indefinitely. If the connection closes, it will not make another connection unless the signal is asserted again.
  • Page 49  Disabled—Do not flush the serial line. This is the default. Select On to block (not tunnel) serial data transmitted to the XPort AR. Select On to block (not tunnel) network data transmitted to the XPort AR. Select whether the XPort AR sends an email when a connection is made.

  • Page 50: Disconnect Mode

    Disconnect Mode Disconnect Mode ends Accept Mode and Connect Mode connections. It runs in the background of an active connection to determine when to disconnect. When disconnecting, the XPort AR shuts down connections gracefully. The following settings end a connection: Stop character received.

  • Page 51: Modem Emulation

    All of these commands behave like a modem. For commands that are valid but not applicable to the XPort AR, an “OK” message is sent (but the command is silently ignored). The XPort AR attempts to make a Command Mode connection as per the IP/DNS/port numbers defined in Connect Mode.
  • Page 52 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 AR 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 53: Figure 6-12 Tunnel 1 Modem Emulation Web Page

    Echo Pluses Echo Commands Verbose Response Response Type Error Unknown Commands Incoming Connection XPort AR User Guide Figure 6-12 shows the page that displays. Table 6-10. Description Select Enable to echo +++ when entering modem Command Mode. Select Enable to echo the modem commands to the console.
  • Page 54 Table 6-10 Tunnel Modem Emulation Fields (continued) Field Connect String Display Remote IP 3. Click Submit. XPort AR User Guide Description Enter the connect string. This modem initialization string prepares the modem for communications. It is a customized string sent with the “CONNECT” modem response code.

  • Page 55: 7: Terminal And Host Settings

    Network Terminal Configuration To configure menu features applicable to CLI access via the network, perform the following steps. 1. Click Terminal > Network. Figure 7-1 Terminal on Network Configuration Web Page XPort AR User Guide Figure 7-1 shows the page that displays.

  • Page 56: Line Terminal Configuration

    Echo 3. Click Submit. Line Terminal Configuration To configure a line to support an attached terminal, perform the following steps. XPort AR User Guide Table 7-1. Description Enter text to describe the type of terminal. The text will be sent to a host via interpret as command (IAC).

  • Page 57: Figure 7-2 Terminal On Line 1 Configuration Web Page

    Table 7-2 Terminal on Line 1 Configuration Fields Field Terminal Type Login Connect Menu Exit Connect Menu XPort AR User Guide Figure 7-2 shows the page that displays. Table 7-2. Description Enter text to describe the type of terminal. The text will be sent to a host via interpret as command (IAC).

  • Page 58: Host Configuration

    You can configure a remote host by using the Host web page. To configure a remote host, perform the following steps. 1. Click Host > Host 1. XPort AR User Guide Description Enter a Send Break control character, e.g., <control> Y, or blank to disable.

  • Page 59: Table 7-3 Host Configuration Fields

    Users page), or leave it blank to be prompted for a username and password at connect time. Enter an IP address for the host to which the XPort AR will connect. Enter the port on the host to which the XPort AR will connect.

  • Page 60: 8: Configurable Pins Manager

    CP into a group. Default Groups The XPort AR 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 61: Change Cps

    Indicates the hardware pin number associated with the CP. Shows the current CP configuration. A CP configured as Input is set to read input. A CP configured as Output drives data out of the XPort AR. 8: Configurable Pins Manager...

  • Page 62: Table 8-2 Cpm Cps Status Fields And Descriptions

    CP. Description Shows the CP number. Shows the current enable state of the CP. On the XPort AR the CP state is always enabled. Indicates whether the CP is set for input or output.

  • Page 63: Cpm Groups

    Level Logic Binary Add Custom CP Groups To add a custom XPort AR CP group, perform the following steps. XPort AR User Guide Description Shows the CP Group name. Shows the current state of the CP group. Locked groups are Lantronix default groups and cannot be deleted.

  • Page 64: Figure 8-2 Cpm Groups Page

    Input or output.  Assertion level. Check the Assert Low box to specify inverted assertion.  XPort AR User Guide lists and describes the fields in the Current Configuration section Figure 8-2 CPM Groups Page Description Shows the CP group name.

  • Page 65: Remove Custom Cp Groups

    To remove a CP from a CP group, perform the following steps. 1. Click on the Group in the Group Name column that contains the CP to be removed. 2. Select the CP from the Remove drop-down list at the bottom of the page. 3. Click Remove. XPort AR User Guide...

  • Page 66: 9: Services Settings

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

  • Page 67: Ppp Configuration

    The Point-to-Point Protocol (PPP) establishes a direct connection between two nodes. It defines a method for data link connectivity between devices using physical layers (such as serial lines). The XPort AR supports two types of PPP authentication: Password Authentication Protocol (PAP) and Challenge Handshake Authentication Protocol (CHAP). Both of these authentication methods require the configuration of a username and password.

  • Page 68: Figure 9-2 Ppp Configuration Web Page

    (both of which are external devices). Use the XPort AR 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 AR acts as the server side of the PPP link;...

  • Page 69: Snmp Configuration

    To configure SNMP, perform the following steps. XPort AR User Guide Table 9-1. Description Enter the IP address assigned to the XPort AR’s PPP interface. Enter the IP address assigned to the peer (when requested during negotiation). Choose the authentication mode: None—No authentication is required.

  • Page 70: Figure 9-3 Snmp Web Page

    Write Community System Contact System Name System Description System Location Traps Enabled Primary Trap Dest IP XPort AR User Guide Figure 9-3 shows the page that displays. Figure 9-3 SNMP Web Page Table 9-2. Description Select On to enable SNMP.

  • Page 71: Ftp

    The FTP web page shows the FTP configuration and statistics about the FTP server. To configure FTP, perform the following steps. 1. Click FTP on the Main Menu. XPort AR User Guide Description Enter the secondary SNMP trap host. Figure 9-4 shows the page that displays.

  • Page 72: Tftp

    TFTP In the TFTP web page, you can configure the server, and view the status and statistics. To configure TFTP server, perform the following steps. 1. Click TFTP on the Main Menu. XPort AR User Guide Table 9-3. Description Select Enabled to enable the FTP server.

  • Page 73: Syslog

    Syslog, perform the following steps. Note: The Syslog file gets saved to lRAM and gets discarded when the XPort AR reboots. Saving the Syslog file to a server that supports remote logging services (see RFC 3164) allows the administrator to save the complete Syslog history. The default port is 514.

  • Page 74: Figure 9-6 Syslog Web Page

    Enter the IP address of the remote server to which system logs are sent for storage. Enter the number of the local port on the XPort AR from which system logs are sent. Enter the number of the port on the remote server that supports logging services.

  • Page 75: Http

    HTTP defines how messages get formatted and transmitted. It also defines the actions web servers and browsers should take in response to different commands. HTTP Authentication enables the requirement of usernames and passwords for access to the XPort AR device. The HTTP web page contains the following sub-menus: Statistics—Viewing statistics such as bytes received and transmitted, bad requests,...

  • Page 76: Http Configuration

    HTTP Configuration To configure HTTP, perform the following steps. 1. Click HTTP > Configuration. Figure 9-8 shows the page that displays. Figure 9-8 HTTP Configuration Web Page 2. Enter or modify the fields in Table 9-6. XPort AR User Guide...

  • Page 77: Table 9-6 Http Configuration Fields

    Logging Max Log Entries Log Format 3. Click Submit. XPort AR User Guide Description Select On to enable the HTTP server. Enter the port for the HTTP server to use. The default is 80. Enter the port for the HTTPS server to use. The default is 443. The HTTP server only listens on the HTTPS Port when an SSL certificate is configured.

  • Page 78: Http Authentication

    To configure HTTP authentication, perform the following steps. 1. Click HTTP > Authentication. 2. Enter or modify the fields in Table 9-7 HTTP Authentication Fields Fields Realm XPort AR User Guide Figure 9-9 shows the page that displays. Figure 9-9 HTTP Authentication Web Page Table 9-7. Description Enter the Uniform Resource Identifier (URI).

  • Page 79: Rss

    Web users. Instead of actively searching for XPort AR configuration changes, RSS enables viewing relevant and new information regarding changes made to the XPort AR via an RSS publisher. RSS can be stored to the file system cfg_log.txt file. To configure RSS, perform the following steps.

  • Page 80: Figure 9-10 Rss Web Page

    RSS Feed Persistent Max Entries Note: You can view and clear settings in the Current Status table by clicking [View] or [Clear]. XPort AR User Guide Figure 9-10 shows the page that displays. Figure 9-10 RSS Web Page Table 9-8.

  • Page 81: 10: Security Settings

    SSH keys may be created on another computer and uploaded to the XPort AR. For example, use the ssh-keygen -b 1024 -t dsa command to create a 1024-bit DSA key pair. SSH Keys from other programs may be converted to the required XPort AR format. Use Open SSH to perform the conversion.

  • Page 82: Figure 10-1 Ssh Server Host Keys Web Page

    2. Enter or modify the fields in Table 10-1 SSH Server Host Keys Fields Field Upload Keys Private Key Public Key Key Type XPort AR User Guide Figure 10-1 shows the page that displays. Figure 10-1 SSH Server Host Keys Web Page Table 10-1. Description Enter the path and name of the existing private key you want to upload or use the Browse button to select the key.

  • Page 83: Ssh Server Authorized Users

    You can change SSH server settings for Authorized Users which are accounts that enable access to the XPort AR. For example, these SSH accounts can be used to log into the CLI or open an SSH connection to a device port. Every account must have a password.

  • Page 84: Figure 10-2 Ssh Server Authorized Users Web Page

    Table 10-2 SSH Server Authorized Users Fields Field Username Password Public RSA Key Public DSA Key 3. Click Submit. XPort AR User Guide Figure 10-2 shows the page that displays. Table 10-2. Description Enter the name of the user authorized to access the SSH server.

  • Page 85: Ssh Client Known Hosts

    Figure 10-3 SSH Client Known Hosts Web Page 2. Enter or modify the fields in Table 10-3 SSH Client Known Hosts Fields Field Server Public RSA Key XPort AR User Guide Figure 10-3 shows the page that displays. Table 10-3. Description Enter the name or IP address of a known host.

  • Page 86: Ssh Client Users

    The keys for public key authentication can be created on another device and uploaded to the XPort AR or automatically generated on the XPort AR. If uploading existing keys, be sure the private key does not get compromised in transit. Upload the data over a secure private network. If you are uploading a key, ensure that it is not password protected.

  • Page 87: Figure 10-4 Ssh Client Users Web Page

    Table 10-4. Description Enter the name that the XPort AR uses to connect to a SSH server. Enter the password associated with the username. Enter the command that can be executed remotely. Default is shell, which tells the SSH server to execute a remote shell upon connection. This command can be changed to anything the remote host can perform.

  • Page 88: Ssl Cipher Suites

    Such a combination is called a cipher suite. lists the supported cipher suites. Table 10-5 Supported Cipher Suites Certificate XPort AR User Guide Description Select the key type to be used. Choices are:  RSA—Use this key with the SSH1 and SSH2 protocols.

  • Page 89: Ssl Certificates

    RSA-style certificate and key exchange methods that require a DSA-style certificate. If only one of these certificates is stored in the XPort AR, only those key exchange methods that can work with that style certificate are enabled. RSA is sufficient in most cases.

  • Page 90: Ssl Certificates And Private Keys

    -in sbr_certkey.sbrpvk -nodes -out sbr_certkey.pem The sbr_certkey.pem file contains both certificate and key. If loading the SBR certificate into XPort AR as an authority, you will need to edit it. Open the file in any plain text editor. Delete all info before the following: “----- BEGIN CERTIFICATE-----“...

  • Page 91: Ssl Configuration

    SBR changes the format it uses to store these strings and becomes incompatible with the current XPort AR 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 92: Table 10-6 Ssl Fields

    10-6. Description This certificate identifies the XPort AR 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 Browse button to select the certificate. RSA or DSA certificates with 512 to 1024 bit public keys are allowed.
  • Page 93 Table 10-6 SSL Fields (continued) Field Key Length Type XPort AR User Guide Description Select the bit size of the new self-signed certificate. Choices are:  512 bits 768 bits   1024 bits The larger the bit size, the longer it takes to generate the key. Approximate times are: ...

  • Page 94: 11: Maintenance And Diagnostics Settings

     Filesystem The XPort AR uses a flash filesystem to store files. You can view file diagnostics and/or modify files. There are two subsections: Statistics and Browse. The Statistics section of the Filesystem Statistics window shows current statistics and usage information of the flash file system.

  • Page 95: Filesystem Browser

    3. Back up all files before you perform Step 4, because all user files get erased in that step. 4. Cick Format in the Actions row. The configuration gets retained. Filesystem Browser To browse the filesystem, perform the following steps. XPort AR User Guide...

  • Page 96: Figure 11-2 Filesystem Browser Web Page

    11: Maintenance and Diagnostics Settings 1. Click Filesystem > Browse. Figure 11-2 shows the page that displays. Figure 11-2 Filesystem Browser Web Page 2. Click a filename to view the contents. XPort AR User Guide...

  • Page 97: Table 11-1 Filesystem Browser Fields

    Mode Local File Remote File Host Port XPort AR User Guide 11: Maintenance and Diagnostics Settings Table Description Enter the name of the file you want to create, and then click Create. Enter the name of the directory you want to create, and then click Create.

  • Page 98: Protocol Stack

    1. Click Protocol Stack on the Main Menu. TCP is the default. displays. 2. Enter or modify the fields in Table 11-2 TCP Fields Field Send RSTs XPort AR User Guide 11: Maintenance and Diagnostics Settings Figure 11-3 TCP Web Page Table 11-2. Description Click Enabled to send RSTs or Disabled to stop sending RSTs.

  • Page 99: Figure 11-4 Ip Web Page

    3. Click Submit. To change the IP settings, perform the following steps. 1. Click Protocol Stack > IP. XPort AR User Guide 11: Maintenance and Diagnostics Settings Description Enter a number to limit how many packets get received before an ACK gets forced.

  • Page 100: Icmp

    3. Click Submit. ICMP To set the ICMP, perform the following steps. 1. Click Protocol Stack > ICMP. Figure 11-5 shows the page that displays. Figure 11-5 ICMP Web Page 2. Click Enabled. 3. Click Submit. XPort AR User Guide...

  • Page 101: Arp

    IP Address MAC Address Current State [Remove All] 2. Click Submit for ARP or click Add for ARP Cache. XPort AR User Guide 11: Maintenance and Diagnostics Settings Figure 11-6 shows the page that displays. Figure 11-6 ARP Web Page 11-3.

  • Page 102: Ip Address Filter

    Note: Be aware not to assign your network IP address as “filtered.”Doing so will prevent you from accessing the XPort AR. You will have to then access the XPort AR from a different computer to reset the configuration. XPort AR User Guide...

  • Page 103: Query Port

    Only 0x77FE discover messages from DeviceInstaller are supported. For more information on DeviceInstaller, see 3: Using To configure the query port server, perform the following steps. 1. Click Query Port on the Main Menu. XPort AR User Guide 11: Maintenance and Diagnostics Settings Table 11-4. Description Enter the IP address to add to the IP filter table.

  • Page 104: Diagnostics

    2. Select On. Off is the default. 3. Click Submit. Diagnostics The XPort AR has several tools to perform diagnostics and view device statistics. These include information on: Hardware  MIB-II  IP Sockets  Ping  Traceroute  DNS Lookup ...

  • Page 105: Mib-Ii

    1. Click Diagnostics > Hardware. Figure 11-9 shows the page that displays. Figure 11-9 Diagnostics Hardware Web Page MIB-II The MIB-II Network Statistics page shows the available SNMP MIBs. To display MIB-II statistics, perform the following steps. XPort AR User Guide...

  • Page 106: Figure 11-10 Mib-Ii Network Statistics Web Page

    RFC 2011—Updated definitions for IP and ICMP.  RFC 2012—Updated definitions for TCP.  RFC 2013—Updated definitions for UDP.  RFC 2096—Definitions for IP forwarding.  XPort AR User Guide 11: Maintenance and Diagnostics Settings Figure 11-10 shows the page that displays.

  • Page 107: Ip Sockets

    To display all open IP sockets, perform the following steps. 1. Click Diagnostics > IP Sockets. Figure 11-11 shows the page that displays. Figure 11-11 IP Sockets Web Page Ping To ping a remote device or computer, perform the following steps. XPort AR User Guide...

  • Page 108: Figure 11-12 Ping Web Page

    Enter the number of ping packets XPort AR should attempt to send to the Host. The default is 3. Enter the time, in seconds, for the XPort AR to wait for a response from the host before timing out. The default is 5 seconds.

  • Page 109: Traceroute

    Traceroute You can trace a packet route from the XPort AR 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 110: Dns Lookup

    To use forward or reverse DNS lookup, perform the following steps. 1. Click Diagnostics < DNS Lookup. Figure 11-14 shows the page that displays. Figure 11-14 DNS Lookup Web Page 2. Enter or modify the fields in Table 11-7. XPort AR User Guide...

  • Page 111: Memory

    The Memory web page displays total and available memory in bytes, along with the number of fragments, allocated blocks, and memory status.To display memory statistics, perform the following steps. 1. Click Diagnostics > Memory. XPort AR User Guide 11: Maintenance and Diagnostics Settings Description Perform one of the following: ...

  • Page 112: Buffer Pools

    Process ID (PID), the percentage of total CPU cycles a process used within the last three seconds, the total stack space available, the maximum amount of stack space used by the process since it started, and the process name. To display the processes, perform the following steps. XPort AR User Guide...

  • Page 113: Figure 11-17 Processes Web Page

    11: Maintenance and Diagnostics Settings 1. Click Diagnostics > Processes. Figure 11-17 shows the page that displays. Figure 11-17 Processes Web Page XPort AR User Guide...

  • Page 114: System

    To configure system settings, perform the following steps. 1. Click System on the Main Menu. XPort AR User Guide 11: Maintenance and Diagnostics Settings Figure 11-18 shows the page that displays.

  • Page 115: Table 11-8 System Fields

    Click Reboot to reboot the system. The system refreshes and redirects the browser to the home page. Click Factory Defaults to restore the XPort AR to the original factory settings. All configurations will be lost. The XPort AR automatically reboots upon setting back to the defaults.

  • Page 116: 12: Advanced Settings

    SMTP server gets logged and displayed in the bottom portion of the page. To view the statistics, perform the following steps. 1. Click Email on the Main Menu. XPort AR User Guide Figure 12-1 shows the page that displays.

  • Page 117: Email Configuration

    2. Click the Log [Clear] link to clear the log. Email Configuration The XPort AR allows you to view and configure email alerts relating to the events occurring within the system. To configure email settings, perform the following steps. 1. Click Email > Email 1 > Configuration.

  • Page 118: Command Line Interface

     Number of bytes that have been sent and received  Kill link to terminate the connection  XPort AR User Guide Table 12-1. Description Enter the email address to which the email alerts will be sent. Multiple addresses are separated by semicolon (;).

  • Page 119: Cli Statistics

    To view the CLI Statistics, perform the following steps. 1. Click CLI on the Main Menu. Figure 12-3 shows the page that displays. Figure 12-3 CLI Statistics Web Page CLI Configuration To configure the CLI, perform the following steps. XPort AR User Guide...

  • Page 120: Figure 12-4 Cli Configuration Web Page

    Field Login Password Enable Level Password Quit connect line Inactivity Timeout Telnet State Telnet Port XPort AR User Guide Figure 12-4 shows the page that displays. Figure 12-4 CLI Configuration Web Page Table 12-2. Description Enter the password for Telnet access.

  • Page 121: Xml Configuration

    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 AR unit or another. The XML data can be exported to the browser window or to a file on the file system.

  • Page 122: Figure 12-5 Xml Export Configuration Web Page

    Figure 12-5 XML Export Configuration Web Page 2. Enter or modify the fields in Table 12-3 XML Export Configuration Fields Field Export to browser Export to local file XPort AR User Guide Figure 12-5 shows the page that displays. Table 12-3. Description Select this option to export the XCR data in the selected fields to a web browser.

  • Page 123: Xml Export Status

    Groups to Export 3. Click Export. The groups display if exporting to the browser. If exporting to the file system, the XPort AR will write the file to the file system and display a completion message. Note: Most browsers will interpret and display the XML data without the XML tags. To view the raw XML, choose the view file source feature of your browser.

  • Page 124: Figure 12-6 Xml Export Status Web Page

    Groups to Export 3. Click Export. The groups display if exporting to the browser. If exporting to the file system, the XPort AR will write the file to the file system and display a completion message. XPort AR User Guide Figure 12-6 shows the page that displays.

  • Page 125: Xml Import Configuration

    This selection shows a field for entering the path and file name of the entire external XCR file you want to import. You can also browse to select the XCR file. XPort AR User Guide Figure 12-7 shows the page that displays.

  • Page 126: Import Configuration From Filesystem

    This selection shows a page for entering the filesystem and your import requirements – groups, lines, and instances. To import a configuration file from the Filesystem, perform the following steps. XPort AR User Guide 12: Advanced Settings Figure 12-8 shows...

  • Page 127: Figure 12-9 Import Configuration From Filesystem Web Page

    12: Advanced Settings 1. Click XML > Import Configuration > Configuration from Filesystem. Figure 12-9 shows the page that displays. Figure 12-9 Import Configuration from Filesystem Web Page XPort AR User Guide...

  • Page 128: Import Line(S) From Single Line Settings On The Filesystem

    Table 12-5. Description Enter the name of the file on the XPort AR (local to its filesystem) that contains XCR data. Select the lines or network whose settings you want to import. Click the Select All link to select all the serial lines and the network lines. Click the Clear All link to clear all of the checkboxes.

  • Page 129: Figure 12-10 Import Lines From Single Line Settings On The Filesystem Web Page

    Table 12-6. Description Provide the name of the file on the XPort AR (local to its file system) that contains XCR data. Select the line(s) whose settings you want to import. Click the Select All link to select all the serial lines and the network lines. Click the Clear All link clear all of the checkboxes.
  • Page 130 Table 12-6 Import Lines from Single Line Settings Fields (continued) Field Whole Groups to Import 3. Click Import. XPort AR User Guide Description Select the configuration groups to import from the XML configuration record. Note: By default, all groups are checked except #those pertaining to the network configuration;...

  • Page 131: 13: Branding The Xport Ar

    13: Branding the XPort AR This chapter describes how to brand your XPort AR by using Web Manager and Command Line Interface (CLI). It contains the following sections: Web Manager Customization  Short and Long Name Customization  Web Manager Customization Customize the Web Manager appearance by modifying index.html and style.css.

  • Page 132: Figure 13-1 System Branding Web Page

    13: Branding the XPort AR 1. Click System in the menu bar. Figure 13-1 shows the page that displays. Figure 13-1 System Branding Web Page 2. In the Short Name field, enter a short name up to 32 characters. 3. In the Long Name field, enter a long name up to 64 characters.

  • Page 133: 14: Updating Firmware

    4. Click Upload to install the firmware. The device automatically reboots on the installation of new firmware. Alternatively, firmware can be updated by sending the file to the XPort AR over a FTP or TFTP connection. XPort AR User Guide Figure 14-1 shows the page that displays.

  • Page 134: A: Technical Support

    Status of the unit when the problem occurred (please try to include information on user and  network activity at the time of the problem) Additionally, it may be useful to export and submit the XML Configuration and XML Status files  XPort AR User Guide...

  • Page 135: B: Binary To Hexadecimal Conversions

    (for 11), etc. To convert a binary value (for example, 0100 1100) to a hexadecimal representation, treat the upper and lower four bits separately to produce a two-digit hexadecimal number (in this case, 4C). Use the following table to convert values from binary to hexadecimal. XPort AR User Guide Table B-1 Conversion Values Decimal Binary...

  • Page 136: Scientific Calculator

    2. On the View menu, select Scientific. The scientific calculator appears. 3. Click Bin (Binary) and type the number you want to convert. 4. Click Hex. The hexadecimal value appears. XPort AR User Guide B: Binary to Hexadecimal Conversions Table B-1 Conversion Values (continued)

  • Page 137: C: Compliance

    Manufacturer Name & Address Lantronix, Inc., 167 Technology, Irvine, CA 92618 USA Product Name Model XPort AR Embedded Device Server Conforms to the following standards or other normative documents: Radiated and conducted emissions CFR Title 47 FCC Part 15, Subpart B and C Industry Canada ICES-003 Issue 4 2004 VCCI V-3/2007.04...

  • Page 138: Rohs Notice

    RoHS Notice All Lantronix products in the following families are China RoHS-compliant and free of the following hazardous substances and elements: Lead (Pb)  Mercury (Hg)  Cadmium (Cd)  Hexavalent Chromium (Cr (VI))  Polybrominated biphenyls (PBB)  Polybrominated diphenyl ethers (PBDE) ...
  • Page 139 Manufacturer Contact Lantronix Inc. 167 Technology, Irvine, CA 92618 USA Phone: 949-453-3990 Fax: 949-450-7249 XPort AR User Guide C: Compliance...

  • Page 140: Index

    RoHS notice ... 138 default server port numbers 19 device control 17 device details summary 21 device management 18 deviceinstaller accessing the XPort AR ... 21 device details summary ... 21 XPort AR User Guide using ...21 diagnostic toolset 18 email configuration 117...
  • Page 141 17 snmp management 17 terminal server/device management 18 troubleshooting capabilities 18 web-based configuration and troubleshooting xml-based architecture and device control 17 XPort AR User Guide port numbers 19 rss 17 secure com port redirector 18 security enterprise-grade ...17 security settings SSH client known hosts ...85...
  • Page 142 ... 23 components of typical web page ... 25 configuration ... 23 navigating ... 26 navigation ... 26 summary of web pages ... 26 web-based configuration 16 xml 18 xml configuration 121 XPort AR User Guide Index...

Table of Contents