UAB Teltonika RUT950 RUT950 User Manual

UAB Teltonika RUT950

Contents

Users Manual-2

69
7.5.2 LAN Networks
In this page you can create extra LAN networks, and assign them with LAN Ports and wireless access points. You
can get extra information on how to configure any of your LAN’s settings in section – 7.3 LAN
Field Name
Sample Value
Explanation
1.
LAN name
Lan
Specifies new LAN name
2.
Interface
name
eth0 tap0
Specifies LAN interface name
7.6 Firewall
In this section we will look over the various firewall features that come with RUT9.
7.6.1 General Settings
The routers firewall is a standard Linux iptables package, which uses routing chains and policies to facilitate
control over inbound and outbound traffic.
Field Name
Sample value
Explanation
1.
Drop Invalid
Checked/Unchecked
A “Drop” action is performed on a packet that is determined to be invalid
70
packets
2.
Input
Reject/Drop/Accept
DEFAULT* action that is to be performed for packets that pass through the
Input chain.
3.
Output
Reject/Drop/Accept
DEFAULT* action that is to be performed for packets that pass through the
Output chain.
4.
Forward
Reject/Drop/Accept
DEFAULT* action that is to be performed for packets that pass through the
Forward chain.
*DEFAULT: When a packet goes through a firewall chain it is matched against all the rules for that specific chain. If
no rule matches said packet, an according Action (either Drop or Reject or Accept) is performed.
Accept – Packet gets to continue down the next chain.
Drop – Packet is stopped and deleted.
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.
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).
7.6.3 Port Forwarding
Here you can define your own port forwarding rules.
71
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/.
Field Name
Sample value
Explanation
Name
Enable_SSH_WAN_PASSTHROUGH
Name of the rule. Used purely to make it easier to
manage rules.
Protocol
TCP/UDP/TCP+UDP/Other
Type of protocol of incoming packet.
External Port
1-65535
From this port on the WAN network the traffic will be
forwarded.
Internal IP address
IP address of some computer on
your LAN
The IP address of the internal machine that hosts
some service that we want to access from the outside.
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.
72
Field Name
Sample value
Explanation
1.
Name
ENABLE_SSH_WAN_PASSTHROUGH
Name of the rule. Used purely to make it easier to
manage rules.
2.
Protocol
TCP/UDP/TCP+
UDP/ICMP/Custom
You may specify multiple by selecting (custom) and
then entering protocols separated by space
3.
Source zone
LAN/VPN/WAN
Match incoming traffic from this zone only
4.
Source MAC address
any
Match incoming traffic from these MACs only
5.
Source IP address
any
Match incoming traffic from this IP or range only
7.
Source port
any
Match incoming traffic originating from the given
source port or port range on the client host only
8.
External IP address
any
Match incoming traffic directed at the given IP
address only
9.
External port
22
Match incoming traffic directed at the given
destination port or port range on this host only
10.
Internal zone
LAN/VPN/WAN
Redirect matched incoming traffic to the specified
internal zone
11.
Internal IP address
127.0.0.1
Redirect matched incoming traffic to the specified
internal host
12.
Internal port
any
Redirect matched incoming traffic to the given port
on the internal host
13.
Enable NAT loopback
Enable/Disable
NAT loopback enables your local network (i.e.
behind your router/modem) to connect to a
forward-facing IP address (such as 208.112.93.73) of
a machine that it also on your local network
14.
Extra arguments
Passes additional arguments to iptables. Use with
care!
73
7.6.4 Traffic Rules
The traffic rule page contains a more generalized rule definition. With it you can block or open ports, alter how
traffic is forwarded between LAN and WAN and many more things.
Field Name
Explanation
1.
Name
Name of the rule. Used for easier rules management purpose only
2.
Protocol
Protocol type of incoming or outgoing packet
3.
Source
Match incoming traffic from this IP or range only
4.
Destination
Redirect matched traffic to the given IP address and destination port
5.
Action
Action to be taken for the packet if it matches the rule
6.
Enable
Self-explanatory. Uncheck to make the rule inactive. The rule will not be deleted, but it also
will not be loaded into the firewall.
7.
Sort
When a packet arrives, it gets checked for a matching rule. If there are several rules that
match the rule, the first one is applied i.e. the order of the rule list impacts how your firewall
operates, therefore you are given the ability to sort your list as you wish.
You can configure firewall rule by clicking edit button.
74
Field Name
Sample value
Explanation
1.
Name
“Allow-DHCP-Relay”
Used to make rule management easier
2.
Restrict to address
family
IPv4 and IPV6
Match traffic from selected address family only
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
address
any
Match incoming traffic from these MACs only
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
zone/LAN/VPN/WAN
Match forwarded traffic to the given destination zone only
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
+ additional rules
Action to be taken on the packet if it matches the rule. You
can also define additional options like limiting packet
volume, and defining to which chain the rule belongs
75
7.6.4.1 Open Ports On the Router
Field Name
Sample value
Explanation
Name
Open_Port_rule
Used to make rule management easier
Protocol
TCP/UDP/Any/ICMP/Custom
Protocol of the packet that is being matched against
traffic rules.
External port
1-65535
Match incoming traffic directed at the given destination
port or port range on this host.
7.6.4.2 New Forward Rule
Field Name
Sample value
Explanation
Name
Forward rule new
Used to make rule management easier
Source
LAN/VPN/WAN
Match incoming traffic from selected address family only
Protocol
TCP/UDP/Any/ICMP/Custom
Protocol of the packet that is being matched against
traffic rules.
7.6.4.3 Source NAT
Source NAT is a specific form of masquerading which allows fine grained control over the source IP used for
outgoing traffic, for example to map multiple WAN addresses to internal subnets.
Field Name
Sample value
Explanation
1.
Name
SNAT
Used to make rule management easier
76
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.
Field Name
Sample value
Explanation
1.
Name
SNAT
Used to make rule management easier
2.
Protocol
TCP/UDP/Any/ICMP/Custom
Protocol of the packet that is being matched against
traffic rules.
3.
Source zone
LAN/VPN/WAN
Match incoming traffic from this zone only
4.
Source MAC address
any
Match incoming traffic from these MACs only
5.
Source address
any
Match incoming traffic from this IP or range only
6.
Source port
any
Match incoming traffic originating from the given source
port or port range on the client host only
7.
Destination zone
LAN/VPN/WAN
Match forwarded traffic to the given destination zone
only
8.
Destination IP address
Select from the list
Match forwarded traffic to the given destination IP
address or IP range only
9.
Destination port
any
Match forwarded traffic to the given destination port or
port range only
77
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!
7.6.5 Custom Rules
Here you have the ultimate freedom in defining your rules – you can enter them straight into the iptables
program. Just type them out into the text field ant it will get executed as a Linux shell script. If you are unsure of how to
use iptables, check out the internet for manuals, examples and explanations.
7.6.6 DDOS Prevention
7.6.6.1 SYN Flood Protection
SYN Flood Protection allows you to protect from attack that exploits part of the normal TCP three-way handshake
to consume resources on the targeted server and render it unresponsive. Essentially, with SYN flood DDoS, the offender
sends TCP connection requests faster than the targeted machine can process them, causing network saturation.
78
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).
7.6.6.2 Remote ICMP requests
Attackers are using ICMP echo request packets directed to IP broadcast addresses from remote locations to
generate denial-of-service attacks.
Field Name
Sample value
Explanation
1.
Enable ICMP requests
Enable/Disable
Blocks remote ICMP echo-request type
2.
Enable ICMP limit
Enable/Disable
Enable ICMP echo-request limit in selected period
3.
Limit period
Second/Minute/Hour/Day
Select in what period limit ICMP echo-request
4.
Limit
“10”
Maximum ICMP echo-request during the period
5.
Limit burst
“5”
Indicating the maximum burst before the above limit
kicks in.
7.6.6.3 SSH Attack Prevention
Prevent SSH (Allows a user to run commands on a machine's command prompt without them being physically
present near the machine.) attacks by limiting connections in defined period.
Field Name
Sample value
Explanation
79
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.
7.6.6.4 HTTP Attack Prevention
HTTP attack sends a complete, legitimate HTTP header, which includes a 'Content-Length' field to specify the size
of the message body to follow. However, the attacker then proceeds to send the actual message body at an extremely
slow rate (e.g. 1 byte/110 seconds). Due to the entire message being correct and complete, the target server will
attempt to obey the 'Content-Length' field in the header, and wait for the entire body of the message to be transmitted,
hence slowing it down.
Field Name
Sample value
Explanation
1.
Enable HTTP limit
Enable/Disable
Limits HTTP connections per period
2.
Limit period
Second/Minute/Hour/Day
Select in what period limit HTTP connections
3.
Limit
“10”
Maximum HTTP connections during the period
4.
Limit burst
“10”
Indicating the maximum burst before the above limit
kicks in.
7.6.6.5 HTTPS Attack Prevention
Field Name
Sample value
Explanation
1.
Enable HTTPS limit
Enable/Disable
Limits HTTPS connections per period
2.
Limit period
Second/Minute/Hour/Day
Select in what period limit HTTPS connections
3.
Limit
“10”
Maximum HTTPS connections during the period
4.
Limit burst
“10”
Indicating the maximum burst
80
7.6.7 Port Scan Prevention
7.6.7.1 Port Scan
Field Name
Sample value
Explanation
1.
Enable
Enable/Disable
Enable port scan prevention
2.
Interval
30
Time interval in seconds counting how much port scan
(10 – 60 sec.)
3.
Scan count
10
How much port scan before blocked
7.6.7.2 Defending type
Field Name
Explanation
1.
SYN-FIN attack
Protect from SYN-FIN attack
2.
SYN-RST attack
Protect from SYN-RST attack
3.
X-Mas attack
Protect from X-Mas attack
4.
FIN scan
Protect from FIN scan
5.
NULLflags attack
Protect from NULLflags attack
7.7 Routing
7.7.1 Static Routes
Static routes specify over which interface and gateway a certain host or network can be reached.
81
Field name
Value
Explanation
1.
Routing table
MAIN/WAN/WAN2/WAN3
Defines the table to use for the route
2.
Interface
MAIN/WAN/WAN2/WAN3
The zone where the target network resides
3.
Destination address
IP address
The address of the destination network
4.
Netmask
IP mask
Mask that is applied to the Target to determine to what actual
IP addresses the routing rule applies
5.
Gateway
IP address
To where the router should send all the traffic that applies to
the rule
6.
Metric
integer
Used as a sorting measure. If a packet about to be routed fits
two rules, the one with the higher metric is applied.
Additional note on Target & Netmask: You can define a rule that applies to a single IP like this: Target - some IP;
Netmask - 255.255.255.255. Furthermore you can define a rule that applies to a segment of IPs like this: Target – some
IP that STARTS the segment; Netmask – Netmask that defines how large the segment is. E.g.:
192.168.55.161
255.255.255.255
Only applies to 192.168.55.161
192.168.55.0
255.255.255.0
Applies to IPs in range 192.168.55.0-192.168.55.255
192.168.55.240
255.255.255.240
Applies 192.168.55.240 - 192.168.55.255
192.168.55.161
255.255.255.0
192.168.55.0 - 192.168.55.255
192.168.0.0
255.255.0.0
192.168.0.0 - 192.168.255.255
7.7.2 Dynamic Routes
7.7.2.1 General
Dynamic routes provide dynamic routing which enables router to select paths according to real-time logical
network layout changes.
82
7.7.2.2 OSPF Protocol
7.7.2.2.1 OSPF General Instance
Field name
Value
Explanation
1.
Enable
Enable/Disable
Enables OSPF protocol
2.
Stub
Enable/Disable
Enable/Disable stub
3.
RFC1583
compatibility
Enable/Disable
Enables OSPF compatibility with RFC1583 specification
4.
Import
All/None/custom
Set if the protocol must import routes
5.
Export
All/None/custom
Set if the protocol must export routes
7.7.2.2.2 OSPF Area
The OSPF network can be divided into sub-domains called areas.
Field name
Value
Explanation
1.
Enable
Enable/Disable
Enable dynamic routes
2.
Router ID
192.168.1.1
Router’s ID
83
Field name
Value
Explanation
1.
Area name
OSPF_area
OSPF area’s name
2.
Enable
Yes/No
Enable/disable OSPF area
To see at specific configuration settings press “edit” button located in newly created OSPF area. A new page with
detailed configuration appears, as shown in the picture below.
Field name
Value
Explanation
1.
Enabled
Enable/Disable
Enable specific OSPF area
2.
Stub
Enable/Disable
Enable/disable stub
3.
Interface
br-lan
A interface that new instance will have
4.
New IP
Name of the new OSPF network configuration. Used for easer
configurations management purpose only
84
7.7.2.3 General Protocol
Field name
Value
Explanation
1.
Enable
Enable/Disable
Enable/Disable settings
2.
Learn
Enable/Disable
Enables routes learning
3.
Persist
Enable/Disable
If checked it allows to store routes. After a restart, routes will be still
configured
4.
Scan time
20
Time between scans
5.
Import
All
Set if the protocol must import routes
6.
Export
All
Set if the protocol must export routes
7.
Enable
Enable/Disable
If checked the protocol will not be configured
8.
Scan time
10
Time between scans
7.7.2.3.1 Static Routes
Field name
Explanation
1.
Prefix
Protocol prefix of incoming or outgoing packet
2.
Type
Protocol type of incoming or outgoing packet
85
7.8 Load Balancing
Load balancing lets users divide traffic between different interfaces.
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.
86
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.
87
Application
Can obtain parameters
Can set parameters
1.
MQTT publisher
o
2.
MODBUS daemon
3.
SSH
4.
RMS
5.
SMS
6.
SNMP
o
7.
JSON-RPC
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.
9 Services
9.1 VRRP
9.1.1 VRRP LAN Configuration Settings
Field name
Sample
Explanation
1.
Enable
Enable/Disable
Enable VRRP (Virtual Router Redundancy Protocol) for LAN
2.
IP address
192.168.1.253
Virtual IP address for LAN's VRRP (Virtual Router Redundancy
Protocol) cluster
3.
Virtual ID
1
Routers with same IDs will be grouped in the same VRRP (Virtual
Router Redundancy Protocol) cluster, range [1-255]
4.
Priority
100
Router with highest priority value on the same VRRP (Virtual Router
Redundancy Protocol) cluster will act as a master, range [1-255]
88
9.1.2 Check Internet connection
Field name
Sample
Explanation
1.
Enable
Enable/Disable
Enable WAN's connection monitoring
2.
Ping IP address
8.8.4.4
A host to send ICMP (Internet Control Message Protocol) packets to
3.
Ping interval
10
Time interval in seconds between two Pings
4.
Ping timeout (sec)
1
Response timeout value, interval [1 - 9999]
5.
Ping packet size
50
ICMP (Internet Control Message Protocol) packet's size, interval [0 -
1000]
6.
Ping retry count
100
Failed Ping attempt’s count before determining that connection is
lost, interval [1 – 9999]
9.2 TR-069
TR-069 is a standard developed for automatic configuration and management of remote devices by Auto
Configuration Servers (ACS).
9.2.1 TR-069 Parameters Configuration
Field name
Sample
Explanation
Enable
Enable/Disable
Enable TR-069 client
Enable Periodic Transmission
Enable / Disable
Enable periodic transmissions of data to server
User name
admin
User name for authentication on TR-069 server
Password
*******
Password for authentication on TR-069 server
URL
http://192.168.1.110:8080
TR-069 server URL address
89
9.3 Web filter
9.3.1 Site blocking
Field name
Sample
Explanation
1.
Enable
Enable/Disable
Enable host name based websites blocking
2.
Mode
Whitelist/Blacklist
Whitelist - allow every site on the list and block everything else. Blacklist -
block every site on the list and allow everything else.
3.
Enable
Enable/Disable
Check to enable site blocking
4.
Host name
www.yahoo.com
Block/allow site with this hostname
9.3.2 Proxy Based Content Blocker
90
Field name
Sample
Explanation
1.
Enable
Enable/Disable
Enable proxy server based URL content blocking. Works with HTTP
protocol only
2.
Mode
Whitelist/Blacklist
Whitelist - allow every part of URL on the list and block everything
else. Blacklist - block every part of URL on the list and allow everything
else
3.
URL
content
example.com
Block/allow any URL containing this string. Example.com, example.*,
*.example.com
9.4 NTP
NTP configuration lets you setup and synchronize routers time.
Field name
Description
Current System time
Local time of router.
Time zone
Time zone of your country.
Enable NTP
Enable system’s time synchronization with time server using NTP (Network Time
91
Protocol)
Update interval
How often router updates systems time
Save time to flash
Save last synchronized time to flash memory
Count of time
synchronizations
Total amount of times that router will do the synchronization. Note: If left blank - the
count will be infinite
Offset frequency
Adjust the minor drift of the clock so that it will be more accurate
Note, that under Time Servers at least one server has to be present, otherwise NTP will not serve its purposes.
9.5 VPN
9.5.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.
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.
92
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).
93
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:
Field name
Explanation
1.
Enabled
Switches configuration on and off. This must be selected to make configuration active.
2.
TUN/TAP
Selects virtual VPN interface type. TUN is most often used in typical IP-level VPN connections,
however, TAP is required to some Ethernet bridging configurations.
3.
Protocol
Defines a transport protocol used by connection. You can choose here between TCP and UDP.
4.
Port
Defines TCP or UDP port number (make sure, that this port allowed by firewall).
5.
LZO
This setting enables LZO compression. With LZO compression, your VPN connection will
generate less network traffic; however, this means higher router CPU loads. Use it carefully
with high rate traffic or low CPU resources.
94
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
address
IP address of OpenVPN server (applicable only for client configuration).
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
IP address of remote network, an actual LAN network behind another VPN endpoint.
13.
Remote network
IP netmask
Subnet mask of remote network, an actual LAN network behind another VPN endpoint.
14.
Max routes
Allow a maximum number of routes to be pulled from an OpenVPN server
15.
HMAC
authentication
algorithm
Sets HMAC authentication algorithm
16.
Additional
HMAC
authentication
Add an additional layer of HMAC authentication on top of the TLS control channel to protect
against DoS attacks
17.
Certificate
authority
Certificate authority is an entity that issues digital certificates. A digital certificate certifies the
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.5.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.
95
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.
Field name
Value
Explanation
1.
Enable
Enabled/Disabled
Check box to enable IPSec.
2.
IKE version
IKEv1 or IKEv2
Method of key exchange
3.
Mode
“Main” or
“Aggressive”
ISAKMP (Internet Security Association and Key Management Protocol)
phase 1 exchange mode
4.
My identifier type
Address, FQDN,
User FQDN
Choose one accordingly to your IPSec configuration
5.
My identifier
Set the device identifier for IPSec tunnel.
In case RUT has Private IP, its identifier should be its own LAN network
address. In this way, the Road Warrior approach is possible.
6.
Dead Peer
Detection
Enabled/Disabled
The values clear, hold and restart all active DPD
7.
Pre shared key
A shared password to authenticate between the peer
96
8.
Remote VPN
endpoint
Domain name or IP address. Leave empty or any
9.
IP
address/Subnet
mask
Remote network secure group IP address and mask used to determine to
what subnet an IP address belongs to. Range [0-32]. IP should differ from
device LAN IP
10.
Enable keep alive
Enabled/Disabled
Enable tunnel keep alive function
11.
Host
A host address to which ICMP (Internet Control Message Protocol) echo
requests will be send
12.
Ping period (sec)
Send ICMP echo request every x seconds. Range [0-999999]
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.
Field name
Value
Explanation
1.
Encryption
algorithm
DES, 3DES, AES 128, AES 192, AES256
The encryption algorithm must match with another
incoming connection to establish IPSec
2.
Authentication
MD5, SHA1, SHA256, SHA384, SHA512
The authentication algorithm must match with another
incoming connection to establish IPSec
3.
Hash algorthm
MD5, SHA1, SHA256, SHA384, SHA512
The hash algorithm must match with another incoming
connection to establish IPSec
4.
DH group
MODP768, MODP1024, MODP1536,
MODP2048, MODP3072, MODP4096
The DH (Diffie-Helman) group must with another
incoming connection to establish IPSec
4.
PFS group
MODP768, MODP1024, MODP1536,
MODP2048, MODP3072, MODP4096,
No PFS
The PFS (Perfect Forward Secrecy) group must match with
another incoming connection to establish IPSec
5.
Lifetime
Hours, Minutes, Seconds
The time duration for phase
97
9.5.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:
1. Source and destination IP addresses.
2. Tunnel local IP address
3. Distant network IP address and Subnet mask.
98
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].
99
9.5.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).
Field name
Explanation
1.
Enable
Check the box to enable the PPTP function.
2.
Local IP
IP Address of this device (RUT)
3.
Remote IP range begin
IP address leases beginning
4.
Remote IP range end
IP address leases end
5.
Username
Username to connect to PPTP (this) server
6.
Password
Password to connect to PPTP server
7.
User IP
Users IP address
Field name
Explanation
1.
Enable
Enable current configuration
100
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.5.5 L2TP
Allows setting up a L2TP server or client. Below is L2TP server configuration example.
Field name
Explanation
1.
Enable
Check the box to enable the L2TP Tunnel function.
2.
Local IP
IP Address of this device (RUT)
3.
Remote IP range begin
IP address leases beginning
4.
Remote IP range end
IP address leases end
5.
Username
Username to connect to L2TP (this) server
6.
Password
Password to connect to L2TP server
Client configuration is even simpler, which requires only Servers IP, Username and Password.
9.6 Dynamic DNS
Dynamic DNS (DDNS) is a domain name service allowing to link dynamic IP addresses to static hostname.
To start using this feature firstly you should register to DDNS service provider (example list is given in description).
101
You are provided with add/delete buttons to manage and use different DDNS configurations at the same time!
You can configure many different DDNS Hostnames in the main DDNS Configuration section.
To edit your selected configuration, hit Edit.
Field name
Value
Explanation
1.
Enable
Enable/Disable
Enables current DDNS configuration.
2.
Status
Timestamp of the last IP check or update.
3.
Service
1. dydns.org
2. 3322.org
3. no-ip.com
4. easydns.com
5. zoneedit.com
Your dynamic DNS service provider selected from the list.
In case your DDNS provider is not present from the ones provided,
please feel free to use "custom" and add hostname of the update
URL.
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
Private
Custom
This option allows you to select specific RUT interface, and then send
the IP address of that interface to DDNS server. So if, for example,
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.
102
8.
Network
WAN
Source network
9.
IP renew interval
(min)
10 (minutes)
Time interval (in minutes) to check if the IP address of the device
have changed.
10.
Force IP renew
472 (minutes)
Time interval (in minutes) to force IP address renew.
9.7 SMS Utilities
RUT950 has extensive amount of various SMS Utilities. These are subdivided into 6 sections: SMS Utilities, Call
Utilities, User Groups, SMS Management, Remote Configuration and Statistics.
9.7.1 SMS Utilities
All configuration options are listed below:
- 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.
103
Field name
Explanation
Notes
1.
Reboot
Enable
This check box will enable and
disable SMS reboot function.
Allows router restart via SMS.
Action
The action to be performed
when this rule is met.
SMS text
SMS text which will reboot
router.
SMS text can contain letters, numbers, spaces and
special symbols. Capital letters also matters.
Authorization method
What kind of authorization to
use for SIM management.
No authorization, by serial or by router admin
password.
Allowed users
Whitelist of allow users
From all numbers, from group or from single number.
Get status via SMS
after reboot
Check this to recieve
connection status via SMS after
a reboot.
If you select this box, router will send status once it
has rebooted and is operational again.
This is both separate SMS Rule and an option under
SMS Reboot rule.
Message text
Which status information
should be included in SMS:
Data state, Operator,
Connection type, Signal
Strength, Connection State, IP
You can select which status elements to display.
2.
Get status
Enable
Check this to receive
connection status via SMS.
Allows to get router‘s status via SMS. This is both
separate SMS Rule and an option under SMS Reboot
rule.
Action
The action to be performed
104
when this rule is met.
Enable SMS Status
This check box will enable and
disable SMS status function.
SMS status is disabled by default.
SMS text
SMS text which will send
routers status.
SMS text can contain letters, numbers, spaces and
special symbols. Capital letters also matters.
Authorization method
What kind of authorization to
use for SIM management.
No authorization, by serial or by router admin
password.
Allowed users
Whitelist of allow users
From all numbers, from group or from single number.
Message text
Which status information
should be included in SMS:
Data state, Operator,
Connection type, Signal
Strength, Connection State, IP
You can select which status elements to display.
3.
Get OpenVPN status
Enable
This check box will enable and
disable this function.
Allows to get OpenVPN‘s status via SMS.
Action
The action to be performed
when this rule is met.
SMS text
SMS text which will send
OpenVPN status.
SMS text can contain letters, numbers, spaces and
special symbols. Capital letters also matters.
Authorization method
What kind of authorization to
use for SIM management.
No authorization, by serial or by router admin
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
disable this function.
Allows Wi-Fi control via SMS.
Action
The action to be performed
when this rule is met.
Turn WiFi ON or OFF.
SMS text
SMS text which will turn Wi-Fi
ON/OFF.
SMS text can contain letters, numbers, spaces and
special symbols. Capital letters also matters.
Authorization method
What kind of authorization to
use for SIM management.
No authorization, by serial or by router admin
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
disable this function.
Allows mobile control via SMS.
Action
The action to be performed
when this rule is met.
Turn mobile ON or OFF.
SMS text
SMS text which will turn mobile
data ON/OFF.
SMS text can contain letters, numbers, spaces and
special symbols. Capital letters also matters.
Authorization method
What kind of authorization to
use for SIM management.
No authorization, by serial or by router admin
password.
Allowed users
Whitelist of allow users
From all numbers, from group or from single number.
Write to config
Permanently saves mobile
network state.
With this setting enabled, router will keep mobile
state even after reboot.
105
If it is not selected, router will revert mobile state
after reboot.
6.
Manage OpenVPN
Enable
This check box will enable and
disable this function.
Allows OpenVPN control via SMS.
Action
The action to be performed
when this rule is met.
Turn OpenVPN ON or OFF.
SMS text
Keyword which will turn
OpenVPN ON/OFF.
SMS text can contain letters, numbers, spaces and
special symbols. Capital letters also matters.
After Keyword you have to write OpenVPN name.
Authorization method
What kind of authorization to
use for SIM management.
No authorization, by serial or by router admin
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
disable this function.
Allows to change mobile settings via SMS.
Action
The action to be performed
when this rule is met.
SMS text
Key word that will precede
actual configuration
parameters.
SMS text can contain letters, numbers, spaces and
special symbols. Capital letters also matters.
Authorization method
What kind of authorization to
use for SIM management.
No authorization, by serial or by router admin
password.
Allowed users
Whitelist of allow users
From all numbers, from group or from single number.
Mobile Settings via SMS parameters:
Parameter
Value(s)
Explanation
apn=
e.g. internet.gprs
Sets APN. i.e: apn=internet.gprs
dialnumber=
e.g. *99***1#
Sets dial number
auth_mode=
none
pap
chap
Sets authentication mode
service=
Auto
4gpreferred
4gonly
3gpreferred
3gonly
2gpreferred
2gonly
You can add as many phone numbers as you need.
Dropdown list with additional rows will show up if you
click on “add” icon at the end of phone number row.
username=
user
Used only if PAP or CHAP authorization is selected
password=
user
Used only if PAP or CHAP authorization is selected
All Mobile settings can be changed in one SMS. Between each <parameter=value> pair a space symbol is
necessary.
Example: cellular apn=internet.gprs dialnumber=*99***1#auth_mode=pap service=3gonly username=user
password=user
Important Notes:
106
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.
Field name
Explanation
Notes
8.
Get list of profiles
Enable
This check box will enable and
disable this function.
Allows to get list of profiles via SMS.
Action
The action to be performed
when this rule is met.
SMS text
SMS text which will send list of
profiles.
SMS text can contain letters, numbers, spaces and
special symbols. Capital letters also matters.
Authorization method
What kind of authorization to
use for SIM management.
No authorization, by serial or by router admin
password.
Allowed users
Whitelist of allow users
From all numbers, from group or from single number.
9.
Change profile
Enable
This check box will enable and
disable this function.
Allows profile change via SMS.
Action
The action to be performed
when this rule is met.
SMS text
Keyword which will change
active profile.
SMS text can contain letters, numbers, spaces and
special symbols. Capital letters also matters.
After Keyword you have to write profile name.
Authorization method
What kind of authorization to
use for SIM management.
No authorization, by serial or by router admin
password.
Allowed users
Whitelist of allow users
From all numbers, from group or from single number.
10.
SSH access Control
Enable
This check box will enable and
disable this function.
Allows SSH access control via SMS.
Action
The action to be performed
when this rule is met.
SMS text
SMS text which will turn SSH
access ON/OFF.
SMS text can contain letters, numbers, spaces and
special symbols. Capital letters also matters.
Authorization method
What kind of authorization to
use for SIM management.
No authorization, by serial or by router admin
password.
Allowed users
Whitelist of allow users
From all numbers, from group or from single number.
Enable SSH access
Enable this to reach router via
SSH from LAN (Local Area
Network).
If this box is selected, SMS will enable SSH access from
LAN. If this box is not selected, SMS will disable SSH
access from LAN.
Enable remote SSH
access
Enable this to reach router via
SSH from WAN (Wide Area
Network).
If this box is selected, SMS will enable SSH access from
WAN. If this box is not selected, SMS will disable SSH
access from WAN.
11.
Web access Control
Enable
This check box will enable and
disable this function.
Allows Web access control via SMS.
Action
The action to be performed
when this rule is met.
SMS text
SMS text which will turn Web
SMS text can contain letters, numbers, spaces and
107
access ON/OFF.
special symbols. Capital letters also matters.
Authorization method
What kind of authorization to
use for SIM management.
No authorization, by serial or by router admin
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
HTTP from LAN (Local Area
Network).
If this box is selected, SMS will enable HTTP access
from LAN. If this box is not selected, SMS will disable
HTTP access from LAN.
Enable remote HTTP
access
Enable this to reach router via
HTTP from WAN (Wide Area
Network).
If this box is selected, SMS will enable HTTP access
from WAN. If this box is not selected, SMS will disable
HTTP access from WAN.
Enable remote HTTPS
access
Enable this to reach router via
HTTPS from WAN (Wide Area
Network).
If this box is selected, SMS will enable HTTPS access
from WAN. If this box is not selected, SMS will disable
HTTPS access from WAN.
12.
Restore to default
Enable
This check box will enable and
disable this function.
Allows to restore router to default settings via SMS.
Action
The action to be performed
when this rule is met.
Router will reboot after this rule is executed.
SMS text
SMS text which will turn Wi-Fi
ON/OFF.
SMS text can contain letters, numbers, spaces and
special symbols. Capital letters also matters.
Authorization method
What kind of authorization to
use for SIM management.
No authorization, by serial or by router admin
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
disable this function.
Allows SIM switch via SMS.
Action
The action to be performed
when this rule is met.
SMS text
SMS text which will change
active SIM card to another one.
SMS text can contain letters, numbers, spaces and
special symbols. Capital letters also matters.
Authorization method
What kind of authorization to
use for SIM management.
No authorization, by serial or by router admin
password.
Allowed users
Whitelist of allow users
From all numbers, from group or from single number.
Sender phone number
Phone number of person who
can receive router status via
SMS message.
You can add as many phone numbers as you need.
Dropdown list with additional rows will show up if you
click on “add” icon at the end of phone number row.
14.
Force FW upgrade
from server
Enable
This check box will enable and
disable this function.
Allows to upgrade router‘s FW via SMS.
Action
The action to be performed
when this rule is met.
Router will reboot after this rule is executed.
SMS text
SMS text which will force router
to upgrade firmware from
server.
SMS text can contain letters, numbers, spaces and
special symbols. Capital letters also matters.
Authorization method
What kind of authorization to
use for SIM management.
No authorization, by serial or by router admin
password.
Allowed users
Whitelist of allow users
From all numbers, from group or from single number.
108
15.
Force Config update
from server
Enable
This check box will enable and
disable this function.
Allows to upgrade router‘s Config via SMS.
Action
The action to be performed
when this rule is met.
Router will reboot after this rule is executed.
SMS text
SMS text which will force router
to upgrade configuration from
server.
SMS text can contain letters, numbers, spaces and
special symbols. Capital letters also matters.
Authorization method
What kind of authorization to
use for SIM management.
No authorization, by serial or by router admin
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
disable this function.
Allows monitoring control via SMS.
Action
The action to be performed
when this rule is met.
Turn monitoring ON or OFF.
SMS text
SMS text which will turn
monitoring ON/OFF
SMS text can contain letters, numbers, spaces and
special symbols. Capital letters also matters.
Authorization method
What kind of authorization to
use for SIM management.
By serial or by router admin password.
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.
9.7.2 Call Utilities
Allow users to call to the router in order to perform one of the actions: Reboot, Get Status, turn Wi-Fi ON/OFF,
turn Mobile data ON/OFF. Only thing that is needed is to call routers SIM card number from allowed phone (user) and
RUT9 will perform all actions that are assigned for this particular number. To configure new action on call rules you just
need to click the Add button in the „New Call rule” section. After that, you get in to the “Modify Call Rule section”.
109
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
after reboot
Enable/Disable
Enables automatic message sending with router status information
after reboot
9.7.2.1 Incoming Calls
Field name
Sample
Explanation
1.
Reject unrecognized
incoming calls
Enable/Disable
If a call is made from number that is not in the active rule list, it can
be rejected with this option
9.7.3 User Groups
Give possibility to group phone numbers for SMS management purposes. You can then later use these groups in
all related SMS functionalities. This option helps if there are several Users who should have same roles when managing
router via SMS. You can create new user group by entering group name and clicking on Add button in “Create New User
Group” section. After that you get to “Modify User Group” section.
Field name
Sample
Explanation
1.
Group name
Group1
Name of grouped phone numbers
2.
Phone number
+37061111111
Number to add to users group, must match international format.
You can add phone numbers fields by clicking on the green + symbol
110
9.7.4 SMS Management
9.7.4.1 Read SMS
In SMS Management page Read SMS you can read and delete received/stored SMS.
9.7.4.2 Send SMS
Field name
Sample
Explanation
1.
Phone number
+3701111111
Recipients phone number. Should be preceded with country code,
i.e. “+370”
2.
Message
My text.
Message text, special characters are allowed.
9.7.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.
111
Field name
Sample
Explanation
1.
Save messages on SIM
Enabled / Disabled
Enables received message storing on SIM card
2.
SIM card memory
Used: 0
Available: 50
Information about used/available SIM card memory
3.
Leave free space
1
How much memory (number of message should be left free
9.7.5 Remote Configuration
RUT9xx can be configured via SMS from another RUT9xx. You only have to select which configuration details have
to be sent, generate the SMS Text, type in the phone number and Serial number of the router that you wish to configure
and Send the SMS.
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.
9.7.5.1 Receive configuration
This section controls how configuration initiation party should identify itself. In this scenario RUT950 itself is being
configured.
Field name
Values
Notes
112
Enable
Enabled / Disabled
Enables router to receive configuration
Authorization method
No authorization /
By serial
By administration password
Describes what kind of authorization to use for SMS
management. Method at Receiving and Sending ends
must match
Allowed users
From all numbers
From group
From single number
Gives greater control and security measures
Note, that for safety reasons Authorization method should be configured before deployment of the router.
9.7.5.2 Send configuration
This section lets you configure remote RUT950 devices. The authorization settings must confirm to those that are
set on the receiving party.
Field name
Values
Notes
113
1.
Generate SMS
New/From current
configuration
Generate new SMS settings or use current device
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
Use ndis mode
An underlying agent that will be used for mobile data
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
method
CHAP/PAP/None
Select an authentication method that will be used to
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
4G (LTE ) preferred
4G (LTE) only
3G preferred
3G only
2G preferred
2G only
You can add as many phone numbers as you need.
Dropdown list with additional rows will show up if
you click on “add” icon at the end of phone number
row.
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
114
Field name
Values
Notes
Message text field
Generated configuration
message
Here you can review and modify configuration
message text to be sent
Phone number
“+37060000001”
A phone number of router which will receive the
configuration
Authorization method
No authorization
By serial
By router admin password
What kind of authorization to use for remote
configuration
9.7.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.8 SNMP
SNMP settings window allows you to remotely monitor and send GSM event information to the server.
115
9.8.1 SNMP Settings
Field name
Sample
Explanation
1.
Enable SNMP service
Enable/Disable
Run SNMP (Simple Network Management Protocol) service on
system's start up
2.
Enable remote access
Enable/Disable
Open port in firewall so that SNMP (Simple Network
Management Protocol) service may be reached from WAN
3.
Port
161
SNMP (Simple Network Management Protocol) service's port
4.
Community
Public/Private/Custom
The SNMP (Simple Network Management Protocol) Community
is an ID that allows access to a router's SNMP data
5.
Community name
custom
Set custom name to access SNMP
6.
Location
Location
Trap named sysLocation
7.
Contact
email@example.com
Trap named sysContact
8.
Name
Name
Trap named sysName
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
116
9.8.2 TRAP Settings
Field name
Sample
Explanation
1.
SNMP Trap
Enable/Disable
Enable SNMP (Simple Network Management Protocol) trap
functionality
2.
Host/IP
192.168.99.155
Host to transfer SNMP (Simple Network Management Protocol)
traffic to
3.
Port
162
Port for trap's host
4.
Community
Public/Private
The SNMP (Simple Network Management Protocol) Community is an
ID that allows access to a router's SNMP data
9.9 SMS Gateway
9.9.1 Post/Get Configuration
Post/Get Configuration allows you to perform actions by writing these requests URI after your device IP address.
117
Field name
Values
Notes
Enable
Enabled / Disabled
Enable SMS management functionality through
POST/GET
User name
admin
User name used for authorization
Password
*******
Password used for authorization (default- admin01)
Do not forget to change parameters in the url according to your POST/GET Configuration!
9.9.1.1 SMS by HTTP POST/GET
It is possible to read and send SMS by using valid HTTP POST/GET syntax. Use web browser or any other
compatible software to submit HTTP POST/GET string to router. Router must be connected to GSM network when using
“SMS send” feature.
Action
POST/GET url e.g.
1.
View mobile
messages list
/cgi-bin/sms_list?username=admin&password=admin01
2.
Read mobile
message
/cgi-bin/sms_read?username=admin&password=admin01&number=1
3.
Send mobile
messages
/cgi-bin/sms_send?username=admin&password=admin01&number=0037060000001&text=testmessage
4.
View mobile
messages
total
/cgi-bin/sms_total?username=admin&password=admin01
5.
Delete mobile
message
/cgi-bin/sms_delete?username=admin&password=admin01&number=1
9.9.1.2 Syntax of HTTP POST/GET string
HTTP POST/GET string
Explanati
on
http://{IP_ADD
RESS}
/cgi-bin/sms_read?
username={your_user_name}&password={your_password}&number={MESSAGE_INDEX}
Read
message
/cgi-bin/sms_send?
username={your_user_name}&password={your_password}&number={PHONE_NUMBER}
&text={MESSAGE_TEXT}
Send
message
118
/cgi-bin/sms_delete?
username={your_user_name}&password={your_password}&number={MESSAGE_INDEX}
Delete
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.
9.9.1.3 Parameters of 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.
9.9.1.4 Possible responses after command execution
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
9.9.1.5 HTTP POST/GET string examples
http://192.168.1.1/cgi-bin/sms_read?username=admin&password=admin01&number=2
http://192.168.1.1/cgi-bin/sms_send?username=admin&password=admin01&number=0037060000001&text=message
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
119
9.9.2 Email to SMS
Field name
Values
Notes
Enable
Enable/Disable
Allows to convert received Email to SMS
POP3 server
“pop.gmail.com”
POP3 server address
Server port
“995”
Server authentication port
User name
“admin”
User name using for server authentication
Password
“admin01”
Password using for server authentication
Secure connection
(SLL)
Enable/Disable
(SSL) is a protocol for transmitting private documents
via the Internet. SSL uses a cryptographic system that
uses two keys to encrypt data − a public key known to
everyone and a private or secret key known only to
the recipient of the message.
Check mail every
Minutes
Hours
Days
Mail checking period
9.9.3 Scheduled Messages
Scheduled messages allow to periodically sending mobile messages to specified number.
120
9.9.3.1 Scheduled Messages Configuration
Field name
Values
Notes
Enable
Enable/Disable
Activates periodical messages sending.
Recipient’s phone
number
“+37060000001”
Phone number that will receive messages.
Message text
“Test”
Message that will be send.
Message sending
interval
Day/Week/Month/Year
Message sending period.
9.9.4 Auto Reply Configuration
Auto reply allows replying to every message that router receives to everyone or to listed numbers only.
Field name
Values
Notes
Enable
Enable/Disable
Enable auto reply to every received mobile message.
Don’t save received
message
Enable/Disable
If enabled, received messages are not going to be
saved
Mode
Everyone /
Listed numbers
Specifies from which senders received messages are
going to be replied.
Message
“Text”
Message text that will be sent in reply.
121
9.9.5 SMS Forwarding
9.9.5.1 SMS Forwarding To HTTP
This functionality forwards mobile messages from all or only specified senders to HTTP, using either POST or GET
methods.
Field name
Values
Notes
Enable
Enable / Disable
Enable mobile message forwarding to HTTP
Method
POST / GET
Defines the HTTP transfer method
URL
192.168.99.250/getpost/index.php
URL address to forward messages to
Number value name
“sender”
Name to assign for sender’s phone number value in
query string
Message value name
“text”
Name to assign for message text value in query string
Extra data pair 1
Var1 - 17
If you want to transfer some extra information
through HTTP query, enter variable name on the left
field and its value on the right
Extra data pair 2
Var2 – “go”
If you want to transfer some extra information
through HTTP query, enter variable name on the left
field and its value on the right
Mode
All messages/From listed numbers
Specifies which senders messages to forward
122
9.9.5.2 SMS Forwarding to SMS
This functionality allows forwarding mobile messages from specified senders to one or several recipients.
Field name
Values
Notes
Enable
Enable / Disable
Enable mobile message forwarding
Add sender number
Enable / Disable
If enabled, original senders number will be added at
the end of the forwarded message
Mode
All message /
From listed numbers
Specifies from which senders received messages are
going to be forwarded.
Recipients phone
numbers
+37060000001
Phone numbers to which message is going to be
forwarded to
9.9.5.3 SMS Forwarding to Email
This functionality forwards mobile messages from one or several specified senders to email address.
123
Field name
Values
Notes
1.
Enable
Enable / Disable
Enable mobile message forwarding to email
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
numbers
Choose which senders messages to forward to email
9.9.6 SMPP
Field name
Values
Explanation
Enable
Enable/Disable
Enables SMPP server
User name
admin
User name for authentication on SMPP server
Password
●●●●●●●
Password for authentication on SMPP server
Server port
7777
A port will be used for SMPP server communications.
Allowed all not used ports [0-65535]
124
9.10 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.).
9.10.1 General settings
9.10.1.1 Main settings
Field name
Explanation
1.
Enabled
Check this flag to enable hotspot functionality on the router.
2.
AP IP
Access Point IP address. This will be the address of the router on the hotspot network. The
router will automatically create a network according to its own IP and the CIDR number
that you specify after the slash. E.g. “192.168.2.254/24” means that the router will create
a network with the IP address 192.168.182.0, netmask 255.255.255.0 for the express
purpose of containing all the wireless clients. Such a network will be able to have 253
clients (their IP addresses will be automatically granted to them and will range from
192.168.2.1 to 192.168.2.253).
Authentication mode: External radius
1.
Radius server #1
The IP address of the RADIUS server that is to be used for Authenticating your wireless
clients.
125
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
page
Enables the use of external landing page.
2.
Landing page
address
The address of external landing page
3.
HTTPS redirect
Redirects HTTP pages to landing page.
Authentication mode: SMS OTP
9.10.1.2 Session settings
Field name
Explanation
1.
Logout address
IP address to instantly logout a client addressing it
2.
Enable
Enable address accessing without first authenticating
3.
Address
Domain name, IP address or network segment
4.
Port
Port number
5.
Allow subdomains
Enable/Disable subdomains
126
9.10.2 Internet Access Restriction Settings
Allows disable internet access on specified day and hour of every week.
9.10.3 Logging
9.10.3.1 Configuration
Field name
Explanation
1.
Enable
Check this box if you want to enable wireless traffic logging. This feature will produce logs
which contain data on what websites each client was visiting during the time he was
connected to your hotspot.
2.
Server address
The IP address of the FTP server to which you want the logs uploaded.
127
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.
Field name
Explanation
1.
Mode
The mode of the schedule. Use “Fixed” if you want the uploading to be done on a specific
time of the day. Use “Interval” if you want the uploading to be done at fixed interval.
2.
Interval
Shows up only when “Mode” is set to Interval. Specifies the interval of regular uploads on
one specific day. E.g. If you choose 4 hours, the uploading will be done on midnight, 4:00,
8:00, 12:00, 16:00 and 20:00.
3.
Days
Uploading will be performed on these days only
4.
Hours, Minutes
Shows up only when “Mode” is set to Fixed. Uploading will be done on that specific time of
the day. E.g. If you want to upload your logs on 6:48 you will have to simply enter hours: 6
and minutes: 48.
9.10.3.2 Log
128
9.10.4 Landing Page
9.10.4.1 General Landing Page Settings
With this functionality you can customize your Hotspot Landing page.
Field name
Explanation
1.
Page title
Will be seen as landing page title
2.
Theme
Landing page theme selection
3.
Upload login page
Allows to upload custom landing page theme
4.
Login page file
Allows to download and save your landing page file
In the sections – “Terms Of Services”, “Background Configuration”, “Logo Image Configuration”, “Link
Configuration”, “Text Configuration” you can customize various parameters of landing page components.
129
9.10.4.2 Template
In this page you can review landing page template HTML code and modify it.
9.10.5 Radius server configuration
An authentication and accounting system used by many Internet Service Providers (ISPs). When you dial in to the
ISP you must enter your username and password. This information is passed to a RADIUS server, which checks that the
information is correct, and then authorizes access to the ISP system.
130
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.10.6 Statistics
On hotspot statistics page you can review statistical information about hotspot instances.
9.11 CLI
CLI or Comand Line Interface functionality allows you to enter and execute comands into routers terminal.
131
9.12 Auto Reboot
9.12.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.
Field name
Explanation
Notes
Enable
This check box will enable or disable Ping reboot
feature.
Ping Reboot is disabled by
default.
Action if no echo is
received
Action after the defined number of unsuccessful
retries
No echo reply for sent ICMP
(Internet Control Message
Protocol) packet received
Interval between pings
Time interval in minutes between two Pings.
Minimum time interval is 5
minutes.
Ping timeout (sec)
Time after which consider that Ping has failed.
Range(1-9999)
Packet size
This box allows to modify sent packet size
Should be left default, unless
necessary otherwise
Retry count
Number of times to try sending Ping to server after
time interval if echo receive was unsuccessful.
Minimum retry number is 1.
Second retry will be done after
defined time interval.
Interface
Interface used for connection
Host to ping from SIM 1
IP address or domain name which will be used to
send ping packets to. E.g. 127.0.0.1 (or
www.host.com if DNS server is configured
correctly)
Ping packets will be sending
from SIM1.
Host to ping from SIM 2
IP address or domain name which will be used to
send ping packets to. E.g. 127.0.0.1 (or
www.host.com if DNS server is configured
correctly)
Ping packets will be sending
from SIM2.
132
9.12.2 Periodic Reboot
Field name
Explanation
1.
Enable
This check box will enable or disable Periodic reboot feature.
2.
Days
This check box will enable router rebooting at the defined days.
3.
Hours, Minutes
Uploading will be done on that specific time of the day
9.13 UPNP
9.13.1 General Settings
UPnP allows clients in the local network to automatically configure the router.
9.13.2 Advanced Settings
133
Field name
Explanation
1.
Use UPnP port mapping
Enable UPnP port mapping functionality
2.
Use NAT-PMP port
mapping
Enable NAT-PMP mapping functionality
3.
Device UUID
Specify Universal unique ID of the device
9.13.3 UPnP ACLs
ACLs specify which external ports may be redirected to which internal addresses and ports.
Field name
Explanation
1.
Comment
Add comment to this rule
2.
External ports
External ports which may be redirected
3.
Internal addresses
Internal address to be redirect to
4.
Internal ports
Internal ports to be redirect to
5.
Action
Allow or forbid UPNP service to open the specified port
9.13.4 Active UPnP Redirects
9.14 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.
134
Field name
Value
Explanation
1.
Interface
WAN/LAN/PPP
2.
Enable
Enable/Disable
Enable/disable settings
3.
Calculate overhead
Enable/Disable
Check to decrease upload and download ratio to prevent link
saturation
4.
Half-duplex
Enable/Disable
Check to enable data transmission in both direction on a single
carrier
5.
Download speed (kbit/s)
1024
Specify maximal download speed
6.
Upload speed (kbit/s)
128
Specify maximal upload speed
Field name
Explanation
1.
Target
Select target for which rule will be applied
2.
Source host
Select host from which data will be transmitted
3.
Destination host
Select host to which data will be transmitted
4.
Service
Select service for which rule will be applied
5.
Protocol
Select data transmission protocol
6.
Ports
Select which port will be used for transmission
7.
Number of bytes
Specify the maximal number of bytes for connection
9.15 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.
135
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)
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.
136
,
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.
137
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.
Parameter name
Parameter description
temperature
Get temperature of the module in 0.1 degrees Celcium
operator
Get current operator’s name
signal
Get signal strength in dBm
network
Get current network type (2G, 3G, 4G, etc’)
138
connection
Check if data connection is available
wan
Get WAN’s IP address
uptime
Get system uptime in seconds
name
Get router’s name
digital1
Get value of digital input no. 1
digital2
Get value of digital input no. 2
analog
Get value of analog input
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.
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.
Publisher
Subscribe router/get
Subscribe
get/01234567/command
Publish router/get
id
Publish router/id
01234567
Publish get/01234567/command
uptime
Broke
r
Client
Publish router/01234567/uptime 15248
139
9.16 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.
Required value
Representation
Register number
Number of registers
System uptime
32 bit unsigned integer
1
2
GSM signal strength (dBm)
32 bit integer
2
2
System temperature in 0.1 degrees
Celcium
32 bit integer
3
2
System hostname
Text
4
16
GSM operator name
Text
5
16
Router serial number
Text
6
16
Router MAC address
Text
7
16
Router name
Text
8
16
Current SIM card
Text
9
16
Network registration
Text
10
16
Network type
Text
11
16
Digital input 1
32 bit integer
12
2
Digital input 2
32 bit integer
13
2
Current WAN IP address
32 bit unsigned integer
14
2
Analog input
32 bit integer
15
2
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
140
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).
Value to set
Description
Register number
Register value
Digital output 1 (on/off)
Change the state of the digital output
number 1
1
1/0
Digital output 2 (on/off)
Change the state of the digital output
number 2
2
1/0
Switch WiFi (on/off)
Allows to switch WiFi on or off
10
1/0
Switch mobile data connection
(on/off)
Turns on or off mobile data
connection
11
1/0
Switch SIM card (SIM1, SIM2,
SIM1->SIM2 and SIM2->SIM1)
Allows to change SIM card in use, 3
possible options are supported
12
0/1/2
Change APN
Allows to change APN
13
APN code
Reboot
Reboots a router
20
1
10 System
10.1 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:
Step 1 (General change)
First, the wizard prompts you to change the default password. Simply enter the same password into both
Password and Confirmation fields and press Next.
Step 2 (Mobile Configuration)
Next we have to enter your mobile configuration. On a detailed instruction on how this should be done see the
Mobile section under Network
141
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.
142
When you’re done with the configuration wizard, press Save.
10.2 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.
143
10.3 Administration
10.3.1 General
Field name
Explanation
1.
Router name
Enter your new router name.
2.
Host name
Enter your new host name
3.
New Password
Enter your new administration password.
Changing this password will change SSH password as well.
4.
Confirm new password
Re-enter your new administration password.
5.
Language
Website will be translated into selected language.
6.
IPv6 support
Enable IPv6 support on router
7.
Show mobile info at login page
Show operator and signal strength at login page.
8.
Show WAN IP at login page
Show WAN IP at login page.
9
On/Off LEDs
If uncheck, all routers LEDs are off.
10
Restore to default
Router will be set to factory default settings
Important notes:
144
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:
User Name: admin
Password: admin01
10.3.2 Troubleshoot
Field name
Explanation
1.
System log level
Debug level should always be used, unless instructed otherwise.
2.
Save log in
Default RAM memory should always be used unless instructed otherwise.
3.
Include GSMD information
Default setting – enabled should be used, unless instructed otherwise.
4.
Include PPPD information
Default setting – disabled should be used, unless instructed otherwise.
5.
Include Chat script
information
Default setting – enabled should be used, unless instructed otherwise.
6.
Include network topology
information
Default setting – disabled should be used, unless instructed otherwise.
7.
System Log
Provides on-screen System logging information. It does not, however, substitute
troubleshooting file that can be downloaded from System -> Backup and Firmware
menu.
8.
Kernel Log
Provides on-screen Kernel logging information. It does not, however, substitute
troubleshooting file that can be downloaded from System -> Backup and Firmware
menu.
9.
Troubleshoot file
Downloadable archive, that contains full router configuration and all System log
files.
145
10.3.3 Backup
Field name
Explanation
1.
Backup archive
Download current router settings file to personal computer. This file can be loaded to
other RUT950 with same Firmware version in order to quickly configure it.
2.
Restore from backup
Select, upload and restore router settings file from personal computer.
146
10.3.3.1 Access control
10.3.3.1.1 General
Field name
Explanation
1.
Enable SSH access
Check box to enable SSH access.
2.
Remote SSH access
Check box to enable remote SSH access.
3.
Port
Port to be used for SSH connection
4.
Enable HTTP access
Enables HTTP access to router
5.
Enable remote HTTP
access
Enables remote HTTP access to router
6.
Port
Port to be used for HTTP communication
7.
Enable remote
HTTPS access
Enables remote HTTPS access to router
8.
Port
Port to be used for HTTPS communication
9.
Enable CLI
Enables Command Line Interface
10.
Enable remote CLI
Enables remote Command Line Interface
11.
Port
Port to be used for CLI communication
Note: The router has 2 users: “admin” for WebUI and “root” for SSH. When logging in via SSH use “root”.
147
10.3.3.1.2 Safety
Field name
Explanation
1.
SSH access secure
enable
Check box to enable SSH access secure functionality.
2.
Clean after reboot
If check box is selected – blocked addresses are removed after every reboot.
3.
Fail count
Specifies maximum connection attempts count before access blocking.
4.
WebUI access
secure enable
Check box to enable secure WebUI access.
10.3.4 Diagnostics
Field name
Explanation
1.
Host
Enter server IP address or hostname.
148
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.3.5 MAC Clone
Field name
Explanation
1.
WAN MAC address
Enter new WAN MAC address.
10.3.6 Overview
Select which information you want to get in Overview window (Status -> Overview).
Field name
Explanation
149
1.
Mobile
Check box to show Mobile table in Overview page
2.
SMS counter
Check box to show SMS counter table in Overview page
3.
System
Check box to show System table in Overview page
4.
Wireless
Check box to show Wireless table in Overview page
5.
WAN
Check box to show WAN table in Overview page
6.
Local network
Check box to show Local network table in Overview page
7.
Access control
Check box to show Access control table in Overview page
8.
Recent system events
Check box to show Recent system events table in Overview page
9.
Recent network events
Check box to show Recent network events table in Overview page
10.
<Hotspot name> Hotspot
Check box to show Hotspot instance table in Overview page
11.
VRRP
Check box to show VRRP table in Overview page
12.
Monitoring
Check box to show Monitoring table in Overview page
10.3.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.
Field name
Explanation
1.
Enable remote monitoring
Check box to enable/disable remote monitoring
2.
Monitoring
Shows monitoring status.
3.
Router LAN MAC address
MAC address of the Ethernet LAN ports
4.
Router serial number
Serial number of the device
10.4 User scripts
Advanced users can insert their own commands that will be executed at the end of booting process.
150
In Script Management window is shown content of a file /etc/rc.local. This file is executed at the end of startup,
executing the line: sh /etc/rc.local In this script is needed to use sh (ash) commands. It should be noted, that this is
embedded device and sh functionality is not full.
10.5 Restore point
10.5.1 Restore point create
Allow to create firmware restore points with all custom configurations. You can download created restore points
to your computer.
10.5.2 Restore point load
Allow to restore configuration from previously saved restore point. You can upload restore point from your
computer.
151
10.6 Firmware
10.6.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.
FW image – router firmware upgrade file.
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.
152
10.6.2 FOTA
Field name
Explanation
1.
Server address
Specify server address to check for firmware updates. E.g.
“http://teltonika.sritis.lt/rut9xx_auto_update/clients/”
2.
User name
User name for server authorization.
3.
Password
Password name for server authorization.
4.
Enable auto check
Check box to enable automatic checking for new firmware updates.
5.
Auto check mode
Select when to perform auto check function.
6.
WAN wired
Allows to update firmware from server only if routers WAN is wired (if box is checked).
10.7 Reboot
Reboot router by pressing button “Reboot”.
153
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.
11.1 Reset button
Reset button is located on the back panel of the device. Reset button has several functions:
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.
11.2 Bootloader’s WebUI
Bootloader also provides a way to recover the router functionality when the firmware is damaged. To make it
easier to use bootloader has its own webserver that can be accessed with any web browser.
Procedure for starting bootloader’s webserver:
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.
154
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.
155
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.
156
13 Changelog
Nr.
Date
Version
Comments
1
2017-02-01
1.34
2
2017-08-03
1.36
Page 2
3
2017-08-31
1.4

Navigation menu