Digi 90000566_H manual

Digi Connect ® Family Digi Connect Family: Digi Connect SP, Digi Connect Wi- S P, Digi Connect ME, Connect ME4, Digi Connect Wi-ME, Digi Conn ect EM, Digi Connect Wi-EM, Digi Connect ES Family (D igi Connect ES 4/8/16 devices) ConnectPort • TS Products: ConnectPort TS 8, Co nnectPort TS 8 MEI Digi Cellular Family: Digi Connect WAN, Digi Connect [...]

© Digi International Inc. 2007. All Rights Reserved. Digi, Digi International, the Digi logo, Digi Connect F amily , Digi Connect SP , Digi Connect Wi-SP , Digi Connect ME, Di gi Connect ME4, Digi Connect Wi-ME, Digi Connect EM, Digi Connect Wi-EM, Digi Connect ES, Conne ctPort TS 8, ConnectPort TS 8 MEI, Digi Connect W AN , Digi Connect W AN VPN,[...]

Contents 3 Chapter 1 Introduction Digi Connect Products and Families to Which This Book Applies......... 7 Quick Reference for Configur ing Features ................ ................ ............ 8 Access the Command Line......... ............................................... .......... 1 1 Configure an IP Address ....... ........................[...]

4 Cont ents set ethernet.............. ................................. ............................... .......... 107 set forwarding .......... ................................................................ .......... 109 set gpio .................. ................................................. ................. .......... 113 set group....[...]

Contents 5 who ............... .............................................. ............... .............. .......... 258 Chapter 3 Modem Emulation Commands What Is Modem Emulation? .. .................................................. .......... 259 Modem Emulation Cabl e Signals ............... ............... .............. .......... 259 Mode[...]

6 Cont ents[...]

Digi Connect Products and Families to Which This Book Applies Chapter 1 Introduction 7 This book describes the commands in the command-line interface for several Digi product families, listed below . This chapter provides the following: • A quick reference showing the command s used to configure features or perform configuration tasks from the co[...]

Quick Reference for Configuring Features 8 Chapter 1 Introduction Quick Reference for Configuring Features The following table shows common feat ures that can be configured from the command line, and t he commands used to conf igure each feature. If you are viewing the PDF fi le of this document, cli ck the commands in the “Commands” column to [...]

Quick Reference for Configuring Features Chapter 1 Introduction 9 IP Forwarding and Network Address T ranslation (NA T) "set forwarding" on pa ge 109. "set nat" on p a ge 146. IP pass-through "set passthroug h" on page 153 Mobile (Cellula r) fe atures: • Provisioning CDMA cellular modules T o disp lay existing provis[...]

Quick Reference for Configuring Features 10 Chapter 1 Introduction Serial port configuration Serial port comm unication options: "set seria l" on page 189. Port profiles: "set profile" on page 172. RCI serial mode : "set rciserial" on page 184. RTS T oggle: "set rtstoggle" on page 187. TCP serial connections:[...]

Access the Command Line Chapter 1 Introduction 11 Access the Command Line T o configure devices using commands, you must first access the command line, and then log on as needed. This procedure assumes that you have already configured the Digi device with an IP address. 1. T o access the Command-Line Interfac e for the Digi device, enter the follow[...]

Basic Command Information 12 Chapter 1 Introduction Basic Command Information Navigation and Editing Keys Use the keys listed in the table to navigate the comm and line and edit commands: Displaying Online Help Help is available for all commands. The table describes how to access it. Abbreviating Commands All commands can be ab breviated. Simply s [...]

Basic Command Information Chapter 1 Introduction 13 Entering Special Characters in S tring V alues Several commands have options that are string values, for example the “set alarm” command’s “match” op tion and the “set autoconnect” command’s “connect_o n_string” option. Escape Sequences for S pecial Characters S pecial characte[...]

User Models and User Permissi ons in Digi Connect Products 14 Chapter 1 Introduction User Models and User Permissi ons in Digi Connect Produc ts The user model in a Digi Connect product influ ences the commands that users can issue. There are three user models implement ed in the various Digi Connect and ConnectPo rt devices: one-user model, two-us[...]

User Models and User Permissi ons in Digi Connect Products Chapter 1 Introduction 15 Login Suppression Feature The login prompt can be disabled by i ssuing the “set login” command. See "set login" on page 131. Increasing Security for Digi Device Users As needed, you can enforc e additional security for device users. For example, you c[...]

User Models and User Permissi ons in Digi Connect Products 16 Chapter 1 Introduction[...]

Verifying Device Support for Commands Chapter 2 Command Descriptions 17 This chapter provides a description of each comma nd in the Digi Connect Family Command- Line Interface. V erifying Device Support for Commands T o verify whether a Digi Connect device supports a particular command or command options, and to get the allo wed ranges and limits f[...]

backup 18 Chapter 2 Command Descriptions backup Devices supported This command is supported in all Digi Connect products. Purpose Save the device configuration to a TFTP server located on the network, or restores the configur ation from a saved c opy on the TFTP server . Required permissions For Digi Connect products with two or more users, permiss[...]

boot Chapter 2 Command Descriptions 19 boot Devices supported This command is supported in all Digi Connect products. Purpose Reboots the device server , restores the device co nfiguration to factory default settings, or loads new firmwar e files (both EOS and POST images) from a TFTP server . Required permissions For Digi Connect products with two[...]

boot 20 Chapter 2 Command Descriptions Examples Restore configuration default s This example reloads the firmware st ored in flash ROM and resets the configuration to factory def aults then reboot s the device. #> boot action=factory Reboot using the current firmware and configuration This example reboots the device and uses the current firmware[...]

close Chapter 2 Command Descriptions 21 close Devices supported This command is supported in all Digi Connect products. Purpose Closes active connect, Rlogin, and T elnet sessions; that is, sessions opened by “connect,” “rlogin, ” or “telnet” commands. The “close” command is associated with the sessions displayed by the “status”[...]

connect 22 Chapter 2 Command Descriptions connect Devices supported This command is supported in all Digi Connect products. Purpose Used to make a connection, or esta blish a session, wit h a serial port. Required permissions For Digi Connect products with two or more users, permissions must be set to “set permissions connect=execut e” to use t[...]

dhcpserver Chapter 2 Command Descriptions 23 dhcp server Devices supported This command is support ed in Digi Cellular Fa mily products only . Purpose Used for managing and showing the st atus of a DHCP server , including managing the leases for IP addresses, restar ting, running, and shutting down the DHCP server , and di splaying DHCP server stat[...]

dhcpserver 24 Chapter 2 Command Descriptions Example Display DHCP server st atus #> dhcpserver status Device Networking Status: IP address : 10.30.1.1 88 Subnet mask : 255.255.2 55.0 Default gateway : 10.6.6.6 Static IP confi gured : yes Uptime : 0 days + 21:00:44 DHCP server statu s: running Uptime : 0 days + 21:00:36 Scopes configured in serve[...]

dhcpserver Chapter 2 Command Descriptions 25 IP address : 10.30 .1.197 Client ID : 00:09 :26:19:51:07 Lease durat ion : using scope lease dura tion Address exclusi ons: none configur ed Lease Records: Client ID Lease Time in Seconds IP Address (MAC Address) D uration Remainin g Lease Record Sta tus ------------- -- -------------- --- ---------- -- [...]

dhcpserver 26 Chapter 2 Command Descriptions DHCP server will mark the address as unavailable. The lease will remain in this state for 4 hours, after which it is reverts to the Reserved (inactive) status. Offered (pre-lease) A lease has been offered to the given client, but t hat client has not yet requested that the lease be acknowledged. It may b[...]

display Chapter 2 Command Descriptions 27 display Devices supported This command is supported in all Digi Connect products. Purpose Displays status information for a Digi Connect device. The “display” command’s focus is on real-time inform ation. In contrast, the “info” command displays statistica l information about a dev ice over time, [...]

display 28 Chapter 2 Command Descriptions • Virtual Private Netw ork ( V PN) information, including Security Association (SA) databas e entries and Security Policy Database (SPD) entries. • Typical wireless LAN (WLAN) parameters for wireless devices. 100% CPU Utilization may i ndicate encryption key generation is in-progress There may be instan[...]

display Chapter 2 Command Descriptions 29 device Displays general product informati on including product name, MAC address, boot, post, and firmware versions, memory usage, CPU utilization, and uptim e. The information display ed b y this option is the same as that displayed by the “info device” comm and (see "info" on page 41). ddns [...]

