ConnectPort LTS. User Guide

Transcription

1 CnnectPrt LTS User Guide

2 Revisin histry Revisin Date Descriptin C June 2012 Updated the dcument and crrected cntent. D July 2012 Updated the dcument and crrected cntent. E May 2013 Added infrmatin n the banner feature. F December 2016 Updated the branding. Added Ethernet bridging feature. Expanded infrmatin under CnnectPrt LTS web interface. Trademarks and cpyright Digi, Digi Internatinal, and the Digi lg are trademarks r registered trademarks in the United States and ther cuntries wrldwide. All ther trademarks mentined in this dcument are the prperty f their respective wners Digi Internatinal Inc. All rights reserved. Disclaimers Warranty Infrmatin in this dcument is subject t change withut ntice and des nt represent a cmmitment n the part f Digi Internatinal. Digi prvides this dcument as is, withut warranty f any kind, expressed r implied, including, but nt limited t, the implied warranties f fitness r merchantability fr a particular purpse. Digi may make imprvements and/r changes in this manual r in the prduct(s) and/r the prgram(s) described in this manual at any time. T view prduct warranty infrmatin, g t the fllwing website: Send cmments Dcumentatin feedback: T prvide feedback n this dcument, send yur cmments t techcmm@digi.cm. Custmer supprt Digi Technical Supprt: Digi ffers multiple technical supprt plans and service packages t help ur custmers get the mst ut f their Digi prduct. Fr infrmatin n Technical Supprt plans and pricing, cntact us at r visit us at Supprt prtal lgin: Digi CnnectPrt LTS User Guide 2

3 Cntents Abut this guide Imprtant safety infrmatin 9 Where t find infrmatin 9 CnnectPrt LTS features CnnectPrt LTS Family 12 User interfaces 12 Hardware and netwrk interface features 12 Netwrk services 12 IP prtcl supprt 13 Serial data cmmunicatin ver TCP and UDP 13 Dynamic Hst Cnfiguratin Prtcl (DHCP) 14 Aut IP 14 Simple Netwrk Management Prtcl (SNMP) 14 Secure Sckets Layer (SSL)/Transprt Layer Security (TLS) 14 Telnet 14 Remte lgin (rlgin) 15 Line Printer Daemn (LPD) 15 HyperText Transfer Prtcl (HTTP)/HyperText Transfer Prtcl ver Secure Scket Layer (HTTPS) 15 Internet Cntrl Message Prtcl (ICMP) 15 Pint-t-Pint Prtcl (PPP) 15 Advanced Digi Discvery Prtcl (ADDP) 15 Secure Shell (SSH) 16 RealPrt sftware 16 Encrypted RealPrt 16 Alarms 16 Mdem emulatin 17 Ethernet bridging 17 Security features 18 Secure access and authenticatin 18 Encryptin 18 SNMP security 18 Cnfiguratin management 19 Getting started with CnnectPrt LTS Cnfiguring IP addresses 21 Assign an IP address using DHCP 22 Assign an IP address using Aut-IP 22 Assign an IP address frm the cmmand-line interface 22 Assign an IP address frm the web interface 23 Digi CnnectPrt LTS User Guide 3

4 Test the IP address assignment 23 Using the rc.user file 23 Quick reference fr cnfiguring features 24 CnnectPrt LTS netwrk cnnectins and data paths Netwrk services 31 Netwrk services assciated with specific prts 31 Netwrk services assciated with serial prts in general 31 Netwrk services assciated with the cmmand-line interface 32 Netwrk/serial clients 32 Autcnnect behavir client cnnectins 32 Cmmand-line interface (CLI)-based client cnnectins 32 Mdem emulatin (pseud-mdem) client cnnectins 33 CnnectPrt LTS cnfiguratin and administratin Cnfiguratin capabilities 35 CnnectPrt LTS administratin capabilities 35 CnnectPrt LTS cnfiguratin interfaces 35 Digi Device Discvery utility CnnectPrt LTS web interface Sign in t the web interface 39 Use a web brwser t sign in t the web interface 39 Use Digi Device Discvery utility t sign in t the web interface 39 Pwer failure message 40 Hme page 40 Menu 40 Getting Started 40 System Summary 40 Lgut and Lgin 41 Apply and save changes 41 Cancel changes 41 Online help 41 Cnfiguratin 41 Netwrk Cnfiguratin 41 Serial Prts Cnfiguratin 53 Alarms Cnfiguratin 78 System Cnfiguratin 79 Users 83 Peripheral 88 SD Memry 89 USB 89 Mdem 89 LCD 97 XBee 98 Applicatin 105 PPP (Pint-t-Pint Prtcl) 105 Pythn Cnfiguratin 115 RealPrt cnfiguratin 117 Digi CnnectPrt LTS User Guide 4

5 Management 118 Serial Prt Management 118 Prt Cnnectins Management 118 Prt Lgging Management 118 Administratin 119 Certificate Management 119 File Management 120 Backup/Restre 120 Update Firmware 122 Factry Default Settings 123 System Infrmatin 124 Rebt 129 Enable/disable access t netwrk services 129 CnnectPrt LTS cmmand-line interface Access the cmmand-line interface 131 Basics fr using the cmmand-line interface 131 Management 132 backup print 133 clse 133 cnnect 133 display 133 exit and quit 134 inf 134 newpass 135 recnnect 135 rlgin 135 send 135 set alarm 136 set autcnnect 136 set buffer and display buffer 136 set grup 136 set hst 136 set ippl 136 set lcd 136 set mdem 136 set netwrk 136 set nfs 136 set permissins 136 set pmdem 137 set prtauth 137 set ppp 137 set prfiles 137 set pythn 137 set realprt 137 set rtstggle 137 set samba 137 set sdmemry 137 set serial 137 set service 137 set smtp 137 set snmp 137 set scket_tunnel 138 set switches 138 Digi CnnectPrt LTS User Guide 5

6 set sysauth 138 set syslg 138 set system 138 set tcpserial 138 set trace 138 set udpserial 138 set user 138 set web 138 set xbee 138 shw 139 status 139 telnet 139 wh and kill 139 Administratin 140 Simple Netwrk Management Prtcl (SNMP) Abut Simple Netwrk Management Prtcl (SNMP) 142 Management Infrmatin Bases (MIBs) 142 Viewing MIB-II cmpnents 142 SNMP device mnitring capabilities 142 Dwnlad a Digi MIB 143 SNMP cnfiguratin 143 Supprted SNMP traps 143 Supprted RFCs and MIBs 143 CnnectPrt LTS LCD interface Keys 146 Keypad peratins 146 Cnfiguring the CnnectPrt LTS using the LCD interface 146 Change the IP settings 147 Change the hstname 149 Change the DNS cnfiguratin 150 Mnitring the status using the LCD interface 151 Running diagnstics using the LCD interface 151 Miscellaneus functins in the LCD interface 151 Run the Factry Reset 152 LCD settings 152 Change the LCD settings 152 CnnectPrt LTS disaster recvery Restre CnnectPrt LTS t Factry Default Settings 155 CnnectPrt LTS hardware specificatins CnnectPrt LTS regulatry infrmatin and certificatins FCC certificatins and regulatry infrmatin (USA nly) 159 FCC Part 15 Class B 159 Radi Frequency Interface (RFI) (FCC ) 159 Digi CnnectPrt LTS User Guide 6

7 Labeling Requirements FCC (15.19) 159 Industry Canada (IC) certificatins 160 China regulatry infrmatin 160 Safety statements 161 Digi CnnectPrt LTS User Guide 7

8 Abut this guide This guide describes hw t install, prvisin, cnfigure, mnitr, and administer Digi CnnectPrt LTS devices. This guide cvers the fllwing prducts: CnnectPrt LTS 8 and CnnectPrt LTS 8 MEI CnnectPrt LTS 8 W and CnnectPrt LTS 8 MEI W CnnectPrt LTS 16 and CnnectPrt LTS 16 MEI CnnectPrt LTS 16 W and CnnectPrt LTS 16 MEI W CnnectPrt LTS 16 MEI 2AC CnnectPrt LTS 32 and CnnectPrt LTS 32 MEI CnnectPrt LTS 32 W and CnnectPrt LTS 32 MEI W Digi CnnectPrt LTS User Guide 8

9 Abut this guide Imprtant safety infrmatin Imprtant safety infrmatin T avid cntact with electrical current: Never install electrical wiring during an electrical strm. Never install an Ethernet cnnectin in wet lcatins unless that cnnectr is specifically designed fr wet lcatins. Use cautin when installing r mdifying lines. Use a screwdriver and ther tls with insulated handles. Wear safety glasses r gggles. D nt place Ethernet wiring r cnnectins in any cnduit, utlet r junctin bx cntaining electrical wiring. Installatin f inside wire may bring yu clse t electrical wire, cnduit, terminals and ther electrical facilities. Extreme cautin must be used t avid electrical shck frm such facilities. Avid cntact with all such facilities. Ethernet wiring must be at least 6 feet frm bare pwer wiring r lightning rds and assciated wires, and at least 6 inches frm ther wire (antenna wires, drbell wires, wires frm transfrmers t nen signs), steam r ht water pipes, and heating ducts. D nt place an Ethernet cnnectin where it wuld allw a persn t use an Ethernet device while in a bathtub, shwer, swimming pl, r similar hazardus lcatin. Prtectrs and grunding wire placed by the service prvider must nt be cnnected t, remved, r mdified by the custmer. D nt tuch uninsulated Ethernet wiring if lightning is likely. External wiring: Any external cmmunicatins wiring installed needs t be cnstructed t all relevant electrical cdes. In the United States this is the Natinal Electrical Cde Article 800. Cntact a licensed electrician fr details. Where t find infrmatin In additin t this guide, yu can find additinal prduct and feature infrmatin in these dcuments: RealPrt Installatin Guide Digi Device Custmizatin and Integratin Guide The CnnectPrt LTS supprt page prvides ne r mre f the fllwing dcuments: Release Ntes Quick Start Guides Cabling Guides Digi Cnnect Hardware Reference Guides Digi CnnectPrt LTS User Guide 9

10 Abut this guide Where t find infrmatin Fr additinal infrmatin, see the fllwing resurces: Online help and tutrials in the web interface fr the Digi device Digi Pythn Wiki Prduct infrmatin available n the Digi website, and the Digi supprt website, including: Supprt frum Knwledge Base Datasheets/prduct briefs Applicatin/slutin guides Carrier-specific dcuments Digi CnnectPrt LTS User Guide 10

11 CnnectPrt LTS features This sectin prvides an verview f CnnectPrt LTS features. CnnectPrt LTS Family 12 User interfaces 12 Hardware and netwrk interface features 12 Netwrk services 12 IP prtcl supprt 13 Serial data cmmunicatin ver TCP and UDP 13 RealPrt sftware 16 Encrypted RealPrt 16 Alarms 16 Mdem emulatin 17 Ethernet bridging 17 Security features 18 Cnfiguratin management 19 Digi CnnectPrt LTS User Guide 11

