NetModule NB2710 User Manual

Hide thumbs Also See for NB2710:

User manual (225 pages)

Table Of Contents

100

101

102

103

104

105

106

107

108

109

110

111

112

113

114

115

116

117

118

119

120

121

122

123

124

125

126

127

128

129

130

131

132

133

134

135

136

137

138

139

140

141

142

143

144

145

146

147

148

149

150

151

152

153

154

155

156

157

158

159

160

161

162

163

164

165

166

167

168

169

170

171

172

173

174

175

176

177

178

179

180

181

182

183

184

185

186

187

188

189

190

191

192

193

194

Table of Contents

Quick Links

Download this manual

NetModule Router NB2710

User Manual for Software Version 4.0

Manual Version 1.8

NetModule AG, Switzerland

May 4, 2017

Table of Contents

Need help?

Do you have a question about the NB2710 and is the answer not in the manual?

Questions and answers

Summary of Contents for NetModule NB2710

Page 1 NetModule Router NB2710 User Manual for Software Version 4.0 Manual Version 1.8 NetModule AG, Switzerland May 4, 2017...
Page 2 The speciﬁcations 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.
Page 3: Table Of Contents
Contents Welcome to NetModule ....... . . Conformity ........
Page 4 NB2710 User Manual 4.0 5.4. ROUTING ........
Page 5 NB2710 User Manual 4.0 Command Line Interface ....... . 156 6.1.
Page 6: List Of Figures
List of Figures 5.1. Initial Login ........5.2.
Page 7 NB2710 User Manual 4.0 5.45. SSH and Telnet Server ....... . 117 5.46.
Page 8: List Of Tables
List of Tables 3.1. NB2710 Status Indicators ......3.2. NB2710 Interfaces .
Page 9: Welcome To Netmodule
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 conﬁguration and maintenance.
Page 10: Conformity
(according to IEC 60950-1, TNV-1 circuit levels) by using safety approved components. NB2710 routers shall only be used with a certiﬁed (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.
Page 11: Declaration Of Conformity
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.
Page 12: Open Source Software
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) GNU Lesser General Public License (LGPL) or other open-source licenses .
Page 13: Speciﬁcations
3. Speciﬁcations 3.1. Appearance...
Page 14: Features
• 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...
Page 15: Operating Elements
NB2710 User Manual 4.0 3.3. Operating Elements The following table describes the NB2710 status indicators. Label Color State Function Status blinking The device is busy due to startup, software or conﬁguration update. The device is ready. The captions of the top bank apply.
Page 16: Nb2710 Status Indicators
Input port 2 is set. oﬀ Input port 2 is not set. The color of the LED represents the signal quality for wireless links. red means low yellow means moderate green means good or excellent Table 3.1.: NB2710 Status Indicators...
Page 17: Interfaces
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 conﬁgura- tion. SIM 2 Front SIM 2, it can be assigned dynamically to any modem by conﬁgura- tion.
Page 18: Mobile
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)
Page 19: Gps
NB2710 User Manual 4.0 3.4.4. GPS Feature Speciﬁcation Systems GPS/GLONASS Data stream JSON or NMEA Tracking sensitivity -154 dBm Supported antennas Active and passive Table 3.5.: GPS Speciﬁcations GNSS (Option Ge) The GNSS module supports Dead Reckoning with onboard 3D accelerometer and 3D gyroscope.
Page 20: Rj45 Ethernet Connectors
NB2710 User Manual 4.0 3.4.6. RJ45 Ethernet Connectors Speciﬁcation The Ethernet ports are speciﬁed as follows: Feature Speciﬁcation Isolation 1000 V Speed 10/100 Mbps Mode Half- & Full-Duplex Crossover Automatic MDI/MDI-X Table 3.8.: Ethernet Port Speciﬁcation Pin Assignment Signal Table 3.9.: Pin Assignments of RJ45 Ethernet Connectors...
Page 21: Pin Terminal Block
NB2710 User Manual 4.0 3.4.7. 13 Pin Terminal Block Power Supply NB2710 routers provide a non-isolated power supply input. The power port has the following speciﬁcations: Feature Speciﬁcation Power supply nominal voltages 12 V , 24 V , 36 V...
Page 22: Common Digital I/O Speciﬁcation
NB2710 User Manual 4.0 Isolated Digital I/Os The isolated input and oputput ports have the following speciﬁcation in common: Feature Speciﬁcation Isolation to enclosure/GND 1’414 V Isolation to adjacent I/O functional Table 3.12.: Common Digital I/O Speciﬁcation Isolated Outputs The isolated digital output ports have the following speciﬁcation: Feature Speciﬁcation...
Page 23: Extension Port
NB2710 User Manual 4.0 Pin Assignment Name Description Power Ground 12 V to 48 V RS-232 RxD (non-isolated) RS-232 TxD (non-isolated) RS-232 GND (non-isolated) Dry contact relay normally open Dry contact relay normally open Dry contact relay normally closed Dry contact relay normally closed...
Page 24: Pin Assignments Of Rj45 Audio Connector
NB2710 User Manual 4.0 Pin Assignment Audio Signal Input Left Channel + Input Left Channel Input Right Channel + Output Right Channel + Output Right Channel Input Right Channel Output Left Channel + Output Left Channel Table 3.17.: Pin Assignments of RJ45 Audio Connector Note: In the case of mono operation the left channels are used.
Page 25: Installation
IP40 (with SIM and USB covers mounted) Table 4.1.: Operating Conditions 4.2. Installation of the Router The NB2710 is designed for mounting it on a worktop or wall. Please consider the safety instructions and the environmental conditions in chapter 2. 4.3. Installation of the Mini-SIM Cards Up to six Mini-SIM cards can be inserted in a NB2710 router.
Page 26: Installation Of The Gsm/Umts/Lte Antenna
Further information about SIM conﬁguration can be found in chapter 5.3.3. 4.4. Installation of the GSM/UMTS/LTE Antenna NetModule routers will only operate eﬃciently in the cellular network if there is a good signal. A stub antenna will be suitable for most applications. However, in some circumstances it might be necessary to use remote antennas together with an extended cable to reach a better location oﬀering an adequate signal.
Page 27: Installation Of The Local Area Network
NB2710 User Manual 4.0 4.7. Installation of the Local Area Network Up to four 10/100 Mbps Ethernet devices can be directly connected to the router, further devices can be attached via an addtional Ethernet switch. Please ensure that the connector has been plugged in properly and remains in a ﬁxed state, you might otherwise experience sporadical link...
Page 28: Conﬁguration
4.0. 5.1. First Steps NetModule routers can be easily set up by using the HTTP-based conﬁguration interface, called the Web Manager. It is supported by the latest web browsers (e.g. Microsoft Internet Explorer 11, Mozilla Firefox 28.0, Safari 7 and many others). Please ensure to have JavaScript turned on.
Page 29: Recovery
NB2710 User Manual 4.0 Figure 5.1.: Initial Login Please note that the admin password will be also applied for the root user which can be used to access the device via the serial console, telnet, SSH or to enter the bootloader. You may also conﬁgure additional users which will only be granted to access the summary page or retrieve status...
Page 30 NB2710 User Manual 4.0 loaded into RAM via TFTP and executed. It oﬀers a minimal system image for running a soft- ware update or doing other modiﬁcations. You will be provided with two ﬁles, recovery-image and recovery-dtb, which must be placed in the root directory of a TFTP server (connected via LAN1 and address 192.168.1.254).
Page 31: Home
NB2710 User Manual 4.0 5.2. HOME This page provides a status overview of enabled features and connections. Figure 5.2.: Home Summary This page oﬀers a short summary about the administrative and operational status of the router’s interfaces. This page oﬀers details about any enabled Wide Area Network (WAN) links (such as the IP addresses, network information, signal strength, etc.) The information about the amount of down-...
Page 32 This page provides information about the Open Shortest Path First routing protocol. DynDNS This page provides information about Dynamic DNS. System Status The system status page displays various details of your NB2710 router, including system details, information about mounted modules and software release information.
Page 33 NB2710 User Manual 4.0 This section will list all webpages generated by SDK scripts.
Page 34: Interfaces
NB2710 User Manual 4.0 5.3. INTERFACES 5.3.1. WAN Link Management Depending on your hardware model, WAN links can be made up of either Wireless Wide Area Network (WWAN), Wireless LAN (WLAN), Ethernet or PPP over Ethernet (PPPoE) connections. Please note that each WAN link has to be conﬁgured and enabled in order to appear on this page.
Page 35 NB2710 User Manual 4.0 In general, a link will be only dialed or declared as up if the following prerequisites are met: Condition WWAN WLAN PPPoE Modem is registered Registered with valid service type Valid SIM state Suﬃcient signal strength...
Page 36 Speciﬁes the switch-back condition of a switchover link and the time after an active hotlink will be teared down NetModule routers provide a feature called IP pass-through (aka Drop-In mode). If enabled, the WAN address will be be passed-through to the ﬁrst DHCP client of the speciﬁed LAN interface.
Page 37: Wan Settings
NB2710 User Manual 4.0 WAN Settings This page can be used to conﬁgure WAN speciﬁc settings like the Maximum Segment Size (MSS). The MSS corresponds to the largest amount of data (in bytes) that the router can handle in a single, unfragmented TCP segment.
Page 38: Link Supervision
NB2710 User Manual 4.0 Supervision Network outage detection on a per-link basis can be performed by sending pings on each link to some authoritative hosts. A link will be declared as down in case all trials have failed and only as up if at least one host can be reached.
Page 39 NB2710 User Manual 4.0 Parameter Supervision Settings Retry interval The interval in seconds at which pings are re-transmitted in case a ﬁrst ping failed Max. number of failed tri- The maximum number of failed ping trials until the link will be...
Page 40: Ethernet
NB2710 User Manual 4.0 5.3.2. Ethernet NB2710 routers ship with an Ethernet switch (ETH1-ETH4) and an additional extension port which can be linked via RJ45 connectors. ETH1 usually forms the LAN1 interface which should be used for LAN purposes. Other interfaces can be used to connect other LAN segments or for conﬁguring a WAN link.
Page 41: Ethernet Link Settings
VLAN Management NetModule routers support Virtual LAN according to IEEE 802.1Q which can be used to create virtual interfaces on top of an Ethernet interface. The VLAN protocol inserts an additional header to Ethernet frames carrying a VLAN Identiﬁer (VLAN ID) which is used for distributing the packets...
Page 42: Vlan Management
NB2710 User Manual 4.0 Figure 5.8.: VLAN Management In order to form a distinctive subnet, the network interface of a remote LAN host must be conﬁgured with the same VLAN ID as deﬁned on the router. Further, 802.1P introduces a priority ﬁeld which inﬂuences packet scheduling in the TCP/IP stack.
Page 43: Lan Ip Conﬁguration
NB2710 User Manual 4.0 IP Settings This page can be used to conﬁgure IP addressing for your LAN/WAN Ethernet interfaces. In addition to the primary IP address/subnet mask you may deﬁne an additional IP address alias on the interface. Please keep in mind that the DNS servers can be set globally in the DNS server conﬁguration menu.
Page 44 NB2710 User Manual 4.0 When running in WAN mode, the interface may be conﬁgured with the following settings: Parameter WAN IP Settings WAN mode The WAN operation mode, deﬁnes whether the interface should run as DHCP client, statically conﬁgured or over PPPoE.
Page 45: Mobile
NB2710 User Manual 4.0 5.3.3. Mobile SIMs Figure 5.10.: SIMs The SIM page gives an overview about the available SIM cards, their assigned modems and the current state. Once a SIM card has been inserted, assigned to a modem and successfully unlocked, the card should remain in state ready and the network registration status should have turned to registered.
Page 46 NB2710 User Manual 4.0 Conﬁguration A SIM card is generally assigned to a default modem but might be switched, for instance if you set up two WWAN interfaces with one modem but diﬀerent SIM cards. Close attention has to be paid when other services (such as SMS or Voice) are operating on that modem, as a SIM switch will naturally aﬀect their operation.
Page 47: Wwan Interfaces
NB2710 User Manual 4.0 WWAN Interfaces This page can be used to manage your WWAN interfaces. The resulting link will pop up auto- matically as WAN link once an interface has been added. Please refer to chapter 5.3.1 for how to manage them.
Page 48 NB2710 User Manual 4.0 Generally, the connection settings are derived automatically as soon as the modem has registered and the network provider has been found in our database. Otherwise, it will be required to conﬁgure the following settings manually: Parameter...
Page 49: Wlan
NB2710 User Manual 4.0 5.3.4. WLAN WLAN Management In case your router is shipping with a WLAN (or Wi-Fi) module you can operate it either as client, access point or managed mode. As a client it can create an additional WAN link which for instance can be used as backup link.
Page 50: Ieee 802.11 Network Standards
802.11n 2.4/5 GHz 20/40 MHz 300 Mbit/s 802.11ac 5 GHz 20/40/80 MHz 866.7 Mbit/s Table 5.19.: IEEE 802.11 Network Standards Note: NetModule Routers with 802.11n and 802.11ac support 2x2 MIMO Only available for NetModule Routers NB2800, NB3701, NB3711 and NB3800...
Page 51 NB2710 User Manual 4.0 Prior to setting up an access point, it is always a good idea to run a network scan for getting a list of neighboring WLAN networks and then choose the less interfering channel. Please note that two adequate channels are required for getting good throughputs with 802.11n and a bandwidth of 40...
Page 52: Wlan Conﬁguration
NB2710 User Manual 4.0 Running in access-point mode you can create up to 4 SSIDs with each running their own network conﬁguration. The networks can be individually bridged to a LAN interface or operate as dedicated interface in routing-mode. Figure 5.13.: WLAN Conﬁguration...
Page 53 NB2710 User Manual 4.0 This section can be used to conﬁgure security-related settings. Parameter WLAN Access-Point Conﬁguration SSID The network name (called SSID) Security mode The desired security mode WPA/WPA2 mixed mode WPA2 should be preferred over WPA1, running WPA/WPA2 mixed-mode oﬀers both.
Page 54: Wlan Ip Conﬁguration
NB2710 User Manual 4.0 WLAN IP Settings This section lets you conﬁgure the TCP/IP settings of your WLAN network. A client interface can be run over DHCP or with a statically conﬁgured address and default gateway. Figure 5.14.: WLAN IP Conﬁguration The access point networks can be bridged to any LAN interface for letting WLAN clients and Ethernet hosts operate in the same subnet.
Page 55: Usb
NB2710 User Manual 4.0 5.3.5. USB NetModule routers ship with a standard USB host port which can be used to connect a storage, network or serial USB device. Please contact our support in order to get a list of supported devices.
Page 56: Usb Device Management
NB2710 User Manual 4.0 Please note that some USB devices behave latency-sensitive which may raise problems when op- erating over a slow IP connection. Some devices may generally not work with the USB/IP driver. Please contact our support in case of compatibility issues.
Page 57 NB2710 User Manual 4.0 USB Autorun This feature can be used to automatically launch a shell script or perform a software/conﬁg update as soon as an USB storage stick has been plugged in. For authentication, a ﬁle called autorun.key must exist in the root directory of a FAT16/32 formatted stick. It can be downloaded from that page and holds the SHA256 hash key of the admin password.
Page 58: Serial Port
NB2710 User Manual 4.0 5.3.6. Serial Port This page can be used to manage your serial ports. A serial port can be used by: Parameter Serial Port Usage none The serial port is not used login console The serial port is used to open a console which can be accessed with a serial terminal client from the other side.
Page 59: Serial Port Settings
NB2710 User Manual 4.0 Running a device server, the following settings can be applied: Figure 5.18.: Serial Port Settings Parameter Serial Settings Physical protocol Selects the desired physical protocol on the serial port Baud rate Speciﬁes the baud rate run on the serial port Data bits Speciﬁes the number of data bits contained in each frame...
Page 60 NB2710 User Manual 4.0 Parameter Serial Settings Protocol on TCP/IP You may choose the IP protocols Telnet or TCP raw for the device server Port The TCP port for the device server Timeout The timeout until a client is declared as disconnected...
Page 61: Digital I/O
NB2710 User Manual 4.0 5.3.7. Digital I/O The Digital I/O page displays the current status of the I/O ports and can be used to turn output ports on or off. Figure 5.19.: Digital I/O Ports You can apply the following settings:...
Page 62: Audio
NB2710 User Manual 4.0 5.3.8. Audio Audio Administration This page can be used to pre-conﬁgure the audio module. They can be later used for the voice gateway. It can be conﬁgured as follows: Parameter Audio Settings Volume level Default volume level for line-out Audio Testing This page can be used to play or record an audio sample.
Page 63: Gnss
NB2710 User Manual 4.0 5.3.9. GNSS Administration The GNSS page lets you enable or disable the GNSS modules present in the system and can be used to conﬁgure the daemon that can be used to share access to receivers without contention or loss of data and to respond to queries with a format that is substantially easier to parse than the NMEA 0183 emitted directly by the GNSS device.
Page 64 NB2710 User Manual 4.0 Position This pages provides further information about the satellites in view and values derived from them: Parameter GNSS Information Latitude The geographic coordinate specifying the north-south position Longitude The geographic coordinate specifying the east-west position Altitude...
Page 65: Routing
NB2710 User Manual 4.0 5.4. ROUTING 5.4.1. Static Routes This menu shows all routing entries of the system. They are typically formed by an address/netmask couple (represented in IPv4 dotted decimal notation) which specify the destination of a packet. The packets can be directed to either a gateway or an interface or both. If interface is set to ANY, the system will choose the route interface automatically, depending on the best matching network conﬁgured for an interface.
Page 66: Static Route Flags
NB2710 User Manual 4.0 Parameter Static Route Conﬁguration Destination The destination address of a packet Netmask The subnet mask which forms, in combination with the destination, the network to be addressed. A single host can be speciﬁed by a netmask of 255.255.255.255, a default route corresponds to 0.0.0.0.
Page 67: Extended Routing
NB2710 User Manual 4.0 5.4.2. Extended Routing Extended routes can be used to perform policy-based routing, they generally precede static routes. Figure 5.21.: Extended Routing In contrast to statis routes, extended routes can be made up, not only of a destination address/net- mask, but also a source address/netmask, incoming interface and the type of service (TOS) of packets.
Page 68: Multipath Routes
NB2710 User Manual 4.0 5.4.3. Multipath Routes Multipath routes will perform weighted IP-session distribution for particular subnets across multiple interfaces. Figure 5.22.: Multipath Routes At least two interfaces have to be deﬁned to establish multipath routing. Additional interfaces can be added by pressing the plus sign.
Page 69: Mobile Ip
Cisco 2900 Series home agent implemen- tation has been veriﬁed. However, since NetModule routers implement a mobile node as well as a home agent, a MIP network with up to 10 mobile nodes can be implemented without requiring expensive third party routers.
Page 70 NB2710 User Manual 4.0 Parameter Mobile IP Conﬁguration Shared secret The shared secret used for authentication of the mobile node at the home agent. This can be either a 128-bit hexadecimal value or a random length ASCII string. Life time...
Page 71 NB2710 User Manual 4.0 If MIP is run as a home agent, you will have to set up a home address and network mask for the home agent ﬁrst. Then you will need to add the conﬁguration for all mobile nodes which is made up of the following settings: Figure 5.23.: Mobile IP...
Page 72: Quality Of Service
NB2710 User Manual 4.0 5.4.5. Quality Of Service NetModule routers are able to prioritize and shape certain kinds of IP traﬃc. This is currently limited on egress, which means that only outgoing traﬃc can be stipulated. The current QoS solution is using Stochastic Fairness Queueing (SFQ) classes in combination with Hierarchy Token Bucket (HTB) qdiscs.
Page 73 NB2710 User Manual 4.0 In case an interface has been activated, the system will automatically create the following queues: Parameter QoS Default Queues high A high priority queue which may hold any latency-critical services (such as VoIP) default A default queue which will handle all other services...
Page 74: Multicast
5.4.6. Multicast Multicast routing (MCR) can be conﬁgured and managed by a daemon. Only one MCR daemon can be used at a time. NetModule routers ship with two diﬀerent MCR daemons to select from depending on your depen- dencies: Parameter...
Page 75: Ospf
NB2710 User Manual 4.0 5.4.7. OSPF The OSPF tab allows the NetModule router to be added to a network of OSPF routers. Parameter OSPF General Settings OSPF status Speciﬁes whether the OSPF routing protocol is active Redistribute connected Redistribute routes to networks which are directly connected to the...
Page 76: Bgp
NB2710 User Manual 4.0 5.4.8. BGP The BGP tab allows to set up peerings of the NetModule router with other Border Gateway Protocol enabled routers. Parameter BGP General Settings BGP status Speciﬁes whether the BGP routing protocol is active AS number...
Page 77: Firewall
NB2710 User Manual 4.0 5.5. FIREWALL 5.5.1. Administration NetModule routers use Linux’s netﬁlter/iptables ﬁrewall framework (see http://www.netfilter.org for more information) which supports stateful inspection, that is, granting the same permissions for inherited connections within an IP session (e.g. FTP which builds up a control and data connection).
Page 78: Rules
NB2710 User Manual 4.0 5.5.3. Rules In general, the ﬁrewall is set up of a range of rules which control each packet’s permission to pass the router. Please note that the rules are processed by order, that means traversing the list from top to bottom until a matching rule is found.
Page 79 NB2710 User Manual 4.0 Parameter Firewall Rule Conﬁguration Destination port(s) The destination port of matching packets, which can be speciﬁed by a single port or a range of ports (only UDP/TCP). The statistics page can be used to ﬁgure out if rules have matched any packets and provides a...
Page 80: Napt
NB2710 User Manual 4.0 5.5.4. NAPT This page can be used to conﬁgure Network Address and Port Translation (NAPT) for packets traversing the system. NAPT hereby modiﬁes IP addresses or/and TCP/UDP ports in matching IP packets. By tracking those connections, it will also automatically adjust the returning packets of an IP session.
Page 81: Inbound Napt
NB2710 User Manual 4.0 NAPT Inbound Rules Inbound rules can be used to modify the target section of IP packets and, for instance, forward a service or port to an internal host. By doing so, you can expose that service and make it available from the Internet.
Page 82 NB2710 User Manual 4.0 Parameter Inbound NAPT Rules Redirect port The port to which matching packets will be redirected NAPT Outbound Rules Outbound rules will modify the source section of IP packets and can be used to establish 1:1 NAT mappings but also to redirect packets to a speciﬁc service.
Page 83: Vpn
NB2710 User Manual 4.0 5.6. VPN 5.6.1. OpenVPN OpenVPN Administration Figure 5.28.: OpenVPN Administration...
Page 84: Openvpn Conﬁguration
NB2710 User Manual 4.0 Tunnel Conﬁguration NetModule routers support one single server tunnel and up to four client tunnels. You can specify tunnel parameters either in standard conﬁguration or upload an expert mode ﬁle which has been created in advance. Refer to chapter 5.6.1...
Page 85 NB2710 User Manual 4.0 If the tunnel is operated in client mode, the following settings can be applied: Parameter OpenVPN Client Conﬁguration Peer selection Speciﬁes how the remote peer shall be selected, besides a single server you may conﬁgure multiple servers which can, in case of failures, either be selected sequently (i.e.
Page 86 NB2710 User Manual 4.0 The following further options can be applied: Parameter OpenVPN Options use compression Enable or disable LZO packet compression use keepalive Can be used to send a periodic keepalive packet in order to keep the tunnel up despite of inactivity...
Page 87 NB2710 User Manual 4.0 OpenVPN Expert Conﬁguration (Server) A server tunnel typically requires the following ﬁles: Parameter Server Expert Files server.conf OpenVPN conﬁguration ﬁle ca.crt Root certiﬁcate authority ﬁle server.crt Certiﬁcate ﬁle server.key Private key ﬁle dh1024.pem Diﬃe-Hellman parameters ﬁle A directory containing client-speciﬁc conﬁguration ﬁles...
Page 88: Openvpn Client Management
NB2710 User Manual 4.0 Client Management Once you have successfully set up an OpenVPN server tunnel, you can manage and enable clients connecting to your service. Currently connected clients can be seen on this page, including the connect time and IP address. You may kick connected clients by disabling them.
Page 89: Ipsec
NB2710 User Manual 4.0 5.6.2. IPsec IPsec is a protocol suite for securing IP communications by authenticating and encrypting each packet of a communication session and thus establishing a secure virtual private network. IPsec includes various cryptographic protocols and ciphers for key exchange and data encryption and can be seen as one of the strongest VPN technologies in terms of security.
Page 90: Ipsec Administration
NB2710 User Manual 4.0 Administration Figure 5.31.: IPsec Administration This page can be used to enable/disable IPsec, you may also specify whether NAT-Traversal should be used. NAT-Traversal is mainly used for connections which traverse a path where a router modiﬁes the IP address/port of packets.
Page 91: Ipsec Conﬁguration
NB2710 User Manual 4.0 Conﬁguration Figure 5.32.: IPsec Conﬁguration General For setting up the tunnel you will have to conﬁgure the following parameters ﬁrst: Parameter IPsec General Settings Remote peer IP address or host name of the remote IPsec peer. You may specify 0.0.0.0 to act as a responder for roadwarrior clients.
Page 92 NB2710 User Manual 4.0 IKE Authentication NetModule routers support IKE authentication through pre-shared keys (PSK) or certiﬁcates within a public key infrastructure. Extended Authentication (XAUTH) leverages RADIUS-like authentica- tion and can be used to apply user level access control over IPSec.
Page 93 NB2710 User Manual 4.0 IKE Proposal This section can be used to conﬁgure the phase 1 settings: Parameter IPsec IKE Proposal Settings Negotiation mode Choose the desired negotiation mode. Preferably, main mode should be used but aggressive mode might be applicable when dealing with dynamic endpoint addresses.
Page 94 NB2710 User Manual 4.0 is present. Therefore, you may need to specify the networks right and left of the endpoints by applying the following settings: Parameter IPsec Network Settings Local network The address of your local area network Local netmask...
Page 95: Pptp
NB2710 User Manual 4.0 5.6.3. PPTP The Point-to-Point Tunneling Protocol (PPTP) is a method for implementing virtual private net- works between two hosts. PPTP is easy to conﬁgure and widely deployed amongst Microsoft Dial-up networking servers. However, due to its weak encryption algorithms, it is nowadays con- sidered insecure but it still provides a straightforward way for establishing tunnels.
Page 96: Pptp Tunnel Conﬁguration
NB2710 User Manual 4.0 Figure 5.34.: PPTP Tunnel Conﬁguration Setting up a server requires the following settings: Parameter PPTP Server Settings Listen address Speciﬁes on which IP address should be listened for incoming client connections Server address The server address within the tunnel Client address range Speciﬁes a range of IP addresses assigned to each client...
Page 97: Pptp Client Management
NB2710 User Manual 4.0 PPTP Client Management PPTP clients for a server tunnel need to be conﬁgured here. They are made up of user-name and password. A ﬁxed IP address can be assigned to them which can be used to point any routes to a dedicated tunnel.
Page 98: Gre
NB2710 User Manual 4.0 5.6.4. GRE The Generic Routing Encapsulation (GRE) is a tunneling protocol that can encapsulate a wide variety of network layer protocols inside virtual point-to-point links over IP. GRE is deﬁned in RFC 1701, 1702 and 2784. It does not provide encryption nor authorization but can be used on an address-basis on top of other VPN techniques (such as IPsec) for tunneling purposes.
Page 99: Dial-In
NB2710 User Manual 4.0 5.6.5. Dial-In On this page you can conﬁgure the Dial-In server in order to establish a data connection over GSM calls. Thus, one would generally apply a required service type of 2G-only, so that the modem registers to GSM only.
Page 100: Services
5.7. SERVICES 5.7.1. SDK NetModule routers are shipping with a Software Development Kit (SDK) which oﬀers a simple and fast way to implement customer-speciﬁc functions and applications. It consists of: 1. An SDK host which deﬁnes the runtime environment (a so-called sandbox), that is, controlling...
Page 101 NB2710 User Manual 4.0 SDK API Functions The current range of API functions can be used to implement the following features: 1. Send/Retrieve SMS 2. Send E-mail 3. Read/Write from/to serial device 4. Control digital input/output ports 5. Run TCP/UDP servers 6.
Page 102 NB2710 User Manual 4.0 Let’s now pay some attention to the very powerful API function nb_status. It can be used to query the router’s status values in the same manner as they can be shown with the CLI. It returns a structure of variables for a speciﬁc section (a list of available sections can be obtained by running...
Page 103 NB2710 User Manual 4.0 Here is an example how one might adopt those functions: /* check current city and enable the second WAN link */ location = nb_status ( " location " ( location ) { city = struct_get ( location , "...
Page 104: Sdk Administration
NB2710 User Manual 4.0 Administration Figure 5.37.: SDK Administration This page can be used to control the SDK host and apply the following settings: Parameter SDK Administration Settings Administrative status Speciﬁes whether SDK scripts should run or not Storage The storage device on which the sandbox shall be stored (see chap- ter 5.8.1)
Page 105: Sdk Jobs
NB2710 User Manual 4.0 Job Management Figure 5.38.: SDK Jobs This page can be used to set up scripts, triggers and jobs. It is usually a good idea to create a trigger ﬁrst which is made up by the following parameters:...
Page 106 NB2710 User Manual 4.0 Parameter SDK Script Parameters Action You may either edit a script, upload it to the system or select one of the example scripts or an already uploaded script You are ready to set up a job afterwards, it can be created by using the following parameters:...
Page 107 NB2710 User Manual 4.0 Testing The testing page oﬀers an editor and an input ﬁeld for optional arguments which can be used to perform test runs of your script or test dedicated portions of it or upload an entire ﬁle. Please note that you might need to quote arguments as they will otherwise be separated by white-spaces.
Page 108: Sms Control Commands
NB2710 User Manual 4.0 The following commands are supported: Command Action status Will reply a message to the sender including a short system overview connect Will enable the ﬁrst WAN link conﬁgured on the system disconnect Will disable the ﬁrst WAN link conﬁgured on the system...
Page 109: Dhcp Server
NB2710 User Manual 4.0 5.7.2. DHCP Server This section can be used to individually conﬁgure the Dynamic Host Conﬁguration Protocol (DHCP) service for each LAN interface which will serve dynamic IP addresses to hosts in the local network. You may also have a look to the status page where you can ﬁnd an overview about negotiated client addresses.
Page 110 NB2710 User Manual 4.0 Parameter DHCP Server Settings DHCP options By default the DHCP will hand out the interface address as default gateway and the current DNS server addresses if not conﬁgured elsewise. You can specify ﬁxed addresses here. Only allow static hosts Any requests coming from none-static hosts will be ignored.
Page 111: Dns Server
NB2710 User Manual 4.0 5.7.3. DNS Server The DNS server can be used to proxy DNS requests towards servers on the net which have for instance been negotiated during WAN link negotiation. By pointing DNS requests to the router, one can reduce outbound DNS traﬃc as it is caching already resolved names but it can be also used for serving ﬁxed addresses for particular host names.
Page 112 NB2710 User Manual 4.0 You may further conﬁgure static hosts for serving ﬁxed IP addresses for various host names. Parameter DNS Static Hosts Settings Address The IP address of the static host Hostname The hostname of the static host Please remember to point DNS lookups of local hosts to the router’s address.
Page 113: Ntp Server
NB2710 User Manual 4.0 5.7.4. NTP Server This section can be used to individually conﬁgure the Network Time Protocol (NTP) server function. Figure 5.41.: NTP Server The following settings for each interface can be applied then: Parameter NTP Server Settings Administrative status Speciﬁes whether the NTP server is enabled or not...
Page 114: Dynamic Dns
We provide support for a bunch of common DynDNS operators but it is also possible to deﬁne a custom update URL. Please note that your NetModule router can operate as DynDNS server on its own, provided that you have your hosts pointed to the DNS service of the router.
Page 115 NB2710 User Manual 4.0 A DynDNS service can receive the following parameters: Parameter Dynamic DNS Settings Provider You can choose one of the listed providers or provide a custom URL Dynamic address Speciﬁes whether the address is derived from the hot-link or via an...
Page 116: E-Mail
NB2710 User Manual 4.0 5.7.6. E-Mail The E-Mail client can be used to send notiﬁcations to a particular E-Mail address upon certain events or by SDK scripts. Figure 5.43.: E-Mail Settings It can be enabled by applying the following settings.
Page 117: Events
NB2710 User Manual 4.0 5.7.7. Events By using the event manager you can notify remote systems about system events. A notiﬁcation can be sent using E-Mail, SMS or SNMP traps. Parameter Event Notiﬁcation Settings E-Mail address The E-Mail address to which the notiﬁcation shall be sent (E-Mail...
Page 118: Sms
5.7.8. SMS Administration NetModule routers can receive or send short messages (SMS) if enabled by your SIM provider. Messages are received/sent by the modem which has been assigned to a SIM, so one has to properly conﬁgure a SMS-capable default modem as described in chapter 5.3.3.
Page 119: Sms Number Expressions
NB2710 User Manual 4.0 Parameter SMS SIM Conﬁguration SMS gateway The service center number for sending short messages. It is gener- ally retrieved automatically from your SIM card but you may deﬁne a ﬁx number here. Routing & Filtering By using SMS routing you can specify outbound rules which will be applied whenever message are sent.
Page 120: Ssh/Telnet Server
NB2710 User Manual 4.0 5.7.9. SSH/Telnet Server Apart from the Web Manager, the SSH and Telnet services can be used to log into the system. Valid users include root and admin as well as additional users as they can be created in the User Accounts section.
Page 121 NB2710 User Manual 4.0 The following parameters can be applied to the SSH service: Parameter SSH Server Settings Administrative status Whether the SSH service is enabled or disabled Server port The TCP port of the service (usually 22) Disable admin login...
Page 122: Snmp Agent
NB2710 User Manual 4.0 5.7.10. SNMP Agent NetModule routers are equipped with an SNMP daemon, supporting basic MIB tables (such as ifTable), plus additional enterprise MIBs to manage multiple systems. Parameter Supported MIBs .1.3.6.1.2.1 MIB-II (RFC1213), SNMPv2-MIB (RFC3418) .1.3.6.1.2.1.2.1 IF-MIB (RFC2863) .1.3.6.1.2.1.4...
Page 123: Snmp Agent
NB2710 User Manual 4.0 SNMP Conﬁguration Figure 5.46.: SNMP Agent The following parameters can be used to conﬁgure the SNMP agent: Parameter SNMP Conﬁguration Administrative status Enable or disable the SNMP agent Operation mode Speciﬁes if agent should run in compatibilty mode or for SNMPv3...
Page 124 NB2710 User Manual 4.0 SNMP Authentication When running in SNMPv3, it is possible to conﬁgure the following authentication settings: Parameter SNMPv3 Authentication Authentication Deﬁnes the authentication (MD5 or SHA) Encryption Deﬁnes the privacy protocols to use (DES or AES) In general, the admin user can read and write any values. Read access will be granted to any other system users.
Page 125 NB2710 User Manual 4.0 Getting the current conﬁg description: snmpget -v 3 -u admin -n "" -l authNoPriv -a MD5 -x DES -A admin01admin01 192.168.1.1 1.3.6.1.4.1.31496.10.40.4.0 Getting the current conﬁg hash: snmpget -v 3 -u admin -n "" -l authNoPriv -a MD5 -x DES -A admin01admin01 192.168.1.1...
Page 126 NB2710 User Manual 4.0 Switching to alternative software: snmpset -v 3 -u admin -n "" -l authNoPriv -a MD5 -x DES -A admin01admin01 192.168.1.1 1.3.6.1.4.1.31496.10.40.16.0 i 0 The return value can be derived from the software update status. Switching to alternative conﬁg: snmpset -v 3 -u admin -n ""...
Page 127: Web Server
NB2710 User Manual 4.0 5.7.11. Web Server This page can be used to conﬁgure diﬀerent ports for accessing the Web Manager via HTTP/HTTPS. We strongly recommend to use HTTPS when accessing the web service via a WAN interface as the communication will be encrypted and thus avoids any misuse of the system.
Page 128: Discovery
NB2710 User Manual 4.0 5.7.12. Discovery This page can be used to enabled discovery protocols which can be used to discover and to get discovered by other hosts. Parameter Discovery Conﬁguration Administrative status Administrative status Enabled protocols List of enabled discovery protocols...
Page 129: Redundancy
NB2710 User Manual 4.0 5.7.13. Redundancy This page can be used to set up a redundant pair of NetModule routers (or other systems) by running the Virtual Router Redundancy Protocol (VRRP) between them. A typical VRRP scenario deﬁnes a ﬁrst host playing the master and another the backup device, they both deﬁne a virtual gateway IP address which will be distributed by gratuitous ARP messages for updating the ARP cache of all LAN hosts and thus redirecting the packets accordingly.
Page 130 NB2710 User Manual 4.0 Parameter Redundancy Conﬁguration Interface Interface on which VRRP should be performed Virtual gateway address The virtual gateway address formed by the participating hosts We assign a priority of 100 to the master and 1 to the backup router. Please adapt the priority of...
Page 131: Voice Gateway
Depending on your hardware, you can set up a voice gateway on the router which can be used to connect mobile calls to VoIP clients and vice versa. NB2710 routers shipping with an audio module (-A option) are feasible to implement a local speaker phone station.
Page 132: Voice Gateway Endpoint Conﬁguration
NB2710 User Manual 4.0 Parameter Voice Gateway Administration Settings SIP port Speciﬁes the agent’s listening port SIP user name Speciﬁes the username used in from headers SIP register expires Speciﬁes the registration interval in seconds In case you are running multiple WWAN interfaces sharing the same SIM, please bear in mind that the system may switch SIMs during operation which will also result in diﬀerent settings for voice...
Page 133 NB2710 User Manual 4.0 Parameter Voice Gateway Endpoint Types SIP (direct) Endpoint for calls directly routed to a SIP agent without registration SIP (user-agent) Endpoint acting as SIP user agent towards a remote registrar Audio Endpoint for internal audio device Based on your equipment, we recommend to adjust the modem’s audio proﬁle for a better sound...
Page 134 NB2710 User Manual 4.0 Parameter Endpoint Settings SIP (registrar) Subscriber The subscriber name for a registering SIP client Username The username for a registering SIP client Password The password for a registering SIP client Parameter Endpoint Settings SIP (direct) Subscriber...
Page 135: Voice Gateway Routing Conﬁguration
NB2710 User Manual 4.0 Voice Routing This page can be used to conﬁgure generic voice routing between the endpoints. Figure 5.51.: Voice Gateway Routing Conﬁguration Enhanced routing facilities are provided via the SDK interface which is able to dispatch voice calls based on their attributes (such as phone numer) and other system related status information (e.g.
Page 136 NB2710 User Manual 4.0 Client Conﬁguration Any SIP client must be conﬁgured to use the router as its registrar/proxy. Parameter X-Lite Conﬁguration User ID SIP username used in from headers (i.e. subscriber name) Domain SIP Domain used in from headers (optional) Authorization name Username used for authentication (i.e.
Page 137: System
NB2710 User Manual 4.0 5.8. SYSTEM 5.8.1. System System Settings Figure 5.52.: System System The following system parameters can be set: Parameter System Settings Local hostname The hostname of the system Application area The desired application area which inﬂuences the system behaviour such as registration timeouts or other adaptions when operating in mobile enviroments.
Page 138 This page can be used for setting the system time and conﬁguring the time zone. You may further enable daylight saving changes for your speciﬁc time zone. NetModule routers can synchronize their system time by using one or more servers by the help of the Network Time Protocol (NTP)
Page 139: Regional Settings
NB2710 User Manual 4.0 or via GNSS. If enabled, the time synchronization is usually triggered after a WAN link has come up but before starting any VPN connections. Further time synchronization cycles are scheduled in background. Figure 5.53.: Regional settings...
Page 140: Authentication
NB2710 User Manual 4.0 5.8.2. Authentication This page can be used to deﬁne the access model for all management interfaces (e.g. GUI, SSH/tel- net server). Parameter Authentication Methods Authentication required Users can login via HTTP/telnet if authentication succeeds Secure authentication re-...
Page 141: Remote Authentication
NB2710 User Manual 4.0 for 30 minutes. If login was successful, any duplicate users from other remote hosts will be logged out. Remote hosts will be blocked for 5 mintes after 10 failed login attempts. Parameter User accounts management Username...
Page 142 NB2710 User Manual 4.0 Parameter Remote authentication settings Administrative status Deﬁnes whether a remote server should be used for authentication RADIUS server The RADIUS server address RADIUS secret The secret used to authenticate against the RADIUS server Authentication port The port used for authentication...
Page 143: Software Update
NB2710 User Manual 4.0 5.8.3. Software Update Manual Software Update This menu can be used to run a manual software update of the system. Parameter Manual Software Update Update operation The update operation method being used. You can upload the...
Page 144: Module Firmware Update
Provide a URL like protocol://server/path/file A ﬁrmware package (ZIP) usually consists of a ﬂash utility and a ﬁrmware ﬁle. Please follow http://www.netmodule.com/support/supportform.aspxin order to get the latest ver- sion. 5.8.5. Software Proﬁles The system consists of two root partitions which can hold diﬀerent software versions and this menu can be used to switch between them.
Page 145: Conﬁguration
NB2710 User Manual 4.0 5.8.6. Conﬁguration Conﬁguration via the Web Manager becomes tedious for larger volumes of devices. The router therefore oﬀers automatic and manual ﬁle-based conﬁguration to automate things. Once you have successfully set up the system you can back up the conﬁguration and restore the system with it afterwards.
Page 146: Automatic File Conﬁguration
NB2710 User Manual 4.0 Automatic File Conﬁguration Figure 5.57.: Automatic File Conﬁguration This menu can be used to run an automatic conﬁguration update of the system. It is conﬁgured as follows: Parameter Automatic File Conﬁguration Status Enable/disable an automatic conﬁguration update...
Page 147: Factory Conﬁguration
NB2710 User Manual 4.0 Factory Conﬁguration Figure 5.58.: Factory Conﬁguration This menu can be used to reset the device to factory defaults. Your current conﬁguration will be lost. This procedure can also be initiated by pressing and holding the Reset button for at least ﬁve seconds.
Page 148: Troubleshooting
NB2710 User Manual 4.0 5.8.7. Troubleshooting Network Debugging There are serveral tools for network debugging like ping, traceroute, tcpdump and darkstat. Parameter Automatic software update Ping The ping utility can be used to verify whether a remote host can be reached via IP.
Page 149: Log Viewer
NB2710 User Manual 4.0 System Debugging You can view the system log here by selection the option Debug log or if you are interested in the boot log select Boot log. Another way to see what is going on on the box is opening a SSH or Telnet session as root and typing tail-log.
Page 150: Tech Support File
NB2710 User Manual 4.0 Tech Support You can generate and download a tech support ﬁle here. We strongly recommend providing this ﬁle when getting in touch with our support team, either by e-mail or via our on-line support form, as it would signiﬁcantly speed up the process of analyzing and resolving your problem. Log ﬁles can be viewed a downloaded and reset here.
Page 151: Keys And Certiﬁcates
NB2710 User Manual 4.0 5.8.8. Keys and Certiﬁcates The key and certiﬁcate page lets you generate required ﬁles for securing your services (such as HTTP and SSH server) but also to implement authentication and encryption for certiﬁcate-based VPN tunnels and WLAN clients.
Page 152: Certiﬁcate Sections
NB2710 User Manual 4.0 Type Description WLAN Keys and certiﬁcates for implementing certiﬁcate-based WLAN au- thentication (e.g. WPA-EAP-TLS). Authorities Other certiﬁcate authorities which we trust when establishing SSL client connections. Table 5.130.: Certiﬁcate Sections For each certiﬁcate section it is possible to perform the following operations:...
Page 153: Certiﬁcate Conﬁguration
NB2710 User Manual 4.0 Conﬁguration Figure 5.62.: Certiﬁcate Conﬁguration This page provides some general conﬁguration options which will be applied when operating on keys and certiﬁcates. If keys, certiﬁcates and signing requests are generated locally, the following settings will be take...
Page 154 NB2710 User Manual 4.0 Parameter Certiﬁcate Conﬁguration Expiry period The number of days a certiﬁcate will be valid from now on Key size The length of the private key in bits DH primes The number of bits for custom Diﬃe-Hellman primes Signature The signature algorithm when signing certiﬁcates...
Page 155 NB2710 User Manual 4.0 using the getca operation. It will be shown on the conﬁguration page and it has to be veriﬁed that it belongs to the correct authority. Otherwise, the CA must be rejected. This part is essential when using SCEP as it builds up the chain of trust.
Page 156: Licensing
NB2710 User Manual 4.0 5.8.9. Licensing Certain features of NetModule routers require a valid license to be present in the system, some of them also depend on the mounted modules. Please contact us for getting a valid license for available components and we will provide a license ﬁle based on your serial number which can be installed to the router afterwards.
Page 157: Legal Notice
5.8.10. Legal Notice OSS Notice 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), GNU Lesser General Public License (LGPL) or other open-source licenses.
Page 158: Logout
NB2710 User Manual 4.0 5.9. LOGOUT Please use this menu to log out from the Web Manager.
Page 159: Command Line Interface
6. Command Line Interface The Command Line Interface (CLI) oﬀers a generic control interface to the router and can be used to get/set conﬁguration parameters, apply updates, restart services or perform other system tasks. It will be started automatically in interactive mode when logging in as admin user or by running cli -i.
Page 160: Print Help
NB2710 User Manual 4.0 Key Sequence Action CTRL-q Reactivate frozen session CTRL-d Delete character at point or exit CLI if at the beginning of the line CTRL-t Drag the character before point forward moving point forward as well; if point...
Page 161: Setting Conﬁg Parameters
NB2710 User Manual 4.0 > get Usage : get [ hsvfc ] <parameter> [<parameter > . . ] Options : generate sourceable output validate config parameter get factory default rather than current value show configuration sections 6.4. Setting Conﬁg Parameters The set command can be used to set conﬁguration values.
Page 162: Scanning Networks
NB2710 User Manual 4.0 dialin Dial In connection status mobileip MobileIP status Digital IO status audio Audio module status CAN module status uart UART module status ibis IBIS module status redundancy Redundancy status SMS status firewall Firewall status QoS status...
Page 163: Manage Keys And Certiﬁcates
NB2710 User Manual 4.0 Options : reboot after update force update don t reset missing config values with factory defaults show update status Available update targets : software Perform software update firmware Perform module firmware update config Update configuration license...
Page 164: Debug System
NB2710 User Manual 4.0 GRE connections ipsec IPsec connections lighttpd HTTP server link manager WAN links network Networking openvpn OpenVPN connections pptp PPTP connections QoS daemon smsd SMS daemon snmpd SNMP daemon surveyor Supervision daemon syslog Syslog daemon telnet Telnet server...
Page 165: Resetting System
NB2710 User Manual 4.0 6.12. Resetting System The reset command can be used to reset the router back to factory defaults. > reset Usage : reset [ h ] 6.13. Rebooting System The reboot command can be used to reboot the router.
Page 166 NB2710 User Manual 4.0 This section describes the CLI-PHP interface for Version 2. It accepts POST and GET requests. Running with GET requests, the general usage is deﬁned as follows: Usage : http ( s ) : / / cli . php?<key1>= <value1>& <key2>= <value2 >..<keyN>= <valueN>...
Page 167 NB2710 User Manual 4.0 Available sections can be retrieved by running command=status&arg0= h . Please note that the status summary can be displayed without authentication . Examples : http : / / 1 9 2 . 1 6 8 . 1 . 1 / cli . php ? version=2&output=html&usr=admin&pwd=admin01&...
Page 168 NB2710 User Manual 4.0 Key usage : command=restart&arg0=<service> Notes : Available services can be retrieved by running command=restart&arg0= h Examples : http : / / 1 9 2 . 1 6 8 . 1 . 1 / cli . php ? version=2&output=html&usr=admin&pwd=admin01&...
Page 169 NB2710 User Manual 4.0 http : / / 1 9 2 . 1 6 8 . 1 . 1 / cli . php ? version=2&output=html&usr=admin&pwd=admin01& command=update&arg0=license&arg1=http : / / 1 9 2 . 1 6 8 . 1 . 2 5 4 / xxx . lic http : / / 1 9 2 .
Page 170 NB2710 User Manual 4.0 In case of stdout , the downloaded techsupport file will be called download . Examples : http : / / 1 9 2 . 1 6 8 . 1 . 1 / cli . php ? version=2&output=mime&usr=admin&pwd=admin01&...
Page 171: Appendix
A. Appendix A.1. Abbrevations Parameter Description ETHx Corresponds to Ethernet interfaces (either single or switched ones) LANx LAN interfaces which are generally based on Ethernet interfaces (including bridges) WLANx Refers to a Wireless LAN interface which will be represented as additional LAN interface when conﬁgured as access point WWANx Refers to a Wireless Wide Area Network (2G/3G/4G) connection...
Page 172: System Events
NB2710 User Manual 4.0 Parameter Description Command Line Interface, a generic interface to query the router or perform system tasks Subscriber Identity Module Short Message Service SSID Service Set Identiﬁers, can be used to deﬁne multiple WLAN net- works on a module...
Page 173 NB2710 User Manual 4.0 Event Description wan-up WAN link came up wan-down WAN link went down dio-in1-on DIO IN1 turned on dio-in1-oﬀ DIO IN1 turned oﬀ dio-in2-on DIO IN2 turned on dio-in2-oﬀ DIO IN2 turned oﬀ dio-out1-on DIO OUT1 turned on dio-out1-oﬀ...
Page 174: System Events
NB2710 User Manual 4.0 Event Description system-time-updated System time has been updated system-poweroﬀ System poweroﬀ has been triggered sms-sent SMS has been sent sms-notsent SMS has not been sent sms-received SMS has been received sms-report-received SMS report has been received...
Page 175: Factory Conﬁguration
NB2710 User Manual 4.0 A.3. Factory Conﬁguration The factory conﬁguration including default values for any conﬁguration parameter can be derived from the ﬁle /etc/config/factory-config.cfg on the router. You may also call cli get -f <parameter> for obtaining a speciﬁc default value.
Page 176: Snmp Vendor Mib
-- * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * -- NetModule AG VENDOR MIB -- ( c ) COPYRIGHT 2017 by NetModule AG , Switzerland -- All rights reserved .
Page 177 NB2710 User Manual 4.0 OBJECT IDENTIFIER ::= { nb 53 } OBJECT IDENTIFIER ::= { nb 90 } traps OBJECT IDENTIFIER ::= { nb 100 } -- * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *...
Page 178 NB2710 User Manual 4.0 SYNTAX DateAndTime MAX - ACCESS read - only STATUS current DESCRIPTION " The current local date and time of day . " ::= { admin 9 } deviceRestart OBJECT - TYPE SYNTAX INTEGER { restart (1)
Page 179 NB2710 User Manual 4.0 ::= { admin 22 } configUpdated OBJECT - TYPE SYNTAX DateAndTime MAX - ACCESS read - only STATUS current DESCRIPTION " The date of the last configuration update " ::= { admin 23 } conf igU pd a te Mod e OBJECT - TYPE...
Page 180 NB2710 User Manual 4.0 a lt S o f t w ar e V er s i o n OBJECT - TYPE SYNTAX DisplayString MAX - ACCESS read - only STATUS current DESCRIPTION " The version of the alternative software "...
Page 181 NB2710 User Manual 4.0 DESCRIPTION " An entry describing a WWAN modem and its current settings " INDEX { wwanModemIndex } ::= { nbWwanTable 1 } NBWwanEntry ::= SEQUENCE { wwanModemInd ex Integer32 , wwanModemName DisplayString , wwanModemType DisplayString ,...
Page 182 NB2710 User Manual 4.0 wwanCellId OBJECT - TYPE SYNTAX DisplayString MAX - ACCESS read - only STATUS current DESCRIPTION " The Cell ID ( CID ) to which the WWAN modem is currently registered " ::= { nbWwanEntry 10 }...
Page 183 NB2710 User Manual 4.0 ::= { nbGnssEntry 4 } gnssLon OBJECT - TYPE SYNTAX DisplayString MAX - ACCESS read - only STATUS current DESCRIPTION " The current longitude value received by the GNSS device " ::= { nbGnssEntry 5 }...
Page 184 NB2710 User Manual 4.0 wlanMod ul eInd ex OBJECT - TYPE SYNTAX Integer32 (0..254) MAX - ACCESS not - accessible STATUS current DESCRIPTION " WLAN module index " ::= { nbWlanEntry 1 } wlanModuleNa me OBJECT - TYPE SYNTAX DisplayString...
Page 185 NB2710 User Manual 4.0 wlan Sta ti o nI nde x OBJECT - TYPE SYNTAX Integer32 (0..254) MAX - ACCESS not - accessible STATUS current DESCRIPTION " WLAN station index " ::= { n b Wl a nS t a t i o nE n t r y 1 }...
Page 186 NB2710 User Manual 4.0 SYNTAX NBWanEntry MAX - ACCESS not - accessible STATUS current DESCRIPTION " An entry describing a WAN link and its current status " INDEX { wanLinkIndex } ::= { nbWanTable 1 } NBWanEntry ::= SEQUENCE {...
Page 187 NB2710 User Manual 4.0 ::= { nbWanEntry 8 } wanLinkNetma sk OBJECT - TYPE SYNTAX DisplayString MAX - ACCESS read - only STATUS current DESCRIPTION " WAN link netmask " ::= { nbWanEntry 9 } wanDial At temp ts OBJECT - TYPE...
Page 188 NB2710 User Manual 4.0 dioStatusIn1 OBJECT - TYPE SYNTAX INTEGER { off (0) , on (1) MAX - ACCESS read - only STATUS current DESCRIPTION " The current value of digital I / O port IN1 " ::= { dio 1 }...
Page 189 NB2710 User Manual 4.0 STATUS current DESCRIPTION " DIO IN1 turned on " ::= { events 201 } dio - in1 - off NOTIFICATION - TYPE STATUS current DESCRIPTION " DIO IN1 turned off " ::= { events 202 }...
Page 190 NB2710 User Manual 4.0 STATUS current DESCRIPTION " Mobile IP connection came up " ::= { events 410 } mobileip - down NOTIFICATION - TYPE STATUS current DESCRIPTION " Mobile IP connection went down " ::= { events 411 }...
Page 191 NB2710 User Manual 4.0 STATUS current DESCRIPTION " Outgoing voice call is being established " ::= { events 702 } ddns - update - succeeded NOTIFICATION - TYPE STATUS current DESCRIPTION " Dynamic DNS update succeeded " ::= { events 801 }...
Page 192: Sdk Examples
NB2710 User Manual 4.0 A.5. SDK Examples Event Description best-operator.are This script will scan for operators on startup and choose the one with the best signal candump.are This script can be used to receive CAN messages conﬁg-summary.are This script shows a summary of the currently running conﬁguration.
Page 193 NB2710 User Manual 4.0 Event Description ping-supervision.are This script will supervise a speciﬁed host. read-conﬁg.are This script can be used to read a conﬁguration parameter. remote-mail.are This script reads sends mails from remote IMAP/POP3/SMTP server scan-mobile.are This script can be used to switch the Mobile LAI according to available networks scan-wlan.are...
Page 194: Sdk Examples
NB2710 User Manual 4.0 Event Description tcpserver.are This script implements a TCP server which is able to receive mes- sages. techsupport.are This transfers a techsupport to a remote FTP server transfer-ﬁle.are This scripts archives a remote ﬁle transfer.are This scripts stores the latest GNSS positions in a remote FTP ﬁle udp-msg-server.are...

This manual is also suitable for:

Nb1600

NetModule NB2710 User Manual

1 Welcome to Netmodule

2 Conformity

3 Speciﬁcations

4 Installation

5 Conﬁguration

6 Command Line Interface

Appendix

Quick Links

Need help?

Questions and answers

Related Manuals for NetModule NB2710

Summary of Contents for NetModule NB2710

This manual is also suitable for:

Table of Contents