display 30 Chapter 2 Command Descriptions serial Displays serial modem signals (DTR, RTS, CTS, DSR, DCD). socket s Displays information about how socket resources are being used by the system. sp d Displays Security Policy Database ( SPD) entries defined for Virtual Private Networ k (VPN) tunnels. switches Displays Multiple Electrical Interfac e (M[...]

display Chapter 2 Command Descriptions 31 Example Display device information #> display device Device Informatio n: Product : Digi Connec t ME MAC Address : 00:40:9D:24 :8B:B3 Firmware Version : 1.9.0 (Vers ion 82000856_F5 0 9/16/2005) Boot Version : 0.0.0.1 (re lease_82000866_C) Post Version : 0.0.0.1 (re lease_82000867_B) CPU Utilization : 14 [...]

display 32 Chapter 2 Command Descriptions Output This section describe and interprets selected information and st atistics output by the “d isplay” command. Information returned by “display ppp st ats” The “display pppst ats” displays status and activity info rmation for a PPP link, and SureLink statistics. This information is specif ic[...]

display Chapter 2 Command Descriptions 33 reset status These PPP status val ues describe why a PPP link was terminated. idle reset s The number of resets bec ause the idle timeout was reached/exceeded for transmitted and received data. Thes e idle timeouts are set by the “set pppoutbound” command. Most of the time, no idle timeout is used on tr[...]

display 34 Chapter 2 Command Descriptions last reset reason The reason for the most rece nt reset of the PPP link. idle An idle reset brought down the link last. lcp keep alive An LCP keepalive reset br ought down the link last. surelink Surelink tests failed and brought down the link. no service The modem received a “no service” indication on [...]

display Chapter 2 Command Descriptions 35 lcp echo request s The number of Link Control Protocol (LCP) echo requests that have been sent after a “quiet” interv al, in order to test th e PPP link and/or keep it alive. For Digi Cellular products, LC P echo requests ar e typically not used. SureLink St atistics Digi SureLink™ provides an “alwa[...]

display 36 Chapter 2 Command Descriptions tot al link down requests The number of times the SureLink feature has failed consecutively the configured number of fail ures and, as a result, requested that PPP shut down and restart its connec tion. This statistic counts such occurrences during the current device boo t. SureLink itself does do the PPP s[...]

display buffers Chapter 2 Command Descriptions 37 display buffers Devices supported This command is supported in al l Digi Connect products except Digi Connect WA N and ConnectPort Display . Purpose Displays the contents of a port buf fer , or transfers the c ontents of a port buffer to a server running T rivial Fi le T ransfer Protocol (TFTP). Por[...]

display buffers 38 Chapter 2 Command Descriptions Examples Display port buffering information on the screen #> display buffer s port=2 screen l ines=32 tail=30 Output buffering information to a TFTP server #> display buffer s port=2 tftp=192 .168.1.1:port_oup ut Output multi-port buffering information to a TFTP serv er #> display buffer s [...]

exit Chapter 2 Command Descriptions 39 exit Devices supported This command is supported in all Digi Connect products. Purpose T erminates your current session. Synt a x exit Example #> exit See also "quit" on page 59. The “ quit” and “exit” comm ands perform the same operation.[...]

help and ? 40 Chapter 2 Command Descriptions help and ? Devices supported This command is supported in all Digi Connect products. Purpose Displays help about a specific command. Synt a x help [command] OR [command]? Examples #> help boot #> boot? #> help set seria l #> set serial? See also "Displaying Online Help" on page 12.[...]

info Chapter 2 Command Descriptions 41 info Devices supported This command is supported in all Digi Connect products. Purpose Displays statistical info rmation about a device. The “info” command displays statisti cal information about a device over time. In contrast, the “display” command’ s focus is on real-time information, while the ?[...]

info 42 Chapter 2 Command Descriptions serial Displays statistics from the serial table. For descriptions of these statistics, see "Output" on page 42. tcp Displays statistics fr om the TCP table. ud p Displays statistics from the UDP table. wlan Displays statistics from the wi reless Ethernet (wlan) table. Output Following are descriptio[...]

info Chapter 2 Command Descriptions 43 Ethernet st atistics ICMP st atistics Stati s ti c Description InBytes Number of bytes received. OutBytes Number of bytes sent. InUcastPkts Number of Unicast packets received. OutUcastPkts Number of Unicast packets sent. InNonUcastPkts Nu mber of non-Unicast packet s r eceived. OutNonUcastPkt s Number of non-U[...]

info 44 Chapter 2 Command Descriptions IP st atistics Stat is t ic Description InReceives Number of datagrams rece ived . OutRequest s Number of datagrams given to IP to tran smit. InAddressErrors Number of received dat agrams discarded because they were for another host and co uld not be forwarded. Datagra msForwarded Number of received data grams[...]

info Chapter 2 Command Descriptions 45 Serial st atistics Stati s ti c Description rbytes T otal dat a in: the number of bytes received. tbytes T otal dat a out: the number of bytes transmitted. overrun errors The number of times FIFO has overrun. The next dat a character arrive d before the hardware could move the previous character . overflow err[...]

info 46 Chapter 2 Command Descriptions TCP st atistics UDP st atistics Stati s ti c Description InSegment s Number of segment s received. OutSegment s Number of segment s sent. InErrors Number of segment s received with errors. RetransmitSegment s Number of segment s retransmitted. Segment s are retransmitted when the ser ver doesn't respond t[...]

info Chapter 2 Command Descriptions 47 Wireless (WLAN) st atistics The WLAN statistics may aid in tr oubleshooting network communication problems with your wireless network. For additional wireless sett ings and an eval uation of the wireless settings, issue a "show wlan" command. See "show" on page 249. Stati s ti c Description[...]

info 48 Chapter 2 Command Descriptions Examples Display ICMP st atistics #> info icmp ICMP statistics: InMessages : 14 OutMessages : 0 InDestUnreachable s : 5 OutDestUnrea chables : 0 InErrors : 0 See also • "display" on page 27. • "show" on page 249. The "show wlan" command displays settings and evaluation info[...]

kill Chapter 2 Command Descriptions 49 kill Devices supported This command is supported in all Digi Connect products. Purpose Use the kill command to ki ll connections. The kill command is associated with the connections displa yed by the “who” command. Required permissions For Digi Connect products with two or more users, permissions must be s[...]

mode 50 Chapter 2 Command Descriptions mode Devices supported This command is support ed in Digi Connect Family products only and not in Digi Cellular Family pr oducts or ConnectPort Display . Purpose Changes or displays the operating options for a cu rrent T elnet session. Required permissions For Digi Connect products with two or more users, perm[...]

newpass Chapter 2 Command Descriptions 51 newp ass Devices supported This command is supported in all Digi Connect products. Purpose Creates or changes user pa sswords for the device. In Digi devices with a single-user model, changing the “roo t” user p assword also changes the passwor d for Advanced Digi Discove ry Protocol (ADDP). In Digi dev[...]

ping 52 Chapter 2 Command Descriptions ping Devices supported This command is supported in Connect Family products only and not in Digi Cellular Family pro ducts or ConnectPort Display . Purpose T ests whether a host or other device is active and reachable. T o interrupt the “ping” command, use Ctrl-C. Required permissions For Digi Connect prod[...]

provision Chapter 2 Command Descriptions 53 provision Devices supported This command is supported in Digi Cellular Family products that have a CDMA (Code-Division Mult iple Access) module. Purpose Provisions the CDMA module in a Digi Cellular Family device. Provisioning establishes configuration settings in the CDMA m odule for use in a mobile netw[...]

provision 54 Chapter 2 Command Descriptions Import ant: Close PPP sessions before issuing provisioning c ommands The “provision” and “display provisio ning” commands cannot be used while Point-to-Point Protocol (PPP) sessions are active. T o close any exis ting PPP sessions: 1. Disable the PPP interface by ent ering a “set pppou tbound”[...]

provision Chapter 2 Command Descriptions 55 Use IOT A to provision the module provision type=iota spc= service programming code (MSL)(also kn own as master subsidy lock or MSL) mdn= mobile directory number min= mobile ID number Use OT ASP to provision the module provision type=otasp otaspnumber= OTASP number - for example, *228 or *22899 Options SI[...]

provision 56 Chapter 2 Command Descriptions aaasstype={ascii|hex} default=ascii Specifies whether the A AA shared secret is sp ecified in ASCII or hexadecimal form. This option affect s how the shared-secret values are specified on the “aaass” option. ha= home address The home address for th e CDMA module, specif ied as an IP address priha= pri[...]

provision Chapter 2 Command Descriptions 57 IOT A provisioning p arameters type=iot a Specifies that the CDMA module is being provisioned using the IOTA method. spc= service programming code (MSL) A six-digit number requi red to program CDMA module parameters. mdn= mobile di re c tory number The phone number of the CDMA module. min= mobile ID numbe[...]

python 58 Chapter 2 Command Descriptions python Devices supported This command is supported in C onnectport X Family products only . Purpose Manually executes a Python pr ogram from t he command line. The “python” command is similar to a command executed on a PC. However , other than a program name and arguments for the program, the command tak[...]

quit Chapter 2 Command Descriptions 59 quit Devices supported This command is supported in all Digi Connect products. Purpose Use the quit command to log out of the device. Synt a x quit Example #> quit See also "exit" on page 39. The “quit” and “exit” commands perform the same operation.[...]

reconnect 60 Chapter 2 Command Descriptions reconnect Devices supported This command is supported in all Digi Connect products. Purpose Reestablishes a previously est ablis hed connection; that is, a connection opened by a “connect,” “rlo gin,” or “telnet” command. The default operation of this command is to reconnect to the last active[...]

revert Chapter 2 Command Descriptions 61 revert Devices supported This command is supported in all Digi Connect products. Purpose Sets a p articular group of a devices’ settings to its default values. The “revert” command keyw ords are used one at a time to revert one group of settings. Y ou cannot enter several keywords on a single command t[...]

revert 62 Chapter 2 Command Descriptions putty| python| rciserial| realport| rtstoggle| serial [port= range ]| service| snmp| socket_tunnel| surelink| switches| system| tcpserial [port= range ]| term [port= range ]| udpserial [port= range ]| user| video| vncclient| vpn {all|global|tunnel|phase1|phase2}| wireless] Options all Reverts all settings ex[...]

revert Chapter 2 Command Descriptions 63 command. ekahau Reverts the Ekahau client settings configured by the “set ekahau” command. See "set ekahau" on page 104. forwarding Reverts the port-forwarding settings configured by t he “set forwarding” command. gpio Reverts the GPIO settings confi gured by the “set gp io” command. ho[...]

revert 64 Chapter 2 Command Descriptions pmodem [port= range ] Reverts the modem emulation settings , configured by the “set pmodem” command. pppoutbound [port= range ] Reverts the Point-to-Poi nt Protocol (PPP) outbound connection settings, configured by the “set pppoutboun d” command. profile [port= range ] Reverts the profile sett ings c[...]

revert Chapter 2 Command Descriptions 65 command. ud pserial [port= range ] Reverts the UDP serial settings configured by the “set udpserial” command. user Reverts the user settings confi gured by the “set user” command. video Reverts the video settings configured by the “set video” command. vncclient [port= range ] Reverts the settings[...]

rlogin 66 Chapter 2 Command Descriptions rlogin Devices supported This command is supported in Dig i Connect Family and Digi Cellular Family products only . Not s upported in ConnectPort Display . Purpose Performs a login to a remote system , also referred to as an rlogin. Required permissions For Digi Connect products with two or more users, permi[...]

send Chapter 2 Command Descriptions 67 send Devices supported This command is supported in Dig i Connect Family and Digi Cellular Family products only . Not s upported in ConnectPort Display . Purpose Sends a T elnet control command, or special-character sequences, when connected using the T e lnet client. Required permissions For Digi Connect prod[...]

set accesscontrol 68 Chapter 2 Command Descriptions set accesscontrol Devices supported This command is support ed in Digi Cellular Fa mily products only . Purpose Used to specify informatio n that limits network a ccess to this device, or display current access-control settings . For the Digi Connect WAN, the access-control settings al so limit ro[...]

set accesscontrol Chapter 2 Command Descriptions 69 subnip[1-32]= ipaddress Used to specify up to 32 subnet IP addresses. Any IP address in these subnets will be allowed to access this device server. subnmask[1-32]= mask Used to specify a subnet mask associat ed with one of the 32 subnet IP addresses. Examples Set access control settings #> set [...]

set alarm 70 Chapter 2 Command Descriptions set alarm Devices supported This command is supported in the following products: • Connect Family: Digi Connect EM, Di gi Connect Wi-EM, Digi Connect ME, Digi Connect Wi-M E. Setting alarms in GPIO mode is not supported in the Digi Connect SP device. • All Digi Cellular Family products. Setting alar m[...]

set alarm Chapter 2 Command Descriptions 71 Configure alarms based on GPIO pin st ates, where n is the GPO pin number set alarm range={1-32} mode=gpio [pins= list of pins| highpins= list_of highpins | lowpins= list of lowpins |pin{ n }={high|low|ignore}| trigger_interval= seconds |reminder={on|off}| reminder_interval= seconds ] Configure alarms bas[...]

