Digi Technical Support: Digi offers multiple technical support plans and service packages to help our customers get the most out of their Digi product. For information on Technical Support plans and pricing, contact us at 877.912.3444 or visit us at www.digi.com/support.
Contents TransPort LR User Guide TransPort LR Family User Guide Hardware TransPort LR54 hardware Hardware summary Hardware specifications Serial connector pinout LEDs Antenna information Regulatory and safety statements Certifications Management and status Interfaces Ethernet interfaces Cellular interfaces DSL interface Wi-Fi interfaces Serial interfaces Local Area Networks (LANs) Example LAN...
Page 4
Show WAN status and statistics Security User management Firewalls Alarms Services and applications Auto-run commands Python SSH server Remote management Remote Manager Simple Network Management Protocol (SNMP) Routing IP routing Virtual Private Networks (VPN) System administration and management Display and set system information settings Set system date and time Show system date and time Updating firmware...
Page 5
Clear the event log Use the "ping" command to troubleshoot network connections Use the "traceroute" command to diagnose IP routing problems Reboot the device Reset the device to factory defaults Digi support site Digi knowledge base Need more help? Command reference Command-line interface basics...
Page 6
mkdir more ping reboot rename rmdir route save serial show cellular show cloud show config show dsl show eth show failover show firewall show ipsec show ipstats show lan show log show route show serial show system show wan show wifi show wifi5g snmp snmp-community...
Dual SIM cellular interfaces, providing redundancy Gobi 4G LTE, for flexibility Local command-line and web interfaces Superior network performance management through Digi Remote Manager (DRM) What other features do we want to cover here? Easy device setup through a wizard? Programmability?
Hardware This section provides hardware specifications, reviews key hardware features, and lists regulatory statements and certifications for TLR Family products. TransPort LR User Guide...
Hardware summary Figures, callouts, and descriptions of TLR Family models to be added here. Hardware specifications TransPort LR devices have the following hardware specifications: Environmental specifications Specification Value -20C to +70C (-4 to 158F)* Operating temperature *Note: To limit unintentional contact with HOT SURFACES, install the device in a Restricted Access Location above +60C.
Page 10
TransPort LR54 hardware Specification Value 4-pin Molex 39301040 connector (Digi part number 2312-0012), or equivalent. Power Two pins are used for power; the other two pins are no-connect. connector Dimensions Specification Value Width 20.7 cm (8.15 in) Depth 13.85 cm (5.45 in) Height 3.8 cm (1.5 in)
Page 11
TransPort LR54 hardware Cellular specifications Model Specification Value TransPort LR54-AA401 Technology LTE, HSPA+, TransPort LR54-AW401 UMTS Downstream rates 300 Mbps (LTE), 42 Mbps (HSPA+) Upstream rates 50 Mbps (LTE), 5.76 Mbps (HSPA+) LTE: 800, 850, Frequency Bands 900, 1800, 1900,...
Page 12
TransPort LR54 hardware DSL specifications Specification Value DSL ports 1 RJ11 DSL port Auto (also known as Multimode) ADSL line modes ADSL2+ ADSL2 G.dmt G.lite Serial specifications Specification Value 1 DB9 RS232 DCE serial port, female Serial ports Wi-Fi specifications Specification Value 802.11 a/b/g/n/ac connections, dual band, dual concurrent...
TransPort LR54 hardware Serial connector pinout TransPort LR54 products are DCE devices. The pinout for the DB9 and RJ45 serial connectors is as follows: RS232 DCE signal DB9 pin RJ45 pin Signal name signal direction number number Transmit Data Receive Data Ready To Send Clear to Send Data Set Ready...
If the WWAN Signal LED is yellow or off, try the following things to improve signal strength: Move the TransPort LR device to another location. Purchase a Digi Antenna Extender Kit: Antenna Extender Kit, 1m (76000954) Antenna Extender Kit, 3m (76000955) 3G ...
Page 15
TransPort LR54 hardware Off: No service. Blinking Green: 2G/3G/4G connection is coming up. Solid Yellow: 2G or 3G connection is up. Solid Green: 4G connection is up. SIM 1 Indicates use of the SIM card installed in SIM slot 1. Off: SIM 1 is not being used. Solid green: SIM 1 is being used or is coming up.
Page 16
TransPort LR54 hardware Off: No Ethernet link detected. Solid green: Ethernet link detected. Blinking green: Indicates Ethernet traffic. TransPort LR User Guide...
FCC ID. Modifications (FCC 15.21) Changes or modifications to this equipment not expressly approved by Digi may void the user’s authority to operate this equipment.
EN 300 386 v1.6.1 (2012-09) EN 61000-4-11:2004 RoHS2: EN 50581:2012 Minnesota, USA, , April 2016 (Place and date of issue) Authorised signature for and on behalf of Digi International Inc. Joel Young,VP,Engineering European Andreas Burghart Representative Digi International GmbH Lise-Meitner-...
Page 19
TransPort LR54 hardware 5.10 Ignition of Flammable Atmospheres Warnings for Use of Wireless Devices Observe all warning notices regarding use of wireless devices. Potentially Hazardous Atmospheres Observe restrictions on the use of radio devices in fuel depots, chemical plants, etc. and areas where the air contains chemicals or particles, such as grain, dust, or metal powders, and any other area where you would normally be advised to turn off your vehicle engine.
Certifications International EMC (Electromagnetic Compatibility) and safety standards This product complies with the requirements of following Electromagnetic Compatibility standards. There are no user-serviceable parts inside the product. Contact your Digi representative through for repair information. Electromagnetic Compatibility (EMC) compliance standards Safety compliance standards EN 300 328 v1.8.1...
Interfaces Interfaces Configurable network interfaces available depend on the TransPort LR device model. This section covers configuring network interfaces from the web interface and command line. TransPort LR User Guide...
Interfaces Ethernet interfaces The Ethernet interfaces can be used as WAN or LAN interfaces. There is no IP configuration set on the individual Ethernet interfaces. Instead, the IP configuration is done on the WAN and LAN interfaces. Related topics Configure Ethernet interfaces on page 28 Show Ethernet status and statistics on page 29 For more information on WAN interfaces and their configuration, see Wide Area Networks (WANs) on...
Page 24
186 command. For descriptions of the output fields, see show dsl on page 182. For example: digi.router> show eth Eth Status and Statistics Port 1 ------------------------------------- Description : Factory default configuration for Ethernet 1 Admin Status...
Page 25
Interfaces Description Admin Status : Up Oper Status : Up Up Time : 1 Day, 13 Hours, 30 Minutes, 23 Seconds MAC Address : 00:50:18:21:E2:83 DHCP : off IP Address : 10.2.4.20 Netmask : 255.255.255.0 DNS Server(s) Link : 100Base-T Full-Duplex Received Sent --------...
Page 26
Tx Collision Event Rx Alignment Error Rx Undersize Error Rx Fragment Error Rx Oversize Error Rx Jabber Error digi.router> Related topics Ethernet interfaces on page 28 Configure Ethernet interfaces on page 28 Related commands eth on page 156 show eth on page 186...
Interfaces Cellular interfaces The TransPort LR device has two cellular interfaces, named cellular1 and cellular2. These cellular interfaces correspond to the physical SIM card slots SIM1 and SIM2 respectively. Both cellular interfaces cannot be up at the same time. If both cellular interfaces are enabled to on, then cellular1 interface takes precedence.
Page 28
To show the status and statistics for a cellular interface, use the show lan on page 195 command. For a description of the output fields, see the show cellular command. digi.router> show cellular Cellular Status and Statistics TransPort LR User Guide...
Page 29
Received Sent -------- ---- Packets Bytes digi.router> Related topics Configure cellular interfaces on page 32 Show cellular status and statistics on page 33 LEDs on page 16 - See the discussion of the WWAN Signal and WWAN Service LEDs Related commands...
Interfaces DSL interface These topics describe configuring and managing the DSL interface. Related topics Configure DSL on page 35 Show DSL status and statistics on page 37 Related commands dsl on page 153 show dsl on page 182 Configure DSL To configure the DSL interface to connect to your DSL network, you need to configure the following: Required configuration items Enable the DSL interface.
Page 31
Interfaces From the command line 1. Enable the DSL interface. By default, the DSL interface is disabled. To enable it, enter: dsl state on 2. Configure VPI and VCI: dsl vpi <vpi-number> dsl vci <vci-number> 3. Configure encapsulation: dsl encapsulation <encapsulation> 4.
Page 32
To show the status and statistics for the DSL interface, use the show dsl on page 182 command. For descriptions of the output fields, see show dsl on page 182. For example: digi.router> show dsl DSL Status and Statistics ------------------------- Description Admin Status : Up...
Page 33
Interfaces Errored Seconds after Line Up : 1 digi.router> Related topics DSL interface on page 35 Configure DSL on page 35 Related commands dsl on page 153 show dsl on page 182 TransPort LR User Guide...
Interfaces Wi-Fi interfaces Wi-Fi-enabled TransPort LR devices support up to 4 Wi-Fi interfaces on each of the 2.4 GHz and 5 GHz frequency bands. Each Wi-Fi interface can be configured as an independent Wi-Fi Access Point with its own security settings. Related topics Configure a Wi-Fi access point on page 39 Configure a Wi-Fi access point with WPA2-Enterprise or WPA-WPA2-Enterprise security on page 41...
Page 35
Interfaces WPA2-Enterprise: This security method is designed for enterprise networks and requires a RADIUS authentication server. This security method requires a more complicated setup, but provides additional security. Various kinds of the Extensible Authentication Protocol (EAP) are used for authentication. WPA/WPA2-Enterprise: This security method is designed for enterprise networks and requires a RADIUS authentication server.
Page 36
Interfaces Configure a Wi-Fi access point with WPA2-Enterprise or WPA-WPA2-Enterprise security The WPA2-Enterprise and WPA-WPA2-Enterprise security modes allow a Wi-Fi Access Point to authenticate connecting Wi-Fi clients using a RADIUS server. When the Wi-Fi Access Point receives an connection request from a Wi-Fi client, it will authenticate the client with the RADIUS server before allowing the client to connect.
Page 37
203 Show Wi-Fi status and statistics To show the status and statistics for a Wi-Fi 2.4 GHz interface, use the show wifi on page 202 command. For example: digi.router> show wifi Interface Status SSID Security ------------------------------------------------------------- wifi1...
Page 38
Interfaces wifi5g2 digi.route_5g_LR000051 None wifi5g3 digi.route_5g WPA2-Personal wifi5g4 Down WPA2-Personal digi.router> Related topics Wi-Fi interfaces on page 39 Configure a Wi-Fi access point on page 39 Configure a Wi-Fi access point with WPA2-Enterprise or WPA-WPA2-Enterprise security on page 41 Related commands...
Local Area Networks (LANs) Local Area Networks (LANs) A Local Area Network (LAN) connects networks together, such as Ethernet, DSL, or Wi-Fi, in a logical Layer-2 network. Networks filter traffic between different segments, thereby reducing the amount of traffic on a LAN, even with many LAN segments. You can configure up to 10 LANs.
Local Area Networks (LANs) Configure a LAN Configuring a Local Area Network (LAN) involves configuring the following items: Required configuration items Identifying which interfaces are in the LAN. Enabling the LAN. LANs are disabled by default. Setting an IPv4 address and subnet mask for the LAN. While it is not strictly necessary for a LAN to have an IP address, if you want to send traffic from other networks to the LAN, you must configure an IP address.
For example, here is show lan output before and after enabling lan1. For a description of the output fields, see the show lan on page 195 command. digi.router> show lan 1 LAN 1 Status and Statistics --------------------------- Admin Status : Up...
Local Area Networks (LANs) DHCP servers The DHCP server feature can be enabled in a TransPort LR device to assign IP addresses and other IP configuration to other hosts on the same local network. Addresses are assigned from a specified pool of IP addresses. For a local network, the device will use the DHCP server that has the IP address pool in the same IP subnet as the local network.
Page 43
Local Area Networks (LANs) 4. Enter the network mask: dhcp-server 1 netmask 255.255.225.0 5. Enter the IP gateway address given to clients: dhcp-server 1 gateway 10.30.1.1 6. Enter the preferred DNS server address given to clients: dhcp-server 1 dns1 10.30.1.1 7. Enter the alternate DNS server address given to clients: dhcp-server 1 dns2 209.183.48.11 8.
Wide Area Networks (WANs) Wide Area Networks (WANs) A Wide Area Network (WAN) interface can be an Ethernet, DSL, or cellular interface that connects to a remote network, such as the internet. Ethernet interfaces Ethernet interfaces can be used as a WAN interface when connecting to a remote network, such as the internet, through a device such as a cable or DSL modem.
Wide Area Networks (WANs) WAN failover If a WAN interface fails for any reason, the TransPort LR device automatically fails over from one WAN interface to use another. For example, if you use an Ethernet interface as your main WAN interface, and have a cellular interface configured as a backup WAN interface, if the Ethernet interface was to fail (for example, if the Ethernet cable is broken), the TransPort LR device automatically starts to use the cellular interface until the Ethernet interface becomes active again.
Wide Area Networks (WANs) Configure a WAN interface You can configure up to 10 WAN interfaces. wan1 is the top priority, wan2 is the second priority, and so on. The TransPort LR device automatically adds a default IP route for the WAN interface when it comes up.
Page 47
Wide Area Networks (WANs) From the command line Configure basic WAN settings 1. Assign an interface to the WAN interface. wan 1 interface eth1 2. Optional: Disable DHCP client mode. wan 1 dhcp-client off 3. Optional: Configure the IP address, mask, gateway and DNS servers. wan 1 ip-address 10.1.2.2 wan 1 mask 255.255.255.252 wan 1 gateway 10.1.2.1...
Page 48
Wide Area Networks (WANs) 6. Optional: Configure the time in, seconds, after which the WAN interface must receive all IP probe responses before reactivating the WAN interface. wan 1 activate-after 30 7. Optional: Configure the time in seconds after which to attempt to bring up the WAN interface. wan 1 try-after 1200 Related topics Wide Area Networks (WANs) on page 52...
Wide Area Networks (WANs) Example WAN failover: DSL to cellular In this example, WAN, the dsl interface is the primary WAN. cellular1 and cellular2 interfaces serve as backups to dsl. IP probing is configured over the DSL interface. A probe packet of size 256 bytes is sent every 10 seconds to the IP host 43.66.93.111.
201 command. Here is here is the show wan on page 201 command output when no WANs are configured: digi.router> show wan # WAN Interface Status IP Address ----------------------------------- digi.router> Here is the show wan on page 201 command output with eth2 and cellular1 configured as WAN interfaces, where eth2 is upand cellular1 is down.
Security Security TransPort LR devices have several device security features. This section covers the configuring security settings from the web interface and command line. TransPort LR User Guide...
Security User management User management involves configuring and managing TransPort LR device users, including their authentication credentials and access permissions. Related topics Users and user access permissions on page 61 Configure a user on page 62 Related commands user on page 212 Users and user access permissions To manage TransPort LR devices via the command-line interface or web interface, users must log in using a configured username and password.
Security Access level Permissions allowed super The user can manage all features on TransPort LR devices. Devices can have multiple users with super access level. A user with super access level is required to be present on a device, to allow editing user access levels.
Page 54
Security 2. Configure the password. For example: user 1 password omnivers1031 3. Optional: Configure the access level. For example: user 1 access read-write Related topics Users and user access permissions on page 61 Delete a user on page 63 Related commands user on page 212 Delete a user To delete a user:...
The Digi Remote Manager servers also provide a data storage facility. Using Digi Remote Manager requires setting up a Digi Remote Manager account. To set up a Digi Remote Manager account and learn more about Digi Remote Manager, go to http://www.digi.com/products/cloud/digi-remote-manager.
Standard SNMP MIBs An enterprise-specific MIB, specific to the LR54, named transport-lr54.mib. This MIB is available for download from Digi Support. Note SNMPv1 cannot be used with the Enterprise MIB, owing to the COUNTER64 types used in the MIB.
Page 58
Remote management snmp v2c on 2. If using SNMPv1/v2c communities, configure a name for each community. For example: snmp-community 1 community public 3. The community access level defaults to read-only. To set the access level to read-write, enter: snmp-community 1 access read-write Related topics Simple Network Management Protocol (SNMP) on page 73 Configure SNMPv3 on page 74...
Page 59
Remote management 5. Set the privacy type for the SNMPv3 user (none, aes, or des): snmp-user 1 authentication des 6. Set the privacy password for the SNMPv3 user. The password length can be between 8 and 64 characters. snmp-user 1 privacy-password privpassword 7.
Routing IP routing The TransPort LR device uses IP routes to decide where to send a packet that it receives for a remote network. The process for deciding on a route to send the packet is as follows: 1. The device examines the destination IP address in the IP packet, and looks through the IP routing table to find a match for it.
Page 61
Routing Configure general IP settings Configuring general IP settings is one of the building blocks of setting up IP routing. Optional configuration settings The IP hostname. This hostname identifies the TLR device on IP networks. It is an unqualified hostname. The default setting for the device isLR54-%s which expands to LR54-<serial number>.
Page 62
Routing Configure a static route A static route is a manually configured routing entry. Information about the route is manually entered rather than obtained from dynamic routing traffic. TransPort LR devices supports up to 32 static routes. Will this be the same across all product models or will we need multiple statements for multiple models? Required configuration settings Setting the destination network and mask.
Page 63
Routing Once the static route is configured, it should be shown in the IPv4 routing table. Related topics IP routing on page 77 Configure general IP settings on page 78 Show the IPv4 routing table on page 81 Delete a static route on page 82 Related commands ip on page 161 route on page 175...
Page 64
Routing Show the IPv4 routing table To display the IPv4 routing table, use the show route on page 197 command. digi.router> show route Destination Gateway Metric Protocol Interface Status -------------------------------------------------------------------------------------- 10.1.2.0/24 192.168.1.254 1 Static lan1 192.168.1.0/24 0.0.0.0 Connected lan1 default 0.0.0.0...
Page 65
Routing Delete a static route To remove a static route from the routing table, clear the destination network configuration. From the command line Enter the route on page 175 command, specifying the interface number, the destination parameter and ! to revert the settings for the route destination. For example: route 1 destination ! Related topics IP routing on page 77...
Routing Virtual Private Networks (VPN) Virtual Private Networks (VPNs) are used to securely connect two private networks together so that devices can connect from one network to the other network using secure channels. These topics cover the various network protocols involved in VPNs, and configuring VPNs from the web interface and command line.
Page 67
Routing IPsec IPsec is a suite of protocols for creating a secure communication link, or IPsec tunnel, between a host and a remote IP network or between two IP networks across a public network such as the internet. TransPort LR devices support to up 32 IPsec tunnels. IPsec data protection IPsec protects the data being sent across a public network by providing the following: Data origin authentication...
Page 68
Routing Aggressive mode is faster than main mode, but is not as secure as main mode, because the device and its peer exchange their IDs and hash information in clear text instead of being encrypted. Aggressive mode is usually used when one or both of the devices have a dynamic external IP address.
Page 69
Routing AES – 128 bits AES – 192 bits AES – 256 bits The default value is AES – 128 bits. The Encapsulating Security Payload (ESP) Diffie-Hellman group for the IPsec tunnel.This setting must match the Diffie-Hellman group configured on the remote device. The Diffie- Hellman group options are: None Group 5 (1536 bits)
Page 70
Routing The default is AES – 128 bits. You can select more than one encryption protocol. IKE negotiates with the remote device which encryption protocol to use. This setting does not need to match the IKE encryption protocols configured on the remote device, but at least one of the encryption protocols must be configured on the remote device.
Page 71
Routing A randomizing factor for the number of seconds or bytes margin before the IPsec tunnel is renegotiated. This defaults to 100% and does not need to match the setting on the remote device. This setting would be used if the device has a number of IPsec tunnels configured to ensure that the IPsec tunnels are not renegotiated at the same time which could put excessive load on the device.
Page 72
Routing 5. Enter the pre-shared key. ipsec 1 psk “secret-psk” 6. Enter the IPsec authentication, encryption, and Diffie-Hellman settings. ipsec 1 esp-authentication sha256 ipsec 1 esp-encryption aes256 ipsec 1 esp-diffie-hellman none 7. Enter the IKE authentication, encryption, and Diffie-Hellman settings. ipsec 1 ike-authentication sha1,sha256 ipsec 1 ike-encryption aes128,aes192,aes256 ipsec 1 ike-diffie-hellman group14,group15...
Page 73
Routing TransPort LR54 configuration TransPort WR44 configuration digi.router> lan 1 # Link to TransPort LR54 eth 0 IPaddr "10.0.0.44" state eth 0 ipsec 1 description IPsec local net 1500 # IPsec local network interfaces eth2,eth3,eth4 eth 1 IPaddr "192.168.44.1" ip-address 192.168.54.1...
Page 74
Outbound ESP SA : 0x9E1325F2 Inbound ESP SA : 0x757935D6 Bytes In Bytes Out digi.router> Related topics IPsec on page 84 IPSec tunnel failover on page 91 Configure an IPSec tunnel on page 85 Example: IPsec tunnel between a TransPort LR54 and TransPort WR44 on page 89...
207 command. 1. Enable SNTP. sntp state on 2. Optional: Set the SNTP server. For example, to set the server to time.digi.com: sntp server time.digi.com 3. Optional: Set the SNTP update interval. sntp update-interval 10 Set the date and time manually...
Page 76
System administration and management date 14:55:00 03:05:2016 Related topics Show system date and time on page 98 Related commands date on page 149 sntp on page 207 TransPort LR User Guide...
Show system date and time From the command line To display the current system date and time, use the date on page 149 command. digi.router> date system time: 14:55:06, 03 May 2016 digi.router> Related topics Set system date and time on page 96...
Page 78
System administration and management Use multiple configuration files to test the configuration on remote devices on page 107 Related commands save on page 176 show system on page 199 TransPort LR User Guide...
System administration and management Use multiple configuration files to test the configuration on remote devices You can use multiple configuration files, along with the autorun on page 141 command, to test a new configuration on a remote device that might result in the remote device going offline, in which case the device cannot be remotely accessed.
Make a directory To make a new directory in the TLR filesystem, use the mkdir on page 168 command, specifying the name of the directory. For example: digi.router> mkdir test digi.router> dir File Size Last Modified ------------------------------------------------------- test Directory config.da0 Sun Mar 5 12:36:20 config.fac...
Display directory contents To display directory contents, use the dir on page 152 command. For example: digi.router> dir File Size Last Modified --------------------------------------------------------- test Directory config.da0 Sun Mar 5 12:36:20 config.fac Mon Feb 21 03:00:17 Remaining User Space: 102,457,344 bytes digi.router>...
Last Modified --------------------------------------------------------- test Directory config.da0 Sun Mar 5 12:36:20 config.fac Mon Feb 21 03:00:17 Remaining User Space: 102,457,344 bytes digi.router> digi.router> cd test digi.router> dir File Size Last Modified --------------------------------------------------------- Remaining User Space: 102,457,344 bytes digi.router> TransPort LR User Guide...
Last Modified --------------------------------------------------------- test Directory config.da0 Sun Mar 5 12:36:20 config.fac Mon Feb 21 03:00:17 Remaining User Space: 102,457,344 bytes digi.router> digi.router> rmdir test Directory test is not empty ERROR digi.router> digi.router> dir test File Size Last Modified --------------------------------------------------------- config.tst...
To display the contents of a file, use the more on page 169 command, specifying the name of the file. For example: digi.router> more config.da0 # Last updated by username on Thu Nov 19 14:26:02 2015 eth 1 ip-address "192.168.1.1" cellular 1 apn "mobile.o2.co.uk"...
Last Modified --------------------------------------------------------- test Directory config.da0 Sun Mar 5 12:36:20 config.fac Mon Feb 21 03:00:17 Remaining User Space: 102,457,344 bytes digi.router> digi.router> digi.router> copy config.da0 backup.da0 digi.router> digi.router> dir File Size Last Modified --------------------------------------------------------- test Directory config.da0 Sun Mar 5 12:36:20 config.fac...
Directory test.da0 Wed Apr 5 07:22:29 config.da0 Sun Mar 5 12:36:20 config.fac Mon Feb 21 03:00:17 Remaining User Space: 102,453,248 bytes digi.router> digi.router> del test.da0 digi.router> digi.router> dir test File Size Last Modified --------------------------------------------------------- test.cfg Wed Apr 5 07:24:45 Remaining User Space: 102,453,248 bytes digi.router>...
Upload and download files Upload and download files You can download and upload files from and to a TLR device, using utilities such as Secure Copy (SCP), SSH File Transfer Protocol (SFTP), or an SFTP application such as FileZilla. Upload files using SCP To upload a file to a TLR device using SCP, the syntax is as follows: scp filename username@ ip_address :filename This example uploads a file named script.py to TLR device 192.168.1.1:...
Page 89
Upload and download files config.da0 100% 0.3KB/s 00:00 sftp> exit TransPort LR User Guide...
Command reference These topics describe the command-line interface for TransPort LR devices and the commands entered through the command-line interface. TransPort LR User Guide...
Command-line interface basics digi.router> dsl mode ? Syntax : dsl 1 mode <value> Description : DSL line mode Current Value : auto Valid Values : auto, adsl2-plus, adsl2, gdmt, glite Default value : auto digi.router> dsl mode Revert command elements using the ! character Entering ! reverts an individual command element to its factory default.
Temperature : Not available Description Location Contact digi.router> Change the configuration file name 1. Change the name of the configuration file to be used at boot-up and when the configuration is saved. update config <filename> 2. If the new configuration file does not exist, enter the...
Command descriptions Command descriptions Following are the TLR Family command-line interface commands. Commands are organized by command type, in alphabetical order. TransPort LR User Guide...
Command descriptions autorun Configures commands to be automatically run at boot-up. Auto-run commands can be used for tasks such as starting a Python program, switching configuration files, or scheduling a reboot. You can configure up to 10 auto-run commands. Syntax autorun <1 - 10>...
Page 95
Command descriptions Changes the current directory. Syntax cd [dir] Parameters When a directory name is specified, 'cd' changes the current directory to it. TransPort LR User Guide...
Command descriptions cellular Configures a cellular interface. Syntax cellular <1 - 2> <parameter> <value> Parameters state Enables or disables the cellular interface, or enables it as an on-demand interface. The 'on-demand' setting allows configuring the cellular interface as an on-demand interface. An on-demand interface is brought up as needed if a higher priority goes down.
Page 97
Command descriptions cellular 1 state off Disable the Cellular 1 interface. cellular 1 state on-demand Disable Cellular 1 interface until the failover task brings it up. cellular 2 apn broadband Set the SIM slot 2 APN to 'broadband.' cellular 1 username my-username Set the SIM slot 1 username to 'my-username.' cellular 1 password my-password Set the SIM slot 1 password to 'my-password.'...
Command descriptions clear Clears system status and statistics, such as the event log, firewall counters, etc. This command is available to super users only. Syntax clear firewall | log Parameters firewall Clears firewall counters. Clears the event log. Examples clear firewall Clear the packet and byte counters in all firewall rules.
Value should be a fully qualified domain name. The default value is my.devicecloud.com. reconnect The time, in seconds, between the device's attempts to connect to Digi Remote Manager. Accepted value is any integer from 0 to 3600. The default value is 30.
Command descriptions copy Copies a file. This command is available to all users. Syntax copy source dest Parameters source The source file to be copied to the location specified by 'dest.' dest The destination file, or file to which the source file is copied. TransPort LR User Guide...
Command descriptions date Manually sets and displays the system date and time. Syntax date [HH:MM:SS [DD:MM:YYYY]] Parameters time System time, specified in the 24-hour format HH:MM:SS. date System date, specified in the format DD:MM:YYYY. Examples date 14:55:00 03:05:2016 Set the system date and time to 14:55:00 on May 3, 2016. TransPort LR User Guide...
Command descriptions Deletes a file. This command is available to all users. Syntax del file Parameters file The file to be deleted. TransPort LR User Guide...
Command descriptions dhcp-server Configures Dynamic Host Configuration Protocol (DHCP) server settings. Syntax dhcp-server <1 - 10> <parameter> <value> Parameters state Enables or disables this DHCP server. Value is either on or off. The default value is off. ip-address-start The first IP address in the pool of addresses to assign. Value should be an IPv4 address.
Command descriptions Displays the contents of the current directory. Syntax dir [file] Parameters file Lists information about the file (by default, the current directory). TransPort LR User Guide...
Command descriptions Configures the DSL interface and account information. This group is only supported in LR54, LR54W, LR54D and LR54DWC1 products. Syntax dsl <parameter> <value> Parameters state Enables or disables the DSL interface, or enables it as an on-demand interface. The 'on-demand' setting allows configuring the DSL interface as an on-demand interface.
Page 107
Command descriptions Maximum Transmission Unit (MTU) for this DSL interface. Accepted value is any integer from 128 to 1500. The default value is 1500. delay-up Delays the DSL interface from coming up for this number of seconds. This delay allows the DSL provider network to propagate network changes after the device has connected to the network, and before packets can be sent and received.
Page 108
Command descriptions dsl state off Disable DSL interface. dsl state on-demand Disable DSL interface until the failover task brings it up. TransPort LR User Guide...
Command descriptions Configures an Ethernet interface. Syntax eth <1 - 4> <parameter> <value> Parameters state Enables or disables the Ethernet interface, or enables it as an on-demand interface. The 'on-demand' setting allows configuring the Ethernet interface as an on-demand interface. An on-demand interface is brought up as needed if a higher priority goes down.
Page 110
Command descriptions eth 3 state on-demand Disable Ethernet interface 3 until the failover task brings it up. TransPort LR User Guide...
Command descriptions firewall Configures the firewall. This command is available to super users only. Syntax firewall rule Parameters rule Firewall rule TransPort LR User Guide...
Command descriptions failover Configures WAN failover settings. Syntax failover <1 - 10> <parameter> <value> Parameters state Enables or disables this WAN failover configuration. Value is either on or off. The default value is off. from The WAN interface to failover from. Also known as the primary WAN interface. Accepted values can be one of none, lan1, lan2, lan3, lan4, lan5, lan6, lan7, lan8, lan9, lan10, dsl, cellular1 or cellular2.
Page 113
Command descriptions alternate-after The time, in seconds, to wait before sending probe packets to an alternate probe when the primary probe fails. Accepted value is any integer from 0 to 3600. The default value is 0. alternate-probe-host When alternate-after is non-zero, this IPv4 address is used as an alternate address when probes fail on the host configured device.
Page 114
Command descriptions Configures Internet Protocol (IP) settings. Syntax ip <parameter> <value> Parameters admin-conn Administrative distance value for connected routes. Administrative distance values rank route types from most to least preferred. If there are two routes to the same destination that have the same mask, the device uses a route's 'metric' parameter value to determine which route to use.
Command descriptions ipsec Configures an IPsec tunnel. Up to 32 IPsec tunnels can be configured. Syntax ipsec <1 - 32> <parameter> <value> Parameters state Enables or disables the IPsec tunnel, or enables it as an on-demand interface. The 'on-demand' setting allows configuring the IPsec tunnel as an on-demand interface. An on-demand interface is brought up as needed if a higher priority goes down.
Page 116
Command descriptions esp-diffie-hellman The Encapsulating Security Payload (ESP) Diffie Hellman group used for for the IPsec tunnel. Accepted values can be multiple values of none, group5, group14, group15, group16, group17 and group18. The default value is group14. auth-by The authentication type for the IPsec tunnel. Accepted values can be multiple values of psk.
Page 117
Command descriptions The Internet Key Exchange (IKE) version to use for this IPsec tunnel. Accepted value is any integer from 1 to 2. The default value is 1. ike-mode The IKEv1 mode to use for this IPsec tunnel. Accepted values can be one of main or aggressive. The default value is main. ike-encryption The IKE encryption type for this IPsec tunnel.
Page 118
Command descriptions Examples ipsec 3 state on Enable IPsec tunnel 3. ipsec 3 state off Disable IPsec tunnel 3. ipsec 3 state on-demand Disable IPsec tunnel 3 until the failover task brings it up. ipsec 3 esp-authentication sha256 Set ESP authentication for IPsec tunnel 3 to SHA256. ipsec 3 esp-encryption aes256 Set ESP encryption for IPsec tunnel 3 to AES 256 bit keys.
Command descriptions ipsec-failover Configures IPsec tunnel failover. Syntax ipsec-failover <1 - 10> <parameter> <value> Parameters state Enables or disables the IPsec failover feature. Value is either on or off. The default value is off. from The IPsec tunnel to failover from. Also known as the primary IPsec tunnel. Accepted value is any integer from 1 to 32.
Command descriptions Configures a LAN interface. A LAN interface is a group of Ethernet and Wi-Fi interfaces. Syntax lan <1 - 10> <parameter> <value> Parameters state Enables or disables a LAN interface. Value is either on or off. The default value is off. description A descriptive name for the LAN.
Command descriptions mkdir Creates a directory. This command is available to all users. Syntax mkdir dir Parameters The directory to be created. TransPort LR User Guide...
Command descriptions ping Sends ICMP echo (ping) packets to the specified destination address. Syntax ping [count n] [interface ifname] [size bytes] destination Parameters count Number of pings to send. interface The interface from which pings are sent. size The number of data bytes to send. destination The name of the IP host to ping.
Command descriptions reboot Reboots the device immediately or at a scheduled time. Performing a reboot will not automatically save any configuration changes since the configuration was last saved. This command is available to all users. Syntax reboot [[in M][at HH:MM][cancel]] Parameters For a scheduled reboot, the minutes before the device is rebooted.
Command descriptions rename Renames a file. This command is available to all users. Syntax rename oldName newName Parameters oldName Old file name. newName New file name. TransPort LR User Guide...
Command descriptions rmdir Deletes a directory. This command is available to all users. Syntax rmdir dir Parameters The directory to be removed. TransPort LR User Guide...
Command descriptions route Configures a static route, a manually-configured entry in the routing table. Syntax route <1 - 32> <parameter> <value> Parameters destination The destination IP network for the static route. Value should be an IPv4 address. mask The destination IP netmask for the static route. Value should be an IPv4 address.
Command descriptions save Saves the configuration to flash memory. Unless you issue this command, all configuration changes since the configuration was last saved are discarded after a reboot. This command is available to all users. Syntax save config Parameters config Saves all configuration to flash memory.
Command descriptions serial Configures a serial interface. Syntax serial <1 - 4> <parameter> <value> Parameters state Enables or disables the serial interface. Value is either on or off. The default value is on. description A description of the serial interface. Accepted value is any string up to 63 characters.
Command descriptions show cellular Displays cellular interface status and statistics. Parameters description A description of the cellular interface. module Manufacturer's model number for the cellular modem. firmware-version Manufacturer's version number for the software running on the cellular modem. hardware-version Manufacturer's version number for the cellular modem hardware. imei International Mobile Station Equipment Identity (IMEI) number for the cellular modem, a unique number assigned to every mobile device.
Page 132
Command descriptions channel The radio channel on which the cellular modem is operating. pdp-context The current Packet Data Protocol (PDP) connection context. A PDP context contains routing information for packet transfer between a mobile station (MS) and a gateway GPRS support node (GGSN) to have access to an external packet-switching network.
The URL of the connected Digi Remote Manager. deviceid Device ID for Digi Remote Manager connection. uptime Amount of time, in seconds, that the Digi Remote Manager connection has been established. rx-bytes Number of bytes received from Digi Remote Manager. rx-packets Number of packets received from Digi Remote Manager.
Command descriptions show config Displays the current device configuration. Parameters config The current configuration running on the device. TransPort LR User Guide...
Command descriptions show dsl Displays the DSL interface status and statistics. This group is only supported in LR54, LR54W, LR54D and LR54DWC1 products. Parameters description Description of the DSL interface. admin-status Whether the DSL interface is sufficiently configured to be brought up. oper-status Whether the DSL interface is up or down.
Page 136
Command descriptions Maximum Transmission Unit (MTU) for the DSL interface. remote-vendor-id The remote vendor ID of the DSLAM to which the DSL interface is connected. ip-address IP address of the DSL interface. mask Address mask of the DSL interface. gateway Gateway address of the DSL interface.
Page 137
Command descriptions upstream-relative-capacity The current relative capacity on the upstream DSL channel. downstream-attentuation The current attenuation, in decibels, on the downstream DSL channel. Attenuation is the measure of how much the signal has degraded between the DSLAM and the DSL modem. The lower the attenuation, the better the performance.
Page 138
Command descriptions errored-secs-15min The number of errored seconds in a 15-minute period. An errored second is an interval of a second during which any error whatsoever has occurred, regardless of whether that error was a single bit error, or a complete loss of communication for that entire second. errored-secs-24hr The number of errored seconds in a 24-hour period.
Command descriptions show eth Displays Ethernet interfaces status and statistics. Parameters description A description of the Ethernet interface. admin-status Whether the Ethernet interface is sufficiently configured to be brought up. oper-status Whether the Ethernet interface is up or down. uptime Amount of time the Ethernet interface has been up.
Page 140
Command descriptions tx-multicast-packets The number of multicast packets transmitted on the Ethernet interface. rx-crc-errors The number of received packets that do not contain the proper cyclic redundancy check (CRC), or checksum value. tx-crc-errors The number of transmitted packets that do not contain the proper cyclic redundancy check (CRC), or checksum value.
Page 141
Command descriptions rx-jabber-error The number of packets that are greater than 1518 bytes and have a bad CRC. If a transceiver does not halt transmission after 1518 bytes, it is considered to be a jabbering transceiver. TransPort LR User Guide...
Command descriptions show failover Displays WAN failover status and statistics. Parameters description Failover status and state. status Status of the WAN failover feature. primary-interface The primary WAN interface. primary-interface-status Status of the primary WAN interface. secondary-interface The secondary WAN interface. secondary-interface-status Status of the secondary WAN interface.
Command descriptions show firewall Displays the firewall status and statistics. Parameters config The current firewall running on the device. TransPort LR User Guide...
Command descriptions show ipsec Displays IPsec tunnel status and statistics. Parameters description A description for this IPsec tunnel. admin-status Whether this IPsec tunnel is sufficiently configured to be brought up. oper-status Whether this IPsec tunnel is up or down. uptime Amount of time, in seconds, this IPsec tunnel has been up.
Page 145
Command descriptions renegotiating-in Renegotiating in. outbound-esp-sa Outbound ESP Security Association (SA). inbound-esp-sa Inbound ESP Security Association (SA). rx-bytes Number of bytes received over the IPsec tunnel. tx-bytes Number of bytes transmitted over the IPsec tunnel. TransPort LR User Guide...
Command descriptions show ipstats Displays system-level Internet Protocol (IP) status and statistics. Parameters rx-bytes Number of bytes received. rx-packets Number of packets received. rx-multicast-packets Number of multicast packets received. rx-multicast-bytes Number of multicast bytes received. rx-broadcast-packets Number of broadcast packets received. rx-forward-datagrams Number of forwarded packets received.
Page 147
Command descriptions rx-unknown-protos Number of received packets where the protocol is unknown. rx-truncated-packets Number of received packets where the data was truncated. tx-bytes Number of bytes transmitted. tx-packets Number of packets transmitted. tx-multicast-packets Number of multicast packets transmitted. tx-multicast-bytes Number of multicast bytes transmitted. tx-broadcast-packets Number of broadcast packets transmitted.
Command descriptions show lan Displays LAN interface status and statistics. Parameters admin-status Whether the LAN interface is sufficiently configured to be brought up. oper-status Whether the LAN interface is up or down. description Description of the LAN interface. interfaces The interfaces connected by the LAN. Maximum Transmission Unit for the LAN.
Command descriptions show route Displays all IP routes in the IPv4 routing table. Parameters destination Destination of the route. gateway The gateway for the route. metric The metric assigned to the route. protocol The protocol for the route. The index number for the route. interface The interface for the route.
Command descriptions show serial Displays serial interface status and statistics. Parameters description A description of the serial interface. admin-status Whether the serial interface is sufficiently configured to be brought up. oper-status Whether the serial interface is up or down. uptime Amount of time the serial interface has been up.
Command descriptions show system Displays system status and statistics. Parameters model The model name for the device. part-number The part number for the device. serial-number The serial number for the device. hardware-version The hardware version for the device. bank The current firmware flash memory bank in use. firmware-version The current firmware version running on the device.
Page 153
Command descriptions cpu-avg Average CPU usage. temperature The current temperature of the device. description Description for this device. location Location details for this device. contact Contact information for this device. TransPort LR User Guide...
Command descriptions show wan Displays WAN interface status and statistics. Parameters oper-status Whether the WAN interface is up or down. interface The interface assigned to the WAN. ip-address IP address for the WAN. TransPort LR User Guide...
Command descriptions show wifi Displays status and statistics for a Wi-Fi 2.4 GHz interface. This group is only supported in LR54, LR54W, LR54D and LR54DWC1 products. Parameters interface The name of the Wi-Fi 2.4 GHz interface. oper-status Whether the Wi-Fi 2.4 GHz interface is up or down. ssid Service Set Identifier (SSID) for the Wi-Fi 2.4 GHz interface.
Command descriptions show wifi5g Displays status and statistics for a Wi-Fi 5 GHz interface. This group is only supported in LR54, LR54W, LR54D and LR54DWC1 products. Parameters interface The name of the Wi-Fi 5 GHz interface. oper-status Whether the Wi-Fi 5 GHz interface is up or down. ssid Service Set Identifier (SSID) for the Wi-Fi 5 GHz interface.
Command descriptions snmp Configures Simple Network Management Protocol (SNMP) management for this device. Syntax snmp <parameter> <value> Parameters Enables or disables SNMPv1 support. Value is either on or off. The default value is off. Enables or disables SNMPv2c support. Value is either on or off. The default value is off. Enables or disables SNMPv3 support.
Command descriptions snmp-community Configures SNMPv1 and SNMPv2c communities. Syntax snmp-community <1 - 10> <parameter> <value> Parameters community SNMPv1 or SNMPv2c community name. This element is available to all users. Accepted value is any string up to 128 characters. access SNMPv1 or SNMPv2c community access level. Accepted values can be one of read-only or read-write.
Command descriptions snmp-user Configures SNMPv3 users. Syntax snmp-user <1 - 10> <parameter> <value> Parameters user SNMPv3 user name. Accepted value is any string up to 32 characters. authentication SNMPv3 authentication type. Accepted values can be one of none, md5 or sha1. The default value is none. privacy SNMPv3 privacy type.
Command descriptions sntp Configures system date and time using Simple Network Time Protocol (SNTP). SNTP continually polls an external NTP time server on either a private company network or the internet at a configured interval rate. Syntax sntp <parameter> <value> Parameters state Enables or disables SNTP to set the system date and time.
Command descriptions Configures Secure Shell (SSH) server settings. Syntax ssh <parameter> <value> Parameters server Enables or disables the SSH server. Value is either on or off. The default value is on. port The port number for the SSH Server. Accepted value is any integer from 1 to 65535. The default value is 22. TransPort LR User Guide...
'%s' in the SSID. For example, an 'prompt' parameter value of 'LR54_%s' resolves to 'LR54_LR123456.' Accepted value is any string up to 16 characters. The default value is digi.router>. timeout The time, in seconds, after which the command-line interface times out if there is no activity.
Page 163
Command descriptions description A description of this device. Accepted value is any string up to 255 characters. passthrough The TCP port used for passthrough. The value 0 disables passthrough mode. A reboot is required for changes to this setting to take effect. Accepted value is any integer from 0 to 65535.
Command descriptions update Performs system updates, such as firmware updates, setting the cellular carrier, and setting the configuration file used at bootup and when saving configuration. Firmware update options include specifying the device firmware, the cellular module firmware, and the DSL modem firmware to load onto the device.
Command descriptions user Configures users and user access privileges. Syntax user <1 - 10> <parameter> <value> Parameters name The username for the user. Accepted value is any string up to 32 characters. password The password for the user. This element is available to all users. Accepted value is any string up to 128 characters.
Command descriptions Configures WAN interface settings. A WAN interface can be an Ethernet, DSL, or cellular interface that connects to a remote network, such as the internet. Syntax wan <1 - 10> <parameter> <value> Parameters interface The WAN interface to configure. Accepted values can be one of none, eth1, eth2, eth3, eth4, dsl, cellular1 or cellular2.
Page 167
Command descriptions activate-after The time, in seconds, that the primary interface needs to be up before switching back to it as the active interface. If probing is active, no probes are permitted to be lost during this period. Otherwise, the timer is restarted. Accepted value is any integer from 0 to 3600.
Command descriptions wifi Configures a Wi-Fi 2.4 GHz interface. This group is only supported in LR54, LR54W, LR54D and LR54DWC1 products. Syntax wifi <1 - 4> <parameter> <value> Parameters state Enables or disables the Wi-Fi 2.4 GHz interface, or enables it as an on-demand interface. The 'on- demand' setting allows configuring the cellular interface as an on-demand interface.
Command descriptions wifi5g Configures a Wi-Fi 5 GHz interface. This group is only supported in LR54, LR54W, LR54D and LR54DWC1 products. Syntax wifi5g <1 - 4> <parameter> <value> Parameters state Enables or disables the Wi-Fi 5 GHz interface, or enables it as an on-demand interface. The 'on- demand' setting allows configuring the cellular interface as an on-demand interface.
Need help?
Do you have a question about the TransPort LR54-AA401 and is the answer not in the manual?
Questions and answers