Digi X2 User manual

ConnectPort™ X Family

User’s Guide

ConnectPort

™

X Family:

ConnectPort X2, ConnectPort X4, ConnectPort X8

90000832_A

e-mail: [email protected]

tel: 08-52 400 700 fax: 08-520 18121

2 

User’s Guide

The Digi logo is a registered trademarks of Digi International, Inc.

Digi Connect, Connectware Manager, ConnectPort, Digi SureLink, are trademarks of Digi

International, Inc.

All other trademarks mentioned in this document are the property of their respective

owners.

Information in this document is subject to change without notice and does not represent a

commitment on the part of Digi International.

Digi provides this document “as is,” without warranty of any kind, either 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.

This product could include technical inaccuracies or typographical errors. Changes are

periodically made to the information herein; these changes may be incorporated in new

editions of the publication.

3

Contents

Contents...........................................................................................................................................................3

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

Network interface features .........................................................................................................29

Configurable network services...................................................................................................29

IP protocol support.....................................................................................................................30

Serial data communication over TCP and UDP...............................................................31

Dynamic Host Configuration Protocol (DHCP) ..............................................................32

Auto-IP.............................................................................................................................32

Simple Network Management Protocol (SNMP).............................................................32

Supported RFCs and MIBs..................................................................................... 32

Supported SNMP traps........................................................................................... 33

Secure Sockets Layer (SSL)/Transport Layer Security (TLS).........................................33

Telnet................................................................................................................................33

Remote Login (rlogin)......................................................................................................33

Line Printer Daemon (LPD).............................................................................................33

Contents

4

HyperText Transfer Protocol (HTTP)

HyperText Transfer Protocol over Secure Socket Layer (HTTPS).................................34

Internet Control Message Protocol (ICMP).....................................................................34

Point-to-Point Protocol (PPP)..........................................................................................34

Network Address Translation (NAT)/Port Forwarding...................................................34

Advanced Digi Discovery Protocol (ADDP)...................................................................34

Generic Routing Encapsulation (GRE) Passthrough

Encapsulating Security Payload (ESP)

ESP Passthrough..............................................................................................................35

Mobile/Cellular features and protocol support ..........................................................................35

Provisioning wizard.........................................................................................................35

Digi SureLink™...............................................................................................................35

Mobile/Cellular protocols................................................................................................36

Global System for Mobile communication (GSM) .........................................................36

Code-Division Multiple Access (CDMA).......................................................................36

General Packet Radio Service (GPRS)............................................................................37

Enhanced Data Rates for GSM Evolution (EDGE).........................................................37

Universal Mobile Telecommunications Service (UMTS)...............................................37

Evolution-Data Optimized (EV-DO, EVDO, or 1xEV-DO)...........................................38

IP address assignment alternatives.............................................................................................39

RealPort software.......................................................................................................................40

Encrypted RealPort..........................................................................................................40

Alarms........................................................................................................................................41

Modem emulation......................................................................................................................41

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

Network/serial clients ......................................................................................................46

Autoconnect behavior client connections .............................................................. 46

5

Contents

Command-line interface (CLI)-based client connections....................................... 46

Modem emulation (pseudo-modem) client connections ........................................ 46

Configuration capabilities and interfaces.............................................................................................47

Configuration capabilities ..........................................................................................................47

Configuration interfaces.............................................................................................................48

The Digi Device Setup wizard.........................................................................................49

Digi Device Discovery utility ..........................................................................................51

The Web interface............................................................................................................53

Command-line interface...................................................................................................55

Connectware Manager interface.......................................................................................56

Simple Network Management Protocol (SNMP).............................................................58

Standard MIBs supported....................................................................................... 59

Digi enterprise MIBs supported ............................................................................. 59

Additional SNMP resources................................................................................... 59

Monitoring capabilities and interfaces .................................................................................................60

Monitoring interfaces.................................................................................................................60

Web Interface...................................................................................................................60

Command-line interface...................................................................................................61

Connectware Manager......................................................................................................61

SNMP...............................................................................................................................61

Administration tasks.............................................................................................................................62

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

IP addresses and Connectware Manager....................................................................................66

Test the IP address configuration...............................................................................................67

Configuration through the web interface.............................................................................................68

Open the web interface...............................................................................................................69

Contents

6

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

The Home page................................................................................................................72

Configuration pages.........................................................................................................72

Application pages ............................................................................................................73

Apply and save changes...................................................................................................73

Cancel changes ................................................................................................................73

Restore the Digi device to factory defaults......................................................................73

Online help.......................................................................................................................73

Change the IP address from the web interface, as needed.........................................................74

Configure network communications..........................................................................................75

Alternatives for configuring network communications...................................................76

IP settings.........................................................................................................................76

DHCP server settings.......................................................................................................77

DHCP terminology................................................................................................. 77

Addresses in the DHCP server settings.................................................................. 79

DHCP server configuration settings....................................................................... 79

Manage the DHCP server....................................................................................... 81

Network services settings ................................................................................................82

Supported network services and their default network port numbers.................... 83

Network services and IP pass-through................................................................... 86

Dynamic DNS update settings.........................................................................................87