set alarm 72 Chapter 2 Command Descriptions Options General alarm options st ate= {on|off} Enables or disables all alarms. on Enables all alarms. off Disables all alarms. To avoid false errors, it is recommended that you configure alarms while alarms are disabled, and enable alarms after they are fully configured. The default is “off.” mailserv[...]

set alarm Chapter 2 Command Descriptions 73 Options for setting multiple alarms with the “range” option range= {1-32} Specifies the alarm or range of alar ms for which alar m options are set. active={on|off} Enables or disables an alarm. on Enables an alarm. off Enables an alarm. The default is “off.” cc= string The text to be included in t[...]

set alarm 74 Chapter 2 Command Descriptions ecio_1xrtt Alarms are triggered when the average Ec/Io 1xRTT signal strength on a CDMA device falls below a specif ied threshold for a specified amount of time. Optional ly, a subsequent ala rm is triggered when signal strength returns to the optimal state above the threshold. ecio_1xevdo Alarms are trigg[...]

set alarm Chapter 2 Command Descriptions 75 type={email|snmptrap|all} Used to determine what kind of an alarm is sent : an e-mail alarm, an SNMP trap or both. For SNMP traps to be sent , the IP address of t he system to which traps are sent must be configured, by i ssuing a “set snmp” command with the “trapdestip” option. Se e "set snm[...]

set alarm 76 Chapter 2 Command Descriptions reminder={on|off} The type of reminder sent. on An email or SNMP trap is sent peri odically while the alarm-triggering event is active. The interval is based on the value of the “reminder_interval” option. off An email or SNMP trap is sent only when an alarm is triggered. reminder_interval= seconds Th[...]

