NetModule NB2710 User manual

NetModule Router NB2710
User Manual for Software Version 4.0
Manual Version 1.8
NetModule AG, Switzerland
May 4, 2017

NetModule Router NB2710
This manual covers all variants of the NB2710 product type.
The specifications and information regarding the products in this manual are subject to change without notice. We
would like to point out that NetModule makes no representation or warranties with respect to the contents herein and
shall not be responsible for any loss or damage caused to the user by the direct or indirect use of this information This
document may contain information about third party products or processes. Such third party information is generally
out of influence of NetModule and therefore NetModule shall not be responsible for the correctness or legitimacy of
this information. Users must take full responsibility for their application of any products.
Copyright ©2017 NetModule AG, Switzerland All rights reserved
This document contains proprietary information of NetModule. No parts of the work described herein may be
reproduced. Reverse engineering of the hardware or software is prohibited and protected by patent law. This material
or any portion of it may not be copied in any form or by any means, stored in a retrieval system, adopted or transmitted
in any form or by any means (electronic, mechanical, photographic, graphic, optic or otherwise), or translated in any
language or computer language without the prior written permission of NetModule.
A large amount of the source code to this product is available under licenses which are both free and open source.
Most of it is covered by the GNU General Public License which can be obtained from www.gnu.org. The remainder
of the open source software which is not under the GPL, is usually available under one of a variety of more permissive
licenses. A detailed license information for a particular software package can be provided on request.
NetModule and NB2710 are trademarks and the logo is a service mark of NetModule AG, Switzerland.
All other products or company names mentioned herein are used for identification purposes only and may be trademarks
or registered trademarks of their respective owners. The following description of software, hardware or process of
NetModule or other third party provider may be included with your product and will be subject to the software,
hardware or other license agreements.
Contact
www.netmodule.com/support
NetModule AG Tel [phone]
Meriedweg 11 Fax [phone]
CH-3172 Niederwangen [e-mail]
Switzerland http://www.netmodule.com
2

Contents
1. Welcome to NetModule ................................. 6
2. Conformity ........................................ 7
2.1. Safety Instructions .................................. 7
2.2. Declaration of Conformity .............................. 8
2.3. Waste Disposal .................................... 8
2.4. National Restrictions ................................. 8
2.5. Open Source Software ................................ 9
3. Specifications ...................................... 10
3.1. Appearance ...................................... 10
3.2. Features ........................................ 11
3.3. Operating Elements ................................. 12
3.4. Interfaces ....................................... 14
3.4.1. Overview .................................... 14
3.4.2. Mobile ...................................... 15
3.4.3. WLAN ...................................... 15
3.4.4. GPS ....................................... 16
3.4.5. USB 2.0 Host Port ............................... 16
3.4.6. RJ45 Ethernet Connectors ........................... 17
3.4.7. 13 Pin Terminal Block ............................. 18
3.4.8. Extension Port ................................. 20
4. Installation ........................................ 22
4.1. Environmental Conditions .............................. 22
4.2. Installation of the Router .............................. 22
4.3. Installation of the Mini-SIM Cards .......................... 22
4.4. Installation of the GSM/UMTS/LTE Antenna ................... 23
4.5. Installation of the WLAN Antennas ......................... 23
4.6. Installation of the GPS Antenna ........................... 23
4.7. Installation of the Local Area Network ....................... 24
4.8. Installation of the Power Supply ........................... 24
5. Configuration ...................................... 25
5.1. First Steps ...................................... 25
5.1.1. Initial Access .................................. 25
5.1.2. Recovery ..................................... 26
5.2. HOME ........................................ 28
5.3. INTERFACES ..................................... 31
5.3.1. WAN ....................................... 31
5.3.2. Ethernet ..................................... 37
5.3.3. Mobile ...................................... 42
5.3.4. WLAN ...................................... 46
5.3.5. USB ....................................... 52
5.3.6. Serial Port .................................... 55
5.3.7. Digital I/O ................................... 58
5.3.8. Audio ...................................... 59
5.3.9. GNSS ...................................... 60
3