12 CnnectPrt LTS features CnnectPrt LTS Family CnnectPrt LTS Family CnnectPrt LTS (Linux Terminal Server) devices prvide serial ver Ethernet cnnectivity fr applicatins. They supprt IPv4 and IPv6 Ethernet prtcls. CnnectPrt LTS MEI is the same size as CnnectPrt LTS (RS-232 nly versin). User interfaces Yu can use the fllwing user interfaces t cnfigure, mnitr, and administer Digi devices: Web-based interface Cmmand-line interface available via lcal serial prt, telnet r SSH Simple Netwrk Management Prtcl (SNMP) LCD panel Fr additinal details n these user interfaces, see CnnectPrt LTS cnfiguratin and administratin. Yu can custmize sme f the user interfaces. Hardware and netwrk interface features Fr detailed hardware specificatins and netwrk interface infrmatin, g t: See als the datasheet fr yur Digi device. Netwrk services Yu can enable r disable access t netwrk services. This means that yu can restrict a device s use f netwrk services t thse strictly needed by the device. T imprve device security, yu can disable nn-secure services. Yu can enable r disable the fllwing netwrk services: Advanced Digi Discvery Prtcl (ADDP) RealPrt Encrypted RealPrt HTTP/HTTPS Line Printer Daemn (LPD) Remte lgin (rlgin) Remte shell (rsh) SNMP Telnet Secure Shell Server (SSH) Yu can enable r disable access t netwrk services frm the Netwrk Services Settings page in the web interface. Fr mre infrmatin, see Basic Netwrk Services Settings. Digi CnnectPrt LTS User Guide 12

13 CnnectPrt LTS features IP prtcl supprt Yu can use the set service cmmand t enable and disable netwrk services frm the cmmand-line interface. See the CnnectPrt LTS Cmmand Reference n digi.cm fr a descriptin f the set service cmmand. IP prtcl supprt All CnnectPrt LTS devices include an n-bard TCP/IP stack with a built-in web server. Supprted prtcls vary by specific prduct and include, unless therwise nted: Transmissin Cntrl Prtcl (TCP) User Datagram Prtcl (UDP) Dynamic Hst Cnfiguratin Prtcl (DHCP) Simple Netwrk Management Prtcl (SNMP) Secure Sckets Layer (SSL)/Transprt Layer Security (TLS) Remte lgin (rlgin) Line Printer Daemn (LPD) HyperText Transfer Prtcl (HTTP)/HyperText Transfer Prtcl ver Secure Scket Layer (HTTPS) Simple Mail Transfer Prtcl (SMTP) Internet Cntrl Message Prtcl (ICMP) Internet Grup Management Prtcl (IGMP) Address Reslutin Prtcl (ARP) Advanced Digi Discvery Prtcl (ADDP) Serial data cmmunicatin ver TCP and UDP CnnectPrt LTS prducts supprt serial data cmmunicatin ver TCP and UDP. The key features include: Serial data cmmunicatin ver TCP can autmatically perfrm the fllwing functins: Establish bi-directinal TCP cnnectins, knwn as autcnnectins, between the serial device and a server r ther netwrk device. Autcnnectins are based n data and/r serial hardware signals. Cntrl frwarding characteristics based n size, time, and pattern. Allw incming raw, telnet, and SSL/TLS (secure-scket) cnnectins. Digi CnnectPrt LTS User Guide 13

14 CnnectPrt LTS features Serial data cmmunicatin ver TCP and UDP Serial data cmmunicatin ver UDP can autmatically perfrm the fllwing functins: Digi Cnnect prducts can autmatically send serial data t ne r mre devices r systems n the netwrk using UDP sckets. Optins fr sending data include whether specific data is n the serial line, a specific time perid has elapsed, r after the specified number f bytes has been received n the serial prt. Cntrl frwarding characteristics based n size, time, and patterns. Supprt incming datagrams frm multiple destinatins. Supprt utging datagrams sent t multiple destinatins. TCP/UDP frwarding characteristics. Extended cmmunicatin cntrl n TCP/UDP data paths. Timeut Hangup User-cnfigurable Scket ID string (text string identifier n autcnnect nly) Dynamic Hst Cnfiguratin Prtcl (DHCP) Yu can use Dynamic Hst Cnfiguratin Prtcl (DHCP) t autmatically assign IP addresses, deliver IP stack cnfiguratin parameters such as the subnet mask and default ruter, and prvide ther cnfiguratin infrmatin. Fr mre details, see Assign an IP address using DHCP. Aut IP The Aut-IP prtcl autmatically assigns an IP address frm a reserved pl f standard Aut-IP addresses t the cmputer n which it is installed. Digi devices autmatically btain their IP addresses frm a DHCP server. If the DHCP server is unavailable r nnexistent, Aut-IP assigns the device an IP address. Fr mre details, see Assign an IP address using Aut-IP. Simple Netwrk Management Prtcl (SNMP) Simple Netwrk Management Prtcl (SNMP) is a prtcl fr managing and mnitring netwrk devices. SNMP architecture enables a netwrk administratr t manage ndes servers, wrkstatins, ruters, switches, hubs, and s n n an IP netwrk; manage netwrk perfrmance, find and slve netwrk prblems, and plan fr netwrk grwth. Fr mre infrmatin n SNMP as a device-management interface, see Simple Netwrk Management Prtcl (SNMP). Secure Sckets Layer (SSL)/Transprt Layer Security (TLS) Secure Sckets Layer (SSL)/Transprt Layer Security (TLS) prvides authenticatin and encryptin fr CnnectPrt LTS prducts. Fr mre infrmatin, see Security features. Telnet CnnectPrt LTS devices supprt the fllwing types f telnet cnnectins: Telnet client Telnet server Digi CnnectPrt LTS User Guide 14

15 CnnectPrt LTS features Serial data cmmunicatin ver TCP and UDP Reverse telnet, ften used fr cnsle management r device management Telnet autcnnect Fr mre infrmatin n these cnnectins, see CnnectPrt LTS netwrk cnnectins and data paths. Yu can enable r disable access t telnet netwrk services. Remte lgin (rlgin) Yu can enable r disable access t rlgin service. When enabled, users can use rlgin t remtely sign in t systems. Line Printer Daemn (LPD) The Line Printer Daemn (LPD) allws netwrk printing ver a serial prt. Each serial prt has a dedicated LPD server that is independently cnfigurable. Yu can enable r disable access t LPD service. HyperText Transfer Prtcl (HTTP)/HyperText Transfer Prtcl ver Secure Scket Layer (HTTPS) Digi prvides web pages that yu can use t cnfigure the CnnectPrt LTS prduct. Yu can secure these web pages by requiring a user lgin. Internet Cntrl Message Prtcl (ICMP) Yu can display ICMP statistics, including the number f: Messages received Bad messages received Destinatin unreachable messages received Pint-t-Pint Prtcl (PPP) The Pint-t-Pint Prtcl (PPP) transprts multi-prtcl packets ver pint-t-pint links. PPP is respnsible fr: Encapsulating the data packet Allwing the server t infrm the dial-up client f its IP address (r client t request the IP address) Authenticating the exchange Negtiating multiple prtcls Reassembling the data packet fr netwrk cmmunicatin Advanced Digi Discvery Prtcl (ADDP) The ADDP runs n any perating system capable f sending multicast IP packets n a netwrk. ADDP allws the system t identify all ADDP-enabled CnnectPrt LTS prducts attached t a netwrk by sending ut a multicast packet. The CnnectPrt LTS prducts respnd t the multicast packet and identify themselves t the client sending the multicast. Digi CnnectPrt LTS User Guide 15

16 CnnectPrt LTS features RealPrt sftware ADDP cmmunicates with the IP stack using UDP. The IP stack can receive multicast packets and transmit datagrams n a netwrk. Yu can enable r disable access t ADDP service, but yu cannt change the netwrk prt number fr ADDP frm its default. Secure Shell (SSH) CnnectPrt LTS prducts supprt Secure Shell (SSH) as a cnnectin methd and the fllwing types f SSH cnnectins: Reverse SSH and SSH Autcnnect. Limited use f SSH via SSH client is available frm the Linux cmmand line/bash shell. Fr mre infrmatin n these cnnectins, see CnnectPrt LTS netwrk cnnectins and data paths. Yu can enable r disable access t Secure Shell netwrk services. RealPrt sftware Digi s RealPrt sftware leverages the TCP/IP netwrk infrastructure t prvide a virtual cnnectin t serial devices. The sftware is installed directly n the server and allws applicatins t talk t devices via a Digi device server r terminal server ver a netwrk. RealPrt sftware is a COM prt redirectr that allws multiple cnnectins t multiple prts ver a single TCP/IP cnnectin. This means RealPrt supprts the maximum number f remte devices. The number is restricted nly by the perating system and server prcessing pwer. Other unique features include full hardware and sftware flw cntrl, as well as tunable latency and thrughput. With these, RealPrt ensures ptimum perfrmance since data transfer is adjusted accrding t specific applicatin requirements. It als prvides cnnectin recvery after a netwrk interruptin RealPrt autmatically recnnects the device t the COM prt withut the applicatin knwing there was a failure. Encrypted RealPrt Alarms CnnectPrt LTS devices als supprt RealPrt sftware with encryptin. Encrypted RealPrt ffers a secure Ethernet cnnectin between the COM r TTY prt and a device server r terminal server. Encryptin prevents internal and external snping f data acrss the netwrk by encapsulating the TCP/IP packets in an SSL cnnectin and encrypting the data using Advanced Encryptin Standard (AES). Digi s RealPrt with encryptin driver has earned Micrsft s Windws Hardware Quality Lab (WHQL) certificatin. Drivers are available fr a wide range f perating systems, including Micrsft Windws and Linux x32 and x64 based perating systems, as well as ther versins f Unix. See the RealPrt Cmpatibility OS List in the Digi Knwledge Base fr a detailed list f supprted perating systems. It is ideal fr financial, retail/pint-f-sale, gvernment, r any applicatin requiring enhanced security t prtect sensitive infrmatin. Yu can cnfigure CnnectPrt LTS prducts t issue alarms, in the frm f messages r SNMP traps, when certain device events ccur, including data patterns detected in the data stream Cnfiguring Digi devices t issue alarms allws yu t knw when events ccur. Fr mre infrmatin n cnfiguring alarms, see Alarms Cnfiguratin. Digi CnnectPrt LTS User Guide 16

17 CnnectPrt LTS features Mdem emulatin Mdem emulatin CnnectPrt LTS devices include a cnfiguratin prfile that allws the device t emulate a mdem. Mdem emulatin sends and receives mdem respnses t a serial device ver TCP/IP (including Ethernet) instead f Public Switched Telephne Netwrk (PSTN). The mdem emulatin prfile allws yu t maintain a current sftware applicatin but using it ver the less expensive Ethernet netwrk. In additin, yu can enable r disable telnet prcessing n the incming and utging mdememulatin cnnectins. Fr infrmatin n the mdem-emulatin cmmands that CnnectPrt LTS prducts supprt, see the CnnectPrt LTS Cmmand Reference. See Select Prt Prfile fr mre infrmatin. Ethernet bridging Yu can use Ethernet bridging t jin multiple Ethernet netwrks tgether s that the jined netwrks appear as ne Ethernet netwrk. Ethernet bridging cmbines an Ethernet interface with ne r mre physical Ethernet interfaces under the umbrella f a single bridge interface. The Ethernet bridge is a sftware switch that can cnnect multiple Ethernet interfaces (physical r virtual) n a single machine while sharing a single IP subnet. Use the script file, brmde (/etc/init.d/brmde), t enable r disable Ethernet bridging. (Ethernet bridging is supprted nly thrugh the cmmand line interface.) T enable Ethernet bridging, run the fllwing cmmand: # service brmde start The IP address f the eth0 interface becmes the cmmn IP address fr the bridging mde interface (br0). After enabling Ethernet bridging, the eth0 and eth1 addresses disappear. There is a delay f a few minutes while the system autmatically changes the physical interface frm the Ethernet 1 prt t Ethernet 2 prt. Nte Enable the eth1 (IP address #2) interface befre starting Ethernet bridging. T disable Ethernet bridging, run the fllwing cmmand: # service brmde stp T custmize Ethernet bridging ptins, mdify /etc/init.d/brmde. See the brctl Linux manpage fr details. T remve bridging messages frm the serial cnsle, run the fllwing cmmand: # brctl setageing br0 0 T autmatically start the Ethernet bridging service at each bt, add the fllwing cmmands t the rc.user file: service brmde start brtcl set ageing br0 0 Fr mre infrmatin n using the rc.user file, see Using the rc.user file and the Digi Knwledgebase. Digi CnnectPrt LTS User Guide 17

