ConnectPort® LTS User’s Guide ConnectPort LTS 8, ConnectPort LTS 8 MEI, ConnectPort LTS 8 W, ConnectPort LTS 8 MEI W, ConnectPort LTS 16, ConnectPort LTS 16 MEI, ConnectPort LTS 16 W, ConnectPort LTS 16 MEI W, ConnectPort LTS 16 MEI 2AC ConnectPort LTS 32, ConnectPort LTS 32 MEI, ConnectPort LTS 32 W, ConnectPort LTS 32 MEI W 90001001_C
© Digi International Inc.2012. All Rights Reserved. Digi, Digi International, the Digi logo, ConnectPort, XBee, and RealPort are trademarks or registered trademarks of Digi International, Inc. in the United States and other countries worldwide. All other trademarks are the property of their respective owners. Information in this document is subject to change without notice and does not represent a commitment on the part of Digi International.
Contents Contents............................................................................................................................................... 3 1. About this guide .......................................................................................................................... 7 Purpose ........................................................................................................................................ 7 Audience ...............................................
The Web interface .............................................................................................................. 33 Command-line interface..................................................................................................... 34 Simple Network Management Protocol (SNMP) .............................................................. 35 LCD panel ..........................................................................................................................
Monitoring capabilities from the command line ..................................................................... 117 Commands for displaying device information and statistics ........................................... 117 Commands for managing connections and sessions ........................................................ 120 Monitoring Capabilities from SNMP ...................................................................................... 121 5 Administration tasks .............................
5.10 Ignition of Flammable Atmospheres ................................................................... 147 Potentially Hazardous Atmospheres ................................................................................ 147 Safety in Aircraft .............................................................................................................. 147 Safety in Hospitals ........................................................................................................... 147 Pacemakers .....
1. About this guide Purpose This guide describes and shows how to configure, monitor, and administer ConnectPort LTS products. Audience This guide is intended for those responsible for setting up ConnectPort LTS products. It assumes some familiarity with networking concepts and protocols. Scope This guide focuses on configuration, monitoring, and administration of ConnectPort LTS products. It does not cover hardware details beyond a certain level, application development, or customization.
Additional product information on www.digi.com In addition to the previous documents, product information is available on the Digi website, www.digi.com, including: Support Forums Knowledge Base Data sheets/product briefs Application/solution guides Digi contact information For more information about Digi products, or for customer service and technical support, contact Digi International.
2. Introduction This chapter introduces ConnectPort LTS products, types of supported connections and data paths, and the interface options available for configuration, monitoring, and administration tasks. Important Safety Information To avoid contact with electrical current: Never install electrical wiring during an electrical storm. Never install an Ethernet connection in wet locations unless that connector is specifically designed for wet locations.
The ConnectPort LTS Family ConnectPort LTS (Linux Terminal Server) products provide serial over Ethernet connectivity for applications today and into the future. They support IPv4 and IPv6 Ethernet protocols. The ConnectPort LTS MEI product is the same size as the ConnectPort LTS (RS-232 only version) and is the fastest multi-port device with a Multiple Electrical Interface (MEI) in the industry. Features This is an overview of key product features.
Quick reference for configuring features This guide primarily focuses on configuration, monitoring, and administration tasks from the web interface. This table provides a quick reference for configuring features and performing device tasks, and where to find the features and settings in the web interface and this guide. Some features are configurable from the command line interface only. In those cases, the commands that configure the feature are noted.
Feature/task Help on configuring features Host name for a device Path to feature in the web interface Help button on each page.
Python support: loading and running Configurable from command line only. See the set python custom programs authored in the Python command in the Connect Family Command Reference. programming language. RealPort (COM port redirection) configuration Reverting configuration settings Security/access control features: Control access to inbound ports Configuration > Serial Ports > port > Port Profile Settings > RealPort See also the RealPort Installation Guide.
Simple Network Management Protocol (SNMP): Configure SNMP through the web interface Configuration > System > Simple Network Enable/disable SNMP service Network > Network Service Settings -> Basic Network Management Protocol (SNMP) Settings Services Settings Enable/disable SNMP alarm traps Configuration > Alarms > alarm > Send SNMP trap to following destination when alarm occurs Use SNMP as primary configuration interface Basic network and serial settings configurable through standard and Digi-specif
Hardware and network interface features For detailed hardware specifications and network interface information, go to: http://www.digi.com/products/serialservers/connectportlts#specs. See also the data sheet for your Digi product. Configurable network services Access to network services can be enabled and disabled. This means that a device’s use of network services can be restricted to those strictly needed by the device. To improve device security, non-secure services, such as Telnet, can be disabled.
IP protocol support All ConnectPort LTS products include a robust on-board TCP/IP stack with a built-in web server. Supported protocols include, unless otherwise noted: Transmission Control Protocol (TCP) User Datagram Protocol (UDP) Dynamic Host Configuration Protocol (DHCP) Simple Network Management Protocol (SNMP) Secure Sockets Layer (SSL)/Transport Layer Security (TLS) Telnet Com Port Control Option (Telnet).
Following is an overview of some of the services provided by these protocols. Serial data communication over TCP and UDP ConnectPort LTS products support serial data communication over TCP and UDP. Key features include: Serial data communication over TCP, also known as autoconnect and tcpserial can automatically perform the following functions: – Establish bidirectional TCP connections, known as autoconnections, between the serial device and a server or other network device.
Auto-IP Auto-IP is a protocol that will automatically assign an IP address from a reserved pool of standard Auto-IP addresses to the computer on which it is installed. ConnectPort LTS is set to obtain its IP address automatically from a DHCP server. But if the DHCP server is unavailable or nonexistent, Auto-IP will assign the device an IP address. For further details, see "IP address assignment alternatives.
Secure Sockets Layer (SSL)/Transport Layer Security (TLS) Secure Sockets Layer (SSL)/Transport Layer Security (TLS) are used to provide authentication and encryption for ConnectPort LTS products. For more information, see ‖Security features.
Point-to-Point Protocol (PPP) The Point-to-Point Protocol (PPP) transports multi-protocol packets over point-to-point links. PPP encapsulates the data packet, allows the server to inform the dial-up client of its IP address (or client to request the IP address), authenticates the exchange, negotiates multiple protocols, and reassembles the data packet for network communication.
IP address assignment alternatives There are several ways to assign an IP address to a ConnectPort LTS product: Static IP: Assign a specific IP address to a device, through the Digi Device Discovery Utility, the web interface, LCD, Digi Device Discovery tool, or the command-line interface. Using Dynamic Host Configuration Protocol (DHCP). Dynamic Host Configuration Protocol (DHCP) is an Internet protocol for automating the configuration of computers that use TCP/IP.
RealPort software ConnectPort LTS products use the patented RealPort COM/TTY port redirection for Microsoft Windows, UNIX, and Linux environments. RealPort software provides a virtual connection to serial devices, no matter where they reside on the network. The software is installed directly on the host PC and allows applications to talk to devices across a network as though the devices were directly attached to the host. Actually, the devices are connected to a Digi device somewhere on the network.
Alarms ConnectPort LTS products can be configured to issue alarms, in the form of email message or SNMP traps, when certain device events occur. These events include certain data patterns being detected in the data stream. Receiving alarms about these conditions provides the advantage of notifications being issued when events occur, rather than having to monitor the device on an ongoing basis to determine whether these events have occurred. For more information on configuring alarms, see "Alarms.
Security features Security-related features in ConnectPort LTS products include: Secure access and authentication: – One password, one permission level. – Can issue passwords to device users. – Can selectively enable and disable network services such as ADDP, RealPort, Encrypted RealPort, HTTP/HTTPS, LPD, Remote Login, Remote Shell, SNMP, Telnet and Secure Shell (SSH). – Can control access to inbound ports. – Secure sites for configuration: HTML pages for configuration have appropriate security.
Configuration management Once a ConnectPort LTS product is configured and running, configuration-management tasks need to be periodically performed, such as: Upgrading firmware Copying configurations to and from a remote host Software and factory resets Rebooting the device Memory management File management For more information on these configuration-management tasks, see Chapter 4, "Administration tasks.
Supported connections and data paths ConnectPort LTS products allow for several kinds of connections and paths for data flow between the ConnectPort LTS product and other entities. These connections can be grouped into two main categories: Network services, in which a remote entity initiates a connection to a ConnectPort LTS product. Network/serial clients, in which a ConnectPort LTS product initiates a network connection or opens a serial port for communication.
Reverse SSH: An SSH connection is made to a ConnectPort LTS product, in which data is passed transparently between the SSH connection and a named serial port. Network services associated with serial ports in general RealPort: A single TCP connection manages (potentially) multiple serial ports. Modem emulation, also known as pseudo-modem (pool): A TCP connection to the ―pool‖ port is interpreted as an incoming call to an available pseudo-modem in the ―pool‖ of available port numbers.
Network/serial clients A network/serial client connection is one in which a ConnectPort LTS product initiates a network connection or opens a serial port for communication.
Command-line interface (CLI)-based client connections Command-line interface based client connections are available for use once a user has established a session with the ConnectPort LTS product CLI. CLI-based client connections include: telnet: A connection is made to a remote entity using the Telnet protocol. bash: The ―bash‖ command provides access to the Linux bash shell. rlogin: A connection is made to a remote entity using the Rlogin protocol.
Configuration capabilities and interfaces This is an overview of the configuration capabilities and interfaces for ConnectPort LTS products; Chapter 2, "Configuration," covers them in more detail. Configuration capabilities Device configuration involves setting values and enabling features for such areas as: Network configuration: Specifying the device IP address and IP settings, network-service settings, and advanced network settings.
Digi Device Discovery utility The Digi Device Discovery utility locates Digi devices on a network and allows for opening the web interface for discovered devices, configuring network settings, and rebooting the device.
Advantages of the Digi Device Discovery utility are: It quickly locates Digi devices and basic device information, such as the device address, firmware revision, and whether it has been configured. ADDP runs on any operating system that can send multicast IP packets to a network. It sends out a User Datagram Protocol (UDP) multicast packet to all devices on the network. Devices supporting ADDP reply to this UDP multicast with their configuration information.
The Web interface A web interface is provided as an easy way to configure and monitor ConnectPort LTS products. Configurable features are grouped into several categories. These categories vary by product; examples include Network, Serial Port, Alarms, System, and Users. Most of the configurable features are arranged by most basic settings on a page, with associated and advanced settings accessible from that page.
Command-line interface ConnectPort LTS products can be configured by issuing commands from the command line. The command-line interface allows communication directly without a graphical interface. For example, the following is a command issued from the command line to set general serial configuration options: #> set serial port=1-32 baudrate=9600 flowcontrol=hardware Advantages of the command-line interface include: Flexibility.
Simple Network Management Protocol (SNMP) Simple Network Management Protocol (SNMP) is a protocol for managing and monitoring network devices. The SNMP architecture enables a network administrator to manage nodes--servers, workstations, routers, switches, hubs, etc.--on an IP network; manage network performance, find and solve network problems, and plan for network growth. ConnectPort LTS supports SNMP Versions 1, 2 and 3. Advantages of SNMP include: SNMP is easy to implement in extensive networks.
Standard MIBs supported The standard MIBs supported in ConnectPort LTS products are: MIB-II (RFC 1213) This is a MIB for managing a TCP/IP network. It is an update of the original MIB, now called MIB-I. MIB-II contains variable definitions that describe the most basic information needed to manage a TCP/IP network.
Monitoring capabilities and interfaces There are several capabilities and interfaces for monitoring ConnectPort LTS products and managing their connections; these are covered in more detail in Chapter 3, "Monitor and manage Digi devices.‖ Monitoring ConnectPort LTS products includes such tasks as checking device status, viewing information on a device, checking runtime state, viewing serial port operations, and reviewing network statistics, and managing their connections.
LCD panel The LCD panel can be used to perform several monitoring tasks. For more information, see LCD interface: configuration, monitoring, and diagnostics’ on page 131.
3. Configuration This chapter describes how to configure a ConnectPort LTS product. It covers these topics: "Alternate methods for assigning an IP address". "Configuration through the web interface". "Configuration through the command line". "Configuration through Simple Network Management Protocol (SNMP)". "Batch capabilities for configuring multiple devices". The primary focus of this chapter is on configuring ConnectPort LTS products through the web interface.
Configure an IP address from the command-line interface The set network command configures an IP address from the command line. Include the following parameters: index=(1-4) : Ethernet interface index number ip_v4=device ip: The IP v4 address for the device. gateway_v4=gateway: The network gateway IP v4 address. submask_v4=device submask: The device subnet mask for IP v4 address. mode_v4=(none|static|dhcp): The configuration mode of IP v4 address.
Configuration through the web interface Configuring ConnectPort LTS products through the web interface involves these tasks: Change the IP address, as needed Open the web interface Configure network communications Configure the serial ports Configure alarms.
By using the Digi Device Discovery utility Alternatively, use the Digi Device Discovery Utility to locate the ConnectPort LTS product and open its web interface. Install Digi Device Discovery utility The Digi Device Discovery Utility is available on the Software and Documentation CD. If this utility is not already available on your computer, follow these steps. 1. On the main page Software and Documentation CD, click software - install optional software. 2. Select Device Discovery Utility and click Install.
Discover devices 1. From the start menu, select Start > Programs > Digi Connect > Digi Device Discovery. The Digi Device Discovery application is displayed. 2. Locate the device in the list of devices, and double-click it, or select the Digi device from the list and select Open web interface in the Device Tasks list. 3. Depending on whether a system administrator has configured password authentication for the device, a login may be required.
For ConnectPort LTS models with multiple power supplies, such as the ConnectPort LTS 16 MEI 2AC, the Home page displays a power failure message above the menu if either of the power supplies is unplugged. For example: Now configure the ConnectPort LTS product, as described on the following pages.
Organization of the web interface When web interface is opened, the Home page is displayed. Here is the home page for the ConnectPort LTS: The Home page The left side of the Home page has a menu of choices that display pages for configuration, management, and administration tasks, and to log out of the web interface. This chapter focuses on the choices under Configuration and Application.
Home page display differences for multiple-power-supply models For ConnectPort LTS models with multiple power supplies, such as the ConnectPort LTS 16 MEI 2AC, the Home page displays a power failure message above the menu if either of the power supplies is unplugged.
Configuration pages The choices under Configuration in the menu display pages for configuring settings for various features, such as network settings, and serial port settings. Some of the configuration settings are organized on sets of linked screens. For example, the Network Configuration screen initially displays the IP Settings, and provides links to Network Services Settings, Advanced Settings, and other network settings appropriate to the ConnectPort LTS product.
Restore the ConnectPort LTS product to factory defaults The device configuration can be reset to factory defaults as needed during the configuration process. See "Restore a device configuration to factory defaults.‖ Online help Online help is available for all screens of the web interface, and for common configuration and administration tasks. There is also tutorial available on the Home page.
Change the IP address from the web interface, as needed Normally, IP addresses are assigned to ConnectPort LTS products through DHCP. This procedure assumes that the ConnectPort LTS product already has an IP address and you simply want to change it. 1. Open a web browser and enter the current IP address for the ConnectPort LTS product in the URL address bar. 2. If security is enabled for the ConnectPort LTS product, a login prompt is displayed. Enter the user name and password for the device.
Network configuration settings The Network configuration pages include: Ethernet IP settings: For viewing IP address settings and changing as needed. Network Services settings: Enable and disables access to various network services, such as ADDP, RealPort and Encrypted RealPort, Telnet, SSH, HTTP/HTTPS, and other services. Advanced Network Settings: Configures the Ethernet Interface speed and mode, TCP/IP settings, TCP keep-alive settings, and DHCP settings.
Ethernet IP settings The Ethernet IP settings configure how the IP address of the ConnectPort LTS product is obtained, either by DHCP or by using a static IP address, subnet mask, default gateway. In addition, this page shows IP addresses of the primary and secondary Domain Name System (DNS) server for the ConnectPort LTS product. For more information about these settings as assigned and used in your organization, contact your network administrator.
IPv6: Internet Protocol version 6 configuration. Do not use this interface: Choose this option if you do not want to enable IPv6 address on this Ethernet interface. Auto configuration: Choose this option if you want to set IPv6 address through the stateless autoconfiguration protocol. Obtain an IP address automatically using DHCP: Choose this option if you want to set IPv6 address through DHCPv6. Use the following IP address: Choose this option to manually enter static IPv6 address settings.
Basic Network Services Settings The Basic Network Services page shows a set of common network services that are available for ConnectPort LTS products, and the network port on which the service is running. Common network services can be enabled and disabled, and the TCP port on which the network service listens can be configured. Disabling services may be done for security purposes. That is, certain services can be disabled so the device runs only those services specifically needed.
Supported basic network services and their default network port numbers In Digi devices that have multiple serial ports, the network port number defaults for various services are set based on the following formula: base network port number + serial port number The default base assumed is 2000. For example, the Telnet Passthrough service is set to network port 2001 for serial port 1, 2002 for serial port 2, 2003 for serial port 3, etc.
The table shows network services, services provided, and the default network port number for each service. Service Services provided Default network port number Device Discovery, also known as Advanced Digi Discovery Protocol (ADDP) Discovery of Digi devices on a network. Disabling this service disables use of the Digi Device Discovery utility to locate the device. The network port number for ADDP cannot be changed from its default.
Service Services provided Default network port number Telnet Server Allows users an interactive Telnet session to the ConnectPort LTS product command-line interface. If disabled, users cannot Telnet to the device. 23 Telnet Passthrough Allows a Telnet connection directly to the serial port, often referred to as reverse Telnet. 2001 Transmission Control Protocol (TCP) Echo Used for testing the ability to send and receive over a TCP connection, similar to a ping.
Advanced Network Services Settings The Advanced Network Services page shows a set of specific network services that are available for ConnectPort LTS products, and the related settings for the service. Web Settings: Login timeout: Idle timeout settings for Web server. SMTP Settings: Enable: Enable or disable the SMTP server SMTP server name: IP address or DNS name of the SMTP server. SMTP with authentication: Choose this option if your SMTP server can be accessed after authentication.
Samba Settings : Enable: Enable or disable the Samba service. Samba server name: IP address or DNS name of the Samba server. Mounting on path Samba server: Full path name of mounting point on the Samba server. Samba timeout: Interval in seconds before disconnecting Samba connection when the Samba server is not responding. Samba mount retrying interval: Interval in seconds when Samba remounting is tried after disconnecting the Samba connection.
Socket tunnel settings A Socket Tunnel can be used to connect two network devices: one on the ConnectPort LTS product’s local network and the other on the remote network. This is especially useful for providing SSL data protection when the local devices do not support the SSL protocol. One of the endpoint devices is configured to initiate the socket tunnel. The tunnel is initiated when that device opens a TCP socket to the ConnectPort LTS product on the configured port number.
Advanced network settings The Advanced Network Settings are used to further define the network interface, including: Host name: The Host name to be placed in the DHCP Option 12 field. This is an optional setting which is only used when DHCP is enabled. Enable Auto IP address assignment: Whether Auto-IP address assignment is enabled or disabled.
Serial port settings Use the Serial Port Configuration page to establish a port profile for the serial port of the ConnectPort LTS product. This page includes the currently selected port profile for the serial port, detailed configuration settings for the serial port, dependent on the port profile selected, and links to Basic Serial Settings and Advanced Serial Settings.
RealPort profile The RealPort profile maps a COM or TTY port to a serial port. This profile configures a ConnectPort LTS product to create a virtual COM port on a PC, known as COM Port Redirection. The PC applications send data to this virtual COM port and RealPort sends the data across the network to the ConnectPort LTS product. Data is routed to the serial device connected to the ConnectPort LTS product serial port. The network is transparent to both the application and the serial device.
TCP Sockets profile The TCP Sockets profile allows serial devices to communicate over a TCP network. The TCP Server allows other network devices to initiate a TCP connection to the serial device attached to the serial port of the ConnectPort LTS product. Automatic TCP connections (autoconnection) The TCP Client allows the ConnectPort LTS product to automatically establish a TCP connection to an application or a network, known as autoconnection.
UDP Sockets profile The UDP Sockets profile allows serial devices to communicate using UDP. The UDP Server configuration allows the serial port to receive data from one or more systems or devices on the network. The UDP Client configuration allows the automatic distribution of serial data from one host to many devices at the same time using UDP sockets. The port numbering conventions shown in the TCP Sockets Profile also apply to UDP sockets.
Modem Emulation profile The Modem Emulation profile allows a Digi device to send and receive modem responses to the serial device over the Ethernet instead of PSTN (Public Switched Telephone Network). This profile allows maintaining the current software application but using it over a less-expensive Ethernet network. The commands that can be issued in a modem-emulation configuration are described in the ConnectPort LTS Command Reference.
Local Configuration profile The Local Configuration profile allows access to the command-line interface when connecting from a serial terminal. Custom Profile The Custom port profile displays all serial-port settings, which can be changed as needed. Use the Custom profile only if the use of the serial port does not fit into any of the predefined port profiles, for example, if network connections involve a mix of TCP and UDP sockets.
Basic serial settings After selecting a port profile, the profile settings are displayed. Choose the appropriate features for your environment. Here are brief descriptions of the fields in the Basic Serial Settings; see the online help for detailed information about each setting. The Description field specifies an optional character string for the port which can be used to identify the device connected to the port.
Advanced serial settings The advanced serial settings further define the serial interface, including whether port buffering (also known as port logging), or RTS Toggle are enabled, as general serial interface options. You can also define how specific aspects of TCP and UDP serial communications should operate, including timeouts and whether a socket ID is sent.
TCP settings The TCP Settings are displayed only when the current serial port is configured with the TCP Sockets or the Custom Profile. The settings are as follows: Send Socket ID: Include an optional identifier string with the data sent over the network. The Socket ID can be 1 to 256 ASCII characters.
Send after the following number of idle: Send the data after the specified number of milliseconds has passed with no additional data received on the serial port. This can be 1 to 65,535 milliseconds. Send after the following number of bytes: Send the data after the specified number of bytes has been received on the serial port. This can be 1 to 65,535 bytes. Close connection after the following number of idle seconds: Enable to close an idle connection.
Authentication Settings The authentication settings set the authentication method and related settings. The ConnectPort LTS supports following authentication methods. None: When selected, user can access the serial port without authentication. This is the factory default setting. Local: When selected, the user who registered the local database of ConnectPort LTS through user configuration can only access the serial port.
For Radius authentication, the following settings are required. Primary authentication server: The IP address or DNS name of authentication server. This option is compulsory to use the remote authentication method. If this server is down or busy, the authentication query is sent to the secondary server, if specified. Secondary authentication server: The IP address or DNS name of the secondary authentication server. This option is complementary.
LDAP: When selected, user who registered the database of LDAP server specified can only access the serial port. There are several categories of LDAP authentication Methods: LDAP server: The user authentication performed only through the LDAP server. LDAP server - Local: The user authentication performed through the LDAP server first. If succeeded, user can access the serial port. If failed, user authentication performed through local database of ConnectPort LTS again.
Port group settings As a convenience feature, port groups can be created to send data to multiple ports. Instead of sending data to individual serial ports, data can be sent to all ports in a group simultaneously through a port in a group. If you select an additional option, you can also see the data from multiple ports in the same group from a terminal connected to the one of serial ports in the group.
Alarms Use the Alarms page to configure device alarms or display current alarms settings. Device alarms are used to send email messages or SNMP traps when certain device events occur. These events include and certain data patterns being detected in the data stream. Alarm notification settings On the Alarms page, the Alarm Notification Settings control the following: Enable alarm notifications: Enables or disables all alarm processing for the Digi Connect device.
Alarm conditions To configure an alarm, click on it. The configuration page for individual alarms has two sections: Alarm Conditions: For specifying the conditions on which the alarm is based, such as serial data pattern matching or data usage. Alarm Destinations: For specifying how the alarm is sent, either as an email message or an SNMP trap, or both, and where the alarm is sent. Alarm conditions The Alarm Conditions part of the page is for specifying the conditions on which the alarm is based.
Enable and Disable Alarms Once alarm conditions are configured, enable and disable individual alarms by selecting or deselecting the Enable checkbox for each alarm. System settings The System Configuration page configures system settings, including device description information, such as the device name, contact, and location, and whether SNMP is enabled or disabled and the SNMP traps that are enabled.
SNMP configuration settings Simple Network Management Protocol (SNMP) is a protocol that can be used to manage and monitor network devices. ConnectPort LTS products can be configured to use SNMP features, or SNMP can be disabled entirely for security reasons. To configure SNMP settings, click the Simple Network Management Protocol link at the middle of the System Configuration page.
Enable Simple Network Management Protocol (SNMP) traps: Enables or disables the generation of SNMP traps. Trap version: SNMP version for the trap Trap primary IP: The primary IP address of the system to which traps are sent. In order to enable any of the traps, a non-zero value must be specified. For ConnectPort LTS products that support alarms, this field is required in order for alarms to be sent in the form of SNMP traps. See "Alarms.
Date and Time Settings System Date and Time can be changed on this configuration page. Authentication Settings The authentication settings for system set the authentication method and related settings of Web UI and CLI access. CLI access includes CLI access through serial console, telnet, SSH, Rlogin and Rsh. Remote authentication will use the permissions set to the default "ruser" user.
User settings User settings involve several areas: User authentication: whether authentication is required for users accessing the ConnectPort LTS product, and the information required to access it. Depending on the Digi product, multiple users and their authentication information can be defined. User authentication settings are on the Users settings page. User access settings: the device interfaces that a user can access, such as the command line or web interface.
Password authentication By default, Digi Connect Family devices have password authentication enabled. That means when a login prompt is displayed when accessing the device by opening the web interface or issuing a telnet command. Disable password authentication In ConnectPort LTS, all users should have a password and password authentication cannot be disabled. Change the password for administrative user To increase security, change the password for the administrative user from its default.
Add users Digi Connect Family products allow multiple users to be defined. For those products, the Users Configuration page shows the currently defined users and allows you to add more user definitions. To add a user definition: 1. On the Main menu, click Users. 2. On the Users Configuration page, click New. 3. On the Add New Users page, specify the user name and password to be used for login. The password can be from 4 through 16 characters long and is case-sensitive. Confirm the password, and click Apply.
User permissions settings The User Permissions page is used to define whether and how users can use services and configuration settings for the ConnectPort LTS product. For example, you can disable a user’s access to certain parts of the web interface, or allow them to display settings only but not change them. The list of services and the user permissions available for them vary by ConnectPort LTS product and the features supported in the product.
User permissions and effects Permission Setting Effect None The user does not have permission to execute this setting. Read Self The user can display his/her own settings, but not those of other users. Read The user can read the settings for all users, but does not have permission to modify or write the settings. Read/Write Self The user can read and write his/her own settings, but not those of other users.
Peripheral SD Memory The ConnectPort LTS supports standard SD and SDHC (high-capacity) memory cards. To use an SD memory device, insert the card to the SD slot and then select Start service on SD Memory configuration page. Once the SD memory card service is started, you can see the card information such as Card Type, File system, used size and available size. And you can also format the card using the Format button on the SD Memory configuration page.
Modem ConnectPort LTS W has an internal modem that is configured it on this page. The Modem configuration page has the same configuration settings of Modem Profile of Serial port settings and it allows you to establish or receive connections from other systems and internal modems. Modem configuration page allow you to use the following type of connection Incoming Connection: Used for dial-in connections, such as inbound PPP connections or to manage a device through a telephone network.
LCD ConnectPort LTS has an LCD display and you can configure it on this page. The LCD configuration page has Enable display: If checked, LCD display is enabled and you can use LCD menu using keypad. Background image wait time: Specifies how much user idle time must elapse before the background image is launched on the LCD display. Default is 0 means the background image will not be launched automatically.
XBee The XBee configuration page has very similar settings to the Custom serial port profile. Once Allow direct access from networks is checked, you can access the XBee port in the same manner that is used to access a serial port in custom profile. The default setting for Allow direct access from networks is Disabled. For detailed information about XBee RF modules and commands for configuring them, please refer to the Product Manual: XBee / XBee-PRO ZB OEM RF Modules.
Applications Additional configurable applications are accessed from the main menu under Applications. Some devices have an Applications link under Configuration. Python® program management Digi incorporates a Python development environment into ConnectPort LTS products. Python is a dynamic, object-oriented language that can be used for developing a wide range of software applications, from simple programs to more complex embedded applications.
Digi Developer Community Wiki: The Digi Developer Community Wiki is a place to learn about developing solutions using Digi’s software and services, including Python, iDigi Platform, iDigi Dia, and more. http://www.digi.com/wiki/developer/index.php/Main_Page Digi Python Custom Development Environment page Python functions can be used to obtain data from attached and integrated sensors on Digi products that have embedded XBee RF modules, such as the Drop-in Networking Accessories.
Auto-start settings The Auto-start Settings page configures Python programs to execute when the ConnectPort LTS product boots. Up to four auto-start programs can be configured. Enable: When checked, the program specified in the Auto-start command line field will be run when the device boots. Auto-start command line: Specify the Python program filename to be executed and any arguments to pass to the program. The syntax is as follows, where arg1 and arg2 are program arguments: filename [arg1 arg2...
PPP configuration PPP (Point-to-point Protocol) provides TCP/IP communication over a modem connected to a serial port on your ConnectPort LTS server. PPP allows you to connect a device to a network using a telephone line and that device has access to the resources of the network as if it were directly connected to the network. Basic PPP settings Under Basic PPP settings, users can set the PPP (Point-to-Point Protocol) options to enable or disable the dynamic IP address pool.
Authentication configuration - User Name: Specifies the username for this connection. The username, along with the password, are specified by the user when connecting to the device. This username must be unique to the device so that no other incoming PPP connection, outgoing PPP connection, or system user uses it. - Password/Confirm Password: Specifies the password for this connection. This is the password that the user specifies when connecting and logging into the device.
Peer configuration: Specifies how the remote IP address that is supplied to the client is assigned. - Automatically Assign Remote IP Address from IP Address Pool: The remote IP address will automatically be assigned with a unique address from the IP address pool (as configured in Basic PPP Settings; see page 93). The assigned address will not conflict with any other PPP connection using the dynamic IP address pool. - Note: This option requires the Dynamic IP Address Pool to be enabled.
Setting up incoming PPP connections To configure the correct settings for incoming PPP connections, you need to configure settings on Application -> PPP first and then configure settings on Configuration -> Serial Ports. Settings on Application -> PPP Basic PPP Settings: To assign an IP address for incoming PPP client automatically, check Enable Dynamic IP Address Pool for Incoming Connections and enter First IP Address and Number of Addresses.
5. In the Peer Configuration section, select an option for assigning the IP address of incoming PPP client. Automatically assign remote IP address from IP address pool: If you select this option, IP address for incoming PPP client will be automatically assigned from the IP address pool set on Basic PPP Settings page Allow remote peer to specify remote IP address: If you select this option, incoming PPP client will specify the IP address used for this PPP connection.
Settings on Serial ports 1. Select a port from Configuration -> Serial ports -> Ports Settings 2. Change the port profile to modem 3. In the Port Profile Settings -> Modem Settings section, Check Incoming Connections. 4. Check Enable PPP connections on this modem. 5. Set configurations on Basic serial settings and Advanced Serial Settings sections according to your environment. 6. Select authentication method of the serial port on Authentication Settings section.
Outgoing PPP Connection Outgoing PPP connections are those connections where the ConnectPort LTS product dials-up to an external modem or ISP. Examples of outgoing PPP connections are typically to automatically connect to an external ISP network when the main Ethernet network goes down. This is to allow the device to continue communication on the network or allow connections from the network when the main Ethernet network is down.
Peer configuration: Specifies how the remote IP address that is supplied to the client is assigned. - Automatically Obtain IP Address from Remote Peer: The IP address will automatically be obtained as supplied by the remote peer. This address, depending on the implementation of the remote peer, will either by dynamic or static. For more information, please contact the service provider of the system being connected to. This is the most commonly used mode and the default.
Configuration through the command line Configuring a ConnectPort LTS product through the command-line interface consists of entering a series of commands to set values in the device. The ConnectPort LTS Command Reference describes the commands used to configure, monitor, administer, and operate ConnectPort LTS products. Access the command line To configure devices using commands, first access the command line.
Verify device support of commands On the configuration specific shell interface, online help is available to verify whether a ConnectPort LTS product supports a particular command. For example: help displays all supported commands for a device. ? displays all supported commands for a device. set ? displays the syntax and options for the set command. Use this command to determine whether the device includes a particular set command variant to configure various features.
To configure: Use this command: system-identifying information set system serial port options--general set serial serial TCP and serial UDP set tcpserial and set udpserial RealPort configuration options set realport RTS toggle set rtstoggle SNMP set snmp users user groups, and passwords set user set group newpass user permissions for various services and commands set permissions SD memory set sdmemory LCD set lcd USB set usb Xbee set xbee IP pool for PPP connection set ippool Set
To configure: Use this command: Python set python Trace log set trace Syslog set syslog 104
Configuration through Simple Network Management Protocol (SNMP) Configuring ConnectPort LTS products through Simple Network Management protocol uses a subset of standard MIBs for network and serial configuration, plus several Digi enterprise MIBs for device identification, alarm handling and ConnectPort LTS products specific configurations. These MIBs are listed and described under ―Configuration Interfaces,‖ and must be loaded into a network management station (NMS).
4. Monitoring and management The port, device, system, and network activities of ConnectPort LTS products can be monitored from a variety of interfaces. Changes in data flow may indicate problems or activities that may require immediate attention. In addition, connections and network services can be managed. This chapter discusses monitoring and connection-management capabilities and tasks in ConnectPort LTS products.
General system information The General page displays the following general system information about the ConnectPort LTS product, which can be useful in device monitoring and troubleshooting. Information on this page includes: Model The model of the ConnectPort LTS product. MAC Address A unique network identifier All network devices are required to have their own unique MAC address. The MAC address is on a sticker on the ConnectPort LTS product.
Power status For models with dual power supply, Power status shows the status of the power supplies.
Serial port information The Serial page of System Information lists the serial ports that are configured for the ConnectPort LTS product. Click on a port to view the detailed serial port information. Serial port diagnostics page The Serial Port Diagnostics page of system information provides details that may aid in troubleshooting serial communication problems. Signals The Signals section shows the serial port signals are green when asserted (on) and gray when not asserted (off).
Serial statistics The Serial statistics section of serial port information includes data counters and error tracking that will help determine the quality of data that is being sent or received. If the error counters are accumulating, there may be a problem in the ConnectPort LTS product. Total Data In Total number of data bytes received. Total Data Out Total number of data bytes transmitted.
Network statistics Network statistics are detailed statistics about network and protocol activity that may aid in troubleshooting network communication problems. Statistics displayed are those gathered since the unit was last rebooted. If an error counter accumulates at an unexpected rate for that type of counter, there may be a problem in the ConnectPort LTS product. Ethernet Connection Statistics Speed Ethernet link speed: 10, 100 or 1000 Mbps.
TCP statistics Segments Received Segments Sent Number of segments received or sent. Active Opens Number of active opens. In an active open, the ConnectPort LTS product is initiating a connection request with a server. Passive Opens Number of passive opens. In a passive open, the ConnectPort LTS product is listening for a connection request from a client. Bad Segments Received Number of segments received with errors. Attempt Fails Number of failed connection attempts.
UDP statistics Datagrams Received Datagrams Sent Number of datagrams received or sent. Bad Datagrams Received Number of bad datagrams that were received. This number does not include the value contained by No Ports. No Ports Number of received datagrams that were discarded because the specified port was invalid. ICMP statistics Messages Received Number of messages received. Bad Messages Received Number of received messages with errors.
XBee Network This section is used to view more detailed statistics for XBee module activity that may aid in troubleshooting network communication problems with your XBee network. Gateway Device Details This section shows the current PAN ID, Channel, and address in use for the XBee network. Network View of the XBee Devices Use the Discover XBee Devices button to refresh the list of devices which have joined the XBee network. (Note that the discovery operation may take a few seconds.
Python Application XBee Socket Counters This section includes data counters that are specific to ZigBee Sockets implemented using a Python application. Frames Sent The total number of transmitted frames. Frames Received The total number of received frames. Bytes Sent The total number of bytes sent. Bytes Received The total number of bytes received. Python Application XBee Socket Error Counts This section includes error counters that are specific to ZigBee Sockets implemented using a Python application.
Manage connections and services The Management menu is for viewing and managing connections and services for the ConnectPort LTS product. Manage serial ports Management > Serial Ports provides an overview of the serial ports and their connections. Clicking Connections displays the active connections for that serial port. The view can be refreshed to see any new serial-port connections list, and connections can be disconnected as needed.
Monitoring capabilities from the command line There are several commands for monitoring ConnectPort LTS products and managing their connections. For complete descriptions of these commands, see the ConnectPort LTS Command Reference.
info The info command displays statistical information about a device over time. The statistics displayed are those gathered since the tables containing the statistics were last cleared. Info keywords display the following types of statistics: Device statistics. info device displays such details as product, MAC address, bios, and firmware versions, memory usage, utilization, and uptime.
set alarm set alarm displays alarm settings, including conditions that trigger alarms, and how alarms are sent, either as an email message, an SNMP trap, or both. Alarms can be reconfigured as needed. set buffer and display buffers set buffer configures buffering parameters on a port and displays the current port buffer configuration. display buffers displays the contents of a port buffer, or transfers the port-buffer contents to a server running Trivial File Transfer Protocol (TFTP).
Commands for managing connections and sessions close: Closes active sessions that were opened by connect, rlogin, and telnet commands. connect: Makes a connection, or establishes a connection, with a serial port. exit and quit: These commands terminate a currently active session. who and kill: The who command displays a global list of connections. The list of connections includes those associated with a serial port or the command-line interface.
Monitoring Capabilities from SNMP Device monitoring capabilities from SNMP include, among other things: Network statistics, defined in RFC 1213, MIB-II Port statistics, defined in RFCs 1316 and 1317 Device information, defined in Digi enterprise MIB DIGI-DEVICE-INFO.mib For more information on the statistics available through the standard RFCs listed above, refer to the RFCs available on the IETF web site (www.ietf.org). For enterprise MIBs, refer to the description fields in the MIB text.
5 Administration tasks This chapter discusses the administration tasks that need to be performed on ConnectPort LTS products periodically, such as file management, changing the password used for logging onto the device, backing up and restoring device configurations, updating firmware and Boot/POST code, restoring the device configuration to factory defaults, and rebooting the device.
File management The File Management page of the web interface uploads custom files to a ConnectPort LTS product. Custom files allow the flexibility to alter the interface either by adding a different company logo, changing colors, or moving information to different locations. If custom files are note, using this feature is not necessary. Upload files To upload files to a ConnectPort LTS product, enter the file path and name for the file, or click Browse to locate and select the file, and click Upload.
Backup/restore device configurations Once a ConnectPort LTS product is configured, backing up the configuration settings is recommended in case problems occur later, firmware is upgraded, or hardware is added. If multiple devices need to be configured, the backup/restore feature can be used as a convenience, where the device configuration settings are backed up to a file, then the file is loaded onto the other devices.
Backup/restore device configuration from a TFTP or BOOTP Server from the command line From the command-line interface, the ―backup‖ command backs up the device configuration to a TFTP or BOOTP server located on the network or a storage device in the ConnectPort LTS device, or restores the configuration.
Update firmware The firmware for a ConnectPort LTS product can be updated in several ways: In the web interface, by the Administration > Update Firmware page From the command-line interface, via TFTP or BOOTP. The recommended method for firmware upgrade is to download the firmware to a local hard drive. Prerequisites These procedures assume that: A firmware file has already been downloaded from the Digi web site. That TFTP or BOOTP is running. Update firmware from a file from the web interface 1.
Restore a device configuration to factory default settings Restoring a ConnectPort LTS product to its factory default settings clears all current configuration settings. Selecting the Keep network settings option retains the IP address settings. In addition, any files that were loaded into the device through the File Management page such as custom-interface files and applet files are retained. See "File management" for information on loading and deleting files.
Using the Reset button If the ConnectPort LTS device cannot be accessed from the web interface, the configuration can be restored to factory defaults by using the Reset button. In this case, all current settings including the IP settings will be cleared. Reset ConnectPort LTS 1. Locate the Factory Reset button on the front of device, as shown in the figure. Use a nonconducive, small diameter tool (such as wood or plastic) with a blunt end (NOT SHARP or the button could be damaged) to press gently. 2.
Display system information System information displays the model, MAC address, firmware version, and bios version of the ConnectPort LTS product. It also displays memory available: total, used, and free, and tracks CPU percent utilization and the uptime. From the web interface menu, select Administration > System Information. Select General, Serial, or Network for the appropriate information. For descriptions of the information displayed on these screens, see ―Display System Information.
Administration from the command-line interface Administrative tasks can also be performed from the command line. Here are several deviceadministration tasks and the commands to perform them. See the ConnectPort LTS Command Reference for more complete command descriptions. Administrative task Command Backup/restore a configuration from a backup to=serveripaddress[:filename] TFTP server on the network Update firmware 1.
6 LCD interface: configuration, monitoring, and diagnostics This chapter discusses how to configure, monitor or diagnose the ConnectPort LTS using the LCD interface. It covers these topics: Description for basic key pad operation and LCD display Configuration using the LCD interface Monitoring using the LCD interface Diagnostics using the LCD interface Miscellaneous functions in the LCD interface.
Keypad operations When you turn on the ConnectPort LTS, the following default image is displayed on the LCD screen: Pressing any key displays the main menu screen on the LCD screen. The black triangle on the right end of each menu item indicates the menu item has submenus. If you press Sel key again, the following configuration submenu screen is displayed on the LCD screen. On this screen, the CONFIG message on the top left side indicates you are on the configuration menu.
Configuration using the LCD interface You can set the following configurations using the LCD interface: IP settings #1: Sets IP mode, IP address, Subnet mask, and the default gateway of network interface #1. (You can only set IPv4 mode. LCD interface does not support the configuration of IPv6 mode.) IP settings #2: Sets IP mode, IP address, Subnet mask, the default Gateway of network interface #2. Host name: Host name of the device. DNS: Primary DNS of the device.
Set IP Address If you select IP Mode to STATIC, you can change or set the IP address, subnet mask and gateway settings. When you select IP ADDRESS menu item, the following menu is displayed: On this screen, you can move cursor position using Up (Left) and Dn (Right) keys.
After changing the selected letter, you can choose another letter by pressing Ext key twice. Repeat the steps to change the letter as described above. When done changing the letters as desired, press the Ext key on the following screen: You can then enter the IP settings menu again. Continue to change SUBNET MASK or GATEWAY in the manner described above. After completing the settings changes, press the Ext key on the IP SETTINGS menu.
Change the hostname Enter the host name menu by selecting CONFIGURATION and then HOST NAME. The following menu is displayed: Press the Sel key again. This menu is displayed: Move cursor position using Up (Left) and Dn (Right) keys. Once you locate the cursor on the position you want to change, press the Sel key to enter the editing submenu as follows: On this editing submenu screen, select EDIT to change the desired letter or CLEAR ALL to clear all host names displayed on the screen.
After changing the selected letter, choose another letter by pressing Ext key twice. Repeat the steps to change the letter just described above. When done changing letters, press the Ext key several times until you meet following screen. Then choose one of following options, SAVE APPLY: Save configuration changed and apply it. DISCARD CHANGES: Discard all changes. CANCEL: Go back to the HOST NAME menu.
Change the DNS configuration Select CONFIGURATION and then DNS. The following menu is displayed: Press the Sel key again. The following menu is displayed: If you choose the ENABLE option and press the Ext key, the following menu is displayed: Set the IP address of the DNS server in the same manner as setting the IP address.
Monitoring using the LCD interface The following information can be monitored through the LCD interface.
Miscellaneous functions in LCD interface The Miscellaneous menu has the following functions. Factory Reset: Restore the configuration to factory defaults. LCD setting - Reset the LCD configuration - Select a background image Factory Reset Enter the factory reset menu by selecting MISCELLANEOUS and then FACTORY RESET. The following menu screen is displayed. If you select APPLY, all configuration of the device restored to factory default value and the device is rebooted automatically.
LED Settings When you enter the LCD setting menu by selecting MISCELLANEOUS and then LCD SETTINGS, the following menu is displayed: Reset RESET allows resetting the LCD configuration, including whether a custom or default background image is used.
7 Disaster recovery The Digi ConnectPort LTS unit provides a disaster recovery procedure in the event the configuration data is destroyed or corrupted. The Digi ConnectPort LTS unit automatically restores a corrupted configuration file system to the factory default settings. However, if the Digi ConnectPort LTS unit fails to boot in spite of being reset to the factory default settings, the firmware can be restored using the Bios menu.
6. Enter the information for the first menu items. - Protocol: The choices are BOOTP or TFTP. - IP address assigned: Enter the IP address of the Digi ConnectPort LTS unit. - Server’s IP address: The IP address of the BOOTP or TFTP server. - Firmware File Name: The filename for the firmware. - Ethernet interface: 1 or 2. 7. Use the ESC key to return to earlier menu screens. 8. Select Start firmware upgrade. The firmware upgrade can take 15 to 20 minutes to process.
8 Hardware specifications Hardware specifications for this product are located at: http://www.digi.
9 Regulatory Information and Certifications FCC certifications and regulatory information (USA only) FCC Part 15 Class B These devices comply with the standards cited in this section: ConnectPort LTS 16 ConnectPort LTS 32 Radio Frequency Interface (RFI) (FCC 15.105) This device has been tested and found to comply with the limits for Class B digital devices pursuant to Part 15 Subpart B, of the FCC rules.
Modifications (FCC 15.21) Changes or modifications to this equipment not expressly approved by Digi may void the user’s authority to operate this equipment.
Safety statements 5.10 Ignition of Flammable Atmospheres Warnings for Use of Wireless Devices Observe all warning notices regarding use of wireless devices. Potentially Hazardous Atmospheres Observe restrictions on the use of radio devices in fuel depots, chemical plants, etc. and areas where the air contains chemicals or particles, such as grain, dust, or metal powders, and any other area where you would normally be advised to turn off your vehicle engine.
Rack-mountable: 1. Elevated Operating Ambient Temperature: If installed in a closed or multi-unit rack assembly, the operating ambient temperature of the rack environment may be greater than room ambient. Therefore, consideration should be given to installing the equipment in a environment compatible with the manufacturer’s maximum rated ambient temperature (Tmra). 2.
Lithium Battery CAUTION Danger of explosion if battery is incorrectly replaced. Replace only with the same or equivalent type recommended by the manufacturer. (Manufacturer: SONY FUKUSHIMA CORP., Model: CR2032.) DISPOSE OF USED BATTERIES ACCORDING TO THE NATIONAL CODE OR RECYCLING PROGRAM. Modem CAUTION To reduce the risk of fire, use only No. 26AWG or larger telecommunication line cord.