NB2710 User Manual 4.0
5.4. ROUTING ...................................... 62
5.4.1. Static Routes .................................. 62
5.4.2. Extended Routing ................................ 64
5.4.3. Multipath Routes ................................ 65
5.4.4. Mobile IP .................................... 66
5.4.5. Quality Of Service ................................ 69
5.4.6. Multicast .................................... 71
5.4.7. OSPF ...................................... 72
5.4.8. BGP ....................................... 73
5.5. FIREWALL ...................................... 74
5.5.1. Administration .................................. 74
5.5.2. Adress/Port Groups ............................... 74
5.5.3. Rules ....................................... 75
5.5.4. NAPT ...................................... 77
5.6. VPN ......................................... 80
5.6.1. OpenVPN .................................... 80
5.6.2. IPsec ....................................... 86
5.6.3. PPTP ...................................... 92
5.6.4. GRE ....................................... 95
5.6.5. Dial-In ...................................... 96
5.7. SERVICES ...................................... 97
5.7.1. SDK ....................................... 97
5.7.2. DHCP Server .................................. 106
5.7.3. DNS Server ................................... 108
5.7.4. NTP Server ................................... 110
5.7.5. Dynamic DNS .................................. 111
5.7.6. E-Mail ...................................... 113
5.7.7. Events ...................................... 114
5.7.8. SMS ....................................... 115
5.7.9. SSH/Telnet Server ............................... 117
5.7.10. SNMP Agent .................................. 119
5.7.11. Web Server ................................... 124
5.7.12. Discovery .................................... 125
5.7.13. Redundancy ................................... 126
5.7.14. Voice Gateway .................................. 128
5.8. SYSTEM ....................................... 134
5.8.1. System ...................................... 134
5.8.2. Authentication ................................. 137
5.8.3. Software Update ................................ 140
5.8.4. Module Firmware Update ............................ 141
5.8.5. Software Profiles ................................ 141
5.8.6. Configuration .................................. 142
5.8.7. Troubleshooting ................................. 145
5.8.8. Keys and Certificates .............................. 148
5.8.9. Licensing .................................... 153
5.8.10. Legal Notice ................................... 154
5.9. LOGOUT ....................................... 155
4

NB2710 User Manual 4.0
6. Command Line Interface ................................ 156
6.1. General Usage .................................... 156
6.2. Print Help ...................................... 157
6.3. Getting Config Parameters .............................. 157
6.4. Setting Config Parameters .............................. 158
6.5. Getting Status Information .............................. 158
6.6. Scanning Networks .................................. 159
6.7. Sending E-Mail or SMS ............................... 159
6.8. Updating System Facilities .............................. 159
6.9. Manage keys and certificates ............................. 160
6.10. Restarting Services .................................. 160
6.11. Debug System .................................... 161
6.12. Resetting System ................................... 162
6.13. Rebooting System .................................. 162
6.14. Running Shell Commands .............................. 162
6.15. Working with History ................................. 162
6.16. CLI-PHP ....................................... 162
A. Appendix ......................................... 168
A.1. Abbrevations ..................................... 168
A.2. System Events .................................... 169
A.3. Factory Configuration ................................ 172
A.4. SNMP VENDOR MIB ................................ 173
A.5. SDK Examples .................................... 189
5