set alarm Chapter 2 Command Descriptions 77 mode=ecio_1xevdo Sets the alarm to 1xEV-DO Ec/Io signal-strength mode for a CDMA radio. signal_strength_threshold= threshold The threshold average si gnal strength., This is measured in dBm for rssi_gsm, rssi_1xrtt, and rssi_1xevdo (typically -120 dBm to -40 dBm) and dB for ecio_1xrtt and ecio_1xevdo (typ[...]

set alarm 78 Chapter 2 Command Descriptions Mobile temperature-based alarm options These options for setting alarms based on the radio’s r eported temperature are supported in Digi Cellular Family products only . No te that temperature- based options are not avail able with all radios. T o determine if your radio supports these alarms, use the ?[...]

set alarm Chapter 2 Command Descriptions 79 Examples Set a GPIO alarm and send an email mess age or SNMP trap This example shows how to set up a GP IO alarm to trigger when two GPIO pins go high, and sending an email mess age when they do. It also shows how to change from s ending an email message wh en the alarm condition occurs to issuing an SNMP[...]

set alarm 80 Chapter 2 Command Descriptions T urn alarm #10 on. #> set alarm range=10 active=on mode=config_change Set all alarms to be se nt to Connectware Manager , and turn on alarms: #> set alarm state=on cwm=on See also • "set gpio" on page 1 13. T his comm and determines whether pins act as GPIO input, GPIO output , or stand[...]

set autoconnect Chapter 2 Command Descriptions 81 set autoconnect Devices supported This command is supported in Dig i Connect Family and Digi Cellular Family products only . Not s upported in ConnectPort Display . Purpose Used to establish an automatic connec tion (autoconnection) between the serial port and a remote network des tination, and to d[...]

set autoconnect 82 Chapter 2 Command Descriptions Options port= range Used to specify the se rial port. Optional on a single-port device. st ate={on| off} Enables or disables the autoconnect feature. on Enables the autoconnect feature. off Disables the auto connect feature. The default is off. If you are using the serial port for another purpose, i[...]

set autoconnect Chapter 2 Command Descriptions 83 description= string A name for descriptive purposes only. ip address= ipaddress The IP address of the net work destination to whic h a connection will be made. ipport= ipport The TCP port of the netwo rk destination to which a connection will be made. connect_on_string= string When the value of the [...]

set autoconnect 84 Chapter 2 Command Descriptions Examples Set autoconnect on with trigger This example shows sett ing autoconnect to connect to the TCP port (2101) of the network IP destination when data arrives on the serial port. #> set autoconnec t state=on trigge r=data ipaddress= 10.0.0.1 ipport=21 01 Allow outgoing dat a that is either un[...]

set bsc Chapter 2 Command Descriptions 85 set bsc Devices supported This command supported in Digi Connect W AN Sync only . Purpose Configures the binary syn chronous feature (also k nown as bisync or BSC) that provides bisync to IP protocol conf iguration. This feature allows you to attach a bisync terminal to the Digi device server ’ s serial p[...]

set bsc 86 Chapter 2 Command Descriptions Synt a x Enable/disable bisync comm unications and configure serial settings set bsc [state={disabled|enabled}] [serial_mode={bisync3270|bisync3275}] [baudrate={ baud rate )|external_clock}] Configure polling settings set bsc [code_set={ascii|ebcdic}] [text_conversion={on|off}] [polling_address=0x followed [...]

set bsc Chapter 2 Command Descriptions 87 Options for polling settings code_set={ascii|ebcdic} Specifies whether the bisync terminal uses the ASCII or EBCDIC code set. This option determines the c ontrol characters used for serial communication and the format of text data if the “text_conversion” option is “on.” This option must match the s[...]

set bsc 88 Chapter 2 Command Descriptions poll_interval= milliseconds Specifies the time interv al between successive attempts to poll the bisync terminal. The default value is “1000,” or 1 second. rx_timeout= milliseconds Specifies the maximum time interval between sending data and receiving a response from the bi sync terminal. If the ex pect[...]

set bsc Chapter 2 Command Descriptions 89 power_on_message=(0x followed by up to 64 hex digits) The status message that is sent to t he host the first time a connection is established after the Digi device server has been powered on or rebooted. no_response_message=(0x followed by up to 64 hex digits) The status message that is sent to the host whe[...]

set buffer 90 Chapter 2 Command Descriptions set buffer Devices supported This command is supported in Dig i Connect Family and Digi Cellular Family products only . Not s upported in ConnectPort Display . Purpose Configures buffering settings on a port, or displa ys the port buf fer configuration settings on all ports. The port buff ering feature a[...]

set buffer Chapter 2 Command Descriptions 91 st ate The buffering state, which can be any of the following: on The data will be buffered. off The data will not be buffered and al l data will be cl eared from the buffer. pa u s e The data will not be buffe red, but data in the buff er will not be cleared. Examples Display port buffer configuration f[...]

set ddns 92 Chapter 2 Command Descriptions set ddns Devices supported This command is support ed in Digi Cellular Fa mily products only . Purpose Configures a Dynamic DNS (DDNS) service. DDNS allows a user whose IP address is dynamical ly assigned to be locate d by a host or domain name. A DDNS service provider typically suppor ts the registration [...]

set ddns Chapter 2 Command Descriptions 93 Set service settings for Dynamic DNS (service =dyndnsorg): set ddns [ddconntype={standardhttp|alternatehttp|securehttp}] [ddsystem={dyndns|statdns|custom}] [ddusername= user name ] [ddpassword= password for DynDNS.org account] [ddhostname= full host name ] [ddwildcard={off|on|nochg}] Display current DDNS s[...]

set ddns 94 Chapter 2 Command Descriptions DynDNS.com service settings These settings are specific to your account information with DynamuiDynDNS.org; please consult thei r website for more information on account terms and settings. ddconntype={standardhttp|alternatehttp|securehttp} The method to use to connect to the DynDNS.org server: st andardht[...]

set ddns Chapter 2 Command Descriptions 95 nochg Specifies that there should be no c hange to service setting from the current selection for wildcards in the DDN S settings at the DynDNS.org Web site. Examples This example shows “set ddns” being us ed to display the cu rrent status of the Dynamic DNS service: #> set ddns DDNS Service Upd ate[...]

set dhcpserver 96 Chapter 2 Command Descriptions set dhcp server Devices supported This command is support ed in Digi Cellular Fa mily products only . Purpose Configures the DHCP serv er settings for the Di gi Connect product. A DHCP server allows other devices or hosts on the same local network as the Digi Connect product to be assi gned dynamic I[...]

set dhcpserver Chapter 2 Command Descriptions 97 Configure the DHCP server scope (“item=scope”) set dhcpserver item=scope [action={set|revert}] [enabled={on|off}] [startip= ip address ] [endip= ip address ] [leasetime={ time |infinite}] (in seconds, 0=default (86400)} [offerdelay=0-5000] (time in milliseconds, default 500} [conflictdetect={on|o[...]

set dhcpserver 98 Chapter 2 Command Descriptions enabled={on|off} Enables the DHCP server feature on th is Digi Connect product. Note that for the DHCP server to operate, the Digi C onnect product must be configured to use a static IP address. st artip= ip address The first IP address in the pool. endip= ip address The last address in t he pool. Th[...]

set dhcpserver Chapter 2 Command Descriptions 99 Options for configuring the scope's a ddress reservations (“item=reservation”) item=reservation Specifies that the DHCP server c onfiguration settings apply to the scope’s address reservati ons. You may use a reservation to create a permanent address lease a ssignment by the DHCP server. R[...]

set dhcpserver 100 Chapter 2 Command Descriptions Options for configuring the scope's a ddress exclusions (“item=exclusion”) item=exclusion Specifies that the DHCP server c onfiguration settings apply to the scope’s address exclusions . An exclusion range is a limited sequence of IP addresses within a scope, excluded from DHC P service o[...]

set dhcpserver Chapter 2 Command Descriptions 101 Examples Configure the IP address range for th e DHCP server scope and enab le it set dhcpserver it em=scope action=s et enabled=on startip=10.30.1.1 50 endip=10.30.1.199 Since the “leasetime” and “offerdelay” op tions are not specified, the default values for them are used, unless they were[...]

set dhcpserver 102 Chapter 2 Command Descriptions Display current DHCP Server settings #> set dhcpserver DHCP Server Settings: server enable d : on scope name : eth0 starting ip a ddress : 10.30.1 .190 ending ip add ress : 10.30.1 .198 lease time : 3600 (s econds) offer delay : 500 (mi lliseconds) addr conflict detect : off Reservation Set tings[...]

set dhcpserver Chapter 2 Command Descriptions 103 See also • "dhcpserver" on p age 23. • "revert" on page 61. • "show" on page 249. • In the W eb user interface, the online help for Network Settings. “Configuring DHCP Seve r Settings” provides more information on DHCP terminology and managi ng DHCP server o[...]

set ekahau 104 Chapter 2 Command Descriptions set ekahau Devices supported This command is support ed in Digi Connect Wi-SP , Digi Connect Wi-ME, and Digi Connect Wi-EM only . Purpose Configures Ekahau Client ™ device-location software in a Digi Connect wireless device. The Ekahau Client fe ature provides integrated support for Ekahau's Wi-F[...]

set ekahau Chapter 2 Command Descriptions 105 Options st ate={on|off} Enables or disables th e Ekahau Client feature. The “id,” “name,” and “server” valu es must be set before you can set “state” to “on.” id= device id A numeric identifier for t he Digi Connect device, us ed internally by the Ekahau Positioning Engine fo r devic[...]

set ekahau 106 Chapter 2 Command Descriptions Examples Set identifiers #> set ekahau id= 1 server=myepe.do main.com name=”Tr acked Device 1" Enable Ekahau Client #> set ekahau sta te=on See also • "revert" on page 61. • "show" on page 249. • For additional information, includi ng free evaluation licenses for t[...]

set ethernet Chapter 2 Command Descriptions 107 set ethernet Devices supported This command is supported in the following products: • Connect Family: Digi Connect SP , Digi Connect EM, Connect ME. • Digi Cellular Family: All Co nnect W AN products, but not ConnectPort WAN VPN. • ConnectPort Display . Purpose Configures, adjusts, and displays [...]

set ethernet 108 Chapter 2 Command Descriptions speed Configures the Ethernet speed the Digi device wi ll use on the Ethernet network. Specify an appropriate setti ng for your Ethernet network, which can be one of the following: 10 The device operates at 10 mega bits per second (Mbps) only. 100 The device operates at 100 Mbps only. auto The device [...]

set forwarding Chapter 2 Command Descriptions 109 set forwarding Devices supported This command is support ed in Digi Cellular Fa mily products only . Purpose Configures IP routing, or forwardi ng of IP datagrams, between network interfaces. IP routing must be enabled to allow the Netw ork Address T able (NA T) and port forwarding feat ures to work[...]

set forwarding 110 Chapter 2 Command Descriptions Change an existing st atic route t able entry T o change an existing static route t abl e entry , these options are required: staticrouteindex={1-8} action=change [one or more additional options] Delete a st atic route ta ble entry T o delete a static route entry , these options are required: static[...]

set forwarding Chapter 2 Command Descriptions 111 enabled={on|off} Enables or disables a st atic route table entry. on Enables an entry. All it s options must be spec ified and valid to enable an entry. The enabled entry is immediately added to the device's IP routing table. off Disables an entry. If the entry was previously enabled and added [...]

set forwarding 112 Chapter 2 Command Descriptions See also • "display" on page 27. The “display route” command displays current routing information. • "set nat" on page 146. • "revert" on page 61 • "show" on page 249. • In the online help for the W eb user interface, the topi c “IP Forwarding [...]

set gpio Chapter 2 Command Descriptions 113 set gpio Devices supported This command is supported in the following products: • Connect Family: Digi Connect EM, Di gi Connect Wi-EM, Digi Connect ME, Digi Connect Wi-ME. • Digi Cellular Family: Digi Connec t W AN, and Digi Connect RG devices. Not supported in Co nnectPort Display . Purpose Used to:[...]

set gpio 114 Chapter 2 Command Descriptions Default serial signal settings for GPIO pins The default serial signal settings for the GPIO pi ns on a Digi Connect device are as follows. Depending on the device, ther e are five or nine GPIO pins. Examples Changing the operation of the GPIO signal pins The following command changes GPIO pi ns 1-5 to al[...]

set group Chapter 2 Command Descriptions 115 set group Devices supported This command is supported in Digi Cellular Family products Digi Connect W AN and Digi Connect RG only . Purpose Used to create and manage us er groups. Y ou can use “set group” to do the following: • Add a group. A maximum of 32 groups can be defined. • Remove groups. [...]

set group 116 Chapter 2 Command Descriptions name= string Specifies the name of th e group to be acted on. newname= string Specifies a new group name. commandline={on|off} Specifies whether the users in th e group are allowed to access the command line of the device. on Users can access the co mmand line interface. off Users can not access t he com[...]

set group Chapter 2 Command Descriptions 117 Default permissions When a new group is creat ed, it has no permissions. Examples Add a new group #> set group add newname=gurus id= 4 Remove group 7 #> set group remove id=7 Set a new group name #> set group id=4 newname=gurus Set a group with command line access rights #> set group id=4 com[...]

set host 118 Chapter 2 Command Descriptions set host Device support This command is suppo rted in all products. Purpose Configures a name for the device, also known as a host name, or displays the current host na me for the device. Required permissions For Digi Connect products with two or more users, permissions must be set to “set permissions s[...]

set ia Chapter 2 Command Descriptions 119 set ia Device support This command is suppo rted in Digi Connect W AN IA, Digi Connect SP , Digi Connect Wi-SP , Digi Connect ME4, Di gi Connect Wi-ME, Digi Connect EM, Digi Connect Wi-EM. Purpose Configures selected Digi devices to support special parsing and bridging of Industrial Automation (IA) protocol[...]

set ia 120 Chapter 2 Command Descriptions implied network master encapsul ated on TCP and UDP port 2101. So by default, incoming Modbus/RTU in TCP or UDP port 2101 is enabled. • “set ia master=1 ” enables incoming M odbus/TCP masters. • “set ia master=2” enabl es incoming Modbus/UDP masters (this is Modbus/TCP format by UDP port 502). ?[...]

set ia Chapter 2 Command Descriptions 121 Configure destination t ables and route entries (set ia t able) set ia table= range [ table options ] [route= range [ route optio ns ]] [ table options ]: state={on|off} name= string addroute= route index removeroute= route inde x moveroute= from_route_ index , to_route_index [ route options ]: active={on|o[...]

set ia 122 Chapter 2 Command Descriptions t able=1..8 (applies to master only) Defines which table is used to rout e messages to t heir destination. This option applies only to master-attached devices. protocol={modbusrtu|modbusascii} The protocol being used by the serial device. The serial protocol also affects the implied in coming network master[...]

set ia Chapter 2 Command Descriptions 123 priority={high|medium|low} Normally messages are processed in a fair round-robin scheme. This becomes unfair when one master acts as many – for example opening 16 TCP sockets to talk to 16 slav es contrasted to a second master using a single TCP socket to talk to 16 slaves. In this situation, the device a[...]

set ia 124 Chapter 2 Command Descriptions [ modbus options ] The configuration options specific to the Modbus protocol, which include: errorresponse={on|off} Controls behavior for common run-time errors such as no response from the slave device. By default , “errorresponse=off” for serial Modbus protocols, sinc e most masters assume no response[...]

set ia Chapter 2 Command Descriptions 125 Options for configuring network-based ma sters (set ia master) master= range Specifies the index of the network ma ster to which the master options apply. st ate={on| off} Enables the IA network master settings. active={on|off} Enables or disables the network listener that accepts network connections. type=[...]

set ia 126 Chapter 2 Command Descriptions idletimeout={0=disab led|1-99000 seconds} The device aborts a connection after th e remote client has been idle for this time. The time is saved in second s, and the best use for this timeout is to speed up fault recovery. For example, many wide-area networks can suffer shutdowns without the Digi device det[...]

set ia Chapter 2 Command Descriptions 127 Options for configuring destination t ables and route entries (set ia t able) The destination table and routes ar e used by the incoming master connections to select whic h one of many potential sl aves a request is to be answered by . ta b l e = ran ge Selects one of eight possi ble tables in which to look[...]

set ia 128 Chapter 2 Command Descriptions type={discard|ip|ma pto|nop ath|serial} Defines the type of desti nation for this route. discard Messages destined for this route entry are discarded without error. ip Messages destined for this route entry are forwarded to the entered IP address. If you enter the IP addre ss as 0.0.0.0, the Digi device’s[...]

set ia Chapter 2 Command Descriptions 129 ipport= ip port The UDP or TCP port on which to listen for protocol messages. Modbus/ TCP defaults to TCP port 502 . This option app lies only if the route “type=ip.” replaceip={on|add|sub|off} Specifies whether and how the last octe t of the IP address is replaced. This option applies only if the route[...]

set ia 130 Chapter 2 Command Descriptions Examples Serial port configuration settings The following “set ia” commands show the default serial- port configuration settings for the Digi Connect W AN IA: set ia serial=1 a ctive=on type=sla ve protocol=modbu srtu table=1 set ia serial=1 m essagetimeout=250 0 slavetimeout=10 00 chartimeout=20 set ia[...]

set login Chapter 2 Command Descriptions 131 set login Device support This command is currentl y supported in all Digi Connect Family devices except Digi Connect ES, Ce llular Family products, and ConnectPort Display . Purpose Suppresses the user login for a Digi Connect device. Required permissions For Digi Connect products with two or more users,[...]

set menu 132 Chapter 2 Command Descriptions set menu Devices supported This command is curren tly not supported in any Digi Connect Family devices. Purpose The “set menu” command is used to crea te and modify custom menus. For example, you can use cust om menus to present a se t of actions to users, or display a limited set of commands to users[...]

set menu Chapter 2 Command Descriptions 133 quit_label= string The text displayed on the custom menu next to the “quit_key” that allows a user to quit and cl ose the custom menu. The string is a short description. If the string contains spac es, enclose it in double quotes. The default is “Quit.” previous_key= key The key and text displayed[...]

set menu 134 Chapter 2 Command Descriptions newname= string A short descriptive string used to ident ify a menu. This option is used to create a new menu or to change the name of an existing menu. When a new menu is being created, this optio n must be specified along with the “range” option. When an existing menu nam e is being changed, this op[...]

set menu Chapter 2 Command Descriptions 135 direction={horizont al|vertical} The direction in which to display a nd arrange menu items. This option only applies when the value of the “columns” option is more than 1 since a single column has no sense of direction other than vertical. horizont al The items will be displayed in order left-to-right[...]

set menu 136 Chapter 2 Command Descriptions command= string The command that is executed when this menu item is selected. This may be any valid command on the CLI (command line interface). The user accessing the custom menu mu st have the necessary permissions for the supplied command in order to properly exec ute the command. Note that this option[...]

set mgmtconnection Chapter 2 Command Descriptions 137 set mgmtconnection Devices supported This command is support ed in all products except Digi Connect ES and ConnectPort Display . Purpose Configures or displays Connectware Manager server connection settings. The Connectware Manager server allows devices to be configured and managed from remote l[...]

set mgmtconnection 138 Chapter 2 Command Descriptions on Enables this instance for use. off Disables this instance for use. timed period= period For a timed connection, this option is used to specif y the time interval in minutes between t he device server's attemp ts to connect to the Connectware Manager server. If a device se rver is already[...]

set mgmtconnection Chapter 2 Command Descriptions 139 clntreconntimeout={none| timeout } Specifies the retry timeout interval, in seconds, for a last-known-address (LKA) update, if the LKA update fails.If and LKA update fails, the interval configured by this option is used as the amount of time to wait before attempting another LKA update. This opt[...]

set mgmtglobal 140 Chapter 2 Command Descriptions set mgmtglobal Devices supported This command is support ed in all products except Digi Connect ES and ConnectPort Display . Purpose The Connectware Manager server allows devices to be configured and managed from remote locations. This command is used to set or display the Connectware Manager global[...]

set mgmtglobal Chapter 2 Command Descriptions 141 rcicompressionenabled={on|off} Configures whether RCI command and response text is compressed, when both are passed be tween the Digi devic e and the Connectware Manager server. This comp ression primarily affects the size of the data passed when settings or state info rmation are formatted as RCI a[...]

set mgmtglobal 142 Chapter 2 Command Descriptions connidletimeout={none| timeout value } Enables or disables the idle ti meout for the Connectware Manager connection between device and server . Specifying “none” disables the idle timeout. Specifying a timeout value enables the idle timeout, which means the connection will be dropped, or ended, [...]

set mgmtnetwork Chapter 2 Command Descriptions 143 set mgmtnetwork Devices supported This command is support ed in all products except Digi Connect ES and ConnectPort Display . Purpose The Connectware Manager server allows devices to be configured and managed from remote locations. T he “set mgmtnetw ork” command configures the network se tting[...]

set mgmtnetwork 144 Chapter 2 Command Descriptions connectionmethod={auto|none|mt|mdh|proxy} The Connectware Devi ce Protocol firewall traversal method. auto Automatically detect the connection method. none No firewall; connect using TCP. mt Connect using TCP. mdh Connect using HTTP. proxy Connect using HTTP over proxy. proxyaddress= string The pro[...]

set mgmtnetwork Chapter 2 Command Descriptions 145 mtwaitcount= count Used to specify the wait count wh en the connection method is “mt,” where count is how many timeouts occur before the Digi device assumes the connection to the Connectware Manager server is lost and drops the connection. mdhrxkeep alive= time Used to specify the tr ansmit kee[...]

set nat 146 Chapter 2 Command Descriptions set nat Devices supported This command is support ed in Digi Cellular Fa mily products only . Purpose Used to set or display Network Ad dress T ranslation (NA T) and port/ protocol forwarding settings. Note that at this time, the only IP prot ocols for which protocol forwarding is supported are: • Generi[...]

set nat Chapter 2 Command Descriptions 147 Options enabled={on|off} Enables or disables NAT. Note that IP forwar ding must be enabled by the “set forwarding” command for NAT to work. on Enable NAT. off Disable NAT. maxentries=64-1024 The maximum number of concurrent NAT table entries that the devi ce will support. This setting effectively limit[...]

set nat 148 Chapter 2 Command Descriptions poproto[1-64]={tcp|ud p} The IP protocol associated with this port forwarding entry. tcp A TCP port is forwarded. ud p A UDP port is forwarded. pocount=[1-64]= number of ports in range, minimum 1 The number of consecutive ports in a port-forwarding range. This option allows you to forward more than o ne po[...]

set network Chapter 2 Command Descriptions 149 set network Devices supported This command is supported in all Digi Connect products. Purpose Used to set general network configur ation options and display current network configuration op tions, including options for IP address settings, TCP keep-alives, retransmissions of TCP packet s, and ARP setti[...]

set network 150 Chapter 2 Command Descriptions Options [ ip address options ] Set IP address-related options for the Digi device, including: ip= device ip address Sets the device IP address when DHCP is off. This option is only applicable if the “s tatic” option is set to “on.” gateway= gateway ip Sets the network gateway IP address. submas[...]

set network Chapter 2 Command Descriptions 151 [ TCP keepalive options ] Are options that conf igure how TCP keep-al ive probes are sent. The keep-alive options (“idle,” “probe_c ount,” “probe_inter val”) should be configured for various se rvices that are confi gured by “set service keepalive={on|of f},” or c lients such as autocon[...]

set network 152 Chapter 2 Command Descriptions [ ARP options ] Are options that control Address Re solution Protocol (ARP) requests. arp_ttl=1-20 (minutes) The initial value of the ARP time-to- live variable, wh ich is the amount of time that an ARP entry remains in the net work ARP cache. When an ARP cache entry first populated, the ARP time-to-li[...]

set passthrough Chapter 2 Command Descriptions 153 set p assthrough Devices supported This command is support ed in Digi Cellular Fa mily products only . Purpose Configures the IP pass-th rough feature. IP p ass- thro ugh allows a Digi Cellular Family device to provide bri dging functionality simi lar to a cable or DSL modem, where t he Digi Cellul[...]

set passthrough 154 Chapter 2 Command Descriptions Using Pinholes to Manage the Digi Cellular Family Device IP pass-through uses a concept called pinholes . Y ou can configure the Digi Cellular Family device to listen on sp ecific TCP ports, and terminate those connections at the Digi Cell ular Family device for purposes of managing it. Those ports[...]

set passthrough Chapter 2 Command Descriptions 155 Using the “set service” command with IP Pass-through Y ou can use the “set service” command to have a network service terminate both at a port on the Digi Cellular Family device and a different port on the connected device. For ex ample, you could have the Digi Cellular Family device termin[...]

set passthrough 156 Chapter 2 Command Descriptions connectware={p ass|terminate} Specifies whether the Connectware Manag er application is configured to pass to the connecte d device (“pass”) or terminate at the Digi Cellular Family device for purposes of managing it, know n as a pinhole (“terminate”). The de fault is "terminate."[...]

set permissions Chapter 2 Command Descriptions 157 set permissions Devices supported This command is supported in all Digi Connect Family devices. However , the extent of its us e varies according to the us er model implemented in the Digi Connect product. For Digi Connect pr oducts with one or two users, this command does not apply . It does apply[...]

set permissions 158 Chapter 2 Command Descriptions Synt a x Set permissions set permissions [type={user|group}] {id= range |name= string } [backup={none|execute}] [boot={none|execute}] [connect={none|execute}] [display={none|execute}] [dhcpserver={none|execute}] [buffers={none|r-self|read|rw-self|w-self-r|rw}] [filesys={none|read|rw}] [kill={none|e[...]

set permissions Chapter 2 Command Descriptions 159 [who={none|execute}] [webui={none|execute} Display current permission settings set permissions Options Permission descriptions Here are the user permissions and their effect s on commands. none The command cannot be executed. execute The command can be executed. r-self The user can execute the &quo[...]

set permissions 160 Chapter 2 Command Descriptions connect={none|execute} Permissions for the “connect” co mmand. (See "connect" on page 22.) dhcp server={n one|execute} Permissions for the "dhcpserver" command. (See "dhcpserver" on page 23.) display={none|execute} Permissions for the “display” comm and. (See &[...]

set permissions Chapter 2 Command Descriptions 161 s-alarm={none|read|rw} Permissions for the “set alarm” command. (See "set al arm" on page 70.) s-autoconnect={none|r-self| read|rw-self|w-self-r|rw} Permissions for the “set autoconnec t” command. (See "set autoconnect" on page 81.) s-bsc={none|read|rw} Permissions for t[...]

set permissions 162 Chapter 2 Command Descriptions s-permissions={none|read|rw} Permissions for the “set permissions” command itself. s-pmodem={none|r-self|read |rw-self|w-self-r|rw} Permissions for the “set pmodem ” command. (See "set pmodem" on page 164.) s-ppp={none|read|rw} Permissions for the “set pppo utbound” command. ([...]

set permissions Chapter 2 Command Descriptions 163 s-user={none|read|rw} Permissions for the “set user” command. (See "set user" on page 220.) s-vpn={none|read|rw} Permissions for the “set vpn” co mmand. (See "set vpn" on page 228.) s-wlan={none|read|rw} Permissions for the “set wlan” comman d. (See "set wlan&qu[...]

set pmodem 164 Chapter 2 Command Descriptions set pmodem Devices supported This command is supported in the following products: • Connect Family: all products • Digi Cellular Family: All produc ts except Digi Connect W AN. Not supported in Co nnectPort Display . Purpose Used to configure various options fo r modem emulation over TCP/IP , and di[...]

set pmodem Chapter 2 Command Descriptions 165 telnet Enables or disables Telnet pr ocessing on incoming and outgoing modem-emulation connections. on Enables Telnet processing. off Disables Telnet processing. The default is “off.” Example #> set pmodem por t=1 state=on See also • "revert" on page 61. • "show" on page 2[...]

set pppoutbound 166 Chapter 2 Command Descriptions set pppoutbound Devices supported This command is support ed in Digi Cellular Fa mily products only . Purpose Configures Point-to-Point Protoc ol (PPP) outbound connections, or displays current PP P outbound settings. Required permissions For Digi Connect products with two or more users, to use thi[...]

set pppoutbound Chapter 2 Command Descriptions 167 Options port= range The physical interface to which the PPP outbound confi guration applies. Required. st ate={enabled|disabled} The state of the interface. The default is “disabled.” auth_method={none|P AP|CHAP|both} Determines whether authentication is required for outbound PPP connections an[...]

set pppoutbound 168 Chapter 2 Command Descriptions address_mask= ip address mask The IP mask to apply to the address specified on the “remote address” and “local address” options . When you specify a s pecific IP address on the “remote address” and “loc al address” options, th is option modifies the meaning of the IP address for rou[...]

set pppoutbound Chapter 2 Command Descriptions 169 lcp_keep alive={on|off} Specifies whether the device server sends Link Control Protocol (LCP) echo requests after a “quiet” interval, in order to test th e PPP link and/or keep it alive. “Quiet” me ans not having received any bytes over the PPP link for a specified time interval, whi ch is [...]

set pppoutbound 170 Chapter 2 Command Descriptions chap_id= chap id A character string that identifi es the outbound PPP user using CHAP authentication. This is equi valent to a user or lo gin name. The string must be 32 or fewer characters and mu st be recogniz ed by the peer. chap_key= chap key A character string that authenticates the outbound P[...]

set pppoutbound Chapter 2 Command Descriptions 171 dial_script= chat script A dialing script, used any time a num ber is dialed for the interface. For example: dial_script="'' ATDTT CONNECT c" login_script= chat script A login script, used to log in to the re mote system on the other end of the outbound PPP connection. For exa[...]

set profile 172 Chapter 2 Command Descriptions set profile Devices supported This command is support ed in all Digi Connect products. However , some port profiles are not support ed in particular devices, as noted in the “profile” option’s description. Purpose Associates a particular port with one of several port conf iguration profiles, or d[...]

set profile Chapter 2 Command Descriptions 173 Required permissions For Digi Connect products with two or more users, to use this command, permissions must be set to one of the following: • For a user to display the profile se ttings for the line on which they are logged in: “set permissi ons s-profile=r-self” • For a user to display the pr[...]

set profile 174 Chapter 2 Command Descriptions tcp_socket s Associates the TCP Sockets port profile with the port. tunneling Associates the Serial Bridge port profile wi th the port. ud p_sockets Associates the UDP Sockets port prof ile with the port. Not supported in Digi Connect W AN. custom Associates the Custom por t profile with the port. ia A[...]

set putty Chapter 2 Command Descriptions 175 set putty Devices supported This command is supported in C onnectPort Display devices only . Purpose Configures terminal-emu lation settings for Co nnectPort Display , and displays current termin al-emulation setting s. ConnectPort Display can emulate a te rminal connected to a host/server over a serial [...]

set putty 176 Chapter 2 Command Descriptions Options General terminal emulation options st ate={on| off} Enables or disables th e terminal emulator. wid th={80|132} The default width of the terminal, spec ified as the number of columns of text to display on the terminal emulator. T he default width is 80. height=10-60 The default height of the term[...]

set putty Chapter 2 Command Descriptions 177 cursortype={none|block|underline|vertical} Specifies how the cursor appears on the terminal emulator display: as a block, an underline, a vert ical line, or no cursor. none The cursor has no visible display characteristics. block The cursor is displayed as a block. underline The cursor is displayed as an[...]

set putty 178 Chapter 2 Command Descriptions characterset= host charset The character set for data received fr om the host. During a session, the terminal emulator re ceives a stream of 8-bit by tes from the server, and in order to display them on the screen it needs to know the character set in which to interpret thes e streams of bytes. There are[...]

set putty Chapter 2 Command Descriptions 179 The complete list of a llowed character sets is: Character Set name Description ISO-8859-1 ISO-8859-1:1998 (Latin- 1, West Europe) ISO-8859-2 ISO-8859-2:1999 (Latin- 2, East Europe) ISO-8859-3 ISO-8859-3:1999 (Latin- 3, South Europe) ISO-8859-4 ISO-8859-4:1998 ( Latin- 4, North Europe) ISO-8859-5 ISO- 88[...]

set putty 180 Chapter 2 Command Descriptions Key mapping terminal emulation options Character codes received from a key board can be converted to different character codes before being sent to the host. This conv ersion, known as key mapping, can be useful when you have different types of keyboards that need to be mapped to the same set of characte[...]

set putty Chapter 2 Command Descriptions 181 The keymap entries are held in a table, as are other device settings such as UDP , serial destinations, alarms, etc. When adding a new entry (an “inseq”/”outseq” p air), you specify at what index in the tabl e to add it using “keymaprange.” T o delete an entry (or range of multiple entries) y[...]

set putty 182 Chapter 2 Command Descriptions Configure general terminal emulation s ettings Given the above settings, to adjust t he screen height and cursor type, you would enter: # set putty heigh t=30 cursortype=v ertical Add, replace, and delete entries in the key mapping table T o add/replace the first 3 entries in the t able you would use the[...]

set python Chapter 2 Command Descriptions 183 set python Devices supported This command is supported in ConnectPort X products only . Purpose Configures Python programs to ex ecute when the Digi device boots. Synt a x set python [range=1–4] state={on|off} command= filename Options range=1 – 4 The index or indices to view or modify with the comm[...]

set rciserial 184 Chapter 2 Command Descriptions set rciserial Devices supported This command is supported in Connect Family and Digi Cellular Family products. Not supported in ConnectPort Display . Purpose Used to: • T urn on/of f RCI serial mode on the fi rst serial port. The RCI serial mode is a mode that allows a c onfiguration file to be loa[...]

set realport Chapter 2 Command Descriptions 185 set realport Devices supported This command is supported in all Digi Connect products. Purpose Configures and displays R ealPort-related settings. Required permissions For Digi Connect products wi th root and non-root ( normal) users, the root user can configure RealPort sett ings. The normal user can[...]

set realport 186 Chapter 2 Command Descriptions See also • "set network" on page 149. The “set network” keepalive options (“idle,” “probe_count,” “probe_i nterval,” “garbage_byte,” and “override_dhcp”) should be configured fo r various services t hat are configured by “set service keepalive={on|of f},” or cli[...]

set rtstoggle Chapter 2 Command Descriptions 187 set rt stoggle Devices supported This command is supported in the following products: • Connect Family: All products. • Digi Cellular Family: All produc ts except Digi Connect W AN. Not supported in Co nnectPort Display . Purpose Used to: • Enable or disable RTS to ggle on a given serial por t.[...]

set rtstoggle 188 Chapter 2 Command Descriptions predelay= delay Specifies the time in milliseconds to wait after the RTS signal is turned on before sending data. The r ange is 0 to 5000 millisec onds. The default is 0. post delay= delay Specifies the time in milliseconds to wait after sending data before turning off the RTS signal. The range is 0 [...]

set serial Chapter 2 Command Descriptions 189 set serial Devices supported This command is supported in all Digi Connect products. Purpose Sets and displays general serial conf iguration options, such as baud rate, character size, parity , st op bits, and flow control. Required permissions For Digi Connect products with two or more users, to use th[...]

set serial 190 Chapter 2 Command Descriptions baudrate= bps The baud rate in bits per se cond. The default is 9600. csize={5|6|7|8} The character size, which can be 5, 6, 7, or 8 bits. The defau lt is 8. flowcontrol={hardware|sof tware|none} Specifies which kind of flow control is used on the line. hardware Hardware flow control (RTS/CTS). sof twar[...]

set service Chapter 2 Command Descriptions 191 set service Devices supported This command is supported in all Digi Connect products. Purpose Used to: • Enable and disable network services. • Change the network port on which a given service listens. • Display the entire service table, or an entry in the service table. Caution on enabling and d[...]

set service 192 Chapter 2 Command Descriptions keep alive={on|off} Indicates whether or no t TCP keepalives will be sent for specified range of network services. If se t to on, keepalives will be sent, if it is off, keepalives will not be sent. Configurable TCP keepalive paramet ers, for example, how many keepalives to send and when to send them ar[...]

set service Chapter 2 Command Descriptions 193 Supported network services and their default n etwork port numbers The following table shows the netwo rk services controlled by the “set services” command, the services provided, and the default network port number for each service. In Digi Connect products that have multiple seri al ports, the ne[...]

set service 194 Chapter 2 Command Descriptions Service Services Provided Default Network Port Number Advanced Digi Discovery Protocol (ADDP), also known as Device Discovery Discovery of Digi Connect products on a ne two rk. 2362 Encrypted (Secure) RealPort Secur e Ethe rnet connections between COM or TTY ports and device servers or ter min a l serv[...]

set service Chapter 2 Command Descriptions 195 T elnet Passthrough Allows a T elnet conne ction directly to the serial port, often referred to as reverse T elnet. 2001 T ransmission Control Protocol (TCP) Passth ro ug h Allows a raw socket connecti on directly to the serial port, of ten referred to as reverse socket s. 2101 User Datagram Pro tocol [...]

set service 196 Chapter 2 Command Descriptions Index numbers and changing d efault port numbers An index number is assigned to each of these services. The index numbers assigned can vary over time. If you want to change the network port number for a service, enter a “set service” or “s how service” command to display the current index numbe[...]

set service Chapter 2 Command Descriptions 197 Examples Disable service #> set service ra nge=1 state=off Change the network port (ipport) of a serv ice #> set service ra nge=1 ipport=500 Displaying the service t able In this example, the “set service” command di splays the entire service table. #> set service Displaying an entry in th[...]

set snmp 198 Chapter 2 Command Descriptions set snmp Devices supported This command is supported in all Connect Family and Digi Cellular Family products. Not supported in ConnectPort Display . Purpose Configures the Simple Network M anagement Protocol (SNMP) agent, or displays current SNMP settings. Required permissions For Digi Connect products wi[...]

set snmp Chapter 2 Command Descriptions 199 authfailtrap={on|off} Enables or disables the sendi ng of authenticatio n failure traps. on Enables the sending of aut hentication failure traps. off Disables the sending of authentication failure traps. The default is “off.” coldst arttrap={on|off} Enables or disables the s ending of cold start traps[...]

set socket_tunnel 200 Chapter 2 Command Descriptions set socket_tunnel Devices supported This command is supported in all Digi Connect Fa mily and Digi Cellular Family products. It is not support ed in ConnectPort Display product s. Purpose Configures a socket tunnel. A socket tunnel can be used to connect two network devices: one on the Digi devic[...]

set socket_tunnel Chapter 2 Command Descriptions 201 Options st ate={disabled|enabled Enables or disables the configured socket tunnel. timeout={0| seconds }] {0 is no timeout} The timeout (specified in seconds) controls how lo ng the tunnel will remain connected when ther e is no tunnel traffic. If the timeout value is zero, then no timeout is in [...]

set surelink 202 Chapter 2 Command Descriptions set surelink Devices supported This command is support ed in Digi Cellular Fa mily products only . Purpose Configures Digi SureLink™ settings for a Digi Cell ular Family device. Digi SureLink™ provides an “a lways-on” mobile network connection to ensure that a Digi Cellular Family device is in[...]

set surelink Chapter 2 Command Descriptions 203 Set TCP connection link test p arameters: set surelink [ipaddr1={ ipv4 address | fqdn }] [ipaddr2={ ipv4 address | fqdn }] [ipport=1-65535] Display current SureLink settings set surelink Options Options for Hardware reset thresholds module_reset_connect_fai lures={1-255|0=off} The number of failed con[...]

set surelink 204 Chapter 2 Command Descriptions test={ping|tcp|dns} The Link Integrity Monito ring test to be run. Each test can be used to demonstrat e that two-way communication is working over the mobile connection. This variety of tests is provided because different mobile networks or firewalls may allow or block Internet packets for various se[...]

set surelink Chapter 2 Command Descriptions 205 dns DNS Lookup Test. This test uses a Domain Name Server (DNS ) lookup as a test to veri fy the integrity of the mobile connection. The test is successful if a valid reply is re ceived from a DNS se rver. Typically, this means the hostname is successful ly “resolved” to an IP address by a DNS serv[...]

set surelink 206 Chapter 2 Command Descriptions max_consecutive_failures={1-255, 0=o ff} (probe failures before link reset)] The maximum numb er of c onsecutive Link Integrit y Monitoring tests. After this number is reached, the mobile connection should be disconnected and reestablished. This value must be between 1 and 255. The default is 3. A val[...]

set surelink Chapter 2 Command Descriptions 207 See also • "revert" on page 61. • "show" on page 249. • The "display pppst ats" command di splays connection and activity information for PPP links, including SureLink statistics. See "SureLink S t atistics" on page 35 for descriptions of these st atistics[...]

set switches 208 Chapter 2 Command Descriptions set switches Device support This command is supported in C onnectPort TS MEI products only . Purpose Configures Multiple Electrical Interfac e (MEI) settings on a per-port basis, and displays current MEI settings. ME I settings inclu de the type of electrical interfac e (EIA-232 or EIA-485), the nu mb[...]

set switches Chapter 2 Command Descriptions 209 Options range= range The port or range of ports to which this command applies. mode={232|485} Selects the electrical interface of the serial port. The selected value determines whether the "wires" and "ter mination" options are meaningful. 232 The serial port uses electrical inte r[...]

set switches 210 Chapter 2 Command Descriptions Examples Configure st andard EIA-232 communication #> set switches p ort=1 mode=232 Configure a half-duplex EIA-485 end point #> set switches p ort=1 mode=485 wi res=two terminati on=on Configure a full-duplex 422 interior node #> set switches p ort=1 mode=485 wi res=four terminat ion=off See[...]

set system Chapter 2 Command Descriptions 211 set system Devices supported This command is supported in all Digi Connect products. Purpose Configures and displays system-identifying inform ation, such as a description of the device, its location, and a cont act person. Required permissions For Digi Connect products with two or more users, permissio[...]

set tcpserial 212 Chapter 2 Command Descriptions set tcp serial Devices supported This command is supported in all Digi Connect products. Purpose Used to set behaviors of TCP serial connections, or display current TCP serial settings. This command affect s the foll owing TCP serial connections: • Connections made using the autoconnect feature. ?[...]

set tcpserial Chapter 2 Command Descriptions 213 Options port= range Used to specify the se rial port. Optional on a single-port device. hangup dcd={on|off} Indicates whether an established net work connection should be terminated when the serial port’s DCD signal drops. The default is “off.” hangup dsr={on|off|} Indicates whether an establis[...]

set tcpserial 214 Chapter 2 Command Descriptions send time={0|1-65535ms} Indicates that data from the serial port should be sent out to the network after the given amount of time has past where no new data has arrived from the serial port. This option only is valid when the “buffered” option is “on.” A value of 0 (zer o) disables this opti [...]

set term Chapter 2 Command Descriptions 215 set term Devices supported This command is supported in al l Digi Connect products except ConnectPort Display . Purpose Allows for connecting a term inal to a device’s serial port and accessing the command line of the device. In the cases where the default access to the te rminal and the command line is[...]

set udpserial 216 Chapter 2 Command Descriptions set ud p serial Devices supported This command is support ed in all Digi Connec t products except Digi Connect W AN and C onnectPort Display . Purpose Use this command to set up the UDP seri al feature, or display current UDP serial settings. The UDP serial feat ure allows data to be sent between the[...]

set udpserial Chapter 2 Command Descriptions 217 Options Options for setting general UDP serial forwarding chara cteristics port= range Used to specify the se rial port. Optional on a single-port device. st ate={on| off} Used to enable or disabl e sending data from the se rial port to remote network destinations. The default is “off.” sendcount[...]

set udpserial 218 Chapter 2 Command Descriptions sid={on|off} Determines how the socket ID (SID) st ring in the “sidstring” option is handled; that is, whet her the string specified by the “sidstring” option is sent at the beginning of each UDP packet. on The value of “sidstring” is sent at the beginning of each UDP packet. off The valu[...]

set udpserial Chapter 2 Command Descriptions 219 ipport= ip port The UDP port of the destinati on to which data is sent. Options for displaying current UDP serial settings port= range Used to specify the se rial port. Optional on a single-port device. range=range Identifies the range of UDP de stinations to be displayed. Examples Set general UDP se[...]

set user 220 Chapter 2 Command Descriptions set user Devices supported This command is supported in all Digi Connect products. Purpose Used to: • Add users for access to a Digi C onnect device. The number of users that can be defined varies by Digi Connect dev ice. T o determine the number of users allowed fo r your Digi Connect dev ice, enter ?[...]

set user Chapter 2 Command Descriptions 221 Synt a x Add a user set user add id= number newname= string Remove a user set user remove {id= range |name= string } Associate a user with a group set user associate {id= number |name= string } {gid= number |gname= string } Disassociate a user from a group set user disassociate {id= number |name= string }[...]

set user 222 Chapter 2 Command Descriptions name= string Specifies the name of th e user to be acted on. newname= string Specifies a new user name. gid= number Specifies the identifier for the gr oup being associated with a user. If omitted, the “gname” opt ion must be specified. gname= string Specifies the name of the group being associated wi[...]

set user Chapter 2 Command Descriptions 223 default access={none|commandline|menu|group} Specifies the default access method a nd interface that a user will be given upon logging into the device. Note that the specified interface must be enabled for the user and have a valid menu and/or group if specified. none The user has no default access to the[...]

set user 224 Chapter 2 Command Descriptions public_key={ tftphost : filename| clear} Loads or clears an SSH publ ic key used for authentication of this user. The key must be an RSA publ ic key, in either Op enSSH or the IETF draft format. tftphost : filename Loads an SSH2 public key for us e with this user, where: tftphost The IP address or DNS nam[...]

set video Chapter 2 Command Descriptions 225 set video Devices supported This command is supported in ConnectPort Display only . Purpose Configures or displa ys video settings fo r ConnectPort Display . Synt a x Configure video settings set video mode={640x480@60-16|800x600@56-16|800x600@60-16| 1024x768@70-8} splash_time=0-30 seconds Display curren[...]

set vncclient 226 Chapter 2 Command Descriptions set vncclient Devices supported This command is supported in ConnectPort Display only . Purpose Configures or displays remote-access settings. Y our ConnectPort Display can provide remote access to a computer on the net work or Internet using the VNC (Virtual Networ k Computing) protocol. VNC server [...]

set vncclient Chapter 2 Command Descriptions 227 keep alive={on|off} Indicates whether or not TCP keep-aliv es will be sent while connected to the VNC server. Ke ep-alives help to detect when a connection has been lost. TCP keep-aliv e parameters (such as how often to send them) are configured globally. Example #> set vncclient state=on server=1[...]

set vpn 228 Chapter 2 Command Descriptions set vpn Devices supported This command is supported in Digi Cellular Family products only , except Digi Connect W AN. Purpose Configures Virtual Privat e Network (VPN) settings. Virtual Private Networks (VPN) are used to securely connect tw o private networks together so that devices may connect from one n[...]

set vpn Chapter 2 Command Descriptions 229 • Configure IKE/ISAKMP SA Phase 1 and Phase 2 options, which create an authenticated secure channel and specify how IKE negotiates security associations (SAs). • Display current VPN settings. Required permissions For Digi Connect products with two or more users, to use this command, permissions must be[...]

set vpn 230 Chapter 2 Command Descriptions [ isakmp optio ns ]: mode=isakmp [shared_key={ ascii key | h ex key }] T o specify proposals: s ee synt ax and options for “Set IKE/ISAKMP SA Phase 2 Options.” Set IKE/ISAKMP SA Phase 1 Options syntax: set vpn phase1 [index=1-2] [state={enabled|disabled}] [auth_method={shared_key|dss|rsa}] [authenticat[...]

set vpn Chapter 2 Command Descriptions 231 Options Global VPN options set vpn global Specifies that the “set vpn” command is for setting global VPN options. mode={main|aggressive} The method used to negotiate Intern et Key Exchange (IKE) Phase One using Internet Security Associat ion and Key Management Protocol (ISAKMP). Negotiations es tablish[...]

set vpn 232 Chapter 2 Command Descriptions identity= ip-address Identity is specified as the Digi devic e’s IP address. Using this method, you can specify either of the following: The Network Address (IPv4): A standard IP addre ss (version 4). that uses the standard IPv4 dotted format (four nu meric values between 0 and 255 separated by periods).[...]

set vpn Chapter 2 Command Descriptions 233 antireplay={on|off} Specifies whether the antireplay feature is on or off. Antireplay allows the IPsec tunnel receiver to detect an d reject packets that have been replayed. It does this by adding information to the packets exchanged between VPN endpoints, to ensure that a third par ty cannot replay the sa[...]

set vpn 234 Chapter 2 Command Descriptions remote_vpn_end point=(fqdn| ip address } The IP address or ho stname of the peer with which the VPN connection is established. remote_tunnel_addr= ip address remote_tunnel_mask= subnet mask remote_tunnel_range= ip address - ip address These options specify the routes required to access clients on the remot[...]

set vpn Chapter 2 Command Descriptions 235 inbound_authentication={none|md5|sha1} The optional authentication algor ithm, used with the associated authentication key specified by the “inbound_auth_key” option, to authorize access on the VPN tunnel fo r inbound traffic. none No authentication algorithm is used. md5 MD5 authentication algorithm ,[...]

set vpn 236 Chapter 2 Command Descriptions inbound_enc_key={ ascii key | hex key } The encryption key for inbound traffic, according to the authentication algorithm specified by the “inbound_encryption” option. The encryption key may be specified as an ASCII value using alpha- numeric characters or may be sp ecified as a hexadecimal value prefi[...]

set vpn Chapter 2 Command Descriptions 237 [ isakmp options ] T o configure an I SAKMP tunnel, you must configure the settings to match those on the remote VPN server . mode=isakmp Indicates that the se ttings are for a VPN ISAKMP tunnel. ISAKMP tunnels specify a list of proposals, or security policies, in order to negotiate a set of security setti[...]

set vpn 238 Chapter 2 Command Descriptions IKE/ISAKMP SA Phase 1 options set vpn phase1 Specifies that the “set vpn” command is for configur ing a VPN Phase 1 options. index=1-2 The index number for an existing VPN tunnel. st ate={enabled|disabled} Whether the VPN tunnel is enabled or disabled. You can use this option when creating several tunn[...]

set vpn Chapter 2 Command Descriptions 239 sa_lifetime=10-2^32 Determines how long an Security Asso ciation (SA) poli cy is active, in seconds. After the IKE SA has been negotiated, t he SA lifetime begins. Once the lifetime has completed, a new set of SA policies are negotiated using IKE phase 2 negotiation. sa_lifetime_dat a=0-2^32 The amount of [...]

set vpn 240 Chapter 2 Command Descriptions authentication={none|md5|sha1} The authentication algorithm used in authenticating clients. none No authentication. No aut hentication can be used to save time and CPU cycles. It is not as secure, but the peers were authenticated in phase 1. md5 MD5 authenti cation, wh ich uses 128-bit keys. sha1 SHA1 auth[...]

set wlan Chapter 2 Command Descriptions 241 set wlan Devices supported This command is support ed in Digi Connect Wi-ME, Digi Co nnect Wi-EM, and Digi Connect Wi-SP devices. Purpose Configures wireless device s, or displays the stat us of wireless devices. Required permissions For Digi Connect products with two or more users, permissions must be se[...]

set wlan 242 Chapter 2 Command Descriptions Authentication methods and associated data fields The following table shows the authent ication methods available for wireless devices, and the associated data fields, or command options, that apply to each method. All data fields with that hav e an X in a particular authentication method’ s column ar e[...]

set wlan Chapter 2 Command Descriptions 243 Inner and outer protocols The following table shows relationship s between outer protocols and inner protocols specified on the “set wlan” command. Outer protocols are the types of Extensible Authentication Pr otocols (EAP) that are allowed to establish the initial connection with an authentication se[...]

set wlan 244 Chapter 2 Command Descriptions Display wireless se ttings set wlan Or: show wlan Options Regarding command options “authenti cation encryption ,” “outer_eap,” “inner_eap,” and “options:” These options have multip le values. More than one value may be specified for each op tion to indicate th e set of allowed values. The[...]

set wlan Chapter 2 Command Descriptions 245 authentication= {[open],[sharekey],[wep_auth],[wp a_psk],[wp a_auth],[leap],[any]} The types of authentication that ar e allowed to esta blish a connection with the access point. open IEEE 802.11 open system authenticati on is used to establish a connection with the access point. sharedkey IEEE 802.11 sha[...]

set wlan 246 Chapter 2 Command Descriptions encryption={[open],[wep],[tkip],[ccmp],[any]} The types of encryption that are allowed to encrypt data tr ansferred over the wireless link. open No encryption is used over the wireless link. Can be used with open and sharedkey authentication. wep Wired Equivalent Priva cy (WEP) encryption is used over the[...]

set wlan Chapter 2 Command Descriptions 247 inner_eap={[gtc],[md5],[mschapv2],[otp],[chap],[mschap], [ttls_mschapv2],[p a p,[any]]} The types of protocols that are allo wed to authenticate the device. These are used within the encrypt ed connection establis hed by PEAP or TTLS. The following are Extensib le Access Protocols (E AP) that can be used [...]

set wlan 248 Chapter 2 Command Descriptions ps k = string Used when the “security” option is set to “wpa_psk.” This option specifies a string that is converted into a pre- shared key (PSK) that is used for encryption. wepmode={64bit|128bit} Specifies the key size used when WEP encryption is enabled. The default is 64bit. wepindex=1-4 Specif[...]

show Chapter 2 Command Descriptions 249 show Devices supported This command is supported in all Digi Connect products. Purpose Displays the current settings in a dev ice, including current configuration settings, boot code loaded in the device, and the effect s of commands issued to the device. Required permissions For Digi Connect products with tw[...]

show 250 Chapter 2 Command Descriptions group set group No No host set host No No ia master set ia command: settings for an IA master; see "Co nfigure network-based masters (set ia master)" on page 120. No ia serial set ia command: settings for IA serial; see "Configure seri al- port connected devices (set ia serial)" on page 12[...]

show Chapter 2 Command Descriptions 251 route The IP routing t able. This command is not associated w ith a “set” command. No No rtstoggle set rtstogg le Y es N o serial set serial Y es No service set service No Y es snmp set snmp No No socket_t unnel set socket_t unnel N o No surelink set surelink system set system N o No tcpserial set tcpseri[...]

show 252 Chapter 2 Command Descriptions port= range Identifies a particular serial port. Optional on a single-port device. range= range A configuration table ent ry or range of entries. Examples Display network configuration settings #> show network Network configura tion: MAC Address : 00:40:9D:24 :8B:B3 Currently i n use by the network stack S[...]

show Chapter 2 Command Descriptions 253 Display wireless se ttings In addition to showing the current wireless setti ngs, "show wlan" displays evaluation notes and warning messages a bout the effect an d interaction of wireless settings. As the exampl e shows, warning messages note encryption methods that have been defined but not used by[...]

status 254 Chapter 2 Command Descriptions st atus Devices supported This command is supported in all Digi Connect products. Purpose Displays the current list of sessions. The “status” command displays the status of outgoing connections (connecti ons made by “connec t,” “rlogin,” or “telnet” commands). In c ontrast, the “display”[...]

telnet Chapter 2 Command Descriptions 255 telnet Devices supported This command is supported in al l Digi Connect Family devices. Purpose Used to make an outgoing T elnet c onnection, also known as a session. Required permissions For Digi Connect products with two or more users, permissions must be set to “set permissions te lnet=execute” to us[...]

vpn 256 Chapter 2 Command Descriptions vpn Devices supported This command is supported in Digi Cellular Family products only , except Digi Connect W AN. Purpose Manages and displays the status of a V i rtual Private Netw ork (VPN) tunnel. Required permissions For Digi Connect products with two or more users, permissions must be set to “set permis[...]

vpn Chapter 2 Command Descriptions 257 Enable a VPN tunnel This command enables the t unnel at index 1 to be used. #> vpn connect in dex=1 See also • "display" on page 27. The “display sadb,” “display sp,” and “display vpn” commands display VPN-related connec tion and status information. • "revert" on page 61.[...]

who 258 Chapter 2 Command Descriptions who Devices supported This command is supported in all Digi Connect products. Purpose Displays active connections to and from the device. Required permissions For Digi Connect products with two or more users, permissions must be set to “set permissions who=execute” to use this command. See "set permis[...]

What Is Modem Emulation? Chapter 3 Modem Emulation Commands 259 This chapter describes the comm ands that can be issued when Digi Connect products are configur ed in modem emulation mode. What Is Modem Emulation? Modem emulation enable s a system administrat or to configure a networked Digi device to act as a modem. The Digi device emulates modem r[...]

Common User Scenarios for Modem Emulation 260 Chapter 3 Modem Emulation Commands Common User Scenarios for Mod e m Emulation The Digi device in modem emulation mode allows fo r the easy replacement of modems in almost any environm ent where there is a LAN or W AN. In Diagram A, t he Digi Connect device replac es a modem connected to a workstation r[...]

Common User Scenarios for Modem Emulation Chapter 3 Modem Emulation Commands 261 In Diagram B, two Digi devices will replace modems on both sides of the connection. The initiation of the connection occurs wit h either of the Digi devices. If both ends are Digi devic es, the TCP listeni ng port number is 50001 for port 1. An example of the conne cti[...]

Connection Scenarios for Modem Emulation 262 Chapter 3 Modem Emulation Commands Connection Scenarios for Modem Emulation Modem emulation can involve the fo llowing types of connection scenarios: Outgoing Modem Emul ation Connection In an outgoing modem emul ation connection, a seri al device sends an AT D x.x.x.x:y command, which triggers the Digi [...]

About the Commands in this Chapter Chapter 3 Modem Emulation Commands 263 About the Commands in this Chapter This chapter describes the Digi-specific modem emulation commands that have been implemented for Digi Connect devi ces. It is divided into several sections: • The A T command set. These are co mmands to perform actions in a modem-emulation[...]

Modem Emulation AT Command Set 264 Chapter 3 Modem Emulation Commands Modem Emulation A T Command Set The following commands can be issued to perform acti ons in a modem- emulation configuration scenario. AT Command Function Result Code n +++ n When in data mo de, this command causes the mod em to switch to command mode. The value of n correspo nds[...]

Modem Emulation AT Command Set Chapter 3 Modem Emulation Commands 265 AT O Return to on-line dat a mode. If the modem is in the on-line comma nd mode, the modem enters the on -line data mode . If the modem is in the off-line command mode (no connection) , ERROR is reported. • O0, O1: If there is an active conn ection, switches the modem t o data [...]

Modem Emulation AT Command Set 266 Chapter 3 Modem Emulation Commands AT & V Displays current values and settings. • A T&V0- A T&V5: Displays S-Registe r/c om ma nd valu es for the cur rent and stored configur ation. • A T&V6: Displays current network settings. OK n=0 to 5 ERROR Otherwise AT & W n S tore configuration. S tor[...]

S-Register Definitions Chapter 3 Modem Emulation Commands 267 S-Register Definitions Following is a description of the S-regist ers that can be set. Register Function Range Unit s Default S0 Rings to Auto-Answer . Sets the number of rings requir ed before the Digi device automati ca lly answers a call. Setting this regi ster to Zero disables auto-a[...]

S-Register Definitions 268 Chapter 3 Modem Emulation Commands S21 General Options S tatus . Indicates the status of command options. • Default: 52 (34h) (001 10100b) • Bits 0 - 2: Igno red. • Bits 3-4: DT E’s DTR behavior (&D n ): 0 = DTR drop is ignored (&D0). 1 = DTR drop causes a transition from dat a to command mode without ha n[...]

Result Codes Chapter 3 Modem Emulation Commands 269 Result Codes Following is a descript ion of the return c odes returned by modem emulation commands. Short Long Form Short Long Form Sh ort Long Form 0O K 13 CONNECT 7200 84 CONNECT 33600 1C O N N E C T 14 CONNECT 12000 91 CONNECT 31200 2R I N G 15 CONNECT 14400 165 CONNECT 32000 3 NO CARRIER 16 CO[...]

Result Codes 270 Chapter 3 Modem Emulation Commands[...]

Index 271 ? command 40 100% CPU utilization 28 232 electric al interface 209 2-wire mode 209 485 electric al interface 209 4-wire mode 209 A abbreviating commands 12 abort output signal 67 access control 68 newpass command 51 set user 220 status information 27 access permissions for commands 14 add line feed characters 50 Advanced Digi Discovery Pr[...]

272 Index CPU utilization 28 , 42 CTS GPIO pin for 11 3 hardware f low control 190 Custom port profile 17 2 D DCD altpin field (swapping DCD with DSR) 189 GPIO pin for 11 3 hangupdcd field 213 DDNS (Dynamic DNS) service 92 default configuration file names 18 default valu es filenames fo r devi ce configurations 18 reverting to 61 device alarms 70 d[...]

Index 273 status of signals 27 Generic Routing Encap sulation (GRE) protocol 146 go ahead signal 67 GPIO. See General Purpose I/O GRE See Generic Routing Encapsulatio n protocol GT C 243 H half-duplex connection 209 hardware f low control 190 help command description 40 hexadecimal numbers in strings 13 horizont al tab characte r 13 Hypertext Trans[...]

274 Index enabling and disa bling 191 new-line character 13 newpass command description 51 enabling login prompt 14 setting permissions for 160 no option signal 67 none user permission 159 O octal bytes in strin gs 13 odd pa r ity 190 online help 12 , 40 operating system updates 19 OTP 243 overflow e rrors 45 overrun errors 45 P PA P 243 P AP authe[...]

Index 275 r-self user permission 15 9 RTS GPIO pin for 11 3 in hardware flow contro l (RTS/CTS) 190 RTS t og gl e 187 rw user p ermission 159 rw-self user per mis sion 159 S Secure Shell (SSH) 194 Secure Socket Service 194 Secure Sockets Layer (SSL) 212 security changing user passwor ds 51 Connectware Device Protocol device secur i ty settings 96 p[...]

276 Index set mgmtglobal command description 140 displaying curren t set tin gs 140 , 250 reverting se ttings 63 setting permissions for 161 set mgmtnetwork command description 143 displaying curren t set tin gs 143 , 250 reverting se ttings 63 setting permissions for 161 set nat command description 146 displaying curren t set tin gs 146 , 250 reve[...]

Index 277 reverting se ttings 65 setting permissions for 163 show command description 249 displaying Indust ria l Automation settings 12 1 displaying number of users defined 14 sigchange 45 Simple Network Management Protocol (SNMP) "get" commands 198 "set" commands 198 configuring 198 enabling and disa bling 191 enabling/disa bl[...]

278 Index V vertical t ab character 13 video settings 225 VNC (Virtua l Network Computing) protocol set vncclient command 226 VNC client configuration 191 VNC Client Listen Daemon 195 VNC server configuration 191 , 195 vpn command description 256 setting permissions for 163 W Web user interface access setting permissions for 163 who command descrip[...]