18 CnnectPrt LTS features Security features Security features This sectin cvers CnnectPrt LTS security features. Secure access and authenticatin Security features include the fllwing: Prvide custmized permissins cntrls t lcally defined users. The lcal definitins apply irrespective f whether Radius is used fr authenticatin Issue passwrds fr device users Selectively enable/disable netwrk services such as ADDP, RealPrt, Encrypted RealPrt, HTTP/HTTPS, LPD, remte lgin, remte shell, SNMP, telnet, and Secure Shell (SSH) Cntrl access t inbund prts Secure sites fr cnfiguratin: HTML pages fr cnfiguratin have apprpriate security Cntrl user and user grup access permissins. These permissins cntrl user access t varius features and the level f cntrl they have ver them (view settings r change settings) Enable secure remte lgin thrugh Remte Authenticatin Dial-In User Service (RADIUS) and Lightweight Directry Access Prtcl (LDAP) Encryptin Encrypted RealPrt ffers encryptin fr the Ethernet cnnectin between the COM/TTY prt and the CnnectPrt LTS prduct. Encryptin prevents internal and external snping f data acrss the netwrk by encapsulating the TCP/IP packets in an SSL cnnectin and encrypting the data using the Advanced Encryptin Standard (AES) security algrithm. Encryptin methds are as fllws: Strng TLS V1.0/V1.2-based encryptin: DES (58/64-bit) 3DES (168/192-bit) AES (128/156/192/256-bit) SNMP security SNMP security ptins include: Yu can cnfigure SNMP set cmmands t use SNMP read-nly. Digi recmmends changing the public and private cmmunity names t prevent unauthrized access t the Digi device (SNMPv1/v2c). Yu can use SNMPv3 supprt fr enhanced security thrugh SNMP. Digi CnnectPrt LTS User Guide 18

19 CnnectPrt LTS features Cnfiguratin management Cnfiguratin management Once a CnnectPrt LTS device is cnfigured and running, yu may need t peridically perfrm the fllwing cnfiguratin-management tasks: Cpy cnfiguratins t and frm a remte hst Perfrm the fllwing n the Digi device: Update the firmware, reset the factry settings, manage the device files and memry, r rebt Fr mre infrmatin n these cnfiguratin-management tasks, see Administratin. Digi CnnectPrt LTS User Guide 19

20 Getting started with CnnectPrt LTS This sectin walks yu thrugh cnfiguring an IP address and signing in t yur CnnectPrt LTS device. Cnfiguring IP addresses 21 Test the IP address assignment 23 Using the rc.user file 23 Quick reference fr cnfiguring features 24 Digi CnnectPrt LTS User Guide 20

21 Getting started with CnnectPrt LTS Cnfiguring IP addresses Cnfiguring IP addresses The IP address mde determines hw IP addresses are assigned. There are tw mdes fr assigning IP addresses: Dynamic: Allws IP addresses t be autmatically assigned using the Dynamic Hst Cnfiguratin Prtcl (DHCP) and/r Aut Private IP Addressing (APIP r AUTO IP). Static: Requires yu t assign a static IP address using any available cnfiguratin interface. By default, CnnectPrt LTS devices are cnfigured t dynamically assign addresses using DHCP. Even if a DHCP server is available fr dynamically assigning IP addresses, static addresses may wrk better fr yur netwrk cnfiguratin. Once set, static IP addresses d nt change and ther netwrk devices can always find the device by its IP address. With dynamic settings, the DHCP server can change the IP address frequently r infrequently depending n hw yur netwrk administratr has cnfigured the netwrk. When the IP address changes, netwrk devices cnfigured t talk t the CnnectPrt LTS device can n lnger access the device. In this case, yu must lcate the Digi device using the Digi Device Discvery utility and recnfigure the ther netwrk devices that need t cmmunicate with the CnnectPrt LTS device. The fllwing table summarizes methds fr assigning an IP address. Methd Digi Device Discvery Utility LCD panel Dynamic Hst Cnfiguratin Prtcl (DHCP) Aut Private IP Addressing (APIPA) als knwn as Aut-IP Static IP Descriptin Use the Digi Device Discvery utility t search fr and display Digi device, as well as change cnfiguratin settings. See Use Digi Device Discvery utility t sign in t the web interface. Use the LCD panel n CnnectPrt LTS prducts t perfrm basic cnfiguratin tasks, including setting the IP address, as well as mnitring and diagnstics tasks. See CnnectPrt LTS LCD interface. Use DHCP frm the web interface t autmatically assign IP addresses, t deliver IP stack cnfiguratin parameters such as the subnet mask and default ruter, and t prvide ther cnfiguratin infrmatin. All CnnectPrt LTS devices have a DHCP client enabled by default. Cntact yur netwrk administratr t find ut if a DHCP server is available. See Assign an IP address using DHCP. Use APIPA t autmatically assign an IP address t the Digi device frm a reserved pl f standard Aut-IP addresses n a DHCP server. If the DHCP server is unavailable r there is n DHCP server, Aut-IP assigns the device an IP address. If DHCP is enabled r respnds after ADDP is used, bth verride the Aut-IP address previusly assigned. See Assign an IP address using Aut-IP. Manually assign a specific IP address t a device thrugh the Digi Device Discvery Utility, the web interface, LCD, r the cmmand-line interface. Once set, these settings d nt change. The IP address and subnet mask are mandatry. Additinal settings may be needed fr sme functins. Cntact yur netwrk administratr fr the required values. Digi CnnectPrt LTS User Guide 21

22 Getting started with CnnectPrt LTS Cnfiguring IP addresses Methd Access via the cnsle prt Cmmandline interface Descriptin Use the prt, labeled cnsle prt n CnnectPrt LTS device t cnfigure device settings. This prt allws fr a lgin with serial settings f 9600 baud, 8 data bits, and 1 stp bit. The standard serial prts d nt prvide a lgin by default and d nt prvide access t cnfiguratin settings. Only the cnsle prt allws access t cnfiguratin settings. Use the cmmand-line interface t cnfigure device settings. See Assign an IP address frm the cmmand-line interface. Assign an IP address using DHCP Yu can assign an IP address using Dynamic Hst Cnfiguratin Prtcl (DHCP). DHCP is an Internet prtcl fr autmating the cnfiguratin f cmputers that use IP. Yu can use DHCP t autmatically assign IP addresses and deliver IP stack cnfiguratin parameters. The fllwing prcedure assumes that yu cnfigured the Digi device as a DHCP client. The Digi devices discussed in this dcument are cnfigured as a DHCP client by default. T cnfigure an IP address using DHCP: 1. Verify the Digi device is nt pwered n. 2. If desired, set up a permanent entry fr the Digi device n a DHCP server. While this is nt necessary t btain an IP address via DHCP, setting up a permanent entry saves the IP address after the device is rebted. 3. Cnnect the Digi device t the netwrk and pwer it n. DHCP assigns the IP address cnfigured in step 2 autmatically. Assign an IP address using Aut-IP The standard Autmatic Private IP Addressing (APIPA r Aut-IP) prtcl autmatically assigns the IP address frm a grup f reserved IP addresses t the device n which Aut-IP is installed. Use Digi Device Discvery r ADDP t find the Digi device and assign it a new IP address that is cmpatible with yur netwrk. When yu plug in the device, Aut-IP autmatically assigns the IP address. Aut-IP addresses are typically in the x.x address range. See Use Digi Device Discvery utility t sign in t the web interface fr instructins n using Digi Device Discvery. Assign an IP address frm the cmmand-line interface Use the set netwrk cmmand t cnfigure an IP address frm the cmmand line. The set netwrk cmmand includes the fllwing parameters: index=(1-4): The Ethernet interface index number. ip_v4=device ip: The IP address fr the device. gateway_v4=gateway: The netwrk gateway IP v4 address. garp=secnds: The frequency f Gratuitus ARP (GARP) annuncements, in secnds, which are a bradcast annuncement t the netwrk f a device s MAC address and the IP address. submask_v4=device submask: The device subnet mask fr the IP v4 address. mde_v4=(nne static dhcp): The cnfiguratin mde f the IP v4 address. Digi CnnectPrt LTS User Guide 22

23 Getting started with CnnectPrt LTS Test the IP address assignment ip_v6=device ip: The IP v6 address fr the device. gateway_v6=gateway: The IP address fr the IP v6 netwrk gateway. submask_v6=gateway: The device subnet mask fr the IP v6 address. mde+v6=(nne static dhcp): The cnfiguratin mde f the IP v6 address. Fr example: set netwrk index=1 ip_v4= gateway_v4= submask_v4= mde_v4=static Assign an IP address frm the web interface Nrmally, yu assign IP addresses t CnnectPrt LTS devices thrugh DHCP. This prcedure assumes that the CnnectPrt LTS device already has an IP address and yu simply want t change it. T change the IP address frm the web interface: 1. Open a web brwser and type the current IP address f the CnnectPrt LTS device in the address bar. 2. Type the user name and passwrd fr the device. The default user name is rt and the default passwrd is dbps. If these defaults d nt wrk, cntact the system administratr wh set up the device. 3. Click Netwrk t access the Netwrk Cnfiguratin page. 4. On the IP Settings page, select Use the fllwing IP address. 5. Type the IP address, subnet mask, and gateway settings. 6. Click Apply t save the cnfiguratin. Test the IP address assignment T verify the IP address wrks as cnfigured: 1. Access the cmmand line f a cmputer r ther netwrked device. 2. Issue the fllwing cmmand: ping ip-address where ip-address is the IP address assigned t the Digi device. Fr example: ping Using the rc.user file The /usr2/rc.user file is a text file n the CnnectPrt LTS that is accessible by lgging in as the rt user. Yu can mdify the file t autmatically perfrm varius tasks at bt time, such as: Run advanced linux cmmands Initiate custm scripts Lad additinal cnfiguratin infrmatin Digi CnnectPrt LTS User Guide 23