List of Figures
5.1. Initial Login ..................................... 26
5.2. Home ......................................... 28
5.3. WAN Links ...................................... 31
5.4. WAN Settings .................................... 34
5.5. Link Supervision ................................... 35
5.6. Ethernet Ports .................................... 37
5.7. Ethernet Link Settings ................................ 38
5.8. VLAN Management ................................. 39
5.9. LAN IP Configuration ................................ 40
5.10. SIMs ......................................... 42
5.11. WWAN Interfaces .................................. 44
5.12. WLAN Management ................................. 46
5.13. WLAN Configuration ................................ 49
5.14. WLAN IP Configuration ............................... 51
5.15. USB Administration ................................. 52
5.16. USB Device Management .............................. 53
5.17. Serial Port Administration .............................. 55
5.18. Serial Port Settings ................................. 56
5.19. Digital I/O Ports ................................... 58
5.20. Static Routing .................................... 62
5.21. Extended Routing .................................. 64
5.22. Multipath Routes .................................. 65
5.23. Mobile IP ....................................... 68
5.24. Firewall Groups ................................... 74
5.25. Firewall Rules .................................... 75
5.26. Masquerading .................................... 77
5.27. Inbound NAPT ................................... 78
5.28. OpenVPN Administration .............................. 80
5.29. OpenVPN Configuration ............................... 81
5.30. OpenVPN Client Management ........................... 85
5.31. IPsec Administration ................................. 87
5.32. IPsec Configuration ................................. 88
5.33. PPTP Administration ................................ 92
5.34. PPTP Tunnel Configuration ............................. 93
5.35. PPTP Client Management ............................. 94
5.36. Dial-in Server Settings ................................ 96
5.37. SDK Administration ................................. 101
5.38. SDK Jobs ...................................... 102
5.39. DHCP Server ..................................... 106
5.40. DNS Server ..................................... 108
5.41. NTP Server ..................................... 110
5.42. Dynamic DNS Settings ............................... 111
5.43. E-Mail Settings ................................... 113
5.44. SMS Configuration .................................. 115
6

NB2710 User Manual 4.0
5.45. SSH and Telnet Server ................................ 117
5.46. SNMP Agent ..................................... 120
5.47. Web Server ...................................... 124
5.48. VRRP Configuration ................................. 126
5.49. Voice Gateway Administration ............................ 128
5.50. Voice Gateway Endpoint Configuration ....................... 129
5.51. Voice Gateway Routing Configuration ........................ 132
5.52. System ........................................ 134
5.53. Regional settings ................................... 136
5.54. User Accounts .................................... 137
5.55. Remote Authentication ............................... 138
5.56. Manual File Configuration .............................. 142
5.57. Automatic File Configuration ............................ 143
5.58. Factory Configuration ................................ 144
5.59. Log Viewer ...................................... 146
5.60. Tech Support File .................................. 147
5.61. Keys and certificates ................................. 148
5.62. Certificate Configuration ............................... 150
5.63. Licensing ....................................... 153
7

List of Tables
3.1. NB2710 Status Indicators .............................. 13
3.2. NB2710 Interfaces .................................. 14
3.3. Mobile Interface ................................... 15
3.4. IEEE 802.11 Standards ............................... 15
3.5. GPS Specifications .................................. 16
3.6. GNSS Specifications ................................. 16
3.7. USB 2.0 Host Port Specification .......................... 16
3.8. Ethernet Port Specification ............................. 17
3.9. Pin Assignments of RJ45 Ethernet Connectors ................... 17
3.10. Power Specifications ................................. 18
3.11. RS-232 Port Specification .............................. 18
3.12. Common Digital I/O Specification ......................... 19
3.13. Isolated Digital Outputs Specification ........................ 19
3.14. Isolated Digital Inputs Specification ......................... 19
3.15. Pin Assignments of Terminal Block ......................... 20
3.16. Audio Port Specification ............................... 20
3.17. Pin Assignments of RJ45 Audio Connector ..................... 21
3.18. Pin Assignments of RJ45 CAN/RS485 Connector ................. 21
4.1. Operating Conditions ................................ 22
4.2. LTE/UMTS antenna port types ........................... 23
4.3. WLAN antenna port types .............................. 23
5.19. IEEE 802.11 Network Standards .......................... 47
5.38. Static Route Flags .................................. 63
5.83. SMS Control Commands .............................. 105
5.93. SMS Number Expressions .............................. 116
5.130. Certificate Sections ................................. 149
5.131. Certificate Operations ................................ 149
A.1. Abbreviations .................................... 169
A.2. System Events .................................... 171
A.3. SDK Examples .................................... 191
8

1. Welcome to NetModule
Thank you for purchasing a NetModule Router. This document should give you an introduction to
the router and its features. The following chapters describe any aspects of commissioning the device,
installation procedure and provide helpful information towards configuration and maintenance.
Please find further imformation such as sample SDK script or configuration samples in our wiki on
http://wiki.netmodule.com.
9