Settings................................................................................................................... 87

Status and history information ............................................................................... 89

IP filtering settings...........................................................................................................90

IP forwarding settings......................................................................................................91

Example.................................................................................................................. 92

Socket tunnel settings ......................................................................................................93

IP pass-through settings...................................................................................................94

How IP pass-through works................................................................................... 94

How IP pass-through affects network access to Digi devices................................ 96

7

Contents

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

How VPN tunnels work........................................................................................ 100

IP address requirements for VPN tunnels............................................................. 101

GSM GPRS/EDGE APN type needed.................................................................. 101

CDMA carrier requirements................................................................................. 101

HQ router / VPN appliance configuration............................................................ 101

Using a console port............................................................................................. 102

Configure VPN settings........................................................................................ 102

Manual-keyed IPSEc/ESP VPN tunnel security settings ..................................... 112

ISAKMP VPN tunnel security settings................................................................ 115

VPN tunnel proposal configuration for ISAKMP tunnels.................................... 117

Advanced network settings ............................................................................................118

Configure mobile (cellular) settings.........................................................................................119

Information required from mobile service provider.......................................................119

Different processes used for CDMA and GSM provisioning........................................119

CDMA-based mobile service providers............................................................... 119

GSM-based mobile service providers................................................................... 119

Set mobile configuration settings to factory defaults.....................................................120

Mobile service provider settings....................................................................................120

Provision a mobile device..............................................................................................121

Launch the Mobile Device Provisioning Wizard ................................................. 121

Automatic versus manual provisioning................................................................ 122

Example: provision ConnectPort WAN VPN for Sprint™ PCS.......................... 122

Re-provision a Digi device................................................................................... 124

Mobile connection settings.............................................................................................125

Digi SureLink™ settings................................................................................................125

Hardware reset thresholds .................................................................................... 126

Link integrity monitoring settings........................................................................ 126

Status and statistical information for mobile connections .............................................129

Contents

8

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

About port profiles.........................................................................................................137

Select and configure a port profile.................................................................................137

RealPort profile..............................................................................................................138

Console Management profile.........................................................................................138

TCP Sockets profile.......................................................................................................139

Automatic TCP connections (autoconnection) .................................................... 139

RFC 2217 support ................................................................................................ 139

TCP and UDP network port numbering conventions........................................... 140

UDP Sockets profile ......................................................................................................140

Serial Bridge profile.......................................................................................................141

Local Configuration profile ...........................................................................................141

Modem Emulation profile..............................................................................................141

Custom Profile...............................................................................................................142

Basic serial settings........................................................................................................142

Advanced serial settings ................................................................................................143

Serial Settings....................................................................................................... 143

TCP settings ......................................................................................................... 144

UDP settings......................................................................................................... 146

Configure camera settings........................................................................................................147

Camera settings..............................................................................................................147

Camera operation...........................................................................................................148

Configure alarms......................................................................................................................149

Alarm notification settings.............................................................................................149

Alarm conditions............................................................................................................150

Alarm list.............................................................................................................. 150

Alarm conditions.................................................................................................. 151

9

Contents

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

Last Known Address (LKA)................................................................................. 156

Client initiated management connection settings................................................. 157

Server initiated management connection settings ................................................ 157

Advanced remote management settings.........................................................................158

Alarms and the Connectware Manager server ...............................................................160

For more information on Connectware Manager...........................................................160

Configure Security settings......................................................................................................160

About user models and user permissions.......................................................................161

Password authentication.................................................................................................161

Enable password authentication ........................................................................... 161

Disable password authentication.......................................................................... 162

Change the password for administrative user....................................................... 162

Upload an SSH public key.................................................................................... 163

Disable unused and non-secure network services..........................................................163

Use IP filtering...............................................................................................................163

Configure applications .............................................................................................................164

Python® program management .....................................................................................164

Recommended distribution of Python interpreter ................................................ 164

Additional Python programming resources.......................................................... 164

Python configuration pages.................................................................................. 164

Python files........................................................................................................... 165

Auto-start settings................................................................................................. 165

Manually execute uploaded Python programs...................................................... 165

Configuration through the command line ..........................................................................................166

Access the command line.........................................................................................................166

Contents

10

Verify device support of commands........................................................................................166

Configuration through Simple Network Management Protocol (SNMP) .........................................169

Configuration through Connectware Manager ..................................................................................170

Configuring Mesh Networks and Nodes through Connectware Manager...............................170

ZigBee Networks View .................................................................................................171

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

Serial port diagnostics page.................................................................................. 178

Configuration ....................................................................................................... 179

Signals.................................................................................................................. 179

Serial statistics...................................................................................................... 180

Network statistics...........................................................................................................181

Ethernet Connection Statistics ............................................................................. 181

IP Statistics........................................................................................................... 182

TCP Statistics....................................................................................................... 182

UDP statistics.................................................................................................................183

ICMP statistics...............................................................................................................183

Mobile information and statistics ..................................................................................184

Mobile Connection Statistics ............................................................................... 184

Mobile Statistics................................................................................................... 185

Mobile Information.............................................................................................. 186