24 Getting started with CnnectPrt LTS Quick reference fr cnfiguring features The Digi Knwledge Base cntains additinal infrmatin n the rc.user file, cmmn examples, and advice n hw t test and implement cmmands using the rc.user file. G t fr details. Quick reference fr cnfiguring features The fllwing table prvides a quick reference fr cnfiguring features and perfrming device tasks. Sme features are cnfigurable frm the cmmand line interface nly. Fr thse features, the cmmands that cnfigure the feature are nted. See the CnnectPrt LTS Cmmand Reference fr descriptins f the cmmands. Feature/task Path t feature in the web interface Administratin/Cnfiguratin management: Certificate Management File management: uplading and dwnlading files, such as applet files, and custm splash screens Pythn prgram file management Backup/restre cnfiguratin settings Update firmware Reset cnfiguratin t factry defaults System infrmatin, including device identifiers and statistics Rebt the device Alarms Administratin > Certificate Management Administratin > File Management See als the Digi Device Custmizatin and Integratin Guide fr infrmatin n uplading and dwnlading files used t custmize the prduct. Administratin > File Management Administratin > Backup/Restre Administratin > Update Firmware Administratin > Factry Default Settings Administratin > System Infrmatin Administratin > Rebt Cnfiguratin > Alarms Cnnectin management: Manage serial prt cnnectins Manage active PPP cnnectins Manage active system cnnectins Dmain Name System (DNS) Client Management > Serial Prts Management > Cnnectins > Active PPP Cnnectins Management > Cnnectins > Active System Cnnectins Cnfiguratin > Netwrk > DNS > Primary DNS and Secndary DNS Digi CnnectPrt LTS User Guide 24

25 Getting started with CnnectPrt LTS Quick reference fr cnfiguring features Feature/task Ethernet settings Help n cnfiguring features Hst name fr a device Path t feature in the web interface Cnfiguratin > Netwrk > Advanced Netwrk Settings Help buttn n each page. Cnfiguratin > Netwrk > Advanced Netwrk Settings > Hst Name IP address settings: Using static IP addresses Using DHCP IPv6 Settings Surce Based Ruting Netwrk Bnding Using Aut IP Cnfiguratin > Netwrk > IP Settings Cnfiguratin > Netwrk > IP Settings Cnfiguratin > Netwrk > IP Settings Cnfiguratin > Netwrk > IP Settings Cnfiguratin > Netwrk > IP Settings Cnfiguratin > Netwrk > Advanced Settings Advanced netwrk services settings: Web settings SMTP settings NFS settings Samba settings Syslg settings Multiple Electrical Interface (MEI) Cnfiguratin > Netwrk > Netwrk Services Settings > Advanced Netwrk Service Settings Cnfiguratin > Netwrk > Netwrk Services Settings > Advanced Netwrk Service Settings Cnfiguratin > Netwrk > Netwrk Services Settings > Advanced Netwrk Service Settings Cnfiguratin > Netwrk > Netwrk Services Settings > Advanced Netwrk Service Settings Cnfiguratin > Netwrk > Netwrk Services Settings > Advanced Netwrk Service Settings 1. Select Cnfiguratin > Serial Prts >. 2. Click a prt number frm the Prt clumn. 3. Click Basic Serial Settings. 4. Cmplete the fields and click Apply. Digi CnnectPrt LTS User Guide 25