2. Conformity
This chapter provides general information for putting the router into operation.
2.1. Safety Instructions
NetModule routers must be used in compliance with any and all applicable national and international
laws and with any special restrictions regulating the utilization of the communication module in
prescribed applications and environments.
We would like to point out that only the original accessories, shipping with the router, must be
used in order to prevent possible injury to health or damage to appliances and to ensure that
all the relevant provisions have been complied with. Unauthorized modifications or utilization of
unapproved accessories may void the warranty. The routers must not be opened. However, it is
possible to replace any pluggable SIM cards even during operation.
All circuits connected to the interfaces of the router must comply with the requirements of Safety
Extra Low Voltage (SELV) circuits and have to be designed for indoor use only. Interconnections
must not leave the building nor penetrate the body shell of a vehicle. Possible antenna circuits
must be limited to over-voltage transient levels below 1 500 VDC (according to IEC 60950-1, TNV-1
circuit levels) by using safety approved components.
NB2710 routers shall only be used with a certified (CE or equivalent) power supply which must
have a power limited and SELV circuit output.
They are basically designed for indoor use. Do not expose the communication module to ex-
treme ambient conditions and protect the communication module against dust, moisture and high
temperature.
We remind the user of the duty to observe the restrictions concerning the utilization of radio devices
at petrol stations, in chemical facilities or in the course of blasting works in which explosives are
used. Switch off the communication module when traveling by plane.
You need to pay increased attention when using the communication module close to personal
medical devices, such as cardiac pacemakers or hearing aids. NetModule routers may also cause
interference in the nearer distance of TV sets, radio receivers and personal computers.
Avoid any installation of the antenna during a lightning. Always keep a distance of more than 40
cm from the antenna in order to reduce exposure to electromagnetic fields below the legal limits.
This distance applies to λ
4- and λ 2-antennas. Larger distances may apply to antennas with higher
gain.
Any Ethernet cabling must be shielded, the Ethernet section of this manual provides more infor-
mation.
Devices with a WLAN interface may be operated only with applicable Regulatory Domain config-
ured. Special attention must be paid to country, number of antennas and the antenna gain (see
also chapter 5.3.4). A misconfiguration will lead to loss of the approval.
Cellular antennas attached to the router must have an antenna gain of equal or less than 2.5 dBi.
If an extension cable is used to attach the antenna, the antenna gain may be higher by the amount
of cable attenuation. The user is responsible for the compliance with the legal regulations.
We highly recommended creating a copy of a working system configuration. It can be downloaded
using the Web Manager and easily applied to a newer software release afterwards as we generally
guarantee backward compatibility.
10

NB2710 User Manual 4.0
2.2. Declaration of Conformity
NetModule hereby declares that under our own responsibility that the routers
comply with the relevant standards following the provisions of the Council Di-
rective 1999/5/EC. The signed version of the Declarations of Conformity can
be found on the NetModule web page.
2.3. Waste Disposal
In accordance with the requirements of the Council Directive 2002/96/EC re-
garding Waste Electrical and Electronic Equipment (WEEE), you are urged to
ensure that this product will be segregated from other waste at end-of-life and
delivered to the WEEE collection system in your country for proper recycling.
2.4. National Restrictions
This product may be generally used in all EU countries (and other countries following the EU
directive 1999/5/EC) without any limitation. Please refer to our WLAN Regulatory Database for
getting further national radio interface regulations and requirements for a particular country.
11

