Page 1 ConnectPort™ X Family User’s Guide ™ ConnectPort X Family: ConnectPort X2, ConnectPort X4, ConnectPort X8 e-mail: info@direktronik.se tel: 08-52 400 700 fax: 08-520 18121 90000832_A...
Page 2 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.
Page 3: Table Of Contents
About this guide............................15 Purpose ..............................15 Audience...............................15 Scope ..............................15 Where to find more information......................16 General release documentation ....................16 Additional product information on www.digi.com ..............17 Digi contact information ........................17 Chapter 1: Introduction..........................19 ConnectPort X Family products ......................20 Features ..............................21 User interfaces..........................21 Quick reference for configuring features ...................22 Hardware features ........................29...
Page 4 Security features......................... 42 Configuration management......................43 Customization capabilities ......................43 Supported connections and data paths in Digi devices ................ 44 Network services......................44 Network services associated with specific serial ports .......... 44 Network services associated with serial ports in general........45 Network services associated with the command-line interface ......
Page 5 Chapter 2: Configure Digi devices......................63 Default IP address ..........................64 Alternate methods for assigning an IP address ..................64 Configure an IP address using the Digi Device Setup Wizard ..........64 Configure an IP address using DHCP ..................65 Configure an IP address using Auto-IP..................65 Configure an IP address from the command-line interface............66...
Page 6 C o n t e n t s By entering the Digi device’s IP address in a web browser ..........69 By using the Digi Device Discovery utility..............69 Install Digi Device Discovery utility ..............69 Discover devices ....................70 Organization of the web interface....................
Page 7 C o n t e n t s Using pinholes to manage the Digi device ............. 96 Remote device management and IP pass-through..........97 Steps to configure IP pass-through................. 97 Virtual Private Network (VPN) settings ................99 Uses for VPN-enabled Digi devices............... 99 Example VPN configuration ................
Page 8 C o n t e n t s Configure Mesh/ZigBee network settings ................130 Mesh network terms .................... 130 ZigBee protocol terms..................131 Mesh Network configuration settings................133 Basic radio settings....................135 Advanced radio settings ..................136 For more information on Mesh networks and the ZigBee protocol ......136 Configure serial ports.......................
Page 9 C o n t e n t s Alarm destinations....................152 Enable and Disable Alarms ....................152 Configure system settings ......................153 Device description information..................153 SNMP configuration settings ..................153 Configure remote management (Connectware Manager) settings ...........154 Steps for setting up remote management ...............154 Connection settings ......................155 About client-initiated and server-initiated connections........
Page 10 Node View ........................172 Batch capabilities for configuring multiple devices ................174 What’s next? ............................174 Chapter 3: Monitor and manage Digi devices..................175 Monitoring capabilities in the web interface..................176 Display system information ..................... 176 General system information................... 177 Serial port information....................
Page 11 C o n t e n t s Manage active system connections............... 189 Event logging .........................190 Manage network services ....................190 Manage DHCP server operation................190 Start, stop, and restart the DHCP server............... 190 View and manage current DHCP leases............... 191 Lease status types ....................
Page 12 Using the web interface ....................215 Using the Reset button ....................216 Display system information ..................... 217 Reboot the Digi device......................217 Enable/disable access to network services................217 Administration from the command-line interface................218 Chapter 5: Specifications and certifications ..................219 Hardware specifications ........................
Page 13 C o n t e n t s Glossary ...............................225 Index ................................241...
Page 14 C o n t e n t s...
Page 15: About This Guide
This guide describes and shows how to provision, configure, monitor, and administer Digi devices. Audience This guide is intended for those responsible for setting up Digi devices. It assumes some familiarity with networking concepts and protocols. A glossary is provided with definitions for networking terms and features discussed in the content.
Page 16: Where To Find More Information
In addition to this guide, find additional product and feature information in the these documents: General release documentation These documents are of interest to end users of Digi devices: Online help and tutorials in the web interface for the Digi device Quick Start Guides ® RealPort...
Page 17: Additional Product Information On Www.digi.com
A b o u t t h i s g u i d e Additional product information on www.digi.com In addition to the previous documents, product information is available on the Digi website, www.digi.com, including: Support Forums Knowledge Base Data sheets/product briefs...
Page 18 D i g i c o n t a c t i n f o r m a t i o n...
Page 19: Chapter 1: Introduction
I n t r o d u c t i o n Introduction This chapter introduces Digi devices and their product families, types of connections and data paths in which Digi devices can be used, and the interface options available for configuring, monitoring, and administering Digi devices.
Page 20: Connectport X Family Products
USB, 1-Wire, RabbitNet, and asynchronous serial. ConnectPort X Family products act as a coordinator for a Mesh network. As with the Connect and Cellular product families, ConnectPort X Family products are supported by Digi’s Connectware Manager device management software application, which can be used to remotely manage gateway devices and Mesh networks.
Page 21: Features
I n t r o d u c t i o n Features This is an overview of key features in Digi devices. Software features are covered in more detail in the next three chapters. Hardware specifications and are covered in Chapter 5, "Specifications and certifications".
Page 22: Quick Reference For Configuring Features
F e a t u r e s Quick reference for configuring features This guide primarily focuses on configuring, monitoring, and administering Digi devices from the web interface. This table provides a quick reference for configuring features and performing device tasks, and where to find the features and settings in the web interface and this guide.
Page 23 TCP Sockets > Automatically establish TCP connections device Bisynchronous (BSC) Configuration > Applications > Bisync (BSC) Settings communications (Available in Digi Connect WAN Sync only) Camera settings for ConnectPort X Configuration > Camera Family products Connection management: Management >...
Page 24 The Industrial Automation port profile should address most configuration scenarios. To fine-tune your IA settings, use the “set ia” command from the command line. See the set ia command description in the Digi Connect Family Command Reference. For additional information on configuring Industrial Automation, see this web site: http://www.digi.com/support/ia...
Page 25 Mobile (cellular) settings: Configuration > Mobile Provisioning CDMA cellular modules For Digi Cellular product that have a CDMA cellular module, provisioning must be performed once. To launch a wizard for provisioning the module, go to Configuration > Mobile. Under Mobile Service Provider Settings, click the Provision Device button.
Page 26 For more information on writing and running Python programs, authored in the Python programming see the Digi Python Programmer’s Guide. language. RealPort (COM port redirection) Configuration > Serial Ports > port > Port Profile Settings >...
Page 27 I n t r o d u c t i o n Feature/task Path to feature in the web interface See page Configuration > Security Issue a new/changed password to a user Serial port configuration: Configuration > Serial Ports > Basic Serial Settings Basic serial port settings Configuration >...
Page 28 Basic network and serial settings configurable through standard 58, 169 Use SNMP as primary and Digi-specific Management Information Blocks (MIBs). configuration interface More advanced settings must be set through the web or command-line user interfaces, and sending alarms as SNMP traps must be configured through the web interface, on the pages listed above.
Page 29: Hardware Features
Services page of Network Configuration. For more information, see "Network services settings" on page 82. In the command-line interface, network services are enabled and disabled through the set service command. See the Digi Connect Family Command Reference for the set service command description.
Page 30: Ip Protocol Support
F e a t u r e s IP protocol support All Digi devices include a Robust on-board TCP/IP stack with a built-in web server. Supported protocols include, unless otherwise noted: Transmission Control Protocol (TCP) User Datagram Protocol (UDP) Dynamic Host Configuration Protocol (DHCP)
Page 31: Serial Data Communication Over Tcp And Udp
I n t r o d u c t i o n Serial data communication over TCP and UDP Digi devices support serial data communication over TCP and UDP. Key features include: Serial data communication over TCP, also known as autoconnect and tcpserial can automatically perform the following functions: –...
Page 32: Dynamic Host Configuration Protocol (Dhcp)
Auto-IP is a protocol that will automatically assign an IP address from a reserved pool of standard Auto-IP addresses to the computer on which it is installed. Digi devices are set to obtain its IP address automatically from a DHCP server. But if the DHCP server is unavailable or nonexistent, Auto-IP will assign the device an IP address.
Page 33: Supported Snmp Traps
RFC 2217, Telnet Com Port Control Option, an extension of the Telnet protocol For more information on these connections, see "Supported connections and data paths in Digi devices" on page 44. Access to Telnet network services can be enabled or disabled. Remote Login (rlogin) Users can perform logins to remote systems (rlogin).
Page 34: Hypertext Transfer Protocol (Http) Hypertext Transfer Protocol Over Secure Socket Layer (Https)
F e a t u r e s HyperText Transfer Protocol (HTTP) HyperText Transfer Protocol over Secure Socket Layer (HTTPS) Digi devices provide web pages for configuration that can be secured by requiring a user login. Internet Control Message Protocol (ICMP) ICMP statistics can be displayed, including the number of messages received, bad messages received, and destination unreachable messages received.
Page 35: Generic Routing Encapsulation (Gre) Passthrough Encapsulating Security Payload (Esp) Esp Passthrough
For Digi devices equipped with a Code-Division Multiple Access (CDMA)-based cellular modem, a wizard is available in the web interface to properly configure the Digi device with the required configuration used to access the mobile network. The wizard allows for both automatic and manual provisioning for a variety of mobile service providers.
Page 36: Mobile/Cellular Protocols
F e a t u r e s Mobile/Cellular protocols Protocols supported in the Digi Cellular Family include, unless otherwise noted: Global System for Mobile communication (GSM) Code-Division Multiple Access (CDMA) General Packet Radio Service (GPRS) Enhanced Data Rates for GSM Evolution (EDGE)
Page 37: General Packet Radio Service (Gprs)
I n t r o d u c t i o n General Packet Radio Service (GPRS) GPRS is based on Global System for Mobile (GSM) communication. GPRS is a packet- based wireless communication service that transports data rates from 56 up to 114 Kbps and continuous connection to the Internet for mobile phone and computer users.
Page 38: Evolution-Data Optimized (Ev-Do, Evdo, Or 1Xev-Do)
F e a t u r e s the network. It will also make it possible to provide new services, such as alternative billing methods (pay-per-bit, pay-per-session, flat rate, asymmetric bandwidth, and others). The higher bandwidth of UMTS also promises new services, such as video conferencing.
Page 39: Ip Address Assignment Alternatives
IP address assignment alternatives There are several ways to assign an IP address to a Digi device: Static IP: Assign a specific IP address to a device, through the Digi Device Setup Wizard, the web interface, or the command-line interface.
Page 40: Realport Software
The software is installed directly on the host PC and allows applications to talk to devices across a network as though the devices were directly attached to the host. Actually, the devices are connected to a Digi device somewhere on the network.
Page 41: Alarms
I n t r o d u c t i o n Alarms Digi devices can be configured to issue alarms, in the form of email message or SNMP traps, when certain device events occur. These events include certain data patterns being detected in the data stream, and cellular alarms for signal strength and amount of cellular traffic for a given period of time.
Page 42: Security Features
F e a t u r e s Security features Security-related features in Digi devices include: Secure access and authentication: – One password, one permission level. – Can issue passwords to device users. – Can selectively enable and disable network services such as ADDP, RealPort, Encrypted RealPort, HTTP/HTTPS, LPD, Remote Login, Remote Shell, SNMP, and Telnet.
Page 43: Configuration Management
I n t r o d u c t i o n Configuration management Once a Digi device is configured and running, configuration-management tasks need to be periodically performed, such as: Upgrading firmware Copying configurations to and from a remote host...
Page 44: Supported Connections And Data Paths In Digi Devices
S u p p o r t e d c o n n e c t i o n s a n d d a t a p a t h s i n D i g i d e v i c e s Supported connections and data paths in Digi devices Digi devices allow for several kinds of connections and paths for data flow between the Digi device and other entities. These connections can be grouped into two main...
Page 45: Network Services Associated With Serial Ports In General
Network services associated with the command-line interface Network service connections associated with the command-line interface include: Telnet: A user can Telnet directly to a Digi device’s command-line interface. rlogin: A user can perform a remote login (rlogin) to a Digi device’s command- line interface.
Page 46: Network/Serial Clients
S u p p o r t e d c o n n e c t i o n s a n d d a t a p a t h s i n D i g i d e v i c e s Network/serial clients A network/serial client connection is one in which a Digi device initiates a network connection or opens a serial port for communication. There are several categories of...
Page 47: Configuration Capabilities And Interfaces
I n t r o d u c t i o n Configuration capabilities and interfaces Following is an overview of the configuration capabilities and interfaces for Digi devices. Chapter 2, "Configure Digi devices" covers these capabilities and interfaces in more detail.
Page 48: Configuration Interfaces
Configuration interfaces Several interfaces are available for configuring Digi devices, including: The Digi Device Setup Wizard, which helps set up an IP address for the device and quickly configure features. The Digi Device Discovery Utility, which locates Digi devices on a network, and allows opening the web interface for the devices.
Page 49: The Digi Device Setup Wizard
I n t r o d u c t i o n The Digi Device Setup wizard The Digi Device Setup Wizard is a wizard, for configuring Digi devices. It is provided on the CD shipped with each product. It assigns an IP address for the device, configures the device’s serial port parameters based on a selected configuration scenario called a port...
Page 50 To access the Digi Device Setup Wizard, insert the Software and Documentation CD that accompanies the Digi device in a PC’s CD drive. The Digi Device Setup Wizard will automatically start. The Digi Device Setup Wizard has online help, accessed from the Help button on wizard...
Page 51: Digi Device Discovery Utility
I n t r o d u c t i o n Digi Device Discovery utility The Digi Device Discovery utility can be used to locate a Digi device and open its web interface. It uses the Advanced Digi Discovery Protocol (ADDP), a Digi International- proprietary protocol for discovering devices on networks, to discover the Digi devices on a network, and displays the discovered devices in a list, as shown below.
Page 52 Not all Digi devices support ADDP. The Digi Device Discovery utility is available on the Software and Documentation CD that accompanies the Digi device. After installing the utility, it is available from the Start menu. Access to the ADDP service can be enabled or disabled, but the network port number for ADDP cannot be changed from its default.
Page 53: The Web Interface
I n t r o d u c t i o n The Web interface A web interface is provided as an easy way to configure and monitor Digi devices. Configurable features are grouped into several categories. These categories vary by product;...
Page 54 If necessary, settings can be modified later from the command line. To access the web interface, enter the Digi Cellular Family device’s IP address or host name in a browser’s URL window. The main menu of the web interface is displayed.
Page 55: Command-Line Interface
I n t r o d u c t i o n Command-line interface Digi devices can be configured by issuing commands from the command line. The command-line interface allows communication directly without a graphical interface. For example, the following is a command issued from the command line to assign the IP address to the Ethernet interface: #>...
Page 56: Connectware Manager Interface
C o n f i g u r a t i o n c a p a b i l i t i e s a n d i n t e r f a c e s Connectware Manager interface Connectware Manager is an optional, centralized device and network management package.
Page 57 Disadvantages include: Devices must be provisioned (assigned an IP address) before they can be accessed on Connectware Manager. Use the Digi Device Setup Wizard to provision devices. If used to manage a device, some of the device configuration options that are available on other device configuration interfaces, such as the web and command-line interfaces, will not be available.
Page 58: Simple Network Management Protocol (Snmp)
SNMP is widely used. SNMP is a standard interface that integrates well with network management stations in an enterprise environment. While its capabilities are limited to device monitoring and display of statistics in Digi Cellular Family devices, read/write capabilities are expected to be added to Digi Cellular Family devices in future releases.
Page 59: Standard Mibs Supported
CHARACTER-MIB (RFC 1658) RS-232-MIB (RFC 1659). Digi enterprise MIBs supported In addition to the standard MIBs, Digi devices use several Digi enterprise MIBs, including: DIGI-DEVICE-INFO.mib: for handling device information. This MIB gives access to elements like the firmware revision, device name, IP network information, memory, and CPU statistics.
Page 60: Monitoring Capabilities And Interfaces
M o n i t o r i n g c a p a b i l i t i e s a n d i n t e r f a c e s Monitoring capabilities and interfaces There are several capabilities and interfaces for monitoring Digi devices and managing their connections; these are covered in more detail in Chapter 3, "Monitor and manage Digi devices".
Page 61: Command-Line Interface
I n t r o d u c t i o n System Information: – General device information – Serial port information: for each port, the port’s description, current profile, and current serial configuration. This is the same information displayed by choosing Serial Port Management.
Page 62: Administration Tasks
A d m i n i s t r a t i o n t a s k s Administration tasks Periodically, administrative tasks need to be performed on Digi devices, such as: Uploading and managing files Changing the password for logging onto the device...
Page 63: Chapter 2: Configure Digi Devices
169. "Batch capabilities for configuring multiple devices" on page 174. The primary focus of this chapter is on configuring Digi devices through the web interface. To use the Digi Device Setup Wizard for initial configuration, see the online help for the Wizard. For instructions on launching the wizard, see "Configure an IP...
Page 64: Default Ip Address
To use the Digi Device Setup Wizard: Connect the Digi deviceto the network and power it on. Locate the MAC address for the Digi device; it is on a label on the bottom of the product. Record it for later use in assigning an IP address.
Page 65: Configure An Ip Address Using Dhcp
A IP address can also be configured using Dynamic Host Configuration Protocol (DHCP). If desired, set up a permanent entry for the Digi device device on a DHCP server. While this is not necessary to obtain an IP address via DHCP, setting up a permanent entry means the IP address is saved when the device is rebooted.
Page 66: Configure An Ip Address From The Command-Line Interface
Configuration > Network > IP Settings. On the IP Settings page, enter the new IP address, subnet mask, and gateway. To use Connectware Manager, first configure the Digi device using the Digi Device Setup Wizard, then install Connectware Manager. For more information, see the Connectware...
Page 67: Test The Ip Address Configuration
Once the IP address is assigned, test the IP address configuration to be sure it works as configured. This procedure assumes that the Digi device has an IP address. Access the command line of a PC or other networked device.
Page 68: Configuration Through The Web Interface
C o n f i g u r a t i o n t h r o u g h t h e w e b i n t e r f a c e Configuration through the web interface Configuring Digi devices through the web interface involves these tasks: Change the IP address, as needed. See page 74.
Page 69: Open The Web Interface
Open the web interface To open the web interface, either enter the Digi device’s URL in a web browser and log on to the device, if required, or use the Digi Device Discovery utility to locate it and open its web interface.
Page 70: Discover Devices
From the start menu, select Start > Programs > Digi Connect > Digi Device Discovery. The Digi Device Discovery application is displayed. Locate the device in the list of devices, and double-click it, or select the Digi device from the list and select Open web interface in the Device Tasks list.
Page 71: Organization Of The Web Interface
C o n f i g u r e D i g i d e v i c e s Organization of the web interface When web interface is opened, the Home page is displayed. Here is a home page for a ConnectPort X Family product.
Page 72: The Home Page
After 5 minutes of inactivity, the idle timeout also automatically performs a user logout. The Getting Started section has a link to a tutorial on configuring and managing Digi device.
Page 73: Application Pages
C o n f i g u r e D i g i d e v i c e s Application pages Depending on the Digi device, there may be an Application menu item for configuring various applications available for use in the device.
Page 74: Change The Ip Address From The Web Interface, As Needed
Open a web browser and enter the Digi device’s current IP address in the URL address bar. If security is enabled for the Digi device, a login prompt is displayed. Enter the user name and password for the device. The default username is root and the default password is dbps.
Page 75: Configure Network Communications
IP address is dynamically assigned to be located by a host or domain name. See page 87. IP Filtering Settings: For configuring the Digi Cellular Family device to only accept connections from specific and known IP addresses or networks. See page 90.
Page 76: Alternatives For Configuring Network Communications
When the IP address does change, you and other network devices configured to talk to the Digi devicecan no longer access the device. In this case, the Digi device must be located the Digi Device Discovery utility, and other network devices that need to communicate with the Digi device must be reconfigured.
Page 77: Dhcp Server Settings
C o n f i g u r e D i g i d e v i c e s DHCP server settings The DHCP server feature can be enabled in a Digi device to allow other devices or hosts on this network to be assigned dynamic IP addresses. This DHCP server supports a single subnetwork scope.
Page 78 Options are other client configuration parameters that the DHCP server can assign when serving leases to DHCP clients. Most options are defined in RFC 2132. The DHCP server in Digi device supports a limited set of options: – Option 3: Routers on Subnet –...
Page 79: Addresses In The Dhcp Server Settings
IP settings, see "IP settings" on page 76. IP Addresses: The starting and ending IP addresses for the scope being served by this DHCP server. These addresses must be in the same subnet as the Digi device itself.
Page 80 C o n f i g u r a t i o n t h r o u g h t h e w e b i n t e r f a c e Check that an IP address is not in use before offering it: When a DHCP client requests a new IP address lease, before offering an IP address to that client, use “ping”...
Page 81: Manage The Dhcp Server
C o n f i g u r e D i g i d e v i c e s Address Exclusions: A specific set of IP addresses to exclude from the scope. The DHCP server will not grant leases to clients for any IP address in the exclusion range.
Page 82: Network Services Settings
The Network Services page shows a set of common network services that are available for Digi devices, and the network port on which the service is running. Common network services can be enabled and disabled, and the TCP port on which the network service listens can be configured.
Page 83: Supported Network Services And Their Default Network Port Numbers
C o n f i g u r e D i g i d e v i c e s Supported network services and their default network port numbers In Digi devices that have multiple serial ports, the network port number defaults for various services are set based on the following formula:...
Page 84 A virtual connection to serial devices, no matter where they reside on the network. Remote login (Rlogin) Allows users to log in to the Digi device and access the command-line interface through Rlogin. Remote shell (Rsh) Allows users to log in to the Digi device and access the...
Page 85 Default network port number Secure Shell (SSH) Allows users secure access to log in to the Digi device and access the command-line interface. Secure Shell (SSH) Passthrough Accessing a specific serial port set up for SSH. 2501 Secure Socket Service Authentication and encryption for Digi devices.
Page 86: Network Services And Ip Pass-Through
To provide access to the device for configuration and management purposes, you can configure a subset of network services to terminate at the Digi device instead of being passed on to a connected device such as a router. In the IP pass-through feature, these network services are called pinholes.
Page 87: Dynamic Dns Update Settings
IP address and update it as it changes. A DDNS service provider typically supports the registration of only public IP addresses. When using such a service provider, if your Digi device has a private IP address (such as 192.168.x.x or 10.x.x.x), your update requests will be rejected.
Page 88 According to wildcard documentation at DynDNS.org: “The wildcard aliases *.yourhost.ourdomain.tld to the same address as yourhost.ourdomain.tld.” Using this option in the settings for your Digi device has the same effect as selecting the wildcard option on the DynDNS.org website. To leave the wildcard option unchanged from the current selection on their web site, use the “no change”...
Page 89: Status And History Information
– Service: The name of the DDNS service provider or server being updated. – IP Address Reported: The IP address for your Digi device that is being registered with the DDNS service provider or server. – Update Status: A simple indication of success or failure for this last update request.
Page 90: Ip Filtering Settings
Note that if you enable this feature and the system from which you are connecting to the Digi device is not included in the list of allowed devices or networks, then you will instantly no longer be able to communicate or configure the device from this system.
Page 91: Ip Forwarding Settings
IP address that is controlled by Port Forwarding/NAT. Port forwarding can be used to connect from a Digi device to a RealPort device, such as a Digi Connect SP. For this type of connection to occur, your mobile wireless provider must be mobile-terminated.
Page 92: Example
Example For example, to enable port forwarding of RealPort data (network port 771) on a Digi Connect WAN VPN to a Digi Connect SP with an IP address of 10.8.128.10, you would do the following: Make sure the Enable IP Routing checkbox is checked.
Page 93: Socket Tunnel Settings
The Digi device then opens a separate connection to the specified destination host. Once the tunnel is established, the Digi device acts as a proxy for the data between the remote network socket and the local network socket, regardless of which end initiated the tunnel.
Page 94: Ip Pass-Through Settings
Digi device. Since the mobile network address is effectively “passed-through” to the local device connected to the Ethernet port of the Digi device, all network access to it is bypassed, with some specific exceptions.
Page 95 C o n f i g u r e D i g i d e v i c e s If the third-party router’s WAN interface is attached to the Digi device’s Ethernet port, and the Digi device’s mobile interface receives the IP address 166.213.2.215, the router’s WAN port is assigned the same IP address 166.213.2.215.
Page 96: How Ip Pass-Through Affects Network Access To Digi Devices
DDNS updates Socket Tunnel Network Services configuration. The Digi device is effectively transparent to all IP activity and network access by other devices, with these exceptions: It can be accessed via the serial port for configuration using the command line interface.
Page 97: Remote Device Management And Ip Pass-Through
Connectware Manager and Digi SureLink ports are automatically set up as pinholes so that they continue to work with the Digi device. In addition, the Digi device uses a private address on the Ethernet interface strictly for use in configuration or local access. This allows a user on the local network to gain access to the web interface or a Telnet session in order to make configuration changes.
Page 98 C o n f i g u r a t i o n t h r o u g h t h e w e b i n t e r f a c e The screen shot shows IP Pass-through configuration settings.
Page 99: Virtual Private Network (Vpn) Settings
The Digi device is responsible for handling the routing between networks. Devices within the private network served by the Digi device can connect directly to devices on the other private network to which the VPN tunnel is established to. The VPN tunnels are configured using various security settings and methods to ensure the networks are secured.
Page 100: Example Vpn Configuration
The Digi device sees the request as being on the HQ subnet and checks whether a VPN tunnel exists between the two sites. If no tunnel exists, the Digi device initiates a VPN tunnel request to its peer — the VPN concentrator at HQ. The VPN policy settings are compared, and if they match, an IPsec tunnel is created between the Digi device and the VPN concentrator.
Page 101: Ip Address Requirements For Vpn Tunnels
HQ router / VPN appliance configuration For supported protocols, see the IPsec specifications your Digi device. Security policies on the HQ VPN device must match those on the Digi device. The HQ VPN appliance’s peer address is the Digi device’s mobile IP address.
Page 102: Using A Console Port
C o n f i g u r a t i o n t h r o u g h t h e w e b i n t e r f a c e Using a console port The Digi device’s console port can be configured for Console Management to provide SSH or Telnet access. It can be cabled to the router or VPN appliance’s console port to provide true diverse out-of-band console access.
Page 103 Ethernet port is 192.168.1.1. The default gateway may change to an address such as 10.6.6.6, which is the mobile service provider’s default gateway. Using a web browser, open the web interface for the Digi device using the IP address you assigned; for example, 172.17.1.1.
Page 104 C o n f i g u r a t i o n t h r o u g h t h e w e b i n t e r f a c e Click VPN Internet Key Exchange (IKE) Settings. 1 0 4...
Page 105 Identity string: Identifies the VPN client with the remote VPN endpoint. The default is macaddress@digi.com. You can also specify the identity as: A Fully Qualified Domain Name (FQDN): Usually the FQDN of the Digi Connect device. For example: www.myhost.com A User FQDN: Similar to standard FQDN but with a user name. The format is the same as an email address.
Page 106 C o n f i g u r a t i o n t h r o u g h t h e w e b i n t e r f a c e Aggressive Mode: Processes phase one negotiations with fewer exchanges than Main Mode.
Page 107 C o n f i g u r e D i g i d e v i c e s Specify the Internet Key Exchange (IKE) Security Settings for the VPN connection. Internet Key Exchange (IKE) negotiates IPSec security associations (SA).
Page 108 C o n f i g u r a t i o n t h r o u g h t h e w e b i n t e r f a c e Click VPN Policy Settings to add, modify, or delete a VPN tunnel. VPN Tunnels define the actual tunnels between two private networks.
Page 109 C o n f i g u r e D i g i d e v i c e s Manual-Keyed IPSec/ESP tunnels are established by manually specifying the tunnel and security settings. See page 112 for more information on these tunnels.
Page 110 C o n f i g u r a t i o n t h r o u g h t h e w e b i n t e r f a c e For example, to configure the ISAKMP VPN tunnel in the example configuration, you would choose ISAKMP and enter the pre-shared key (PSK) information and security policy.
Page 111 C o n f i g u r e D i g i d e v i c e s When the VPN tunnel has been added to the configuration settings after you click Apply, the VPN Policy Settings page looks like this: Configure the remote VPN concentrator with the same settings, remembering to reverse the peer endpoint and remote/local subnet settings.
Page 112: Manual-Keyed Ipsec/Esp Vpn Tunnel Security Settings
C o n f i g u r a t i o n t h r o u g h t h e w e b i n t e r f a c e Manual-keyed IPSEc/ESP VPN tunnel security settings Manual-keyed IPSec/ESP tunnels specify the tunnel and security settings manually.
Page 113 C o n f i g u r e D i g i d e v i c e s There are two groups of manual-keyed settings, for incoming and outgoing traffic, which differ from each other, depending on the implementation of the remote VPN server. Incoming Traffic Security Settings: Incoming traffic is any traffic sent from a remote peer on the remote network of the remote VPN endpoint to a local peer on the local network.
Page 114 C o n f i g u r a t i o n t h r o u g h t h e w e b i n t e r f a c e Enable Authentication Authentication algorithm Authentication key: The optional authentication algorithm and associated authentication key used to authorize access on the VPN tunnel.
Page 115: Isakmp Vpn Tunnel Security Settings
C o n f i g u r e D i g i d e v i c e s ISAKMP VPN tunnel security settings ISAKMP security settings include a pre-shared key and security policies for incoming and outgoing traffic. These settings must be set as specified by the remote VPN server. They affect the network traffic between the local and remote peers specified on the Tunnel Network Traffic from the following Local Network and Tunnel Network Traffic to the following Remote Network settings.
Page 116 C o n f i g u r a t i o n t h r o u g h t h e w e b i n t e r f a c e Use the following pre-shared key to negotiate IKE security settings: The Pre-Shared Key (PSK) specifies the shared key used to secure the VPN tunnel.
Page 117: Vpn Tunnel Proposal Configuration For Isakmp Tunnels
C o n f i g u r e D i g i d e v i c e s VPN tunnel proposal configuration for ISAKMP tunnels The Proposal Configuration settings configure a set of security policies for ISAKMP tunnels. The settings define the set of encryption and authentication algorithms for incoming and outgoing traffic over the VPN tunnel.
Page 118: Advanced Network Settings
C o n f i g u r a t i o n t h r o u g h t h e w e b i n t e r f a c e Advanced network settings The Advanced Network Settings are used to further define the network interface, including: Host name: The Host name to be placed in the DHCP Option 12 field.
Page 119: Configure Mobile (Cellular) Settings
If your Digi device has not already been provisioned for use in the mobile network, you can launch a wizard to provision it from these pages.
Page 120: Set Mobile Configuration Settings To Factory Defaults
The Mobile Service Provider settings part of the screen identifies the service provider to use in connecting to the mobile network. The information displayed varies by Digi Cellular Family product and whether the remote service provider is GSM- or CDMA- based.
Page 121: Provision A Mobile Device
The device must be provisioned before you will be able to create a data connection to the mobile network.The device only needs to be provisioned once. This type of provisioning applies only to Digi devices that have a CDMA cellular module.
Page 122: Automatic Versus Manual Provisioning
The sequence of Mobile Device Provisioning Wizard screens displayed and the settings on them vary by product and mobile service provider. If you used the Digi Device Setup Wizard for initial configuration of your Digi device, and selected a service provider in the wizard, some of the provisioning settings will have already been established.
Page 123 C o n f i g u r e D i g i d e v i c e s Select automatic or manual provisioning. The main difference between automatic and manual provisioning is that manual provisioning involves entering more information. You will have received all of this information from your mobile service provider during account setup.
Page 124: Re-Provision A Digi Device
Upon successful completion of provisioning, a screen is displayed stating that the provisioning was successful.Click Finish. Click Apply on the Mobile Configuration page to complete the provisioning. Re-provision a Digi device Re-provisioning a Digi device simply consists of going through the Mobile Device Provisioning Wizard again. 1 2 4...
Page 125: Mobile Connection Settings
The Mobile Connection Settings configure Digi SureLink™ settings for a Digi device. SureLink ensures that a Digi device is in a state where it can connect to the mobile network, and they can be used to monitor the integrity of the established mobile connection.
Page 126: Hardware Reset Thresholds
1 and 255. The default is 3. Power-cycle the device after the following number of consecutive failed connections: Enables or disables a power-cycle of the Digi device after the specified number of failed connection attempts. This value can be a number between 1 and 255.
Page 127 C o n f i g u r e D i g i d e v i c e s Ping Test: Enables or disables the use of “ping” (ICMP) as a test to verify the integrity of the mobile connection. The test is successful if a valid ping reply is received in response to the ping request sent.
Page 128 C o n f i g u r a t i o n t h r o u g h t h e w e b i n t e r f a c e DNS Lookup Test: Enables or disables the use of a Domain Name Server (DNS) lookup as a test to verify the integrity of the mobile connection.
Page 129: Status And Statistical Information For Mobile Connections
C o n f i g u r e D i g i d e v i c e s Test only when idle: if no data is received for the above period of time: Specifies that the test repeat interval (above) is to be used as an idle period interval.
Page 130: Configure Mesh/Zigbee Network Settings
C o n f i g u r a t i o n t h r o u g h t h e w e b i n t e r f a c e Configure Mesh/ZigBee network settings A Digi ConnectPort X gateway provides a gateway between an Internet Protocol (IP) network and a mesh network of various ZigBee wireless devices. Typically, these mesh devices are small sensors and controllers.
Page 131: Zigbee Protocol Terms
C o n f i g u r e D i g i d e v i c e s router A router is a node that creates/maintains network information and uses this information to determine the best route for a data packet. A router must join a network before it can allow other routers and end devices to join to it.
Page 132 C o n f i g u r a t i o n t h r o u g h t h e w e b i n t e r f a c e joining The process of a node becoming part of a ZigBee PAN. A node becomes part of a network by joining to a coordinator or a router (that has previously joined to the network).
Page 133: Mesh Network Configuration Settings
C o n f i g u r e D i g i d e v i c e s Mesh Network configuration settings The Mesh Network Configuration settings (Configure > Mesh Network) displays a view of Mesh Network components, including the ConnectPort X gateway and any ZigBee nodes that have been discovered by the XBee module in the ConnectPort X gateway.
Page 134 XBee radio module. The configuration settings displayed vary depending on the type of XBee radio installed in your Digi device. The radio settings will include some or all of the settings described in this section.
Page 135: Basic Radio Settings
PAN ID: Sets the PAN (Personal Area Network) ID, in hex. This is the preferred PAN ID for the mesh network. If the configured ID setting is FFFF, the Digi device will select a random PAN ID. Otherwise, the specified ID will be used.
Page 136: Advanced Radio Settings
C o n f i g u r a t i o n t h r o u g h t h e w e b i n t e r f a c e Advanced radio settings Transmit Power Level: Sets the power level at which the RF module transmits conducted power.
Page 137: Configure Serial Ports
Port profiles simplify serial port configuration by displaying only those items that are relevant to the currently selected profile. If the Digi Device Setup Wizard was used to initially configure the Digi device, the wizard prompted to select a port profile.
Page 138: Realport Profile
The RealPort profile maps a COM or TTY port to a serial port. This profile configures a Digi device to create a virtual COM port on a PC, known as COM Port Redirection. The PC applications send data to this virtual COM port and RealPort sends the data across the network to the Digi device.
Page 139: Tcp Sockets Profile
Digi device. Automatic TCP connections (autoconnection) The TCP Client allows the Digi device to automatically establish a TCP connection to an application or a network, known as autoconnection. Autoconnection is enabled through the TCP Sockets profile’s setting labeled Automatically establish TCP connections.
Page 140: Tcp And Udp Network Port Numbering Conventions
Raw connection to the serial port 2101(TCP and UDP) Ensure that the application or Digi device that initiates communication with the uses these network ports numbers. If they cannot be configured to use these network port numbers, change the network port on the Digi device.
Page 141: Serial Bridge Profile
The Serial Bridge profile configures one side of a serial bridge. A serial bridge connects two serial devices over the network, each of which uses a Digi device, as if they were connected with a serial cable. The serial devices “think” they are communicating with each other across a serial cable using serial communication techniques.
Page 142: Custom Profile
9600 bits per second, 8 data bits, no parity, and 1 stop bit. When using RealPort (COM port redirection) or RFC 2217, these settings are supplied by applications running on the PC or server, and the default values on the Digi device do not need to be changed. 1 4 2...
Page 143: Advanced Serial Settings
Enable RTS Toggle: When enabled, the RTS (Request To Send) signal is forced high (on) when sending data on the serial port. Enable RCI over Serial (DSR): This choice allows the Digi Connect device to be configured through the serial port using the RCI protocol. See the RCI specification in the Digi Connect Integration Kit for further details.
Page 144: Tcp Settings
C o n f i g u r a t i o n t h r o u g h t h e w e b i n t e r f a c e TCP settings The TCP Settings are displayed only when the current serial port is configured with the TCP Sockets or the Custom Profile.
Page 145 C o n f i g u r e D i g i d e v i c e s Send data only under any of the following conditions: Enable if it is required to set conditions on whether the Digi device sends the data read from the serial port to the TCP destination. Conditions include: –...
Page 146: Udp Settings
C o n f i g u r a t i o n t h r o u g h t h e w e b i n t e r f a c e UDP settings The UDP Settings are displayed only when the current serial port is configured with the UDP Sockets or the Custom Profile.
Page 147: Configure Camera Settings
Configure camera settings ConnectPort X Family products support connecting a WatchPort Camera to one of its USB host ports. One Digi WatchPort V2 USB camera is supported. Camera settings These settings configure the operation of the camera and handling of images captured by the camera.
Page 148: Camera Operation
C o n f i g u r a t i o n t h r o u g h t h e w e b i n t e r f a c e Current Image: Displays a snapshot of the current camera image. Clicking on the image brings up a new window with the full size image (as configured above).
Page 149: Configure Alarms
SNMP traps when certain device events occur. These events include certain data patterns being detected in the data stream, and, for Digi Cellular Family products, alarms for signal strength and amount of cellular traffic for a given period of time.
Page 150: Alarm Conditions
C o n f i g u r a t i o n t h r o u g h t h e w e b i n t e r f a c e Alarm conditions The Alarm Conditions part of the Alarms page shows a list of all of the alarms. Up to 32 alarms can be configured for a Digi device, and they can be enabled and disabled individually. Alarm list The list of alarms displays the current status of each alarm.
Page 151: Alarm Conditions
C o n f i g u r e D i g i d e v i c e s Alarm conditions To configure an alarm, click on it. The configuration page for individual alarms has two sections: Alarm Conditions: For specifying the conditions on which the alarm is based, serial data pattern matching, signal strength (RSSI), or data usage.
Page 152: Alarm Destinations
C o n f i g u r a t i o n t h r o u g h t h e w e b i n t e r f a c e Alarm destinations The Alarm Destination part of the page defines how alarm notifications are sent—either as an email message or an SNMP trap, or both—and where the alarm notification is sent.
Page 153: Configure System Settings
SNMP traps that are enabled. Device description information A device description is a system description of the Digi device’s name, contact, and location. This device description can be useful for identifying a specific Digi device when working with a large number of devices in multiple locations.
Page 154: Configure Remote Management (Connectware Manager) Settings
Destination IP: The IP address of the system to which traps are sent. In order to enable any of the traps, a non-zero value must be specified. For Digi devices that support alarms, this field is required in order for alarms to be sent in the form of SNMP traps.
Page 155: Connection Settings
Digi devices communicating over a cellular network with a Connectware Manager server running in the home office. Addresses for Digi devices can be publicly known, or private and dynamic, or handled through Network Address Translation (NAT). (NAT reduces the need for a large amount of publicly known IP addresses by creating a separation between publicly known and privately known IP addresses.
Page 156: Last Known Address (Lka)
C o n f i g u r a t i o n t h r o u g h t h e w e b i n t e r f a c e A server-initiated connection works the opposite way. The Connectware Manager server opens a TCP connection, and the Digi device must be listening for the connection to the Connectware Manager server to occur. An advantage of server-initiated connections is that you are not charged for sending the keep-alive bytes that are used in client-initiated connections.
Page 157: Client Initiated Management Connection Settings
Enable Last Known Address (LKA) updates to the following server: Enables or disables a connection to a Connectware Manager server to inform that server of the IP address of the Digi device, known as a “last known address” (LKA) update. This permits the Connectware Manager to connect back to the Digi Cellular Family device, or to dynamically update a DNS with the IP address of the device.
Page 158: Advanced Remote Management Settings
Advanced settings are used in advanced situations. They are used to configure the idle timeout for the connection between the Digi device and the Connectware Manager server, and the keep-alive settings of the various interfaces (TCP and HTTP for mobile and Ethernet network connections).
Page 159 Username: Password: The username and password for logging on to the proxy host. Enable persistent proxy connections: Specifies whether the Digi device should attempt to use HTTP persistent connections. Not all HTTP proxies correctly handle HTTP persistent connections. The use of persistent...
Page 160: Alarms And The Connectware Manager Server
Security settings involve several areas: User authentication: whether authentication is required for users accessing the Digi device, and the information required to access it. You can choose to have the user authentication be by username and password or by an SSH public key.
Page 161: About User Models And User Permissions
Password authentication By default, there is no password authentication for Digi Cellular Family devices. That means if when accessing the Digi Cellular Family device by opening the web interface or issuing a telnet command, no login prompt is displayed. Enable password authentication If desired, enable password authentication for the Cellular Family device.
Page 162: Disable Password Authentication
Note must be reset to the default firmware settings. In Digi devices with a single-user model, changing the root password also changes the password for Advanced Digi Discovery Protocol (ADDP). In Digi devices with the multi- user model, changing the root password has no effect on ADDP. To change the ADDP password, use enter newpass name=addp from the command line.
Page 163: Upload An Ssh Public Key
Click Apply. Disable unused and non-secure network services Depending on your mobile service provider, other users can access your Digi device device over the Internet, through various network services enabled on your Digi device. To further secure the Digi device, network services not necessary to the device, particularly non-secure or un-encrypted network services such as Telnet, can be disabled.
Page 164: Configure Applications
Python has also been ported to Java and .NET virtual machines. Recommended distribution of Python interpreter The current version of the Python interpreter embedded in Digi devices is 2.4.3. Please use modules known to be compatible with this version of the Python language only.
Page 165: Python Files
C o n f i g u r e D i g i d e v i c e s Python files The Python files page is for uploading Python programs to a Digi device, and managing the uploaded files.
Page 166: Configuration Through The Command Line
IP address of the Digi device. For example: #> telnet 192.3.23.5 If security is enabled for the Digi device, (that is, a username and password have been set up for logging on to it), a login prompt is displayed. If the user name and password for the device are unknown, contact the system administrator who originally configured the device.
Page 167 C o n f i g u r e D i g i d e v i c e s Here are some examples of commands used to configure Digi devices. See the Introduction of the Digi Connect Family Command Reference for a complete list of features and tasks that can be configured and performed from the command line.
Page 168 C o n f i g u r a t i o n t h r o u g h t h e c o m m a n d l i n e To configure: Use this command: Point-to-Point (PPP) outbound connections set pppoutbound port buffering set buffer...
Page 169: Configuration Through Simple Network Management Protocol (Snmp)
These MIBs are listed and described on page 59, and must be loaded into a network management station (NMS). The standard and Digi Enterprise MIBs allow for very basic network and serial configuration. For more detailed configuration settings, use the command-line interface or web interface instead.
Page 170: Configuration Through Connectware Manager
C o n f i g u r a t i o n t h r o u g h C o n n e c t w a r e M a n a g e r Configuration through Connectware Manager Configuring Mesh Networks and Nodes through Connectware Manager Connectware Manager has several views for configuring and managing Mesh networks: The Mesh Networks view...
Page 171: Zigbee Networks View
C o n f i g u r e D i g i d e v i c e s ZigBee Networks View The Mesh Networks device management view of Connectware Manager allows for displaying devices within their ZigBee network, including their node ID, the network to which they belong, physical addresses, their role in the ZigBee network (coordinator, router, or end node), and their defined parent in the ZigBee network.
Page 172: Node View
C o n f i g u r a t i o n t h r o u g h C o n n e c t w a r e M a n a g e r Node View From the ZigBee Networks view, more detailed views of devices can be accessed.
Page 173 C o n f i g u r e D i g i d e v i c e s 1 7 3...
Page 174: Batch Capabilities For Configuring Multiple Devices
Digi Connect Family Customization and Integration Guide. What’s next? See Chapter 3, "Monitor and manage Digi devices" for details on viewing system information and device statistics and managing device connections and services. Chapter 4, "Administration tasks" describes common administrative tasks such as file management, updating firmware, and restoring configuration settings to factory defaults.
Page 175: Chapter 3: Monitor And Manage Digi Devices
Monitor and manage Digi devices The port, device, system, and network activities of Digi devicescan be monitored for from a variety of interfaces. Changes in data flow may indicate problems or activities that may require immediate attention. In addition, connections and network services can be managed.
Page 176: Monitoring Capabilities In The Web Interface
Display system information The System Information pages display information about a Digi device, and are typically used by technical support to troubleshoot problems. To display these pages, go to Administration > System Information. System Information pages include general system information, serial port information, network statistics, mobile information and statistics, and diagnostics.
Page 177: General System Information
MAC Address A unique network identifier. All network devices are required to have their own unique MAC address. The MAC address is on a sticker on the Digi device. The number is displayed as 12 hexadecimal digits, usually starting with 00:40:9D.
Page 178: Serial Port Information
M o n i t o r i n g c a p a b i l i t i e s i n t h e w e b i n t e r f a c e Up Time The amount of time the Digi device has been running since it was last powered on or rebooted.
Page 179: Configuration
Digi device should stop sending data. Input Flow Control. This signal indicates that the Digi device is operating as if flow control is enabled for incoming data sent from the remote side of the serial-port connection.
Page 180: Serial Statistics
The Serial statistics section of serial port information includes data counters and error tracking that will help determine the quality of data that is being sent or received. If the error counters are accumulating, there may be a problem in the Digi device. Total Data In Total number of data bytes received.
Page 181: Network Statistics
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 Digi device. Ethernet Connection Statistics Speed Ethernet link speed: 10 or 100 Mbps.
Page 182: Ip Statistics
Number of active opens. In an active open, the Digi device is initiating a connection request with a server. Passive Opens Number of passive opens. In a passive open, the Digi device is listening for a connection request from a client. Bad Segments Received Number of segments received with errors.
Page 183: Udp Statistics
M o n i t o r a n d m a n a g e D i g i d e v i c e s Established Resets Number of established connections that have been reset. UDP statistics Datagrams Received Datagrams Sent Number of datagrams received or sent.
Page 184: Mobile Information And Statistics
– Not Registered: Digi device is not currently searching a new operator to register to. – Registered: Home Network. – Not Registered: Digi device is currently searching a new operator to register to. – Registration Denied. – Unknown. – Registered - Roaming.
Page 185: Mobile Statistics
M o n i t o r a n d m a n a g e D i g i d e v i c e s Mobile Statistics Mobile statistics include the interface status, bytes received and sent, baud rate, modem resets, and inactivity timer.
Page 186: Mobile Information
M o n i t o r i n g c a p a b i l i t i e s i n t h e w e b i n t e r f a c e Mobile Information IMSI International Mobile Subscriber Identifier (IMSI), a unique 15-digit number which designates the subscriber.
Page 187: Surelink Statistics
(Note that the PPP link may come down for many reasons, independent of SureLink testing.) total successes The total number of times a configured test was attempted and succeeded since the Digi device was booted. 1 8 7...
Page 188: Diagnostics
M o n i t o r i n g c a p a b i l i t i e s i n t h e w e b i n t e r f a c e total failures The total number of times a configured test was attempted but failed since the Digi device was booted.
Page 189: Manage Connections And Services
M o n i t o r a n d m a n a g e D i g i d e v i c e s Manage connections and services The Management menu is for viewing and managing connections and services for the Digi device. Manage serial ports Management > Serial Ports provides an overview of the serial ports and their connections.
Page 190: Event Logging
M o n i t o r i n g c a p a b i l i t i e s i n t h e w e b i n t e r f a c e Event logging Information on this feature to be provided in a forthcoming release.
Page 191: View And Manage Current Dhcp Leases
M o n i t o r a n d m a n a g e D i g i d e v i c e s View and manage current DHCP leases The DHCP server maintains a current list of its leases, reservations and unavailable addresses.
Page 192: Lease Status Types
M o n i t o r i n g c a p a b i l i t i e s i n t h e w e b i n t e r f a c e Lease status types Descriptions of Lease Status values that are displayed in the lease list follow, including how long a lease table entry will remain in each state.
Page 193: Manage Mesh Networks
DHCP server setting Check that an IP address is not in use before offering it). Manage Mesh networks Digi provides several avenues for managing Mesh networks and the ZigBee devices in the Mesh Network: From a ConnectPort X device’s web interface. This section focuses on this interface.
Page 194: Manage Mesh Networks From The Web Interface
M o n i t o r i n g c a p a b i l i t i e s i n t h e w e b i n t e r f a c e Manage Mesh networks from the web interface To display information about Mesh networks and devices within them, select Administration >...
Page 195: Gateway Device Details
M o n i t o r a n d m a n a g e D i g i d e v i c e s Gateway device details This part of the display shows information about the ConnectPort X gateway and its role PAN ID, Channel, and as a gateway device in the Mesh network.
Page 196: Python Application Zigbee Socket Error Counts
M o n i t o r i n g c a p a b i l i t i e s i n t h e w e b i n t e r f a c e Python Application ZigBee Socket Error Counts This section includes error counters that are specific to ZigBee Sockets implemented using a Python application.
Page 197: Mesh Device State Pages
M o n i t o r a n d m a n a g e D i g i d e v i c e s Mesh device state pages Clicking a device in the Network View of the Mesh Devices displays the Mesh Device State page for the selected Mesh device.
Page 198: Monitoring Capabilities From The Command Line
M o n i t o r i n g c a p a b i l i t i e s f r o m t h e c o m m a n d l i n e Monitoring capabilities from the command line There are several commands for monitoring Digi devices and managing their connections. For complete descriptions of these commands, see the Digi Connect Family Command Reference.
Page 199: Info
M o n i t o r a n d m a n a g e D i g i d e v i c e s info The info command displays statistical information about a device over time. The statistics displayed are those gathered since the tables containing the statistics were last cleared.
Page 200: Set Alarm
M o n i t o r i n g c a p a b i l i t i e s f r o m t h e c o m m a n d l i n e set alarm The set alarm command displays current alarm settings, including the conditions which trigger alarms, and how the alarms are sent, either as an email message, an SNMP trap, or...
Page 201: Commands For Managing Connections And Sessions
M o n i t o r a n d m a n a g e D i g i d e v i c e s Commands for managing connections and sessions close: Closes active sessions that were opened by connect, rlogin, and telnet commands.
Page 202: Commands For Managing Mesh Networks And Nodes
M o n i t o r i n g c a p a b i l i t i e s f r o m t h e c o m m a n d l i n e Commands for managing Mesh networks and nodes Several commands are used to configure Mesh networks and display information and statistics about the devices in the Mesh network: set mesh, display mesh, and info...
Page 203: Display Mesh Network Configuration Settings: Command Syntax
M o n i t o r a n d m a n a g e D i g i d e v i c e s packet_timeout=0-255 {Packetization timeout, chars} dio0_config=0-5 {AD0/DIO0 configuration} dio1_config=0-5 {AD1/DIO1 configuration} dio2_config=0-5 {AD2/DIO2 configuration} dio3_config=0-5 {AD3/DIO3 configuration} dio4_config=0-5...
Page 204: Display Mesh
M o n i t o r i n g c a p a b i l i t i e s f r o m t h e c o m m a n d l i n e display mesh The display mesh command refreshes the display of Mesh network devices, and displays specific information about Mesh network devices.
Page 205: Info Zigbee_Sockets
M o n i t o r a n d m a n a g e D i g i d e v i c e s #> display mesh address=00:0d:6f:00:00:06:89:31! Status of device: 00:0d:6f:00:00:06:89:31! channel : 18 net_addr : 0x8e3e association : 0x0 firmware_version : 0x1220...
Page 206: Monitoring Capabilities From Connectware Manager
M o n i t o r i n g c a p a b i l i t i e s f r o m C o n n e c t w a r e M a n a g e r Monitoring capabilities from Connectware Manager Digi devices can be monitored and managed from Connectware Manager. Examples of activities from Connectware Manager include:...
Page 207: Monitor/Manage Mesh Networks From Connectware Manager
Digi’s Connectware Manager provides remote network management of all connected hardware, including devices on the ZigBee network. In contrast to the one-user-to-one device model of other Digi device interfaces, Connectware Manager deploys a one-user- to-many-devices interface model. From Connectware Manager, you can provision and configure network hardware, track device performance, remotely set filters and alarms, monitor connections, reboot devices and reset defaults, and remotely upgrade firmware.
Page 208: Monitoring Capabilities From Snmp
Network statistics, defined in RFC 1213, MIB-II Port statistics, defined in RFCs 1316 and 1317 Device information, defined in Digi enterprise MIB DIGI-DEVICE-INFO.mib For more information on the statistics available through the standard RFCs listed above, refer to the RFCs available on the IETF web site (www.ietf.org). For enterprise MIBs, refer to the description fields in the MIB text.
Page 209: Chapter 4: Administration Tasks
A d m i n i s t r a t i o n t a s k s Administration tasks This chapter discusses the administration tasks that need to be performed on Digi devices periodically, such as file management, changing the password used for logging onto the...
Page 210: Administration From The Web Interface
System Information: For displaying general system information for the device and device statistics. See "Display system information" on page 217. Reboot: For rebooting the device. See "Reboot the Digi device" on page 217. These administrative tasks are organized elsewhere in the web interface: Enable and disable network services.
Page 211: File Management
Java applet is not used, using this feature is not necessary. Uploading Files To upload files to a Digi device, enter the file path and name for the file, or click Browse to locate and select the file, and click Upload.
Page 212: X.509 Certificate/Key Management
A d m i n i s t r a t i o n f r o m t h e w e b i n t e r f a c e X.509 Certificate/Key Management The X.509 Certificate/Key Management pages are for loading and managing X.509 certificates and public/private host key pairs that are public key infrastructure (PKI) based security.
Page 213: Backup/Restore Device Configurations
A d m i n i s t r a t i o n t a s k s Backup/restore device configurations Once a Digi device is configured, backing up the configuration settings is recommended in case problems occur later, firmware is upgraded, or hardware is added. If multiple devices need to be configured, the backup/restore feature can be used as a convenience, where the first device’s configuration settings is backed u to a file, then the file is loaded...
Page 214: Update Firmware And Boot/Post Code
A d m i n i s t r a t i o n f r o m t h e w e b i n t e r f a c e Update firmware and Boot/POST Code The firmware and/or boot/POST code for a Digi device can be updated from a file on a PC or through TFTP.The recommended method is to download the firmware to a local hard drive.
Page 215: Restore A Device Configuration To Factory Defaults
See "File management" on page 211 for information on loading and deleting files. There are two ways to reset the device configuration of a Digi device to the factory default settings: from the web interface and using the reset button on the Digi device.
Page 216: Using The Reset Button
A d m i n i s t r a t i o n f r o m t h e w e b i n t e r f a c e Using the Reset button If the Digi device cannot be accessed from the web interface, the configuration can be restored to factory defaults by using the Reset button.
Page 217: Display System Information
Display system information System information displays the model, MAC address, firmware version, boot version, and POST version of the Digi device. It also displays memory available: total, used, and free, and tracks CPU percent utilization and the uptime. From the web interface menu, select Administration > System Information. Select General, Serial or Network for the appropriate information.
Page 218: Administration From The Command-Line Interface
A d m i n i s t r a t i o n f r o m t h e c o m m a n d - l i n e i n t e r f a c e Administration from the command-line interface Administrative tasks for Digi devices can also be performed from the command line. Here are several device-administration tasks and the commands used to perform them. See the Digi Connect Family Command Reference for more complete command descriptions.
Page 219: Chapter 5: Specifications And Certifications
S p e c i f i c a t i o n s a n d c e r t i f i c a t i o n s Specifications and certifications This chapter provides hardware specifications, additional feature detail, and regulatory statements and certifications for Digi devices. Hardware specifications Regulatory statements and certifications 2 1 9...
Page 220: Hardware Specifications
H a r d w a r e s p e c i f i c a t i o n s Hardware specifications ConnectPort X8 specifications Specification Value Environmental Ambient temperature -30 to 60C (-22 to 140F) Relative humidity 5 to 95% (non-condensing) Storage and transport -40 to 85C (-40 to 185F)
Page 221: Regulatory Information And Certifications
S p e c i f i c a t i o n s a n d c e r t i f i c a t i o n s Regulatory information and certifications Safety standards The ConnectPort X8 gateway device complies with the standards cited in this section. FCC Part 15 Class B Radio Frequency Interface (RFI) (FCC 15.105) The ConnectPort X8 gateway device has been tested and found to comply with the limits...
Page 222: Modifications (Fcc 15.21)
FCC ID. This exterior label can use wording such as the following: “Contains Transmitter Module FCC ID: MCQ-50M1358/ IC: 1846A-50M1358”. 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. Industry Canada...
Page 223: International Emc Standards
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.
Page 224: Important Safety Information
I m p o r t a n t S a f e t y I n f o r m a t i o n Important Safety Information To avoid contact with electrical current: Never install electrical wiring during an electrical storm. Never install an Ethernet connection in wet locations unless that connector is specifically designed for wet locations.
Page 225 ADDP allows the system to identify all ADDP-enabled Digi devices attached to a network by sending out a multicast packet. The Digi devices respond to the multicast packet and identify themselves to the client sending the multicast.
Page 226 COM or TTY port on the host. See also RealPort. configuration management For Digi devices, configuration management involves managing the files and settings that contain device configuration information. Configuration management tasks include copying device configuration files to and from a remote host, upgrading device firmware, and resetting the device configuration to factory defaults.
Page 227 See Dynamic Host Configuration Protocol. Digi Device Setup Wizard A wizard for configuring Digi devices that is provided on the CD shipped with each device. The Digi Device Setup Wizard is available in Microsoft Windows or UNIX platforms. It assigns an IP address for the device, configures the device based on your description of the device environment, and determines whether you need to install RealPort.
Page 228 A method of carrying IP packets for a Virtual Private Network (VPN) setup. In ESP Passthrough, inbound IPsec ESP protocol traffic is forwarded from to a VPN device connected to the Digi device’s Ethernet port. Evolution-Data Optimized (EV-DO, EVDO, or 1xEV-DO) A wireless radio broadband data standard adopted by many CDMA mobile phone service providers.
Page 229 A method of carrying IP packets for a Virtual Private Network (VPN) setup. In GRE Passthrough, inbound IPsec GRE protocol traffic is forwarded from to a VPN device connected to the Digi device’s Ethernet port. Global System for Mobile communication (GSM) A digital mobile telephone system that digitizes and compresses data, then sends it down a channel with two other streams of user data, each in its own time slot.
Page 230 HTTP See HyperText Transfer Protocol. HTTPS See HyperText Transfer Protocol over Secure Socket Layer. HyperText Transfer Protocol (HTTP) An application protocol in the TCP/IP suite that defines the rules for transferring files (text, graphic images, sound, video, and other multimedia files) on the World Wide web (WWW).
Page 231 Internet Group Management Protocol (IGMP) Internet Group Management Protocol (IGMP) provides a way for an Internet computer to report its multicast group membership to adjacent routers. Multicasting allows one computer on the Internet to send content to multiple other computers that have identified themselves as interested in receiving the originating computer's content.
Page 232 A unique network identifier. All network devices are required to have their own unique MAC address. The MAC address is on a sticker on your Digi device server. The number is displayed as 12 hexadecimal digits, usually starting with 00:40:9D.
Page 233 A serial port configuration where the port acts as a modem. The Digi device emulates modem responses to a serial device and seamlessly sends and receives data over an Ethernet network instead of a Public Switched Telephone Network (PSTN). The...
Page 234 (rlogin) A remote login to a Digi device’s command-line interface (CLI). rlogin is a Unix command that allows an authorized user to login to other UNIX machines (hosts) on a network and to interact as if the user were physically at the host computer. Once logged in to the host, the user can do anything that the host has given permission for, such as read, edit, or delete files.
Page 235 See serial bridge. Setup Wizard See Digi Device Setup Wizard. Simple Mail Transfer Protocol (SMTP) A TCP/IP protocol used in sending and receiving e-mail. Since it is limited in its ability to queue messages at the receiving end, it is usually used with one of two other protocols, POP3 or IMAP, that let the user save messages in a server mailbox and download them periodically from the server.
Page 236 IP network; manage network performance, find and solve network problems, and plan for network growth. Digi devices support SNMP Version SNMP See Simple Network Management Protocol. SMTP See Simple Mail Transfer Protocol.
Page 237 Transmission Control Protocol (TCP) A set of rules used along with the Internet Protocol (IP) to send data in the form of message units between computers over the Internet. While IP handles the actual delivery of the data, TCP handles keeping track of the individual units of data (called packets) that a message is divided into for efficient routing through the Internet.
Page 238 Transmit eXchange Data. See User Datagram Protocol. Universal Mobile Telecommunications Service (UMTS) A third-generation (3G) broadband, packet-based transmission of text, digitized voice, video, and multimedia at data rates up to 2 megabits per second (Mbps) that offers a consistent set of services to mobile computer and phone users no matter where they are located in the world.
Page 239 In the Open Systems Interconnection (OSI) communication model, UDP, like TCP, is in layer 4, the Transport Layer. web interface The web-based interface for configuring, monitoring, and administering Digi devices. ZigBee A specification for wireless personal area networks (WPANs) operating at 868 MHz, 902-928 MHz, and 2.4 GHz.
Page 240 to 255 devices in a single WPAN. 2 4 0...
Page 241 Access Control Lists (ACL) access permissions for commands Active Opens backup command ADDP backup/restore configurations See Advanced Digi Discovery Protocol from command line address requirements for VPN from web interface administration Bad Datagrams Received from command line Bad Messages Received...
Page 242 See factory defaults from web interface default static IP address for Ethernet port ConnectPort Display Default Time-To-Live hardware installation default username and password for Digi ConnectPort specifications devices ConnectPort WAN VPN deleting files from file system configuring VPN settings destination IP address for SNMP traps...
Page 243 (set ethernet) default IP address for Ethernet port Dynamic DNS (DDNS) Update Settings duplex mode Dynamic Host Configuration Protocol (DHCP) for Digi Connect WAN VPN Address Pool speed as an IP address assignment alternative Evolution-Data Optimized (EV-DO, EVDO, or...
Page 244 General system information page Internet Key Exchange (IKE) Generic Routing Encapsulation (GRE) Internet Protocol (IP) as a supported protocol for forwarding IP protocols supported in Digi devices definition statistics passthrough IOTA (IP-Based Over the Air) Global System for Mobile communication...
Page 245 Encrypted (Secure) RealPort in Digi Device Setup Wizard HyperText Transfer Protocol (HTTP) in web interface HyperText Transfer Protocol over Secure provisioning state Socket Layer (HTTPS) Service Plan...
Page 246 Simple Network Management Protocol changing password for administrative (SNMP) user Telnet configuring Telnet Passthrough default for Digi devices Transmission Control Protocol (TCP) enabling and disabling password Echo authentication Transmission Control Protocol (TCP) for accessing mobile network Passthrough for Dynamic DNS (DDNS) service...
Page 247 Transmission Control Protocol (TCP) displaying current Transport Layer Security (TLS) updating User Datagram Protocol (UDP) power requirements provisioning Digi Connect WAN products automatic from command line See Point to Point Protocol from web interface pre-shared key (PSK) information required from mobile service...
Page 248 I n d e x regulatory information Access Control Lists Remote Login (Rlogin) changing password for root user remote management configuring features and IP Pass-through disabling unused and non-secure network services configuration settings enabling password authentication See also Connectware Manager features overview Remote shell (Rsh) IP filtering...
Page 249 I n d e x stop bits signal strength TCP settings for Digi Cellular Family products UDP settings setting alarms for serial ports Simple Mail Transfer Protocol (SMTP) managing connections serial statistics Simple Network Management Protocol (SN- server-initiated connections session bypasses...
Page 250 TCP Echo network service configuration settings TCP keep-alives configuring TCP Sockets port profile description tcpserial communication statistics Transport Layer Security (TLS) traps (SNMP) supported in Digi devices system connections tunnel system information tunnels System Information page serial tunneling system settings socket tunnel...
Page 251 I n d e x IP address requirements ISAKMP tunnels manual-keyed tunnels purpose settings testing the connection tunnel Tunnel Proposal Configuration vpn command web interface accessing alarm settings application settings applying and saving changes as a device configuration interface canceling changes configuration pages for configuring devices Home page...
Page 252 I n d e x 2 5 2...

This manual is also suitable for:

Connectport x8 Connectport x4

Digi ConnectPort X2 User Manual

Contents

About this Guide

Chapter 1: Introduction

Chapter 2: Configure Digi Devices

Chapter 3: Monitor and Manage Digi Devices

Chapter 4: Administration Tasks

Quick Links

Need help?

Questions and answers

Subscribe to Our Youtube Channel

Related Manuals for Digi ConnectPort X2

Summary of Contents for Digi ConnectPort X2