26 Getting started with CnnectPrt LTS Quick reference fr cnfiguring features Feature/task Prt lgging: enabling prt buffering and displaying cntents f a prt buffer Prt prfiles: sets f precnfigured serial-prt settings fr a particular cnnectin and use scenari Path t feature in the web interface T enable prt lgging: 1. Select Cnfiguratin > Serial Prts. 2. Click a prt number frm the Prt clumn. 3. Click Advanced Serial Settings. 4. Select Enable Prt Lgging and cmplete the fields. 5. Click Apply. T display the cntents f a prt buffer, select Management > Serial Prts > Cnnectins. 1. Select Cnfiguratin > Serial Prts. 2. Click a prt number frm the Prt clumn. 3. Click Change Prfile. 4. Select ne f the fllwing prfile ptins and click Apply: RealPrt Cnfigure the COM prt redirectin. See als the RealPrt Installatin Guide. Cnsle Management TCP Sckets The TCP server listens fr TCP cnnectins n the serial prt r the TCP client t autmatically establish a cnnectin t a defined netwrk prt. See Autmatic TCP cnnectins (Autmatic Cnnectin). UDP Sckets Serial Bridge Mdem Mdem Emulatin Printer Lcal Cnfiguratin Custm 5. Cmplete the fields and click Apply. Ethernet bridging Ethernet bridging cnfiguratin is available nly thrugh the cmmand line interface. T enable Ethernet bridging, first enable the eth1 interface (IP address #2). Then cnnect t the CnnectPrt LTS via serial prt, ssh, r telnet and run the fllwing cmmand: # service brmde start See Ethernet bridging fr mre infrmatin. Digi CnnectPrt LTS User Guide 26

27 Getting started with CnnectPrt LTS Quick reference fr cnfiguring features Feature/task Pythn supprt: lading and running custm prgrams authred in the Pythn prgramming language. RealPrt (COM prt redirectin) cnfiguratin Reverting cnfiguratin settings Path t feature in the web interface Cnfigurable frm cmmand line nly. See the set pythn cmmand in the CnnectPrt LTS Cmmand Reference. Cnfiguratin > Serial Prts > prt > Prt Prfile Settings > RealPrt 1. Select Cnfiguratin > Serial Prts. 2. Click a prt number frm the Prt clumn. 3. Click Change Prfile. 4. Select RealPrt and click Apply. 5. Cmplete the fields and click Apply. See als the RealPrt Installatin Guide. Administratin > Factry Default Settings Security/access cntrl features: Cntrl access t TCP/UDP inbund prts 1. Select Cnfiguratin > Serial Prts. 2. Click a prt number frm the Prt clumn. 3. Click Change Prfile. 4. Select TCP Sckets, UDP Sckets, r Custm, and click Apply. Nte When yu cnfigure a TCP/UDP server, the cnfiguratin nly applies t inbund sckets. Yu cnfigure the utbund sckets when yu cnfigure the TCP/UDP client. 5. Cmplete the fields and click Apply. Secure Shell Server (SSH) Add r mdify a user's sign in credentials Cnfiguratin > Netwrk > Netwrk Service Settings > Basic Netwrk Services Settings > Enable Secure Shell Server (SSH) 1. Select Cnfiguratin > Users. 2. Select a user r click New user and cmplete the fields. 3. Click User Access and cmplete select the access ptins fr the user. 4. Click User Permissins and select the user permissins fr the user. 5. Click Grup Cnfiguratin and assciate a grup with a user. 6. Click Uplad SSH Public key and enable r disable SSH Public Key Authenticatin. Digi CnnectPrt LTS User Guide 27

28 Getting started with CnnectPrt LTS Quick reference fr cnfiguring features Feature/task Set authenticatin methd fr prt access Path t feature in the web interface 1. Select Cnfiguratin > Serial Prts. 2. Select prt number under the Prt clumn. 3. Click Authenticatin Settings. Serial prt cnfiguratin: Basic serial prt settings Advanced serial prt settings Prt prfiles: assciate a serial prt with a set f precnfigured prt settings fr a specific use RTS Tggle Prt Sharing: allw a serial prt t be shared by multiple sftware applicatins. Supprts up t fur sessins per prt. Only ne sessin can be RealPrt Cnfiguratin > Serial Prts > Basic Serial Settings Cnfiguratin > Serial Prts > Advanced Serial Settings Cnfiguratin > Serial Prts > Prt Prfile Settings Cnfiguratin > Serial Prts > Advanced Serial Settings 1. Select Cnfiguratin > Serial Prts. 2. Click a prt number frm the Prt clumn. 3. Click Change Prfile. 4. Select TCP Sckets, UDP Sckets, r Custm and click Apply: 5. Cmplete the fields under TCP Server Settings, UDP Server Settings, r Netwrk Services and click Apply. SNMP: Cnfigure SNMP thrugh the web interface Enable/disable SNMP service Enable/disable SNMP alarm traps Use SNMP as primary cnfiguratin interface System infrmatin: assign systemidentifying infrmatin t a device Authenticatin cnfiguratin fr Web and CLI access Statistics Cnfiguratin > System > Simple Netwrk Management Prtcl (SNMP) Settings Cnfiguratin > Netwrk > Netwrk Service Settings > Basic Netwrk Services Settings Cnfiguratin > Alarms > alarm > Send SNMP trap t fllwing destinatin when alarm ccurs Basic netwrk and serial settings cnfigurable thrugh standard and Digi-specific Management Infrmatin Blcks (MIBs). Yu can als cnfigure advanced settings thrugh SNMP. Cnfiguratin > System > Device Identity Settings Cnfiguratin > System > Authenticatin Settings Administratin > System Infrmatin Digi CnnectPrt LTS User Guide 28

29 Getting started with CnnectPrt LTS Quick reference fr cnfiguring features Feature/task Status infrmatin Path t feature in the web interface Management > Serial Prts, Cnnectins, Netwrk Services Peripheral settings: SD Memry USB Mdem LCD XBee Peripheral > SD Memry Peripheral > USB Peripheral > Mdem Peripheral > LCD Peripheral > XBee Applicatin settings: PPP Pythn RealPrt Applicatin > PPP Applicatin > Pythn Applicatin > RealPrt Digi CnnectPrt LTS User Guide 29

30 CnnectPrt LTS netwrk cnnectins and data paths CnnectPrt LTS devices allw fr several kinds f cnnectins and paths fr data flw between CnnectPrt LTS devices and ther entities. Yu can grup these cnnectins int tw main categries: Netwrk services, in which a remte entity initiates a cnnectin t a Digi device. Netwrk/serial clients, in which a Digi device initiates a netwrk cnnectin r pens a serial prt fr cmmunicatin. The fllwing tpics describe the effects f enabling features and selecting settings when cnfiguring CnnectPrt LTS devices. Netwrk services 31 Netwrk/serial clients 32 Digi CnnectPrt LTS User Guide 30

31 CnnectPrt LTS netwrk cnnectins and data paths Netwrk services Netwrk services A netwrk service cnnectin ccurs when a remte entity initiates a cnnectin t a Digi device. There are several categries f netwrk services: Netwrk services assciated with specific prts Netwrk services assciated with serial prts in general Netwrk services assciated with the cmmand-line interface Netwrk services assciated with specific prts The fllwing list details netwrk services assciated with specific prts. Reverse telnet: A remte entity establishes a telnet cnnectin t a Digi serial prt. Data passes transparently between the telnet cnnectin and a named serial prt. Reverse raw scket: A remte entity establishes a raw TCP scket cnnectin t a Digi serial prt. Data passes transparently between the scket and a named serial prt. Reverse TLS scket: A remte entity establishes an encrypted raw TCP scket cnnectin t a Digi serial prt. Data passes transparently t and frm a named serial prt. LPD: A remte entity establishes a TCP cnnectin t a named serial prt. The Digi device interprets the LPD prtcl and sends a print jb ut f the serial prt. Mdem emulatin, als knwn as pseud-mdem (pmdem): A remte entity establishes a TCP cnnectin t a named serial prt. This cnnectin is interpreted as an incming call t the pseud-mdem. Cnsle Mgmt: Allws a TCP cnnectin t a serially-attached cnsle. Mdem: The Mdem Prfile allws yu t attach mdem devices t the serial prt t establish r receive cnnectins frm ther systems and mdems. Bth the mdem dial-in and bidirectinal ptins prvide a lgin frm the Digi device. Reverse SSH: A remte entity establishes an SSH cnnectin t a CnnectPrt LTS serial prt and data passes transparently between the SSH cnnectin and a named serial prt. Netwrk services assciated with serial prts in general The fllwing list details netwrk services assciated with serial prts in general. RealPrt: A single TCP cnnectin manages (ptentially) multiple serial prts. Mdem emulatin, als knwn as pseud-mdem (pl): A TCP cnnectin t the pl prt is interpreted as an incming call t an available pseud-mdem in the pl f available prt numbers. Digi CnnectPrt LTS User Guide 31

32 CnnectPrt LTS netwrk cnnectins and data paths Netwrk/serial clients rsh: CnnectPrt LTS prducts supprt a limited implementatin f the remte shell (rsh) prtcl, in that a single service listens t cnnectins and allws a cmmand t be executed. Only ne class f cmmands is allwed: a single integer that specifies which serial prt t cnnect t. Otherwise, the resulting cnnectin is smewhat similar t a reverse telnet r reverse scket cnnectin. Netwrk services assciated with the cmmand-line interface The fllwing list details netwrk services assciated with the cmmand line interface (CLI). SSH: Use Secure Shell (SSH) t directly access a CnnectPrt LTS cmmand-line interface. Telnet: Use telnet t directly access a CnnectPrt LTS cmmand-line interface. Rlgin: Perfrm a remte lgin (rlgin) t a CnnectPrt LTS cmmand-line interface. Netwrk/serial clients A netwrk/serial client cnnectin ccurs when a CnnectPrt LTS prduct initiates a netwrk cnnectin r pens a serial prt fr cmmunicatin. There are several categries f netwrk/serial client cnnectins: Autcnnect behavir client cnnectins Cmmand-line interface (CLI)-based client cnnectins Mdem emulatin (pseud-mdem) client cnnectins Autcnnect behavir client cnnectins In client cnnectins that invlve autcnnect behavirs, a CnnectPrt LTS prduct initiates a netwrk cnnectin based n timing, serial activity, r serial mdem signals. Autcnnect-related client cnnectins include: Raw TCP cnnectin: The CnnectPrt LTS initiates a raw TCP scket cnnectin t a remte entity. Telnet cnnectin: The CnnectPrt LTS initiates a TCP cnnectin using the telnet prtcl t a remte entity. SSH cnnectin: The CnnectPrt LTS initiates a TCP cnnectin using the SSH prtcl t a remte entity. Raw TLS encrypted cnnectin: The CnnectPrt LTS initiates an encrypted raw TCP scket cnnectin t a remte entity. Rlgin cnnectin: The CnnectPrt LTS initiates a TCP cnnectin using the rlgin prtcl t a remte entity. Cmmand-line interface (CLI)-based client cnnectins CLI-based client cnnectins are available fr use when yu establish a sessin with the CnnectPrt LTS prduct s CLI. CLI-based client cnnectins include: ssh: Allws yu t cnnect t a remte entity using the ssh prtcl. telnet: Allws yu t cnnect t a remte entity using the telnet prtcl. Digi CnnectPrt LTS User Guide 32

33 CnnectPrt LTS netwrk cnnectins and data paths Netwrk/serial clients rlgin: Allws yu t cnnect t remte entity using the rlgin prtcl (bash nly). scp: Allws yu t transfer files (bash nly). cnnect: Begin cmmunicating with a lcal serial prt. Nte Additinal cmmunicatin methds include using a bash shell such as scp, tftp, nc, r using Pythn. Mdem emulatin (pseud-mdem) client cnnectins When a prt is in the mdem-emulatin r pseud-mdem mde, it can initiate netwrk cnnectins based n AT cmmand strings received n the serial prt. See the CnnectPrt LTS Cmmand Reference n digi.cm fr mdem emulatin AT cmmands. Digi CnnectPrt LTS User Guide 33

34 CnnectPrt LTS cnfiguratin and administratin This sectin prvides infrmatin n cnfiguratin capabilities and interfaces. Cnfiguratin capabilities 35 CnnectPrt LTS administratin capabilities 35 CnnectPrt LTS cnfiguratin interfaces 35 Digi CnnectPrt LTS User Guide 34

35 CnnectPrt LTS cnfiguratin and administratin Cnfiguratin capabilities Cnfiguratin capabilities Cnfiguratin ptins prvide settings fr the fllwing features: Netwrk Cnfiguratin: Specifies IP address settings, netwrk service settings, and advanced netwrk settings. Serial Prts Cnfiguratin: Specifies serial prt characteristics fr the device. Alarms: Defines cnditins that trigger alarms and ntificatins fr alarms. System Cnfiguratin: Prvides system-identifying infrmatin, such as a device descriptin, device lcatin, and cntact infrmatin. Users: Cnfigures security features, such as enabling passwrd authenticatin fr device users. CnnectPrt LTS administratin capabilities Administrative capabilities include the fllwing: Uplading and managing files Changing the passwrd fr lgging nt the device Backing up and restring the cnfiguratin Updating firmware Restring the cnfiguratin t factry defaults Rebting the mdule Yu can perfrm administratin tasks using a number f interfaces, including the CnnectPrt LTS web interface and cmmand line. See Administratin fr mre infrmatin and prcedures. CnnectPrt LTS cnfiguratin interfaces The fllwing table lists and briefly describes CnnectPrt LTS cnfiguratin interfaces. Cnfiguratin interface Digi Device Discvery Utility CnnectPrt LTS web interface Descriptin Allws yu t discver devices, pen the web interface fr a device, cnfigure netwrk settings, and rebt the device. See Digi Device Discvery utility. Allws yu t cnfigure and mnitr CnnectPrt LTS devices. See CnnectPrt LTS web interface. Nte Nt all cnfiguratin ptins prvided by the cmmand-line interface (CLI) appears in the web interface. If yu need t cnfigure mre advanced ptins, see the Access the cmmand-line interface fr instructins n accessing the CLI. Digi CnnectPrt LTS User Guide 35

36 CnnectPrt LTS cnfiguratin and administratin CnnectPrt LTS cnfiguratin interfaces Cnfiguratin interface CnnectPrt LTS cmmand line interface Simple Netwrk Management Prtcl (SNMP) CnnectPrt LTS LCD panel Descriptin Allws yu t cnfigure CnnectPrt LTS by issuing cmmands frm the cmmand line. See CnnectPrt LTS cmmand-line interface. Allws yu t manage and mnitr netwrk devices. See Simple Netwrk Management Prtcl (SNMP). Allws yu t cnfigure, mnitr status, and diagnse CnnectPrt LTS issues. See CnnectPrt LTS LCD interface. Digi CnnectPrt LTS User Guide 36

37 Digi Device Discvery utility The Digi Device Discvery utility: Lcates Digi devices n a netwrk Allws yu t pen the web interface fr discvered devices Allws yu t cnfigure netwrk settings and rebt the device Dwnlad the Digi Device Discvery utility frm In additin t quickly lcating devices, the utility als lists device infrmatin, such as the device address, firmware versin, and whether it has been cnfigured. It runs n any perating system that can send multicast IP packets t a netwrk. It sends ut a User Datagram Prtcl (UDP) multicast packet t all Digi devices n the netwrk. Digi devices that supprt ADDP reply t the UDP multicast with their cnfiguratin infrmatin. Even Digi devices that d nt yet have an assigned IP address r are miscnfigured fr the subnet can reply t the UDP multicast packet and appear in the device discvery results. Nte Persnal firewalls, Virtual Private Netwrk (VPN) sftware, and certain netwrk equipment can blck device discvery. Firewalls blck UDP prts 2362 and 2363 that ADDP uses t discver devices. Yu can enable r disable access t the ADDP service, but yu cannt change the netwrk prt number fr ADDP. See Use Digi Device Discvery utility t sign in t the web interface fr instructins n using the utility t sign in t the CnnectPrt LTS web interface. Digi CnnectPrt LTS User Guide 37

38 CnnectPrt LTS web interface This sectin describes hw t cnfigure and manage a CnnectPrt LTS device using the web interface. Sign in t the web interface 39 Hme page 40 Apply and save changes 41 Cancel changes 41 Online help 41 Cnfiguratin 41 Peripheral 88 Applicatin 105 Management 118 Administratin 119 Digi CnnectPrt LTS User Guide 38

39 CnnectPrt LTS web interface Sign in t the web interface Sign in t the web interface After yu successfully assign an IP address t yur device, yu can sign in t the device's web interface using either f the fllwing: Web brwser Digi Device Discvery utility Use a web brwser t sign in t the web interface T access the web interface fr a Digi device using a brwser: 1. In the web brwser address bar, type the IP address f the device. 2. If yu are prmpted fr lgin credentials, type the user name and passwrd fr the Digi device. The default user name is rt and the default passwrd is dbps. If the default user name and passwrd d nt wrk, cntact the system administratr wh set up the Digi device. The Hme page appears. See Hme page fr an verview f the Hme page and ther linked pages. Nte If passwrd authenticatin is enabled, the idle timeut autmatically lgs users ut f the web interface after 5 minutes f inactivity. Use Digi Device Discvery utility t sign in t the web interface T discver the Digi device and pen the web interface: 1. Dwnlad and install the Digi Device Discvery utility frm the Digi Supprt website. a. Frm a brwser, g t b. Select Supprt > Prduct Supprt. c. Click Diagnstics, Utilities & MIBs. d. Enter a keywrd r select yur Digi device frm the prduct list. e. Under Operating System Specific Utilities, chse an perating system. f. Under Utilities r Operating System Specific Diagnstics, Utilities and MIBs, select either Device Discvery Utility fr Windws - Standalne versin r Device Discvery Utility fr Windws - Installable versin. The standalne versin runs the utility immediately after the dwnlad is cmplete. The installable versin installs the utility n yur cmputer and adds it t a prgram grup in the Start menu named Digi > Digi Device Discvery. g. Click Run n the tw dialgs. The standalne versin f the utility starts immediately. Fr the installable versin, an installatin wizard appears. Fllw the prmpts t cmplete the installatin. T start the utility, select Start > All Prgrams > Digi > Digi Device Discvery > Digi Device Discvery. Digi CnnectPrt LTS User Guide 39

40 CnnectPrt LTS web interface Hme page 2. Frm the Digi Device Discvery utility, lcate the Digi device in the list f devices, and chse ne f the fllwing ptins: Duble-click the Digi device t pen the web interface Select the Digi device frm the list and select Open web interface in the Device Tasks list 3. If yu are prmpted fr lgin credentials, type the user name and passwrd fr the Digi device. The default user name is rt and the default passwrd is dbps. If the default user name and passwrd d nt wrk, cntact the system administratr wh set up the Digi device. Pwer failure message If either f the tw pwer cnnectins t the CnnectPrt LTS 16 2AC fails, a pwer failure message is displayed at the tp f the page. Fr example, if the first pwer cnnectin fails, the fllwing message is displayed: Pwer 1 Failure Hme page When yu access the web interface, the Hme page appears. The Hme page prvides a tutrial and a system summary. Menu The left side f the web interface displays a menu. Use the menu t: Cnfigure the Digi device, peripheral devices, and applicatins Manage serial prts and cnnectins Administer the Digi device Getting Started The Getting Started sectin displays a link t a tutrial n cnfiguring and managing Digi devices. System Summary The System Summary page displays the details fr this CnnectPrt LTS. Mdel: The mdel type fr this CnnectPrt LTS prduct. IPv6 Address (Link): The IPv6 address (link) assciated with this Digi device. IPv6 Address (Glbal): The IPv6 address (glbal) assciated with this Digi device. IPv4 Address: The IPv4 address assciated with this Digi device. MAC Address: The MAC address assciated with this Digi device. Descriptin: A descriptin f this Digi device. Cntact: Cntact infrmatin fr the Digi device. Lcatin: The lcatin f this Digi device. Digi CnnectPrt LTS User Guide 40

41 CnnectPrt LTS web interface Apply and save changes Device ID: The serial number assciated with this Digi device. The serial number appears n a label n the Digi device. Lgut and Lgin T sign ut f a cnfiguratin and management sessin: 1. Click Lgut. The Lgin page appears. 2. Clse the brwser windw t prevent access by ther users. Nte After 5 minutes f inactivity, the idle timeut autmatically perfrms a user lgut. T sign in t the device: Enter yur user credentials n the Lgin page and click Lgin. Apply and save changes The web interface runs lcally n the Digi device, which means that the interface always maintains and displays the current settings in the Digi device. When yu change the cnfiguratin settings, click Apply t save yur changes t the Digi device. Cancel changes T cancel changes t cnfiguratin settings, click the Refresh r Relad buttn n the web brwser. The brwser relads the page. Any changes made since the last time yu clicked Apply are reset t their riginal values. Online help The web interface prvides nline help fr all pages. The Hme page prvides a tutrial. Cnfiguratin Use the ptins under Cnfiguratin t cnfigure settings fr varius features, such as netwrk settings and serial prt settings. Netwrk Cnfiguratin The Netwrk Cnfiguratin page includes: IP settings: Fr viewing IP address settings and changing as needed. See IP Settings fr mre infrmatin. Netwrk Services settings: Cnfigure access t varius netwrk services, such as ADDP, RealPrt and Encrypted RealPrt, telnet, SSH, HTTP/HTTPS, and ther services. See Basic Netwrk Services Settings fr mre infrmatin. Scket Tunnel settings: Cnfigure a scket tunnel used t cnnect tw netwrk devices: ne n the CnnectPrt LTS device s lcal netwrk and the ther n the remte netwrk. See Scket Tunnel Settings fr mre infrmatin. Digi CnnectPrt LTS User Guide 41

42 CnnectPrt LTS web interface Cnfiguratin Advanced Netwrk Settings: Cnfigure the Ethernet Interface speed and mde, IP settings, TCP keepalive settings, and DHCP settings. See Advanced Netwrk Settings fr mre infrmatin. IP Filtering Settings: Cnfigure the built-in firewall functinality t limit IP traffic t and frm IP Settings certain netwrks, TCP r UDP prts, and interfaces. This feature is based n Linux tl iptables. See IP Filtering Settings fr mre infrmatin. The IP Settings page allws yu t cnfigure hw t btain the IP address f the CnnectPrt LTS device. Yu can use ne f the fllwing methds t btain the IP address: DHCP Static IP address Subnet mask Default gateway Nte Changes t DHCP, IP address, subnet mask, and DNS may effect yur brwser cnnectin. In additin, this page displays the IP addresses f the primary and secndary Dmain Name System (DNS) server fr the CnnectPrt LTS device. Fr mre infrmatin n hw t assign and use these settings in yur rganizatin, cntact yur netwrk administratr. CnnectPrt LTS has tw Ethernet interfaces and yu can enable r disable each interface separately. Each interface has fllwing settings: IPv4: Internet Prtcl versin 4 cnfiguratin. D nt use this interface: Chse this ptin if yu d nt want t enable IPv4 address n this Ethernet interface. Obtain an IP address autmatically using DHCP: Chse this ptin if yu want t btain new netwrk settings after yu rebt the CnnectPrt LTS device. Use the fllwing IP address: Chse this ptin t supply a static IP address. Yu must prvide the IP address and subnet mask. Other items are nt mandatry, but may be needed fr sme functins (such as talking t ther netwrks). IP Address: The IP address fr the CnnectPrt LTS device. The IP address is a 4-part id assigned t netwrk devices. IP addresses are in the frm f , where each number is between 0 and 255. Subnet Mask: The subnet mask fr the CnnectPrt LTS device. A cmmn subnet mask is Gateway: The IP address f the cmputer that enables the CnnectPrt LTS device t access ther netwrks, such as the Internet. Digi CnnectPrt LTS User Guide 42

43 CnnectPrt LTS web interface Cnfiguratin IPv6: Internet Prtcl versin 6 cnfiguratin. D nt use this interface: Chse this ptin if yu d nt want t enable IPv6 address n this Ethernet interface. Aut cnfiguratin: Chse this ptin if yu want t set IPv6 address thrugh the stateless autcnfiguratin prtcl. Obtain an IP address autmatically using DHCP: Chse this ptin if yu want t set IPv6 address thrugh DHCPv6. Use the fllwing IP address: Chse this ptin t supply a static IPv6 address. IP address: The IPv6 address fr the CnnectPrt LTS device. The IPv6 addresses are nrmally written as eight grups f fur hexadecimal digits, where each grup is separated by a cln (:). Fr example, IPv6 addresses are in the frm f 2001:0db8:85a3:0000:0000:8a2e:0370:7334 And yu must enter an IPv6 address with an IPv6 prefix length f the netwrk. IPv6 netwrk is written in CIDR ntatin which is separated by a slash "/" t IPv6 address. Fr example, an IPv6 address cnnected t a /64 subnet is written 2001:0db8:85a3:0000:0000:8a2e:0370:7334/64. Gateway: The IPv6 address f the cmputer that enables this CnnectPrt LTS device t access ther netwrks, such as the Internet. Use 6t4 tunneling: Chse this ptin t supply 6t4 Tunneling which cnsists f encapsulating IPv6 packets within IPv4; in effect using IPv4 as a link layer fr IPv6 s that the CnnectPrt LTS device can reach the remte IPv6 Internet thrugh the existing IPv4 infrastructure. IPv4 address f the remte 6t4 relay: Set the IPv4 address f the remte 6t4 relay server. Overwrite lcal IPv4 address: Set the public IPv4 address that yu want t use fr 6t4 tunneling. This is the public IPv4 address. If it is nt set, the current IPv4 address f CnnectPrt LTS will be used. DNS: Set the IP address f the Dmain Name Server (DNS) used t reslve cmputer hst names t IP addresses. The DNS servers are specified independently f any netwrk interface and its cnnectin state. An IP address f indicates n server is specified. Use Manual DNS: Chse this ptin if yu want t set DNS cnfiguratin manually. Primary DNS: Set the IP address f primary DNS. Secndary DNS: Set the IP address f secndary DNS. Digi CnnectPrt LTS User Guide 43

44 CnnectPrt LTS web interface Cnfiguratin Surce Based Ruting: Chse this ptin t if yu have tw ruters (gateways) in yur netwrk and yu want each interface t use a different ruter. Fr example, if yu enable this ptin, any traffic that riginates frm the IP address f Ethernet interface 2 (replies t traffic that came in Ethernet interface 2), will be ruted back ut thrugh the same Ethernet interface 2. Please nte that this ptin applies nly t Ethernet interface 1 and 2 by default. Enable Lcal Ruting: Select this ptin t enable lcal ruting. Netwrk Bnding: Use the link aggregatin feature t aggregate ne r mre Ethernet interfaces t frm a lgical pint-t-pint link, knwn as a LAG (link aggregatin grups), virtual link, r bundle. The MAC client can treat this virtual link like a single link. Netwrk Bnding implements 802.3ad. D nt use this interface: Chse this ptin if yu d nt want t enable netwrk bnding n this Ethernet interface. Obtain an IP address autmatically using DHCP: Chse this ptin if yu want t btain new netwrk settings after yu rebt the CnnectPrt LTS device. Use the fllwing IP address: Chse this ptin t manually enter static IP address settings. Subnet Mask: The subnet mask fr the CnnectPrt LTS device. A cmmn subnet mask is Gateway: The IP address f the cmputer that enables the CnnectPrt LTS device t access ther netwrks, such as the Internet. Basic Netwrk Services Settings The Basic Netwrk Services Settings page shws a set f cmmn netwrk services that are available fr CnnectPrt LTS prducts, and the netwrk prt n which the service is running. Yu can enable and disable cmmn netwrk services and cnfigure the TCP/UDP prt n which the netwrk service listens. Yu can disable services as needed fr security purpses. That is, yu can disable certain services s the device runs nly thse services specifically needed. T imprve device security, yu can disable nn-secure services such as telnet. Best practice Use the default netwrk prt numbers fr basic netwrk services because the prt numbers are used by mst applicatins. CAUTION! Exercise cautin when enabling and disabling netwrk services, particularly disabling them. Changing certain settings can render a Digi Cnnect device inaccessible. Fr example, disabling Advanced Digi Discvery Prtcl (ADDP) prevents a netwrk frm discvering the device, even if it is actually cnnected. Disabling HTTP and HTTPS disables access t the web interface. Disabling basic services such as telnet, rlgin, and s n makes the Cmmand-Line interface inaccessible. Supprted basic netwrk services and their default prt numbers Fr Digi devices with multiple serial prts, the netwrk prt number defaults fr varius services are set based n the fllwing frmula: base netwrk prt number + serial prt number Digi CnnectPrt LTS User Guide 44

45 CnnectPrt LTS web interface Cnfiguratin The assumed default base is Fr example, the telnet passthrugh service is set t netwrk prt 2001 fr serial prt 1, 2002 fr serial prt 2, 2003 fr serial prt 3, etc. If yu change a netwrk prt fr a particular service, that is the nly netwrk prt number that changes. That change des nt carry ver t the ther netwrk prts. Fr example, if yu change the netwrk prt number fr telnet passthrugh frm 2001 t 3001, that des nt mean that the ther netwrk prts will change t 3002, 3003, etc. There are tw types f netwrk services available: Basic services: Yu can access these services by cnnecting t a particular well-knwn netwrk prt. Passthrugh services: Yu can set up a specific type f service fr a specific serial prt. T use the service, yu must use the crrect prtcl and specify the crrect netwrk prt. Fr example, assuming default service prts and using a Linux hst, here is hw a user wuld access the SSH and telnet passthrugh services n prt 1: #> ssh -l fred digi16 -p 2501 #> telnet digi The fllwing table shws the netwrk services, services prvided, and the default netwrk prt number fr each service. Service Device Discvery, als knwn as Advanced Digi Discvery Prtcl (ADDP) Encrypted (Secure) RealPrt RealPrt Services prvided Discvery f Digi devices n a netwrk. Disabling this service disables use f the Digi Device Discvery utility t lcate the device. Yu cannt change the netwrk prt number fr ADDP frm its default. Secure Ethernet cnnectins between COM r TTY prts and device servers r terminal servers. A virtual cnnectin t serial devices n matter where they reside n the netwrk. Default netwrk prt number Line Printer Daemn (LPD) Allws netwrk printing ver a serial prt. 515 Mdem Emulatin Pl (pmdem) Mdem Emulatin Passthrugh Allws the Digi device t emulate a mdem. Mdem emulatin sends and receives mdem respnses t the serial device ver the Ethernet instead f Public Switched Telephne Netwrk (PSTN). Yu can enable r disable telnet prcessing n the incming and utging mdem-emulatin cnnectins. The pmdem service is fr cnnecting t whatever serial prt will answer. Allws the Digi device t emulate a mdem. This service is fr dialing in t a particular serial prt that has been set up fr mdem emulatin Digi CnnectPrt LTS User Guide 45

46 CnnectPrt LTS web interface Cnfiguratin Service Remte lgin (rlgin) Remte shell (Rsh) Secure Shell Server (SSH) Services prvided Allws users t sign in t the Digi device and access the cmmand-line interface thrugh rlgin. Allws users t sign in t the Digi device and access the cmmand-line interface thrugh Rsh. Allws users secure access t sign in t the Digi device and access the cmmand-line interface. Default netwrk prt number Secure Shell (SSH) Passthrugh Accessing a specific serial prt set up fr SSH Secure Scket Service Authenticatin and encryptin fr Digi devices Simple Netwrk Management Prtcl (SNMP) Telnet Server Telnet Passthrugh Transmissin Cntrl Prtcl (TCP) Ech Transmissin Cntrl Prtcl (TCP) Passthrugh Managing and mnitring the Digi device. T run SNMP in a mre secure manner, SNMP allws fr set cmmands t be disabled. This securing is dne in SNMP itself, nt thrugh Netwrk Services settings. If disabled, SNMP services such as traps and device infrmatin are nt used. Allws users an interactive telnet sessin t the Digi device s cmmand-line interface. If disabled, users cannt telnet t the device. Allws a telnet cnnectin directly t the serial prt, ften called reverse telnet. The frmat fr this prt number is as fllws: 20<serial prt number> Replace <serial prt number> with the Digi serial prt number. Fr example, 2001 applies t serial prt 1, 2010 applies t serial prt 10, and 2016 applies t serial prt 16. Used fr testing the ability t send and receive ver a TCP cnnectin, similar t a ping. Allws a raw scket cnnectin directly t the serial prt, ften called reverse sckets. The frmat fr this prt number is as fllws: 21<serial prt number> Replace <serial prt number> with the Digi serial prt number. Fr example, 2101 applies t serial prt 1, 2110 applies t serial prt 10, and 2116 applies t serial prt Digi CnnectPrt LTS User Guide 46

47 CnnectPrt LTS web interface Cnfiguratin Service User Datagram Prtcl (UDP) Ech User Datagram Prtcl (UDP) Passthrugh Services prvided Used fr testing the ability t send and receive ver a UDP cnnectin, similar t a ping. Allws raw data t be passed between the serial prt and UDP datagrams n the netwrk. The frmat fr this prt number is as fllws: 21<serial prt number> Replace <serial prt number> with the Digi serial prt number. Fr example, 2101 applies t serial prt 1, 2110 applies t serial prt 10, and 2116 applies t serial prt 16. Default netwrk prt number Web Server, als knwn as HyperText Transfer Prtcl (HTTP) Yu can establish secure access t cnfiguratin web pages by requiring a user t sign in. HTTP and HTTPS are als called Web Server r Secure Web Server. These services cntrl the use f the web interface. If HTTP and HTTPS are disabled, device users cannt use the web interface t cnfigure, mnitr, and administer the device. 80 Secure Web Server, als knwn as HyperText Transfer Prtcl ver Secure Scket Layer (HTTPS) Yu can secure access t cnfiguratin web pages by requiring a user t sign in with encryptin fr greater security. 443 Advanced Netwrk Services Settings The Advanced Netwrk Services Settings page shws a set f specific netwrk services that are available fr CnnectPrt LTS prducts, and the related settings fr the service. Web Settings: Lgin timeut ( minutes, 0 fr unlimited): Idle timeut settings in minutes fr the Web server. The Digi device prmpts the user t lg in again if the user tries t use the web interface after lgin timeut has expired. If yu set this value 0, the web lgin will nt expire. Digi CnnectPrt LTS User Guide 47

48 CnnectPrt LTS web interface Cnfiguratin SMTP Settings: Enable SMTP service: When enabled, the Digi device can send an ntificatin when an alarm ccurs. SMTP server name: IP address r DNS name f the SMTP server. SMTP with authenticatin: Chse this ptin if yur SMTP server requires a user name and passwrd. SMTP withut authenticatin: Chse this ptin if yur SMTP server des nt require a user name and passwrd. POP befre SMTP: Chse this ptin if yu want t access yur SMTP server after yu successfully lg in t POP service. SMTP user name: The user name fr yur SMTP (r POP) server. SMTP passwrd (new)/(cnfirm): The passwrd fr yur SMTP (r POP) server. Device mail address: The address used t send alarms. Mst SMTP servers check the sender's address with the hst dmain name t verify the address as authentic. Cnsequently, when assigning an address fr the device address, any arbitrary username with the registered hstname may be used. An example is username@cmpany.cm. Digi CnnectPrt LTS User Guide 48

49 CnnectPrt LTS web interface Cnfiguratin NFS Settings: Enable NFS service: When enabled, the Digi device can lg prt data t an NFS server. NFS server name: IP address r dmain name f the NFS server. Munting path n NFS server: The path t where the files are lcated n the NFS server. NFS timeut ( secnds): The timeut value in secnds t discnnect the Digi device frm the NFS cnnectin when the NFS server is nt respnding. If there is n respnse frm the NFS server during the NFS timeut interval, The Digi device releases (unmunt) a lcal directry which is munted t the directry f NFS server (munting path n NFS server). NFS munt retrying interval ( secnds): The retrying interval in secnds befre the Digi device attempts an NFS remunt again after discnnecting an NFS cnnectin. The Digi device checks whether cnnecting t the NFS server is pssible fr every NFS munt retrying interval. And if cnnectin t NFS server is pssible, the Digi device remunts munting path n NFS server n its lcal directry again and changes data lgging lcatin t NFS server autmatically if it is needed. Alert Settings: Descriptin: A descriptin f the alert that will be sent t the receiver. Send alert t the fllwing recipients fr NFS discnnectin: Send an alert if selected. Subject: The title f the alert. T: The primary recipient f the alert. CC: The secndary recipient f the alert. Pririty: Select ne f the fllwing pririty ptins fr this alert: Nrmal r High. Send NFS discnnectin trap when alarm ccurs: When selected, sends an SNMP trap when an alarm ccurs. Digi CnnectPrt LTS User Guide 49

50 CnnectPrt LTS web interface Cnfiguratin Samba Settings: Enable Samba service: When enabled, the Digi device can lg prt data t a Samba server. Samba server name: IP address r dmain name f the Samba server. Munting n path Samba server: The path t where the files are lcated n the Samba server. Samba timeut ( secnds): Timeut interval in secnds befre the Digi device discnnects Samba cnnectin when the Samba server is nt respnding. If there is n respnse frm the Samba server during the Samba timeut interval, the Digi device releases (unmunt) a lcal directry which is munted t the directry f the Samba server (munting path n Samba server). Samba munt retrying interval ( secnds): Retrying interval in secnds when the Digi device tries t cnnect t the Samba server again after discnnecting the Samba cnnectin. The Digi device checks whether cnnecting t the Samba server is pssible fr every Samba munt retrying interval. If cnnectin t the Samba server is pssible, the Digi device remunts munting path n the Samba server n its lcal directry again and changes data lgging lcatin t Samba server autmatically if it is needed. Samba server user: The user name fr yur Samba server. Samba server passwrd (new)/(cnfirm): The passwrd fr yur Samba server. Alert Settings : Descriptin: A descriptin f the alert that will be sent t the receiver. Send alert t the fllwing recipients fr Samba discnnectin: When selected, sends an alert when an alarm ccurs. Subject: The subject line f the ntificatin and the descriptin f the SNMP trap when an alarm is triggered. T: The address f the primary recipient f alert. CC: (Optinal) The address f the secndary recipient f Alert. Send Samba discnnectin trap when alarm ccurs: When selected, sends an SNMP discnnectin trap when an alarm ccurs. Pririty: Select ne f the fllwing pririty ptins fr this alert: Nrmal r High. Send Samba discnnectin trap when alarm ccurs: When selected, sends an Samba discnnectin trap when an alarm ccurs. Digi CnnectPrt LTS User Guide 50

51 CnnectPrt LTS web interface Cnfiguratin SYSLOG settings: Enable SYSLOG service: When selected, the Digi device can lg prt data t the SYSLOG server. SYSLOG server name: IP address r dmain name f the SYSLOG server. SYSLOG Facility: The Digi device supprts SYSLOG facilities frm lcal0 t lcal7. Yu can emply these facilities t save messages frm the Digi device separately t the SYSLOG server. Scket Tunnel Settings Yu can use a scket tunnel t cnnect tw netwrk devices: ne n the CnnectPrt LTS prduct s lcal netwrk and the ther n the remte netwrk. This is especially useful fr prviding SSL data prtectin when the lcal devices d nt supprt the SSL prtcl. One f the endpint devices is cnfigured t initiate the scket tunnel. The tunnel is initiated when that device pens a TCP scket t the CnnectPrt LTS prduct n the cnfigured prt number. The CnnectPrt LTS prduct then pens a separate cnnectin t the specified destinatin hst. Once the tunnel is established, the CnnectPrt LTS prduct acts as a prxy fr bi-directinal data between the remte netwrk scket and the lcal netwrk scket, regardless f which end initiated the tunnel. Scket tunnel settings include: Enable: Enables r disables the cnfigured scket tunnel. Timeut (secnds): The timeut, specified in secnds, cntrls hw lng the tunnel will remain cnnected when there is n tunnel traffic. If the timeut value is zer, then n timeut is in effect and the tunnel will stay up until sme ther event causes it t clse. Initiating Hst: The hstname r IP address f the netwrk device which will initiate the tunnel. This field is ptinal. Initiating Prt: Specify the prt number that the Digi device prduct will use t listen fr the initial tunnel cnnectin. Initiating Prtcl: The prtcl used between the device that initiates the tunnel and the Digi device server. Currently, TCP and SSL are the tw supprted prtcls. Destinatin Hst: The hstname r IP address f the destinatin netwrk device. Destinatin Prt: The prt number that the Digi device will use t make a cnnectin t the destinatin device. Destinatin Prtcl: The prtcl used between Digi device and the destinatin device. Currently, TCP and SSL are the tw supprted prtcls. This prtcl des nt need t be the same fr bth cnnectins. Click Add t add a scket tunnel. Click Apply t save the settings. Once the scket tunnel is cnfigured, select the Enable check bx t enable the scket tunnel. Advanced Netwrk Settings The Advanced Netwrk Settings define the netwrk interface. These settings rarely need t be changed. Cntact yur netwrk administratr fr mre infrmatin abut these settings. Digi CnnectPrt LTS User Guide 51

52 CnnectPrt LTS web interface Cnfiguratin IP Settings: Hst name: The hst name that will appear the DHCP Optin 12 field. The hst name can be a single name r a fully qualified dmain name (FQDN). Yu can use this ptinal setting nly when yu enable DHCP. Nte If yu change the hst name, yu must sign in t the web interface again. Enable Aut IP address assignment: Aut Private IP Addressing (APIPA), als knwn as Aut-IP: A standard prtcl that autmatically assigns an IP address frm a reserved pl f standard Aut-IP addresses t the cmputer n which it is installed. The device is set t btain its IP address autmatically frm a DHCP server. If the DHCP server is unavailable r nnexistent, Aut-IP assigns the device an IP address if ne f the fllwing instances are true: Yu enabled DHCP r it respnds later Yu are using ADDP/Device Discvery Bth will verride the previusly assigned Aut-IP address. Reuse ld IP at btup time n DHCP failure: If the Digi device fails t receive an IP address frm the DHCP server n bting up, the users can set the IP cnfiguratins f the Digi device with the previus IP cnfiguratins and cnnect it t the netwrk. Ethernet interface: Yu can set the speed and duplex mde f each Ethernet interface. Speed: Specify the Ethernet speed f the Digi device. Yur ptins are as fllws: Aut, 10 Mbit, 100 Mbps, r 1000 Mbps. Mde: Specify the duplex mde f the Ethernet interface. Yur ptins are as fllws: Aut, Half-duplex, r Full-duplex. Nte that yu cannt manually set the duplex mde if the speed is set t Aut. TCP keep-alive settings: The DHCP server assigns these netwrk settings, unless yu manually set them here. Idle Timeut: The perid f time that a TCP cnnectin can remain idle befre sending a keep-alive. Prbe Interval: The time in secnds between each keep-alive prbe. Prbe Cunt: The number f times TCP prbes the cnnectin t determine if it is alive after activating the keep-alive ptin. The cnnectin is assumed t be lst after sending this number f keep-alive prbes. IP Filtering Settings The Digi device ffers built-in firewall functinality t limit TCP/IP traffic t and frm certain netwrks, TCP prts, and interfaces. The functinality implemented is based n the Linux tl iptables. Yu can restrict yur Digi device n the netwrk by nly allwing certain devices r netwrks t cnnect. This is better knwn as IP Filtering r Access Cntrl Lists (ACL). By enabling IP filtering, yu are telling the Digi device t nly accept cnnectins frm specific and knwn IP addresses r Digi CnnectPrt LTS User Guide 52

53 CnnectPrt LTS web interface Cnfiguratin netwrks. Yu can filter devices n a single IP address r restrict device t a grup f devices using a subnet mask that nly allws specific netwrks t access t the device. CAUTION! Plan and review yur IP filtering settings befre applying them. If the settings are incrrect, the Digi device will be inaccessible frm the netwrk. The settings fr IP Filtering Settings include: Interface: The name f the netwrk interface where the packet riginated. Optin: Determines the rule that will be applied t the specified IP address/mask r its inverse. IP address/mask: Specifies the hst range by entering the base hst IP address fllwed by a frward slash (/) and subnet mask. Prtcl: The type f prtcl this prt will accept r drp. Prt: A TCP/IP prt n the Digi device that ther hsts will access. Chain: Determines whether r nt hsts can access the prt. Serial Prts Cnfiguratin Use the Serial Prts Cnfiguratin page t establish a prt prfile fr each serial prt n the CnnectPrt LTS prduct. The Serial Prts Cnfiguratin page includes the currently selected prt prfile fr the serial prt, detailed cnfiguratin settings fr the serial prt, dependent n the prt prfile selected, and links t basic and advanced serial settings. The Serial Prt Cnfiguratin page includes: Prt Grup Settings: This pane allws yu t create ne r mre prt grups and assign prts t each prt grup. See Prt Grup Settings fr mre infrmatin. Prt Settings: This pane lists the available prts and allws yu t cnfigure r cpy selected prts. See Prt Settings fr mre infrmatin. Prt Grup Settings Yu can create prt grups t send data t multiple prts. Instead f sending data t individual serial prts, yu can send data t all prts in a grup simultaneusly thrugh a prt in a grup. If yu select an additinal ptin, yu can als see the data frm multiple prts in the same grup frm a terminal cnnected t the ne f serial prts in the grup. T cnfigure a prt grup, yu must create a prt grup first and then select prts t be assciated with this grup. Yu can create a maximum number f 16 prt grups and a prt cannt be assciated with multiple grups. When yu select prts t be assciated with a grup yu can als cnfigure fllwing settings: N.: The grup number. Grup name: The name f the grup. Prts: Lists the prts assciated with the grup. When yu click Add, the fllwing settings appear: Grup name: The name f the grup. Check all/uncheck all: Select r clear the check bxes fr all prts. Digi CnnectPrt LTS User Guide 53

54 CnnectPrt LTS web interface Cnfiguratin Prt #<number>: Select r clear the check bx assciated with the prt. When yu select a check bx, the prt will be assigned t the grup. Shw data frm all prts assciated with same prt grup: When selected, user can see the data frm ther prts in the same grup frm a terminal cnnected t the ne f serial prts in the grup. Yu can cntrl the pattern f data frm ther prts in the same grup. Send after the fllwing number f bytes: Send the data t the ther prts in the same grup after the specified number f bytes has been received n the serial prt. Yu can specify 1 t 4096 bytes. Default is 1024 bytes. Send after the fllwing number f idle millisecnds: Send the data t the ther prts in the same grup after the specified number f idle time has been passed with n additinal data received n the serial prt. Yu can specify 1 t 65,535 millisecnds. Default is 1000 millisecnds. Prt Settings Prt: Lists the available prt. T view r cnfigure the prt settings, click the prt number. See Prt Prfile Settings fr mre infrmatin. Descriptin: A brief descriptin f the prt. Prfile: The prfile assigned t the prt. See Select Prt Prfile fr mre infrmatin n available prt prfile ptins. Serial Cnfiguratin: Displays the serial cnfiguratin assciated with the prt. Actin: Select t perfrm allwable actins n this entry. The nly allwable actin is t cpy the prt settings fr this prt t ther prts. See Cpy Serial Prt Settings fr mre infrmatin. Select Prt Prfile The Select Prt Prfile page appears when yu click Change Prfile n the Prt Prfile Settings pane. A prt prfile allws yu t easily cnfigure a serial prt based n hw yu intend t use that prt. By selecting ne f the pre-defined prfiles, the cnfiguratin ptins are fcused nly n the settings required fr that particular prfile. The CnnectPrt LTS supprts the fllwing prt prfiles: Cnsle Management: Manage a serial device's cnsle prt ver a netwrk cnnectin. The Cnsle Management prfile allws yu t access a Digi device's cnsle prt ver a netwrk cnnectin. Mst netwrk devices such as ruters, switches, and servers ffer ne r mre serial prts fr management. Instead f cnnecting a terminal t the cnsle prt, cable the cnsle prt t the serial prt f the CnnectPrt LTS prduct. Then using TCP/IP utilities like reverse telnet, netwrk administratrs can access these cnsled serial prts frm the LAN. Digi CnnectPrt LTS User Guide 54

55 CnnectPrt LTS web interface Cnfiguratin See Assign a prfile t a serial prt fr mre infrmatin. Custm: The Custm prfile is an advanced ptin t allw full cnfiguratin f the serial prt. Use the Custm prfile nly if the serial prt des nt fit int any f the predefined prt prfiles. Fr example, when netwrk cnnectins invlve a mix f TCP and UDP sckets. In CnnectPrt LTS, the Custm prfile als allws the access f a serial prt thrugh RealPrt prtcl. See Assign a prfile t a serial prt fr mre infrmatin. Lcal Cnfiguratin: The Lcal Cnfiguratin prfile allws yu t sign in and access the cmmand line interface when cnnecting directly t a serial prt n a Digi device. This prfile prvides a lgin frm the Digi device. See Assign a prfile t a serial prt fr mre infrmatin. Mdem: The Mdem prfile allws yu t attach mdem devices t the serial prt t establish r receive cnnectins frm ther systems and mdems. Mdem dial-in and bi-directinal ptins prvide a lgin frm the Digi device. See Assign a prfile t a serial prt fr mre infrmatin. Mdem Emulatin: The Mdem Emulatin prfile allws yu t cnfigure the serial prt t act as a mdem. The Digi device server emulates mdem respnses t a serial device and seamlessly sends and receives data ver an Ethernet netwrk instead f a PSTN (Public Switched Telephne Netwrk). This allws yu t retain legacy sftware applicatins withut mdificatin and use a less expensive Ethernet netwrk in place f public telephne lines. See Assign a prfile t a serial prt fr mre infrmatin. Printer: The Printer prfile allws yu t cnnect a printer t the serial prt. Use this prfile if yu intend t print using the LPD prtcl n yur system. See Assign a prfile t a serial prt fr mre infrmatin. Digi CnnectPrt LTS User Guide 55

56 CnnectPrt LTS web interface Cnfiguratin RealPrt: Use RealPrt t map a COM r TTY prt t this serial prt f yur Digi device. The COM/TTY prt appears and behaves as a lcal prt t the PC r server. RealPrt is als knwn as COM Prt Redirectin. See Assign a prfile t a serial prt fr mre infrmatin. Refer t the RealPrt Setup Guide fr instructins n installing and cnfiguring the RealPrt driver n yur PC r server. When yu cnfigure a RealPrt prfile, the CnnectPrt LTS prduct relinquishes cntrl f the serial prt t the hst that has the RealPrt driver installed. The cmputer applicatins send data t this virtual COM r TTY prt and the RealPrt driver sends the data acrss the netwrk t the crrespnding serial prt n the CnnectPrt LTS prduct. The netwrk is transparent t bth the applicatin and the serial device. Imprtant Install and cnfigure the RealPrt sftware n each cmputer that uses RealPrt prts. Yu can dwnlad and install the RealPrt sftware frm the Digi Supprt site. See Assign a prfile t a serial prt fr installatin instructins. Yu need t cnfigure the RealPrt sftware with the IP address f the CnnectPrt LTS prduct. Serial Bridge: The Serial Bridge Prfile cnfigures ne side f a serial bridge. A bridge cnnects tw serial devices ver the netwrk as if they were cnnected with a serial cable. This is als referred t as serial tunneling. Each serial device is cnnected t the serial prt f a Digi device server. Yu must cnfigure ne Digi device as the client and the ther Digi device as the server. This prfile cnfigures each side f the bridge separately. See Assign a prfile t a serial prt fr mre infrmatin. Digi CnnectPrt LTS User Guide 56

57 CnnectPrt LTS web interface Cnfiguratin TCP Sckets: Aut-Cnnect (TCP client) t anther hst n the netwrk r allw incming cnnectins n this serial prt (TCP server). The TCP Sckets prfile allws serial devices t cmmunicate ver a TCP netwrk. The TCP server allws ther netwrk devices t initiate a TCP cnnectin t the serial device attached t the serial prt f the CnnectPrt LTS prduct. The TCP client will establish a TCP cnnectin t a defined IP address and prt number. See Assign a prfile t a serial prt fr mre infrmatin. UDP Sckets: Allws the autmatic distributin f serial data frm ne hst t many devices at the same time. The UDP Sckets prfile allws serial devices t cmmunicate using UDP. The UDP Server cnfiguratin allws the serial prt t receive data frm ne r mre systems r devices n the netwrk. See Assign a prfile t a serial prt fr mre infrmatin. The UDP Client cnfiguratin allws the autmatic distributin f serial data frm ne hst t many devices at the same time using UDP sckets. The prt numbering cnventins shwn in the TCP Sckets Prfile als apply t UDP sckets. See Assign a prfile t a serial prt fr mre infrmatin. Nt all prt prfiles are supprted in all prducts. Supprted prt prfiles varies by CnnectPrt LTS mdel. If a prfile listed in this descriptin is nt available n the page, it is nt supprted in the CnnectPrt LTS prduct. If yu selected a prt prfile, the prt number assciated with the prt prfile appears at the tp f the page. Yu can change r retain the prfile and adjust individual settings. Everything displayed n the Serial Prts Cnfiguratin page between Prt Prfile Settings and the links t the Basic Serial Settings and Advanced Serial Settings depends n the selected prt prfile. Assign a prfile t a serial prt T assign a prfile t a serial prt: 1. Select Cnfiguratin > Serial Prts. 2. Click a prt number frm the Prt clumn. 3. Click Change Prfile. 4. On the Select Prt Prfile page, select a prt prfile ptin and then click Apply. Digi CnnectPrt LTS User Guide 57