NB2710 User Manual 4.0
2.5. Open Source Software
We inform you that NetModule products may contain in part open-source software. We are dis-
tributing such open-source software to you under the terms of GNU General Public License (GPL)1,
GNU Lesser General Public License (LGPL)2or other open-source licenses3. These licenses allow
you to run, copy, distribute, study, change and improve any software covered by GPL, Lesser GPL,
or other open-source licenses without any restrictions from us or our end user license agreement
on what you may do with that software. Unless required by applicable law or agreed to in writ-
ing, software distributed under open-source licenses is distributed on an "AS IS" basis, WITHOUT
WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
To obtain the corresponding open source codes covered by these licenses, please contact our tech-
nical support at [e-mail].
Acknowledgements
This product includes:
•PHP, freely available from http://www.php.net
•Software developed by the OpenSSL Project for use in the OpenSSL Toolkit (http://www.openssl.org)
•Cryptographic software written by Eric Young ([email protected])
•Software written by Tim Hudson ([email protected])
•Software written Jean-loup Gailly and Mark Adler
•MD5 Message-Digest Algorithm by RSA Data Security, Inc.
•An implementation of the AES encryption algorithm based on code released by Dr Brian
Gladman
•Multiple-precision arithmetic code originally written by David Ireland
•Software from The FreeBSD Project (http://www.freebsd.org)
1Please find the GPL text under http://www.gnu.org/licenses/gpl-2.0.txt
2Please find the LGPL text under http://www.gnu.org/licenses/lgpl.txt
3Please find the license texts of OSI licenses (ISC License, MIT License, PHP License v3.0, zlib License) under
http://opensource.org/licenses
12

3. Specifications
3.1. Appearance
13

NB2710 User Manual 4.0
3.2. Features
All models of NB2710 have following standard functionalities:
•Input power
•4 Ethernet ports (10/100 Mbps)
•2 digital inputs, 2 digital outputs
•1 serial port (RS-232)
•1 USB 2.0 host port
•6 mini SIM card slots
•Extension port
The NB2710 can be equipped with the following options:
•LTE
•LTE 450MHz
•LTE US
•CDMA 450MHz
•WLAN IEEE 802.11abgn
•GPS/GNSS
•RS-232
•RS-485
•IBIS
•CAN
•Audio
•64 GB internal storage
•Software Key Server
•Software Key Voice
Note:All LTE models include support for UMTS/EDGE/GPRS.
Due to its modular approach, the NB2710 router and its hardware components can be arbitrarily
assembled according to its indented usage or application. Please contact us in case of special
project requirements.
14

NB2710 User Manual 4.0
3.3. Operating Elements
The following table describes the NB2710 status indicators.
Label Color State Function
Status lblinking The device is busy due to startup, software or configuration
update.
lon The device is ready. The captions of the top bank apply.
lon The device is ready. The captions of the bottom bank apply.
Mob1 lll[1] on Mobile connection 1 is up.
lblinking Mobile connection 1 is being established.
moff Mobile connection 1 is down.
Mob2 lll[1] on Mobile connection 2 is up.
lblinking Mobile connection 2 is being established.
moff Mobile connection 2 is down.
VPN lon VPN connection is up.
moff VPN connection is down.
WLAN lll[1] on WLAN connection is up.
lblinking WLAN connection is being established.
moff WLAN connection is down.
GNSS lon GNSS is turned on and a valid NMEA stream is available.
lblinking GNSS is searching for satellites.
moff GNSS is turned off or no valid NMEA stream is available.
Voice lon A voice call is currently active.
moff No voice call is active.
DO1 lon Normally open output port 1 is closed.
moff Normally open output port 1 is open.
DO2 lon Normally closed output port 2 is closed.
moff Normally closed output port 2 is open.
15

NB2710 User Manual 4.0
Label Color State Function
DI1 lon Input port 1 is set.
moff Input port 1 is not set.
DI2 lon Input port 2 is set.
moff Input port 2 is not set.
[1] The color of the LED represents the signal quality for wireless links.
lred means low
lyellow means moderate
lgreen means good or excellent
Table 3.1.: NB2710 Status Indicators
16

NB2710 User Manual 4.0
3.4. Interfaces
3.4.1. Overview
Label Panel Function
SIM 1 Front SIM 1, it can be assigned dynamically to any modem by configura-
tion.
SIM 2 Front SIM 2, it can be assigned dynamically to any modem by configura-
tion.
SIM 3 Front SIM 3, it can be assigned dynamically to any modem by configura-
tion.
SIM 4 Front SIM 4, it can be assigned dynamically to any modem by configura-
tion.
SIM 5 Front SIM 5, it can be assigned dynamically to any modem by configura-
tion.
SIM 6 Front SIM 6, it can be assigned dynamically to any modem by configura-
tion.
USB Front USB 2.0 host port, can be used as USB device server or for software
configuration updates.
Ethernet 1-4 Rear Ethernet switch ports, can be used for LAN/WAN.
Extension Rear Audio/CAN/IBIS/RS485 extension.
Mob 1 Rear 2 SMA female connectors for MIMO LTE antenna
Mob 2 Rear 2 SMA female connectors for MIMO LTE antenna
GPS Rear SMA female connector for GPS antenna
WLAN1 Rear 2 SMA female connectors for MIMO WLAN antenna
WLAN2 Rear 2 SMA female connectors for MIMO WLAN antenna
Power Rear Power supply 12-48 VDC (Pins 1 and 2)
RS-232 Rear Non-isolated serial RS-232 interface (Pins 3 to 5) which can be
used for console administration, serial device server or other serial
based communication applications.
Outputs Rear Galvanically isolated digital outputs (Pins 6 to 9)
Inputs Rear Galvanically isolated digital inputs (Pins 10 to 13)
Reset Front The reset button is accessible through a small hole below the USB
connector. Press at least 3 seconds for reboot and at least 10 second
for a factory reset. The start of the factory reset is confirmed by
all LEDs lighting up for a second. The button can be released then
again.
Table 3.2.: NB2710 Interfaces
17

NB2710 User Manual 4.0
3.4.2. Mobile
The various variants of the NB2710support multiple multimode modules for mobile communica-
tion.
Standard Bands
4G (LTE/FDD) B1(2100), B2(1900), B3(1800), B5(850), B7(2600), B8(900),
B20(800)
3G (DC-HSPA+/UMTS) B5(850), B8(900), B2(1900), B1(2100)
2G (EDGE/GPRS/GSM) B9(900), B3(1800), B2(1900)
LTE450 LTE Band 3 (1800 MHz), LTE Band 7 (2600 MHz), LTE Band
20 (800 MHz), LTE Band 31 (450 MHz), UMTS Band 1 (2100
MHz), UMTS Band 8 (900 MHz)
CDMA450 Band Class 5 Block Designators A + B
Table 3.3.: Mobile Interface
The LTE modules support 2x2 MIMO.
Data rates: LTE max. 100 Mbps downlink / 50 Mbps uplink (DC-HSPA+ 42/5.76); CDMA450
max. 14,7 Mbps downlink / 5.4 Mbps uplink
3.4.3. WLAN
The variants of the NB2710support 802.11 a/b/g/n WLAN modules. It can operate either as client
or access point.
Standard Frequencies Bandwidth Data Rate
802.11a 5 GHz 20 MHz 54 Mbit/s
802.11b 2.4 GHz 20 MHz 11 Mbit/s
802.11g 2.4 GHz 20 MHz 54 Mbit/s
802.11n 2.4/5 GHz 20/40 MHz 300 Mbit/s
Table 3.4.: IEEE 802.11 Standards
Note: 802.11n supports 2x2 MIMO
18

NB2710 User Manual 4.0
3.4.4. GPS
Feature Specification
Systems GPS/GLONASS
Data stream JSON or NMEA
Tracking sensitivity -154 dBm
Supported antennas Active and passive
Table 3.5.: GPS Specifications
GNSS (Option Ge)
The GNSS module supports Dead Reckoning with onboard 3D accelerometer and 3D gyroscope.
Feature Specification
Systems GPS/GLONASS/BeiDu/Galileo ready
Data stream NMEA or UBX
Tracking sensitivity -160 dBm
Channels 72
Accuracy 2m
Supported antennas Active and passive
Table 3.6.: GNSS Specifications
3.4.5. USB 2.0 Host Port
The USB 2.0 host port has the following specification:
Feature Specification
Speed Low, Full & Hi-Speed
Current max. 500 mA
Table 3.7.: USB 2.0 Host Port Specification
19

NB2710 User Manual 4.0
3.4.6. RJ45 Ethernet Connectors
Specification
The Ethernet ports are specified as follows:
Feature Specification
Isolation 1000 VAC
Speed 10/100 Mbps
Mode Half- & Full-Duplex
Crossover Automatic MDI/MDI-X
Table 3.8.: Ethernet Port Specification
Pin Assignment
Pin Signal
1 TX+
2 TX−
3 RX+
4 -
5 -
6 RX−
7 -
8 -
Table 3.9.: Pin Assignments of RJ45 Ethernet Connectors
Note: Pairs 4-5 and 7-8 have an internal 100 Ωtermination.
20