Digi ConnectPort LTS User Guide

ConnectPort LTS
User Guide
Revision history—90001001
Revision
Date
Description
C
June 2012
Updated the document and corrected content.
D
July 2012
Updated the document and corrected content.
E
May 2013
Added information on the banner feature.
F
December 2016
n
Updated the branding.
n
Added Ethernet bridging feature.
n
Expanded information under ConnectPort LTS web interface.
Trademarks and copyright
Digi, Digi International, and the Digi logo are trademarks or registered trademarks in the United
States and other countries worldwide. All other trademarks mentioned in this document are the
property of their respective owners.
© 2016 Digi International Inc. All rights reserved.
Disclaimers
Information in this document is subject to change without notice and does not represent a
commitment on the part of Digi International. Digi provides this document “as is,” without warranty of
any kind, expressed or implied, including, but not limited to, the implied warranties of fitness or
merchantability for a particular purpose. Digi may make improvements and/or changes in this manual
or in the product(s) and/or the program(s) described in this manual at any time.
Warranty
To view product warranty information, go to the following website:
www.digi.com/howtobuy/terms
Send comments
Documentation feedback: To provide feedback on this document, send your comments to
techcomm@digi.com.
Customer support
Digi Technical Support: Digi offers multiple technical support plans and service packages to help our
customers get the most out of their Digi product. For information on Technical Support plans and
pricing, contact us at 877.912.3444 or visit us at www.digi.com/support.
Support portal login: www.digi.com/support/eservice
Digi ConnectPort LTS User Guide
2
Contents
About this guide
Important safety information
Where to find information
9
9
ConnectPort LTS features
ConnectPort LTS Family
User interfaces
Hardware and network interface features
Network services
IP protocol support
Serial data communication over TCP and UDP
Dynamic Host Configuration Protocol (DHCP)
Auto IP
Simple Network Management Protocol (SNMP)
Secure Sockets Layer (SSL)/Transport Layer Security (TLS)
Telnet
Remote login (rlogin)
Line Printer Daemon (LPD)
HyperText Transfer Protocol (HTTP)/HyperText Transfer Protocol over Secure Socket Layer
(HTTPS)
Internet Control Message Protocol (ICMP)
Point-to-Point Protocol (PPP)
Advanced Digi Discovery Protocol (ADDP)
Secure Shell (SSH)
RealPort software
Encrypted RealPort
Alarms
Modem emulation
Ethernet bridging
Security features
Secure access and authentication
Encryption
SNMP security
Configuration management
12
12
12
12
13
13
14
14
14
14
14
15
15
15
15
15
15
16
16
16
16
17
17
18
18
18
18
19
Getting started with ConnectPort LTS
Configuring IP addresses
Assign an IP address using DHCP
Assign an IP address using Auto-IP
Assign an IP address from the command-line interface
Assign an IP address from the web interface
Digi ConnectPort LTS User Guide
21
22
22
22
23
3
Test the IP address assignment
Using the rc.user file
Quick reference for configuring features
23
23
24
ConnectPort LTS network connections and data paths
Network services
Network services associated with specific ports
Network services associated with serial ports in general
Network services associated with the command-line interface
Network/serial clients
Autoconnect behavior client connections
Command-line interface (CLI)-based client connections
Modem emulation (pseudo-modem) client connections
31
31
31
32
32
32
32
33
ConnectPort LTS configuration and administration
Configuration capabilities
ConnectPort LTS administration capabilities
ConnectPort LTS configuration interfaces
35
35
35
Digi Device Discovery utility
ConnectPort LTS web interface
Sign in to the web interface
Use a web browser to sign in to the web interface
Use Digi Device Discovery utility to sign in to the web interface
Power failure message
Home page
Menu
Getting Started
System Summary
Logout and Login
Apply and save changes
Cancel changes
Online help
Configuration
Network Configuration
Serial Ports Configuration
Alarms Configuration
System Configuration
Users
Peripheral
SD Memory
USB
Modem
LCD
XBee
Application
PPP (Point-to-Point Protocol)
Python Configuration
RealPort configuration
Digi ConnectPort LTS User Guide
39
39
39
40
40
40
40
40
41
41
41
41
41
41
53
78
79
83
88
89
89
89
97
98
105
105
115
117
4
Management
Serial Port Management
Port Connections Management
Port Logging Management
Administration
Certificate Management
File Management
Backup/Restore
Update Firmware
Factory Default Settings
System Information
Reboot
Enable/disable access to network services
118
118
118
118
119
119
120
120
122
123
124
129
129
ConnectPort LTS command-line interface
Access the command-line interface
Basics for using the command-line interface
Management
backup print
close
connect
display
exit and quit
info
newpass
reconnect
rlogin
send
set alarm
set autoconnect
set buffer and display buffer
set group
set host
set ippool
set lcd
set modem
set network
set nfs
set permissions
set pmodem
set portauth
set ppp
set profiles
set python
set realport
set rtstoggle
set samba
set sdmemory
set serial
set service
set smtp
set snmp
set socket_tunnel
set switches
Digi ConnectPort LTS User Guide
131
131
132
133
133
133
133
134
134
135
135
135
135
136
136
136
136
136
136
136
136
136
136
136
137
137
137
137
137
137
137
137
137
137
137
137
137
138
138
5
set sysauth
set syslog
set system
set tcpserial
set trace
set udpserial
set user
set web
set xbee
show
status
telnet
who and kill
Administration
138
138
138
138
138
138
138
138
138
139
139
139
139
140
Simple Network Management Protocol (SNMP)
About Simple Network Management Protocol (SNMP)
Management Information Bases (MIBs)
Viewing MIB-II components
SNMP device monitoring capabilities
Download a Digi MIB
SNMP configuration
Supported SNMP traps
Supported RFCs and MIBs
142
142
142
142
143
143
143
143
ConnectPort LTS LCD interface
Keys
Keypad operations
Configuring the ConnectPort LTS using the LCD interface
Change the IP settings
Change the hostname
Change the DNS configuration
Monitoring the status using the LCD interface
Running diagnostics using the LCD interface
Miscellaneous functions in the LCD interface
Run the Factory Reset
LCD settings
Change the LCD settings
146
146
146
147
149
150
151
151
151
152
152
152
ConnectPort LTS disaster recovery
Restore ConnectPort LTS to Factory Default Settings
155
ConnectPort LTS hardware specifications
ConnectPort LTS regulatory information and certifications
FCC certifications and regulatory information (USA only)
FCC Part 15 Class B
Radio Frequency Interface (RFI) (FCC 15.105)
Digi ConnectPort LTS User Guide
159
159
159
6
Labeling Requirements FCC (15.19)
Industry Canada (IC) certifications
China regulatory information
Safety statements
Digi ConnectPort LTS User Guide
159
160
160
161
7
About this guide
This guide describes how to install, provision, configure, monitor, and administer Digi ConnectPort LTS
devices. This guide covers the following products:
n ConnectPort LTS 8 and ConnectPort LTS 8 MEI
n
ConnectPort LTS 8 W and ConnectPort LTS 8 MEI W
n
ConnectPort LTS 16 and ConnectPort LTS 16 MEI
n
ConnectPort LTS 16 W and ConnectPort LTS 16 MEI W
n
ConnectPort LTS 16 MEI 2AC
n
ConnectPort LTS 32 and ConnectPort LTS 32 MEI
n
ConnectPort LTS 32 W and ConnectPort LTS 32 MEI W
Digi ConnectPort LTS User Guide
8
About this guide
Important safety information
Important safety information
To avoid contact with electrical current:
n Never install electrical wiring during an electrical storm.
n
Never install an Ethernet connection in wet locations unless that connector is
specifically designed for wet locations.
n
Use caution when installing or modifying lines.
n
Use a screwdriver and other tools with insulated handles.
n
Wear safety glasses or goggles.
n
Do not place Ethernet wiring or connections in any conduit, outlet or junction box
containing electrical wiring.
n
Installation of inside wire may bring you close to electrical wire, conduit,
terminals and other electrical facilities. Extreme caution must be used to avoid
electrical shock from such facilities. Avoid contact with all such facilities.
n
Ethernet wiring must be at least 6 feet from bare power wiring or lightning rods
and associated wires, and at least 6 inches from other wire (antenna wires,
doorbell wires, wires from transformers to neon signs), steam or hot water pipes,
and heating ducts.
n
Do not place an Ethernet connection where it would allow a person to use an
Ethernet device while in a bathtub, shower, swimming pool, or similar hazardous
location.
n
Protectors and grounding wire placed by the service provider must not be
connected to, removed, or modified by the customer.
n
Do not touch uninsulated Ethernet wiring if lightning is likely.
n
External wiring: Any external communications wiring installed needs to be
constructed to all relevant electrical codes. In the United States this is the
National Electrical Code Article 800. Contact a licensed electrician for details.
Where to find information
In addition to this guide, you can find additional product and feature information in these documents:
n RealPort® Installation Guide
n
Digi Device Customization and Integration Guide
The ConnectPort LTS support page provides one or more of the following documents:
n Release Notes
n
Quick Start Guides
n
Cabling Guides
n
Digi Connect® Hardware Reference Guides
Digi ConnectPort LTS User Guide
9
About this guide
Where to find information
For additional information, see the following resources:
n Online help and tutorials in the web interface for the Digi device
n
Digi Python Wiki
n
Product information available on the Digi website, www.digi.com, and the Digi support website,
including:
l
Support forum
l
Knowledge Base
l
Datasheets/product briefs
l
Application/solution guides
l
Carrier-specific documents
Digi ConnectPort LTS User Guide
10
ConnectPort LTS features
This section provides an overview of ConnectPort LTS features.
ConnectPort LTS Family
User interfaces
Hardware and network interface features
Network services
IP protocol support
Serial data communication over TCP and UDP
RealPort software
Encrypted RealPort
Alarms
Modem emulation
Ethernet bridging
Security features
Configuration management
Digi ConnectPort LTS User Guide
12
12
12
12
13
13
16
16
16
17
17
18
19
11
ConnectPort LTS features
ConnectPort LTS Family
ConnectPort LTS Family
ConnectPort LTS (Linux Terminal Server) devices provide serial over Ethernet connectivity for
applications. They support IPv4 and IPv6 Ethernet protocols. ConnectPort LTS MEI is the same size as
ConnectPort LTS (RS-232 only version).
User interfaces
You can use the following user interfaces to configure, monitor, and administer Digi devices:
n
Web-based interface
n
Command-line interface available via local serial port, telnet or SSH
n
Simple Network Management Protocol (SNMP)
n
LCD panel
For additional details on these user interfaces, see ConnectPort LTS configuration and administration.
You can customize some of the user interfaces.
Hardware and network interface features
For detailed hardware specifications and network interface information, go to:
www.digi.com/products/serial-servers/serial-deviceservers/connectportlts#specifications
See also the datasheet for your Digi device.
Network services
You can enable or disable access to network services. This means that you can restrict a device’s use
of network services to those strictly needed by the device. To improve device security, you can disable
non-secure services. You can enable or disable the following network services:
n Advanced Digi Discovery Protocol (ADDP)
n
RealPort
n
Encrypted RealPort
n
HTTP/HTTPS
n
Line Printer Daemon (LPD)
n
Remote login (rlogin)
n
Remote shell (rsh)
n
SNMP
n
Telnet
n
Secure Shell Server (SSH)
You can enable or disable access to network services from the Network Services Settings page in the
web interface. For more information, see Basic Network Services Settings.
Digi ConnectPort LTS User Guide
12
ConnectPort LTS features
IP protocol support
You can use the set service command to enable and disable network services from the command-line
interface. See the ConnectPort LTS Command Reference on digi.com for a description of the set service
command.
IP protocol support
All ConnectPort LTS devices include an on-board TCP/IP stack with a built-in web server. Supported
protocols vary by specific product and include, unless otherwise noted:
n Transmission Control Protocol (TCP)
n
User Datagram Protocol (UDP)
n
Dynamic Host Configuration Protocol (DHCP)
n
Simple Network Management Protocol (SNMP)
n
Secure Sockets Layer (SSL)/Transport Layer Security (TLS)
n
Remote login (rlogin)
n
Line Printer Daemon (LPD)
n
HyperText Transfer Protocol (HTTP)/HyperText Transfer Protocol over Secure Socket Layer
(HTTPS)
n
Simple Mail Transfer Protocol (SMTP)
n
Internet Control Message Protocol (ICMP)
n
Internet Group Management Protocol (IGMP)
n
Address Resolution Protocol (ARP)
n
Advanced Digi Discovery Protocol (ADDP)
Serial data communication over TCP and UDP
ConnectPort LTS products support serial data communication over TCP and UDP. The key features
include:
n Serial data communication over TCP can automatically perform the following functions:
l
Establish bi-directional TCP connections, known as autoconnections, between the serial
device and a server or other network device. Autoconnections are based on data and/or
serial hardware signals.
l
Control forwarding characteristics based on size, time, and pattern.
l
Allow incoming raw, telnet, and SSL/TLS (secure-socket) connections.
Digi ConnectPort LTS User Guide
13
ConnectPort LTS features
n
Serial data communication over TCP and UDP
Serial data communication over UDP can automatically perform the following functions:
l
Digi Connect products can automatically send serial data to one or more devices or
systems on the network using UDP sockets. Options for sending data include whether
specific data is on the serial line, a specific time period has elapsed, or after the specified
number of bytes has been received on the serial port.
l
Control forwarding characteristics based on size, time, and patterns.
l
Support incoming datagrams from multiple destinations.
l
Support outgoing datagrams sent to multiple destinations.
n
TCP/UDP forwarding characteristics.
n
Extended communication control on TCP/UDP data paths.
l
Timeout
l
Hangup
l
User-configurable Socket ID string (text string identifier on autoconnect only)
Dynamic Host Configuration Protocol (DHCP)
You can use Dynamic Host Configuration Protocol (DHCP) to automatically assign IP addresses, deliver
IP stack configuration parameters such as the subnet mask and default router, and provide other
configuration information. For more details, see Assign an IP address using DHCP.
Auto IP
The Auto-IP protocol automatically assigns an IP address from a reserved pool of standard Auto-IP
addresses to the computer on which it is installed. Digi devices automatically obtain their IP
addresses from a DHCP server. If the DHCP server is unavailable or nonexistent, Auto-IP assigns the
device an IP address. For more details, see Assign an IP address using Auto-IP.
Simple Network Management Protocol (SNMP)
Simple Network Management Protocol (SNMP) is a protocol for managing and monitoring network
devices. SNMP architecture enables a network administrator to manage nodes—servers,
workstations, routers, switches, hubs, and so on—on an IP network; manage network performance,
find and solve network problems, and plan for network growth. For more information on SNMP as a
device-management interface, see Simple Network Management Protocol (SNMP).
Secure Sockets Layer (SSL)/Transport Layer Security (TLS)
Secure Sockets Layer (SSL)/Transport Layer Security (TLS) provides authentication and encryption for
ConnectPort LTS products. For more information, see Security features.
Telnet
ConnectPort LTS devices support the following types of telnet connections:
n Telnet client
n
Telnet server
Digi ConnectPort LTS User Guide
14
ConnectPort LTS features
Serial data communication over TCP and UDP
n
Reverse telnet, often used for console management or device management
n
Telnet autoconnect
For more information on these connections, see ConnectPort LTS network connections and data
paths. You can enable or disable access to telnet network services.
Remote login (rlogin)
You can enable or disable access to rlogin service. When enabled, users can use rlogin to remotely sign
in to systems.
Line Printer Daemon (LPD)
The Line Printer Daemon (LPD) allows network printing over a serial port. Each serial port has a
dedicated LPD server that is independently configurable. You can enable or disable access to LPD
service.
HyperText Transfer Protocol (HTTP)/HyperText Transfer Protocol
over Secure Socket Layer (HTTPS)
Digi provides web pages that you can use to configure the ConnectPort LTS product. You can secure
these web pages by requiring a user login.
Internet Control Message Protocol (ICMP)
You can display ICMP statistics, including the number of:
n Messages received
n
Bad messages received
n
Destination unreachable messages received
Point-to-Point Protocol (PPP)
The Point-to-Point Protocol (PPP) transports multi-protocol packets over point-to-point links. PPP is
responsible for:
n Encapsulating the data packet
n
Allowing the server to inform the dial-up client of its IP address (or client to request the IP
address)
n
Authenticating the exchange
n
Negotiating multiple protocols
n
Reassembling the data packet for network communication
Advanced Digi Discovery Protocol (ADDP)
The ADDP runs on any operating system capable of sending multicast IP packets on a network. ADDP
allows the system to identify all ADDP-enabled ConnectPort LTS products attached to a network by
sending out a multicast packet. The ConnectPort LTS products respond to the multicast packet and
identify themselves to the client sending the multicast.
Digi ConnectPort LTS User Guide
15
ConnectPort LTS features
RealPort software
ADDP communicates with the IP stack using UDP. The IP stack can receive multicast packets and
transmit datagrams on a network.
You can enable or disable access to ADDP service, but you cannot change the network port number for
ADDP from its default.
Secure Shell (SSH)
ConnectPort LTS products support Secure Shell (SSH) as a connection method and the following types
of SSH connections: Reverse SSH and SSH Autoconnect. Limited use of SSH via SSH client is available
from the Linux command line/bash shell. For more information on these connections, see ConnectPort
LTS network connections and data paths. You can enable or disable access to Secure Shell network
services.
RealPort software
Digi’s RealPort software leverages the TCP/IP network infrastructure to provide a virtual connection
to serial devices. The software is installed directly on the server and allows applications to talk to
devices via a Digi device server or terminal server over a network.
RealPort software is a COM port redirector that allows multiple connections to multiple ports over a
single TCP/IP connection. This means RealPort supports the maximum number of remote devices. The
number is restricted only by the operating system and server processing power.
Other unique features include full hardware and software flow control, as well as tunable latency and
throughput. With these, RealPort ensures optimum performance since data transfer is adjusted
according to specific application requirements. It also provides connection recovery—after a network
interruption RealPort automatically reconnects the device to the COM port without the application
knowing there was a failure.
Encrypted RealPort
ConnectPort LTS devices also support RealPort software with encryption. Encrypted RealPort offers a
secure Ethernet connection between the COM or TTY port and a device server or terminal server.
Encryption prevents internal and external snooping of data across the network by encapsulating the
TCP/IP packets in an SSL connection and encrypting the data using Advanced Encryption Standard
(AES).
Digi’s RealPort with encryption driver has earned Microsoft’s Windows Hardware Quality Lab (WHQL)
certification.
Drivers are available for a wide range of operating systems, including Microsoft Windows and Linux x32
and x64 based operating systems, as well as other versions of Unix. See the RealPort Compatibility OS
List in the Digi Knowledge Base for a detailed list of supported operating systems. It is ideal for
financial, retail/point-of-sale, government, or any application requiring enhanced security to protect
sensitive information.
Alarms
You can configure ConnectPort LTS products to issue alarms, in the form of email messages or SNMP
traps, when certain device events occur, including data patterns detected in the data stream
Configuring Digi devices to issue alarms allows you to know when events occur. For more information
on configuring alarms, see Alarms Configuration.
Digi ConnectPort LTS User Guide
16
ConnectPort LTS features
Modem emulation
Modem emulation
ConnectPort LTS devices include a configuration profile that allows the device to emulate a modem.
Modem emulation sends and receives modem responses to a serial device over TCP/IP (including
Ethernet) instead of Public Switched Telephone Network (PSTN). The modem emulation profile allows
you to maintain a current software application but using it over the less expensive Ethernet network.
In addition, you can enable or disable telnet processing on the incoming and outgoing modememulation connections. For information on the modem-emulation commands that ConnectPort LTS
products support, see the ConnectPort LTS Command Reference. See Select Port Profile for more
information.
Ethernet bridging
You can use Ethernet bridging to join multiple Ethernet networks together so that the joined
networks appear as one Ethernet network. Ethernet bridging combines an Ethernet interface with
one or more physical Ethernet interfaces under the umbrella of a single bridge interface. The Ethernet
bridge is a software switch that can connect multiple Ethernet interfaces (physical or virtual) on a
single machine while sharing a single IP subnet.
Use the script file, brmode (/etc/init.d/brmode), to enable or disable Ethernet bridging. (Ethernet
bridging is supported only through the command line interface.)
To enable Ethernet bridging, run the following command:
# service brmode start
The IP address of the eth0 interface becomes the common IP address for the bridging mode interface
(br0).
After enabling Ethernet bridging, the eth0 and eth1 addresses disappear. There is a delay of a few
minutes while the system automatically changes the physical interface from the Ethernet 1 port to
Ethernet 2 port.
Note Enable the eth1 (IP address #2) interface before starting Ethernet bridging.
To disable Ethernet bridging, run the following command:
# service brmode stop
To customize Ethernet bridging options, modify /etc/init.d/brmode. See the brctl Linux manpage for
details.
To remove bridging messages from the serial console, run the following command:
# brctl setageing br0 0
To automatically start the Ethernet bridging service at each boot, add the following commands to the
rc.user file:
service brmode start
brtcl set ageing br0 0
For more information on using the rc.user file, see Using the rc.user file and the Digi Knowledgebase.
Digi ConnectPort LTS User Guide
17
ConnectPort LTS features
Security features
Security features
This section covers ConnectPort LTS security features.
Secure access and authentication
Security features include the followoing:
n Provide customized permissions controls to locally defined users. The local definitions apply
irrespective of whether Radius is used for authentication
n
Issue passwords for device users
n
Selectively enable/disable network services such as ADDP, RealPort, Encrypted RealPort,
HTTP/HTTPS, LPD, remote login, remote shell, SNMP, telnet, and Secure Shell (SSH)
n
Control access to inbound ports
n
Secure sites for configuration: HTML pages for configuration have appropriate security
n
Control user and user group access permissions. These permissions control user access to
various features and the level of control they have over them (view settings or change
settings)
n
Enable secure remote login through Remote Authentication Dial-In User Service (RADIUS) and
Lightweight Directory Access Protocol (LDAP)
Encryption
Encrypted RealPort offers encryption for the Ethernet connection between the COM/TTY port and the
ConnectPort LTS product. Encryption prevents internal and external snooping of data across the
network by encapsulating the TCP/IP packets in an SSL connection and encrypting the data using the
Advanced Encryption Standard (AES) security algorithm.
Encryption methods are as follows:
n
Strong TLS V1.0/V1.2-based encryption:
l
DES (58/64-bit)
l
3DES (168/192-bit)
l
AES (128/156/192/256-bit)
SNMP security
SNMP security options include:
n
You can configure SNMP set commands to use SNMP read-only. Digi recommends changing the
public and private community names to prevent unauthorized access to the Digi device
(SNMPv1/v2c).
n
You can use SNMPv3 support for enhanced security through SNMP.
Digi ConnectPort LTS User Guide
18
ConnectPort LTS features
Configuration management
Configuration management
Once a ConnectPort LTS device is configured and running, you may need to periodically perform the
following configuration-management tasks:
n Copy configurations to and from a remote host
n
Perform the following on the Digi device: Update the firmware, reset the factory settings,
manage the device files and memory, or reboot
For more information on these configuration-management tasks, see Administration.
Digi ConnectPort LTS User Guide
19
Getting started with ConnectPort LTS
This section walks you through configuring an IP address and signing in to your ConnectPort LTS
device.
Configuring IP addresses
Test the IP address assignment
Using the rc.user file
Quick reference for configuring features
Digi ConnectPort LTS User Guide
21
23
23
24
20
Getting started with ConnectPort LTS
Configuring IP addresses
Configuring IP addresses
The IP address mode determines how IP addresses are assigned. There are two modes for assigning
IP addresses:
n Dynamic: Allows IP addresses to be automatically assigned using the Dynamic Host
Configuration Protocol (DHCP) and/or Auto Private IP Addressing (APIP or AUTO IP).
n
Static: Requires you to assign a static IP address using any available configuration interface.
By default, ConnectPort LTS devices are configured to dynamically assign addresses using DHCP.
Even if a DHCP server is available for dynamically assigning IP addresses, static addresses may work
better for your network configuration. Once set, static IP addresses do not change and other network
devices can always find the device by its IP address. With dynamic settings, the DHCP server can
change the IP address frequently or infrequently depending on how your network administrator has
configured the network. When the IP address changes, network devices configured to talk to the
ConnectPort LTS device can no longer access the device. In this case, you must locate the Digi device
using the Digi Device Discovery utility and reconfigure the other network devices that need to
communicate with the ConnectPort LTS device.
The following table summarizes methods for assigning an IP address.
Method
Description
Digi Device
Discovery
Utility
Use the Digi Device Discovery utility to search for and display Digi device, as well as
change configuration settings. See Use Digi Device Discovery utility to sign in to the
web interface.
LCD panel
Use the LCD panel on ConnectPort LTS products to perform basic configuration
tasks, including setting the IP address, as well as monitoring and diagnostics tasks.
See ConnectPort LTS LCD interface.
Dynamic
Host
Configuration
Protocol
(DHCP)
Use DHCP from the web interface to automatically assign IP addresses, to deliver IP
stack configuration parameters such as the subnet mask and default router, and to
provide other configuration information. All ConnectPort LTS devices have a DHCP
client enabled by default. Contact your network administrator to find out if a DHCP
server is available. See Assign an IP address using DHCP.
Auto Private
IP Addressing
(APIPA)
also known
as Auto-IP
Use APIPA to automatically assign an IP address to the Digi device from a reserved
pool of standard Auto-IP addresses on a DHCP server. If the DHCP server is
unavailable or there is no DHCP server, Auto-IP assigns the device an IP address. If
DHCP is enabled or responds after ADDP is used, both override the Auto-IP address
previously assigned. See Assign an IP address using Auto-IP.
Static IP
Manually assign a specific IP address to a device through the Digi Device Discovery
Utility, the web interface, LCD, or the command-line interface. Once set, these
settings do not change. The IP address and subnet mask are mandatory. Additional
settings may be needed for some functions. Contact your network administrator for
the required values.
Digi ConnectPort LTS User Guide
21
Getting started with ConnectPort LTS
Configuring IP addresses
Method
Description
Access via
the console
port
Use the port, labeled console port on ConnectPort LTS device to configure device
settings. This port allows for a login with serial settings of 9600 baud, 8 data bits,
and 1 stop bit. The standard serial ports do not provide a login by default and do not
provide access to configuration settings. Only the console port allows access to
configuration settings.
Commandline interface
Use the command-line interface to configure device settings. See Assign an IP
address from the command-line interface.
Assign an IP address using DHCP
You can assign an IP address using Dynamic Host Configuration Protocol (DHCP). DHCP is an Internet
protocol for automating the configuration of computers that use IP. You can use DHCP to
automatically assign IP addresses and deliver IP stack configuration parameters.
The following procedure assumes that you configured the Digi device as a DHCP client. The Digi
devices discussed in this document are configured as a DHCP client by default.
To configure an IP address using DHCP:
1. Verify the Digi device is not powered on.
2. If desired, set up a permanent entry for the Digi device on a DHCP server. While this is not
necessary to obtain an IP address via DHCP, setting up a permanent entry saves the IP
address after the device is rebooted.
3. Connect the Digi device to the network and power it on. DHCP assigns the IP address
configured in step 2 automatically.
Assign an IP address using Auto-IP
The standard Automatic Private IP Addressing (APIPA or Auto-IP) protocol automatically assigns the
IP address from a group of reserved IP addresses to the device on which Auto-IP is installed. Use Digi
Device Discovery or ADDP to find the Digi device and assign it a new IP address that is compatible with
your network. When you plug in the device, Auto-IP automatically assigns the IP address. Auto-IP
addresses are typically in the 169.254.x.x address range. See Use Digi Device Discovery utility to sign in
to the web interface for instructions on using Digi Device Discovery.
Assign an IP address from the command-line interface
Use the set network command to configure an IP address from the command line. The set network
command includes the following parameters:
n index=(1-4): The Ethernet interface index number.
n
ip_v4=device ip: The IP address for the device.
n
gateway_v4=gateway: The network gateway IP v4 address.
n
garp=seconds: The frequency of Gratuitous ARP (GARP) announcements, in seconds, which are
a broadcast announcement to the network of a device’s MAC address and the IP address.
n
submask_v4=device submask: The device subnet mask for the IP v4 address.
n
mode_v4=(none|static|dhcp): The configuration mode of the IP v4 address.
Digi ConnectPort LTS User Guide
22
Getting started with ConnectPort LTS
Test the IP address assignment
n
ip_v6=device ip: The IP v6 address for the device.
n
gateway_v6=gateway: The IP address for the IP v6 network gateway.
n
submask_v6=gateway: The device subnet mask for the IP v6 address.
n
mode+v6=(none|static|dhcp): The configuration mode of the IP v6 address.
For example:
set network index=1 ip_v4=10.0.0.100 gateway_v4=10.0.0.1 submask_v4=255.255.255.0
mode_v4=static
Assign an IP address from the web interface
Normally, you assign IP addresses to ConnectPort LTS devices through DHCP. This procedure
assumes that the ConnectPort LTS device already has an IP address and you simply want to change it.
To change the IP address from the web interface:
1. Open a web browser and type the current IP address of the ConnectPort LTS device in the
address bar.
2. Type the user name and password for the device. The default user name is root and the default
password is dbps. If these defaults do not work, contact the system administrator who set up
the device.
3. Click Network to access the Network Configuration page.
4. On the IP Settings page, select Use the following IP address.
5. Type the IP address, subnet mask, and gateway settings.
6. Click Apply to save the configuration.
Test the IP address assignment
To verify the IP address works as configured:
1. Access the command line of a computer or other networked device.
2. Issue the following command:
ping ip-address
where ip-address is the IP address assigned to the Digi device. For example:
ping 192.168.2.2
Using the rc.user file
The /usr2/rc.user file is a text file on the ConnectPort LTS that is accessible by logging in as the root
user. You can modify the file to automatically perform various tasks at boot time, such as:
n Run advanced linux commands
n
Initiate custom scripts
n
Load additional configuration information
Digi ConnectPort LTS User Guide
23
Getting started with ConnectPort LTS
Quick reference for configuring features
The Digi Knowledge Base contains additional information on the rc.user file, common examples, and
advice on how to test and implement commands using the rc.user file. Go to
http://www.digi.com/support for details.
Quick reference for configuring features
The following table provides a quick reference for configuring features and performing device tasks.
Some features are configurable from the command line interface only. For those features, the
commands that configure the feature are noted. See the ConnectPort LTS Command Reference for
descriptions of the commands.
Feature/task
Path to feature in the web interface
Administration/Configuration management:
Certificate Management
Administration > Certificate Management
File management: uploading
and downloading files, such
as applet files, and custom
splash screens
Administration > File Management
See also the Digi Device Customization and Integration Guide for
information on uploading and downloading files used to customize
the product.
Python program file
management
Administration > File Management
Backup/restore
configuration settings
Administration > Backup/Restore
Update firmware
Administration > Update Firmware
Reset configuration to
factory defaults
Administration > Factory Default Settings
System information,
including device identifiers
and statistics
Administration > System Information
Reboot the device
Administration > Reboot
Alarms
Configuration > Alarms
Connection management:
Manage serial port
connections
Management > Serial Ports
Manage active PPP
connections
Management > Connections > Active PPP Connections
Manage active system
connections
Management > Connections > Active System Connections
Domain Name System (DNS) Configuration > Network > DNS > Primary DNS and Secondary DNS
Client
Digi ConnectPort LTS User Guide
24
Getting started with ConnectPort LTS
Quick reference for configuring features
Feature/task
Path to feature in the web interface
Ethernet settings
Configuration > Network > Advanced Network Settings
Help on configuring features Help button on each page.
Host name for a device
Configuration > Network > Advanced Network Settings > Host
Name
IP address settings:
Using static IP addresses
Configuration > Network > IP Settings
Using DHCP
Configuration > Network > IP Settings
IPv6 Settings
Configuration > Network > IP Settings
Source Based Routing
Configuration > Network > IP Settings
Network Bonding
Configuration > Network > IP Settings
Using Auto IP
Configuration > Network > Advanced Settings
Advanced network services settings:
Web settings
Configuration > Network > Network Services Settings > Advanced
Network Service Settings
SMTP settings
Configuration > Network > Network Services Settings > Advanced
Network Service Settings
NFS settings
Configuration > Network > Network Services Settings > Advanced
Network Service Settings
Samba settings
Configuration > Network > Network Services Settings > Advanced
Network Service Settings
Syslog settings
Configuration > Network > Network Services Settings > Advanced
Network Service Settings
Multiple Electrical Interface
(MEI)
1. Select Configuration > Serial Ports >.
2. Click a port number from the Port column.
3. Click Basic Serial Settings.
4. Complete the fields and click Apply.
Digi ConnectPort LTS User Guide
25
Getting started with ConnectPort LTS
Quick reference for configuring features
Feature/task
Path to feature in the web interface
Port logging: enabling port
buffering and displaying
contents of a port buffer
To enable port logging:
1. Select Configuration > Serial Ports.
2. Click a port number from the Port column.
3. Click Advanced Serial Settings.
4. Select Enable Port Logging and complete the fields.
5. Click Apply.
To display the contents of a port buffer, select Management > Serial
Ports > Connections.
Port profiles: sets of
preconfigured serial-port
settings for a particular
connection and use scenario
1. Select Configuration > Serial Ports.
2. Click a port number from the Port column.
3. Click Change Profile.
4. Select one of the following profile options and click Apply:
n
RealPort—Configure the COM port redirection. See
also the RealPort Installation Guide.
n
Console Management
n
TCP Sockets—The TCP server listens for TCP
connections on the serial port or the TCP client to
automatically establish a connection to a defined
network port. See Automatic TCP connections
(Automatic Connection).
n
UDP Sockets
n
Serial Bridge
n
Modem
n
Modem Emulation
n
Printer
n
Local Configuration
n
Custom
5. Complete the fields and click Apply.
Ethernet bridging
Ethernet bridging configuration is available only through the
command line interface. To enable Ethernet bridging, first enable the
eth1 interface (IP address #2). Then connect to the ConnectPort LTS
via serial port, ssh, or telnet and run the following command:
# service brmode start
See Ethernet bridging for more information.
Digi ConnectPort LTS User Guide
26
Getting started with ConnectPort LTS
Quick reference for configuring features
Feature/task
Path to feature in the web interface
Python support: loading and
running custom programs
authored in the Python
programming language.
Configurable from command line only. See the set python command
in the ConnectPort LTS Command Reference.
RealPort (COM port
redirection) configuration
Configuration > Serial Ports > port > Port Profile Settings >
RealPort
1. Select Configuration > Serial Ports.
2. Click a port number from the Port column.
3. Click Change Profile.
4. Select RealPort and click Apply.
5. Complete the fields and click Apply.
See also the RealPort Installation Guide.
Reverting configuration
settings
Administration > Factory Default Settings
Security/access control features:
Control access to TCP/UDP
inbound ports
1. Select Configuration > Serial Ports.
2. Click a port number from the Port column.
3. Click Change Profile.
4. Select TCP Sockets, UDP Sockets, or Custom, and click Apply.
Note When you configure a TCP/UDP server, the configuration
only applies to inbound sockets. You configure the outbound
sockets when you configure the TCP/UDP client.
5. Complete the fields and click Apply.
Secure Shell Server (SSH)
Add or modify a user's sign
in credentials
Configuration > Network > Network Service Settings > Basic
Network Services Settings > Enable Secure Shell Server (SSH)
1. Select Configuration > Users.
2. Select a user or click New user and complete the fields.
3. Click User Access and complete select the access options for
the user.
4. Click User Permissions and select the user permissions for
the user.
5. Click Group Configuration and associate a group with a user.
6. Click Upload SSH Public key and enable or disable
SSH Public Key Authentication.
Digi ConnectPort LTS User Guide
27
Getting started with ConnectPort LTS
Feature/task
Set authentication method
for port access
Quick reference for configuring features
Path to feature in the web interface
1. Select Configuration > Serial Ports.
2. Select port number under the Port column.
3. Click Authentication Settings.
Serial port configuration:
Basic serial port settings
Configuration > Serial Ports > Basic Serial Settings
Advanced serial port
settings
Configuration > Serial Ports > Advanced Serial Settings
Port profiles: associate a
serial port with a set of
preconfigured port settings
for a specific use
Configuration > Serial Ports > Port Profile Settings
RTS Toggle
Configuration > Serial Ports > Advanced Serial Settings
Port Sharing: allow a serial
port to be shared by
multiple software
applications. Supports up to
four sessions per port. Only
one session can be RealPort
1. Select Configuration > Serial Ports.
2. Click a port number from the Port column.
3. Click Change Profile.
4. Select TCP Sockets, UDP Sockets, or Custom and click Apply:
5. Complete the fields under TCP Server Settings, UDP Server
Settings, or Network Services and click Apply.
SNMP:
Configure SNMP through
the web interface
Configuration > System > Simple Network Management Protocol
(SNMP) Settings
Enable/disable SNMP
service
Configuration > Network > Network Service Settings > Basic
Network 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-specific Management Information Blocks (MIBs).
You can also configure advanced settings through SNMP.
System information: assign
systemidentifying information to a
device
Configuration > System > Device Identity Settings
Authentication configuration Configuration > System > Authentication Settings
for Web and CLI access
Statistics
Digi ConnectPort LTS User Guide
Administration > System Information
28
Getting started with ConnectPort LTS
Quick reference for configuring features
Feature/task
Path to feature in the web interface
Status information
Management > Serial Ports, Connections, Network Services
Peripheral settings:
SD Memory
Peripheral > SD Memory
USB
Peripheral > USB
Modem
Peripheral > Modem
LCD
Peripheral > LCD
XBee
Peripheral > XBee
Application settings:
PPP
Application > PPP
Python
Application > Python
RealPort
Application > RealPort
Digi ConnectPort LTS User Guide
29
ConnectPort LTS network connections and data
paths
ConnectPort LTS devices allow for several kinds of connections and paths for data flow between
ConnectPort LTS devices and other entities. You can group these connections into two main
categories:
n Network services, in which a remote entity initiates a connection to a Digi device.
n
Network/serial clients, in which a Digi device initiates a network connection or opens a serial
port for communication.
The following topics describe the effects of enabling features and selecting settings when configuring
ConnectPort LTS devices.
Network services
Network/serial clients
Digi ConnectPort LTS User Guide
31
32
30
ConnectPort LTS network connections and data paths
Network services
Network services
A network service connection occurs when a remote entity initiates a connection to a Digi device.
There are several categories of network services:
n Network services associated with specific ports
n
Network services associated with serial ports in general
n
Network services associated with the command-line interface
Network services associated with specific ports
The following list details network services associated with specific ports.
n Reverse telnet: A remote entity establishes a telnet connection to a Digi serial port. Data
passes transparently between the telnet connection and a named serial port.
n
Reverse raw socket: A remote entity establishes a raw TCP socket connection to a Digi serial
port. Data passes transparently between the socket and a named serial port.
n
Reverse TLS socket: A remote entity establishes an encrypted raw TCP socket connection to a
Digi serial port. Data passes transparently to and from a named serial port.
n
LPD: A remote entity establishes a TCP connection to a named serial port. The Digi device
interprets the LPD protocol and sends a print job out of the serial port.
n
Modem emulation, also known as pseudo-modem (pmodem): A remote entity establishes a
TCP connection to a named serial port. This connection is “interpreted” as an incoming call to
the pseudo-modem.
n
Console Mgmt: Allows a TCP connection to a serially-attached console.
n
Modem: The Modem Profile allows you to attach modem devices to the serial port to establish
or receive connections from other systems and modems. Both the modem dial-in and bidirectional options provide a login from the Digi device.
n
Reverse SSH: A remote entity establishes an SSH connection to a ConnectPort LTS serial port
and data passes transparently between the SSH connection and a named serial port.
Network services associated with serial ports in general
The following list details network services associated with serial ports in general.
n RealPort: A single TCP connection manages (potentially) multiple serial ports.
n
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.
Digi ConnectPort LTS User Guide
31
ConnectPort LTS network connections and data paths
n
Network/serial clients
rsh: ConnectPort LTS products support a limited implementation of the remote shell (rsh)
protocol, in that a single service listens to connections and allows a command to be executed.
Only one class of commands is allowed: a single integer that specifies which serial port to
connect to. Otherwise, the resulting connection is somewhat similar to a reverse telnet or
reverse socket connection.
Network services associated with the command-line interface
The following list details network services associated with the command line interface (CLI).
n SSH: Use Secure Shell (SSH) to directly access a ConnectPort LTS command-line interface.
n
Telnet: Use telnet to directly access a ConnectPort LTS command-line interface.
n
Rlogin: Perform a remote login (rlogin) to a ConnectPort LTS command-line interface.
Network/serial clients
A network/serial client connection occurs when a ConnectPort LTS product initiates a network
connection or opens a serial port for communication. There are several categories of network/serial
client connections:
n Autoconnect behavior client connections
n
Command-line interface (CLI)-based client connections
n
Modem emulation (pseudo-modem) client connections
Autoconnect behavior client connections
In client connections that involve autoconnect behaviors, a ConnectPort LTS product initiates a
network connection based on timing, serial activity, or serial modem signals. Autoconnect-related
client connections include:
n Raw TCP connection: The ConnectPort LTS initiates a raw TCP socket connection to a remote
entity.
n
Telnet connection: The ConnectPort LTS initiates a TCP connection using the telnet protocol
to a remote entity.
n
SSH connection: The ConnectPort LTS initiates a TCP connection using the SSH protocol to a
remote entity.
n
Raw TLS encrypted connection: The ConnectPort LTS initiates an encrypted raw TCP socket
connection to a remote entity.
n
Rlogin connection: The ConnectPort LTS initiates a TCP connection using the rlogin protocol
to a remote entity.
Command-line interface (CLI)-based client connections
CLI-based client connections are available for use when you establish a session with the ConnectPort
LTS product’s CLI. CLI-based client connections include:
n ssh: Allows you to connect to a remote entity using the ssh protocol.
n
telnet: Allows you to connect to a remote entity using the telnet protocol.
Digi ConnectPort LTS User Guide
32
ConnectPort LTS network connections and data paths
Network/serial clients
n
rlogin: Allows you to connect to remote entity using the rlogin protocol (bash only).
n
scp: Allows you to transfer files (bash only).
n
connect: Begin communicating with a local serial port.
Note Additional communication methods include using a bash shell such as scp, tftp, nc, or using
Python.
Modem emulation (pseudo-modem) client connections
When a port is in the modem-emulation or pseudo-modem mode, it can initiate network connections
based on AT command strings received on the serial port. See the ConnectPort LTS Command
Reference on digi.com for modem emulation AT commands.
Digi ConnectPort LTS User Guide
33
ConnectPort LTS configuration and administration
This section provides information on configuration capabilities and interfaces.
Configuration capabilities
ConnectPort LTS administration capabilities
ConnectPort LTS configuration interfaces
Digi ConnectPort LTS User Guide
35
35
35
34
ConnectPort LTS configuration and administration
Configuration capabilities
Configuration capabilities
Configuration options provide settings for the following features:
n Network Configuration: Specifies IP address settings, network service settings, and advanced
network settings.
n
Serial Ports Configuration: Specifies serial port characteristics for the device.
n
Alarms: Defines conditions that trigger alarms and notifications for alarms.
n
System Configuration: Provides system-identifying information, such as a device description,
device location, and contact information.
n
Users: Configures security features, such as enabling password authentication for device
users.
ConnectPort LTS administration capabilities
Administrative capabilities include the following:
n Uploading and managing files
n
Changing the password for logging onto the device
n
Backing up and restoring the configuration
n
Updating firmware
n
Restoring the configuration to factory defaults
n
Rebooting the module
You can perform administration tasks using a number of interfaces, including the ConnectPort LTS
web interface and command line. See Administration for more information and procedures.
ConnectPort LTS configuration interfaces
The following table lists and briefly describes ConnectPort LTS configuration interfaces.
Configuration
interface
Description
Digi Device
Discovery
Utility
Allows you to discover devices, open the web interface for a device, configure
network settings, and reboot the device. See Digi Device Discovery utility.
ConnectPort
LTS web
interface
Allows you to configure and monitor ConnectPort LTS devices. See ConnectPort
LTS web interface.
Note Not all configuration options provided by the command-line interface (CLI)
appears in the web interface. If you need to configure more advanced options, see
the Access the command-line interface for instructions on accessing the CLI.
Digi ConnectPort LTS User Guide
35
ConnectPort LTS configuration and administration
Configuration
interface
ConnectPort LTS configuration interfaces
Description
ConnectPort
LTS command
line interface
Allows you to configure ConnectPort LTS by issuing commands from the command
line. See ConnectPort LTS command-line interface.
Simple
Network
Management
Protocol
(SNMP)
Allows you to manage and monitor network devices. See Simple Network
Management Protocol (SNMP).
ConnectPort
LTS LCD panel
Allows you to configure, monitor status, and diagnose ConnectPort LTS issues. See
ConnectPort LTS LCD interface.
Digi ConnectPort LTS User Guide
36
Digi Device Discovery utility
The Digi Device Discovery utility:
n Locates Digi devices on a network
n
Allows you to open the web interface for discovered devices
n
Allows you to configure network settings and reboot the device
Download the Digi Device Discovery utility from www.digi.com/support/productdetail?pid=5574.
In addition to quickly locating devices, the utility also lists device information, such as the device
address, firmware version, and whether it has been configured. It 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 Digi devices on the network. Digi devices that support ADDP reply to the UDP multicast
with their configuration information. Even Digi devices that do not yet have an assigned IP address or
are misconfigured for the subnet can reply to the UDP multicast packet and appear in the device
discovery results.
Note Personal firewalls, Virtual Private Network (VPN) software, and certain network equipment can
block device discovery. Firewalls block UDP ports 2362 and 2363 that ADDP uses to discover devices.
You can enable or disable access to the ADDP service, but you cannot change the network port
number for ADDP.
See Use Digi Device Discovery utility to sign in to the web interface for instructions on using the utility
to sign in to the ConnectPort LTS web interface.
Digi ConnectPort LTS User Guide
37
ConnectPort LTS web interface
This section describes how to configure and manage a ConnectPort LTS device using the web
interface.
Sign in to the web interface
Home page
Apply and save changes
Cancel changes
Online help
Configuration
Peripheral
Application
Management
Administration
Digi ConnectPort LTS User Guide
39
40
41
41
41
41
88
105
118
119
38
ConnectPort LTS web interface
Sign in to the web interface
Sign in to the web interface
After you successfully assign an IP address to your device, you can sign in to the device's web interface
using either of the following:
n Web browser
n
Digi Device Discovery utility
Use a web browser to sign in to the web interface
To access the web interface for a Digi device using a browser:
1. In the web browser address bar, type the IP address of the device.
2. If you are prompted for login credentials, type the user name and password for the Digi device.
The default user name is root and the default password is dbps. If the default user name and
password do not work, contact the system administrator who set up the Digi device.
The Home page appears. See Home page for an overview of the Home page and other linked
pages.
Note If password authentication is enabled, the idle timeout automatically logs users out of
the web interface after 5 minutes of inactivity.
Use Digi Device Discovery utility to sign in to the web interface
To discover the Digi device and open the web interface:
1. Download and install the Digi Device Discovery utility from the Digi Support website.
a. From a browser, go to www.digi.com.
b. Select Support > Product Support.
c. Click Diagnostics, Utilities & MIBs.
d. Enter a keyword or select your Digi device from the product list.
e. Under Operating System Specific Utilities, choose an operating system.
f. Under Utilities or Operating System Specific Diagnostics, Utilities and MIBs,
select either Device Discovery Utility for Windows - Standalone version or
Device Discovery Utility for Windows - Installable version. The standalone
version runs the utility immediately after the download is complete. The installable
version installs the utility on your computer and adds it to a program group in the
Start menu named Digi > Digi Device Discovery.
g. Click Run on the two dialogs. The standalone version of the utility starts
immediately.
For the installable version, an installation wizard appears. Follow the prompts to
complete the installation. To start the utility, select
Start > All Programs > Digi > Digi Device Discovery > Digi Device Discovery.
Digi ConnectPort LTS User Guide
39
ConnectPort LTS web interface
Home page
2. From the Digi Device Discovery utility, locate the Digi device in the list of devices, and choose
one of the following options:
n
Double-click the Digi device to open the web interface
n
Select the Digi device from the list and select Open web interface in the Device Tasks
list
3. If you are prompted for login credentials, type the user name and password for the Digi device.
The default user name is root and the default password is dbps. If the default user name and
password do not work, contact the system administrator who set up the Digi device.
Power failure message
If either of the two power connections to the ConnectPort LTS 16 2AC fails, a power failure message is
displayed at the top of the page. For example, if the first power connection fails, the following
message is displayed:
Power 1 Failure
Home page
When you access the web interface, the Home page appears. The Home page provides a tutorial and a
system summary.
Menu
The left side of the web interface displays a menu. Use the menu to:
n Configure the Digi device, peripheral devices, and applications
n
Manage serial ports and connections
n
Administer the Digi device
Getting Started
The Getting Started section displays a link to a tutorial on configuring and managing Digi devices.
System Summary
The System Summary page displays the details for this ConnectPort LTS.
n Model: The model type for this ConnectPort LTS product.
n
IPv6 Address (Link): The IPv6 address (link) associated with this Digi device.
n
IPv6 Address (Global): The IPv6 address (global) associated with this Digi device.
n
IPv4 Address: The IPv4 address associated with this Digi device.
n
MAC Address: The MAC address associated with this Digi device.
n
Description: A description of this Digi device.
n
Contact: Contact information for the Digi device.
n
Location: The location of this Digi device.
Digi ConnectPort LTS User Guide
40
ConnectPort LTS web interface
n
Apply and save changes
Device ID: The serial number associated with this Digi device. The serial number appears on a
label on the Digi device.
Logout and Login
To sign out of a configuration and management session:
1. Click Logout. The Login page appears.
2. Close the browser window to prevent access by other users.
Note After 5 minutes of inactivity, the idle timeout automatically performs a user logout.
To sign in to the device:
n Enter your user credentials on the Login page and click Login.
Apply and save changes
The web interface runs locally on the Digi device, which means that the interface always maintains
and displays the current settings in the Digi device. When you change the configuration settings, click
Apply to save your changes to the Digi device.
Cancel changes
To cancel changes to configuration settings, click the Refresh or Reload button on the web browser.
The browser reloads the page. Any changes made since the last time you clicked Apply are reset to
their original values.
Online help
The web interface provides online help for all pages. The Home page provides a tutorial.
Configuration
Use the options under Configuration to configure settings for various features, such as network
settings and serial port settings.
Network Configuration
The Network Configuration page includes:
n IP settings: For viewing IP address settings and changing as needed. See IP Settings for more
information.
n
Network Services settings: Configure access to various network services, such as ADDP,
RealPort and Encrypted RealPort, telnet, SSH, HTTP/HTTPS, and other services. See Basic
Network Services Settings for more information.
n
Socket Tunnel settings: Configure a socket tunnel used to connect two network devices: one
on the ConnectPort LTS device’s local network and the other on the remote network. See
Socket Tunnel Settings for more information.
Digi ConnectPort LTS User Guide
41
ConnectPort LTS web interface
n
Configuration
Advanced Network Settings: Configure the Ethernet Interface speed and mode, IP settings,
TCP keepalive settings, and DHCP settings. See Advanced Network Settings for more
information.
n
IP Filtering Settings: Configure the built-in firewall functionality to limit IP traffic to and from
certain networks, TCP or UDP ports, and interfaces. This feature is based on Linux tool
iptables. See IP Filtering Settings for more information.
IP Settings
The IP Settings page allows you to configure how to obtain the IP address of the ConnectPort LTS
device. You can use one of the following methods to obtain the IP address:
n DHCP
n
Static IP address
n
Subnet mask
n
Default gateway
Note Changes to DHCP, IP address, subnet mask, and DNS may effect your browser connection.
In addition, this page displays the IP addresses of the primary and secondary Domain Name System
(DNS) server for the ConnectPort LTS device. For more information on how to assign and use these
settings in your organization, contact your network administrator.
ConnectPort LTS has two Ethernet interfaces and you can enable or disable each interface separately.
Each interface has following settings:
n
IPv4: Internet Protocol version 4 configuration.
l
Do not use this interface: Choose this option if you do not want to enable IPv4 address
on this Ethernet interface.
l
Obtain an IP address automatically using DHCP: Choose this option if you want to
obtain new network settings after you reboot the ConnectPort LTS device.
l
Use the following IP address: Choose this option to supply a static IP address. You must
provide the IP address and subnet mask. Other items are not mandatory, but may be
needed for some functions (such as talking to other networks).
l
IP Address: The IP address for the ConnectPort LTS device. The IP address is a 4-part id
assigned to network devices. IP addresses are in the form of 192.168.2.2, where each
number is between 0 and 255.
l
Subnet Mask: The subnet mask for the ConnectPort LTS device. A common subnet mask is
255.255.255.0.
l
Gateway: The IP address of the computer that enables the ConnectPort LTS device to
access other networks, such as the Internet.
Digi ConnectPort LTS User Guide
42
ConnectPort LTS web interface
n
Configuration
IPv6: Internet Protocol version 6 configuration.
l
Do not use this interface: Choose this option if you do not want to enable IPv6 address
on this Ethernet interface.
l
Auto configuration: Choose this option if you want to set IPv6 address through the
stateless autoconfiguration protocol.
l
Obtain an IP address automatically using DHCP: Choose this option if you want to set
IPv6 address through DHCPv6.
l
Use the following IP address: Choose this option to supply a static IPv6 address.
l
IP address: The IPv6 address for the ConnectPort LTS device. The IPv6 addresses are
normally written as eight groups of four hexadecimal digits, where each group is
separated by a colon (:).
For example, IPv6 addresses are in the form of
2001:0db8:85a3:0000:0000:8a2e:0370:7334
And you must enter an IPv6 address with an IPv6 prefix length of the network. IPv6
network is written in CIDR notation which is separated by a slash "/" to IPv6 address.
For example, an IPv6 address connected to a /64 subnet is written
2001:0db8:85a3:0000:0000:8a2e:0370:7334/64.
l
Gateway: The IPv6 address of the computer that enables this ConnectPort LTS device to
access other networks, such as the Internet.
l
Use 6to4 tunneling: Choose this option to supply 6to4 Tunneling which consists of
encapsulating IPv6 packets within IPv4; in effect using IPv4 as a link layer for IPv6 so that
the ConnectPort LTS device can reach the remote IPv6 Internet through the existing IPv4
infrastructure.
l
IPv4 address of the remote 6to4 relay: Set the IPv4 address of the remote 6to4 relay
server.
l
Overwrite local IPv4 address: Set the public IPv4 address that you want to use for 6to4
tunneling. This is the public IPv4 address. If it is not set, the current IPv4 address of
ConnectPort LTS will be used.
n
DNS: Set the IP address of the Domain Name Server (DNS) used to resolve computer host
names to IP addresses. The DNS servers are specified independently of any network interface
and its connection state. An IP address of 0.0.0.0 indicates no server is specified.
l
Use Manual DNS: Choose this option if you want to set DNS configuration manually.
l
Primary DNS: Set the IP address of primary DNS.
l
Secondary DNS: Set the IP address of secondary DNS.
Digi ConnectPort LTS User Guide
43
ConnectPort LTS web interface
n
Configuration
Source Based Routing: Choose this option to if you have two routers (gateways) in your
network and you want each interface to use a different router. For example, if you enable this
option, any traffic that originates from the IP address of Ethernet interface 2 (replies to traffic
that came in Ethernet interface 2), will be routed back out through the same Ethernet
interface 2. Please note that this option applies only to Ethernet interface 1 and 2 by default.
l
n
Enable Local Routing: Select this option to enable local routing.
Network Bonding: Use the link aggregation feature to aggregate one or more Ethernet
interfaces to form a logical point-to-point link, known as a LAG (link aggregation groups), virtual
link, or bundle. The MAC client can treat this virtual link like a single link. Network Bonding
implements 802.3ad.
l
Do not use this interface: Choose this option if you do not want to enable network
bonding on this Ethernet interface.
l
Obtain an IP address automatically using DHCP: Choose this option if you want to
obtain new network settings after you reboot the ConnectPort LTS device.
l
Use the following IP address: Choose this option to manually enter static IP address
settings.
l
Subnet Mask: The subnet mask for the ConnectPort LTS device. A common subnet mask is
255.255.255.0.
l
Gateway: The IP address of the computer that enables the ConnectPort LTS device to
access other networks, such as the Internet.
Basic Network Services Settings
The Basic Network Services Settings 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.
You can enable and disable common network services and configure the TCP/UDP port on which the
network service listens. You can disable services as needed for security purposes. That is, you can
disable certain services so the device runs only those services specifically needed. To improve device
security, you can disable non-secure services such as telnet.
Best practice Use the default network port numbers for basic network services because the port
numbers are used by most applications.
CAUTION! Exercise caution when enabling and disabling network services, particularly
disabling them. Changing certain settings can render a Digi Connect device inaccessible.
For example, disabling Advanced Digi Discovery Protocol (ADDP) prevents a network
from discovering the device, even if it is actually connected. Disabling HTTP and HTTPS
disables access to the web interface. Disabling basic services such as telnet, rlogin, and
so on makes the Command-Line interface inaccessible.
Supported basic network services and their default port numbers
For Digi devices with 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
Digi ConnectPort LTS User Guide
44
ConnectPort LTS web interface
Configuration
The assumed default base 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.
If you change a network port for a particular service, that is the only network port number that
changes. That change does not carry over to the other network ports. For example, if you change the
network port number for telnet passthrough from 2001 to 3001, that does not mean that the other
network ports will change to 3002, 3003, etc.
There are two types of network services available:
n Basic services: You can access these services by connecting to a particular well-known
network port.
n
Passthrough services: You can set up a specific type of service for a specific serial port. To use
the service, you must use the correct protocol and specify the correct network port. For
example, assuming default service ports and using a Linux host, here is how a user would
access the SSH and telnet passthrough services on port 1:
#> ssh -l fred digi16 -p 2501
#> telnet digi16 2101
The following table shows the network services, services provided, and the default network port
number for each service.
Service
Services provided
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. You cannot
change the network port number for ADDP from
its default.
Default network
port number
2362
Encrypted (Secure) RealPort Secure Ethernet connections between COM or
1027
TTY ports and device servers or terminal servers.
RealPort
A virtual connection to serial devices no matter
where they reside on the network.
771
Line Printer Daemon (LPD)
Allows network printing over a serial port.
515
Modem Emulation Pool
(pmodem)
Allows the Digi device to emulate a modem.
Modem emulation sends and receives modem
responses to the serial device over the Ethernet
instead of Public Switched Telephone Network
(PSTN). You can enable or disable telnet
processing on the incoming and outgoing
modem-emulation connections. The pmodem
service is for connecting to whatever serial port
will answer.
50000
Modem Emulation
Passthrough
Allows the Digi device to emulate a modem. This
service is for dialing in to a particular serial port
that has been set up for modem emulation.
50001
Digi ConnectPort LTS User Guide
45
ConnectPort LTS web interface
Configuration
Default network
port number
Service
Services provided
Remote login (rlogin)
Allows users to sign in to the Digi device and
access the command-line interface through
rlogin.
513
Remote shell (Rsh)
Allows users to sign in to the Digi device and
access the command-line interface through Rsh.
514
Secure Shell Server (SSH)
Allows users secure access to sign in to the Digi
device and access the command-line interface.
22
Secure Shell (SSH)
Passthrough
Accessing a specific serial port set up for SSH.
2501
Secure Socket Service
Authentication and encryption for Digi devices.
2601
Simple Network
Management Protocol
(SNMP)
Managing and monitoring the Digi device. To run 161
SNMP in a more secure manner, SNMP allows for
set commands to be disabled. This securing is
done in SNMP itself, not through Network
Services settings. If disabled, SNMP services
such as traps and device information are not
used.
Telnet Server
Allows users an interactive telnet session to the
Digi device’s command-line interface. If disabled,
users cannot telnet to the device.
23
Telnet Passthrough
Allows a telnet connection directly to the serial
port, often called reverse telnet.
The format for this port number is as follows:
2001
20<serial port number>
Replace <serial port number> with the Digi serial
port number. For example, 2001 applies to serial
port 1, 2010 applies to serial port 10, and 2016
applies to serial port 16.
Transmission Control
Protocol (TCP) Echo
Used for testing the ability to send and receive
over a TCP connection, similar to a ping.
7
Transmission Control
Protocol (TCP) Passthrough
Allows a raw socket connection directly to the
serial port, often called reverse sockets.
The format for this port number is as follows:
2101
21<serial port number>
Replace <serial port number> with the Digi serial
port number. For example, 2101 applies to serial
port 1, 2110 applies to serial port 10, and 2116
applies to serial port 16.
Digi ConnectPort LTS User Guide
46
ConnectPort LTS web interface
Configuration
Default network
port number
Service
Services provided
User Datagram Protocol
(UDP) Echo
Used for testing the ability to send and receive
over a UDP connection, similar to a ping.
User Datagram Protocol
(UDP) Passthrough
Allows raw data to be passed between the serial 2101
port and UDP datagrams on the network.
The format for this port number is as follows:
7
21<serial port number>
Replace <serial port number> with the Digi serial
port number. For example, 2101 applies to serial
port 1, 2110 applies to serial port 10, and 2116
applies to serial port 16.
Web Server, also known as
You can establish secure access to configuration
HyperText Transfer Protocol web pages by requiring a user to sign in. HTTP
(HTTP)
and HTTPS are also called Web Server or Secure
Web Server. These services control the use of
the web interface. If HTTP and HTTPS are
disabled, device users cannot use the web
interface to configure, monitor, and administer
the device.
80
Secure Web Server, also
known as HyperText
Transfer Protocol over
Secure Socket Layer
(HTTPS)
443
You can secure access to configuration web
pages by requiring a user to sign in with
encryption for greater security.
Advanced Network Services Settings
The Advanced Network Services Settings page shows a set of specific network services that are
available for ConnectPort LTS products, and the related settings for the service.
n
Web Settings:
l
Login timeout (0-1440 minutes, 0 for unlimited): Idle timeout settings in minutes for
the Web server. The Digi device prompts the user to log in again if the user tries to use the
web interface after login timeout has expired. If you set this value 0, the web login will not
expire.
Digi ConnectPort LTS User Guide
47
ConnectPort LTS web interface
n
Configuration
SMTP Settings:
l
Enable SMTP service: When enabled, the Digi device can send an email notification when
an alarm occurs.
l
SMTP server name: IP address or DNS name of the SMTP server.
l
SMTP with authentication: Choose this option if your SMTP server requires a user name
and password.
l
SMTP without authentication: Choose this option if your SMTP server does not require a
user name and password.
l
POP before SMTP: Choose this option if you want to access your SMTP server after you
successfully log in to POP service.
l
SMTP user name: The user name for your SMTP (or POP) server.
l
SMTP password (new)/(confirm): The password for your SMTP (or POP) server.
l
Device mail address: The email address used to send alarms. Most SMTP servers check
the sender's email address with the host domain name to verify the address as authentic.
Consequently, when assigning an email address for the device email address, any arbitrary
username with the registered hostname may be used. An example is
username@company.com.
Digi ConnectPort LTS User Guide
48
ConnectPort LTS web interface
n
Configuration
NFS Settings:
l
Enable NFS service: When enabled, the Digi device can log port data to an NFS server.
l
NFS server name: IP address or domain name of the NFS server.
l
Mounting path on NFS server: The path to where the files are located on the NFS server.
l
NFS timeout (5-3600 seconds): The timeout value in seconds to disconnect the Digi
device from the NFS connection when the NFS server is not responding. If there is no
response form the NFS server during the NFS timeout interval, The Digi device releases
(unmount) a local directory which is mounted to the directory of NFS server (mounting
path on NFS server).
l
NFS mount retrying interval (5-3600 seconds): The retrying interval in seconds before
the Digi device attempts an NFS remount again after disconnecting an NFS connection.
The Digi device checks whether connecting to the NFS server is possible for every NFS
mount retrying interval. And if connection to NFS server is possible, the Digi device
remounts mounting path on NFS server on its local directory again and changes data
logging location to NFS server automatically if it is needed.
l
Alert Settings:
o
Description: A description of the alert that will be sent to the receiver.
o
Send E-mail alert to the following recipients for NFS disconnection: Send an
email alert if selected.
o
Subject: The title of the email alert.
o
To: The primary recipient of the email alert.
o
CC: The secondary recipient of the email alert.
o
Priority: Select one of the following priority options for this email alert: Normal or
High.
l
Send NFS disconnection trap when alarm occurs: When selected, sends an SNMP trap
when an alarm occurs.
Digi ConnectPort LTS User Guide
49
ConnectPort LTS web interface
n
Configuration
Samba Settings:
l
Enable Samba service: When enabled, the Digi device can log port data to a Samba server.
l
Samba server name: IP address or domain name of the Samba server.
l
Mounting on path Samba server: The path to where the files are located on the Samba
server.
l
Samba timeout (5-3600 seconds): Timeout interval in seconds before the Digi device
disconnects Samba connection when the Samba server is not responding. If there is no
response form the Samba server during the Samba timeout interval, the Digi device
releases (unmount) a local directory which is mounted to the directory of the Samba
server (mounting path on Samba server).
l
Samba mount retrying interval (5-3600 seconds): Retrying interval in seconds when the
Digi device tries to connect to the Samba server again after disconnecting the Samba
connection. The Digi device checks whether connecting to the Samba server is possible for
every Samba mount retrying interval. If connection to the Samba server is possible, the
Digi device remounts mounting path on the Samba server on its local directory again and
changes data logging location to Samba server automatically if it is needed.
l
Samba server user: The user name for your Samba server.
l
Samba server password (new)/(confirm): The password for your Samba server.
l
Alert Settings :
o
Description: A description of the alert that will be sent to the receiver.
o
Send E-mail alert to the following recipients for Samba disconnection: When
selected, sends an email alert when an alarm occurs.
o
Subject: The subject line of the e-mail notification and the description of the SNMP trap
when an alarm is triggered.
o
To: The email address of the primary recipient of email alert.
o
CC: (Optional) The email address of the secondary recipient of email Alert.
o
Send Samba disconnection trap when alarm occurs: When selected, sends an SNMP
disconnection trap when an alarm occurs.
o
Priority: Select one of the following priority options for this email alert: Normal or High.
o
Send Samba disconnection trap when alarm occurs: When selected, sends an Samba
disconnection trap when an alarm occurs.
Digi ConnectPort LTS User Guide
50
ConnectPort LTS web interface
n
Configuration
SYSLOG settings:
l
Enable SYSLOG service: When selected, the Digi device can log port data to the SYSLOG
server.
l
SYSLOG server name: IP address or domain name of the SYSLOG server.
l
SYSLOG Facility: The Digi device supports SYSLOG facilities from local0 to local7. You can
employ these facilities to save messages from the Digi device separately to the SYSLOG
server.
Socket Tunnel Settings
You can use a socket tunnel 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. The
ConnectPort LTS product then opens a separate connection to the specified destination host. Once
the tunnel is established, the ConnectPort LTS product acts as a proxy for bi-directional data between
the remote network socket and the local network socket, regardless of which end initiated the
tunnel.
Socket tunnel settings include:
n Enable: Enables or disables the configured socket tunnel.
n
Timeout (seconds): The timeout, specified in seconds, controls how long the tunnel will
remain connected when there is no tunnel traffic. If the timeout value is zero, then no timeout
is in effect and the tunnel will stay up until some other event causes it to close.
n
Initiating Host: The hostname or IP address of the network device which will initiate the
tunnel. This field is optional.
n
Initiating Port: Specify the port number that the Digi device product will use to listen for the
initial tunnel connection.
n
Initiating Protocol: The protocol used between the device that initiates the tunnel and the
Digi device server. Currently, TCP and SSL are the two supported protocols.
n
Destination Host: The hostname or IP address of the destination network device.
n
Destination Port: The port number that the Digi device will use to make a connection to the
destination device.
n
Destination Protocol: The protocol used between Digi device and the destination device.
Currently, TCP and SSL are the two supported protocols. This protocol does not need to be the
same for both connections.
n
Click Add to add a socket tunnel. Click Apply to save the settings. Once the socket tunnel is
configured, select the Enable check box to enable the socket tunnel.
Advanced Network Settings
The Advanced Network Settings define the network interface. These settings rarely need to be
changed. Contact your network administrator for more information about these settings.
Digi ConnectPort LTS User Guide
51
ConnectPort LTS web interface
n
Configuration
IP Settings:
l
Host name: The host name that will appear the DHCP Option 12 field. The host name can
be a single name or a fully qualified domain name (FQDN). You can use this optional setting
only when you enable DHCP.
Note If you change the host name, you must sign in to the web interface again.
l
Enable Auto IP address assignment: Auto Private IP Addressing (APIPA), also known as
Auto-IP: A standard protocol that automatically assigns an IP address from a reserved pool
of standard Auto-IP addresses to the computer on which it is installed. The device is set to
obtain its IP address automatically from a DHCP server. If the DHCP server is unavailable
or nonexistent, Auto-IP assigns the device an IP address if one of the following instances
are true:
o
You enabled DHCP or it responds later
o
You are using ADDP/Device Discovery
Both will override the previously assigned Auto-IP address.
l
Reuse old IP at bootup time on DHCP failure: If the Digi device fails to receive an IP
address from the DHCP server on booting up, the users can set the IP configurations of the
Digi device with the previous IP configurations and connect it to the network.
n
Ethernet interface: You can set the speed and duplex mode of each Ethernet interface.
l
Speed: Specify the Ethernet speed of the Digi device. Your options are as follows: Auto, 10
Mbit, 100 Mbps, or 1000 Mbps.
l
Mode: Specify the duplex mode of the Ethernet interface. Your options are as follows: Auto,
Half-duplex, or Full-duplex. Note that you cannot manually set the duplex mode if the
speed is set to Auto.
n
TCP keep-alive settings: The DHCP server assigns these network settings, unless you
manually set them here.
l
Idle Timeout: The period of time that a TCP connection can remain idle before sending a
keep-alive.
l
Probe Interval: The time in seconds between each keep-alive probe.
l
Probe Count: The number of times TCP probes the connection to determine if it is alive
after activating the keep-alive option. The connection is assumed to be lost after sending
this number of keep-alive probes.
IP Filtering Settings
The Digi device offers built-in firewall functionality to limit TCP/IP traffic to and from certain networks,
TCP ports, and interfaces. The functionality implemented is based on the Linux tool iptables.
You can restrict your Digi device on the network by only allowing certain devices or networks to
connect. This is better known as IP Filtering or Access Control Lists (ACL). By enabling IP filtering, you
are telling the Digi device to only accept connections from specific and known IP addresses or
Digi ConnectPort LTS User Guide
52
ConnectPort LTS web interface
Configuration
networks. You can filter devices on a single IP address or restrict device to a group of devices using a
subnet mask that only allows specific networks to access to the device.
CAUTION! Plan and review your IP filtering settings before applying them. If the settings
are incorrect, the Digi device will be inaccessible from the network.
The settings for IP Filtering Settings include:
n Interface: The name of the network interface where the packet originated.
n
Option: Determines the rule that will be applied to the specified IP address/mask or its
inverse.
n
IP address/Mask: Specifies the host range by entering the base host IP address followed by a
forward slash (/) and subnet mask.
n
Protocol: The type of protocol this port will accept or drop.
n
Port: A TCP/IP port on the Digi device that other hosts will access.
n
Chain: Determines whether or not hosts can access the port.
Serial Ports Configuration
Use the Serial Ports Configuration page to establish a port profile for each serial port on the
ConnectPort LTS product. The Serial Ports Configuration 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 and advanced serial settings.
The Serial Port Configuration page includes:
n Port Group Settings: This pane allows you to create one or more port groups and assign ports
to each port group. See Port Group Settings for more information.
n
Port Settings: This pane lists the available ports and allows you to configure or copy selected
ports. See Port Settings for more information.
Port Group Settings
You can create port groups to send data to multiple ports. Instead of sending data to individual serial
ports, you can send data 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.
To configure a port group, you must create a port group first and then select ports to be associated
with this group. You can create a maximum number of 16 port groups and a port cannot be associated
with multiple groups. When you select ports to be associated with a group you can also configure
following settings:
n No.: The group number.
n
Group name: The name of the group.
n
Ports: Lists the ports associated with the group.
When you click Add, the following settings appear:
n Group name: The name of the group.
n
Check all/Uncheck all: Select or clear the check boxes for all ports.
Digi ConnectPort LTS User Guide
53
ConnectPort LTS web interface
n
Configuration
Port #<number>: Select or clear the check box associated with the port. When you select a
check box, the port will be assigned to the group.
n
Show data from all ports associated with same port group: When selected, user can see
the data from other ports in the same group from a terminal connected to the one of serial
ports in the group. You can control the pattern of data from other ports in the same group.
l
Send after the following number of bytes: Send the data to the other ports in the same group
after the specified number of bytes has been received on the serial port. You can specify 1 to 4096
bytes. Default is 1024 bytes.
l
Send after the following number of idle milliseconds: Send the data to the other ports in the
same group after the specified number of idle time has been passed with no additional data
received on the serial port. You can specify 1 to 65,535 milliseconds. Default is 1000 milliseconds.
Port Settings
n
Port: Lists the available port. To view or configure the port settings, click the port number. See
Port Profile Settings for more information.
n
Description: A brief description of the port.
n
Profile: The profile assigned to the port. See Select Port Profile for more information on
available port profile options.
n
Serial Configuration: Displays the serial configuration associated with the port.
n
Action: Select to perform allowable actions on this entry. The only allowable action is to copy
the port settings for this port to other ports. See Copy Serial Port Settings for more
information.
Select Port Profile
The Select Port Profile page appears when you click Change Profile on the Port Profile Settings
pane.
A port profile allows you to easily configure a serial port based on how you intend to use that port. By
selecting one of the pre-defined profiles, the configuration options are focused only on the settings
required for that particular profile.
The ConnectPort LTS supports the following port profiles:
n
Console Management: Manage a serial device's console port over a network connection. The
Console Management profile allows you to access a Digi device's console port over a network
connection. Most network devices such as routers, switches, and servers offer one or more
serial ports for management. Instead of connecting a terminal to the console port, cable the
console port to the serial port of the ConnectPort LTS product. Then using TCP/IP utilities like
reverse telnet, network administrators can access these consoled serial ports from the LAN.
Digi ConnectPort LTS User Guide
54
ConnectPort LTS web interface
Configuration
See Assign a profile to a serial port for more information.
n
Custom: The Custom profile is an advanced option to allow full configuration of the serial port.
Use the Custom profile only if the serial port does not fit into any of the predefined port
profiles. For example, when network connections involve a mix of TCP and UDP sockets. In
ConnectPort LTS, the Custom profile also allows the access of a serial port through RealPort
protocol. See Assign a profile to a serial port for more information.
n
Local Configuration: The Local Configuration profile allows you to sign in and access the
command line interface when connecting directly to a serial port on a Digi device. This profile
provides a login from the Digi device. See Assign a profile to a serial port for more information.
n
Modem: The Modem profile allows you to attach modem devices to the serial port to establish
or receive connections from other systems and modems.
Modem dial-in and bi-directional options provide a login from the Digi device. See Assign a
profile to a serial port for more information.
n
Modem Emulation: The Modem Emulation profile allows you to configure the serial port to act
as a modem. The Digi device server emulates modem responses to a serial device and
seamlessly sends and receives data over an Ethernet network instead of a PSTN (Public
Switched Telephone Network). This allows you to retain legacy software applications without
modification and use a less expensive Ethernet network in place of public telephone lines. See
Assign a profile to a serial port for more information.
n
Printer: The Printer profile allows you to connect a printer to the serial port. Use this profile if
you intend to print using the LPD protocol on your system. See Assign a profile to a serial port
for more information.
Digi ConnectPort LTS User Guide
55
ConnectPort LTS web interface
n
Configuration
RealPort: Use RealPort to map a COM or TTY port to this serial port of your Digi device. The
COM/TTY port appears and behaves as a local port to the PC or server. RealPort is also known
as COM Port Redirection. See Assign a profile to a serial port for more information. Refer to the
RealPort Setup Guide for instructions on installing and configuring the RealPort driver on your
PC or server.
When you configure a RealPort profile, the ConnectPort LTS product relinquishes control of the
serial port to the host that has the RealPort driver installed. The computer applications send
data to this virtual COM or TTY port and the RealPort driver sends the data across the network
to the corresponding serial port on the ConnectPort LTS product.
The network is transparent to both the application and the serial device.
Important Install and configure the RealPort software on each computer that uses RealPort
ports. You can download and install the RealPort software from the Digi Support site. See
Assign a profile to a serial port for installation instructions. You need to configure the RealPort
software with the IP address of the ConnectPort LTS product.
n
Serial Bridge: The Serial Bridge Profile configures one side of a serial bridge. A bridge connects
two serial devices over the network as if they were connected with a serial cable. This is also
referred to as serial tunneling. Each serial device is connected to the serial port of a Digi device
server. You must configure one Digi device as the client and the other Digi device as the server.
This profile configures each side of the bridge separately.
See Assign a profile to a serial port for more information.
Digi ConnectPort LTS User Guide
56
ConnectPort LTS web interface
n
Configuration
TCP Sockets: Auto-Connect (TCP client) to another host on the network or allow incoming
connections on this serial port (TCP server). 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.
The TCP client will establish a TCP connection to a defined IP address and port number.
See Assign a profile to a serial port for more information.
n
UDP Sockets: Allows the automatic distribution of serial data from one host to many devices at
the same time. 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. See Assign a profile to a serial port for more information.
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.
See Assign a profile to a serial port for more information.
Not all port profiles are supported in all products. Supported port profiles varies by ConnectPort LTS
model. If a profile listed in this description is not available on the page, it is not supported in the
ConnectPort LTS product.
If you selected a port profile, the port number associated with the port profile appears at the top of
the page. You can change or retain the profile and adjust individual settings.
Everything displayed on the Serial Ports Configuration page between Port Profile Settings and the
links to the Basic Serial Settings and Advanced Serial Settings depends on the selected port profile.
Assign a profile to a serial port
To assign a profile to a serial port:
1. Select Configuration > Serial Ports.
2. Click a port number from the Port column.
3. Click Change Profile.
4. On the Select Port Profile page, select a port profile option and then click Apply.
Digi ConnectPort LTS User Guide
57
ConnectPort LTS web interface
Configuration
5. Complete the steps based on the selected profile option:
n
Console Management: Most network devices such as routers, switches, and servers
offer one or more serial ports for management. Instead of connecting a terminal to the
console port, cable the console port to the serial port of your Digi device server. Then
using TCP/IP utilities like reverse telnet, network administrators can access these
consoled serial ports from the LAN.
a. Record the TCP (or SSH) port number listed under TCP Server Settings. You
will need the TCP port number when configuring an application or device
that accesses the serial port from the network.
b. To log inbound serial data, click Advanced Serial Settings, select Enable
port logging, and then click Apply.
c. Click Basic Serial Settings, complete the fields to match the settings of the
attached serial device, and then click Apply.
Note Configure the application or device that initiates communication to the serial port
from the network with the following information:
n
l
IP address of this Digi device server.
l
TCP or (SSH) port number for the serial port recorded above in Step a.
Local Configuration (Console Port): Click Basic Serial Settings, complete the fields to
match the settings of the attached serial device or terminal, and then click Apply.
n
Custom: Complete the fields under Serial Port Configuration and then click Apply.
n
Modem: To accommodate environments where the ConnectPort LTS is not available on
the network (for security purposes) or to allow access when a network outage occurs,
use externally attached serial modems for out-of-band management.
a. Select Incoming Connection or Outgoing Connection (or Network Bridge
Connection... if bi-directional).
b. Select Enable PPP Connections on this Modem if you want to establish a
PPP connection.
c. Click Apply.
d. Click Basic Serial Settings and configure these settings to match the
settings of the attached modem. In a typical configuration, you should set
the baud rate should be set to 115200 and set flow control to Hardware.
e. Click Apply.
Digi ConnectPort LTS User Guide
58
ConnectPort LTS web interface
n
Configuration
Modem Emulation: Click Basic Serial Settings, complete the fields to match the
settings of the attached serial device and then click Apply.
Modem emulation enables a system administrator to configure the serial port to act as
a modem. The Digi device server emulates modem responses to a serial device and
seamlessly sends and receives data over an Ethernet network instead of a PSTN (Public
Switched Telephone Network). The advantage for a user is the ability to retain legacy
software applications without modification and use a less expensive Ethernet network
in place of public telephone lines.
n
Printer: Verify that the Basic Serial Settings match the settings of your serial printer
and then click Apply. See Using LDP protocol for more information.
n
RealPort: COM port redirection is provided with the RealPort software installed on your
network-based computer. RealPort creates a virtual COM port on your computer. When
your computer applications send data to this virtual COM or TTY port, RealPort sends
the data across the network to the Digi device server. The Digi device server routes the
data to the serial device connected to its serial port. The network is transparent to both
the application and the serial device.
Prerequisite RealPort software must be installed on each computer that you want to
connect to. See Install RealPort software for more information.
RealPort will set the serial port settings as directed by the computer application, so
there is no need to modify the Basic Serial Port Settings.
Digi ConnectPort LTS User Guide
59
ConnectPort LTS web interface
n
Configuration
Serial Bridge: A bridge connects two serial devices over the network as if they were
connected with a serial cable. This is also referred to as serial tunneling. Each serial
device is connected to the serial port of a Digi device server. Configure one Digi device
as the TCP server and the other Digi device as the TCP client. Once you establish a
connection between the two Digi devices the communication is bi-directional.
To assign a Serial Bridge (Serial Tunneling) to a serial port on a Digi device acting as the
TCP client (which initiates the connection to the TCP server):
a. Select Initiate serial bridge to the following device and provide the
following information:
l
Type the IP Address of the other Digi device server.
l
In the TCP Port field, type the Raw TCP port number for the destination
serial port. If the serial port is the first or only port on the device server,
the value is 2101.
b. Click Apply to save the configuration.
c. Click Basic Serial Settings, complete the fields to match the settings of the
attached serial device and then click Apply.
Follow the same steps to configure the Digi device server on the other side of the
bridge, with the following exceptions:
l
Select Allow other devices to initiate serial bridge. The default TCP Port rarely
needs to be changed.
l
Clear the Initiate serial bridge to the following device check box.
Digi ConnectPort LTS User Guide
60
ConnectPort LTS web interface
n
Configuration
TCP Sockets for TCP client (Automatic Connection): In a TCP client configuration, the
Digi device server automatically establishes a TCP connection to an application or
network device. See Automatic TCP connections (Automatic Connection) for more
information.
To assign a TCP Client (Automatic Connection) profile to a serial port:
a. Under TCP Client Settings, select the Automatically establish
TCP connections check box.
b. Select the Connect option that describes when the TCP connection will be
initiated.
c. Type the IP address or DNS name of the destination server in the Server
(name or IP) field.
d. Select one of the following options from the Service drop-down list:
Digi ConnectPort LTS User Guide
l
Raw TCP
l
Rlogin
l
Secure Sockets
l
Telnet
l
SSH
61
ConnectPort LTS web interface
Configuration
e. Specify the destination TCP port number in the TCP Port field. The port
number depends on the conventions used on the remote server or device.
The following table provides the common TCP port number conventions.
Connection Service
Common TCP Port Number
Telnet
23
Rlogin
513
Reverse Telnet to the port of the
2001
Digi device server
The format for this port number is
as follows:
20<serial port number>
Replace <serial port number> with
the Digi serial port number. For
example, 2001 applies to serial port
1, 2010 applies to serial port 10, and
2016 applies to serial port 16.
Raw connection to the port of the
2101
Digi device server
The format for this port number is
as follows:
21<serial port number>
Replace <serial port number> with
the Digi serial port number. For
example, 2101 applies to serial port
1, 2110 applies to serial port 10, and
2116 applies to serial port 16.
f. Click Apply to save the configuration.
g. Click Basic Serial Settings, complete the fields to match the settings of the
attached serial device or terminal, and then click Apply.
Digi ConnectPort LTS User Guide
62
ConnectPort LTS web interface
n
Configuration
TCP Sockets for TCP server: A TCP Server configuration allows other network devices
to initiate a TCP connection to the serial device attached to a serial port of the Digi
device server. This is also referred to as reverse telnet, console management or device
management.
a. Record the TCP (or SSH) port number listed under TCP Server Settings. You
will need the TCP port number when configuring an application or device
that accesses the serial port from the network.
b. Click Basic Serial Settings, complete the fields to match the settings of the
attached serial device or terminal, and then click Apply.
Note Configure the application or device that initiates communication to the serial port
from the network with the following information:
n
l
IP address of this Digi device server.
l
TCP or (SSH) port number for the serial port recorded above in Step a.
UDP Sockets for UDP client (data distribution): UDP client configuration allows the
automatic distribution of serial data from one host to many devices at the same time
using UDP sockets. This is also referred to this as UDP Multicast.
a. Under UDP Client Settings, provide the following information for each UDP
destination:
l
A description of the destination.
l
The destination IP Address or DNS name.
l
The destination UDP port.
When finished, click Add.
b. Select the options that define when to send data and click Apply.
c. Click Basic Serial Settings, complete the fields to match the settings of the
attached serial device or terminal, and then click Apply.
n
UDP Sockets for a UDP server:
a. Record the UDP port number listed under UDP Server Settings. You will
need the UDP port number when configuring an application or device that
accesses the serial port from the network.
b. Click Basic Serial Settings, complete the fields to match the settings of the
attached serial device, and then click Apply.
Note Configure the application or device that initiates communication to the serial port
from the network with the following information:
l
IP address of this Digi device server.
l
UDP port number for the serial port recorded above in Step 5.
Digi ConnectPort LTS User Guide
63
ConnectPort LTS web interface
Configuration
Using LDP protocol
The following list provides tips for configuring the print spooler on your system when you intend to
print using the LPD protocol to a printer attached to device server:
n Banner pages are not supported.
n
The device server’s DNS name or IP address is the remote system’s name.
n
Queue names must conform to the following conventions:
lp[port#]
For example :
lp1(port 1), lp2(port 2)
Note Ensure the LDP service is enabled in the Network Services Settings. See Basic Network Services
Settings for more information.
Automatic TCP connections (Automatic Connection)
The TCP Client allows the ConnectPort LTS product to automatically establish a TCP connection to an
application or a network, known as autoconnection. You can enable autoconnection through the TCP
Sockets profile’s setting labeled Automatically establish TCP connections.
TCP and UDP network port numbering conventions
Digi devices use the following conventions for TCP and UDP network port numbering:
For this connection type...
Use this Port
Telnet to the serial port
The format for this port number is as follows:
2001 (TCP only)
20<serial port number>
Replace <serial port number> with the Digi serial
port number. For example, 2001 applies to serial
port 1, 2010 applies to serial port 10, and 2016
applies to serial port 16.
Raw connection to the serial port
The format for this port number is as follows:
2101 (TCP and UDP)
21<serial port number>
Replace <serial port number> with the Digi serial
port number. For example, 2101 applies to serial
port 1, 2110 applies to serial port 10, and 2116
applies to serial port 16.
The application or ConnectPort LTS device that initiates communication must use these network
ports numbers. If you cannot configure the application or ConnectPort LTS product to use these
network port numbers, change the network port on the ConnectPort LTS product.
Copy Serial Port Settings
You can copy the port settings for this port to other ports.
Digi ConnectPort LTS User Guide
64
ConnectPort LTS web interface
Configuration
To copy port settings, select a port first and then select the ports you want to copy the port settings
to.
n All: Selects or clears all port check boxes.
n
<number>: Select or clear the check box associated with the port number. When you select a
check box, the port settings will be copied to the port.
Note The following port settings will not be copied: Port Description, Auto Connection State, TCP
Socket ID, UDP Serial State, and UDP Socket ID.
Port Profile Settings
The Port Profile Settings page appears when you select a port under Port Settings on the Serial Ports
Configuration page. The content on this page varies depending on the type of port profile selected. To
change a port profile, click Change Profile. See Select Port Profile for more information the available
port profiles and changing the port profile.
Console Management settings
Use the Console Management Settings pane to connect directly to the serial device using the
following TCP port on the network.
n
Enable Telnet access using TCP Port: Enable the telnet access method to connect to your
serial device. The currently configured TCP port is shown.
n
Enable Secure Shell (SSH) access using TCP Port: Enable Secure Shell access to connect to
your serial device. The currently configured TCP port is shown.
Local Configuration Settings
The Local Configuration profile allows you to sign in to and the command line interface when
connecting directly to a serial port. This profile provides a login from the Digi device.
n
Access the command line interface when connecting from serial terminals: Enable access
to the command-line interface when connecting from serial terminals to configure and manage
the Digi device.
Modem Emulation Settings
The Modem Emulation profile allows you to configure the serial port to act as a modem.
Verify that the Basic Serial Settings match the settings of your modem.
Modem Settings
The Modem profile allows you to connect a modem to the serial port. When you assign the Modem
profile to a serial port, the following settings appear under Modem Settings on the Port Profile
Settings page:
n Incoming Connection: Modem receives dial-in connections, such as inbound PPP connections
or to manage a device through a telephone network. The ConnectPort LTS product server will
receive connections from other hosts.
n
Outgoing Connection: The modem sends dial-out connections to establish connections with
external hosts or to connect to an external PPP network.
Digi ConnectPort LTS User Guide
65
ConnectPort LTS web interface
n
Configuration
Network Bridge Connection (bi-directional): You can use the modem to establish
connections to other hosts and receive connections from other hosts.
n
Init String: This is the modem initialization settings. Modify the init string to change the
behavior of the modem as needed by your application/modem model. For more information
about the supported modem commands, see the ConnectPort LTS Command Reference.
Note If the modem is currently in use, the init string change will not take effect immediately. It
will be used the next time the modem is initialized.
n
Enable PPP Connections on this Modem: When enabled, modem is used for PPP connections.
You will need to configure the PPP connection for incoming and/or outgoing PPP connections.
See PPP (Point-to-Point Protocol) for more information.
Note The Modem profile is most often used when you configure a Digi device server for out-ofband management and PPP.
n
Enable callback: When enabled, the Digi device disconnects the connection from a remote site
and then calls the phone number specified in the Callback phone number field.
n
Callback phone number: The phone number that the Digi device calls when you enable
callback.
n
Dial-in modem callback login: The Digi device calls the phone number specified as the
callback phone number after a user authentication.
n
Allow dial-in modem callback number change: The Digi device will ask a user whether to
change the callback phone number before calling.
Printer Settings
Verify that the Basic Serial Settings match the settings of your serial printer.
RealPort Settings
When you associate a port with the RealPort profile, you are only required to configure the altpin
when using 8-wire cabling with modems or devices requiring DCD assertion. The other configuration
settings are not required. RealPort will set the serial port settings as directed by the computer
application.
Refer to the RealPort Setup Guide for instructions on installing and configuring the RealPort driver on
your computer or server.
Serial Bridge Settings
The Serial Bridge profile configures one side of a serial bridge. A bridge connects two serial devices
over the network as if they were connected with a serial cable. This is also referred to as serial
tunneling.
n
Client/Server bridge: In a client/server bridge, one side of the bridge is designated as the
client. This side should enable Initiate serial bridge to the following device. You need to
configure the client with the IP address and TCP port of the other side of the bridge.
The other side of the bridge is designated as the server. This side should enable Allow other
devices to initiate serial bridge.
Digi ConnectPort LTS User Guide
66
ConnectPort LTS web interface
Configuration
Note the TCP Port value entered under Allow other devices to initiate serial bridge. You will
need this TCP Port number when you configure the other side of the serial bridge. Most bridges
should use the suggested default TCP Port.
n
Enable Secure Socket serial bridge: Enable to use a secure socket connection, otherwise the
connection will use raw TCP.
Serial Services
Your serial device can automatically establish connections to another system or device on the
network. This is also referred to as Automatic Connection or AutoConnect.
Access the command line interface: Enable access to the command-line interface when connecting
from serial terminals.
TCP Settings
Automatically establish bi-directional TCP connections between the serial device and a server or other
networked device.
n
Automatically establish TCP Connections: Enable automatic connection to a system or
device on the network.
l
Establish connection under one of the following conditions:
o
Always connect and maintain connections: A connection is always available. If a
connection is lost it will be reconnected automatically. This type of connection is most
often used in client/server configurations where this Digi device server is the client.
Note Select this option to enable autoconnect for 3-wire devices.
o
Connect when data is present on the serial line: A connection is made when the
serial port receives data. This type of connection is most often used for terminals and
terminal emulation.
o
Match string: A 1 to 4 character string. This is usually the newline character sequence
but can also be a custom string of 1 to 4 characters.
o
Strip string before sending: Search for the string specified in the Match String field
before sending the data and strip the string from the string from the data before it is
sent to the destination.
o
Connect when DCD (Data Carrier Detect) line goes high: A connection is made when
the serial port's DCD (Data Carrier Detect) signal goes high. This type of connection is
most often used for modems. See the Advanced Serial Settings for the option to close
the connection when the DCD signal goes low.
Note If you are using 8-wire cabling, you must apply the altpin for DCD functionality.
o
Connect when DSR (Data Set Ready) line goes high: A connection is made when the
serial port's DSR (Data Set Ready) signal goes high. See the Advanced Serial Settings for
the option to close the connection when the DSR signal goes low.
Digi ConnectPort LTS User Guide
67
ConnectPort LTS web interface
l
Configuration
Establish connection to the following network service:
o
Server (name or IP): Type the IP address or host name of the destination device.
o
Service: Select the service type of the connection. Your options are as follows:
o
o
Raw TCP—If you are bridging to another Digi device server use Raw TCP.
o
Rlogin
o
Secure Sockets
o
Telnet
o
SSH
TCP Port: Type the TCP port number of the destination device. The standard port
numbers are 23 for telnet and 513 for rlogin. If you are bridging to another Digi device
server use the raw TCP port number for its serial port. This is usually 2101 for port 1. The
format for this port number is as follows:
21<serial port number>
Replace <serial port number> with the Digi serial port number. For example, 2101
applies to serial port 1, 2110 applies to serial port 10, and 2116 applies to serial port 16.
See Assign a profile to a serial port for more information about assigning a Serial Bridge
(Serial Tunneling) profile to a serial port.
o
Enable Keep-Alive: When selected, enables the Keep-Alive feature.
UDP Settings
Serial data received is automatically returned to the last UDP client that sent data. You can override
or lock-down the destination by entering one or more IP and port pairs below. All serial data is
repeated as UDP unicast to all devices in this list.
n
Automatically send serial data: Enable sending serial data to one or more systems or devices
on the network using UDP sockets.
l
Send data to the following network services: A list of servers or devices to send data to
using UDP. To add a new destination enter the following information and click Add.
o
Description: A description of the server or device (16 characters or less).
o
Send To: The IP address or DNS name to send data to.
o
UDP Port: The port number to send data to. If you are sending data to another Digi
device server use the raw UDP port number for its serial port. This is usually 2101 for
port 1. The format for this port number is as follows:
21<serial port number>
Replace <serial port number> is the Digi serial port number. For example, 2101 applies
to serial port 1, 2110 applies to serial port 10, and 2116 applies to serial port 16.
Digi ConnectPort LTS User Guide
68
ConnectPort LTS web interface
l
Configuration
Send data under any of the following conditions:
o
Send when data is present on the serial line: Send the data to the network
destinations when a string of characters is detected in the serial data. To enter nonprintable characters, use these key sequences:
Key
Character
Sequence
hexadecimal
\xhh
values
o
tab
\t
line feed
\n
backslash
\\
Send after the following number of idle milliseconds: Send the data after the
specified number of milliseconds have passed with no data received on the serial port.
o
Send after the following number of bytes: Send the data after the specified number
of bytes have been received on the serial ports
Network Services
Enable the access methods that will be used to connect to your serial device. This page displays the
currently configured TCP or UDP port.
n
Allow multiple connections: Enable to allow multiple connections to the TCP server.
n
Enable Raw TCP access using TCP Port: Enable raw TCP access method to access to the
specified port. The default is 2101 for port 1. The format for this port number is as follows:
21<serial port number>
Replace <serial port number> is the Digi serial port number. For example, 2101 applies to serial
port 1, 2110 applies to serial port 10, and 2116 applies to serial port 16.
n
Enable Secure Shell (SSH) access using TCP Port: Enable Secure Shell access to connect to
your serial device. The currently configured TCP port is shown.
n
Enable UDP access using UDP Port: Enable the UDP access method to access the specified
port.
n
Enable RealPort access: Enable the RealPort access method.
n
Enable LPD access: Enable the LPD access method.
Digi ConnectPort LTS User Guide
69
ConnectPort LTS web interface
n
Configuration
Enable TCP Keep-Alive: When selected, enables the sending of the TCP Keep-Alive feature.
TCP sends keep-alive messages at the TCP layer to connected devices indicating the
connection is still alive.
TCP Server Settings
Other systems or devices can connect to your serial device over the network (often referred to as
Reverse Telnet, Console Management or Device Management). You can enable the access methods
that will be used to connect to your serial device. The default configuration enables telnet, raw TCP,
Secure Shell (SSH), and Secure Socket access.
n
Allow multiple connections: Enable to allow multiple connections to the TCP server.
n
Enable Telnet access using TCP Port: Enable the telnet access method to connect to your
serial device. The currently configured TCP port is shown.
n
Enable Raw TCP access using TCP Port: Enable raw TCP access method to access to the
specified port. The default is 2101 for port 1. The format for this port number is as follows:
21<serial port number>
Replace <serial port number> is the Digi serial port number. For example, 2101 applies to serial
port 1, 2110 applies to serial port 10, and 2116 applies to serial port 16.
n
Enable TCP Keep-Alive: When selected, enables the sending of the TCP Keep-Alive feature.
TCP sends keep-alive messages at the TCP layer to connected devices indicating the
connection is still alive.
TCP Client Settings
Your serial device can automatically establish connections to another system or device on the
network. This is also referred to as Automatic Connection or AutoConnect.
n
Automatically establish TCP Connections: Enable automatic connection to a system or
device on the network.
Digi ConnectPort LTS User Guide
70
ConnectPort LTS web interface
n
Configuration
Establish connection under one of the following conditions:
l
Always connect and maintain connections: A connection is always available. If a
connection is lost it will be reconnected automatically. This type of connection is most
often used in client/server configurations where this Digi device server is the client.
Note Select this option to enable autoconnect for 3-wire devices.
l
Connect when data is present on the serial line: A connection is made when the serial
port receives data. This type of connection is most often used for terminals and terminal
emulation.
l
Match string: A 1 to 4 character string. This is usually the newline character sequence but
can also be a custom string of 1 to 4 characters.
l
Strip string before sending: Search for the string specified in the Match String field
before sending the data and strip the string from the string from the data before it is sent
to the destination.
l
Connect when DCD (Data Carrier Detect) line goes high: A connection is made when the
serial port's DCD (Data Carrier Detect) signal goes high. This type of connection is most
often used for modems. See the Advanced Serial Settings for the option to close the
connection when the DCD signal goes low.
Note If you are using 8-wire cabling, you must apply the altpin for DCD functionality.
l
Connect when DSR (Data Set Ready) line goes high: A connection is made when the
serial port's DSR (Data Set Ready) signal goes high. See the Advanced Serial Settings for
the option to close the connection when the DSR signal goes low.
Digi ConnectPort LTS User Guide
71
ConnectPort LTS web interface
n
Configuration
Establish connection to the following network service:
l
Server (name or IP): Type the IP address or host name of the destination device.
l
Service: Select the service type of the connection. Your options are as follows:
l
o
Raw TCP—If you are bridging to another Digi device server use Raw TCP.
o
Rlogin
o
Secure Sockets
o
Telnet
o
SSH
TCP Port: Type the TCP port number of the destination device. The standard port numbers
are 23 for telnet and 513 for rlogin. If you are bridging to another Digi device server use the
raw TCP port number for its serial port. This is usually 2101 for port 1. The format for this
port number is as follows:
21<serial port number>
Replace <serial port number> with the Digi serial port number. For example, 2101 applies
to serial port 1, 2110 applies to serial port 10, and 2116 applies to serial port 16.
See Assign a profile to a serial port for more information about assigning a Serial Bridge
(Serial Tunneling) profile to a serial port.
l
Enable Keep-Alive: When selected, enables the Keep-Alive feature.
UDP Server Settings
Your serial device can receive UDP data from systems or devices on the network. See Assign a profile
to a serial port for more information on assigning a UDP server to a serial port.
n Allow multiple connections: When enabled, allows multiple connections to the UDP server.
n
Enable UDP access using UDP Port: When enabled, allows you to specify the UDP port
number to connect to when sending data to the serial device. The default is 2102.
UDP Client Settings
Your serial device can send data to one or more systems or devices on the network using UDP. This is
also referred to as Data Distribution or UDP Multicast.
n
Automatically send serial data: Enable sending serial data to one or more systems or devices
on the network using UDP sockets.
Digi ConnectPort LTS User Guide
72
ConnectPort LTS web interface
n
Configuration
Send data to the following network services: A list of servers or devices to send data to
using UDP. To add a new destination enter the following information and click Add.
l
Description: A description of the server or device (16 characters or less).
l
Send To: The IP address or DNS name to send data to.
l
UDP Port: The port number to send data to. If you are sending data to another Digi device
server use the raw UDP port number for its serial port. This is usually 2101 for port 1. The
format for this port number is as follows:
21<serial port number>
Replace <serial port number> is the Digi serial port number. For example, 2101 applies to
serial port 1, 2110 applies to serial port 10, and 2116 applies to serial port 16.
n
Send data under any of the following conditions:
l
Send when data is present on the serial line: Send the data to the network
destinations when a string of characters is detected in the serial data. To enter nonprintable characters, use these key sequences:
Key
Character
Sequence
hexadecimal
\xhh
values
l
tab
\t
line feed
\n
backslash
\\
Match string: A 1 to 4 character string. This is usually the newline character sequence but
can also be a custom string of 1 to 4 characters.
l
Strip string before sending: Search for the string specified in the Match String field
before sending the data and strip the string from the string from the data before it is sent
to the destination.
l
Send after the following number of idle milliseconds: Send the data after the specified
number of milliseconds have passed with no data received on the serial port.
l
Send after the following number of bytes: Send the data after the specified number of
bytes have been received on the serial ports
Basic Serial Settings
The basic serial port settings must match the serial settings of the connected device. If you do not
know these settings consult the documentation that came with your serial device. These serial
Digi ConnectPort LTS User Guide
73
ConnectPort LTS web interface
Configuration
settings may be documented as 9600 8N1, which means that the device is using a baud rate of 9600
bits per second, 8 data bits, no parity, and 1 stop bit.
When using RealPort (COM port redirection) these settings are supplied by applications running on the
PC or server, and the default values on your Digi device server do not need to be changed.
The possible settings are as follows:
n Description: Specifies an optional character string for the port which can be used to identify
the device connected to the port.
n
MEI Type: The MEI (multi-electronic interface) type sets the type of serial interface if the
ConnectPort LTS is the MEI version. The MEI version has three kinds of serial interfaces: RS232,
RS422/485 (full), and RS485Half. If the ConnectPort LTS is not the MEI version, MEI Type will be
fixed to RS232 and you cannot change it.
n
Baud Rate: Select the baud rate value for the serial device.
n
Data Bits: Select the data bits value for the serial device.
n
Parity: Select the parity for the serial device.
n
Stop Bits: Select the stop bit value for the serial device.
n
Flow Control: Select the flow control value for the serial device.
n
Enable termination: When selected, enables termination.
Advanced Serial Settings
Use Advanced Serial Settings to configure the serial interface and the access to the serial interface.
The default settings will typically work in most situations.
Serial Settings
n Enable Port Logging: Port logging allows you to save serial data to the memory of the Digi
device server. Once enabled, the port log can be viewed by selecting Port Logs on the Serial
Port Management page (Management > Serial Ports). Port Logging is enabled in the CLI via
the set buffer command.
n
Log Size: The size in kilobytes of the memory buffer used to save serial data when port logging
is enabled.
n
Automatic backup: The port data is stored to specified location automatically.
n
Unlimited automatic backup size: When enabled, the automatic backup size is not limited.
n
Automatic backup size: This option defines the amount of the log to backup at a time.
n
Enable SYSLOG service: The port data can be stored to the SYSLOG server in addition to the
port log storage location at the same time.
n
Enable RTS Toggle: When enabled, the Digi device asserts RTS (Request To Send) when
sending data on the serial port.
n
Pre-delay: The number of milliseconds to wait after the RTS signal is turned on before sending
data. This can be 0 to 5000 milliseconds but is usually set to 0. This setting only appears when
you are configuring a Console Management, Modem, or RealPort profile.
Digi ConnectPort LTS User Guide
74
ConnectPort LTS web interface
n
Configuration
Post-delay: The number of milliseconds to wait after sending data before turning off the RTS
signal. This can be 0 to 5000 milliseconds but is usually set to 0. This setting only appears when
you are configuring a Console Management, Modem, or RealPort profile.
n
Enable DCD on 8-pin RJ45 connectors (Altpin): When enabled, the functions of DCD pin and
DSR pin are swapped so that you can use eight-wire RJ-45 cables with modems. This setting
only appears when you are configuring a Console Management, Modem, RealPort, and or
Sockets profile.
TCP Settings
These TCP Settings are available only when you configure the current port with the Console
Management, Custom, or TCP Sockets profile.
n
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. Enter non-printable characters as
follows:
n
Character
Key
Sequence
backspace
\b
formfeed
\f
tab
\t
line feed
\n
return
\r
backslash
\\
hexadecimal
values
\xhh
Send data only under any of the following conditions: Enable if you need to specify the
conditions when the Digi device server will send the data read from the serial port to the TCP
destination.
Digi ConnectPort LTS User Guide
75
ConnectPort LTS web interface
n
Configuration
Send when data is present on the serial line: Send the data to the network destinations
when a string of characters is detected in the serial data. To enter non-printable characters,
use these key sequences:
Key
Character
Sequence
hexadecimal
\xhh
values
n
tab
\t
line feed
\n
backslash
\\
Match string: A 1 to 4 character string. This is usually the newline character sequence but can
also be a custom string of 1 to 4 characters.
n
Strip string before sending: Search for the string specified in the Match String field before
sending the data and strip the string from the string from the data before it is sent to the
destination.
n
Send after the following number of idle milliseconds: Send the data after the specified
number of milliseconds have passed with no data received on the serial port.
n
Send after the following number of bytes: Send the data after the specified number of
bytes have been received on the serial ports
n
Close connection after the following number of idle seconds: Enable to close an idle
connection. Use the Timeout field to enter the number of seconds that the connection will be
idle before it is closed. This can be 1 to 65000 seconds.
n
Close connection when DCD goes low: When selected, the connection will be closed when the
DCD (Data Carrier Detected) signal goes low.
Note If you are using 8-wire cabling, you must apply the altpin for DCD functionality.
n
Close connection when DSR goes low: When selected, the connection will be closed when the
DSR (Data Set Ready) signal goes low.
UDP Settings
These UDP Settings are available only when the current port is configured with the Console
management, the UDP Sockets, or the Custom Profile.
n
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. Enter non-printable characters as
follows:
Digi ConnectPort LTS User Guide
76
ConnectPort LTS web interface
Configuration
Character
Key
Sequence
backspace
\b
formfeed
\f
tab
\t
line feed
\n
return
\r
backslash
\\
hexadecimal
values
\xhh
Authentication settings
Note The selected profile type determines if the following settings are enabled.
n
Authentication method: The authentication method. The default is None.
The Digi device supports various authentication options, such as None, Local, RADIUS, LDAP.
n
Primary/Secondary authentication server: The IP address or DNS name of the remote
authentication server.
n
Authentication server socket: The TCP port number of the authentication server.
n
Primary/Secondary account server: The IP address or DNS name of the remote accounting
server. The accounting server is only required when you set the authentication method to
RADIUS.
n
Account server socket: The TCP port number of the accounting server.
n
Shared secret: A password string used for encryption of messages between the authentication
server and the ConnectPort LTS. Only RADIUS servers require a shared secret.
n
Timeout: The authentication timeout, in seconds. Only RADIUS servers require a timeout value.
n
Retries: The authentication retry count. Only RADIUS servers require an authentication retry
count.
n
LDAP search base: The LDAP search base string. Only LDAP servers require a search base
string.
n
Domain name for active directory: The LDAP domain name string for Active Directory. Only
LDAP servers require a domain name of Active Directory.
Digi ConnectPort LTS User Guide
77
ConnectPort LTS web interface
n
Configuration
Secure LDAP: Allows you to enable Secure LDAP for LDAP servers. The default is Disable. Only
LDAP servers require this option.
Note Default permissions for authenticated remote users are defined under the user name
ruser.
n
PPP User: Select the PPP user you want to allow to sign in to the serial port. Select ANYBODY if
you want to allow multiple users to sign in to the serial port. This field is enabled when you
assign the Modem profile to the serial port. To add PPP users to this drop-down list, configure
Incoming PPP Connections (Application > PPP > Incoming PPP Connections.
Alarms Configuration
Use the Alarms Configuration page to configure device alarms and displaying alarm settings. Device
alarms send email messages or SNMP traps when certain device events occur. These device events
include data patterns detected in the data stream.
Alarm notification settings
Use the Alarm Notification Settings page to configure the following:
n Enable alarm notifications: Enables or disables all alarm processing for the Digi device.
Alarm list and status
The Alarm Conditions page lists all of the alarms. You can configure up to 32 alarms for a Digi device,
and you can individually enable and disable these alarms.
The alarm list displays the current status of each alarm. You can use this list to view alarm status at a
glance, then view more details for each alarm as needed.
n Enable: The check box indicates whether the alarm is currently enabled or disabled.
n
Alarm: The number of the alarm.
n
Type: The basis for the alarm; whether it is based on serial data pattern matching.
n
Trigger: The conditions that trigger the alarm.
n
SNMP Trap: Indicates whether the alarm is sent as an SNMP trap.
l
If the SNMP Trap field is disabled, and the Send To field has a value, the alarm is sent as an
email message only.
l
If the SNMP Trap field is enabled and the Send To field is blank, the alarm is sent as an
SNMP trap only.
l
If the SNMP Trap field is enabled, and a value is specified in the Send To field, that means
the alarm is sent both as an email and as an SNMP trap.
n
Send To: The email address to which the alarm is sent.
n
Email Subject: Text to include in the Subject line of alarms sent as email messages.
Alarm Conditions
Use the Alarm Conditions page to specify the conditions on which the alarm is based Alarm conditions
include:
Digi ConnectPort LTS User Guide
78
ConnectPort LTS web interface
n
Configuration
Send alarms based on serial data pattern matching: Click this radio button to specify that
this alarm is sent when the specified serial data pattern is detected. Then specify the following:
l
Serial Port: The serial port to monitor for the data pattern. This field appears for devices
where more than one serial port is available.
l
Pattern: When the serial port receives this data pattern it sends an alarm. You can include
special characters such as carriage return carriage return (\r) and new line (\n) in the data
pattern.
Alarm Destinations
Use the Alarm Destinations page to define how alarm notifications are sent, either as an email
message or an SNMP trap, or both, and where the alarm notification is sent.
n
Alarm Type: Specify the alarm type to send. Your options are as follows:
[none|email|snmptrap|all]
n
Alarm Description: The text to include in the Subject: lien of the alarm-notification email or
SNMP traps description.
n
Send SNMP trap to the following destination when alarm occurs: Specifies whether to
send the alarm as an SNMP trap. To send alarms as SNMP traps, you must set the Alarm Type
to snmptrap and specify the IP address of the destination for the SNMP traps in the SNMP
settings.
To configure an alarm notification to be sent as both an email message and an SNMP trap:
1. Select both Send E-Mail and Send SNMP trap check boxes.
2. Click Apply to apply changes to alarm settings and return to the Alarms Configuration page.
Configure alarm conditions
To configure an alarm:
1. Select Configuration > Alarms.
2. To enable or disable an alarm, select or clear the Enable check box next to the alarm.
3. Click the alarm under the Alarm column that you want to configure.
4. Configure the fields in the following sections:
n
Alarm Conditions: These condition specify the conditions on which the alarm is based, such as
serial data pattern matching or data usage.
n
Alarm Destinations: These conditions specify how the alarm is sent, either as an email
message or an SNMP trap, or both, and where the alarm is sent.
5. Click Apply to save your changes.
System Configuration
Use the System Configuration page to configure device identity and description information, date and
time settings, and settings for SNMP.
Digi ConnectPort LTS User Guide
79
ConnectPort LTS web interface
Configuration
Device Identity Settings
Use the Device Identity Settings page to create a description of the ConnectPort LTS product’s name,
contact, and location. You can use this information to identify a specific Digi device product when
working with a large number of devices in multiple locations.
n Description: The network name assigned to the Digi device.
n
Contact: The SNMP contact person (often the network administrator).
n
Location: A text description of the physical location of the Digi device.
n
Device ID: A text description of the device ID used to identify the device (for example, MAC or
IP address).
Simple Network Management Protocol (SNMP) Settings
Use the Simple Network Management Protocol (SNMP) Settings page to manage and monitor
network devices. You can configure ConnectPort LTS devices to use SNMP features, or you can disable
SNMP for security reasons. For additional information, see Simple Network Management Protocol
(SNMP).
n Enable Simple Network Management Protocol (SNMP): This check box enables or disables
use of SNMP.
The Public community and Private community fields specify passwords required to get
l
or set SNMP-managed objects. Changing public and private community names from their
defaults is recommended to prevent unauthorized access to the device.
Public community: The password required to get SNMP-managed objects. The default is
l
public.
Private community: The password required to set SNMP-managed objects. The default is
l
private.
Allow SNMP clients to set device settings through SNMP: This check box enables or
l
disables the capability for users to issue SNMP set commands uses use of SNMP read-only
for the Digi device.
n
Enable Simple Network Management Protocol (SNMP) v1/v2c: This check box enables or
disables use of SNMP version 1 or version2c.
l
SNMPv1/v2c Get community: The password required to get SNMP-managed objects. The
default is public. Changing get and set community names from their defaults is
recommended to prevent unauthorized access to the device.
l
SNMPv1/v2c Set community: The password required to set SNMP-managed objects. The
default is private.
l
SNMPv1/v2c Permission: Allow SNMP clients to set device settings through SNMP:
l
get only: Disables the capability for users to issue SNMP set commands uses use of SNMP
read-only for the ConnectPort LTS product.
l
get/set: Enables the capability for users to issue SNMP set commands uses use of SNMP
read-only for the ConnectPort LTS product.
Digi ConnectPort LTS User Guide
80
ConnectPort LTS web interface
n
Configuration
Enable Simple Network Management Protocol (SNMP) v3: Enables or disables use of SNMP
version 3.
l
User: The user name that is authenticated to communicate with the SNMP engine.
l
Security level: The security level of the user with regard to authentication and privacy:
Auth_NoPriv or Auth_Priv.
l
Authentication protocol: The type of authentication protocol algorithm to use: MD5 or SHA.
l
Authentication password/ Authentication password (confirm): Supply and confirm the
password for the user.
l
Privacy protocol: The type of privacy protocol to use: DES or AES.
l
Privacy password/ Privacy password (confirm): Supply and confirm the password for the
user.
SNMPv3 Permission: Select the appropriate permission level: get only or get/set.
l
n
Enable Simple Network Management Protocol (SNMP) traps: Enables or disables the
generation of SNMP traps.
l
Trap version: The SNMP version for the trap.
l
Trap primary IP: The primary IP address of the system to which traps are sent. You must
specify a non-zero value to enable traps. If your ConnectPort LTS product supports alarms,
this field is required in order to send alarms in the form of SNMP traps. See Alarms
Configuration.
l
Trap secondary IP: The secondary IP address of the system to which traps are sent.
l
Trap community: Community string for SNMP trap.
l
Trap user: Type the user name that is authenticated to communicate with the SNMP v3
trap engine.
l
Trap security level: The security level of the user with regard to authentication and
privacy in case of SNMPv3 trap: Auth_NoPriv or Auth_Priv.
Select one or more of the following SNMP trap options:
n Generate cold start traps
n
Generate link up traps
n
Generate authentication failure traps
n
Generate login traps
n
Generate power traps
Date and Time Settings
Use the Date and Time Settings page to set the Coordinated Universal Time (UTC) and/or system
time and date on a device, or set the offset from UTC for the Digi device's system time.
n Enable NTP: Select or clear the check box to enable or disable Network Time Protocol (NTP).
When enabled, the ConnectPort LTS uses NTP to set the system time.
Digi ConnectPort LTS User Guide
81
ConnectPort LTS web interface
l
l
Configuration
NTP server: Type the IP address or hostname for the NTP server.
NTP option: Choose one of the following options:
o
Once:
o
Periodically: Synchronize the clock with NTP based on the NTP update interval.
n
NTP update interval: Type the interval, in hours, between NTP updates.
n
Date (mm/dd/yyyy): Type the date in mm/dd/yyyy format.
n
Time (hh:mm:ss): Type the time in hh:mm:ss format.
n
Offset (hh:mm): Type the offset in hh:mm format.
Authentication Settings
Use the Authentication Settings page to set the authentication method and the related settings for
web interface and command-line interface access. The command-line interface access includes access
through serial console, telnet, SSH, Rlogin and Rsh. Remote authentication uses the permissions set
to the default user called ruser.
n
Authentication method: The authentication method. The default is None.
The Digi device supports various authentication options, such as None, Local, RADIUS, LDAP.
n
Primary/Secondary authentication server: The IP address or DNS name of the remote
authentication server.
n
Authentication server socket: The TCP port number of the authentication server.
n
Primary/Secondary account server: The IP address or DNS name of the remote accounting
server. The accounting server is only required when you set the authentication method to
RADIUS.
n
Account server socket: The TCP port number of the accounting server.
n
Shared secret: A password string used for encryption of messages between the authentication
server and the ConnectPort LTS. Only RADIUS servers require a shared secret.
n
Timeout: The authentication timeout, in seconds. Only RADIUS servers require a timeout value.
n
Retries: The authentication retry count. Only RADIUS servers require an authentication retry
count.
n
LDAP search base: The LDAP search base string. Only LDAP servers require a search base
string.
n
Domain name for active directory: The LDAP domain name string for Active Directory. Only
LDAP servers require a domain name of Active Directory.
n
Secure LDAP: Allows you to enable Secure LDAP for LDAP servers. The default is Disable. Only
LDAP servers require this option.
Note Default permissions for authenticated remote users are defined under the user name
ruser.
Digi ConnectPort LTS User Guide
82
ConnectPort LTS web interface
Configuration
Login Settings
Use the Login Settings page to configure the login settings.
n
Enable Login Banner: Allows you to enable the login banner. A login banner is an optional
message that appears above the Login page before a user signs in using the web interface or
telnet/ssh command line login prompt. For example, a banner “Security Notice” followed by
additional security information may appear above the Login page. The login banner is disabled
by default.
The text for the banner resides in a text file named issue.net. See Create the login banner for
instructions on creating the banner.
n
Disable root login via telnet or ssh: Allows you to disable the root shell access via telnet
(default port 23) or ssh (default port 22). The root shell access via telnet is enabled by default.
Create the login banner
To create the login banner:
1. From the web interface, select Configuration > System > Login Settings.
2. Select the Enable Login Banner check box.
3. Open a Linux command line prompt and type the following command:
#> bash
4. Using a text editor, such as vi, create a text file called issue.net:
#> vi /usr2/issue.net
5. In issue.net file, type the text that you want to appear in the login banner.
6. Change the permissions of the issue.net file to read, write, and execute for all.
#> chmod 777 /usr2/issue.net
Escape Character Settings
Use the Escape Character Settings page to configure the escape character settings.
n Connect: The escape character for users using the connect command. The default escape
character is ^[ (Control key and left bracket).
n
Telnet: The escape character for users using telnet. The default is ^] (Control key and right
bracket).
n
SSH: The escape character for users using ssh. The default is ~.
Users
You can configure the Digi device server to accommodate the requirements of specific users. You can
configure the following user attributes:
Digi ConnectPort LTS User Guide
83
ConnectPort LTS web interface
Configuration
n
The user's name and password.
n
The device interfaces that the user can access, such as the command-line interface or web
interface.
n
The permissions the user has to access and configure the device.
Multi-user model implemented in ConnectPort LTS
The user model in ConnectPort LTS device determines the commands that users can issue.
ConnectPort LTS supports multiple users. ConnectPort LTS devices use a more-than-two-user model.
You can define up to 32 users. Characteristics of this model include:
n The root user is a user name or account that by default has access to all configuration settings
on the Digi device. The root user is responsible for system administration. By default, the all
permissions for the root user are enabled and the root user can issue all commands. The root
user is the first user to access and configure the Digi device. The first user to access the Digi
device can choose to disable some of the default root permissions. You are prompted to
change your password the first time you sign in and after a factory reset.
n
The admin user is a user name or account that has access to configuration settings defined by
the root user for administrative purposes.
Digi ConnectPort LTS User Guide
84
ConnectPort LTS web interface
n
Configuration
The ruser is a user name or account used by authentication when the user is not locally
defined. The ruser represents the remote user. Use the user named ruser to set permissions
for users authenticating remotely via Remote Authentication Dial-In User Service (RADIUS)
and/or Lightweight Directory Access Protocol (LDAP).
The default RADIUS user defines the permissions for all RADIUS users who do not have a local
definition. You can customize the permissions for RADIUS users who do not have a local
definition.
Users that have a local definition and connect to services that are set up for RADIUS:
l
Have permission characteristics of locally-defined users.
l
User authentication uses the specified RADIUS authentication method. See description of
Authentication Method in Authentication Settings for more information.
The RADIUS attributes supported by ConnectPort LTS are as follows:
l
l
n
For authentications:
o
User-Name
o
User-Password
o
NAS-Port-Id
o
Framed-Protocol
For accounting:
o
Acct-Status-Type
o
User-Name
o
User-Password
o
NAS-Port-Id
o
Acct-Session-ID
o
Acct-Session-Time
o
Service-Type
Users are defined by the user settings in the web interface or the set user command in the
command-line interface.
n
You can define additional users as needed.
n
set user, set group, and other commands are described in detail in the ConnectPort LTS
Command Reference.
Users
The Users page displays a list of configured users and groups. Use the page to configure users and
groups.
n Configure Users:
l
l
User Name: Lists the configured users. To edit a user, click a user's name.
Action: Lists the available actions per user. The possible action is as follows:
o
Remove: Allows you to remove the user.
Digi ConnectPort LTS User Guide
85
ConnectPort LTS web interface
l
n
Configuration
New user: Allows you to add a new user.
Configure Groups:
l
Group Name: Lists the configured groups. To edit a group, click the group's name.
l
Action: Lists the available actions per group. The possible action is as follows:
l
Remove: Allows you to remove the group.
l
New group: Allows you to add a new group.
Add New User
Use the Users Configuration page to configure a user's login credentials.
n User Name: The user's login name.
n
New Password/Confirm Password: The user's login password. The password must be 4 to 16
characters long.
Add a user
ConnectPort LTS devices allow you to define multiple users. For those products, the Users
Configuration page shows the currently defined users and allows you to add users.
To add a user:
1. Select Configuration > Users.
2. Click New user.
3. On the Add New User page, complete the user authentication fields. You can specify a casesensitive password from 4 through 16 characters long.
4. Click Apply. The changes take effect immediately. No logout/login is necessary.
User Configuration
n
User Configuration: Use the User Configuration page to configure a user's login credentials.
l
User Name: The user's login name.
l
New Password/Confirm Password: The user's login password. The password must be 4 to
16 characters long.
n
User Access: Use the User Access page to configure the user's access permissions.
l
System Interface Access (Command Line Interface): Choose the interface to use when
the user logs into the command line interface. Your options are as follows:
l
o
None: Disable system interface access for this user.
o
Shell: Allow this user to access the shell program of the command-line interface.
o
CLI menu: Allow this user to access the menu program of the command-line interface.
o
Port access menu: Allow this user to access the port access menu.
Allow web interface access: Allow this user to access the web interface for system
configuration and management.
l
Manage Serial Ports: Select the ports that the user can access.
Digi ConnectPort LTS User Guide
86
ConnectPort LTS web interface
n
Configuration
User Permissions: Use the User Permissions page to configure a user's permissions
associated with various services and configuration settings.
To further secure the ConnectPort LTS product, you can disable network services that are not
required for the Digi device. You can disable non-secure or un-encrypted network services such
as Telnet. See Basic Network Services Settings.
A user cannot set another user's permission level higher than their own permission level, nor
can a user raise their own permission level.
The list of services and the user permissions available for them vary by ConnectPort LTS
product and the features supported in the product. There are several groups of services, such
as:
l
Network Configuration
l
Serial Configuration
l
System Configuration
l
User Configuration
l
Peripherals
l
Application Configuration
l
Connection Management
l
Command Line Applications
l
System Administration
The possible selections for each permissions setting can vary, but includes the following
possibilities:
l
None: The user does not have permission to execute this setting.
l
Read Self: The user can display their own settings, but not those of other users.
l
Read: The user can read the setting for all users, but does not have permission to modify or
write the setting.
l
Read/Write Self: The user can read and write their own setting, but not those of other
users.
l
Read All/Write Self: The user can read the setting for all users and can modify their own
setting.
l
Read/Write: The user can read and write the setting for all users.
l
Execute: The user can execute this setting.
Change user access settings
For ConnectPort LTS products with the two-user or more-than-two-users model, you can configure
user access to the device interfaces. For example, the administrative user can access both the
command line and web interface, but you can restrict other users to the web interface only.
Digi ConnectPort LTS User Guide
87
ConnectPort LTS web interface
Peripheral
CAUTION! Take care in changing access settings. If you sign in as the administrative
user and disable the web interface, you will not be able to sign in to the ConnectPort LTS
device on your next attempt, and there is no way to raise your user permissions to
enable the web interface again. You must reset the device to factory defaults to enable
the web interface access.
To set access settings:
1. Select Configuration > Users.
2. Click a user under User Name.
3. Click User Access.
4. Enable or disable the device interface access as desired:
n
Allow command line access: Enables or disables access to the command line.
5. Select the user access options that you want to enable for this user.
6. Click Apply. The changes take effect immediately. No logout/login is necessary.
Set user permissions
To set user permissions, choose one of the following options:
n
Set user permissions from the web interface:
1. Select Configuration > Users.
2. Click a user under User Name.
3. Click User Permissions.
4. A list of feature groupings and the user permissions for them appears. Customize these
settings as needed.
5. Click Apply.
n
Set user permissions from the command-line interface:
Use the set permissions command to set permissions from the command-line interface. See
the ConnectPort LTS Command Reference for the command description.
Peripheral
Use the options under Peripheral to configure settings for various peripheral devices on ConnectPort
LTS, such as SD memory, USB, Modem, LCD, and XBee.
Note USB, Modem, and XBee are supported in ConnectPort LTS W versions only.
Digi ConnectPort LTS User Guide
88
ConnectPort LTS web interface
Peripheral
SD Memory
The ConnectPort LTS supports standard SD and SDHC (high-capacity) memory cards. To use an SD
memory device, insert the card in the SD slot and then select Start service on the SD Memory page.
After you start the SD memory card service, you can see the card information such as:
n Card Type
n
File system
n
Used size
n
Available size
If the SD memory card is not formatted, select the format type and click the Format button.
The physical mounting point of SD memory device on the ConnectPort LTS is /mnt/sd.
USB
To use the USB device, insert the device in the USB port and then select Start service next to the USB
device you want to start on the USB page.
The ConnectPort LTS W version has two USB ports. After you start the USB service, you can see the
device information such as:
n Card Type
n
File system
n
Used size
If the USB storage device using is not formatted, select the format type and click the Format button.
The physical mounting point of USB device on the ConnectPort LTS is /mnt/usb1 or /mnt/usb2.
Modem
Use the Modem page to configure the internal modem for ConnectPort LTS. The Modem 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 allows you
to use the several connection types.
Modem Settings
The Modem profile allows you to connect a modem to the serial port. When you assign the Modem
profile to a serial port, the following settings appear under Modem Settings on the Port Profile
Settings page:
n Incoming Connection: Modem receives dial-in connections, such as inbound PPP connections
or to manage a device through a telephone network. The ConnectPort LTS product server will
receive connections from other hosts.
n
Outgoing Connection: The modem sends dial-out connections to establish connections with
external hosts or to connect to an external PPP network.
n
Network Bridge Connection (bi-directional): You can use the modem to establish
connections to other hosts and receive connections from other hosts.
Digi ConnectPort LTS User Guide
89
ConnectPort LTS web interface
n
Peripheral
Init String: This is the modem initialization settings. Modify the init string to change the
behavior of the modem as needed by your application/modem model. For more information
about the supported modem commands, see the ConnectPort LTS Command Reference.
Note If the modem is currently in use, the init string change will not take effect immediately. It
will be used the next time the modem is initialized.
n
Enable PPP Connections on this Modem: When enabled, modem is used for PPP connections.
You will need to configure the PPP connection for incoming and/or outgoing PPP connections.
See PPP (Point-to-Point Protocol) for more information.
Note The Modem profile is most often used when you configure a Digi device server for out-ofband management and PPP.
n
Enable callback: When enabled, the Digi device disconnects the connection from a remote site
and then calls the phone number specified in the Callback phone number field.
n
Callback phone number: The phone number that the Digi device calls when you enable
callback.
n
Dial-in modem callback login: The Digi device calls the phone number specified as the
callback phone number after a user authentication.
n
Allow dial-in modem callback number change: The Digi device will ask a user whether to
change the callback phone number before calling.
Service Settings
n
Serial Service Settings:
l
TCP Settings: Your serial device can automatically establish connections to another
system or device on the network. This is also referred to as Automatic Connection or
AutoConnect.
o
Automatically establish TCP Connections: Enable automatic connection to a system
or device on the network.
Digi ConnectPort LTS User Guide
90
ConnectPort LTS web interface
o
Peripheral
Establish connection under one of the following conditions:
o
Always connect and maintain connections: A connection is always available. If a
connection is lost it will be reconnected automatically. This type of connection is most
often used in client/server configurations where this Digi device server is the client.
Note Select this option to enable autoconnect for 3-wire devices.
o
Connect when data is present on the serial line: A connection is made when the
serial port receives data. This type of connection is most often used for terminals and
terminal emulation.
o
Match string: A 1 to 4 character string. This is usually the newline character sequence
but can also be a custom string of 1 to 4 characters.
o
Strip string before sending: Search for the string specified in the Match String field
before sending the data and strip the string from the string from the data before it is
sent to the destination.
o
Connect when DCD (Data Carrier Detect) line goes high: A connection is made
when the serial port's DCD (Data Carrier Detect) signal goes high. This type of
connection is most often used for modems. See the Advanced Serial Settings for the
option to close the connection when the DCD signal goes low.
Note If you are using 8-wire cabling, you must apply the altpin for DCD functionality.
o
Connect when DSR (Data Set Ready) line goes high: A connection is made when
the serial port's DSR (Data Set Ready) signal goes high. See the Advanced Serial
Settings for the option to close the connection when the DSR signal goes low.
Digi ConnectPort LTS User Guide
91
ConnectPort LTS web interface
o
Peripheral
Establish connection to the following network service:
o
Server (name or IP): Type the IP address or host name of the destination device.
o
Service: Select the service type of the connection. Your options are as follows:
o
o
Raw TCP—If you are bridging to another Digi device server use Raw TCP.
o
Rlogin
o
Secure Sockets
o
Telnet
o
SSH
TCP Port: Type the TCP port number of the destination device. The standard port
numbers are 23 for telnet and 513 for rlogin. If you are bridging to another Digi device
server use the raw TCP port number for its serial port. This is usually 2101 for port 1.
The format for this port number is as follows:
21<serial port number>
Replace <serial port number> with the Digi serial port number. For example, 2101
applies to serial port 1, 2110 applies to serial port 10, and 2116 applies to serial port
16.
See Assign a profile to a serial port for more information about assigning a Serial
Bridge (Serial Tunneling) profile to a serial port.
o
Enable Keep-Alive: When selected, enables the Keep-Alive feature.
Digi ConnectPort LTS User Guide
92
ConnectPort LTS web interface
l
Peripheral
UDP Settings:
o
Automatically send serial data: Enable sending serial data to one or more systems or
devices on the network using UDP sockets.
o
Send data to the following network services: A list of servers or devices to send data
to using UDP. To add a new destination enter the following information and click Add.
o
Description: A description of the server or device (16 characters or less).
o
Send To: The IP address or DNS name to send data to.
o
UDP Port: The port number to send data to. If you are sending data to another Digi
device server use the raw UDP port number for its serial port. This is usually 2101 for
port 1. The format for this port number is as follows:
21<serial port number>
Replace <serial port number> is the Digi serial port number. For example, 2101 applies
to serial port 1, 2110 applies to serial port 10, and 2116 applies to serial port 16.
o
Send data under any of the following conditions:
o
Send when data is present on the serial line: Send the data to the network
destinations when a string of characters is detected in the serial data. To enter nonprintable characters, use these key sequences:
Key
Character
Sequence
hexadecimal
\xhh
values
o
tab
\t
line feed
\n
backslash
\\
Match string: A 1 to 4 character string. This is usually the newline character sequence
but can also be a custom string of 1 to 4 characters.
o
Strip string before sending: Search for the string specified in the Match String field
before sending the data and strip the string from the string from the data before it is
sent to the destination.
o
Send after the following number of idle milliseconds: Send the data after the
specified number of milliseconds have passed with no data received on the serial port.
o
Send after the following number of bytes: Send the data after the specified
number of bytes have been received on the serial ports
Digi ConnectPort LTS User Guide
93
ConnectPort LTS web interface
n
Peripheral
Network Services Settings: Enable the access methods that will be used to connect to your
serial device. This page displays the currently configured TCP or UDP port.
Basic Serial Settings
The basic serial port settings must match the serial settings of the connected device. If you do not
know these settings consult the documentation that came with your serial device. These serial
settings may be documented as 9600 8N1, which means that the device is using a baud rate of 9600
bits per second, 8 data bits, no parity, and 1 stop bit.
When using RealPort (COM port redirection) these settings are supplied by applications running on the
PC or server, and the default values on your Digi device server do not need to be changed.
The possible settings are as follows:
n Description: Specifies an optional character string for the port which can be used to identify
the device connected to the port.
n
MEI Type: The MEI (multi-electronic interface) type sets the type of serial interface if the
ConnectPort LTS is the MEI version. The MEI version has three kinds of serial interfaces: RS232,
RS422/485 (full), and RS485Half. If the ConnectPort LTS is not the MEI version, MEI Type will be
fixed to RS232 and you cannot change it.
n
Baud Rate: Select the baud rate value for the serial device.
n
Data Bits: Select the data bits value for the serial device.
n
Parity: Select the parity for the serial device.
n
Stop Bits: Select the stop bit value for the serial device.
n
Flow Control: Select the flow control value for the serial device.
n
Enable termination: When selected, enables termination.
Advanced Serial Settings
The following settings are advanced settings used to fine tune the serial port and access to the serial
interface. The default settings will typically work in most situations.
Note The advanced settings rarely need to be changed.
Serial Settings:
n Enable Port Logging: Port logging allows you to save serial data to the memory of the Digi
device server. Once enabled, the port log can be viewed by selecting Port Logs on the Serial
Port Management page (Management > Serial Ports). Port Logging is enabled in the CLI via
the set buffer command.
n
Log Size: The size in kilobytes of the memory buffer used to save serial data when port logging
is enabled.
n
Automatic backup: The port data is stored to specified location automatically.
n
Unlimited automatic backup size: When enabled, the automatic backup size is not limited.
n
Automatic backup size: This option defines the amount of the log to backup at a time.
Digi ConnectPort LTS User Guide
94
ConnectPort LTS web interface
n
Peripheral
Enable SYSLOG service: The port data can be stored to the SYSLOG server in addition to the
port log storage location at the same time.
UDP Settings:
These UDP Settings are available only when the current port is configured with the Console
management, the UDP Sockets, or the Custom Profile.
n
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. Enter non-printable characters as
follows:
Character
Key
Sequence
backspace
\b
formfeed
\f
tab
\t
line feed
\n
return
\r
backslash
\\
hexadecimal
values
\xhh
TCP Settings:
These TCP Settings are available only when you configure the current port with the Console
Management, Custom, or TCP Sockets profile.
n
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. Enter non-printable characters as
follows:
Character
Key
Sequence
backspace
\b
formfeed
\f
tab
\t
line feed
\n
return
\r
backslash
\\
hexadecimal
values
\xhh
Digi ConnectPort LTS User Guide
95
ConnectPort LTS web interface
n
Peripheral
Send data only under any of the following conditions: Enable if you need to specify the
conditions when the Digi device server will send the data read from the serial port to the TCP
destination.
n
Send when data is present on the serial line: Send the data to the network destinations
when a string of characters is detected in the serial data. To enter non-printable characters,
use these key sequences:
Key
Character
Sequence
hexadecimal
\xhh
values
n
tab
\t
line feed
\n
backslash
\\
Match string: A 1 to 4 character string. This is usually the newline character sequence but can
also be a custom string of 1 to 4 characters.
n
Strip string before sending: Search for the string specified in the Match String field before
sending the data and strip the string from the string from the data before it is sent to the
destination.
n
Send after the following number of idle milliseconds: Send the data after the specified
number of milliseconds have passed with no data received on the serial port.
n
Send after the following number of bytes: Send the data after the specified number of
bytes have been received on the serial ports
n
Close connection after the following number of idle seconds: Enable to close an idle
connection. Use the Timeout field to enter the number of seconds that the connection will be
idle before it is closed. This can be 1 to 65000 seconds.
n
Close connection when DCD goes low: When selected, the connection will be closed when the
DCD (Data Carrier Detected) signal goes low.
Note If you are using 8-wire cabling, you must apply the altpin for DCD functionality.
n
Close connection when DSR goes low: When selected, the connection will be closed when the
DSR (Data Set Ready) signal goes low.
Authentications settings
n
Authentication method: The authentication method. The default is None.
The Digi device supports various authentication options, such as None, Local, RADIUS, LDAP.
Digi ConnectPort LTS User Guide
96
ConnectPort LTS web interface
n
Peripheral
Primary/Secondary authentication server: The IP address or DNS name of the remote
authentication server.
n
Authentication server socket: The TCP port number of the authentication server.
n
Primary/Secondary account server: The IP address or DNS name of the remote accounting
server. The accounting server is only required when you set the authentication method to
RADIUS.
n
Account server socket: The TCP port number of the accounting server.
n
Shared secret: A password string used for encryption of messages between the authentication
server and the ConnectPort LTS. Only RADIUS servers require a shared secret.
n
Timeout: The authentication timeout, in seconds. Only RADIUS servers require a timeout value.
n
Retries: The authentication retry count. Only RADIUS servers require an authentication retry
count.
n
LDAP search base: The LDAP search base string. Only LDAP servers require a search base
string.
n
Domain name for active directory: The LDAP domain name string for Active Directory. Only
LDAP servers require a domain name of Active Directory.
n
Secure LDAP: Allows you to enable Secure LDAP for LDAP servers. The default is Disable. Only
LDAP servers require this option.
Note Default permissions for authenticated remote users are defined under the user name
ruser.
LCD
Use the LCD configuration page to configure the LCD display for ConnectPort LTS. The following
settings are available on LCD configuration page:
n
Enable display: When enabled, LCD display is enabled and you can use LCD menu using
keypad.
l
Background image wait time: Specifies how much user idle time must elapse before the
background image is launched on the LCD display. The default is 0 and means the
background image will not be launched automatically.
n
Use default background image: When enabled, the default background image appears on the
LCD display when either the wait time is elapsed or the Exit menu is selected using keypad on
the LCD display.
n
Load background image: Upload a background image on the LCD. This product supports only
128 x 64 8 bit bitmap image. If you upload an incorrect image type, an error message appears
on LCD screen. After uploading the image, toggle the Enable display or Use default
background image option once to force the LCD daemon to reload the image.
n
Load custom (Python) program: Upload a custom Python program onto the ConnectPort LTS.
Digi ConnectPort LTS User Guide
97
ConnectPort LTS web interface
Peripheral
For instructions on configuring an IP address using the LCD interface, see ConnectPort LTS LCD
interface.
XBee
The XBee configuration page has very similar settings to the Custom serial port profile.
For detailed information about XBee RF modules and commands for configuring them, please refer to
the ZigBee RF Modules User Guide.
XBee Port Settings
n
Allow direct Access from networks: When enabled, you can access the XBee port in the same
manner that the custom profile accesses a serial port. This setting is Disabled by default.
Digi ConnectPort LTS User Guide
98
ConnectPort LTS web interface
n
Peripheral
Serial Service Settings:
l
TCP Settings: Your serial device can automatically establish connections to another
system or device on the network. This is also referred to as Automatic Connection or
AutoConnect.
o
Automatically establish TCP Connections: Enable automatic connection to a system
or device on the network.
o
Establish connection under one of the following conditions:
o
Always connect and maintain connections: A connection is always available. If a
connection is lost it will be reconnected automatically. This type of connection is most
often used in client/server configurations where this Digi device server is the client.
Note Select this option to enable autoconnect for 3-wire devices.
o
Connect when data is present on the serial line: A connection is made when the
serial port receives data. This type of connection is most often used for terminals and
terminal emulation.
o
Match string: A 1 to 4 character string. This is usually the newline character sequence
but can also be a custom string of 1 to 4 characters.
o
Strip string before sending: Search for the string specified in the Match String field
before sending the data and strip the string from the string from the data before it is
sent to the destination.
o
Connect when DCD (Data Carrier Detect) line goes high: A connection is made
when the serial port's DCD (Data Carrier Detect) signal goes high. This type of
connection is most often used for modems. See the Advanced Serial Settings for the
option to close the connection when the DCD signal goes low.
Note If you are using 8-wire cabling, you must apply the altpin for DCD functionality.
o
Connect when DSR (Data Set Ready) line goes high: A connection is made when
the serial port's DSR (Data Set Ready) signal goes high. See the Advanced Serial
Settings for the option to close the connection when the DSR signal goes low.
Digi ConnectPort LTS User Guide
99
ConnectPort LTS web interface
o
Peripheral
Establish connection to the following network service:
o
Server (name or IP): Type the IP address or host name of the destination device.
o
Service: Select the service type of the connection. Your options are as follows:
o
o
Raw TCP—If you are bridging to another Digi device server use Raw TCP.
o
Rlogin
o
Secure Sockets
o
Telnet
o
SSH
TCP Port: Type the TCP port number of the destination device. The standard port
numbers are 23 for telnet and 513 for rlogin. If you are bridging to another Digi device
server use the raw TCP port number for its serial port. This is usually 2101 for port 1.
The format for this port number is as follows:
21<serial port number>
Replace <serial port number> with the Digi serial port number. For example, 2101
applies to serial port 1, 2110 applies to serial port 10, and 2116 applies to serial port
16.
See Assign a profile to a serial port for more information about assigning a Serial
Bridge (Serial Tunneling) profile to a serial port.
o
Enable Keep-Alive: When selected, enables the Keep-Alive feature.
Digi ConnectPort LTS User Guide
100
ConnectPort LTS web interface
l
Peripheral
UDP Settings:
o
Automatically send serial data: Enable sending serial data to one or more systems or
devices on the network using UDP sockets.
o
Send data to the following network services: A list of servers or devices to send data
to using UDP. To add a new destination enter the following information and click Add.
o
Description: A description of the server or device (16 characters or less).
o
Send To: The IP address or DNS name to send data to.
o
UDP Port: The port number to send data to. If you are sending data to another Digi
device server use the raw UDP port number for its serial port. This is usually 2101 for
port 1. The format for this port number is as follows:
21<serial port number>
Replace <serial port number> is the Digi serial port number. For example, 2101 applies
to serial port 1, 2110 applies to serial port 10, and 2116 applies to serial port 16.
o
Send data under any of the following conditions:
o
Send when data is present on the serial line: Send the data to the network
destinations when a string of characters is detected in the serial data. To enter nonprintable characters, use these key sequences:
Key
Character
Sequence
hexadecimal
\xhh
values
o
tab
\t
line feed
\n
backslash
\\
Match string: A 1 to 4 character string. This is usually the newline character sequence
but can also be a custom string of 1 to 4 characters.
o
Strip string before sending: Search for the string specified in the Match String field
before sending the data and strip the string from the string from the data before it is
sent to the destination.
o
Send after the following number of idle milliseconds: Send the data after the
specified number of milliseconds have passed with no data received on the serial port.
o
Send after the following number of bytes: Send the data after the specified
number of bytes have been received on the serial ports
Digi ConnectPort LTS User Guide
101
ConnectPort LTS web interface
n
Peripheral
Network Services Settings: Enable the access methods that will be used to connect to your
serial device. This page displays the currently configured TCP or UDP port.
Basic Serial Settings
The basic serial port settings must match the serial settings of the connected device. If you do not
know these settings consult the documentation that came with your serial device. These serial
settings may be documented as 9600 8N1, which means that the device is using a baud rate of 9600
bits per second, 8 data bits, no parity, and 1 stop bit.
When using RealPort (COM port redirection) these settings are supplied by applications running on the
PC or server, and the default values on your Digi device server do not need to be changed.
The possible settings are as follows:
n Description: Specifies an optional character string for the port which can be used to identify
the device connected to the port.
n
MEI Type: The MEI (multi-electronic interface) type sets the type of serial interface if the
ConnectPort LTS is the MEI version. The MEI version has three kinds of serial interfaces: RS232,
RS422/485 (full), and RS485Half. If the ConnectPort LTS is not the MEI version, MEI Type will be
fixed to RS232 and you cannot change it.
n
Baud Rate: Select the baud rate value for the serial device.
n
Data Bits: Select the data bits value for the serial device.
n
Parity: Select the parity for the serial device.
n
Stop Bits: Select the stop bit value for the serial device.
n
Flow Control: Select the flow control value for the serial device.
n
Enable termination: When selected, enables termination.
Advanced Serial Settings
The following settings are advanced settings used to fine tune the serial port and access to the serial
interface. The default settings will typically work in most situations.
Note The advanced settings rarely need to be changed.
Serial Settings:
n Enable Port Logging: Port logging allows you to save serial data to the memory of the Digi
device server. Once enabled, the port log can be viewed by selecting Port Logs on the Serial
Port Management page (Management > Serial Ports). Port Logging is enabled in the CLI via
the set buffer command.
n
Log Size: The size in kilobytes of the memory buffer used to save serial data when port logging
is enabled.
n
Automatic backup: The port data is stored to specified location automatically.
n
Unlimited automatic backup size: When enabled, the automatic backup size is not limited.
n
Automatic backup size: This option defines the amount of the log to backup at a time.
Digi ConnectPort LTS User Guide
102
ConnectPort LTS web interface
n
Peripheral
Enable SYSLOG service: The port data can be stored to the SYSLOG server in addition to the
port log storage location at the same time.
UDP Settings:
These UDP Settings are available only when the current port is configured with the Console
management, the UDP Sockets, or the Custom Profile.
n
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. Enter non-printable characters as
follows:
Character
Key
Sequence
backspace
\b
formfeed
\f
tab
\t
line feed
\n
return
\r
backslash
\\
hexadecimal
values
\xhh
TCP Settings:
These TCP Settings are available only when you configure the current port with the Console
Management, Custom, or TCP Sockets profile.
n
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. Enter non-printable characters as
follows:
Character
Key
Sequence
backspace
\b
formfeed
\f
tab
\t
line feed
\n
return
\r
backslash
\\
hexadecimal
values
\xhh
Digi ConnectPort LTS User Guide
103
ConnectPort LTS web interface
n
Peripheral
Send data only under any of the following conditions: Enable if you need to specify the
conditions when the Digi device server will send the data read from the serial port to the TCP
destination.
n
Send when data is present on the serial line: Send the data to the network destinations
when a string of characters is detected in the serial data. To enter non-printable characters,
use these key sequences:
Key
Character
Sequence
hexadecimal
\xhh
values
n
tab
\t
line feed
\n
backslash
\\
Match string: A 1 to 4 character string. This is usually the newline character sequence but can
also be a custom string of 1 to 4 characters.
n
Strip string before sending: Search for the string specified in the Match String field before
sending the data and strip the string from the string from the data before it is sent to the
destination.
n
Send after the following number of idle milliseconds: Send the data after the specified
number of milliseconds have passed with no data received on the serial port.
n
Send after the following number of bytes: Send the data after the specified number of
bytes have been received on the serial ports
n
Close connection after the following number of idle seconds: Enable to close an idle
connection. Use the Timeout field to enter the number of seconds that the connection will be
idle before it is closed. This can be 1 to 65000 seconds.
n
Close connection when DCD goes low: When selected, the connection will be closed when the
DCD (Data Carrier Detected) signal goes low.
Note If you are using 8-wire cabling, you must apply the altpin for DCD functionality.
n
Close connection when DSR goes low: When selected, the connection will be closed when the
DSR (Data Set Ready) signal goes low.
Authentication Settings
n
Authentication method: The authentication method. The default is None.
The Digi device supports various authentication options, such as None, Local, RADIUS, LDAP.
Digi ConnectPort LTS User Guide
104
ConnectPort LTS web interface
n
Application
Primary/Secondary authentication server: The IP address or DNS name of the remote
authentication server.
n
Authentication server socket: The TCP port number of the authentication server.
n
Primary/Secondary account server: The IP address or DNS name of the remote accounting
server. The accounting server is only required when you set the authentication method to
RADIUS.
n
Account server socket: The TCP port number of the accounting server.
n
Shared secret: A password string used for encryption of messages between the authentication
server and the ConnectPort LTS. Only RADIUS servers require a shared secret.
n
Timeout: The authentication timeout, in seconds. Only RADIUS servers require a timeout value.
n
Retries: The authentication retry count. Only RADIUS servers require an authentication retry
count.
n
LDAP search base: The LDAP search base string. Only LDAP servers require a search base
string.
n
Domain name for active directory: The LDAP domain name string for Active Directory. Only
LDAP servers require a domain name of Active Directory.
n
Secure LDAP: Allows you to enable Secure LDAP for LDAP servers. The default is Disable. Only
LDAP servers require this option.
Note Default permissions for authenticated remote users are defined under the user name
ruser.
Application
Most Digi devices support additional configurable applications. Use the options under Application to
configure applications. The application options vary depending on the Digi device.
n PPP: Connects incoming clients or serial devices to external networks using modems and
telephony to maintain the connection.
n
Python: For loading and running custom programs authored in the Python programming
language.
n
RealPort: Configures RealPort settings.
PPP (Point-to-Point Protocol)
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 the device has access to the resources of the network as if it were directly
connected to the network. Use the PPP (Point-to-Point Protocol) page to connect incoming clients or
serial devices to an external network using modems and telephony to maintain the connection.
Digi ConnectPort LTS User Guide
105
ConnectPort LTS web interface
Application
Basic PPP Settings
Use Basic PPP Settings to configure the most commonly used settings for incoming and outgoing PPP
connections. You should configure these settings before creating any incoming or outgoing
connections.
You can use Basic PPP Settings to enable or disable the Dynamic IP Address Pool. The Dynamic IP
Address Pool is a set of reserved IP addresses unique to the network that are assigned to the
incoming connections. You can set the first IP address to use and the number of sequential addresses
(plus one) to be reserved for assignment.
n Enable Dynamic IP Address Pool for Incoming Connections: Enables or disables the
Dynamic IP Address Pool used by incoming connections. The Dynamic IP Address Pool is a set of
reserved IP addresses that can be automatically supplied to each incoming PPP connection.
Each connection that is set up to automatically assign an IP address is supplied a different
address from the pool. The set of addresses in the pool must to be unique to the network so
that network conflicts do not occur.
n
First IP Address: Specifies the first IP address that the address pool should start with. The IP
address pool contains this address and all successive addresses up to the number of IP
addresses specified plus one for the network interface. For example, if the first IP address is
10.0.0.1 and the number of addresses is 4, then the Dynamic IP Address Pool will contain
10.0.0.1, 10.0.0.2, 10.0.0.3, 10.0.0.4, and 10.0.0.5.
n
Number of Addresses: Specifies the number of addresses to use in the pool. Note that you
should verify that none of the addresses from the first IP address up to the number of
addresses plus one is already in use on the network.
Configure basic PPP settings
To automatically assign an IP address for an incoming PPP client:
1. Select Application > PPP.
2. Click Basic PPP Settings.
3. Select Enable Dynamic IP Address Pool for Incoming Connections.
4. Type the IP address for the incoming PPP client in the First IP Address field.
5. Type the number of addresses in the Number of Addresses field.
Digi ConnectPort LTS User Guide
106
ConnectPort LTS web interface
Application
6. Incoming PPP Connections: Use this section to make and maintain rules for incoming PPP
connections. To make a new rule for incoming PPP connections.
a. Click New connection.
b. On the Serial Port section of the Incoming connection page, select the serial ports
for this connection rule.
c. On the Authentication Configuration section, type the User Name and Password
to use for PPP authentication such as NONE/PAP/CHAP/BOTH.
Note To use the Local authentication method for serial port authentication, you
must enter the User Name and Password of an existing system user.
If you are going to use the None method for serial port authentication, you can add
any user, including users not in the local database of system users, and you can
select a user name from the PPP User menu on the Authentication page of the
serial port.
d. Select the authentication method from one of following methods:
NONE: The remote user does not require PPP authentication.
PAP: Password Authentication Protocol (PAP) authentication is
required.
CHAP: Challenge Handshake Authentication Protocol (CHAP)
authentication is required.
BOTH: Both CHAP and PAP authentication are required.
e. In the Peer Configuration section, select one of the following options for assigning
the IP address of the incoming PPP client:
Automatically assign remote IP address from IP address pool: If
you select this option, the IP address for the incoming PPP client will
be automatically assigned from the IP address pool set on the Basic
PPP Settings page.
Allow remote peer to specify remote IP address: If you select this
option, the incoming PPP client will specify the IP address used for
the PPP connection.
Assign static remote IP address: If you select this option, the IP
address for incoming PPP client will be assigned as specified by the
Remote IP address.
Digi ConnectPort LTS User Guide
107
ConnectPort LTS web interface
Application
f. In the Peer Configuration section, select Allow client access to local network
via PPP connection if you want the incoming PPP client to be able to access the
ConnectPort LTS or other devices on the network through the ConnectPort LTS
PPP interface. Once you enable this option, you can select one of the following
options for assigning the IP address of the local PPP interface:
Automatically assign local IP address from IP address pool: The
IP address for the local PPP interface is automatically assigned from
the IP address pool set on the Basic PPP Settings page.
Assign static local IP address: The IP address for the local PPP
interface is assigned as specified by the local IP address.
g. In the Advanced Configuration section, select Enable idle timeout if you want to
close the PPP connection when there is no activity from the incoming PPP client
during the time specified by Timeout.
7. Advanced PPP Settings: If you want the incoming PPP client to be able to access the local
network where the ConnectPort LTS is connected, select the Process ARP Requests (Proxy
ARP) option.
Note Use Advanced PPP Settings when IP addresses assigned to the PPP link are on the
same local network subnet as the local LAN.
Incoming PPP Connections
Incoming PPP connections are connections where you can dial in to the ConnectPort LTS device. You
can connect to the ConnectPort LTS device using a modem to dial the phone number of the modem
connected to the serial port. For example, you can use a modem to access the network associated
with the Digi device server or use modems to create a network bridge by connecting two separate
networks.
See Configure incoming PPP connections for more information.
n Serial ports: Select the serial ports or internal modem associated with incoming PPP
connections.
Digi ConnectPort LTS User Guide
108
ConnectPort LTS web interface
n
Application
Authentication Configuration:
l
User Name: Specifies the user name for this connection. The user provides the user name
and password when connecting to the device. This user name must be unique to the device
so that no other incoming PPP connection, outgoing PPP connection, or system user uses
it.
l
Password/Confirm Password: Specifies the password for this connection. This is the
password that the user specifies when connecting and logging into the device.
l
Associate with "ANYBODY": Select this check box when multiple PPP users will connect to
one or more serial ports. When you clear this check box, there is only one user dedicated to
the selected ports.
l
Authentication: Specifies the type of authentication required by this PPP connection. You
must supply the same type of authentication for your dial-up connection as specified here
in order to successfully connect.
NONE: No authentication is required. This is the recommended default for authentication.
CHAP: CHAP (Challenge Handshake Authentication Protocol) provides secure encrypted
authentication. CHAP periodically verifies the identity of the peer using a 3-way handshake.
This is done upon initial link establishment and may be repeated anytime after the link has
been established. (See RFC 1334 for further details.) CHAP authentication will work
between two ConnectPort LTS devices.
Note ConnectPort LTS does not support MS-CHAP (Microsoft specific implementation of
CHAP).
PAP: Many ISPs and corporate PPP servers use PAP (Password Authentication Protocol).
PAP provides a simple method for the peer to establish its identity using a 2-way
handshake. This is done only upon link establishment. (See RFC 1334 for further details.)
BOTH: CHAP authentication will work between two ConnectPort LTS products. CHAP will
be negotiated to PAP for all other connections.
Digi ConnectPort LTS User Guide
109
ConnectPort LTS web interface
n
Application
Peer Configuration: Specifies how to assign the remote IP address that is supplied to the
client.
l
Automatically assign remote IP address from IP address pool: Automatically assigns
the remote IP address with a unique address from the IP address pool (as configured in
Basic PPP Settings). The assigned address will not conflict with any other PPP connection
using the Dynamic IP Address Pool.
Note The Dynamic IP Address Pool must be enabled.
l
Allow remote peer to specify remote IP address: The remote peer automatically assigns
the remote IP address.
l
Assign static remote IP address: Assigns the IP address entered in the Remote IP
Address field to the remote IP address. This connection will always be assigned this same
IP address. Use this option if the client needs to have the same IP address if it is running as
a server.
l
Remote IP Address: Specifies the static remote IP address.
l
Allow client access to local network via PPP connection: Specifies whether the remote
client should have access to the local Ethernet network when they dial in to the PPP
connection. This option requires the ConnectPort LTS device to have a unique local IP
address for each PPP connection to handle the routing between the PPP connection and
the local network.
l
Automatically assign local IP address from IP address pool: Automatically assigns the
local IP address with a unique address from the IP address pool (as configured in Basic PPP
Settings). The assigned address will not conflict with any other PPP connection using the
Dynamic IP Address Pool.
Note The Dynamic IP Address Pool must be enabled.
l
Assign static local IP address: Assigns the IP address entered in the Local IP
Address field to the local IP address. This connection will always be assigned this same IP
address. Use this option if the client needs to have the same IP address if it is running as a
server.
l
Local IP Address: Specifies the local IP address to use for the PPP connection. This IP
address must be unique on the network and must not be the same as the remote IP
address or any address in the Dynamic IP Address Pool. Digi recommends that this address
should reside on a different subnet than the Ethernet IP address.
Digi ConnectPort LTS User Guide
110
ConnectPort LTS web interface
n
Application
Advanced configuration: Specifies how to assign the remote IP address supplied to the client.
Enable Idle Timeout: When selected, enables idle timeout for this connection. The idle time is
the elapsed time after receiving the last byte from this connection. If you clear this check box,
the connection can remain idle for any amount of time. If you select this check box, the
connection closes after the connection has been idle for specified number of seconds in the
Timeout field.
n
Timeout: The maximum allowed time (in seconds) a connection can remain idle before it is
closed.
Configure incoming PPP connections
This section describes how to configure an incoming PPP connection. Use it to configure a PPP
connection that will be initiated by another system dialing into the ConnectPort LTS server.
Prerequisite Assign a modem profile with an incoming connection to the Digi device server port. See
Assign a profile to a serial port for more information.
To configure the rules for incoming PPP connections:
1. Select Application > PPP.
2. Click Incoming PPP Connections.
3. Click New Connection.
4. Under Authentication Configuration, complete the following fields:
n
User Name: Type the user name.
n
Password/Confirm Password: Type the password.
n
Associate with "ANYBODY": Enable when you want the user name and password
associated with any PPP user.
n
Authentication: Choose one of the following authentication methods:
l
NONE: The remote user does not require PPP authentication.
l
CHAP: Challenge Handshake Authentication Protocol (CHAP) authentication is
required.
l
PAP: Password Authentication Protocol (PAP) authentication is required.
l
BOTH: Both CHAP and PAP authentication are required.
PPP authentication uses this information.
Note To use the Local authentication method for serial port authentication, you need to enter
the user name and password of an existing system user. If not, the PPP connection will fail
because you cannot specify a PPP user on the Authentication page of the serial port
separately.
If you choose the None authentication method for serial port authentication, you can add any
user even if the user is not in the local database as a system user; you can select a user name
from the PPP User menu on the Authentication page for the serial port.
Digi ConnectPort LTS User Guide
111
ConnectPort LTS web interface
Application
5. Under Peer Configuration, select one of the following options for assigning the IP address of
an incoming PPP client:
n
Automatically assign remote IP address from IP address pool: Select this option if
you want to automatically assign the IP address for the incoming PPP client from the IP
address pool set on the Basic PPP Settings page. If you want the IP address to be
assigned dynamically, you must first configure a pool of IP addresses on the Basic PPP
Settings page. See Basic PPP Settings for more information.
n
Allow remote peer to specify remote IP address: Select this option if you want the
incoming PPP client to specify the IP address to use for the PPP connection.
n
Assign static remote IP address: Select this option if you want to assign the IP
address for incoming PPP client as specified by the Remote IP address.
6. Under Peer Configuration, select Allow client access to local network via PPP connection
if you want the incoming PPP client to access the ConnectPort LTS or other devices on the
network through the ConnectPort LTS PPP interface. If you enable this option, select one of
the following options for assigning the IP address of the local PPP interface.
n
Automatically assign local IP address from IP address pool: Automatically assign
the IP address for the local PPP interface from the IP address pool set on the Basic PPP
Settings page. If you choose this option, type the IP address in the Remote IP Address
field.
n
Assign static local IP address: Assign the IP address for the local PPP interface is as
specified in the Local IP Address field. If you choose this option, type the IP address in
the Local IP Address field.
7. Under Advanced Configuration, select Enable idle timeout if you want to close the PPP
connection when there is no activity from the incoming PPP client after a specified number of
seconds and type the number of seconds in the Timeout secs field.
The dial-in user will need to know the following:
n The phone number for the modem attached to this Digi device server.
n
The Username, Password, and type of Authentication configured in the preceding task.
Setting up incoming PPP connections
To correctly configure the settings for incoming PPP connections:
1. Select Application > PPP.
2. Configure the PPP settings.
3. Select Configuration > Serial Ports.
4. Configure the serial port settings.
Outgoing PPP Connections
Use Outgoing PPP Connections to configure outgoing PPP connections.
The ConnectPort LTS device uses the outgoing PPP connections to connect to an external modem or
ISP. Outgoing PPP connections typically automatically connect the Digi device server to an external
Digi ConnectPort LTS User Guide
112
ConnectPort LTS web interface
Application
modem or ISP network when the main Ethernet network goes down. This allows the device to
continue communication on the network or allow connections from the network when the main
Ethernet network is down.
n Username: The username for this connection.
n
Phone Number 1: The phone number used to connect to the remote system.
n
Phone Number 2: Alternate phone number used to connect to the remote system.
n
Action: Lists the available actions per user. The Remove action allows you to remove the user.
Configure outgoing PPP connections
This section describes how to configure an outgoing PPP connection. Use it to configure a PPP
connection that will be initiated by another system dialing into the ConnectPort LTS server.
Prerequisite Assign a modem profile with an outgoing connection to the Digi device server port. See
Assign a profile to a serial port for more information.
To create or modify the rules for outgoing PPP connections:
1. Select Application > PPP.
2. Click Outgoing PPP Connections.
3. Choose one of the following options:
n
To create a new rule, click New Connection.
n
To modify an existing rule, click a user name under the Username column.
4. Under Serial Ports, select the serial ports to which you want the connection rule to apply.
Digi ConnectPort LTS User Guide
113
ConnectPort LTS web interface
Application
5. Under Authentication Configuration, complete the following fields:
n
User Name: Type the user name.
n
Password/Confirm Password: Type the password.
n
Phone Number 1: Specifies the phone number used to connect to the remote system.
n
Phone Number 2: Specifies the alternate phone number used to connect to the remote
system.
n
Authentication: Choose one of the following authentication methods:
l
NONE: The remote user does not require PPP authentication.
l
CHAP: Challenge Handshake Authentication Protocol (CHAP) authentication
provides secure encrypted authentication. CHAP periodically verifies the identity of
the peer using a 3-way handshake. This is done upon initial link establishment and
may be repeated anytime after the link has been established. (See RFC 1334 for
details.) CHAP authentication will work between two ConnectPort LTS devices.
Note MS-CHAP (Microsoft specific implementation of CHAP) is not supported.
l
PAP: Password Authentication Protocol (PAP) authentication is required. PAP
provides a simple method for the peer to establish its identity using a 2-way
handshake. This is done only upon link establishment. (See RFC 1334 for further
details.)
l
n
BOTH: Both CHAP and PAP authentication are required (recommended).
Use login script: Enable when you want to use a login script and type the path to the
login script in the Dial chat script field.
PPP authentication uses this information.
6. Under Peer Configuration, select one of the following options for assigning the IP address of
an incoming PPP client:
n
Automatically obtain remote IP address remote peer: Select this option if you want
to automatically assign the IP address supplied by the remote peer.
n
Request specific address: Select this option if you want to request the specified IP
Address from the remote peer. There is no guarantee this IP address is assigned to this
connection. The address is only requested. Some service providers do not allow you to
request IP addresses and others only allow you to assign a certain range of addresses.
Ask the service provider of the system you want to connect to if you can request an IP
address.
Advanced PPP Settings
The ConnectPort LTS product uses advanced PPP settings to enable the routing table to use and
process ARP requests received by this device. Process ARP requests are also known as Proxy ARP.
ARP requests inform devices how and where to connect to a specific device. PPP connections use this
setting. The setting is disabled by default.
Digi ConnectPort LTS User Guide
114
ConnectPort LTS web interface
Application
Configure advanced PPP settings
To enable or disable Proxy ARP:
1. Select Application > PPP.
2. Click Advance PPP Connections.
3. Select or clear the Process ARP Requests (Proxy ARP) check box to enable or disable Proxy
ARP.
4. Click Apply to save your changes.
Configure settings on serial ports
To configure the settings on serial ports:
1. Select a port from Configuration > Serial ports > Ports Settings.
2. Click Change Profile and change the port profile to modem.
3. In the Port Profile Settings > Modem Settings section, select Incoming Connections.
4. Select Enable PPP connections on this modem if you want to establish a PPP connection.
5. Set configurations on Basic Serial Settings and Advanced Serial Settings sections according
to your environment.
6. Select the authentication method of the serial port in the Authentication Settings section. If
the port profile is set to modem, you can only select None or Local authentication method.
7. Select PPP User from the list if you set authentication method to None.
If you select the Local authentication method, you cannot select a PPP user separately. To
make the correct PPP connection with the Local serial port authentication method, you need
to have the PPP connection configuration with the same user name and password as in the
local system user database set on Configuration > Users. (See Configure incoming PPP
connections.)
Note If your serial port or internal modem uses local authentication with a user in the local
database, you must use the Show Terminal window on your PPP client. When the terminal
window opens, log in to the serial port and then close the terminal window. PPP negotiation
will start once you close the terminal window.
Python Configuration
If you have a Python-enabled ConnectPort LTS device, you can manage Python files using the
Application > Python menu options. Python options include:
n Uploading Python program files to the ConnectPort LTS device
n
Deleting a Python program file from the device
n
Configuring which Python programs to execute when the ConnectPort LTS device boots (also
known as auto-start programs)
Digi ConnectPort LTS User Guide
115
ConnectPort LTS web interface
Application
Python Files
The Python Files page allows you to upload and manage Python programs on a ConnectPort LTS
device.
n Upload Files: Click Choose File to select a file to upload and click Upload.
n
Manage Files: Select any files to remove from the ConnectPort LTS device and click Delete.
Auto-start settings
Use the Auto-start Settings page to configure Python programs to execute when the ConnectPort
LTS device boots. You can configure up to four auto-start entries.
n Enable: When selected, the program specified in the Auto-start command line field runs when
the device boots.
n
Auto-start command line: Specify the name of a Python program file to be executed and any
arguments to pass to the program using the following syntax:
filename [arg1 arg2...]
Manually execute uploaded Python programs
To manually execute an uploaded Python program on a ConnectPort LTS device:
n
Access the Digi device command-line interface and type the following command:
python filename [arg1arg2...]
View and manage Python programs
To view Python threads running on the ConnectPort LTS device:
n Access the Digi device command-line interface and type the who command.
Python program management and programming resources
Digi incorporates a Python development environment into ConnectPort LTS devices. Digi integration of
the universal Python programming language allows customers an open standard for complete control
of connections to devices, the manipulation of data, and event-based actions.
Recommended distribution of Python interpreter
The current version of the Python interpreter embedded in Digi devices is 2.6.2. Use modules known
to be compatible with this version of the Python language only.
Digi Wiki for Developers
Digi Wiki for Developers is where you can learn how to develop solutions using Digi's communications
products, software and services. The wiki includes how-to's, example code, and M2M information to
speed application development. Digi encourages an active developer community and welcomes your
contributions.
www.digi.com/wiki/developer/index.php/Main_Page
Digi Python Programmer's Guide
The Digi Python Programmer’s Guide introduces the Python programming language by showing you
how to create and run a simple Python program. It reviews Python modules, particularly modules with
Digi ConnectPort LTS User Guide
116
ConnectPort LTS web interface
Application
Digi-specific behavior. It describes how to load and run Python programs onto Digi devices, either
through the command-line or web user interfaces, and how to run several sample Python programs.
To access the Digi Python Programmer's Guide:
1. Go to www.digi.com/wiki/developer/index.php/Digi_Python_Programmer's_Guide.
2. In the Start Here section, click Digi Python Programmer's Guide.
For general Python programming language information:
1. Go to www.python.org/.
2. Click Documentation.
Python support forum on digi.com
Find answers to common questions and exchange ideas and examples with other members of the Digi
Python development community at:
www.digi.com/support/forum/categories/python
RealPort configuration
Install and configure RealPort software on each computer that uses the RealPort ports on the Digi
device. The RealPort software is available for downloading from the Digi Support website. For
complete information on installing and using RealPort software, see RealPort Installation Guide.
Install RealPort software
To install RealPort software from the Digi Support site:
1. Open a browser and go to the Digi Support website.
2. Click the Find drivers, documentation and firmware and then click Drivers.
3. Under Select Your Product for Support, type the name of your Digi device in the Enter a
product keyword field.
4. Select your Digi device from the product list.
5. Select the operating system for your computer from the Operating System Specific Drivers
list.
6. Click the link for the RealPort zip file and save it to your computer.
7. Extract the files from the RealPort zip file and run the RealPort setup wizard.
RealPort Settings
Use the RealPort Configuration page to configuring the RealPort application. The available settings
are as follows:
n RealPort Settings:
l
Enable Keep-Alives: Enables the sending of RealPort keep-alives. RealPort protocol sends
keep-alive messages approximately every 10 seconds to connected devices indicating the
connection is still alive. RealPort keep-alives are different from TCP keep-alives, which are
done at the TCP layer.
Note that RealPort keep-alives generate additional traffic which may be undesirable in
situations where traffic is measured for billing purposes.
Digi ConnectPort LTS User Guide
117
ConnectPort LTS web interface
l
Management
Enable Exclusive Mode: Exclusive mode allows a single connection from any one RealPort
client ID. If you enable this setting and a subsequent connection occurs that has the same
source IP as an existing connection, the existing connection is forcibly reset under the
assumption that it is stale.
Management
Use the Management menu to view and manage connections and services for the ConnectPort LTS
product.
You can monitor the port, device, system, and network activities of ConnectPort LTS devices from a
variety of interfaces. Changes in data flow may indicate problems or activities that may require
immediate attention.
This chapter discusses monitoring and connection-management capabilities and tasks in ConnectPort
LTS products.
Serial Port Management
The Serial Port Management page (Management > Serial Ports) provides an overview of the serial
ports and their connections. Click Connections to display the active connections for a serial port. You
can refresh the view to see new serial-port connections, and you can disconnect serial-port
connections as needed.
Port Connections Management
The Port Connections Management page (Management > Serial Ports > Connections) displays active
system connections.
Manage PPP connections
The Active PPP Connections list provides an overview of connections associated with PPP interfaces.
Manage active system connections
The Active System Connections list provides an overview of connections associated with various
interfaces, such as:
n User connections to the device’s web interface
n
Connections to the command line through the local shell
n
Python threads currently running
n
Protocols used for the connections
n
The number of active sessions for each connection
Use this list to determine which connections are no longer needed. You can disconnect connections
that are no longer needed.
Port Logging Management
The Port Logging Management page displays the logs for a selected port.
Digi ConnectPort LTS User Guide
118
ConnectPort LTS web interface
n
Administration
Logging: Displays one of the following options:
l
On: Logging is enabled.
l
Off: Logging is disabled.
n
Buffer Utilization: Displays the percentage of buffer utilization.
n
Pause Logging/Start Logging: Allows you to stop and start logging.
n
Refresh: When clicked, displays the latest log information.
n
Clear Log: When clicked, deletes the log information.
Administration
You can periodically perform administration tasks on ConnectPort LTS products, such as:
n File management
n
Changing the password used for logging onto the device
n
Backing up and restoring device configurations
n
Updating firmware and Boot/POST code
n
Restoring the device configuration to factory defaults
n
Rebooting the device
The Administration section in the web interface provides the following options:
n File Management: Upload and manage files, such as custom web pages, applet files, and
initialization files. See File Management for more information.
n
Python Program File Management: Upload custom programs in the Python programming
language to Digi devices and configuring the programs to execute automatically at startup. See
Python Configuration for more information.
n
Backup/Restore: Back up or restore device configuration settings. See Backup/Restore for
more information.
n
Update Firmware: Update the firmware, including Boot and POST code. See Update Firmware
for more information.
n
Factory Default Settings: Restore a device to factory default settings. See Factory Default
Settings for more information.
n
System Information: Display general system information for the device and device statistics.
See System Information for more information.
n
Reboot: Reboot the device. See Reboot for more information.
These administrative tasks are organized elsewhere in the web interface:
n Enable and disable network services. See Reboot for more information.
n
Enable password authentication for the ConnectPort LTS. See Users for more information.
Certificate Management
Use the Certificate Management page to upload your certificates and private key to the Digi device
server.
Digi ConnectPort LTS User Guide
119
ConnectPort LTS web interface
Administration
CAUTION! You must restart the web server for changes to take effect. To restart the
web server, click Restart Web Server.
You can also generate a temporary self-signed certificate for testing purposes. To generate a
temporary certificate, click Generate.
File Management
Use the File Management page to upload custom files to a ConnectPort LTS product, such as an
image file containing your company logo. You can use custom applets and HTML files to alter the
interface either by adding a different company logo, changing colors, or moving information to
different locations.
If you upload an index.htm or index.html file, that file automatically loads when you sign in to a Digi
device from the web browser.
Upload files
To upload files to a ConnectPort LTS:
1. Select Administration > File Management.
2. Click Choose File to locate and select the file.
3. Click Upload.
Delete files
To delete files from a ConnectPort LTS:
1. Select Administration > File Management.
2. Select the Action check boxes next to files that you want to delete.
3. Click Delete.
Factory reset does not delete custom files
A factory reset does not delete files uploaded to the File Management page. When you restore the Digi
device to factory defaults or press the Reset button on the device (see Factory Default Settings), the
uploaded files remain. This allows you to retain custom applets and custom factory defaults. If you
want to remove custom files you must manually delete them (see Delete files). The root user also can
delete custom files by accessing the command-line interface.
Backup/Restore
After you configure a ConnectPort LTS device, back up the configuration settings. You can restore the
backup configuration settings if a problem occurs when updating the firmware or adding hardware. If
you need to configure multiple devices, you can use the backup/restore feature to load the backup
configuration settings from the first device onto the other devices.
Back up or restore a device configuration from the web interface
You can back up or restore a device configuration to a server from the web-interface and download a
configuration from a server to a file
To backup a device configuration:
Digi ConnectPort LTS User Guide
120
ConnectPort LTS web interface
Administration
1. Click Administration > Backup/Restore. The Backup/Restore page appears.
2. Select the storage location type. The ConnectPort LTS basic version supports NFS/Samba/User
space/Local machine for the location. The default filename for the backup file is backup.cfg.
3. Click Backup.
To restore a device configuration:
1. Click Administration > Backup/Restore. The Backup/Restore page appears.
2. Select the storage location type. The ConnectPort LTS basic version supports NFS/Samba/User
space/Local machine for the location. The default filename for the backup file is backup.cfg.
3. Select the Keep Network Settings check box if you want to retain the basic network settings,
such as IP address, subnet mask, and gateway.
Note If the restored configuration modifies the network settings, your Digi device server will
dynamically switch to the new settings. You will need to manually redirect your browser to the
new IP address.
4. Select the file to restore from the Restore From File field or click Choose File to locate and
select the file.
5. Click Restore.
Backup or restore a 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.
The format for the backup command is as follows:
backup [to=serveripaddress[:filename]|
[to={sd|usb|nfs|samba|userspace}[:filename]]
[from=serveripaddress[:filename] print]|
[from={sd|usb|nfs|samba|userspace}[:filename]]
Parameters
n
to=serveripaddress[:filename]: The IP address of the TFTP server where you save the
configuration file and the name of the configuration file. If you do not specify a filename, the
default filename is config.rci.
n
to=(sd|usb|nfs|samba|userspace)[:filename]: The location of the storage device where you
save the configuration file and the name of the configuration file. If you do not specify a
filename, the default filename is config.rci.
n
from=serveripaddress[:filename]: The IP address of the TFTP server where the configuration
file resides and the name of the configuration file you want to restore. If you do not specify a
filename, the default filename config.rci is used. In ConnectPort LTS, after you restore the
configuration file the system will be rebooted.
Digi ConnectPort LTS User Guide
121
ConnectPort LTS web interface
n
Administration
from=(sd|usb|nfs|samba|userspace)[:filename]: The location of the storage device where
the configuration file resides and the name of the configuration file you want to restore. If you
do not specify a filename, the default filename config.rci is used.
n
print: Prints the current device configuration.
Example:
#> backup from=10.0.0.1:config.rci
Update Firmware
To update the firmware for a ConnectPort LTS device, choose one of the following options:
n Updated the firmware from Administration > Update Firmware page in the web interface.
n
Update the firmware from the command-line interface via TFTP or BOOTP.
Digi recommends downloading the firmware to a local hard drive before upgrading the firmware.
Update the firmware from the web interface
Before you update the firmware from the web interface:
1. Download the latest firmware from http://www.digi.com/support.
2. Read the release notes to determine if there are any special steps to complete before
updating the firmware.
To update the firmware from the web interface:
1. Click Administration > Update Firmware. The Update Firmware page appears.
2. Click Choose File to locate and select the firmware file.
3. Click Update.
Important DO NOT close the browser until the update is complete and a reboot prompt
appears.
Update the firmware from the command-line interface on a TFTP or BOOTP server
Before you update the firmware from the web interface:
1. Download the latest firmware from http://www.digi.com/support.
2. Read the release notes to determine if there are any special steps to complete before
updating the firmware.
3. Ensure the TFTP or BOOTP server is running before you start this task.
To update the firmware from a TFTP or BOOTP server:
n
From the command-line interface on a TFTP or BOOTP server, issue the following command:
boot load=host ip address:loadfile
See the description of the boot command in the ConnectPort LTS Command Reference for more
information.
Digi ConnectPort LTS User Guide
122
ConnectPort LTS web interface
Administration
Update the BIOS code
You can only update the BIOS code through the boot loader. To update BIOS code, see ConnectPort
LTS disaster recovery.
Important Before uploading the firmware, read the firmware Release Notes to see if you need to
update the BIOS code before updating the firmware.
Factory Default Settings
Restoring a ConnectPort LTS device to its factory default settings clears all current configuration
settings with some exceptions. See the following topics for more information:
n Settings cleared and retained during a factory reset
n
File Management
There are several ways to reset the device configuration of a ConnectPort LTS product to the factory
default settings:
n
From the web interface using the Restore Factory Defaults operation
This method is the best way to reset the configuration, because you can back up the settings
using the Backup/Restore operation. The Backup/Restore operation provides a means to
restore the configuration after the configuration issues have been resolved. See Reset the
factory settings on a ConnectPort LTS product from the web interface for more information.
n
From the command-line interface, using the boot or revert commands
n
Using the reset button on the ConnectPort LTS device
Use this method if you cannot access the device from a web browser. The location of the reset
button may vary. See Reset the factory settings on a ConnectPort LTS product using the Reset
button for more information.
n
From the LCD display under Miscellaneous
Settings cleared and retained during a factory reset
A factory reset does not delete files uploaded to the File Management page. See Factory reset does
not delete custom files for more information.
n Restore: Returns the configured settings on the Digi device to the factory defaults.
n
Keep network settings: Select this check box to retain the IP address settings.
n
Restore Only Serial Port Settings: Select this check box to restore only the serial settings to
their factory defaults. The other configuration settings remain as-is.
Reset the factory settings on a ConnectPort LTS product from the web interface
To reset the factory settings on the ConnectPort LTS from the web interface:
1. Create a backup copy of the configuration using the Backup/Restore operation. See
Backup/Restore for more information.
2. Select Administration > Factory Default Settings. The Factory Default Settings page appears.
Digi ConnectPort LTS User Guide
123
ConnectPort LTS web interface
Administration
3. (Optional) Choose one or both of the following options:
n
To keep the network settings for the device, such as the IP address, select the
Keep network settings check box.
n
To reset the serial port settings only, select the Restore Only Serial Port Settings check
box.
4. Click Restore.
Reset the factory settings on a ConnectPort LTS product using the Reset button
To reset the factory settings on a ConnectPort LTS product using the Reset button:
1. Locate the Factory Reset button on the front of device, as shown in the following image.
2. Gently press the Factory Reset button with a non-conducive, small diameter tool (such as wood
or plastic) with a blunt end. Do not use a sharp-ended tool or the button could be damaged.
3. Hold down the Factory Reset button for 2~3 seconds and then release it.
4. Check the status of the Ready LED. When the restoration is complete, the Ready LED will turn
on again.
System Information
The System Information page displays general system information about the ConnectPort LTS device.
Technical support uses this information to troubleshoot problems. To display these pages, go to
Administration > System Information.
General
The General page displays the following general system information:
n Model: The model of the ConnectPort LTS product.
n
Ethernet MAC Address: A unique network identifier required for all network devices. The MAC
address appears on a sticker on the Digi device and consists of 12 hexadecimal digits, usually
starting with 00:40:9D.
n
Firmware Version: The current firmware version running in the Digi device. Use this
information to locate and download new firmware. You can download firmware updates from:
http://www.digi.com/support.
n
Bios Version: The current boot code version running in the Digi device.
n
POST Version: The current Power-On Self Test (POST) code version running in the Digi device.
n
CPU Utilization: The amount of CPU resources the Digi device uses.
n
Up Time: The amount of time the Digi device has been running since it was last powered on or
rebooted.
Digi ConnectPort LTS User Guide
124
ConnectPort LTS web interface
n
Administration
Total/Used/Free Memory: The amount of memory (RAM) available, currently in use, and
currently not being used.
n
Power status: For models with dual power supply, Power status shows the status of the
power supplies. For example, if power supply 1 for a ConnectPort LTS 16 MEI unit is
disconnected but power supply 2 is connected, the power status appears as follows:
Power status: Dual power (1 - Fail, 2 - Normal)
Serial
The Serial page under Administration > System Information lists the configured serial ports for the
ConnectPort LTS products. Click a port to view detailed serial port information on the Serial Port
Diagnostics page.
Serial Port Diagnostics
The Serial Port Diagnostics page displays information on the current state of a serial port on your Digi
device.
n
Configuration: The Configuration page displays the electrical interface (Port Type) and basic
serial settings.
n
Signals: The Signals pane shows the state of serial port signals. The serial port signals are
green when asserted (on) and gray when not asserted (off). These signals are defined as
follows:
n
l
RTS: Request To Send.
l
CTS: Clear To Send.
l
DTR: Data Terminal Ready.
l
DSR: Data Set Ready.
l
DCD: Data Carrier Detected.
Serial Statistics: The Statistics section 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, you may have a problem with your Digi device server.
l
Total Data In: Total number of data bytes received.
l
Total Data Out: Total number of data bytes transmitted.
l
Overrun Errors: Number of overrun errors—the next data character arrived before the
hardware could move the previous character.
l
Framing Errors: Number of framing errors received—the received data did not have a valid
stop bit.
l
Parity Errors: Number of parity errors—the received data did not have the correct parity
setting.
l
Breaks: Number of break signals received.
Digi ConnectPort LTS User Guide
125
ConnectPort LTS web interface
Administration
Network statistics
Network pane provide details 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
n Speed: Ethernet link speed: 10, 100, or 1000 Mbps. N/A if link integrity is not detected. For
example, the cable is disconnected.
n
Duplex: Ethernet link mode: half or full duplex. N/A if link integrity is not detected. For example,
the cable is disconnected.
n
Bytes Received/Bytes Sent: Number of bytes received or sent.
n
Packets Received: Number of packets received and delivered to a higher-layer protocol.
n
Non-Unicast Packets Received: Number of non-unicast packets received and delivered to a
higher-layer protocol. A non-unicast packet is directed to either an Ethernet broadcast address
or a multicast address.
n
Non-Unicast Packets Sent: Number of non-unicast packets requested to be sent by a higherlayer protocol. A non-unicast packet is directed to either an Ethernet broadcast address or a
multicast address.
n
Unknown Protocol Packets Received: Number of received packets discarded because of an
unknown or unsupported protocol.
IP statistics
n Datagrams Received/Datagrams Forwarded: Number of received or forwarded datagrams.
n
Forwarding: Displays whether forwarding is enabled or disabled.
n
No Routes: Number of outgoing datagrams for which no route to the destination IP can be
found.
n
Routing Discards: Number of discarded outgoing datagrams.
n
Default Time-To-Live: Number of routers an IP packet can pass through before it is discarded.
TCP Statistics
n Segments Received/Segments Sent: Number of received or sent segments.
n
Active Opens: Number of active opens. In an active open, the ConnectPort LTS product
initiates a connection request with a server.
n
Passive Opens: Number of passive opens. In a passive open, the ConnectPort LTS listens for a
connection request from a client.
n
Bad Segments Received: Number of segments received with errors.
n
Attempt Fails: Number of failed connection attempts.
Digi ConnectPort LTS User Guide
126
ConnectPort LTS web interface
n
Administration
Segments Retransmitted: Number of retransmitted segments. Segments are retransmitted
when the server does not respond to a packet sent by the client. A retransmit limits the
number of lost and discarded packets.
n
Established Resets: Number of established connections that have been reset.
n
Currently Established: The number of established connections that have been reset.
n
Resets Sent: The number of sent resets.
UDP Statistics
n Datagrams Received/Datagrams Sent: Number of datagrams received or sent.
n
Bad Datagrams Received: Number of bad datagrams received. This number does not include
the value contained by No Ports.
n
No Ports: Number of received datagrams that were discarded because the specified port was
invalid.
ICMP Statistics
n Messages Received: Number of messages received.
n
Bad Messages Received: Number of received messages with errors.
n
Destination Unreachable Messages Received: Number of destination unreachable messages
received. A destination unreachable message is sent to the originator when a datagram fails to
reach its intended destination.
n
Messages Sent: Number of ICMP messages sent.
n
Dest. Unreachable Messages Sent: Number of ICMP destination unreachable messages sent.
n
IPv6 Messages Received: Number of IPv6 messages received.
n
IPv6 Bad Messages Received: Number of IPv6 messages received with errors.
n
IPv6 Destination Unreachable Messages Received: Number of IPv6 destinations
unreachable messages received. A destination unreachable message is sent to the originator
when a datagram fails to reach its intended destination.
n
IPv6 Messages Sent: Number of IPv6 messages sent.
n
IPv6 Dest. Unreachable Messages Sent: Number of IPv6 destination unreachable messages
sent.
XBee Network
Use this section to view XBee module activity and detailed statistics. This information may aid in
troubleshooting network communication problems with your XBee network.
Gateway Device Details
This Gateway Device Details page displays the current PAN ID, channel, and gateway address used by
the XBee network.
Network View of the XBee Devices
Use the Discover XBee Devices button to refresh the list of devices that joined the XBee network.
(Note that the discovery operation may take a few seconds.) Click an entry in the device's table to
Digi ConnectPort LTS User Guide
127
ConnectPort LTS web interface
Administration
view detailed information about the state of that device on the XBee Device State page.
Field
Description
Node ID
The user assigned identifier of the node.
Network Address
The 16-bit network address of the node.
Extended Address
The unique 64-bit MAC address of the node.
Node Type
The role that the XBee module in the gateway serves in the XBee network.
For a gateway, the XBee module is a coordinator.
Product Type
The product type of the XBee module.
Clear list before
device discovery
Clears the network view of XBee devices of any previously discovered nodes
prior to any new discovery/display XBee network actions.
Python Application XBee Socket Counter
The Python Application XBee Socket Counter pane displays data counters that are specific to ZigBee
Sockets implemented using a Python application.
Field
Description
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 Counters
This Python Application XBee Socket Error Counters pane displays data counters that are specific to
XBee Sockets implemented using a Python application. Use these values to determine the quality of
sent or received data.
Field
Description
Transmit Frame
Errors
The total number of transmitted frames that could not be transmitted due to
an I/O error.
Receive Frame
Errors
The total number of received frames where an error occurred.
Received Bytes
Dropped
The total number of bytes dropped due to an exhaustion of internal buffers.
Received Bytes
Truncated
Number of received bytes that were dropped because the user buffer passed to
recvfrom() was not large enough to contain the entire packet.
XBee Device State
Use the XBee Device State page to see detailed information on the state of the wireless node. The
parameters that appear on this page will vary based on the capabilities supported by the node's RF
Digi ConnectPort LTS User Guide
128
ConnectPort LTS web interface
Administration
module.
Reboot
Changes to some device settings require saving the changes and rebooting the ConnectPort LTS. Use
the Reboot page to reboot the ConnectPort LTS. To reboot a ConnectPort LTS from the web interface:
1. Select Administration > Reboot.
2. Click the Reboot button. Wait approximately one minute for the reboot to complete.
Enable/disable access to network services
You can enable and disable access to various network services, such as ADDP, RealPort, SNMP, SSH,
and telnet. For example, you can disable access to all network services that are not required for
running or interfacing with the ConnectPort LTS product for performance and security reasons. From
the web interface, you can enable and disable network services on the Network Services Settings
page for a ConnectPort LTS product. See Basic Network Services Settings.
Digi ConnectPort LTS User Guide
129
ConnectPort LTS command-line interface
You can issue commands from the command line to configure, manage, and monitor For a description
of the complete command set, see the ConnectPort LTS Command Reference.
This section gives some basics for using the command line interface, as well as listing some commonly
used commands by function.
Access the command-line interface
Basics for using the command-line interface
Management
Administration
Digi ConnectPort LTS User Guide
131
131
132
140
130
ConnectPort LTS command-line interface
Access the command-line interface
Access the command-line interface
To access the command-line interface and send configuration commands to the ConnectPort LTS
device:
1. Choose one of the following options:
n
Launch the command-line interface from the Digi Device Discovery Utility.
n
Use the telnet/ssh command to launch the command-line interface.
2. To launch the CLI via telnet, issue the following telnet command from a command prompt on
another networked device, such as a server:
#> telnet ip-address
Replace ip-address with the IP address of the ConnectPort LTS device. For example:
#> telnet 192.3.23.5
For secure connections, use the ssh command as follows:
#> ssh username@ip-address
Replace username with the user name used to sign in to the ConnectPort LTS device and
replace ip-address with the IP address of the device. For example:
#> ssh root@192.3.23.5
If security is enabled for the ConnectPort LTS device, a login prompt appears for telnet/SSH
access. If you do not know the user name and password for the device, contact the system
administrator who originally configured the device.
After you successfully sign in to the command-line interface, you can access the configuration
shell interface (configshell) or the general bash-shell, according to the your user settings for
system interface access. When the user system interface access option is set to Shell, you can
access the general bash-shell directly and run various system commands. In addition, you can
run the configshell command to enter the configuration-specific shell interface. If the your
system interface access option is set to CLI menu, the you can access the configuration shell
interface directly, but you cannot access the general bash-shell.
Basics for using the command-line interface
The ConnectPort LTS offers online help for CLI commands. Use the following command examples to
get help for using commands.
n help displays all supported commands for a device.
n
? displays all supported commands for a device
n
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.
Digi ConnectPort LTS User Guide
131
ConnectPort LTS command-line interface
n
help set displays syntax and options for the set command.
n
set serial ? displays the syntax and options for the set serial command.
n
help set serial displays the syntax and options for the set serial command.
Management
Management
Use the following commands to display information and statistics:
n display
n
info
n
set alarm
n
set buffer and display buffer
n
set snmp
n
show
Use the following commands to manage connections and sessions:
n close
n
connect
n
exit and quit
n
reconnect
n
rlogin
n
send
n
status
n
telnet
n
who and kill
Use the following commands to configure the ConnectPort LTS product:
n backup print
n
newpass
n
set alarm
n
set autoconnect
n
set buffer and display buffer
n
set group
n
set host
n
set ippool
n
set lcd
n
set modem
n
set network
n
set nfs
n
set permissions
Digi ConnectPort LTS User Guide
132
ConnectPort LTS command-line interface
n
set pmodem
n
set portauth
n
set ppp
n
set profiles
n
set python
n
set realport
n
set rtstoggle
n
set samba
n
set sdmemory
n
set serial
n
set service
n
set smtp
n
set snmp
n
set socket_tunnel
n
set switches
n
set sysauth
n
set syslog
n
set system
n
set tcpserial
n
set trace
n
set udpserial
n
set user
n
set web
n
set xbee
Management
backup print
Print the configuration file in command-line format. You can use this to cut and paste into scripts.
close
Use the close command to close active sessions that were opened by connect, rlogin, and telnet
commands.
connect
Use the connect command to establish a connection with a serial port.
display
Use the display commands to display real-time information about a device, such as:
Digi ConnectPort LTS User Guide
133
ConnectPort LTS command-line interface
n
Management
General product information, including the product name, MAC address, boot, post, and
firmware versions, memory usage, utilization, and uptime, or the amount of time since the
device was booted (display device).
n
Active interfaces on the system. These include the web interface, command line interface,
Point-to-Point Protocol (PPP), and Ethernet interface, and their status, such as Closed or
Connected (display netdevice).
n
Logged serial data (display buffers).
n
Memory usage information (display memory).
n
Serial modem signals (display serial).
n
General status of the sockets resource (display sockets).
n
Active TCP sessions and active TCP listeners (display tcp).
n
Current UDP listeners (display udp).
n
Uptime information (display uptime).
exit and quit
Use the exit and quit commands to terminate a currently active session.
info
Use the info commands to display statistical information about a device over time. The statistics
displayed are those gathered since the tables containing the statistics were last cleared. The type of
statistics include:
n Device statistics. The info device command displays such details as product, MAC address,
bios, and firmware versions, memory usage, utilization, and uptime. For models with dual
power supplies, such as ConnectPort LTS 16 MEI 2AC, this command displays the status of the
power supplies.
n
Ethernet statistics. The info ethernet command displays statistics regarding the Ethernet
interface, including:
n
l
The number of bytes and packets sent and received
l
The number of incoming and outgoing bytes that were discarded or that contained errors
l
The number of Rx overruns
l
The number of times the transmitter was reset
l
The number of incoming bytes when the protocol was unknown
ICMP statistics. The info icmp command displays the number of messages, bad messages, and
destination unreachable messages received.
Digi ConnectPort LTS User Guide
134
ConnectPort LTS command-line interface
n
n
n
Management
Serial statistics. The info serial command displays the following information:
l
Number of bytes received and transmitted
l
Signal changes
l
FIFO and buffer overruns
l
Framing and parity errors
l
Breaks detected
TCP statistics. The info tcp command displays the following information:
l
The number of segments received or sent
l
The number of active and passive opens
l
The number of bad segments received
l
The number of failed connection attempts
l
The number of segments retransmitted
l
The number of established connections that were reset
UDP statistics. The info udp command displays the following information:
l
The number of datagrams received or sent
l
The number of bad datagrams received
l
The number of received datagrams that were discarded because the specified port was
invalid
n
ZigBee statistics. The info zigbee_sockets command displays the following information:
l
The number of frames received or sent
l
The number of bad frames received or sent
l
The number of bytes received or sent
l
The number of received bytes dropped or truncated
newpass
Use the newpass command to issue a new password to a user.
reconnect
Use the reconnect command to reestablish a connection opened by a connect, rlogin, or telnet
command. By default, the reconnect command reestablishes the connection to the last active
session.
rlogin
Use the rlogin command to sign in to a remote system.
send
Use the send command to send a telnet control command, such as break, abort output, are you there,
escape, or interrupt process, to the last active telnet session.
Digi ConnectPort LTS User Guide
135
ConnectPort LTS command-line interface
Management
set alarm
Use the set alarm command to display alarm settings, including conditions that trigger alarms, and
how alarms are sent. You can configure alarms to be sent as either an email message, an SNMP trap,
or both. You can configure the alarms as needed.
set autoconnect
Use the set autoconnect command to configure the autoconnection behaviors for serial port
connections.
set buffer and display buffer
Use the set buffer command to configure buffering parameters on a port and display the current port
buffer configuration. The display buffers command displays the contents of a port buffer, or
transfers the port-buffer contents to a server running Trivial File Transfer Protocol (TFTP).
set group
Use the set group command to configure create, establish, update, or remove group attributes.
set host
Use the set host command to configure the host name for the Digi device.
set ippool
Use the IP pool command to configure the IP pool for the PPP connection.
set lcd
Use the set lcd command to configure the LCD.
set modem
Use the set modem command to configure the modem profile.
set network
Use the set network command to configure the network options.
set nfs
Use the set nfs command to configure NFS.
set permissions
Use the set permissions command to configure the user permissions for various services and
command-line interface commands.
Digi ConnectPort LTS User Guide
136
ConnectPort LTS command-line interface
Management
set pmodem
Use the set pmodem command to configure the modem emulation.
set portauth
Use the set portauth command to enable authentication for serial ports.
set ppp
Use the set ppp command to configure PPP connections.
set profiles
Use the set profiles command to configure the port profile for a serial port.
set python
Use the set python command to configure Python.
set realport
Use the set realport command to configure RealPort.
set rtstoggle
Use the set rtstoggle command to configure the RTS toggle.
set samba
Use the set samba command to configure the Samba server.
set sdmemory
Use the set sdmemory command to configure the SD memory.
set serial
Use the set serial command to configure the serial port options.
set service
Use the set service command to configure the network services.
set smtp
Use the set smtp command to configure SMTP.
set snmp
Use the set snmp command to configure SNMP, including SNMP traps, such as:
Digi ConnectPort LTS User Guide
137
ConnectPort LTS command-line interface
n
Authentication failure
n
Cold start
n
Link up
n
Login traps
Management
The set snmp command also displays current SNMP settings.
set socket_tunnel
Use the set socket_tunnel command to configure the socket tunnel.
set switches
Use the set switches command to configure the MEI type and termination.
set sysauth
Use the set sysauth command to enable authentication for the web interface and command-line
interface.
set syslog
Use the set syslog command to configure the system log.
set system
Use the set system command to configure the system identifying information.
set tcpserial
Use the set tcpserial command to configure serial TCP.
set trace
Use the set trace command to configure the trace log.
set udpserial
Use the set udpserial command to configure the serial UDP.
set user
Use the set user command to configure a user.
set web
Use the set web command to configure the web timeout value in minutes.
set xbee
Use the set xbee command to configure the XBee.
Digi ConnectPort LTS User Guide
138
ConnectPort LTS command-line interface
Management
show
Use the show commands to display current settings on a Digi device.
status
Use the status command to display a list of sessions or outgoing connections made by the connect,
rlogin, or telnet commands for a Digi device. Use the status command to determine which of the
current sessions to close.
telnet
Use the telnet command to establish an outgoing telnet connection, also known as a session.
who and kill
Use the who command to display a global list of connections. The list of connections includes those
associated with a serial port or the command-line interface.
Use the kill command to terminate active connections based on the ID number returned from the
who results.
Use the who command to determine any connections that are no longer needed, and end the
connections by issuing a kill command.
Digi ConnectPort LTS User Guide
139
ConnectPort LTS command-line interface
Administration
Administration
You can issue commands from the command-line interface to administer ConnectPort LTS products.
The following table displays several administration tasks and the commands used 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
boot
To update the firmware:
1. Telnet or ssh to the Digi device command-line
interface using a telnet/ssh application.
2. If security is enabled for the Digi device, a login
prompt appears. The default user name is root and
the default password is dbps. If these defaults do
not work, contact the system administrator who
set up the device.
3. If you are at the bash shell, type configshell to get
to the config shell.
4. Issue the boot load command:
#> boot load=tftp-server-ip:filename
Replace tftp-server-ip with the IP address of the
TFTP server that contains the firmware, and
replace filename with the name of the file to upload.
Reset configuration to factory defaults revert
or
boot action=factory
Display system information and
statistics
info
Reboot the device
boot
Enable/disable network services
set service
Configure device server for tracing and set trace
display tracing information
Digi ConnectPort LTS User Guide
140
Simple Network Management Protocol (SNMP)
This section describes how to use SNMP to manage and monitor ConnectPort LTS devices.
About Simple Network Management Protocol (SNMP)
SNMP device monitoring capabilities
Download a Digi MIB
SNMP configuration
Supported SNMP traps
Supported RFCs and MIBs
Digi ConnectPort LTS User Guide
142
142
143
143
143
143
141
Simple Network Management Protocol (SNMP)
About Simple Network Management Protocol (SNMP)
About Simple Network Management Protocol (SNMP)
SNMP is a widely-used standard protocol that allows you to manage all device nodes on an IP
network, solve network problems, and improve network performance.
Most Digi devices support SNMP versions 1 and 2.
ConnectPort LTS supports SNMP versions 1, 2, and 3.
SNMP is easy to implement in extensive networks because the standard architecture allows you to
easily program new variables and drop in new devices into a network.
However, because device communication is UDP-based, the communication is not secure. If you
require secure communications with a device, use an alternate device interface. Also, SNMP does not
allow you to perform all the tasks available from the ConnectPort LTSweb or command line interfaces,
such as file management, uploading firmware, or backing up and restoring configurations. Compared
to the web or command-line interfaces, SNMP offers a limited set of management and configuration
options.
Management Information Bases (MIBs)
Accessing the SNMP interface requires a tool, such as a network management station. The
management station relies on an agent at a device to retrieve or update the information at the
device, including device configuration, status, and statistical information. This information is viewed as
a logical database, called a Management Information Base (MIB). MIB modules describe MIB variables
for a variety of device types and computer hardware and software components.
Viewing MIB-II components
For an overview of the SNMP interface and the MIB-II components:
1. Go to www.rfc-editor.org/search/rfc_search.php.
2. Search for MIB-II.
3. From the results, select the text file Management Information Base for Network Management of
TCP/IP-based internets: MIB-II.
SNMP device monitoring capabilities
SNMP provides the following device monitoring capabilities:
n Network statistics, defined in RFC 1213, MIB-II
n
Port statistics, defined in RFCs 1316 and 1317
n
Device information, defined in Digi enterprise MIB DIGI-DEVICE-INFO.mib
You can use this information to manage network performance, gather device statistics, and find and
solve network problems.
For more information on the statistics available through the standard RFCs listed above, refer to the
RFCs available on the IETF website (www.ietf.org). For enterprise MIBs, refer to the description fields
in the MIB text.
Digi ConnectPort LTS User Guide
142
Simple Network Management Protocol (SNMP)
Download a Digi MIB
Download a Digi MIB
To download a Digi MIB:
1. Go to the ConnectPort LTS product page.
2. Click Diagnostics, Utilities and MIBs.
3. Locate the MIB you want to view under General Diagnostics, Utilities, and MIBs.
SNMP configuration
You can configure basic network and serial configurations for ConnectPort LTS devices through SNMP:
n Use a subset of standard MIBs for network and serial configuration. See Supported RFCs and
MIBs for more information on supported MIBS.
n
Use Digi enterprise MIBs for device identification, alarm handling, and ConnectPort LTS-specific
configurations.
To use the MIBS, you must load MIBs into a network management station (NMS).
Note that some SNMP configuration settings can be configured only from the web or command line
interfaces. For example, to send alarms as SNMP traps:
n In the web interface, use the Configuration > Alarms > alarm > Alarm Destinations > Send
SNMP trap to following destination when alarm occurs option. See Alarms Configuration.
n
In the command-line interface, use the set alarm option typescript. See the set alarm
command description in the ConnectPort LTS Command Reference on digi.com.
Note You cannot configure all network and serial configurations using SNMP. For more advanced
configuration settings, use the web or command-line interfaces.
Supported SNMP traps
You can enable or disable SNMP traps. Supported SNMP traps include:
n Authentication failure
n
Login
n
Cold start
n
Link up
n
Alarms issued in the form of SNMP traps
Supported RFCs and MIBs
ConnectPort LTS supports the following SNMP-related Request for Comments (RFCs) and
Management Information Bases (MIBs):
n Standard RFCs and MIBs
l
RFC 1213—Management Information Base (MIB) II manages a TCP/IP network. MIB-II
contains variable definitions that describe the most basic information needed to manage a
TCP/IP network. Variable definitions are organized into several groups, such as groups for
Digi ConnectPort LTS User Guide
143
Simple Network Management Protocol (SNMP)
Supported RFCs and MIBs
managing the system, network interfaces, address translation, transmission media, and
various protocols, including IP, ICMP, TCP, UDP, EGP, and SNMP. See
www.ietf.org/rfc/rfc1213.txt for more information.
l
RFC 1215—Generic Traps (coldStart, linkUp, authenticationFailure, login only). See
www.ietf.org/rfc/rfc1215.txt for more information.
n
DIGI enterprise MIBs
l
DIGI DEVICE INFO MIB—A Digi enterprise MIB for handling and displaying basic device
information, such as firmware revisions in use, device name, IP network information,
memory use, and CPU statistics.
l
DIGI SERIAL ALARM TRAPS MIB—A Digi enterprise MIB for sending alarms as SNMP traps.
l
DIGI ConnectPort LTS MIB—A Digi enterprise MIB for configuring ConnectPort LTS.
See Download a Digi MIB for instructions on downloading a Digi MIB from the Digi website.
Digi ConnectPort LTS User Guide
144
ConnectPort LTS LCD interface
This section discusses how to configure, monitor or diagnose a ConnectPort LTS device using the
LCD interface.
Keys
Keypad operations
Configuring the ConnectPort LTS using the LCD interface
Monitoring the status using the LCD interface
Running diagnostics using the LCD interface
Miscellaneous functions in the LCD interface
Digi ConnectPort LTS User Guide
146
146
146
151
151
151
145
ConnectPort LTS LCD interface
Keys
Keys
n
Use the keys on the right side of LCD display to select menu options. The selected menu option is
displayed with white characters on black background.
Up: Move up.
n
Dn: Move down.
n
Sel: Select the current menu item. If the item has a submenu, a black triangle mark is displayed at the
end of line. If the item does not have a submenu, the action assigned to the menu item is performed.
n
Ext: Go to the upper menu or run the action assigned to the selected menu item. The current menu
level appears on the top left top of the LCD screen. The upper menu appears on the top right of the
LCD screen.
Keypad operations
When you turn on the ConnectPort LTS, the following image appears on the LCD screen by default:
Press any key to display the LCD main menu.
If a menu item has submenus, a black triangle appears to the right of the menu item. Use the Up or
Dn keys to navigate the menu.
Press the Sel key to display the submenu associated with the selected menu item. The name of the
submenu appears on the left at the top of the screen. For example, the CONFIG tab indicates you are
on the CONFIGURATION menu. The MAIN tab is the upper menu. To return to the upper menu, press
Ext.)
Configuring the ConnectPort LTS using the LCD interface
You can configure the following ConnectPort LTS settings using the LCD interface:
Digi ConnectPort LTS User Guide
146
ConnectPort LTS LCD interface
n
Configuring the ConnectPort LTS using the LCD interface
IP settings #1: Sets IP mode, IP address, subnet mask, and the default gateway of network
interface #1.
n
IP settings #2: Sets IP mode, IP address, subnet mask, and the default gateway of network
interface #2.
n
Host name: Specifies the host name of the device.
n
DNS: Specifies the primary DNS of the device.
Note You can only set IPv4 mode. You cannot configure IPv6 using the LCD interface.
Change the IP settings
You can change the IP mode, as well as the IP address, subnet mask, and default gateway settings.
To set the IP Mode:
1. From the LCD main menu, select CONFIGURATION.
2. Select either IP SETTINGS #1 or IP SETTINGS #2. The following IP menu appears:
3. Select IP MODE and then select one of the following options:
n
DISABLE: Disable this Ethernet interface.
n
STATIC IP: Set the IP mode to STATIC. If you set the IP address mode to STATIC, you can set
the static IP address, subnet mask, and gateway addresses.
n
DHCP: Set the IP mode to DHCP.
To change the IP address:
1. Select IP ADDRESS from the IP menu.
2. Select the IP address that you want to change.
Digi ConnectPort LTS User Guide
147
ConnectPort LTS LCD interface
Configuring the ConnectPort LTS using the LCD interface
3. Choose one of the following options:
n
Select the EDIT menu to change the IP address.
a. From this menu, choose a character under SELECT using the Up (Left) and
Dn (Right) keys. The following image shows how the IP address on the upper
line changes as you select each number:
Note that you can choose the null character (first letter) to clear a selected
letter.
b. Choose another character by pressing Ext key twice. Repeat the steps to
change the letter as described above.
c. When you finish changing the characters, press the Ext key.
d. Enter the IP settings menu again to change the SUBNET MASK or GATEWAY
in the manner described above.
e. Press the Ext key when the IP SETTINGS menu is displayed.
Digi ConnectPort LTS User Guide
148
ConnectPort LTS LCD interface
Configuring the ConnectPort LTS using the LCD interface
f. Choose one of following options:
n
l
SAVE APPLY: Save and apply configuration changes.
l
DISCARD CHANGES: Discard all changes.
l
CANCEL: Discard all changes and return to IP SETTINGS menu.
Select the CLEAR ALL menu to clear the entire IP address.
Change the hostname
To change the hostname:
1. Access the host name menu by selecting CONFIGURATION and then HOST NAME.
2. Press the Sel key again.
3. Move cursor position using the Up (Left) and Dn (Right) keys. Once you position the cursor to
the item you want to change, press the Sel key to enter the editing submenu.
Digi ConnectPort LTS User Guide
149
ConnectPort LTS LCD interface
Configuring the ConnectPort LTS using the LCD interface
4. On the editing submenu screen, select EDIT to change the selected letter or CLEAR ALL to
clear all host names displayed on the screen. Selecting EDIT displays the following submenu:
5. On the submenu, choose a character using Up (Left) and Dn (Right) keys. The host name on the
upper line changes automatically as follows:
6. After changing the selected letter, choose another letter by pressing the Ext key twice. Repeat
the steps as needed until you have finished entering the host name. When you have finished
changing letters, press the Ext key several times until you see the following screen.
7. Choose one of following options:
n
SAVE APPLY: Save and apply configuration changes.
n
DISCARD CHANGES: Discard all changes.
n
CANCEL: Discard all changes and return to the HOST NAME menu.
Change the DNS configuration
1. Select CONFIGURATION and then DNS.
Digi ConnectPort LTS User Guide
150
ConnectPort LTS LCD interface
Monitoring the status using the LCD interface
2. Press the Sel key again.
3. Choose ENABLE and press the Ext key.
4. Set the IP address of the DNS server in the same manner as setting the IP address.
Monitoring the status using the LCD interface
You can monitor the following status information through the LCD interface:
n
n
Serial port
l
Configuration: Profile, Baudrate, Data Bit, Parity Bit, Stop Bit, Flow control, Port Type
l
Signal status: RTS, CTS, DTR, DSR, DCD
l
Statistics: Data In, Data out, Parity Error, Framing Error, Overrun error
Ethernet
l
n
Speed, Duplex, Bytes Received, Bytes Sent, Packets Received, Packet Sent
System
l
Product Model, F/W version, Bios version, IP Address, MAC address, CPU Utilization, UP Time,
Memory (Total, Used, Free)
Running diagnostics using the LCD interface
n
You can run the following diagnostics run through the LCD interface:
Auto Test: Run all possible hardware tests and show the results.
n
Individual Test: Run the following tests by selection or manually: EEPROM, UART (Internal and
External), Ethernet, USB, SD Memory, Modem, XBee.
Miscellaneous functions in the LCD interface
You can run the following functions from the Miscellaneous menu.
n Factory Reset: Restore the configuration to factory defaults.
n
LCD setting: Reset the LCD configuration or select a background image.
Digi ConnectPort LTS User Guide
151
ConnectPort LTS LCD interface
Miscellaneous functions in the LCD interface
Run the Factory Reset
To run the Factory Reset from the LCD interface:
1. Select Miscellaneous and then FACTORY RESET.
2. Select APPLY to restore the device configuration to factory default values and automatically
reboot the device.
LCD settings
Select the LCD setting menu by selecting MISCELLANEOUS and then LCD SETTINGS.
You can select the following functions:
n RESET: Restore the LCD configuration, including the background image, to the factory defaults.
n
SELECT IMAGE: Choose a background image.
Change the LCD settings
To change the LCD settings:
1. Select MISCELLANEOUS and then LCD SETTINGS. The LCD settings menu appears.
Digi ConnectPort LTS User Guide
152
ConnectPort LTS LCD interface
Miscellaneous functions in the LCD interface
2. Choose one of the following options:
n
To reset the LCD configuration settings, select RESET and then click APPLY to confirm
your changes when you see the following confirmation message:
n
To change the background image, select SELECT IMAGE and choose one of the
following options.
l
DEFAULT IMAGE: Restore the original background image.
l
USER IMAGE: Select a new background image and follow the prompts.
Digi ConnectPort LTS User Guide
153
ConnectPort LTS disaster recovery
The Digi ConnectPort LTS provides a disaster recovery procedure in the event the configuration data
is destroyed or corrupted. The Digi ConnectPort LTS automatically restores a corrupted configuration
file system to the factory default settings. If the Digi ConnectPort LTS device fails to boot after you run
a factory reset to restore the factory default settings, you can restore the firmware from the Bios
menu.
Restore ConnectPort LTS to Factory Default Settings
Digi ConnectPort LTS User Guide
155
154
ConnectPort LTS disaster recovery
Restore ConnectPort LTS to Factory Default Settings
Restore ConnectPort LTS to Factory Default Settings
To restore the ConnectPort LTS to the factory default configuration settings, use a TFTP or BOOTP
server. To use the Bios menu to flash new firmware and/or new BIOS code revision:
1. Connect the console port on the rear panel of the Digi ConnectPort LTS unit to a serial port on
a workstation. Use the supplied RJ45/DB9F console adapter and an Ethernet cable.
2. Set up a terminal emulation program such as HyperTerminal. Use the following port
parameters:
n
bps=9600
n
data bits=8
n
parity=none
n
stop bits=1
n
flow control=none
3. Reboot or power on the ConnectPort LTS unit.
4. Press the ESC key within three seconds of applying power to the device. The following screen
appears. Use the ESC key to return to a previous menu screen, and then press the Enter key to
refresh the menu screen.
5. Choose Firmware upgrade by entering 3. The following screen appears.
Digi ConnectPort LTS User Guide
155
ConnectPort LTS disaster recovery
Restore ConnectPort LTS to Factory Default Settings
6. Enter the information for the first menu items.
n
Protocol: The choices are BOOTP or TFTP.
n
IP address assigned: Type the IP address of the Digi ConnectPort LTS unit.
n
Server’s IP address: The IP address of the BOOTP or TFTP server.
n
Firmware File Name: The filename for the firmware.
n
Ethernet interface: 1 or 2.
7. Use the ESC key to return to previous menu screens.
8. Select Start firmware upgrade. The firmware upgrade can take 15 to 20 minutes to process.
Do not interact with the ConnectPort LTS unit until the firmware update is complete.
9. When the upgrade process is complete, the device will reboot and the factory default settings
will be restored.
Digi ConnectPort LTS User Guide
156
ConnectPort LTS hardware specifications
To get ConnectPort LTS hardware specifications, visit www.digi.com/products/serial-servers/serialdevice-servers/connectportlts#specifications.
Digi ConnectPort LTS User Guide
157
ConnectPort LTS regulatory information and
certifications
This section documents ConnectPort LTS regulatory information and certifications.
FCC certifications and regulatory information (USA only)
Industry Canada (IC) certifications
China regulatory information
Safety statements
Digi ConnectPort LTS User Guide
159
160
160
161
158
ConnectPort LTS regulatory information and
certifications
FCC certifications and regulatory information (USA
only)
FCC certifications and regulatory information (USA only)
FCC Part 15 Class B
Radio Frequency Interface (RFI) (FCC 15.105)
Labeling Requirements FCC (15.19)
FCC Part 15 Class B
These devices comply with the standards cited in this section:
n ConnectPort LTS 16
n
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. These limits are designed to provide reasonable protection
against harmful interference in a residential environment. This equipment generates, uses, and can
radiate radio frequency energy, and if not installed and used in accordance with the instruction
manual, may cause harmful interference to radio communications. However, there is no guarantee
that interference will not occur in a particular installation. If this equipment does cause harmful
interference to radio or television reception, which can be determined by turning the equipment off
and on, the user is encouraged to try and correct the interference by one or more of the following
measures:
n Reorient or relocate the receiving antenna.
n
Increase the separation between the equipment and receiver.
n
Connect the equipment into an outlet on a circuit different from that to which the receiver is
connected.
n
Consult the dealer or an experienced radio/TV technician for help.
Labeling Requirements FCC (15.19)
This device complies with Part 15 of FCC rules. Operation is subject to the following two conditions: (1)
this device may not cause harmful interference, and (2) this device must accept any interference
received, including interference that may cause undesired operation.
If the FCC ID is not visible when installed inside another device, then the outside of the device into
which the module is installed must also display a label referring to the enclosed module FCC ID.
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.
Declaration of Conformity
(In accordance with FCC Dockets 96-208 and 95-19)
Manufacturer’s Name:
Digi ConnectPort LTS User Guide
Digi International Inc.
159
ConnectPort LTS regulatory information and certifications
Corporate Headquarters:
11001 Bren Road East
Minnetonka, MN 55434
Manufacturing Headquarters:
10000 West 76th Street
Eden Prairie MN 55344
Industry Canada (IC) certifications
Digi International declares, that the product:
Product Name
Model Number
ConnectPort LTS
50001688-xx
to which this declaration relates, meets the requirements specified by the Federal Communications
Commission as detailed in the following specifications:
n Part 15, Subpart B, for Class B equipment
n
FCC Docket 96-208 as it applies to Class B personal computers and peripherals
The product listed above has been tested at an External Test Laboratory certified per FCC rules and
has been found to meet the FCC, Part 15, Class B, Emission Limits. Documentation is on file and
available from the Digi International Homologation Department.
Industry Canada (IC) certifications
This digital apparatus does not exceed the Class B limits for radio noise emissions from digital
apparatus set out in the Radio Interference Regulations of the Canadian Department of
Communications.
Le present appareil numerique n’emet pas de bruits radioelectriques depassant les limites applicables
aux appareils numeriques de la class B prescrites dans le Reglement sur le brouillage radioelectrique
edicte par le ministere des Communications du Canada.
China regulatory information
Linux Terminal Server
Digi 串 口 服 务 器 LTS 16 MEI 2AC
用户须知
当 系 统 出 现 故 障 时 可 能 会 导 致 严 重 的 后 果 ,为 了 应 对 这 些 后 果 ,采 用 备 份 系 统 和 安 全 装 置
保 护 生 命 和 财 产 安 全 是 必 不 可 少 的 。用 户 承 担 对 保 护 系 统 故 障 所 造 成 后 果 的 责 任 。
该 设 备 在 室 内 使 用 ,所 有 通 信 线 路 仅 限 于 建 筑 物 内 。
该设备未被批准不得用于生命支持系统或医疗系统。
塞 纳 科 技 没 有 明 确 批 准 该 设 备 的 变 更 或 修 改 ,用 户 将 无 权 操 作 该 设 备 。
Digi ConnectPort LTS User Guide
160
ConnectPort LTS regulatory information and certifications
Safety statements
警告!
要断开关危险电压应断开所有的输入插座!
没有电源线设备将被出售
机架式
1. 高 架 工 作 环 境 温 度 —如 果 安 装 在 一 个 封 闭 或 多 单 元 机 架 组 件 上 ,其 机 架
环 境 的 操 作 环 境 温 度 也 许 高 于 室 温 。因 此 ,应 考 虑 设 备 安 装 的 环 境 应
与制造商的最高额定环境温度兼容。
2. 空 气 流 通 减 少 —在 机 架 中 安 装 的 设 备 应 该 是 这 样 的 :其 操 作 设 备 所 需 的
空气流动量不会影响设备的安全。
3. 机 械 载 荷 —由 于 机 械 负 荷 的 不 平 衡 性 ,在 机 架 上 安 装 设 备 不 应 该 在 危 险
的条件下进行。
4. 电 路 过 载 —应 考 虑 连 接 设 备 的 供 电 线 路 和 电 路 超 载 可 能 产 生 对 过 量 电
流 的 保 护 以 及 对 电 源 线 的 影 响 。解 决 这 一 问 题 ,应 适 当 考 虑 设 备 的 铭
牌额定值。
5. 应 保 持 可 靠 的 接 地 —保 持 机 架 安 装 设 备 接 地 的 可 靠 性 。应 特 别 注 意 将 连
接头而不是直流电的连接头连到分支电路上。
6. 锂 蓄 电 池
“警 告 ”
如 果 电 池 更 换 不 当 ,会 有 发 生 爆 炸 的 危 险 。
请仅使用制造商推荐的同一或者同等型号的产品。
(制 造 商 :索 尼 福 岛 公 司 ,型 号 :CR2032)
按 照 国 家 标 准 或 回 收 计 划 ,处 理 废 旧 电 池 。
Safety statements
5.10 Ignition of Flammable Atmospheres
Warnings for Use of Wireless Devices
CAUTION! Observe all warning notices regarding use of wireless devices.
Digi ConnectPort LTS User Guide
161
ConnectPort LTS regulatory information and certifications
Safety statements
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.
Safety in Aircraft
Switch off the wireless device when instructed to do so by airport or airline staff. If the device offers a
”flight mode” or similar feature, consult airline staff about its use in flight.
Safety in Hospitals
Wireless devices transmit radio frequency energy and may affect medical electrical equipment. Switch
off wireless devices wherever requested to do so in hospitals, clinics, or healthcare facilities. These
requests are designed to prevent possible interference with sensitive medical equipment.
Pacemakers
Pacemaker manufacturers recommended that a minimum of 15cm (6 inches) be maintained between
a handheld wireless device and a pacemaker to avoid potential interference with the pacemaker.
These recommendations are consistent with independent research and recommendations by Wireless
Technology Research.
Persons with Pacemakers
n ALWAYS keep the device more than 15cm (6 inches) from their pacemaker when turned ON.
n
Do not carry the device in a breast pocket.
n
If you have any reason to suspect that the interference is taking place, turn OFF your device.
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. Reduced Air Flow: Installation of the equipment in a rack should be such that the amount of air
flow required for safe operation of the equipment is not compromised.
3. Mechanical Loading: Mounting of the equipment in the rack should be such that a hazardous
condition is not achieved due to uneven mechanical loading.
4. Circuit Overloading: Consideration should be given to the connection of the equipment to the
supply circuit and the effect that overloading of circuits might have on over-current protection and
supply wiring. Appropriate consideration of equipment nameplate ratings should be used when
addressing this concern.
5. Reliable Earthing: Reliable earthing of rack-mounted equipment should be maintained. Particular
attention should be given to supply connections other than direct connections to the branch
circuit.
Lithium Battery
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.)
Digi ConnectPort LTS User Guide
162
ConnectPort LTS regulatory information and certifications
Safety statements
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.
Cabling
To determine the proper cable requirements for your application, please refer to the Cable Guide for
all PortServer® TS, Digi Connect®, and Digi One® Products (Digi part number 90000253).
Digi ConnectPort LTS User Guide
163