SureLink statistics................................................................................................ 187

Diagnostics.....................................................................................................................188

Manage connections and services............................................................................................189

Manage serial ports........................................................................................................189

Manage connections ......................................................................................................189

Manage VPN connections .............................................................................................189

11

Contents

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

Manage Mesh networks .................................................................................................193

Manage Mesh networks from the web interface .................................................. 194

Gateway device details......................................................................................... 195

Network view of the Mesh devices ...................................................................... 195

Python Application ZigBee Socket Counters....................................................... 195

Python Application ZigBee Socket Error Counts................................................. 196

Mesh device state pages ....................................................................................... 197

Monitoring capabilities from the command line................................................................................198

Commands for displaying device information and statistics ...................................................198

display ............................................................................................................................198

info .................................................................................................................................199

set alarm .........................................................................................................................200

set buffer and display buffers.........................................................................................200

set snmp..........................................................................................................................200

show ...............................................................................................................................200

Commands for managing connections and sessions ................................................................201

Commands for managing Mesh networks and nodes...............................................................202

set mesh..........................................................................................................................202

Configure Mesh network settings: command syntax ........................................... 202

Display Mesh network configuration settings: command syntax......................... 203

display mesh...................................................................................................................204

info zigbee_sockets........................................................................................................205

Monitoring capabilities from Connectware Manager ........................................................................206

Monitor/manage Mesh networks from Connectware Manager................................................207

Monitoring Capabilities from SNMP.................................................................................................208

Chapter 4: Administration tasks.............................................................................................................209

Contents

12

Administration from the web interface..............................................................................................210

File management......................................................................................................................211

Uploading Files..............................................................................................................211

Delete files.....................................................................................................................211

Custom files are not deleted by device reset..................................................................211

X.509 Certificate/Key Management........................................................................................212

Backup/restore device configurations......................................................................................213

Update firmware and Boot/POST Code ..................................................................................214

Prerequisites...................................................................................................................214

Update firmware from a file on a PC.............................................................................214

Update Firmware from a TFTP Server..........................................................................214

Restore a device configuration to factory defaults ..................................................................215

Settings cleared and retained during factory reset.........................................................215

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

ConnectPort X8 specifications.................................................................................................220

Regulatory information and certifications .........................................................................................221

Safety standards .......................................................................................................................221

FCC Part 15 Class B ................................................................................................................221

Radio Frequency Interface (RFI) (FCC 15.105)............................................................221

Labeling Requirements (FCC 15.19).............................................................................221

Modifications (FCC 15.21)............................................................................................222

Industry Canada.............................................................................................................222

Declaration of Conformity.............................................................................................222

International EMC Standards.........................................................................................223

Important Safety Information.............................................................................................................224

13

Contents

Glossary.......................................................................................................................................................225

Index ............................................................................................................................................................241

Contents

14

15

About this guide

Purpose

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.

Scope

This guide focuses on configuration, monitoring, and administration of Digi devices. It

does not cover hardware details beyond a certain level, application development, or

customization of Digi devices.

Where to find more information

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

®

Installation Guide

 Cellular 101 Tutorial

 Digi Connect Family Customization and Integration Guide

 Connectware Manager Getting Started Guide and Operator’s Guide

 Release Notes

 Cabling Guides

17

About this guide

Additional product information on www.digi.com

In addition to the previous documents, product information is available on the Digi

website, www.digi.com, including:

 Support Forums

 Knowledge Base

 Data sheets/product briefs

 Application/solution guides

Digi contact information

For more information about Digi products, or for customer service and technical support,

contact Digi International.

To Contact Digi International

by:

Use:

Mail Digi International

11001 Bren Road East

Minnetonka, MN 55343

U.S.A.

World Wide Web: http://www.digi.com/support/

email http://www.digi.com/support/

Telephone (U.S.) (952) 912-3444 or (877) 912-3444

Telephone (other locations) +1 (952) 912-3444 or (877) 912-3444

Digi contact information

18

19

Introduction

CHAPTER 1

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.

ConnectPort X Family products

20

ConnectPort X Family products

The ConnectPort X Family of products is intended to provide gateway functionality

between various network technologies such as Ethernet, cellular, Wi-Fi, and Mesh (IEEE

802.15.4 and ZigBee). In addition to providing IP network connectivity between cellular,

Wi-Fi and Ethernet networks and devices; ConnectPort X Family products are designed to

provide remote connectivity to mesh networks as well as other devices connected to local

ports: 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.

Key features of ConnectPort X Family include:

 Network flexibility: gateway functionality for a variety of networks

 MaxStream XBeePro Radio

 Currently Freescale-based, primarily 802.15.4

 Ember-250/ZigBee-based

 Commercial/Industrial Grade

 Connectware Enterprise Management: High-level and detailed views of Mesh

networks and nodes

 Personal Area Network (PAN) connectivity and management

 Support of Python programming language, for creating a variety of embedded

programs and applications

 Remote help desk support through a WatchPort

®

Camera connection to a USB

host port

 Security

Page is loading ...

Digi X2 User manual

This manual is also suitable for

Digi X2 User manual

Related papers

Other documents