RUT950 Manual v1 41
RUT950 Manual v1 41
1
Legal notice
Copyright © 2015 TELTONIKA Ltd. All rights reserved. Reproduction, transfer, distribution or storage of part
or all of the contents in this document in any form without the prior written permission of TELTONIKA Ltd is
prohibited. The manufacturer reserves the right to modify the product and manual for the purpose of technical
improvement without prior notice.
Other product and company names mentioned herein may be trademarks or trade names of their respective
owners.
Attention
Before using the device we strongly recommend reading this user manual first.
Do not rip open the device. Do not touch the device if the device block is broken.
All wireless devices for data transferring may be susceptible to interference, which could
affect performance.
2
Table of Contents
Legal notice.............................................................................................................................................................. 2
Attention.................................................................................................................................................................. 2
SAFETY INFORMATION ............................................................................................................................................ 8
Device connection ............................................................................................................................................... 9
1 Introduction ................................................................................................................................................. 10
2 Specifications ............................................................................................................................................... 10
2.1 Ethernet ................................................................................................................................................... 10
2.2 Wi-Fi ......................................................................................................................................................... 10
2.3 Hardware ................................................................................................................................................. 10
2.4 Electrical, Mechanical & Environmental .................................................................................................. 10
2.5 Applications ............................................................................................................................................. 11
3 Setting up your router ................................................................................................................................. 12
3.1 Installation ............................................................................................................................................... 12
3.1.1 Front Panel and Back Panel ............................................................................................................. 12
3.1.2 Connection status LED indication .................................................................................................... 13
3.1.3 Hardware installation ...................................................................................................................... 14
3.2 Logging in ................................................................................................................................................. 15
4 Operation Modes ......................................................................................................................................... 18
5 Powering Options ........................................................................................................................................ 18
5.1 Powering the device from higher voltage................................................................................................ 19
6 Status ........................................................................................................................................................... 20
6.1 Overview .................................................................................................................................................. 20
6.2 System Information ................................................................................................................................. 21
6.3 Network Information ............................................................................................................................... 22
6.4 Device information .................................................................................................................................. 31
6.5 Services .................................................................................................................................................... 32
6.6 Routes ...................................................................................................................................................... 33
6.6.1 ARP ................................................................................................................................................... 33
6.6.2 Active IP-Routes ............................................................................................................................... 33
6.6.3 Active IPv6-Routes ........................................................................................................................... 33
6.7 Graphs ...................................................................................................................................................... 35
6.7.1 Mobile Signal Strength ..................................................................................................................... 35
6.7.2 Realtime Load .................................................................................................................................. 35
3
6.7.3 Realtime Traffic ................................................................................................................................ 36
6.7.4 Realtime Wireless ............................................................................................................................ 38
6.7.5 Realtime Connections ...................................................................................................................... 39
6.8 Mobile Traffic ........................................................................................................................................... 40
6.9 Events Log ................................................................................................................................................ 41
6.9.1 All Events.......................................................................................................................................... 41
6.9.2 System Events .................................................................................................................................. 42
6.9.3 Network Events ................................................................................................................................ 43
6.9.4 Events Reporting .............................................................................................................................. 44
6.9.5 Reporting Configuration .................................................................................................................. 45
7 Network ....................................................................................................................................................... 48
7.1 Mobile ...................................................................................................................................................... 48
7.1.1 General............................................................................................................................................. 48
7.1.2 SIM Management ............................................................................................................................ 51
7.1.3 Network Operators .......................................................................................................................... 52
7.1.4 Mobile Data Limit............................................................................................................................. 53
7.1.5 SIM Idle protection .......................................................................................................................... 54
7.2 WAN ......................................................................................................................................................... 55
7.2.1 Operation Mode .............................................................................................................................. 55
7.2.2 Common configuration .................................................................................................................... 56
7.3 LAN ........................................................................................................................................................... 62
7.3.1 Configuration ................................................................................................................................... 62
7.3.2 DHCP Server ..................................................................................................................................... 63
7.4 Wireless ................................................................................................................................................... 66
7.4.1 Wireless Access Point ...................................................................................................................... 66
7.4.2 Wireless Station ............................................................................................................................... 70
7.5 VLAN......................................................................................................................................................... 72
7.5.1 VLAN Networks ................................................................................................................................ 72
7.5.2 LAN Networks .................................................................................................................................. 73
7.6 Firewall..................................................................................................................................................... 74
7.6.1 General Settings ............................................................................................................................... 74
7.6.2 DMZ.................................................................................................................................................. 75
7.6.3 Port Forwarding ............................................................................................................................... 75
7.6.4 Traffic Rules...................................................................................................................................... 77
7.6.5 Custom Rules ................................................................................................................................... 81
4
7.6.6 DDOS Prevention ............................................................................................................................. 81
7.6.7 Port Scan Prevention ....................................................................................................................... 84
7.7. Routing ................................................................................................................................................. 85
7.7.1. Static Routes .................................................................................................................................... 85
7.7.2. Dynamic Routes ............................................................................................................................... 86
7.8 Load Balancing ......................................................................................................................................... 92
7.9. IPv6 ...................................................................................................................................................... 93
7.9.1 Enabling IPv6 .................................................................................................................................... 93
8 Remote monitoring and administration ...................................................................................................... 95
8.1. Basic SSH/CLI/Telnet commands ......................................................................................................... 97
8.1.1 Login via SSH/CLI .............................................................................................................................. 97
8.1.2 Configuring the router ................................................................................................................... 100
8.1.3 UCI commands ............................................................................................................................... 102
9 Services ...................................................................................................................................................... 103
9.8 VRRP ....................................................................................................................................................... 103
9.8.1 VRRP LAN Configuration Settings .................................................................................................. 103
9.8.2 Check Internet connection............................................................................................................. 103
9.9 TR-069 .................................................................................................................................................... 104
9.9.1 TR-069 Parameters Configuration ................................................................................................. 104
9.10 Web filter ........................................................................................................................................... 104
9.10.1 Site blocking .................................................................................................................................. 104
9.10.2 Proxy Based Content Blocker ........................................................................................................ 105
9.11 NTP ..................................................................................................................................................... 106
9.12 VPN .................................................................................................................................................... 106
9.12.1 OpenVPN ....................................................................................................................................... 106
9.12.2 IPSec .............................................................................................................................................. 109
9.12.3 GRE Tunnel .................................................................................................................................... 112
9.12.4 PPTP ............................................................................................................................................... 114
9.12.5 L2TP ............................................................................................................................................... 115
9.13 Dynamic DNS...................................................................................................................................... 115
9.14 SMS Utilities ....................................................................................................................................... 117
9.14.1 SMS Utilities................................................................................................................................... 117
9.14.2 Call Utilities .................................................................................................................................... 123
9.14.3 User Groups ................................................................................................................................... 124
9.14.4 SMS Management ......................................................................................................................... 125
5
9.14.5 Remote Configuration ................................................................................................................... 126
9.14.6 Statistics......................................................................................................................................... 129
9.15 SNMP ................................................................................................................................................. 129
9.15.1 SNMP Settings ............................................................................................................................... 130
9.15.2 TRAP Settings................................................................................................................................. 131
9.16 SMS Gateway ..................................................................................................................................... 131
9.16.1 Post/Get Configuration ................................................................................................................. 131
9.16.2 Email to SMS .................................................................................................................................. 134
9.16.3 Scheduled Messages ..................................................................................................................... 134
9.16.4 Auto Reply Configuration .............................................................................................................. 135
9.16.5 SMS Forwarding............................................................................................................................. 136
9.16.6 SMPP.............................................................................................................................................. 138
9.17 Hotspot .............................................................................................................................................. 139
9.17.1 General settings............................................................................................................................. 139
9.17.2 Internet Access Restriction Settings .............................................................................................. 141
9.17.3 Logging........................................................................................................................................... 141
9.17.4 Landing Page.................................................................................................................................. 143
9.17.5 Radius server configuration........................................................................................................... 144
9.17.6 Statistics......................................................................................................................................... 145
9.18 CLI....................................................................................................................................................... 145
9.19 Auto Reboot ....................................................................................................................................... 146
9.19.1 Ping Reboot ................................................................................................................................... 146
9.19.2 Periodic Reboot ............................................................................................................................. 147
9.20 UPNP .................................................................................................................................................. 147
9.20.1 General Settings ............................................................................................................................ 147
9.20.2 Advanced Settings ......................................................................................................................... 147
9.20.3 UPnP ACLs...................................................................................................................................... 148
9.20.4 Active UPnP Redirects ................................................................................................................... 148
9.21 QoS ..................................................................................................................................................... 149
9.22 MQTT ................................................................................................................................................. 150
9.23 Modbus TCP interface........................................................................................................................ 155
10 System........................................................................................................................................................ 156
10.8 Setup Wizard...................................................................................................................................... 156
10.9 Profiles ............................................................................................................................................... 158
10.10 Administration ................................................................................................................................... 159
6
10.10.1 General ........................................................................................................................................ 159
10.10.2 Troubleshoot ............................................................................................................................... 160
10.10.3 Backup ......................................................................................................................................... 161
10.10.4 Diagnostics................................................................................................................................... 163
10.10.5 MAC Clone ................................................................................................................................... 164
10.10.6 Overview...................................................................................................................................... 164
10.10.7 Monitoring ................................................................................................................................... 165
10.11 User scripts ........................................................................................................................................ 165
10.12 Restore point ..................................................................................................................................... 166
10.12.1 Restore point create .................................................................................................................... 166
10.12.2 Restore point load ....................................................................................................................... 166
10.13 Firmware ............................................................................................................................................ 167
10.13.1 Firmware ..................................................................................................................................... 167
10.13.2 FOTA ............................................................................................................................................ 168
10.14 Reboot................................................................................................................................................ 168
11 Device Recovery ......................................................................................................................................... 169
11.8 Reset button ...................................................................................................................................... 169
11.9 Bootloader’s WebUI........................................................................................................................... 169
12 Glossary...................................................................................................................................................... 170
13 Changelog .................................................................................................................................................. 172
7
SAFETY INFORMATION
In this document you will be introduced on how to use a RUT950 router safely. We suggest you to adhere to the
following recommendations in order to avoid personal injuries and or property damage.
You have to be familiar with the safety requirements before using the device!
To avoid burning and voltage caused traumas, of the personnel working with the device, please follow these
safety requirements.
The device is intended for supply from a Limited Power Source (LPS) that power consumption should
not exceed 15VA and current rating of over current protective device should not exceed 2A.
The highest transient over voltage in the output (secondary circuit) of used PSU shall not exceed 36V
peak.
The device can be used with the Personal Computer (first safety class) or Notebook (second safety
class). Associated equipment: PSU (power supply unit) (LPS) and personal computer (PC) shall
comply with the requirements of standard EN 60950-1.
Protection in primary circuits of associated PC and PSU (LPS) against short circuits and earth faults of
associated PC shall be provided as part of the building installation.
To avoid mechanical damages to the device it is recommended to transport it packed in a damage-proof pack.
While using the device, it should be placed so, that its indicating LEDs would be visible as they inform in which working
mode the device is and if it has any working problems.
Protection against over current, short circuiting and earth faults should be provided as a part of the building
installation.
Signal level of the device depends on the environment in which it is working. In case the device starts working
insufficiently, please refer to qualified personnel in order to repair this product. We recommend forwarding it to a
repair center or the manufacturer. There are no exchangeable parts inside the device.
8
Device connection
9
1 Introduction
Thank you for purchasing a RUT950 LTE router!
RUT950 is part of the RUT9xx series of compact mobile routers with high speed wireless and Ethernet
connections.
This router is ideal for people who‘d like to share their internet on the go, as it is not restricted by a cumbersome
cable connection. Unrestricted, but not forgotten: the router still supports internet distribution via a broadband cable,
simply plug it in to the wan port, set the router to a correct mode and you are ready to browse.
2 Specifications
2.1 Ethernet
IEEE 802.3, IEEE 802.3u standards
3 x LAN 10/100Mbps Ethernet ports
1 x WAN 10/100Mbps Ethernet port
Supports Auto MDI/MDIX
2.2 Wi-Fi
IEEE 802.11b/g/n WiFi standards
2x2 MIMO
AP and STA modes
64/128-bit WEP, WPA, WPA2, WPA&WPA2, EAP-PEAP encryption methods
2.401 – 2.483 GHz WiFi frequency range*
20dBm max WiFi TX power
SSID stealth mode and access control based on MAC address
2.3 Hardware
High performance 560 MHz CPU with 128 Mbytes of DDR2 memory
5.5/2.5mm DC power socket (terminal block connector optional)
Reset/restore to default button
x SMA for LTE, 2 x RP-SMA for WiFi antenna connectors
x Ethernet LEDs, 1 x power LED
1 x bi-color connection status LED, 5 x connection strength LEDs
Optional: Din rail or panels with integrated mounting flanges
*Supported frequency bands are dependent on geographical location and may not be available in all markets
10
2.5 Applications
11
3 Setting up your router
3.1 Installation
After you unpack the box, follow the steps, documented below, in order to properly connect the device. For
better Wi-Fi performance, put the device in clearly visible spot, as obstacles such as walls and door hinder the signal.
1. First assemble your router by attaching the necessary antennas and inserting the SIM card.
2. To power up your router, please use the power adapter included in the box. (IMPORTANT: Using a different
power adapter can damage and void the warranty for this product.).
3. If you have a wired broadband connection you will also have to connect it to the WAN port of the router.
To find out your router’s modem brand, check the bottom of your router. You should find a sticker containing
information about the router (Serial, IMEI, LAN MAC, etc.). The first line is the router’s product code. The seventh
symbol of the code indicates the router’s modem:
Quectel: A, H, J, K, L, M, P
Huawei: 1, 3, 5, 7, 9, B, F
Telit: 0, 2, G
Below is an example of a sticker with a Huawei modem (the modem symbol is highlighted in yellow)
12
3.1.2 Power connector
Red lit and blinking rapidly while data is being transferred: connected 2G with data session;
Yellow lit and blinking rapidly while data is being transferred: connected 3G with data session;
Green lit and blinking rapidly while data is being transferred: connected 4G with data session;
13
3.1.4 Hardware installation
1. Remove back panel and insert SIM card which was given by your ISP (Internet Service Provider). Correct SIM card
orientation is shown in the picture.
14
3.2 Logging in
After you’re complete with the setting up as described in the section above, you are ready to start logging into
your router and start configuring it. This example shows how to connect on Windows 7. On windows Vista: click Start ->
Control Panel -> Network and Sharing Centre -> Manage network Connections -> (Go to step 4). On Windows XP: Click
Start -> Settings -> Network Connections -> (see step 4). You won’t see “Internet protocol version 4(TCP/IPv4)”, instead
you’ll have to select “TCP/IP Settings” and click options -> (Go to step 6)
We first must set up our network card so that it could properly communicate with the router.
1. Press the start button 2. Type in “network connections”, wait for the results to
pop up.
3. Click “View network connections” 4. Then right click on your wireless device that you use to
connect to other access points (It is the one with the name
“Wireless Network Connection” and has signal bars on its
icon).
5. Select Internet Protocol Version 4 (TCP/IPv4) and then click 6. By default the router is going to have DHCP enabled,
Properties which means that if you select “Obtain an IP address
automatically” and “Obtain DNS server address
automatically”, the router should lease you an IP and you
15
should be ready to login.
First select an IP address. Due to the stock settings that your router has arrived in you can only enter an IP in the
form of 192.168.1.XXX , where XXX is a number in the range of 2-254 (192.168.1.2 , 192.168.1.254 , 192.168.1.155 and
so on… are valid; 192.168.1.0 , 192.168.1.1 , 192.168.1.255 , 192.168.1.699 and so on… are not). Next we enter the
subnet mask: this has to be “255.255.255.0”. Then we enter the default gateway: this has to be “192.168.1.1”. Finally we
enter primary and secondary DNS server IP’s. One will suffice, though it is good to have a secondary one as well as it will
act as a backup if the first should fail. The DNS can be your routers IP (192.168.1.1), but it can also be some external DNS
server (like the one Google provides: 8.8.8.8).
16
Right click on the Wireless network icon and select Connect / Disconnect. A list should pop up with all available
wireless networks. Select “Teltonika” and click connect. Then we launch our favorite browser and enter the routers IP
into the address field:
Press enter. If there are no problems you should be greeted with a login screen such as this:
Enter the default password, which is “admin01” into the “Password” field and then either click Login with your
mouse or press the Enter key. You have now successfully logged into the RUT950!
From here on out you can configure almost any aspect of your router.
17
4 Operation Modes
The RUT9xx series router supports various operation modes. It can be connected to the internet (WAN) via
mobile, standard Ethernet cable or via a wireless network. When connecting to the internet, you may also backup your
main WAN connection with one or two backup connections. Any interface can act like backup if configured so. At first
router uses its main WAN connection, if it is lost then router tries to connect via backup with higher priority and if that
fails too, router tries the second backup option.
5 Powering Options
The RUT9xx router can be powered from power socket or over Ethernet port. Depending on your network
architecture you can use LAN 1 port to power the device.
RUT9xx can be powered from power socket and over Ethernet simultaneously. Power socket has higher priority
meaning that the device will draw power from power socket as long as it is available.
When RUT9xx is switching from one power source to the other it loses power for a fraction of the second and
may reboot. The device will function correctly after the reboot.
Though the device can be powered over Ethernet port it is not compliant with IEEE 802.3af-2003 standard.
Powering RUT9xx from IEEE 802.3af-2003 power supply will damage the device as it is not rated for input voltages of
PoE standard.
18
5.1 Powering the device from higher voltage
If you decide not to use our standard 9 VDC wall adapters and want to power the device from higher voltage (15 –
30 VDC) please make sure that you choose power supply of high quality. Some power supplies can produce voltage
peaks significantly higher than the declared output voltage, especially during connecting and disconnecting them.
While the device is designed to accept input voltage of up to 30 VDC peaks from high voltage power supplies can
harm the device. If you want to use high voltage power supplies it is recommended to also use additional safety
equipment to suppress voltage peaks from power supply.
19
6 Status
The status section contains various information, like current IP addresses of various network interfaces; the state
of the routers memory; firmware version; DHCP leases; associated wireless stations; graphs indicating load, traffic, etc.;
and much more.
6.1 Overview
Overview section contains various information summaries.
20
6.2 System Information
The System Information tab contains data that pertains to the routers operating system.
System explanation:
Field Name Sample value Explanation
1. Router Name RUT950 Name of the router (hostname of the routers system). Can be changed
in System -> Administration.
2. Host name Teltonika-RUT950.com Indicates how router will be seen by other devices on the network. Can
be changed in System -> Administration.
3. Router Model Teltonika RUT950 LTE Routers model.
4. Firmware RUT9XX_R_00.02.345 Shows the version of the firmware that is currently loaded in the router.
Version Newer versions might become available as new features are added. Use
this field to decide whether you need a firmware upgrade or not.
5. Kernel Version 3.10.36 The version of the Linux kernel that is currently running on the router.
6. Local Time 2016-05-06, 05:54:10 Shows the current system time. Might differ from your computer,
because the router synchronizes it's time with an NTP server. Format
[year-month-day, hours: minutes: seconds].
7. Uptime 0d 0h 47m 35s (since Indicates how long it has been since the router booted up. Reboots will
2016-05-06, 05:06:35) reset this timer to 0. Format *day’s hours minutes seconds (since year-
month-day, hours: minutes: seconds)].
8. Load Average 1 min: 100%; 5 mins: Indicates how busy the router is. Let's examine some sample output: "1
87%; 15 mins: 52% min: 22%, 5 mins: 13%, 15 mins: 20%". The first number mean past
minute and second number 22% means that in the past minute there
have been, on average, 22% processes running or waiting for a
resource.
9. Temperature 34° C Device’s temperature
21
Memory explanation:
Field Name Sample Value Explanation
1. Free 79972 kB / 126556 kB The amount of memory that is completely free. Should this rapidly
(63%) decrease or get close to 0, it would indicate that the router is running
out of memory, which could cause crashes and unexpected reboots.
2. Cached 15848 kB / 126556 kB The size of the area of memory that is dedicated to storing frequently
(12%) accessed data.
3. Buffered 5920 kB / 126556 kB The size of the area in which data is temporarily stored before moving
(4%) it to another location.
Mobile information:
Field Name Sample Value Explanation
1. Data connection Connected Mobile data connection status
state
2. IMEI 860461024350889 Modem's IMEI (International Mobile Equipment Identity) number
3. IMSI 246012101426458 IMSI (International Mobile Subscriber Identity) is used to identify
the user in a cellular network
4. SIM card state Ready Indicates the SIM card's state, e.g. PIN required, Not inserted, etc.
5. Signal strength -88 dBm Received Signal Strength Indicator (RSSI). Signal's strength
22
measured in dBm
6. Cell ID 2C86315 ID of operator cell that device is currently connected to
7. RSRP -119 dBm Indicates the Reference Signal Received Power
8. RSRQ -11 dBm Indicates the Reference Signal Received Quality
9. SINR -1.2 dBm Indicates the Signal to Interference plus Noise Ratio
10. Operator OMNITEL LT Operator's name of the connected GSM network
11. Operator state Registered (home) GSM network's status
12. Connection type 4G (LTE) Indicates the GSM network's access technology
13. Bytes received 39.9 KB (40832 How many bytes were received via mobile data connection
bytes)
14. Bytes sent 27.0 KB (27674 How many bytes were sent via mobile data connection
bytes)
6.3.1.2 WAN
Display information about WAN connection.
WAN information:
Field Name Sample Value Explanation
1. Interface Wired Specifies through what medium the router is connecting to the internet.
This can either be Wired, Mobile or Wi-Fi.
23
2. Type Static Specifies the type of connection. This can either be static or DHCP.
3. IP address 192.168.99.69 The IP address that the routers uses to connect the internet.
4. WAN MAC 00:1E:42:00:00:01 MAC (Media Access Control) address used for communication in a Ethernet
WAN (Wide Area Network)
5. Netmask* 255.255.255.0 Specifies a mask used to define how large the WAN network is
6. Gateway* 192.168.99.254 Indicates the default gateway, an address where traffic destined for the
internet is routed to.
7. DNS* 8.8.8.8 Domain name server(s).
8. Connected* 1h 45m 27s How long the connection has been successfully maintained.
*-These fields show up on other connection modes.
** - Exclusively to other Modes with DHCP.
6.3.1.3 LAN
Display information about LAN connections.
LAN information:
Field Name Sample Value Explanation
1. Name Lan LAN instance name
2. IP address 192.168.99.218 Address that the router uses on the LAN network.
3. Netmask 255.255.255.0 A mask used to define how large the LAN network is
4. Ethernet MAC 00:1E:42:00:00:00 MAC (Media Access Control) address used for communication in a Ethernet
address LAN (Local Area Network)
5. Connected for 1h 53m 56s How long LAN has been successfully maintained.
DHCP Leases
If you have enabled a DHCP server this field will show how many devices have received an IP address and what
those IP addresses are.
24
Field Name Sample Value Explanation
1. Hostname ? DHCP client's hostname
2. IP address 192.168.99.120 Each lease declaration includes a single IP address that has been leased to
the client
3. LAN name Lan LAN instance name
4. MAC address D4:85:64:65:2B:D4 The MAC (Media Access Control) address of the network interface on
which the lease will be used. MAC is specified as a series of hexadecimal
octets separated by colons
5. Lease time 10h 11m 13s Remaining lease time for addresses handed out to clients
remaining
6.3.1.4 Wireless
Wireless can work in two modes, Access Point (AP) or Station (STA). AP is when the wireless radio is used to
create an Access Point that other devices can connect to. STA is when the radio is used to connect to an Access Point via
WAN.
6.3.1.4.1 Station
Display information about wireless connection (Station mode).
25
3. SSID Teltonika_Router The SSID that the AP, to which the routers is connected to, uses.
4. Mode Station (STA) Connection mode – Client indicates that the router is a client to
some local AP.
5. Encryption no encryption The AP, to which the router is connected to, dictates the type of
encryption.
6. Wireless MAC 00:1E:42:10:80:22 The MAC address of the access points radio.
7. Signal Quality 61% The quality between routers radio and some other device that is
connecting to the router. Will show 0% if no devices are trying to
connect or are currently maintaining a connection.
8. Bit rate 43.3 MBit/s The physical maximum possible throughput that the routers radio
can handle. Keep in mind that this value is cumulative - The bit rate
will be shared between the router and other possible devices that
connect to the local AP.
Wireless AP information
Field Name Sample Value Explanation
1. Channel 11 (2.46 GHz) The channel which is used to broadcast the SSID and to establish new
connections to devices.
2. Country code 00(World) Country code.
3. SSID Teltonika_Router_Test The SSID that is being broadcast. Other devices will see this and will be
26
able to use to connect to your wireless network.
4. Mode Access Point (AP) Connection mode – Master indicates that you router is an access
point.
5. Encryption No Encryption The type of encryption that the router will use to authenticate,
establish and maintain a connection.
6. Wireless MAC 00:1E:42:00:00:03 MAC address of your wireless radio.
7. Signal Quality 80% The quality between routers radio and some other device that is
connecting to the router. Will show 0% if no devices are trying to
connect or are currently maintaining a connection.
8. Bit rate 54.0 MBit/s The bit rate will be shared between all devices that connect to the
routers wireless network.
Additional note: MBit/s indicates the bits not bytes. To get the throughput in bytes divide the bit value by 8, for
e.g. 54MBits/s would be 6.75MB/s (Mega Bytes per second).
This can either be the information of the Access Point that the router is connecting to in STA mode or a list of all
devices that are connecting to the router in AP mode:
27
6. Time 0h 0m 13s For how long the connection has been established
6.3.1.9 VRRP
VRRP (Virtual Router Redundancy Protocol) for LAN
28
Field Name Sample Value Explanation
1. Status Enabled VRRP status
2. Virtual IP 192.168.1.253 Virtual IP address(- es) for LAN’s VRRP (Virtual Router Redundancy
Protocol ) cluster
3. Priority 100 Router with highest priority value on the same VRRP (Virtual Router
Redundancy Protocol) cluster will act as a master, range [1 - 255]
4. Router** Master Connection mode – Master
**-Exclusive to other Modes with Slave.
6.3.1.10 Topology
Network scanner allows you to quickly retrieve information about network devices. When router is configured to
use Mobile as WAN and Connection type is selected „PPP“, then possible to scan only the LAN side.
6.3.1.11 Access
Display information about local and remote active connections status.
29
Field Name Sample Value Explanation
1. Type SSH; HTTP; HTTPS Type of connection protocol
2. Status Disabled/Enabled Connection status
3. Port 22; 80; 443 Connection port used
4. Active 0(0.00B);1(9.26 KB); Count of active connections and amount of data transmitted in KB
Connections 6(558.12 KB)
**-Exclusive to other Modes with Slave.
31
6.5 Services
The page displays usage of the available services.
32
6.6 Routes
The page displays ARP table and active IP routes of the device.
6.6.1 ARP
Show the routers active ARP table. An ARP table contains recently cached MAC addresses of every immediate
device that was communicating with the router.
33
Field Name Sample Value Explanation
1. Network loopback Network interface used
2. Target 0:0:0:0:0:0:0:0/0 Indicates where a TCP/IP packet, with a specific IP address, should
be directed
3. IPv6-Gateway 0:0:0:0:0:0:0:0/0 Indicates through which gateway a TCP/IP packet should be directed
4. Metric FFFFFFFF Metric number indicating interface priority of usage
34
6.7 Graphs
Real-time graphs show how various statistical data changes over time.
35
Field Name Sample Value Explanation
1. 1/5/15 Minutes 0.83 Time interval for load averaging, colour of the diagram
Load
2. Average 0.86 Average CPU load value over time interval (1/5/15 Minute)
3. Peak 1.50 Peak CPU load value of the time interval
36
Field Name Explanation
1. Bridge Cumulative graph, which encompasses wired Ethernet LAN and the wireless network.
2. LAN Graphs the total traffic that passes through both LAN network interfaces.
3. WAN (Wired) Graphs the amount of traffic which passed through the current active WAN connection.
4. Mobile Graphs the amount of traffic which passed through the mobile network connection.
5. Wi-Fi Shows the amount of traffic that has been sent and received through the wireless radio.
37
6.7.4 Realtime Wireless
Display the wireless radio signal, signal noise and theoretical maximum channel permeability. Average and peak
signal levels are displayed.
38
6.7.5 Realtime Connections
Displays currently active network connections with the information about network, protocol, source and
destination addresses, transfer speed.
39
6.8 Mobile Traffic
Displays mobile connection data sent and received in KB of this day, week, Month.
By default mobile traffic usage logging is disabled. To use this functionality is needed to enable it.
40
6.9 Events Log
Event log displays such actions as: login, reboot, firmware flashing and reset.
41
6.9.2 System Events
Display all system events, their type and time of occurrence. Events include authentication or reboot requests,
incoming and outgoing SMS and calls, Mails, Configuration changes, DHCP events.
42
6.9.3 Network Events
Display information about recent network events like connection status change, lease status change, network
type or operator change.
43
6.9.4 Events Reporting
Allow to view, enable/disable or modify created rules for events reporting.
44
Field Name Sample Value Explanation
1. Enable Enable/Disable Make a rule active/inactive
2. Event type Reboot Select event type about which occurrence information will be sent
3. Event subtype After unexpected shut Specify event subtype to activate the rule
down
4. Event subtype All/Loaded Event subtype for which the rule is applied
5. Action Send SMS Action to perform when an event occurs
6. Enable delivery Enable/Disable Enables to send SMS again if first try to send SMS was unsuccessful.
retry
7. Message text on Router name - %rn; Message text on specific event
Event Event type - %et; Event
text - %ex; Time stamp
- %ts;
8 Get status after Enable/Disable Receive router status information after reboot
reboot
9. Recipient‘s +123456789 For whom you want to send a SMS
phone number
45
6.9.5.1 Events Log Report Configuration
Allow to change the configuration of periodic events reporting to email or FTP.
FTP:
Email:
46
Field Name Sample Value Explanation
1. Enable Enable/Disable Make a rule active/inactive
2. Events log System Event log for which the rule is applied
3. Transfer type Email Events log file transfer type: Email/FTP
4. Compress file Enable Enable/disable compress events log file using gzip
5. Subject Subject Subject of an email
6. Message YourMessage Message to send in email
7. SMTP server smtp.gmail.com SMTP (Simple Mail Transfer Protocol) server address
8. SMTP server 25 SMTP (Simple Mail Transfer Protocol) server port
port
9. Secure Enable/Disable Enables/disables secure connection. Use only if server supports
connection SSL or TLS
10. User name User User name for authentication on SMTP (Simple Mail Transfer
Protocol)
11. Password ●●●●●●● User password for authentication on SMTP (Simple Mail
Transfer Protocol)
12. Sender‘s email sendersemail@example.com An address that will be used to send your email from. Allowed
address characters (a-zA-Z0-9._%+-)
13. Recipient‘s recipientemail@example.com For whom you want to send an email to. Allowed characters (a-
email address zA-Z0-9._%+-)
14. Interval Week Send report every select time interval
between
reboots
15. Weekday Sunday Day of the week to get events log report
16. Hour 1 Hour of the day to get events log report
47
7 Network
7.1 Mobile
7.1.1 General
Warning: If an invalid PIN number was entered (i.e. the entered PIN does not match the one that was used to
protect the SIM card), your SIM card will get blocked. To avoid such mishaps it is highly advised to use an unprotected
SIM. If you happen to insert a protected SIM and the PIN number is incorrect, your card won’t get blocked immediately,
although after a couple of reboots OR configuration saves it will.
Enter your computer MAC address (xx:xx:xx:xx:xx:xx) to MAC Address field and select Lease time (expire time for
lease addresses). Device, which MAC address will be entered, will get IP from GSM operator. Other connected devices to
the router LAN will get IP from router DHCP server, but these devices will not have internet access.
Using Dynamic mode, device will get IP from GSM operator , which connect to the router firstly. Using
Passthrough in dynamic mode, the DHCP in LAN will be disabled.
Using no DHCP mode, IP (also subnet, gateway and DNS) from GSM operator should be entered in device, which is
connected to the router LAN, manually. Using Passthrough in no DHCP mode, the DHCP in LAN will be disabled.
49
7.1.1.2 Mobile Data On Demand
50
7.1.2 SIM Management
* Your carrier's data usage accounting may differ. Teltonika is not liable should any accounting discrepancies occur.
51
7.1.3 Network Operators
Note: after clicking Scan for operators’ button- You will lose current mobile connection! For changing network operator
status have to be available. There is manual connection to network operator, you have to fill numeric name, and it’s
have to be available.
* Your carrier's data usage accounting may differ. Teltonika is not liable should any accounting discrepancies occur.
53
7.1.4.2 SMS Warning Configuration
* Your carrier's data usage accounting may differ. Teltonika is not liable should any accounting discrepancies occur.
7.1.5.1 Settings
54
7.1.5.2 Test
Tests the functioning of idle protection with your parameters entered at settings tab.
7.2 WAN
7.2.1 Operation Mode
Your WAN configuration determines how the router will be connecting to the internet.
Type Explanation
1. Main WAN Switches between Mobile, Wired and Wi-Fi interface for main WAN
2. Backup Let’s user to select one or two interfaces for WAN backup
WAN/Load
balancing
3. Interface Name Displays WAN interface name, and changes interface priority, the interface at the table top has
the highest priority
4. Protocol Displays protocol used by WAN interface
5. IP Address Displays IP address acquired by specific interface
6. Sort Sorts table rows and changes interface priority, the highest interface has highest priority
55
7.2.2 Common configuration
Common configuration allows you to configure your TCP/IP settings for the wan network.
You can switch between the Static, DHCP or PPPoE protocol by selecting the protocol that you want to use and
then pressing Switch Protocol.
This is the configuration setup for when you select the static protocol.
56
7.2.2.1.2 DHCP:
When you select the DHCP protocol you can use it as is, because most networks will not require any additional
advanced configuration.
7.2.2.1.3 PPPoE
This protocol is mainly used by DSL providers:
This is the configuration setup for when you select PPPoE protocol.
7.2.2.2 Advanced
These are the advanced settings for each of the protocols, if you are unsure of how to alter these attributes it is
highly recommended to leave them to a trained professional:
57
7.2.2.2.1 Static
7.2.2.2.2 DHCP
58
requesting DHCP (Dynamic Host Configuration Protocol)
7. Vendor Class to send Specify vendor class which be sent when requesting DHCP
when requesting DHCP (Dynamic Host Configuration Protocol)
8. Override MAC address 86:48:71:B7:E9:E4 Override MAC address of the WAN interface. If your ISP gives you
a static IP address it might also bind it to your computers MAC
address (i.e. that IP will only work with your computer). In this
field you can enter your computers MAC address and fool the
gateway in thinking that it is communicating with your computer.
9. Override MTU 1500 Maximum transmission unit – specifies the largest possible size of
a data packet.
7.2.2.2.3 PPPoE
7.2.2.2.4 IP Aliases
IP aliases are a way of defining or reaching a subnet that works in the same space as the regular network.
59
As you can see, the configuration is very similar to the static protocol; only in the example a 99th subnet is
defined. Now if some device has an IP in the 99 subnet (192.168.99.xxx) and the subnets gateway metric is “higher” and
the device is trying to reach the internet it will reroute it’s traffic not to the gateway that is defined in common
configurations but through the one that is specified in IP aliases.
You may also optionally define a broadcast address and a custom DNS server.
The majority of the options consist of timing and other important parameters that help determine the health of
your primary connection. Regular health checks are constantly performed in the form of ICMP packets (Pings) on your
primary connection. When the connections state starts to change (READY->NOT READY and vice versa) a necessary
amount of failed or passed health checks has to be reached before the state changes completely. This delay is instituted
so as to mitigate “spikes” in connection availability, but it also extends the time before the backup link can be brought
up or down.
60
1. Health monitor Interval Disable/5/10/20/30/60/120 The interval at which health checks are performed
Seconds
2. Health monitor ICMP host(s) Disable/DNS Server(s) Where to Ping for a health check. As there is no
/WAN GW/Custom definitive way to determine when the connection
to internet is down for good, you’ll have to define
a host whose availability that of the internet as a
whole.
3. Health monitor ICMP timeout 1/3/4/5/10 Seconds How long to wait for an ICMP request to come
back. Set a higher value if your connection has
high latency or high jitter (latency spikes).
4. Attempts before failover 1/3/5/10/15/20 How many checks should fail for your WAN
connection to be declared DOWN for good.
5. Attempts before recovery 1/3/5/10/15/20 How many checks should pass for your WAN
connection to be declared UP.
The above picture shows the status for Backup WAN configured on a wired main link. You can now simulate a
downed link by simply unplugging your Ethernet WAN cable. When you’ve done so you should see this:
And, if you plug the cable back in you should, again, see this:
61
7.3 LAN
This page is used to configure the LAN network, where all your devices and computers that you connect to the
router will reside.
7.3.1 Configuration
62
7.3.2 DHCP Server
The DHCP server is the router side service that can automatically configure the TCP/IP settings of any device that
requests such a service. If you connect a device that has been configured to obtain IP address automatically the DHCP
server will lease an IP address and the device will be able to fully communicate with the router.
63
7.3.2.2 Advanced settings
You can also define some advanced options that specify how the DHCP server will operate on your LAN network.
7.3.2.4 IP Aliases
7.3.2.4.1 General Setup
IP aliases are the way of defining or reaching a subnet that works in the same space as the regular network.
64
7.3.2.4.2 Advanced Settings
You may also optionally define a broadcast address and a custom DNS server.
65
7.4 Wireless
The Wireless configuration window provides you with the possibility to configure your wireless access points and
wireless stations. The Wireless Station Mode will become active only when Wi-Fi is configured as an active WAN
interface (either main or backup.)
Above is the overview of the Wireless Configuration window. It displays active access points and stations. Here you
can disable or enable your Wi-Fi interfaces, remove unwanted access points or stations or enter a configuration window
for each Wi-Fi, where you can configure it more thoroughly.
66
7.4.1.1.2 Advanced Settings
7.4.1.2.2.1 WEP
7.4.1.2.2.2 WPA
68
7.4.1.2.2.3 WPA-2 Enterprise EAP
69
7.4.1.2.3 MAC Filter
The MAC Filter tab is used for setting up rules that allow or exclude devices with specified MAC addresses from
connecting to your Wi-Fi network.
70
After which you will be redirected to the window shown below.
Pressing Start scan will initiate a scan for available Wi-Fi Access Points in the area. After the scan finishes, you will
see a list of these Access points. Choose one according to your liking and press the Join Network button next to it.
71
7.5 VLAN
On this page you can configure your Virtual LAN settings, either Port based or Tag based.
72
Field Name Sample Value Explanation
1. VLAN ID 2 VLAN Identification number, allowed in range (1-4094)
3. Wireless Enabled / Disabled Assign selected access point(s) to selected LAN.
access points
4. LAN None Select to which LAN to wireless access point(s).
73
7.6 Firewall
In this section we will look over the various firewall features that come with RUT9.
Reject – Packet is stopped, deleted and, differently from Drop, an ICMP packet containing a message of rejection
is sent to the source of the dropped packet.
74
7.6.2 DMZ
By enabling DMZ for a specific internal host (for e.g.: your computer), you will expose that host and its services to
the routers WAN network (i.e. - internet).
You can use port forwarding to set up servers and services on local LAN machines. The above picture shows how
you can set up a rule that would allow a website that is being hosted on 192.168.1.109, to be reached from the outside
by entering http://routersExternalIp:12345/.
75
2. Protocol TCP/UDP/TCP+UDP/Other Type of protocol of incoming packet.
3. External Port 1-65535 From this port on the WAN network the traffic will be
forwarded.
4. Internal IP address IP address of some computer on The IP address of the internal machine that hosts
your LAN some service that we want to access from the outside.
5. Internal port 1-65535 To that port on the internal machine the rule will
redirect the traffic.
When you click edit you can fine tune a rule to near perfection, if you should desire that.
77
Field Name Sample value Explanation
1. Name “Allow-DHCP-Relay” Used to make rule management easier
2. Restrict to address IPv4 and IPV6 Match traffic from selected address family only
family
3. Protocol TCP/UDP/Any/ICMP/Custom Protocol of the packet that is being matched against traffic
rules.
4. Match ICMP type any Match traffic with selected ICMP type only
5. Source zone any zone/LAN/VPN/WAN Match incoming traffic from this zone only
6. Source MAC any Match incoming traffic from these MACs only
address
7. Source address any Match incoming traffic from this IP or range only
8. Source port any Match incoming traffic originating from the given source
port or port range on the client host only
9. Destination zone Device/Any Match forwarded traffic to the given destination zone only
zone/LAN/VPN/WAN
10. Destination address any Match forwarded traffic to the given destination IP address
or IP range only
11. Destination port 67 Match forwarded traffic to the given destination port or
port range only
12. Action Drop/Accept/Reject + chain Action to be taken on the packet if it matches the rule. You
+ additional rules can also define additional options like limiting packet
volume, and defining to which chain the rule belongs
78
7.6.4.1 Open Ports On the Router
79
2. Protocol TCP/UDP/Any/ICMP/Custom Protocol of the packet that is being matched against traffic
rules.
3. Source LAN/VPN/WAN Match incoming traffic from selected address family only
4. Destination LAN/VPN/WAN Forward incoming traffic to selected address family only
5. SNAT Rewrite to source IP 10.101.1.10 SNAT (Source Network Address Translation) rewrite packet\'s
source IP address and port
6. Enable Enable/Disable Make a rule active/inactive
You can configure firewall source NAT rule, by clicking edit button.
80
10. SNAT IP address “10.101.1.10” Rewrite matched traffic to the given IP address
11. SNAT port “22” Rewrite matched traffic to the given source port. May be
left empty to only rewrite the IP address'
12. Extra arguments Passes additional arguments to iptables. Use with care!
81
Field Name Sample value Explanation
1. Enable SYN flood protection Enable/Disable Makes router more resistant to SYN flood attacks.
2. SYN flood rate “25” Set rate limit (packets/second) for SYN packets above
which the traffic is considered a flood.
3. SYN flood burst “50” Set burst limit for SYN packets above which the traffic is
considered a flood if it exceeds the allowed rate.
4. TCP SYN cookies Enable/Disable Enable the use of SYN cookies (particular choices of
initial TCP sequence numbers by TCP servers).
82
1. Enable SSH limit Enable/Disable Enable SSH connections limit in selected period
2. Limit period Second/Minute/Hour/Day Select in what period limit SSH connections
3. Limit “10” Maximum SSH connections during the period
4. Limit burst “5” Indicating the maximum burst before the above limit
kicks in.
83
7.6.7 Port Scan Prevention
84
7.7. Routing
7.7.1. Static Routes
Static routes specify over which interface and gateway a certain host or network can be reached. In this page you
can configure your own custom routes.
85
7.7.1.1. Static ARP entries
Static ARP entries are used to bind a MAC address to a specific IP address. For example, if you want some device to
get the same IP every time it connects to the router, you can create a Static ARP entry by binding that device’s MAC
address to a desired IP address. The router will then create an entry in the ARP table, which in turn make sure that that
device will get the specified IP address every time.
86
7.7.2.1.2 BGP Instance
87
7.7.2.1.4 Access list filters
7.7.2.2.1. General
88
7.7.2.2.2 RIP interfaces
89
7.7.2.3.1. General Settings
91
7.8 Load Balancing
Load balancing lets users create rules that divide traffic between different interfaces.
Here you can define the ratio of each WAN interface. In the example above we can see that the mobile interface’s
ratio is 3, and the wired interface’s ratio is 2. This means that of all traffic will go through the mobile interface, and
will go through the wired interface. After you’ve finished configuring you Load Balancing rules, go the WAN section and
activate Load Balancing for the desired interface.
92
7.9. IPv6
Internet Protocol version 6 (IPv6) is the most recent version of the Internet Protocol (IP), the communications
protocol that provides an identification and location system for computers on networks and routes traffic across the
Internet. IPv6 was developed by the Internet Engineering Task Force (IETF) to deal with the long-anticipated problem of
IPv4 address exhaustion. IPv6 is intended to replace IPv4.
Once this is done, your router can start using both IPv4 and IPv6. To use use IPv6 in LAN, go to Network->LAN,
where you can setup a local IPv6 address and enable IPv6 in DHCP.
93
In order to use IPv6 with your mobile connection, go to Network->Mobile and you can uncheck the Use IPv4 only
field.
94
8 Remote monitoring and administration
RUT9XX supports multiple monitoring and administration possibilities. One can get routers information through
SMS or using RMS (Remote Management System). Furthermore, some system related parameters can be obtained using
MODBUSD or MQTT publisher services. How to use them are described in the 9.19 and 9.20 chapters respectively. The
main focus is on parameters, which change from time to time, like signal strength, operators name (it is quite common
to change of operator name in countries where inner roaming is used) or module temperature. Although it is also
possible to read more static values, like MAC address, router’s serial number and many others. The access to the
mentioned parameters is implemented in both MODBUSD and MQTT publisher applications. Apart from getting of
some parameters, MODBUSD also supports setting of some system related parameter, for example, change value of
digital output. Although it sounds frustrating, this functionality is sometimes useful and necessary.
Some applications, like MQTT publisher or RMS allows monitoring or administrating several routers from one
place. It is very useful functionality, when you have few routers and would like to change some parameter using single
application. RMS share some similarities with SSH (Secure Shell) and indeed, one of RMS feature is to allows SSH access
to remote router. There is no separate chapter about RMS in this manual, because the interface of RMS is very intuitive
and user friendly. You can access RMS by using your browser with supplied username and a password at
http://rms.teltonika.lt
By sending SMS to the router the user can execute some command, like reboot, switch wifi on or off and many
others. With each SMS the user need to specify router’s administrator password. This is done for authentication
purposes. The list of commands that may be executed through the SMS is limited. Full list of commands can be found on
Services-SMS Utilities of routers WEB page. More about router’s management using SMS can found in chapter 9.8.
Another interesting router monitoring solution is SNMP (Simple Network Management Protocol). By not going
into deep details about this protocol, it is another manner to monitor router parameters. It allows the user to check
current operator, modem model and other router parameters. Compared to other applications and services, only SNMP
have ability to inform the user about the occurrence of specific event (called trap) in the system. The main drawback of
this protocol is, that it does not allow to change anything. You can read more about SNMP in chapter 8.9.
Apart from services mentioned earlier, there is one service, which is used only for communication between router
and Android type device (phones, etc’). It is called json-rpc and allows to set or get various parameters of the system.
JSON-RPC can execute the same commands, like user through SSH. To sum up, this approach opens wide possibilities in
communication between router and Android. However, there is no separate topic about JSON-RPC in this manual,
because this type of communication is generally not for end-user use.
Each approach has its advantages and disadvantages. In some situations, maybe MQTT publisher works better
than MODBUSD, while in others, MODBUSD will be the better choice. The most versatile manner of system monitoring
and administration is through SSH. The SSH provides complete control of the router. The user can execute commands,
write shell scripts and do many other things. In such case, the user only needs application to connect router through
SSH. The most popular application used in Windows type operating systems is called Putty. If you try to connect to
router from Unix like operating system, you only need to execute ssh command with some arguments, like hostname
and username (in this case – root).
Sometimes the use of SSH is not necessary, so other more conservative services/applications are used. The
complete list of applications and services, which can be used for router administration and monitoring are given below.
It can be seen, that all applications, except MQTT publisher and SNMP supports setting/getting of some system related
parameter.
95
Application Can obtain parameters Can set parameters
1. MQTT publisher o
2. MODBUS daemon
3. SSH
4. RMS
5. SMS
6. SNMP
7. JSON-RPC
8. TR-069
By summarizing, RUT9XX provides several solutions for router management. Each user can choose what solution
to use. If required functionality is not found in particular service, the user can combine several applications, for
example, use MQTT publisher along with SNMP. Finally, if user has special needs, he can write shell script and execute it
via SSH or use json-rpc.
96
8.1. Basic SSH/CLI/Telnet commands
This section will provide some examples of basic SSH commands that can be used to monitor and manage the
router both remotely and locally.
Username – root
Password – admin01 (admin01 is the router’s default password, use the password that you setup for your router)
SSH with Windows OS: to login via SSH when using a Window operating system you will need an app that allows
Windows users to achieve an SSH connection. The most commonly used app for that purpose is PuTTY. It is very
lightweight program and can be downloaded for free.
When have PuTTY installed, open it and type in the router’s LAN (default: 192.168.1.1) or WAN IP (in order to reach
the router via WAN, first enable remote SSH access in System->Administration->Access Control) address in the Host
Name (or IP address) field and click the Open button as shown in the example bellow.
97
After this you will be greeted with a screen as such:
The login name is root, and the password is your router’s admin password (default: admin01). If your login was
successful you will be greeted with a message like this:
98
SSH with Linux OS: to login via SSH using a Linux operating system open the Terminal app and type in this
command:
ssh root@router_ip_address
root is the username, router_ip_address is the router’s LAN or WAN IP address, depending on whether you’re
trying to reach the router from a local or a remote location (to login to a router remotely, you must first enable remote
SSH access in System->Administration->Access Control). After you initiate this command, you will be prompted to enter
the router’s administrator password (default: root).
Sever in router:
Client in router:
1. To connect to telnet server use command - telnet <ip> [port], enter login and password.
99
8.1.2 Configuring the router
This section will provide examples of some basic Linux commands that be used to monitor, manage and configure a
RUT router.
All of the router’s configuration files are stored in the /etc/config folder. You can use the ls command to view the
contents of this folder. ls is a Linux shell command that lists directory contents of files and directories. The command to
view the contents of the config folder goes like this:
ls /etc/config
You can use the cat command to view the contents of a file. For example, to view the contents of the network
config, you should use this command:
cat /etc/config/network
vi /etc/config/network
You can use /etc/init.d scripts to stop, start, enable, disable or restart a service. For example, in order to restart the
OpenVPN service, use:
/etc/init.d/openvpn restart
Modem restart:
100
/etc/init.d/modem restart
Network restart:
/etc/init.d/network restart
To get mobile information, use gsmctl commands. A few examples of gsmctl usage will be provided here, but you
can get the whole list of gsmctl commands and a description on how to use them by typing gsmctl –h.
mnf_info commands can be used to view the manufacturing info of the device (serial number, hardware version,
mac, etc.)
mnf_info sn – router’s serial number
mnf_info mac – router’s MAC address
mnf_info name – router’s device name
mnf_info hwver mnf_info - router’s hardware version
mnf_info blver – router’s bootloader version
mnf_simpin – SIM card’s PIN number
101
8.1.3 UCI commands
1. uci
Examples of use:
Note: in order to know exact section name it is highly recommended to check config with uci show command.
2.luci-reload
uci commit – commits all of the uci changes from RAM to flash memory
luci-reload – reloads the relevant services in order for the changes to take place
102
9 Services
9.8 VRRP
9.8.1 VRRP LAN Configuration Settings
103
9.9 TR-069
TR-069 is a standard developed for automatic configuration and management of remote devices by Auto
Configuration Servers (ACS).
105
9.11 NTP
NTP configuration lets you setup and synchronize routers time.
9.12 VPN
9.12.1 OpenVPN
VPN (Virtual Private Network) is a method for secure data transfer through unsafe public network. This section
explains how to configure OpenVPN, which is implementation of VPN supported by the RUT9 router.
106
A picture below demonstrates default OpenVPN configurations list, which is empty, so you have to define a new
configuration to establish any sort of OpenVPN connection. To create it, enter desired configuration name in “New
configuration name” field, select device role from “Role” drop down list. For example, to create an OpenVPN client with
configuration name demo, select client role, name it “demo” and press “Add New” button as shown in the following
picture.
To see at specific configuration settings press “edit” button located in newly created configuration entry. A new
page with detailed configuration appears, as shown in the picture below (TLS client example).
107
There can be multiple server/client instances.
You can set custom settings here according to your VPN needs. Below is summary of parameters available to set:
108
6. Encryption Selects Packet encryption algorithm.
7. Authentication Sets authentication mode, used to secure data sessions. Two possibilities you have here:
“Static key” means, that OpenVPN client and server will use the same secret key, which must
be uploaded to the router using “Static pre-shared key” option. “TLS” authentication mode
uses X.509 type certificates. Depending on your selected OpenVPN mode (client or server)
you have to upload these certificates to the router:
For client: Certificate Authority (CA), Client certificate, Client key.
For server: Certificate Authority (CA), Server certificate, Server key and Diffie-Hellman (DH)
certificate used to key exchange through unsafe data networks.
All mention certificates can be generated using OpenVPN or Open SSL utilities on any type
host machine. Certificate generation and theory is out of scope of this user manual.
8. TLS cipher Packet encryption algorithm (cipher)
9. Remote host/IP IP address of OpenVPN server (applicable only for client configuration).
address
10. Resolve Retry Sets time in seconds to try resolving server hostname periodically in case of first resolve
failure before generating service exception.
11. Keep alive Defines two time intervals: one is used to periodically send ICMP request to OpenVPN server,
and another one defines a time window, which is used to restart OpenVPN service, if no ICPM
request is received during the window time slice. Example Keep Alive “10 60”
12. Remote network IP address of remote network, an actual LAN network behind another VPN endpoint.
IP address
13. Remote network Subnet mask of remote network, an actual LAN network behind another VPN endpoint.
IP netmask
14. Max routes Allow a maximum number of routes to be pulled from an OpenVPN server
15. HMAC Sets HMAC authentication algorithm
authentication
algorithm
16. Additional Add an additional layer of HMAC authentication on top of the TLS control channel to protect
HMAC against DoS attacks
authentication
17. Certificate Certificate authority is an entity that issues digital certificates. A digital certificate certifies the
authority ownership of a public key by the named subject of the certificate.
18. Client certificate Client certificate is a type of digital certificate that is used by client systems to make
authenticated requests to a remote server. Client certificates play a key role in many mutual
authentication designs, providing strong assurances of a requester's identity.
19. Client key Authenticating the client to the server and establishing precisely who they are
After setting any of these parameters press “Save” button. Some of selected parameters will be shown in the
configuration list table. You should also be aware of the fact that router will launch separate OpenVPN service for every
configuration entry (if it is defined as active, of course) so the router has ability to act as server and client at the same
time.
9.12.2 IPSec
The IPsec protocol client enables the router to establish a secure connection to an IPsec peer via the Internet.
IPsec is supported in two modes - transport and tunnel. Transport mode creates secure point to point channel between
two hosts. Tunnel mode can be used to build a secure connection between two remote LANs serving as a VPN solution.
109
IPsec system maintains two databases: Security Policy Database (SPD) which defines whether to apply IPsec to a
packet or not and specify which/how IPsec-SA is applied and Security Association Database (SAD), which contain Key of
each IPsec-SA.
The establishment of the Security Association (IPsec-SA) between two peers is needed for IPsec communication. It
can be done by using manual or automated configuration.
Note: router starts establishing tunnel when data from router to remote site over tunnel is sent. For automatic
tunnel establishment used tunnel Keep Alive feature.
Phase 1 and Phase 2 must be configured accordingly to the IPSec server configuration, thus algorithms,
authentication and lifetimes of each phase must be identical.
111
9.12.3 GRE Tunnel
GRE (Generic Routing Encapsulation RFC2784) is a solution for tunneling RFC1812 private address-space traffic
over an intermediate TCP/IP network such as the Internet. GRE tunneling does not use encryption it simply encapsulates
data and sends it over the WAN.
In the example network diagram two distant networks LAN1 and LAN2 are connected.
To create GRE tunnel the user must know the following parameters:
112
Field name Explanation
1. Enabled Check the box to enable the GRE Tunnel function.
2. Remote endpoint IP address Specify remote WAN IP address.
3. Remote network IP address of LAN network on the remote device.
4. Remote network netmask Network of LAN network on the remote device. Range [0-32].
5. Local tunnel IP Local virtual IP address. Cannot be in the same subnet as LAN network.
6. Local tunnel netmask Network of local virtual IP address. Range [0-32]
7. MTU Specify the maximum transmission unit (MTU) of a communications protocol of
a layer in bytes.
8. TTL Specify the fixed time-to-live (TTL) value on tunneled packets [0-255]. The 0 is a
special value meaning that packets inherit the TTL value.
9. PMTUD Check the box to enable the Path Maximum Transmission Unit Discovery
(PMTUD) status on this tunnel.
10. Enable Keep alive It gives the ability for one side to originate and receive keep alive packets to and
from a remote router even if the remote router does not support GRE keep
alive.
11. Keep Alive host Keep Alive host IP address. Preferably IP address which belongs to the LAN
network on the remote device.
12. Keep Alive interval Time interval for Keep Alive. Range [0 - 255].
113
9.12.4 PPTP
Point-to-Point Tunneling Protocol (PPTP) is a protocol (set of communication rules) that allows corporations to
extend their own corporate network through private "tunnels" over the public Internet. Effectively, a corporation uses a
wide-area network as a single large local area network. A company no longer needs to lease its own lines for wide-area
communication but can securely use the public networks. This kind of interconnection is known as a virtual private
network (VPN).
114
2. Use as default gateway Use this PPTP instance as default gateway
3. Server The server IP address or hostname
4. Username The user name for authorization with the server
5. Password The password for authorization with the server
9.12.5 L2TP
Allows setting up a L2TP server or client. Below is L2TP server configuration example.
Client configuration is even simpler, which requires only Servers IP, Username and Password.
You can configure many different DDNS Hostnames in the main DDNS Configuration section.
4. Hostname yourhost.example.org Domain name which will be linked with dynamic IP address.
5. Username your_username Name of the user account.
6. Password your_password Password of the user account.
7. IP Source Public This option allows you to select specific RUT interface, and then send
Private the IP address of that interface to DDNS server. So if, for example,
Custom your RUT has Private IP (i.e. 10.140.56.57) on its WAN (3G interface),
then you can send this exact IP to DDNS server by selecting "Private",
or by selecting "Custom" and "WAN" interface. The DDNS server will
then resolve hostname queries to this specific IP.
116
8. Network WAN Source network
9. IP renew interval 10 (minutes) Time interval (in minutes) to check if the IP address of the device
(min) have changed.
10. Force IP renew 472 (minutes) Time interval (in minutes) to force IP address renew.
- Reboot
- Get status
- Get OpenVPN status
- Switch WiFi on/off
- Switch mobile data on/off
- Change mobile data settings
- Get list of profiles
- Change profile
- Manage OpenVPN
- SSh access control
- Web access control
- Restore to default
- Force SIM switch
- FW upgrade from server
- Config update from server
- Switch monitoring on/off
You can choose your SMS Keyword (text to be sent) and authorized phone number in the main menu. You can
edit each created rule by hitting Edit button.
117
Field name Explanation Notes
1. Reboot
Enable This check box will enable and Allows router restart via SMS.
disable SMS reboot function.
Action The action to be performed
when this rule is met.
SMS text SMS text which will reboot SMS text can contain letters, numbers, spaces and
router. special symbols. Capital letters also matters.
Authorization method What kind of authorization to No authorization, by serial or by router admin
use for SIM management. password.
Allowed users Whitelist of allow users From all numbers, from group or from single number.
Get status via SMS Check this to recieve If you select this box, router will send status once it
after reboot connection status via SMS after has rebooted and is operational again.
a reboot. This is both separate SMS Rule and an option under
SMS Reboot rule.
Message text Which status information You can select which status elements to display.
should be included in SMS:
Data state, Operator,
Connection type, Signal
Strength, Connection State, IP
2. Get status
Enable Check this to receive Allows to get router‘s status via SMS. This is both
connection status via SMS. separate SMS Rule and an option under SMS Reboot
rule.
Action The action to be performed
118
when this rule is met.
Enable SMS Status This check box will enable and SMS status is disabled by default.
disable SMS status function.
SMS text SMS text which will send SMS text can contain letters, numbers, spaces and
routers status. special symbols. Capital letters also matters.
Authorization method What kind of authorization to No authorization, by serial or by router admin
use for SIM management. password.
Allowed users Whitelist of allow users From all numbers, from group or from single number.
Message text Which status information You can select which status elements to display.
should be included in SMS:
Data state, Operator,
Connection type, Signal
Strength, Connection State, IP
3. Get OpenVPN status
Enable This check box will enable and Allows to get OpenVPN‘s status via SMS.
disable this function.
Action The action to be performed
when this rule is met.
SMS text SMS text which will send SMS text can contain letters, numbers, spaces and
OpenVPN status. special symbols. Capital letters also matters.
Authorization method What kind of authorization to No authorization, by serial or by router admin
use for SIM management. password.
Allowed users Whitelist of allow users From all numbers, from group or from single number.
4. Switch WiFi On/Off
Enable This check box will enable and Allows Wi-Fi control via SMS.
disable this function.
Action The action to be performed Turn WiFi ON or OFF.
when this rule is met.
SMS text SMS text which will turn Wi-Fi SMS text can contain letters, numbers, spaces and
ON/OFF. special symbols. Capital letters also matters.
Authorization method What kind of authorization to No authorization, by serial or by router admin
use for SIM management. password.
Allowed users Whitelist of allow users From all numbers, from group or from single number.
Write to config Permanently saves Wi-Fi state. With this setting enabled, router will keep Wi-Fi state
even after reboot.
If it is not selected, router will revert Wi-Fi state after
reboot.
5. Switch mobile data
on/off
Enable This check box will enable and Allows mobile control via SMS.
disable this function.
Action The action to be performed Turn mobile ON or OFF.
when this rule is met.
SMS text SMS text which will turn mobile SMS text can contain letters, numbers, spaces and
data ON/OFF. special symbols. Capital letters also matters.
Authorization method What kind of authorization to No authorization, by serial or by router admin
use for SIM management. password.
Allowed users Whitelist of allow users From all numbers, from group or from single number.
Write to config Permanently saves mobile With this setting enabled, router will keep mobile
network state. state even after reboot.
119
If it is not selected, router will revert mobile state
after reboot.
6. Manage OpenVPN
Enable This check box will enable and Allows OpenVPN control via SMS.
disable this function.
Action The action to be performed Turn OpenVPN ON or OFF.
when this rule is met.
SMS text Keyword which will turn SMS text can contain letters, numbers, spaces and
OpenVPN ON/OFF. special symbols. Capital letters also matters.
After Keyword you have to write OpenVPN name.
Authorization method What kind of authorization to No authorization, by serial or by router admin
use for SIM management. password.
Allowed users Whitelist of allow users From all numbers, from group or from single number.
7. Change mobile data
settings
Enable This check box will enable and Allows to change mobile settings via SMS.
disable this function.
Action The action to be performed
when this rule is met.
SMS text Key word that will precede SMS text can contain letters, numbers, spaces and
actual configuration special symbols. Capital letters also matters.
parameters.
Authorization method What kind of authorization to No authorization, by serial or by router admin
use for SIM management. password.
Allowed users Whitelist of allow users From all numbers, from group or from single number.
Important Notes:
120
3G settings must be configured correctly. If SIM card has PIN number you must enter it at “Network” > “3G”
settings. Otherwise SMS reboot function will not work.
Sender phone number must contain country code. You can check sender phone number format by reading
the details of old SMS text massages you receiving usually.
121
access ON/OFF. special symbols. Capital letters also matters.
Authorization method What kind of authorization to No authorization, by serial or by router admin
use for SIM management. password.
Allowed users Whitelist of allow users From all numbers, from group or from single number.
Enable HTTP access Enable this to reach router via If this box is selected, SMS will enable HTTP access
HTTP from LAN (Local Area from LAN. If this box is not selected, SMS will disable
Network). HTTP access from LAN.
Enable remote HTTP Enable this to reach router via If this box is selected, SMS will enable HTTP access
access HTTP from WAN (Wide Area from WAN. If this box is not selected, SMS will disable
Network). HTTP access from WAN.
Enable remote HTTPS Enable this to reach router via If this box is selected, SMS will enable HTTPS access
access HTTPS from WAN (Wide Area from WAN. If this box is not selected, SMS will disable
Network). HTTPS access from WAN.
12.
Restore to default
Enable This check box will enable and Allows to restore router to default settings via SMS.
disable this function.
Action The action to be performed Router will reboot after this rule is executed.
when this rule is met.
SMS text SMS text which will turn Wi-Fi SMS text can contain letters, numbers, spaces and
ON/OFF. special symbols. Capital letters also matters.
Authorization method What kind of authorization to No authorization, by serial or by router admin
use for SIM management. password.
Allowed users Whitelist of allow users From all numbers, from group or from single number.
13.
Force switch SIM
Enable This check box will enable and Allows SIM switch via SMS.
disable this function.
Action The action to be performed
when this rule is met.
SMS text SMS text which will change SMS text can contain letters, numbers, spaces and
active SIM card to another one. special symbols. Capital letters also matters.
Authorization method What kind of authorization to No authorization, by serial or by router admin
use for SIM management. password.
Allowed users Whitelist of allow users From all numbers, from group or from single number.
Sender phone number Phone number of person who You can add as many phone numbers as you need.
can receive router status via Dropdown list with additional rows will show up if you
SMS message. click on “add” icon at the end of phone number row.
14.
Force FW upgrade
from server
Enable This check box will enable and Allows to upgrade router‘s FW via SMS.
disable this function.
Action The action to be performed Router will reboot after this rule is executed.
when this rule is met.
SMS text SMS text which will force router SMS text can contain letters, numbers, spaces and
to upgrade firmware from special symbols. Capital letters also matters.
server.
Authorization method What kind of authorization to No authorization, by serial or by router admin
use for SIM management. password.
Allowed users Whitelist of allow users From all numbers, from group or from single number.
122
15.
Force Config update
from server
Enable This check box will enable and Allows to upgrade router‘s Config via SMS.
disable this function.
Action The action to be performed Router will reboot after this rule is executed.
when this rule is met.
SMS text SMS text which will force router SMS text can contain letters, numbers, spaces and
to upgrade configuration from special symbols. Capital letters also matters.
server.
Authorization method What kind of authorization to No authorization, by serial or by router admin
use for SIM management. password.
Allowed users Whitelist of allow users From all numbers, from group or from single number.
16. Switch monitoring
on/off
Enable This check box will enable and Allows monitoring control via SMS.
disable this function.
Action The action to be performed Turn monitoring ON or OFF.
when this rule is met.
SMS text SMS text which will turn SMS text can contain letters, numbers, spaces and
monitoring ON/OFF special symbols. Capital letters also matters.
Authorization method What kind of authorization to By serial or by router admin password.
use for SIM management.
Allowed users Whitelist of allow users From all uers, from group or from single number.
Important Notes:
3G settings must be configured correctly. If SIM card has PIN number you must enter it at “Network” > “3G”
settings. Otherwise SMS reboot function will not work.
Sender phone number must contain country code. You can check sender phone number format by reading
the details of old SMS text massages you receiving usually.
123
Field name Sample Explanation
1. Enable Enable/Disable Enables the rule
2. Action Reboot Action to be taken after receiving a call, you can choose from
following actions: Reboot, Send status, Switch Wi-Fi, Switch mobile
data.
3. Allowed users From all numbers Allows to limit action triggering from all users, to user groups or
single user numbers
4. Get status via SMS Enable/Disable Enables automatic message sending with router status information
after reboot after reboot
124
9.14.4 SMS Management
9.14.4.3 Storage
With storage option you can choose for router NOT to delete SMS from SIM card. If this option is not used, router
will automatically delete all incoming messages after they have been read. Message status “read/unread” is examined
every 60 seconds. All “read” messages are deleted.
125
Field name Sample Explanation
1. Save messages on SIM Enabled / Disabled Enables received message storing on SIM card
2. SIM card memory Used: 0 Information about used/available SIM card memory
Available: 50
3. Leave free space 1 How much memory (number of message should be left free
Total count of SMS is managed automatically. You should be aware of possible number of SMS and use this
feature at your own responsibility. It should not, generally, be used if you have high cost per SMS. This is especially
relevant if you will try to send whole OpenVPN configuration, which might acumulate ~40 SMS.
126
1. Enabled / Disabled Enables router to receive configuration
Enable
127
1. New/From current Generate new SMS settings or use current device
Generate SMS
configuration configuration
2. Interface Mobile/Wired Interface type used for WAN (Wide Area Network)
connection
3. WAN Enable/Disable Include configuration for WAN (Wide Area Network)
4. LAN Enable/Disable Include configuration for LAN (Local Area Network)
6. Protocol Static/DHCP Network protocol used for network configuration
parameters management
7. IP address “217.147.40.44” IP address that router will use to connect to the
internet
8. IP netmask “255.255.255.0” That will be used to define how large the WAN (Wide
Area Network) network is
11. IP gateway “217.147.40.44” The address where traffic destined for the internet is
routed to
12. IP broadcast “217.147.40.255” A logical address at which all devices connected to a
multiple-access communications network are enabled
to receive datagrams.
13. Primary SIM card SIM1/SIM2 A SIM card that will be used as primary
14. Mobile connection Use pppd mode An underlying agent that will be used for mobile data
Use ndis mode connection creation and management
15. APN “internet.mnc012.mcc345.gprs” (APN) is the name of a gateway between a GPRS or
3G mobile networks and another computer network,
frequently the public Internet.
16. Dialing number “+37060000001” A phone number that will be used to establish a
mobile PPP (Point-to-Point Protocol) connection
17. Authentication CHAP/PAP/None Select an authentication method that will be used to
method authenticate new connections on your GSM carrier's
network
18. User name “admin” User name used for authentication on your GSM
carrier's network
19. Password “password” Password used for authentication on your GSM
carrier's network
20. Service mode Auto You can add as many phone numbers as you need.
4G (LTE ) preferred Dropdown list with additional rows will show up if
4G (LTE) only you click on “add” icon at the end of phone number
3G preferred row.
3G only
2G preferred
2G only
21. IP address “192.168.1.1” IP address that router will use on LAN (Local Area
Network) network
22. IP netmask “255.255.255.0” A subnet mask that will be used to define how large
the LAN (Local Area Network) network is
23. IP broadcast “192.168.1.255” A logical address at which all devices connected to a
multiple-access communications network are enabled
to receive datagrams
128
Field name Values Notes
1. Generated configuration Here you can review and modify configuration
Message text field
message message text to be sent
2. “+37060000001” A phone number of router which will receive the
Phone number
configuration
3. Authorization method No authorization What kind of authorization to use for remote
By serial configuration
By router admin password
9.14.6 Statistics
In statistics page you can review how much SMS was sent and received on both SIM card slots. You can also reset
the counters.
9.15 SNMP
SNMP settings window allows you to remotely monitor and send GSM event information to the server.
129
9.15.1 SNMP Settings
Variables/OID
OID Description
1. 1.3.6.1.4.1.99999.1.1.1 Modem IMEI
2. 1.3.6.1.4.1.99999.1.1.2 Modem model
3. 1.3.6.1.4.1.99999.1.1.3 Modem manufacturer
4. 1.3.6.1.4.1.99999.1.1.4 Modem revision
5. 1.3.6.1.4.1.99999.1.1.5 Modem serial number
6. 1.3.6.1.4.1.99999.1.1.6 SIM status
7. 1.3.6.1.4.1.99999.1.1.7 Pin status
8. 1.3.6.1.4.1.99999.1.1.8 IMSI
9. 1.3.6.1.4.1.99999.1.1.9 Mobile network registration status
10. 1.3.6.1.4.1.99999.1.1.10 Signal level
11. 1.3.6.1.4.1.99999.1.1.11 Operator currently in use
12. 1.3.6.1.4.1.99999.1.1.12 Operator number (MCC+MNC)
13. 1.3.6.1.4.1.99999.1.1.13 Data session connection state
14. 1.3.6.1.4.1.99999.1.1.14 Data session connection type
15. 1.3.6.1.4.1.99999.1.1.15 Signal strength trap
16. 1.3.6.1.4.1.99999.1.1.16 Connection type trap
130
9.15.2 TRAP Settings
131
Field name Values Notes
1. Enabled / Disabled Enable SMS management functionality through
Enable
POST/GET
2. admin User name used for authorization
User name
132
/cgi-bin/sms_delete? Delete
username={your_user_name}&password={your_password}&number={MESSAGE_INDEX} message
/cgi-bin/ sms_list? username={your_user_name}&password={your_password} List all
message
s
/cgi-bin/sms_ total? username={your_user_name}&password={your_password} Number
of
message
s in
memory
Note: parameters of HTTP POST/GET string are in capital letters inside curly brackets. Curly brackets (“{ }”) are not
needed when submitting HTTP POST/GET string.
Parameter Explanation
1. IP_ADDRESS IP address of your router
2. MESSAGE_INDEX SMS index in memory
3. PHONE_NUMBER Phone number of the message receiver.
Note: Phone number must contain country code. Phone number format is:
00{COUNTRY_CODE} {RECEIVER_NUMBER}.
E.g.: 0037062312345 (370 is country code and 62312345 is receiver phone number)
4. MESSAGE_TEXT Text of SMS. Note: Maximum number of characters per SMS is 160. You cannot send
longer messages. It is suggested to use alphanumeric characters only.
After every executed command router will respond with return status.
Response Explanation
1. OK Command executed successfully
2. ERROR An error occurred while executing command
3. TIMEOUT No response from the module received
4. WRONG_NUMBER SMS receiver number format is incorrect or SMS index number is incorrect
5. NO MESSAGE There is no message in memory by given index
6. NO MESSAGES There are no stored messages in memory
http://192.168.1.1/cgi-bin/sms_delete?username=admin&password=admin01&number=4
http://192.168.1.1 /cgi-bin/sms_list?username=admin&password=admin01
http://192.168.1.1/cgi-bin/sms_total?username=admin&password=admin01
133
9.16.2 Email to SMS
134
9.16.3.1 Scheduled Messages Configuration
2. Don’t save received Enable/Disable If enabled, received messages are not going to be
message saved
3. Mode Everyone / Specifies from which senders received messages are
Listed numbers going to be replied.
4. Message “Text” Message text that will be sent in reply.
135
9.16.5 SMS Forwarding
136
9.16.5.2 SMS Forwarding to SMS
This functionality allows forwarding mobile messages from specified senders to one or several recipients.
2. Add sender number Enable / Disable If enabled, original senders number will be added at
the end of the forwarded message
3. Mode All message / Specifies from which senders received messages are
From listed numbers going to be forwarded.
4. Recipients phone +37060000001 Phone numbers to which message is going to be
numbers forwarded to
137
Field name Values Notes
1. Enable / Disable Enable mobile message forwarding to email
Enable
2. Add sender number Enable / Disable If enabled, original senders number will be added at
the end of the forwarded message
3. Subject “forwarded message” Text that will be inserted in email Subject field
4. SMTP server mail.teltonika.lt Your SMTP server’s address
5. SMTP server port 25 Your SMTP server’s port number
6. Secure connection Enable / Disable Enables the use of cryptographic protocols, enable
only if your SMTP server supports SSL or TLS
7. User name “admin” Your full email account user name
8. Password ******* Your email account password
9. Sender’s email address name.surname@gmail.com Your address that will be used to send emails from
10. Recipient’s email address name2.surname2@gmail.com Address that you want to forward your messages to
11. Mode All messages / from listed Choose which senders messages to forward to email
numbers
9.16.6 SMPP
138
9.17 Hotspot
Wireless hotspot provides essential functionality for managing an open access wireless network. In
addition to standard RADIUS server authentication there is also the ability to gather and upload detailed logs on
what each device (denoted as a MAC address) was doing on the network (what sites were traversed, etc.).
139
2. Radius server #2 The IP address of the second RADIUS server.
3. Authentication port RADIUS server authentication port.
4. Accounting port RADIUS server accounting port.
5. Radius secret key The secret key is used for authentication with the RADIUS server
6. UAM port Port to bind for authenticating clients
7. UAM UI port UAM UI port
8. UAM secret Shared secret between UAM server an hotspot
9. NAS Identifier NAS Identifier
10. Swap octets Swap the meaning of input octets and output as it related to RADIUS attributes
11. Location name The name of location
Authentication mode: Internal radius/Without radius
1. External landing Enables the use of external landing page.
page
2. Landing page The address of external landing page
address
3. HTTPS redirect Redirects HTTP pages to landing page.
Authentication mode: SMS OTP
140
9.17.2 Internet Access Restriction Settings
Allows disable internet access on specified day and hour of every week.
9.17.3 Logging
9.17.3.1 Configuration
141
3. Username The username of the user on the aforementioned FTP server.
4. Password The password of the user.
5. Port The TCP/IP Port of the FTP server.
9.17.3.2 Log
142
9.17.4 Landing Page
In the sections – “Terms Of Services”, “Background Configuration”, “Logo Image Configuration”, “Link
Configuration”, “Text Configuration” you can customize various parameters of landing page components.
143
9.17.4.2 Template
In this page you can review landing page template HTML code and modify it.
144
Field name Explanation
1. Enable Activates an authentication and accounting system
2. Remote access Activates remote access to radius server
3. Accounting port Port on which to listen for accounting
4. Authentication port Port on which to listen for authentication
9.17.6 Statistics
On hotspot statistics page you can review statistical information about hotspot instances.
9.18 CLI
CLI or Comand Line Interface functionality allows you to enter and execute comands into routers terminal.
145
9.19 Auto Reboot
9.19.1 Ping Reboot
Ping Reboot function will periodically send Ping command to server and waits for echo receive. If no echo is
received router will try again sending Ping command defined number times, after defined time interval. If no echo is
received after the defined number of unsuccessful retries, router will reboot. It is possible to turn of the router
rebooting after defined unsuccessful retries. Therefore this feature can be used as “Keep Alive” function, when router
Pings the host unlimited number of times. Possible actions if no echo is received: Reboot, Modem restart, Restart
mobile connection, (Re) register, None.
146
9.19.2 Periodic Reboot
9.20 UPNP
9.20.1 General Settings
UPnP allows clients in the local network to automatically configure the router.
147
Field name Explanation
1. Use UPnP port mapping Enable UPnP port mapping functionality
2. Use NAT-PMP port Enable NAT-PMP mapping functionality
mapping
3. Device UUID Specify Universal unique ID of the device
148
9.21 QoS
QoS (Quality of Service) is the idea that transmission rates, error rates, and other characteristics can be measured,
improved, and, to some extent, guaranteed in advance. QoS is of particular concern for the continuous transmission of
high-bandwidth video and multimedia information.
QoS can be improved with traffic shaping techniques such as packet, network traffic, and port prioritization.
9.22 MQTT
MQTT also known as MQ Telemetry Transport is an publish-subscribe based messaging protocol for use on top of
the TCP/IP protocol. It is designed to send short messages from one client (publisher) to another (subscriber) through
the brokers, which are responsible for message delivery to the end point. RUT 9XX routers do support this functionality
via open source Mosquitto broker. The messages are sent in this way: some client (subscriber) subscribes to specific
topic or many of them, and then publisher posts some message to specific topic. The broker then checks who is
subscribed to particular topic and transmits data from publisher to subscriber.
RUT9XX supports some functionality of the MQTT broker and MQTT publisher. The main window of parameters is
presented below. The broker can be enabled by checking Enable and entering the port number on which MQTT broker
should run to. In order to accept connections from WAN interface, Enable Remote Access should be checked also.
In order to use TLS/SSL for connecting clients (subscribers and publishers) to the broker, the one should check
Use TLS/SSL. After that, additional settings will be displayed to the user as shown below. Here the user can upload
certificates, key files and choose TLS version, which will be used for data encryption between broker and clients
(subscribers and publishers)
150
The MQTT broker also supports option called Bridge. It means, that two brokers can be connected to each other
and share messages. The window of bridge parameters are presented below. There are some mandatory parameters,
like Connection Name, Remote Address and Remote Port. Although connection name is mandatory, it should be set to
value what you like and according to mosquitto’s user manual this option denotes the client ID which will be used when
connecting to remote broker. There are some other parameters. If you would like to known that they mean and how to
use them you should check for mosquito.conf manual page.
151
,
The last section of parameters is called Miscellaneous. It contains parameters, which does not depend on neither
Security, nor Bridge categories. ACL File denotes access control list file name. The contents of this file are used to control
client access to topics of the broker. The Password File denotes the file, there users and corresponding passwords are
stored. This file is used for user authentication. This option is related to another option called Allow Anonymous. If
Allow Anonymous is unchecked, only users, which exist in password file will be able to connect to the broker. More
about password file can be read on mosquitto configuration manual. The last option is called Persistence, it allows to
save connection, subscription and message data to the disk, otherwise, the data is stored in memory only.
152
It is possible to configure some sort of MQTT publisher. It is not simple publisher, but publisher, which publishes
some system parameters to the broker. The publisher configuration window has few fields, like hostname and port of
the broker to connect. Username and password fields are used for authentication. If these fields are left empty, no
authentication is performed.
The full list of system parameters, which can be published, are described below.
153
connection Check if data connection is available
In order system to work, MQTT broker should be configured in advance. You can use the broker, which is installed inside
the router, or the broker in the other location. The publisher operates according to the scheme presented below. In the
scheme the client tries to subscribe information about router’s uptime. To achieve this multiple commands between
client and publisher are being sent.
Subscribe router/get
Subscribe
get/01234567/command Publish router/get
Publisher id Client
Publish get/01234567/command
Publish router/id
uptime
01234567
Broke
r
Publish router/01234567/uptime 15248
In general publisher works in such a way: connects to the broker and subscribes to the topics router/get and
get/<SERIAL>/command, there <SERIAL> denotes serial number of the router which is currently run publisher. The client
then sends message id to the topic router/get. The following message is received by the publisher, since it is subscribed
to that topic. Then the publisher sends response with its serial number to the topic router/id. Now the client knows that
publisher with some serial number exist. It means, that client can send message with parameter name from the list as a
message to the topic get/<SERIAL>/command to the broker. The message will be received only by the subscriber, which
has the same SERIAL number mentioned in the topic. Now the publisher can send back a response with
router/<SERIAL>/parameter_name topic and message with a value of requested parameter. It should be noted, that
according to MQTT protocol, the topic names are case-sensitive, for example topic router is not the same as topic
RoUtEr.
154
9.23 Modbus TCP interface
Modbus TCP interface allows the user to set or get some parameters from the router (the parameters, which can
be set or get will be described later), like module temperature or signal strength. In other words, Modbus TCP is another
manner to control router behavior. To use Modbus TCP capabilities it must be turned on by navigating to Services-
Modbus. After “Save” button is pressed, the Modbus daemon will be launched on selected port of the system. Modbus
daemon performs as slave, that means, it accepts connection from the master (client) and sends out a response or sets
some system related parameter. By the default Modbus will only accept connections through LAN interface. In order to
accept connections through WAN interface also, Allow Remote Access must be checked.
To obtain some parameter from the system, the read holding registers command is used. The register number
and corresponding system values are described below. Each register contains 2 bytes. For simplification the number of
registers for storing numbers is 2, while for storing text information the number of registers is 16.
The Modbus daemon also supports setting of some system parameters. For this task write holding register
command is used. System related parameters and how to use them are described below. The register number refers to
the register number where to start write required values. All commands, except “Change APN” accepts only one input
parameter. For the APN the number of input registers may vary. The very first byte of APN command denotes a number
155
of SIM card for which set the APN. This byte should be set to 1 (in order to change APN for SIM card number 1) or to 2
(in order to change APN for SIM card number 2).
10 System
10.8 Setup Wizard
The configuration wizard provides a simple way of quickly configuring the device in order to bring it up to basic
functionality. The wizard is comprised out of 4 steps and they are as follows:
First, the wizard prompts you to change the default password. Simply enter the same password into both
Password and Confirmation fields and press Next.
Next we have to enter your mobile configuration. On a detailed instruction on how this should be done see the
Mobile section under Network
156
Step 3 (LAN)
Next, you are given the chance to configure your LAN and DHCP server options. For a detailed explanation see
LAN under Network.
Step 4 (Wi-Fi)
The final step allows you to configure your wireless settings in order to set up a rudimentary Access Point.
157
When you’re done with the configuration wizard, press Save.
10.9 Profiles
Router can have 5 configuration profiles, which you can later apply either via WebUI or via SMS. When you add
New Profile, you save current full configuration of the router. Note: profile names cannot exceed 10 symbols.
158
10.10 Administration
10.10.1 General
Important notes:
159
The only way to gain access to the web management if you forget the administrator password is to reset the
device factory default settings. Default administrator login settings are:
Password: admin01
10.10.2 Troubleshoot
160
10.10.3 Backup
161
10.10.3.1 Access control
10.10.3.1.1 General
Note: The router has 2 users: “admin” for WebUI and “root” for SSH. When logging in via SSH use “root”.
162
10.10.3.1.2 Safety
10.10.4 Diagnostics
163
2. Ping Utility used to test the reach ability of a host on an Internet IP network and to measure the
round-trip time for messages sent from the originating host to a destination server. Server echo
response will be shown after few seconds if server is accessible.
3. Traceroute Diagnostics tool for displaying the route (path) and measuring transit delays of packets across an
Internet IP network. Log containing route information will be shown after few seconds.
4. Nslookup Network administration command-line tool for querying the Domain Name System (DNS) to
obtain domain name or IP address mapping or for any other specific DNS record. Log containing
specified server DNS lookup information will be shown after few seconds.
10.10.6 Overview
Select which information you want to get in Overview window (Status -> Overview).
10.10.7 Monitoring
Monitoring functionality allows your router to be connected to Remote Monitoring System. Also MAC
address and router serial numbers are displayed for convenience in this page, because they are needed when
adding device to monitoring system.
166
10.13 Firmware
10.13.1 Firmware
Keep all settings – if the check box is selected router will keep saved user configuration settings after firmware
upgrade. When check box is not selected all router settings will be restored to factory defaults after firmware upgrade.
When upgrading firmware, you can choose settings that you wish to keep after the upgrade. This function is useful
when firmware is being upgraded via Internet (remotely) and you must not lose connection to the router afterwards.
Warning: Never remove router power supply and do not press reset button during upgrade process! This would
seriously damage your router and make it inaccessible. If you have any problems related to firmware upgrade you
should always consult with local dealer.
167
10.13.2 FOTA
10.14 Reboot
168
11 Device Recovery
The following section describes available options for recovery of malfunctioning device. Usually device can
become unreachable due to power failure during firmware upgrade or if its core files were wrongly modified in the file
system. Teltonika’s routers offer several options for recovering from these situations.
Reboot the device. After the device has started and if the reset button is pressed for up to 4 seconds the device
will reboot. Start of the reboot will be indicated by flashing of all 5 signal strength LEDs together with green connection
status LED.
Reset to defaults. After the device has started if the reset button is pressed for at least 5 seconds the device will
reset all user changes to factory defaults and reboot. To help user to determine how long the reset button should be
pressed, signal strength LEDs indicates the elapsed time. All 5 lit LEDs means that 5 seconds have passed and reset
button can be released. Start of the reset to defaults will be indicated by flashing of all 5 signal strength LEDs together
with red connection status LED. SIM PIN on the main SIM card is the only user parameter that is kept after reset to
defaults.
Automatically. It happens when bootloader does not detect master firmware. Flashing all 4 Ethernet LEDs
indicate that bootloader’s webserver has started.
Manually. Bootloader’s webserver can be requested by holding reset button for 3 seconds while powering the
device on. Flashing all 4 Ethernet LEDs indicates that bootloader’s webserver has started.
Bootloader’s WebUI can be accessed by typing this address in the web browser:
http://192.168.1.1/index.html
Note: it may be necessary to clear web browser’s cache and to use incognito/anonymous window to access
bootloader’s WebUI.
169
12 Glossary
WAN – Wide Area Network is a telecommunication network that covers a broad area (i.e., any network that links
across metropolitan, regional, or national boundaries). Here we use the term WAN to mean the external network that
the router uses to reach the internet.
LAN – A local area network (LAN) is a computer network that interconnects computers in a limited area such as a
home, school, computer laboratory, or office building.
DHCP – The Dynamic Host Configuration Protocol (DHCP) is a network configuration protocol for hosts on Internet
Protocol (IP) networks. Computers that are connected to IP networks must be configured before they can communicate
with other hosts. The most essential information needed is an IP address, and a default route and routing prefix. DHCP
eliminates the manual task by a network administrator. It also provides a central database of devices that are connected
to the network and eliminates duplicate resource assignments.
ETHERNET CABLE – Refers to the CAT5 UTP cable with an RJ-45 connector.
AP – Access point. An access point is any device that provides wireless connectivity for wireless clients. In this
case, when you enable Wi-Fi on your router, your router becomes an access point.
DNS – Domain Name System. A server that translates names such as www.google.lt to their respective IPs. In
order for your computer or router to communicate with some external server it needs to know it’s IP, its name
“www.something.com” just won’t do. There are special servers set in place that perform this specific task of resolving
names into IPs, called Domain Name servers. If you have no DNS specified you can still browse the web, provided that
you know the IP of the website you are trying to reach.
ARP – Short for Adress Resolution Protocol a network layer protocol used to convert an IP address into a physical
address (called a DLC address), such as an Ethernet address.
PPPoE – Point-to-Point Protocol over Ethernet. PPPoE is a specification for connecting the users on an Ethernet to
the internet through a common broadband medium, such as DSL line, wireless device or cable modem.
DSL – digital subscriber line - it is a family of technologies that provide internet access by transmitting digital data
using a local telephone network which uses the public switched telephone network.
NAT – network address translation – an internet standard that enables a local-area network (LAN) to use one set
of IP addresses for internet traffic and a second set of addresses for external traffic.
LCP – Link Control Protocol – a protocol that is part of the PPP (Point-to-Point Protocol). The LCP checks the
identity of the linked device and either accepts or rejects the peer device, determines the acceptable packet size for
transmission, searches for errors in configuration and can terminate the link if the parameters are not satisfied.
BOOTP – Bootstrap Protocol – an internet protocol that enables a diskless workstation to discover its own IP
address, the IP address of a BOOTP server on the network, and a file to be loaded into memory to boot the machine.
This enables the workstation to boot without requiring a hard or floppy disk drive.
TCP – Transmission Control Protocol – one of the main protocols in TCP/IP networks. Whereas the IP protocol
deals only with packets, TCP enables two hosts to establish a connection and exchange streams of data. TCP guarantees
delivery of data and also guarantees that packets will be delivered in the same order in which they were sent.
170
TKIP – Temporal Key Integrity Protocol – scrambles the keys using hashing algorithm and, by adding an integrity-
checking feature, ensure that the keys haven’t been tampered with.
CCMP – Counter Mode Cipher Block Chaining Message Authentication Code Protocol – encryption protocol
designed for Wireless LAN products that implement the standards of the IEEE 802.11i amendment to the original
IEEE802.11 standard. CCMP is an enchanted data cryptographic encapsulation designed for data confidentiality and
based upon the Counter Mode with CBC-MAC (CCM) of the AES (Advanced Encryption Standard) standard.
MAC – Media Access Control. Hardware address which uniquely identifies each node of the network. In IEEE 802
networks, the Data Link Control (DCL) layer of the PSO Reference Model is divided into two sub-layers: the Logical Link
Control (LLC) layer and the Media Access Control layer. The MAC layer interfaces directly with the network medium.
Consequently, each different type of network medium requires a different MAC layer.
DMZ – Demilitarized Zone – a computer or small subnetwork that sits between a trusted internal network, such as
a corporate private LAN, and an untrusted external network, such as the public internet.
UDP – User Datagram Protocol – a connectionless protocol that, like TCP, runs on top of IP networks. Provides
very few error recovery services, offering instead a direct way to send and receive datagrams over IP network.
VPN – Virtual Private Network – a network that is constructed by using public wires — usually the Internet — to
connect to a private network, such as a company's internal network.
VRRP – Virtual Router Redundancy Protocol - an election protocol that dynamically assigns responsibility for one
or more virtual router(s) to the VRRP router(s) on a LAN, allow several routers on a multiaccess link to utilize the same
virtual IP address.
GRE Tunnel – Generic Routing Encapsulation - a tunneling protocol developed by Cisco Systems that can
encapsulate a wide variety of network layerprotocols inside virtual point-to-point links over an Internet Protocol
internetwork.
PPPD – Point to Point Protocol Daemon – it is used to manage network connections between two nodes on Unix-
likeoperating systems. It is configured using command-line arguments and configuration files.
SSH – Secure Shell - a program to log into another computer over a network, to execute commands in a remote
machine, and to move files from one machine to another. It provides strong authentication and secure communications
over insecure channels.
VRRPD – Virtual Router Redundancy Protocol – it is designed to eliminate the single point of failure associated
with statically routed networks by automatically providing failover using multiple LAN paths through alternate routers.
SNMP – Simple Network Management Protocol - a set of protocols for managing complex networks. SNMP works
by sending messages, called protocol data units (PDUs), to different parts of a network.
171
13 Changelog
Nr. Date Version Comments
1 2017-02-01 1.34
172