NetModule NB3710 User Manual
Hide thumbs Also See for NB3710:
Table of Contents

Advertisement

Quick Links

NetModule Router NB3710
User Manual for Software Version 4.4
Manual Version 1.13
NetModule AG, Switzerland
September 30, 2022

Advertisement

Table of Contents
loading
Need help?

Need help?

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

Questions and answers

Summary of Contents for NetModule NB3710

  • 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.
  • Page 3: Table Of Contents

    Contents Welcome to NetModule ........
  • Page 4 NB3710 User Manual for NRSW version 4.4 5.3.10.GNSS ......... . .
  • Page 5 NB3710 User Manual for NRSW version 4.4 5.9. LOGOUT ..........186 Command Line Interface .
  • Page 6 NB3710 User Manual for NRSW version 4.4 List of Figures 5.1. Initial Login ......... .
  • Page 7 NB3710 User Manual for NRSW version 4.4 5.47. Web Server ......... . 152 5.48.
  • Page 8 ........3.3. NB3710 Status Indicators ........
  • Page 9 NB3710 User Manual for NRSW version 4.4 A.3. SDK Examples ........207...
  • Page 10: Welcome To Netmodule

    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.
  • Page 11: Conformity

    – 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.
  • Page 13: Declaration Of Conformity

    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...
  • Page 14: Open Source Software

    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...
  • Page 15: Specifications

    NB3710 User Manual for NRSW version 4.4 3. Specifications 3.1. Appearance...
  • Page 16: Features

    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...
  • Page 18: Environmental Conditions

    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...
  • Page 19: Interfaces

    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.
  • Page 20: Led Indicators

    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.
  • Page 21: Reset

    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...
  • Page 22: Mobile

    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...
  • Page 23: Ieee 802.11 Standards

    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...
  • Page 24: Gnss

    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.
  • Page 25: M12 Ethernet Connectors

    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:...
  • Page 26: Power Supply

    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...
  • Page 27: Power Input Specifications Variant Pb

    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...
  • Page 28: Digital Inputs And Outputs

    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...
  • Page 29: Pin Assignments Of Digital Inputs And Outputs

    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...
  • Page 30: Extension Connector

    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: –...
  • Page 31: Audio Port Specification

    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.
  • Page 32: Can Port Specification

    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...
  • Page 33: Ibis Port Specification

    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...
  • Page 34: Non-Isolated Rs-232 Port Specification

    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,...
  • Page 35: Isolated Rs-232 Port Specification

    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...
  • Page 36: Port Specification

    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,...
  • Page 37: Installation

    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.
  • Page 38: Lte/Umts Antenna Port Types

    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...
  • Page 39: Installation Of The Wlan Antennas

    – 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.
  • Page 40: Installation Of The Local Area Network

    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...
  • Page 41: Installation Of The Audio Interface

    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...
  • Page 42: Configuration

    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.
  • Page 43: Automatic Mobile Data Connection

    NetModule Router Simulator Hostname netbox Software Version 4.4.0.103 © 2004-2020, NetModule AG 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 configure additional users which will only be granted to access the summary page or retrieve status information but not to set any configuration parameters.
  • Page 44: Recovery

    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 45: Home

    Firewall System NetModule Router Simulator Hostname NB1600 Software Version 4.4.0.103 © 2004-2020, NetModule AG Figure 5.2.: Home Summary This page offers a short summary about the administrative and operational status of the router’s inter- faces. This page offers 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 downloaded/uploaded...
  • 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 48: Interfaces

    Port Setup VLAN Management LAN2 permanent IP Settings WWAN1 permanent Mobile Modems Apply SIMs Interfaces WLAN Administration Configuration IP Settings Bridges Serial Digital I/O GNSS NetModule Router Simulator Hostname NB1600 Software Version 4.4.0.103 © 2004-2020, NetModule AG Figure 5.3.: WAN Links...
  • 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 51: Wan Settings

    Bridges Serial Digital I/O GNSS NetModule Router Simulator Hostname NB1600 Software Version 4.4.0.103 © 2004-2020, NetModule AG Figure 5.4.: WAN Settings Parameter TCP MSS Settings MSS adjustment Enable or disable MSS adjustment on WAN interfaces. Maximum segment size Maximum number of bytes in a TCP data segment.
  • Page 52: Link Supervision

    Bridges Serial Digital I/O GNSS NetModule Router Simulator Hostname NB1600 Software Version 4.4.0.103 © 2004-2020, NetModule AG Figure 5.5.: Link Supervision Parameter Supervision Settings Link The WAN link to be monitored (can be ANY) Mode Specifies whether the link shall only be monitored if being up (e.g.
  • 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.
  • Page 54: Ethernet

    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.
  • Page 55: 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 Identifier (VLAN ID) which is used for distributing the packets to the associated...
  • Page 56: Vlan Management

    NetModule Router Simulator Hostname NB1600 Software Version 4.4.0.103 © 2004-2020, NetModule AG Figure 5.8.: VLAN Management In order to form a distinctive subnet, the network interface of a remote LAN host must be configured with the same VLAN ID as defined on the router. Further, 802.1P introduces a priority field which influences packet scheduling in the TCP/IP stack.
  • Page 57: Lan Ip Configuration

    Serial Digital I/O GNSS NetModule Router Simulator Hostname NB1600 Software Version 4.4.0.103 © 2004-2020, NetModule AG Figure 5.9.: LAN IP Configuration Parameter LAN IP Settings Mode Defines whether this interface is being used as LAN or WAN interface When running in LAN mode, the interface may be configured with the following settings:...
  • 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 59: Mobile

    NetModule Router Simulator Hostname NB1600 Software Version 4.4.0.103 © 2004-2020, NetModule AG 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...
  • 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 62: Wwan Interfaces

    Serial Digital I/O GNSS NetModule Router Simulator Hostname NB1600 Software Version 4.4.0.103 © 2004-2020, NetModule AG Figure 5.11.: WWAN Interfaces The following mobile settings are required: Parameter WWAN Mobile Parameters Modem The modem to be used for this WWAN interface...
  • 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 64: Wlan

    NetModule Router Simulator Hostname NB1600 Software Version 4.4.0.103 © 2004-2020, NetModule AG Figure 5.12.: WLAN Management If the administrative status is set to disabled, the module will be powered off in order to reduce the overall power consumption. Regarding antennas, we generally recommend using two antennas for better coverage and throughput.
  • 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.
  • Page 66: Ieee 802.11 Network Standards

    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 69: Wlan Configuration

    WPA + WPA2 / TKIP + CCMP Ethernet Port Setup VLAN Management IP Settings Mobile Modems SIMs Interfaces WLAN Administration Configuration IP Settings Bridges Serial Digital I/O GNSS NetModule Router Simulator Hostname NB1600 Software Version 4.4.0.103 © 2004-2020, NetModule AG Figure 5.13.: WLAN Configuration...
  • 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 73: Wlan Ip Configuration

    NetModule Router Simulator Hostname NB1600 Software Version 4.4.0.103 © 2004-2020, NetModule AG Figure 5.14.: WLAN IP Configuration The access point networks can be bridged to any LAN interface for letting WLAN clients and Ethernet hosts operate in the same subnet. However, for multiple SSIDs we strongly recommend to set up separated interfaces in routing-mode in order to avoid unwanted access and traffic between the inter-...
  • 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...
  • Page 75: Software Bridges

    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.
  • Page 76: Usb

    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 77: Usb Device Management

    Bridges Serial Digital I/O GNSS NetModule Router Simulator Hostname NB1600 Software Version 4.4.0.103 © 2004-2020, NetModule AG Figure 5.16.: USB Device Management Parameter USB Devices Vendor ID The USB Vendor ID of the device Product ID The USB Product ID of the device...
  • 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.
  • Page 79: Serial Port

    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 80: Serial Port Administration

    Modems Apply Back SIMs Interfaces WLAN Administration Configuration IP Settings Bridges Serial Digital I/O GNSS NetModule Router Simulator Hostname NB1600 Software Version 4.4.0.103 © 2004-2020, NetModule AG Figure 5.17.: Serial Port Administration An RS485 serial port is optional on NB3710.
  • Page 81: Serial Port Settings

    Allow clients from: specify Apply NetModule Router Simulator Hostname NB1600 Software Version 4.4.0.103 © 2004-2020, NetModule AG Figure 5.18.: Serial Port Settings Parameter Serial Settings Physical protocol Selects the desired physical protocol on the serial port Baud rate Specifies the baud rate run on the serial port Data bits Specifies the number of data bits contained in each frame...
  • 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...
  • Page 84: Digital I/O

    Serial Digital I/O GNSS NetModule Router Simulator Hostname NB1600 Software Version 4.4.0.103 © 2004-2020, NetModule AG Figure 5.19.: Digital I/O Ports You can apply the following settings: Parameter Digital I/O Settings DO1 after reboot Initial status of DO1 after system has booted...
  • Page 85: Audio

    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...
  • Page 86: Gnss

    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...
  • Page 89: Routing

    NetModule Router Simulator Hostname NB1600 Software Version 4.4.0.103 © 2004-2020, NetModule AG Figure 5.20.: Static Routing In general, host routes precede network routes and network routes precede default routes. Addition- ally, a metric can be used to determine the priority of a route, a packet will go in the direction with the lowest metric in case a destination matches multiple routes.
  • Page 90: Static Route Flags

    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.
  • Page 91: Extended Routing

    NetModule Router Simulator Hostname NB1600 Software Version 4.4.0.103 © 2004-2020, NetModule AG 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 92: Multipath Routes

    Classification NetModule Router Simulator Hostname NB1600 Software Version 4.4.0.103 © 2004-2020, NetModule AG Figure 5.22.: Multipath Routes At least two interfaces have to be defined to establish multipath routing. Additional interfaces can be added by pressing the plus sign. Parameter...
  • Page 93: Mobile Ip

    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 95: Mobile Ip

    (optional) Apply NetModule Router Simulator Hostname NB1600 Software Version 4.4.0.103 © 2004-2020, NetModule AG Figure 5.23.: Mobile IP Parameter Mobile IP Node Configuration The Security Parameter Index (SPI) identifying the security context for the tunnel between the mobile node and the home agent. This is used to distinguish mobile nodes from each other.
  • 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.
  • Page 97: Quality Of Service

    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)
  • Page 99: Multicast

    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...
  • Page 100: Ospf

    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...
  • Page 101: Bgp

    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...
  • Page 102: Firewall

    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 103: Rules

    Inbound Rules Outbound Rules Apply Clear NetModule Router Simulator Hostname NB1600 Software Version 4.4.0.103 © 2004-2020, NetModule AG Figure 5.25.: Firewall Rules Parameter Firewall Rule Configuration Description A meaningful description about the purpose of this rule Action Specifies whether the packets of this rule should be allowed or denied...
  • 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 105: Napt

    NetModule Router Simulator Hostname NB1600 Software Version 4.4.0.103 © 2004-2020, NetModule AG Figure 5.26.: Masquerading The administration page lets you specify the interfaces on which masquerading will be performed. NAT will hereby use the address of the selected interface and choose a random source port for outgoing connections and thus enables communication between hosts from a private local area network towards hosts on the public network.
  • Page 106: Inbound Napt

    NetModule Router Simulator Hostname NB1600 Software Version 4.4.0.103 © 2004-2020, NetModule AG Figure 5.27.: Inbound NAPT Please note that the specified rules are processed by order, that means, traversing the list from top to bottom until a matching rule is found. If there is no matching rule found, the packet will pass as is.
  • 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...
  • Page 108: Vpn

    Restart on link change: Tunnel Configuration Multipath TCP support: PPTP Administration Tunnel Configuration Apply Restart Client Management Administration Tunnel Configuration L2TP Administration Tunnel Configuration NetModule Router Simulator Hostname NB1600 Software Version 4.4.0.103 © 2004-2020, NetModule AG Figure 5.28.: OpenVPN Administration...
  • Page 109: Openvpn Configuration

    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...
  • Page 113: Openvpn Client Management

    NetModule Router Simulator Hostname NB1600 Software Version 4.4.0.103 © 2004-2020, NetModule AG Figure 5.30.: OpenVPN Client Management In the Networking section you can specify a fixed tunnel endpoint address for each client. Please note that, if you intend to use a fixed address for a particular client, you would have to apply fixed addresses to the other ones as well.
  • Page 114: Ipsec

    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 115: Ipsec Administration

    Tunnel Configuration NetModule Router Simulator Hostname NB1600 Software Version 4.4.0.103 © 2004-2020, NetModule AG 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 modifies the IP address/port of packets.
  • Page 116: Ipsec Configuration

    L2TP Administration Tunnel Configuration NetModule Router Simulator Hostname NB1600 Software Version 4.4.0.103 © 2004-2020, NetModule AG Figure 5.32.: IPsec Configuration General For setting up the tunnel you will have to configure the following parameters first: Parameter IPsec General Settings Remote peer IP address or host name of the remote IPsec peer.
  • 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...
  • Page 120: Pptp

    NetModule Router Simulator Hostname NB1600 Software Version 4.4.0.103 © 2004-2020, NetModule AG Figure 5.33.: PPTP Administration When setting up a PPTP tunnel, you would need to choose between server or client. A client tunnel requires the following parameters to be set:...
  • Page 121: Pptp Tunnel Configuration

    Administration Tunnel Configuration Apply NetModule Router Simulator Hostname NB1600 Software Version 4.4.0.103 © 2004-2020, NetModule AG Figure 5.34.: PPTP Tunnel Configuration Setting up a server requires the following settings: Parameter PPTP Server Settings Listen address Specifies on which IP address should be listened for incoming client...
  • Page 122: Pptp Client Management

    Username Address Tunnel Configuration Client Management IPsec Administration Tunnel Configuration PPTP Administration Tunnel Configuration Client Management Administration Tunnel Configuration L2TP Administration Tunnel Configuration NetModule Router Simulator Hostname NB1600 Software Version 4.4.0.103 © 2004-2020, NetModule AG Figure 5.35.: PPTP Client Management...
  • Page 123: Gre

    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.
  • Page 124: L2Tp

    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.
  • Page 125: Dial-In

    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.
  • Page 127: Services

    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 131: Sdk Administration

    Redundancy Voice Gateway NetModule Router Simulator Hostname NB1600 Software Version 4.4.0.103 © 2004-2020, NetModule AG 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 Specifies whether SDK scripts should run or not...
  • Page 132: Sdk Jobs

    NetModule Router Simulator Hostname NB1600 Software Version 4.4.0.103 © 2004-2020, NetModule AG 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 first which is made up by the following parameters:...
  • 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.
  • Page 135: Sms Control Commands

    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 136: Dhcp Server

    Discovery Redundancy Voice Gateway NetModule Router Simulator Hostname NB1600 Software Version 4.4.0.103 © 2004-2020, NetModule AG Figure 5.39.: DHCP Server The following settings for each interface can be applied then: Parameter DHCP Server Settings Operation mode Specifies whether the DHCP server is enabled or not First lease address The first address out of the range of IP addresses given to hosts...
  • 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 138: Dns Server

    Apply Discovery Redundancy Voice Gateway NetModule Router Simulator Hostname NB1600 Software Version 4.4.0.103 © 2004-2020, NetModule AG Figure 5.40.: DNS Server The following settings can be applied: Parameter DNS Server Settings Administrative status Enables or disables the DNS server Domain name...
  • 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...
  • Page 141: Ntp Server

    Discovery Redundancy Voice Gateway NetModule Router Simulator Hostname NB1600 Software Version 4.4.0.103 © 2004-2020, NetModule AG Figure 5.41.: NTP Server The following settings for each interface can be applied then: Parameter NTP Server Settings Administrative status Specifies whether the NTP server is enabled or not Poll interval Defines the polling interval (64..2048 seconds) for synchronizing the...
  • Page 142: Dynamic Dns

    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...
  • Page 144: E-Mail

    Discovery Redundancy Voice Gateway NetModule Router Simulator Hostname NB1600 Software Version 4.4.0.103 © 2004-2020, NetModule AG Figure 5.43.: E-Mail Settings It can be enabled by applying the following settings. Parameter E-Mail Client Settings E-mail client status Administrative status of the E-Mail client...
  • Page 145 NB3710 User Manual for NRSW version 4.4 Parameter E-Mail Client Settings Password Password used for authentication...
  • Page 146: Events

    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...
  • Page 147: 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 configure a SMS-capable default modem as described in chapter 5.3.3.
  • Page 148: Sms Number Expressions

    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 149: Ssh/Telnet Server

    NetModule Router Simulator Hostname NB1600 Software Version 4.4.0.103 © 2004-2020, NetModule AG Figure 5.45.: SSH and Telnet Server Please note that these services will be accessible from the WAN interface also. In doubt, please consider to disable or restrict access to them by applying applicable firewall rules.
  • 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)
  • Page 151: Snmp Agent

    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 152: Snmp Agent

    Discovery Redundancy Voice Gateway NetModule Router Simulator Hostname NB1600 Software Version 4.4.0.103 © 2004-2020, NetModule AG Figure 5.46.: SNMP Agent The following parameters can be used to configure the SNMP agent: Parameter SNMP Configuration Administrative status Enable or disable the SNMP agent Operation mode Specifies if agent should run in compatibilty mode or for SNMPv3 only...
  • 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.
  • Page 156: Web Server

    Discovery Redundancy Apply Voice Gateway NetModule Router Simulator Hostname NB1600 Software Version 4.4.0.103 © 2004-2020, NetModule AG Figure 5.47.: Web Server Parameter Web Server Settings Administrative Status Enable or disable the Web server HTTP port Web server port for HTTP connections...
  • Page 157: Softflow

    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...
  • Page 158: Discovery

    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...
  • Page 159: Redundancy

    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 161: Voice Gateway

    Web Server MQTT Broker Apply Softflow Discovery Redundancy Voice Gateway NB2800 NetModule Router Simulator Hostname NB1800 Software Version 4.4.0.104 © 2004-2020, NetModule AG Figure 5.49.: Voice Gateway Administration The following parameters can be used to set it up: Parameter Voice Gateway Administration Settings Administrative status Specifies whether the gateway shall be enabled or disabled...
  • 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 167: System

    Tech Support Keys & Certificates Licensing Legal Notice NetModule Router Simulator Hostname NB1600 Software Version 4.4.0.103 © 2004-2020, NetModule AG Figure 5.50.: 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 influences the system behaviour...
  • 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.
  • Page 169: Regional Settings

    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 171: Authentication

    NetModule Router Simulator Hostname NB1600 Software Version 4.4.0.103 © 2004-2020, NetModule AG Figure 5.52.: User Accounts The admin user is a built-in power user which represents the default administrator of the system. Please note that the admin password will be also applied to the root user which is able to enter a system shell.
  • 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...
  • Page 173: Remote Authentication

    Licensing Legal Notice Apply NetModule Router Simulator Hostname NB1600 Software Version 4.4.0.103 © 2004-2020, NetModule AG Figure 5.53.: Remote Authentication It can be configured as follows: Parameter Remote authentication settings Administrative status Defines whether a remote server should be used for authentication...
  • Page 174: Software Update

    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,...
  • Page 175: Module Firmware Update

    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.
  • Page 176: Software Profiles

    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.
  • Page 177: Configuration

    NetModule Router Simulator Hostname NB1600 Software Version 4.4.0.103 © 2004-2020, NetModule AG Figure 5.54.: Manual File Configuration This section can be used to download the currently running system configuration (including essential files such as certificates). In order to restore a particular configuration you can upload a configura- tion previously downloaded.
  • Page 178: Automatic File Configuration

    Licensing Legal Notice NetModule Router Simulator Hostname NB1600 Software Version 4.4.0.103 © 2004-2020, NetModule AG Figure 5.55.: Automatic File Configuration This menu can be used to run an automatic configuration update of the system. It is configured as follows: Parameter Automatic File Configuration...
  • Page 179: Factory Configuration

    NetModule Router Simulator Hostname NB1600 Software Version 4.4.0.103 © 2004-2020, NetModule AG Figure 5.56.: Factory Configuration This menu can be used to reset the device to factory defaults. Your current configuration will be lost. This procedure can also be initiated by pressing and holding the Reset button for at least five seconds.
  • Page 180: Troubleshooting

    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.
  • Page 181: Log Viewer

    Jan 9 02:03:01 NB1600 user.notice link-manager[27880]: wanlink1: permanent link is suspended for 10s (set suspended [auto]) Jan 9 02:03:01 NB1600 user.notice link-manager[27880]: wanlink0: permanent link is unsuspended now (reset suspended [auto]) NetModule Router Simulator Hostname NB1600 Software Version 4.4.0.103 © 2004-2020, NetModule AG Figure 5.57.: Log Viewer...
  • Page 182: Tech Support File

    NetModule Router Simulator Hostname NB1600 Software Version 4.4.0.103 © 2004-2020, NetModule AG Figure 5.58.: Tech Support File It is possible to trace any IP interface and inspect individual packet flows between hosts. This can be achieved by logging onto the box and start a network packet capture by using the tool tcdump. We recommend to use the -n switch to bypass name resolution (e.g.
  • Page 183: Keys And Certificates

    Keys & Certificates Licensing Legal Notice NetModule Router Simulator Hostname NB1600 Software Version 4.4.0.103 © 2004-2020, NetModule AG Figure 5.59.: Keys and certificates The entry pages shows an overview about installed keys and certificates. The following sections may appear: Type Description Root CA The root Certificate Authority (CA) which issues certificates, its key...
  • Page 184: Certificate Sections

    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 185: Certificate Configuration

    Apply NetModule Router Simulator Hostname NB1600 Software Version 4.4.0.103 © 2004-2020, NetModule AG Figure 5.60.: Certificate Configuration This page provides some general configuration options which will be applied when operating on keys and certificates. If keys, certificates and signing requests are generated locally, the following settings will be take into...
  • 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.
  • Page 188: Licensing

    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...
  • Page 189: Legal Notice

    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.
  • Page 190: Logout

    NB3710 User Manual for NRSW version 4.4 5.9. LOGOUT Please use this menu to log out from the Web Manager.
  • Page 191: Command Line Interface

    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.
  • Page 192: Print Help

    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...
  • Page 193: Setting Config Parameters

    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 >...
  • Page 194: Scanning Networks

    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...
  • Page 195: Manage Keys And Certificates

    NB3710 User Manual for NRSW version 4.4 > update Usage : update [ hfrsn ] <software | config | license | sshkeys > <URL> Options : reboot after update force update don ' t reset missing config values with factory defaults...
  • Page 196: Debug System

    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...
  • Page 197: Resetting System

    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) .
  • Page 203: Appendix

    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...
  • Page 204: System Events

    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...
  • Page 206: System Events

    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...
  • Page 207: Factory Configuration

    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.
  • Page 208: Snmp Vendor Mib

    NB3710 User Manual for NRSW version 4.4 A.4. SNMP VENDOR MIB...
  • Page 209: Sdk Examples

    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.

This manual is also suitable for:

Nb2700

Table of Contents