Page 1
NetModule Router NB3710 User Manual for Software Version 4.4 Manual Version 1.13 NetModule AG, Switzerland September 30, 2022...
Page 2
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.
User Manual for NRSW version 4.4 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.
– Changes made to the device or the use of non-authorized accessories will render the warranty null and void and potentially invalidate the operating license. – NetModule routers must not be opened (SIM cards may be used according to the instructions).
Page 12
– Exercise particular caution near personal medical aids, such as pacemakers and hear- ing aids. – The NetModule routers may also cause interference in the nearer distance of TV sets, radio receivers and personal computers. – Never perform work on the antenna system during a thunderstorm.
User Manual for NRSW version 4.4 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 RED Directive 2014/53/EU. The signed version of the Declaration of Conformity can be obtained http://www.netmodule.com/downloads...
User Manual for NRSW version 4.4 2.5. Open Source Software We inform you that NetModule products may contain in part open-source software. We are distributing such open-source software to you under the terms of GNU General Public License (GPL) , GNU...
NB3710 User Manual for NRSW version 4.4 3.2. Features All models of NB3710 have the following standard functionalities: – Galvanically isolated power supply – 5 Ethernet ports (M12, 10/100 Mbit/s) – 1 USB 2.0 host port – 2 digital inputs, 2 digital outputs –...
Page 17
– Software Key Voice Note:All LTE models include support for UMTS/EDGE/GPRS. Due to its modular approach, the NB3710 router and its hardware components can be arbitrarily assembled according to its indented usage or application. Please contact us in case of special project...
NB3710 User Manual for NRSW version 4.4 3.3. Environmental Conditions Parameter Rating Input Voltage (Variant Pa) 12 V to 48 V ( 15% / +30%) Input Voltage (Variant Pb) 72 V to 110 V ( 30% / +30%) Operating Temperature Range...
NB3710 User Manual for NRSW version 4.4 3.4. Interfaces 3.4.1. Overview Nr. Label Function LED Indicators LED Indicators for the different interfaces Reset Reboot and factory reset button SIM 1-4 SIM 1-4, they can be assigned dynamically to any modem by configuration.
Extension Galvanically isolated extension port M12 connector GNSS TNC female connector for GPS/GLONASS antenna Table 3.2.: NB3710 Interfaces 3.4.2. LED Indicators Status LEDs The following table describes the NB3710 status indicators. Label Color State Function Status blinking The device is busy due to startup, software or configuration up- date.
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.3.: NB3710 Status Indicators Ethernet LEDs The following table describes the Ethernet status indicators. Label Color...
40 cm tenna Connector type Table 3.6.: Mobile Antenna Port Specification 3.4.5. WLAN The variants of the NB3710 support up to 2 802.11 a/b/g/n WLAN modules. Each can operate either as client or access point. Standard Frequencies Bandwidth Data Rate 802.11a...
Connector type Table 3.8.: WLAN Antenna Port Specification Note: WLAN antennas with a higher amplification may be used with the NetModule router "Enhanced-RF-Configuration" software license and the antenna gain and cable attenuation that have been correctly configured by certified specialized...
NB3710 User Manual for NRSW version 4.4 3.4.6. GNSS GNSS (Option G) The GNSS is used from a WWAN Module. Feature Specification Systems GPS/GLONASS Data stream JSON or NMEA Tracking sensitivity -154 dBm Supported antennas Active and passive Table 3.9.: GNSS Specifications option G GNSS (Option Ge) The GNSS module supports Dead Reckoning with onboard 3D accelerometer and 3D gyroscope.
NB3710 User Manual for NRSW version 4.4 Feature Specification Speed Low, Full & Hi-Speed Current max. 500 mA Max. cable length Cable shield mandatory Connector type Type A Table 3.12.: USB 2.0 Host Port Specification 3.4.8. M12 Ethernet Connectors Specification The five Ethernet ports have following specification:...
NB3710 User Manual for NRSW version 4.4 Pin Assignment on M12, 4 poles, D-coded female Signal Pinning Table 3.14.: Pin Assignments of Ethernet Connectors 3.4.9. Power Supply Standard variant Pa (12 V to 48 V The power input has the following specifications: Feature Specification...
NB3710 User Manual for NRSW version 4.4 Variant Pb (72 V to 110 V The power input has the following specifications: Feature Specification Power supply nominal voltages 72 V , 96 V and 110 V (according to EN 50155) Voltage range...
NB3710 User Manual for NRSW version 4.4 3.4.10. Digital Inputs and Outputs The isolated input and oputput ports have the following specification in common: Feature Specification Isolation to enclosure/GND 1’000 V Isolation to adjacent I/O functional Max. cable length 10 m...
NB3710 User Manual for NRSW version 4.4 Signal Pinning DI1+ DI2+ DO1: Dry contact relay normally open DO1: Dry contact relay normally open DO2: Dry contact relay normally closed DO2: Dry contact relay normally closed Table 3.21.: Pin Assignments of Digital Inputs and Outputs...
Available Options The NB3710 has an M12 extension connector with 8 pins. The 8 pins are split into two logical ports: Pins 1 to 4 represent Extension Port 1 (EP1) and pin 5 to 8 represent Extension Port 2 (EP2). On both EP1 and EP2 the following interfaces may be present: –...
NB3710 User Manual for NRSW version 4.4 Audio Port Specification (Option A) The Audio port has the following specification: Feature Specification Protocol Audio Line In/Out Input impedance 44 kΩ, signal level 2 V Input bandwidth 100 Hz- 15 kHz Input galvanic isolation to enclosure functional (max.
NB3710 User Manual for NRSW version 4.4 CAN Port Specification (Option C) The CAN port has the following specification: Feature Specification Protocol CAN V2.0B Speed Up to 1 Mbit/s Default: 125 kbit/s Galvanic isolation to enclosure 1500 V Internal bus termination...
NB3710 User Manual for NRSW version 4.4 IBIS Port Specification (Option I) The IBIS port has the following specification: Feature Specification Protocol ’IBIS Wagenbus’, according to VDV300 and VDV301 Device type ’IBIS Peripheriegerät’, according to VDV300 and VDV301 Speed 1200 Baud...
NB3710 User Manual for NRSW version 4.4 Non-isolated 3-wire RS-232 Port Specification Option S The non-isolated 3-wire RS-232 port has the following specification (bold characters show the default configuration): Feature Specification Protocol 3-wire RS-232: GND, TXD, RXD Baud rate 300, 1 200, 2 400, 4 800, 9 600, 19 200, 38 400,...
NB3710 User Manual for NRSW version 4.4 Isolated 3-wire RS-232 Port Specification (Option Sb) The isolated 3-wire RS-232 port has the following specification (bold characters show the default con- figuration): Feature Specification Protocol 3-wire RS-232: GND, TXD, RXD Baud rate...
NB3710 User Manual for NRSW version 4.4 RS-485 Port Specification (Option Sa) The RS-485 port has the following specification (bold characters show the default configuration): Feature Specification Protocol 3-wire RS-485 (GND, A, B) Baud rate 600, 1 200, 2 400, 4 800, 9 600, 19 200, 38 400,...
4.1. Installation of the Mini-SIM Card Up to four Mini-SIM cards can be inserted in a NB3710 router. SIM cards can be inserted by sliding it into one of the designated slots on the front panel. You have to push the SIM card using a small paper clip (or similar) until it snaps into place.
NB3710 User Manual for NRSW version 4.4 The following table shows how to connect the LTE/UMTS antennas. Generally, LTE antennas use both, main and auxiliary ports, but UMTS requrires only main ports. Antenna Port Type Mob 1 (Top) Main Mob 1...
– WLAN antennas must only be installed in buildings or within vehicle hulls. – WLAN antennas may have an amplification of maximum 3dBi in the relevant frequency range. WLAN antennas with a higher amplification may be used with the NetModule router "Enhanced-RF-Configuration" software license and the antenna gain and cable attenuation that have been correctly configured by certified specialized personnel.
The router is now ready for getting engaged. Attention: Only CE-compliant power supplies with a current-limited SELV output volt- age range (for NetModule routers with "Pb" option with a correspondingly higher output voltage range and in accordance with appropriate comparable safety precautions) may...
NB3710 User Manual for NRSW version 4.4 4.7. Installation of the Audio Interface The audio interface (line out) is available on the PTT (Option Ap) and the Audio (Option A) extension. Attention: Risk of hearing damage: Avoid the use of earphones or Headphones at high volumes...
5.1. First Steps NetModule routers can be easily set up by using the HTTP-based configuration 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.
NB3710 User Manual for NRSW version 4.4 esteblish a mobile data connection automatically. This feature is highly dependent on the SIM card features and the available networks. This Option is only availble if the router is equipped with a cellular module.
Page 46
NB3710 User Manual for NRSW version 4.4 power of the interface as well as the list of associated stations. GNSS This page displays the position status values, such as latitude/longitude, the satellites in view and more details about the used satellites.
Page 47
This page provides information about Dynamic DNS. System Status The system status page displays various details of your NB3710 router, including system details, information about mounted modules and software release information. This section will list all webpages generated by SDK scripts.
Page 49
NB3710 User Manual for NRSW version 4.4 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 Sufficient signal strength...
Page 50
If WLAN client, the LAN interface to which the WAN link should be bridged. 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 first DHCP client of the specified LAN interface. As Ethernet- based communication requires additional addresses, we pick an appropriate subnet to talk to the LAN host.
Page 53
NB3710 User Manual for NRSW version 4.4 Parameter Supervision Settings Ping interval The interval in seconds at which pings are transmitted on each inter- face Retry interval The interval in seconds at which pings are re-transmitted in case a first ping failed Max.
User Manual for NRSW version 4.4 5.3.2. Ethernet NB3710 routers ship with an Ethernet switch (ETH1-ETH5) which can be linked via M12 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 configuring a WAN link. The LAN10 interface will be available as soon as a pre-configured USB Ethernet device has been plugged in.
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 Identifier (VLAN ID) which is used for distributing the packets to the associated...
Page 58
NB3710 User Manual for NRSW version 4.4 Parameter LAN IP Settings Alias subnet mask The alias subnet mask for this interface When running in WAN mode, the interface may be configured with the following settings: Parameter WAN IP Settings WAN mode The WAN operation mode, defines whether the interface should run...
Page 60
NB3710 User Manual for NRSW version 4.4 not, please double-check your PIN. Please keep in mind that registering to a network usually takes some time and depends on signal strength and possible radio interferences. You may hit the Update button at any time in order to restart PIN unlocking and trigger another network registration attempt.
Page 61
NB3710 User Manual for NRSW version 4.4 Configuration 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 different 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 affect their operation.
Page 63
NB3710 User Manual for NRSW version 4.4 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 configure the following settings manually:...
Page 65
NB3710 User Manual for NRSW version 4.4 Configurable parameters for access-point, client mode, mesh point and any dual mode: Parameter WLAN Management Regulatory Domain Select the country the Router operates in Number of antennas Set the number of connected antennas Antenna gain Specify the antenna gain for the connected antennas.
NB3710 User Manual for NRSW version 4.4 Standard Frequencies Bandwidth Data Rate 802.11g 2.4 GHz 20 MHz 54 Mbit/s 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.20.: IEEE 802.11 Network Standards...
Page 67
Specifies the desired IEEE 802.11 operation mode Radio band Selects the radio band to be used for connections, depending on your module it could be 2.4 or 5 GHz Channel Specifies the channel to be used Note: NetModule Routers with 802.11n and 802.11ac support 2x2 MIMO...
Page 68
NB3710 User Manual for NRSW version 4.4 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 70
NB3710 User Manual for NRSW version 4.4 This section can be used to configure security-related settings. Parameter WLAN Access-Point Configuration 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 offers both.
Page 71
NB3710 User Manual for NRSW version 4.4 Running in mesh point mode, it is possible to connect to one or more mesh points within the mesh network at the same time. The system will automatically join the wireless network, connect to the other mesh partners with the same ID and sercurtiy credentials.
Page 72
NB3710 User Manual for NRSW version 4.4 The following security modes can be configured: Parameter WLAN Mesh-Point Security Modes MESHID is disabled None No authentication, provides an open network SAE (Simultaneous Authentication of Equals) is a secure password- based authentication and key establishment protocol...
Page 74
NB3710 User Manual for NRSW version 4.4 The following feature can be configured if the WLAN interface is bridged Parameter WLAN Bridging features 4addr frame Enables the 4-address frame format (required for bridge links) IAPP Enables the Inter-Access Point Protocol feature...
NB3710 User Manual for NRSW version 4.4 5.3.5. Software Bridges Software bridges can be used to bridge layer-2 devices like OpenVPN TAP, GRE or WLAN interfaces without the need for a physical LAN interface. Bridge Settings This page can be used to enable/disable software bridges.
User Manual for NRSW version 4.4 5.3.6. 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 78
NB3710 User Manual for NRSW version 4.4 USB Autorun This feature can be used to automatically launch a shell script or perform a software/config update as soon as an USB storage stick has been plugged in. For authentication, a file called autorun.key must exist in the root directory of a FAT16/32 formatted stick.
NB3710 User Manual for NRSW version 4.4 5.3.7. 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 82
NB3710 User Manual for NRSW version 4.4 Parameter Serial Settings Defines the software flow control for the serial port, XOFF will send a Software flow control stop, XON a start character to the other end to control the rate of any incoming data Hardware flow control...
Page 83
NB3710 User Manual for NRSW version 4.4 When running the serial port as AT modem emulator the following settings can be applied: Parameter Serial Port Settings Physical protocol Selects the desired physical protocol on the serial port Baud rate Specifies the baud rate run on the serial port Hardware flow control...
NB3710 User Manual for NRSW version 4.4 5.3.9. Audio Audio Administration This page can be used to pre-configure the audio module. It can be later used for the voice gateway. It can be configured as follows: Parameter Audio Settings Volume level...
NB3710 User Manual for NRSW version 4.4 5.3.10. GNSS Administration The GNSS page lets you enable or disable the GNSS modules present in the system and can be used to configure 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 87
NB3710 User Manual for NRSW version 4.4 Parameter GNSS Server Configuration Specifies where clients can connect from, can be either everywhere Allow clients from or from a specific network Clients start mode Specifies how data transferal is accomplished when a client connects.
Page 88
NB3710 User Manual for NRSW version 4.4 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...
NB3710 User Manual for NRSW version 4.4 Parameter Static Route Configuration 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 specified by a netmask of 255.255.255.255, a default route corresponds to 0.0.0.0.
Cisco 2900 Series home agent implementation has been verified. 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 94
NB3710 User Manual for NRSW version 4.4 Parameter Mobile IP Configuration The shared secret used for authentication of the mobile node at the Shared secret home agent. This can be either a 128-bit hexadecimal value or a random length ASCII string.
Page 96
NB3710 User Manual for NRSW version 4.4 Parameter Mobile IP Node Configuration The shared secret used for authentication of the mobile node at the Shared secret home agent. This can be either a 128-bit hexadecimal value or a random length ASCII string.
User Manual for NRSW version 4.4 5.4.5. Quality Of Service NetModule routers are able to prioritize and shape certain kinds of IP traffic. This is currently limited on egress, which means that only outgoing traffic can be stipulated. The current QoS solution is using Stochastic Fairness Queueing (SFQ) classes in combination with Hierarchy Token Bucket (HTB) qdiscs.
Page 98
NB3710 User Manual for NRSW version 4.4 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)
5.4.6. Multicast Multicast routing (MCR) can be configured and managed by a daemon. Only one MCR daemon can be used at a time. NetModule routers ship with two different MCR daemons to select from depending on your dependen- cies: Parameter...
NB3710 User Manual for NRSW version 4.4 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 Specifies whether the OSPF routing protocol is active Redistribute...
NB3710 User Manual for NRSW version 4.4 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 Specifies whether the BGP routing protocol is active...
NB3710 User Manual for NRSW version 4.4 5.5. FIREWALL 5.5.1. Administration NetModule routers use Linux’s netfilter/iptables firewall framework http://www.netfilter.org (see 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 104
NB3710 User Manual for NRSW version 4.4 Parameter Firewall Rule Configuration Protocol The used IP protocol of matching packets (UDP, TCP or ICMP) Destination port(s) The destination port of matching packets, which can be specified by a single port or a range of ports (only UDP/TCP).
Page 107
NB3710 User Manual for NRSW version 4.4 Parameter Inbound NAPT Rules Ports The used UDP/TCP port of matching packets Redirect to The address to which matching packets shall be redirected Redirect port The port to which matching packets will be redirected...
User Manual for NRSW version 4.4 Tunnel Configuration NetModule routers support one single server tunnel and up to four client tunnels. You can specify tunnel parameters either in standard configuration or upload an expert mode file which has been created in advance. Refer to chapter 5.6.1...
Page 110
NB3710 User Manual for NRSW version 4.4 If the tunnel is operated in client mode, the following settings can be applied: Parameter OpenVPN Client Configuration Peer selection Specifies how the remote peer shall be selected, besides a single server you may configure multiple servers which can, in case of fail- ures, either be selected sequently (i.e.
Page 111
NB3710 User Manual for NRSW version 4.4 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...
Page 112
NB3710 User Manual for NRSW version 4.4 OpenVPN Expert Configuration (Server) A server tunnel typically requires the following files: Parameter Server Expert Files server.conf OpenVPN configuration file ca.crt Root certificate authority file server.crt Certificate file server.key Private key file dh1024.pem Diffie-Hellman parameters file...
NB3710 User Manual for NRSW version 4.4 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 117
Restart the peer. IKE Authentication NetModule routers support IKE authentication through pre-shared keys (PSK) or certificates within a public key infrastructure. Extended Authentication (XAUTH) leverages RADIUS-like authentication and can be used to apply user level access control over IPSec.
Page 118
NB3710 User Manual for NRSW version 4.4 IKE Proposal This section can be used to configure the phase 1 settings: Parameter IPsec IKE Proposal Settings Choose the desired negotiation mode. Preferably, main mode should Negotiation mode be used but aggressive mode might be applicable when dealing with dynamic endpoint addresses.
Page 119
NB3710 User Manual for NRSW version 4.4 Parameter IPsec Network Settings Local network The address of your local area network Local netmask The netmask of your local area network Peer network The address of the remote network behind the peer...
NB3710 User Manual for NRSW version 4.4 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 defined in RFC 1701, 1702 and 2784.
NB3710 User Manual for NRSW version 4.4 5.6.5. L2TP The Layer 2 Tunneling Protocol is a tunneling protocol which does not support any encryption or confidentiality. It relies on an encryption protocol that it passes within the tunnel to provide privacy.
NB3710 User Manual for NRSW version 4.4 5.6.6. Dial-In On this page you can configure 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 126
NB3710 User Manual for NRSW version 4.4 Please note that Dial-In connections are generally discouraged. As they are implemented as GSM voice calls, they suffer from unreliability and poor bandwidth.
5.7. SERVICES 5.7.1. SDK NetModule routers are shipping with a Software Development Kit (SDK) which offers a simple and fast way to implement customer-specific functions and applications. It consists of: 1. An SDK host which defines the runtime environment (a so-called sandbox), that is, controlling...
Page 128
NB3710 User Manual for NRSW version 4.4 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.
Page 129
NB3710 User Manual for NRSW version 4.4 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 specific section (a list of available sections can be obtained by running cli status -h).
Page 130
NB3710 User Manual for NRSW version 4.4 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 133
NB3710 User Manual for NRSW version 4.4 Parameter SDK Script Parameters Name A meaningful name to identify the script Description An optional description of the script Arguments An optional set of arguments passed to the script (supports quoting) Action You may either edit a script, upload it to the system or select one of...
Page 134
NB3710 User Manual for NRSW version 4.4 Testing The testing page offers an editor and an input field for optional arguments which can be used to perform test runs of your script or test dedicated portions of it or upload an entire file. Please note that you might need to quote arguments as they will otherwise be separated by white-spaces.
NB3710 User Manual for NRSW version 4.4 The following commands are supported: Command Action status Will reply a message to the sender including a short system overview connect Will enable the first WAN link configured on the system disconnect Will disable the first WAN link configured on the system...
Page 137
NB3710 User Manual for NRSW version 4.4 Parameter DHCP Server Settings Persistent leases By turning on this option the router will remember issued leases even after a reboot. This can be used to ensure that the same IP address will be assigned to a particular host.
Page 139
NB3710 User Manual for NRSW version 4.4...
Page 140
NB3710 User Manual for NRSW version 4.4 You may further configure static hosts for serving fixed 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...
We provide support for a bunch of common DynDNS operators but it is also possible to define 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 143
NB3710 User Manual for NRSW version 4.4 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 Specifies whether the address is derived from the hot-link or via an...
NB3710 User Manual for NRSW version 4.4 5.7.7. Events By using the event manager you can notify remote systems about system events. A notification can be sent using E-Mail, SMS or SNMP traps. Parameter Event Notification Settings E-Mail address The E-Mail address to which the notification shall be sent (E-Mail...
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 configure a SMS-capable default modem as described in chapter 5.3.3.
NB3710 User Manual for NRSW version 4.4 identify SIMs based on their IMEI number and track their statistics in a non-volatile manner. Parameter SMS SIM Configuration SMS gateway The service center number for sending short messages. It is generally retrieved automatically from your SIM card but you may define a fix number here.
Page 150
NB3710 User Manual for NRSW version 4.4 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)
NB3710 User Manual for NRSW version 4.4 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...
Page 153
NB3710 User Manual for NRSW version 4.4 SNMP Authentication When running in SNMPv3, it is possible to configure the following authentication settings: Parameter SNMPv3 Authentication Authentication Defines the authentication (MD5 or SHA) Encryption Defines the privacy protocols to use (DES or AES) In general, the admin user can read and write any values.
Page 154
NB3710 User Manual for NRSW version 4.4 Getting the current config 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 config hash: 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.5.0...
Page 155
NB3710 User Manual for NRSW version 4.4 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.
NB3710 User Manual for NRSW version 4.4 5.7.12. Softflow This page can be used to configure the network traffic analyser daemon softflowd used for exporting NetFlow traffic data. Parameter Softflow Settings Interface Interface on which to listen for traffic Host Address Destination address of the traffic data...
NB3710 User Manual for NRSW version 4.4 5.7.13. 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 Configuration Administrative status Administrative status Enabled protocols...
User Manual for NRSW version 4.4 5.7.14. 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 defines a first host playing the master and another the backup device, they both define a virtual gateway IP...
Page 160
NB3710 User Manual for NRSW version 4.4 Parameter Redundancy Configuration Role The role of this system (either master or backup) The Virtual Router ID (you can theoretically run multiple instances) 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.
Page 162
NB3710 User Manual for NRSW version 4.4 Parameter Voice Gateway Administration Settings SIP interface Specifies the interface (LAN or WAN) on which the agent should listen for incoming calls SIP port Specifies the agent’s listening port SIP register expires Specifies the registration interval in seconds...
Page 163
NB3710 User Manual for NRSW version 4.4 Parameter Voice-Over-Mobile Audio Profiles Speakerphone Handle situations of loud echo with extreme acoustic distortion. This mode is intended for use with a car kit or speakerphone appli- cations with high volume and high distortion. Acoustic echo in this situation has negative ERL and is impossible to cancel completely.
Page 164
NB3710 User Manual for NRSW version 4.4 Parameter Endpoint Settings SIP (user-agent) Register Selects whether the user-agent shall register at the registrar Expires The expiry time in seconds after registration will be triggered again...
Page 165
NB3710 User Manual for NRSW version 4.4 Voice Routing This page can be used to configure generic voice routing between the endpoints. 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 166
NB3710 User Manual for NRSW version 4.4 Client Configuration Any SIP client must be configured to use the router as its registrar/proxy. Parameter X-Lite Configuration 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 168
NB3710 User Manual for NRSW version 4.4 Parameter System Settings Enable TCP timestamps Enable TCP timestamps for system wide TCP communication. This is needed for Protection Against Wrapped Sequence numbers (PAWS), but with these timestamps enabled a remote attacker can guess the uptime of the system.
This page can be used for setting the system time and configuring the time zone. You may further enable daylight saving changes for your specific time zone. NetModule routers can synchronize their system time by using one or more servers by the help of the Network Time Protocol (NTP) or via GNSS.
Page 170
NB3710 User Manual for NRSW version 4.4 Parameter Time Synchronisation NTP server Address of the primary NTP server NTP server 2 Optionally, the address of a second NTP server Ping check Uses an ICMP ping to check whether NTP servers are available when...
Page 172
NB3710 User Manual for NRSW version 4.4 Parameter User accounts management Role Either admin or user Shell Specifies if the user gets the CLI or a SHELL Store password unen- If this option is selected the user password is stored unencrypted on...
NB3710 User Manual for NRSW version 4.4 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 image,...
NB3710 User Manual for NRSW version 4.4 Attention In case you perform a major downgrade with a previous release line (e.g. 3.7.0 to 3.6.0), please ensure to always use the latest release of that branch (i.e. 3.6.0.X) as only those tend to be fully forward-compatible.
TFTP, HTTP, HTTPS, and FTP. For boxes with limited amount of flash you may also use usb0://<path-to-firmware-package>. A firmware package (ZIP) usually consists of a flash utility, an info file and the corresponding firmware files. Please follow http://www.netmodule.com/support/supportform.aspx in order to get the latest ver- sion. 5.8.5. Software Profiles The system consists of two root partitions which can hold different software versions and this menu can be used to switch between them.
NB3710 User Manual for NRSW version 4.4 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.
NB3710 User Manual for NRSW version 4.4 Type Description SSH Authorization The keys used for SSH authorization. OpenVPN Server or client keys and certificates for running OpenVPN tunnels. IPsec Server or client keys and certificates for running IPsec tunnels. WLAN Keys and certificates for implementing certificate-based WLAN au-...
Page 186
NB3710 User Manual for NRSW version 4.4 Parameter Certificate Configuration Country (C) The certificate owner’s country (usually a TLD abbreviation) Common Name (CN) The certificate owner’s common name, mainly used to identify a host E-Mail The certificate owner’s email address Expiry period The number of days a certificate will be valid from now on...
Page 187
NB3710 User Manual for NRSW version 4.4 When enrolling certificates, the CA certificate will be initially fetched from the specified SCEP URL using the getca operation. It will be shown on the configuration page and it has to be verified that it belongs to the correct authority.
User Manual for NRSW version 4.4 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 file based on your serial number which can be installed to...
5.8.10. Legal Notice OSS Notice We inform you that NetModule products may contain in part open-source software. We are distributing 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.
NB3710 User Manual for NRSW version 4.4 6. Command Line Interface The Command Line Interface (CLI) offers a generic control interface to the router and can be used to get/set configuration parameters, apply updates, restart services or perform other system tasks.
NB3710 User Manual for NRSW version 4.4 Key Sequence Action CTRL-t Drag the character before point forward moving point forward as well; if point is at the end of the line, then this transposes the two characters before the point...
NB3710 User Manual for NRSW version 4.4 Options : generate sourceable output validate config parameter get factory default rather than current value show configuration sections 6.4. Setting Config Parameters The set command can be used to set configuration values. > set Usage : set [ hv ] <parameter >=<value >...
NB3710 User Manual for NRSW version 4.4 LAN interface status WAN interface status openvpn OpenVPN connection status ipsec IPsec connection status pptp PPTP connection status GRE connection status dialin Dial In connection status mobileip MobileIP status Digital IO status audio...
NB3710 User Manual for NRSW version 4.4 firewall Firewall and NAPT gpsd GPS daemon 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...
NB3710 User Manual for NRSW version 4.4 6.13. Resetting System The reset command can be used to reset the router back to factory defaults. > reset Usage : reset [ h ] 6.14. Rebooting System The reboot command can be used to reboot the router.
Page 198
NB3710 User Manual for NRSW version 4.4 Attention The examples only show the usage of this interface for demonstration purpose. For productive environments it is recommended to use POST and HTTPS instead of GET and HTTP. Please be aware that your browser history will store GET requests including passwords and other sensitive information if you use GET requests to test this interface.
Page 199
NB3710 User Manual for NRSW version 4.4 Key usage : command=status [& arg0=<section > ] Notes : 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 .
Page 200
NB3710 User Manual for NRSW version 4.4 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&command= restart&arg0= h...
Page 201
NB3710 User Manual for NRSW version 4.4 send - Send SMS Key usage : command=send&arg0=sms&arg1=<number>&arg2=<text > Notes : The phone number has to be specified in international format such as +123456789 including a leading plus sign ( which can be encoded with %2B ) . The SMS daemon must be properly configured prior to using that function .
Page 202
NB3710 User Manual for NRSW version 4.4 send - Send USSD code Key usage : command=send&arg0=ussd&arg1=<card>&arg2=<code > Notes : The argument card specifies the card module index ( e . g . 0 for wwan0 ) . The USSD code can consist of digits , plus signs , asterisks ( can be encoded with \%2A ) and dashes ( can be encoded with \%23) .
NB3710 User Manual for NRSW version 4.4 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 (in- cluding bridges) WLANx Refers to a Wireless LAN interface which will be represented as addi- tional LAN interface when configured as access point...
NB3710 User Manual for NRSW version 4.4 Parameter Description Subscriber Identity Module Short Message Service SSID Service Set Identifiers, can be used to define multiple WLAN networks on a module Spanning Tree Protocol USSD Unstructured Supplementary Service Data VRRP Virtual Router Redundancy Protocol...
Page 205
NB3710 User Manual for NRSW version 4.4 Event Description dio-in1-off DIO IN1 turned off dio-in2-on DIO IN2 turned on dio-in2-off DIO IN2 turned off dio-out1-on DIO OUT1 turned on dio-out1-off DIO OUT1 turned off dio-out2-on DIO OUT2 turned on dio-out2-off...
NB3710 User Manual for NRSW version 4.4 Event Description system-error System is in error state system-no-error System left error state 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...
NB3710 User Manual for NRSW version 4.4 A.3. Factory Configuration The factory configuration including default values for any configuration parameter can be derived from the file /etc/config/factory-config.cfg on the router. You may also call cli get -f <parameter> for obtaining a specific default value.
NB3710 User Manual for NRSW version 4.4 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 config-summary.are This script shows a summary of the currently running configuration.
Page 210
NB3710 User Manual for NRSW version 4.4 Event Description remote-mail.are This script reads and sends mails from a 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 This script can be used to switch the WLAN client network according to availability send-mail.are...
Page 211
NB3710 User Manual for NRSW version 4.4 Event Description transfer-file.are This scripts archives a remote file transfer.are This scripts stores the latest GNSS positions in a remote FTP file udp-msg-server.are This script will run an UDP server which is able to receive messages and forward them as SMS/E-Mail.
Need help?
Do you have a question about the NB3710 and is the answer not in the manual?
Questions and answers