Instruction/ maintenance manual of the product 90000566_H Digi
Go to page of 278
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.
© 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 Co.
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......... ....................
4 Cont ents set ethernet.............. ................................. ............................... .......... 107 set forwarding .......... ................................................................ .......... 109 set gpio ................
Contents 5 who ............... .............................................. ............... .............. .......... 258 Chapter 3 Modem Emulation Commands What Is Modem Emulation? .. .................................................. .......... 259 Modem Emulation Cabl e Signals .
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 .
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.
Quick Reference for Configuring Features Chapter 1 Introduction 9 IP Forwarding and Network Address T ranslation (NA T) "set forwarding" on pa ge 109.
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.
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.
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.
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.
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.
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.
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.
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 .
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 .
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.
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.
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.
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 DH.
dhcpserver 24 Chapter 2 Command Descriptions Example Display DHCP server st atus #> dhcpserver status Device Networking Status: IP address : 10.30.1.
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:.
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.
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.
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.
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).
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.
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.
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.
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.
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.
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.
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.
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).
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.
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.
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.
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.
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.
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 .
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.
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.
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.
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.
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.
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).
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.
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.
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.
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 n.
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.
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.
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.
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.
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.
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 .
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.
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.
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.
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.
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.
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 .
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.
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.
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 |.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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 .
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.
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.
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.
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.
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}] [baudrat.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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 .
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.
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.
set dhcpserver Chapter 2 Command Descriptions 103 See also • "dhcpserver" on p age 23. • "revert" on page 61. • "show" on page 249.
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.
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.
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.
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.
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.
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.
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} a.
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.
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.
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.
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.
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.
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.
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 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.
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.
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 ]: sta.
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.
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.
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.
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.
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.
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 .
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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 .
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.
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.
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.
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.
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.
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.
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 disp.
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.
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,” “pro.
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.
set passthrough Chapter 2 Command Descriptions 153 set p assthrough Devices supported This command is support ed in Digi Cellular Fa mily products only .
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.
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.
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”).
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.
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|.
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.
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.
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.
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.
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.
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 .
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.
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.
set pppoutbound Chapter 2 Command Descriptions 167 Options port= range The physical interface to which the PPP outbound confi guration applies. Required.
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 .
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.
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.
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.
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.
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 us.
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.
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.
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.
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.
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.
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:19.
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.
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.
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.
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.
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.
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.
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,” “garb.
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 .
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.
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.
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.
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.
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.
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.
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.
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.
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.
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 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.
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.
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.
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.
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.
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 curr.
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.
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.
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.
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.
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.
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.
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 or.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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 .
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.
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.
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.
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 .
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.
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.
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.
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).
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 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).
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.
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.
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.
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.
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 .
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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).
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.
vpn 256 Chapter 2 Command Descriptions vpn Devices supported This command is supported in Digi Cellular Family products only , except Digi Connect W AN.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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).
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.
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 cont.
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 (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.
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 byt.
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 Sec.
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.
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 Net.
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 confi.
An important point after buying a device Digi 90000566_H (or even before the purchase) is to read its user manual. We should do this for several simple reasons:
If you have not bought Digi 90000566_H yet, this is a good time to familiarize yourself with the basic data on the product. First of all view first pages of the manual, you can find above. You should find there the most important technical data Digi 90000566_H - thus you can check whether the hardware meets your expectations. When delving into next pages of the user manual, Digi 90000566_H you will learn all the available features of the product, as well as information on its operation. The information that you get Digi 90000566_H will certainly help you make a decision on the purchase.
If you already are a holder of Digi 90000566_H, but have not read the manual yet, you should do it for the reasons described above. You will learn then if you properly used the available features, and whether you have not made any mistakes, which can shorten the lifetime Digi 90000566_H.
However, one of the most important roles played by the user manual is to help in solving problems with Digi 90000566_H. Almost always you will find there Troubleshooting, which are the most frequently occurring failures and malfunctions of the device Digi 90000566_H along with tips on how to solve them. Even if you fail to solve the problem, the manual will show you a further procedure – contact to the customer service center or the nearest service center
