NetComm Wireless NWL10 User Manual

Vodafone MachineLink 3G
USER GUIDE
2
www.netcommwireless.com
Copyright
Copyright© 2012 NetComm Wireless Limited. All rights reserved.
The information contained herein is proprietary to NetComm Wireless. No part of this document may be translated, transcribed, reproduced, in any form, or by any means without prior written consent of NetComm Wireless.
Please note: This document is subject to change without notice.
Save our environment
When this equipment has reached the end of its useful life, it must be taken to a recycling centre and processed separately from domestic waste.
The cardboard box, the plastic contained in the packaging, and the parts that make up this device can be recycled in accordance with regionally established regulations. Never dispose of this electronic equipment along with your household waste. You may be subject to penalties or sanctions under the law. Instead, ask for disposal instructions from your municipal government.
Please be responsible and protect our environment.
This manual covers the following products:
Vodafone MachineLink 3G M2M IP Router
DOCUMENT VERSION DATE
1.0- Initial document release XX/12/2012
Table 1 - Document Revision History
Vodafone MachineLink 3G
www.netcommwireless.com
3
Table of contents
Overview ........................................................................................................................................................................................ 4
Product introduction ...................................................................................................................................................................... 5
Product overview ........................................................................................................................................................................................... 5
Package contents .......................................................................................................................................................................................... 5
Product features ............................................................................................................................................................................................ 6
Physical dimensions and indicators ............................................................................................................................................. 7
Physical dimensions ...................................................................................................................................................................................... 7
LED indicators ............................................................................................................................................................................................... 8
Interfaces .................................................................................................................................................................................................... 10
Placement of the MachineLink 3G router ................................................................................................................................... 11
Mounting options ......................................................................................................................................................................................... 11
Installation and configuration of the Vodafone MachineLink 3G ............................................................................................... 16
Powering the router ..................................................................................................................................................................................... 16
Power consumption ..................................................................................................................................................................................... 17
Installing the router ...................................................................................................................................................................................... 17
Advanced configuration .............................................................................................................................................................. 18
Status ........................................................................................................................................................................................... 19
Networking ................................................................................................................................................................................... 21
Data connection .......................................................................................................................................................................................... 21
Connect on demand .................................................................................................................................................................................... 28
Cellular band settings .................................................................................................................................................................................. 31
SIM security settings .................................................................................................................................................................................... 33
LAN ............................................................................................................................................................................................................ 37
Routing ....................................................................................................................................................................................................... 41
VPN ............................................................................................................................................................................................................ 49
Services........................................................................................................................................................................................ 62
Dynamic DNS .............................................................................................................................................................................................. 62
Network time (NTP)...................................................................................................................................................................................... 63
Ping watchdog ............................................................................................................................................................................................ 64
SNMP ......................................................................................................................................................................................................... 66
TR-069........................................................................................................................................................................................................ 68
SMS Diagnostics and Commands ................................................................................................................................................................ 70
Diagnostics ................................................................................................................................................................................................. 74
Sending an SMS diagnostic command ......................................................................................................................................................... 77
System ......................................................................................................................................................................................... 84
Log ............................................................................................................................................................................................................. 84
System configuration ................................................................................................................................................................................... 87
Appendix A: Tables...................................................................................................................................................................... 95
Appendix B: Device Mounting Dimensions ................................................................................................................................ 96
Appendix C: Mounting Bracket ................................................................................................................................................... 97
Appendix D: Default Settings ...................................................................................................................................................... 98
Restoring factory default settings ................................................................................................................................................................. 99
Recovery mode ......................................................................................................................................................................................... 100
Appendix E: HTTP Secure ......................................................................................................................................................... 101
What is HTTP Secure? ............................................................................................................................................................................... 101
Generating your own self-signed certificate ................................................................................................................................................. 101
Uploading a self-signed certificate .............................................................................................................................................................. 103
Appendix F: RJ-45 connector ................................................................................................................................................... 105
Safety and product care ............................................................................................................................................................ 106
Vodafone MachineLink 3G
4
www.netcommwireless.com
Overview
Introduction
This document provides you all the information you need to set up, configure and use the Vodafone MachineLink 3G Router.
Target audience
This document is intended for system integrators or experienced hardware installers who understand telecommunications terminology and concepts.
Prerequisites
Before continuing with the installation of your Vodafone MachineLink 3G, please confirm that have the following:
A device with a working Ethernet network adapter.
A web browser such as Internet Explorer, Mozilla Firefox or Google Chrome.
A working SIM card if your router was not shipped with one pre-inserted.
A flathead screwdriver (No. 3) if field terminated power is required.
Notation
The following symbols are used in this user guide:
The following note requires attention
The following note provides a warning
The following note provides useful information
Vodafone MachineLink 3G
www.netcommwireless.com
5
Product introduction
Product overview
HSPA+ up to 14.4Mbps downstream
Penta-band 3G with quad-band 2G auto-fallback
Internal diversity antennae with option for external main antenna (auto-sensing)
Ethernet port with full passive Power over Ethernet (PoE) support (802.3af)
Intelligent tri-colour LED display for clear, easy-to-read modem status information
Integration with Vodafone GDSP back end
Roaming algorithm with prioritisation for cost effective, flawless network connection across the globe
Extensive device management with support for TR-069, web configuration and full feature management with SMS
Optimised web configuration
Flexible mounting suitable for in-home use or industrial applications with built-in wall mount, DIN and C-Rail mounting options
Package contents
The Vodafone MachineLink 3G package consists of:
1x Vodafone MachineLink 3G router
1x 1.5m yellow Ethernet cable 8P8C
1x DIN rail mounting bracket
1x quick start guide and safety manual
If any of these items are missing or damaged, please contact NetComm Wireless Support immediately by visiting the NetComm Wireless Support website at:
http://support.netcommwireless.com
Vodafone MachineLink 3G
6
www.netcommwireless.com
Product features
The Vodafone MachineLink 3G is a feature-packed wireless M2M device designed by Vodafone to address the rapid growth in M2M deployments. The first M2M device of its kind, it is designed to deliver state of the art features, versatility and ease of use at an affordable price. Compatible with Vodafone networks worldwide, MachineLink is managed by Vodafone's global M2M platform enabling remote management and support wherever you are. The open management system also allows you to customise your own software applications for scalability, large scale compatibility and an easy path to large deployments across a broad range of industries.
The Vodafone MachineLink 3G meets the global demand for a reliable and cost-effective M2M device that successfully caters to mass deployment across businesses.
Vodafone MachineLink 3G
www.netcommwireless.com
7
Physical dimensions and indicators
Physical dimensions
Below is a list of the physical dimensions of the Vodafone MachineLink 3G, as well as the physical dimensions of the antennas.
Figure 1 – Vodafone MachineLink 3G Dimensions
VODAFONE MACHINELINK 3G
(WITHOUT ANTENNAS ATTACHED)
Length 140 mm
Depth 103 mm
Height 30 mm
Weight 180g
Table 2 - Device Dimensions
Vodafone MachineLink 3G
8
www.netcommwireless.com
LED indicators
The Vodafone MachineLink 3G uses 5 LEDs to display the current system and connection status.
Figure 2 - Vodafone MachineLink 3G LED Indicators
LED ICON NAME COLOUR STATE DESCRIPTION
Off Power off
Slow Flashing Powering up
Power
On Power on
On Power on in recovery mode
Slow Flashing Hardware error
On Connected via WWAN
Traffic via WWAN
Network
Signal strength
Blinking1
Slow flashing Connecting PDP
On Registered network
Slow flashing Registering network
Slow flashing SIM PIN locked
Fast flashing SIM PUK locked
On Can’t connect
On 3G
On 2G GPRS
On GSM only (no GPRS)
Table 3 - LED Indicators
1
The term “blinking” means that the LED may pulse, with the intervals that the LED is on and off not being equal. The term “flashing” means that the
LED turns on and off at equal intervals.
Vodafone MachineLink 3G
www.netcommwireless.com
9
Signal strength LEDs
The following table lists the signal strength range corresponding with the number of lit signal strength LEDs.
NUMBER OF LIT LEDS SIGNAL STRENGTH
All LEDs unlit < -109 dBm
1 -109 dBm to -101dBm
2 -101 dBm to -91 dBm
3 -91 dBm to -85 dBm
4 -85 dBm to -77 dBm
5 > -77 dBm
Table 4 - Signal strength LED descriptions
LED update interval
The signal strength LEDs update within a few seconds with a rolling average signal strength reading. When selecting a location for the router or connected or positioning an external antenna, please allow up to 20 seconds for the signal strength LEDs to update before repositioning.
Vodafone MachineLink 3G
10
www.netcommwireless.com
Interfaces
The following interfaces are available on the Vodafone MachineLink 3G:
Figure 3 - Interfaces
ITEM DESCRIPTION
External main antenna socket
Power LED Indicates the power status of the device and whether the device is in recovery mode.
Network LED Indicates the network and SIM status.
Signal strength LEDs Indicates the signal strength and network type.
RJ45 PoE Ethernet port
Reset button
Two-way captive power
SIM tray eject Insert a pencil or paper clip here to eject the SIM card tray.
SIM card slot Insert SIM card here.
SMA female connector for an optional external antenna (not supplied). The main internal antenna is disabled when an external antenna is connected but the auxiliary antenna remains active to provide (where possible) diversity assistance.
Connect one or several devices via a network switch here. This port can also optionally receive Power over Ethernet (802.3af PoE) in which case the DC power supply can serve as backup power source if required.
Press and hold for less than 5 seconds to reboot to normal mode. Press and hold for 5 to 15 seconds to reboot to recovery mode. Press and hold for 15 to 20 seconds to reset the router to factory default settings.
Connect power source here. Power wires may be terminated on optional terminal block and connected to DC input jack. Operates in the 8-35V DC range.
Table 5 - Interfaces
Vodafone MachineLink 3G
www.netcommwireless.com
11
Placement of the MachineLink 3G router
When selecting a location to mount the MachineLink 3G router, keep in mind that it houses two high performance internal antennas designed to provide optimum signal strength in a wide range of environments. If you find the signal strength is weak, try moving the router to a different place or mounting it differently. If signal strength doesn’t improve, you may need to attach an external antenna (not included) to the router’s female SMA connector.
Note: If you connect an external antenna to the female SMA connector, the main internal antenna disables automatically but the auxiliary internal antenna remains connected to provide (where possible) diversity assistance.
Note: When selecting a location for the router, allow at least 20 seconds for the signal strength LEDs to update before trying a different location or connecting an external antenna.
Mounting options
The Vodafone MachineLink 3G router can be quickly and easily mounted in a variety of locations.
Mounted flat against the wall
When mounted flat against the wall, the MachineLink 3G router has a slimline form factor. Use appropriately sized screws in the mounting holes provided on the base of the unit.
Figure 4 - Wall mount - Flat against the wall
Perpendicular to the wall
If a large surface area is not available, there is the option of mounting the router perpendicular to the wall. This gives the router a small wall footprint while remaining securely attached. Use appropriately sized screws in the mounting holes provided on the back of the unit.
Vodafone MachineLink 3G
12
www.netcommwireless.com
Figure 5 - Wall mount - Perpendicular to the wall
C Section DIN Rail mount
The MachineLink 3G router easily slides onto a C Section DIN rail so that it is horizontally mounted. The DIN Rail mounting bracket is not required for C Section DIN rail mounting.
Figure 6 - C Section DIN rail mount
To mount the unit on a C-Section DIN rail, slide it on as illustrated below:
Figure 7 - Mounting the unit on a DIN rail
Vodafone MachineLink 3G
www.netcommwireless.com
13
Mounting bracket
The provided mounting bracket provides additional methods of mounting the MachineLink 3G Router. To attach the mounting bracket, slide it onto the rear of the router as shown in the diagram below:
To remove the bracket, press the
Figure 8 - Sliding on the mounting bracket
PUSH button and slide the router off the bracket:
Figure 9 - Removing the mounting bracket
Vodafone MachineLink 3G
14
www.netcommwireless.com
Using the mounting bracket for wall mounting
By first attaching the DIN rail bracket to the wall, the MachineLink 3G can be easily attached and removed from the bracket.
Figure 10 – Wall mount - Mounted via DIN rail bracket
Using the mounting bracket for Top hat DIN rail mounting
The MachineLink 3G Router may be vertically mounted to the wall with the bracket by sliding the bracket onto a top hat DIN rail
Figure 11 - Top hat DIN rail mount
Alternatively, you can attach it to the DIN Rail by using the V bend in the bracket as illustrated below:
Figure 12 - Attaching the mounting bracket to the DIN rail using the V bend
Vodafone MachineLink 3G
www.netcommwireless.com
15
Desk mount
In situations where wall mounts and DIN rails are not required, you can simply place the MachineLink 3G router on a desk using its rubber feet to prevent it from slipping.
Figure 13 - Desk mount
Vodafone MachineLink 3G
16
www.netcommwireless.com
Installation and configuration of the Vodafone MachineLink 3G
Powering the router
The MachineLink 3G Router can be powered in one of three ways:
1. Power over Ethernet (802.3af PoE)
2. DC power input via 2-pin connector (8-35V DC)
3. DC power input via field terminated power source (8-35V DC)
4. The green power LED on the router lights up when a power source is connected.
Power over Ethernet (802.3af PoE)
Power over Ethernet (PoE) is a method of connecting network devices through Ethernet cable where power and data are passed along a single cable. This may be a desirable method of powering the device if PoE is available, or if it’s most convenient in the desired installation environment to only have a single cable running to the MachineLink 3G device.
There are 5 power classes defined in the IEEE 802.3-2005 standard, of which the Vodafone MachineLink 3G is a class 3 device.
CLASS
To use PoE to power the MachineLink 3G, simply connect your router to a PoE injector or PoE network switch using the bundled yellow Ethernet cable 8P8C.
CLASSIFICATION
CURRENT
3 26-30 mA 6.49 – 12.95 W Mid power
POWER RANGE CLASS DESCRIPTION
Table 6 - PoE power classes
DC power via 2-pin connector
The DC input jack can accept power from a separately sold DC power supply. Both a standard temperature range DC power supply and an extended temperature range DC power supply are available to purchase as accessories.
To power the device via DC Power via the 2-pin connector, remove the attached green terminal block from your router and connect the external DC power supply to the router’s green DC power jack.
DC power via field terminated power source
If an existing 8-35V DC power supply is available, you can insert the wires into the supplied terminal block to power your router. Use a No. 3 flathead screwdriver to tighten the terminal block screws and secure the power wires, making sure the polarity of the wires are correctly matched, as illustrated below.
Vodafone MachineLink 3G
Figure 14 - Locking Power Terminal Block
PIN SIGNAL DESCRIPTION
+ V+ Voltage +
- V- Ground
Table 7 - Locking power block pin outs
www.netcommwireless.com
17
Failover power support
The MachineLink 3G Router includes support for connection of two power sources at the same time. When a PoE Ethernet cable is connected and DC power is also supplied to the DC input jack of the router, the router will source power exclusively from the PoE source. In the event that power from the PoE cable is lost, the router will automatically switch to source power from the DC input jack, without affecting the router’s operation. When PoE power is restored, the router automatically switches back to receive power from the PoE input source.
Viewing power source information
You can view the current power input mode in the Advanced status section of the device’s Web user interface. This is useful for remotely monitoring the device. You can also use the Software Development Kit to access this information for advanced purposes (e.g. configuring SMS alerts to inform you of the power status of the router).
To view the router’s power source information, log in to the router and expand the Advanced status box on the status page. See the
Status section of this manual for more information on the status page.
Power consumption
To assist with power consumption planning, the following table summarises average power consumption during the various states of the MachineLink 3G under normal usage conditions. It’s important to note that this table serves as an indication only as the power consumed by the device is affected by many variables including signal strength, network type, and network activity.
Average power consumption figures
STATE POWER CONSUMPTION
Powered on, idle and connected to packet data
Powered on, connected to packet data with average load
Powered on, connected to packet data with heavy traffic
Peak power draw at maximum 3G module transmission power
Table 8 - Average power consumption figures
1.2W
2.0W
4.0W
5.0W
Installing the router
After you have mounted the router and connected a power source, follow these steps to complete the installation process.
1. Connect equipment that requires network access to the Ethernet port of your router. This may be your computer for
advanced configuration purposes, or your end equipment which requires data access via the MachineLink 3G. You can connect one device directly, or several devices using a network switch.
If you’re using PoE as the power source, you need to connect any devices via an available data Ethernet port on your PoE power source (be it a PoE network switch or PoE power injector).
2. Ensure the external power source is switched on and wait 2 minutes for your Vodafone MachineLink 3G to start up and
connect to the mobile network. Your router has an active SIM card preinstalled and arrives with preconfigured settings that should suit most customers.
Your router is now connected. To check the status of your router, compare the LED indicators on the device with those listed on page 8 of this guide.
Vodafone MachineLink 3G
18
www.netcommwireless.com
Advanced configuration
The Vodafone MachineLink 3G Router comes with preconfigured settings that should suit most customers. For advanced configuration, login to the web-based user interface of the Vodafone MachineLink 3G.
To log in to the web-based user interface of the router:
1. Open a web browser (e.g. Internet Explorer, Firefox, Safari), type
The web-based user interface login screen is displayed.
2. Enter the login username and password. If this is the first time you are logging in or you have not previously configured the
password for the “root” or “admin” accounts, you can use one of the default account details to log in.
http://192.168.1.1 into the address bar and press Enter.
ADMIN MANAGER
ACCOUNT
Username: admin Username: root
Password: admin Password: admin
Table 9 - Management account login details
Note:
To access all features of the router, you must use the root manager account.
For security reasons, we highly recommend that you change the passwords for the root and admin accounts upon
initial installation. You can do so by navigating via the menu to the System and then Administration page.
Figure 15 – Log in prompt for the web-based user interface
After you have logged in, the Status page is displayed.
ROOT MANAGER
ACCOUNT
Vodafone MachineLink 3G
www.netcommwireless.com
19
Status
The status page of the web interface provides system related information and is displayed when you log in to the Vodafone MachineLink 3G management console. The status page shows System information, LAN details, Cellular connection status, Packet
data connection status and Advanced status details. You can toggle the sections from view by clicking the or buttons to show or hide them.
Extra status boxes will appear as additional software features are enabled (e.g. VPN connectivity)
Figure 16 - The Status page
Vodafone MachineLink 3G
20
www.netcommwireless.com
System information
LAN
Cellular connection status
Packet data connection status
Transparent bridge mode
Advanced status
ITEM DEFINITION
System up time The current uptime of the router.
Device version The hardware and software firmware versions of the router.
Cellular module The type of phone module and the firmware version of the module.
IP The IP address and subnet mask of the router.
MAC address The MAC address of the router.
Ethernet port status Displays the current status of the Ethernet port and its operating speed.
SIM status / Signal strength (dBm) The status of the SIM card and the current signal strength measured in dBm
Provider / Roaming status / Coverage This shows the 3G service provider, the roaming status of the SIM and the type of coverage currently being received.
IMEI / Frequency
Profile name The name of the active profile.
Status The connection status of the active profile.
WWAN IP The IP address assigned by the mobile broadband carrier network.
APN The Access Point Name currently in use.
The IMEI (International Mobile Equipment Identity) of the router, a unique code for identifying devices on a GSM network.
Status The status of the bridged connection mode.
IP The IP address and subnet mask of the bridged connection.
APN name The Access Point Name you have selected for the bridged connection.
Service name The optional service name you have chosen for the bridged connection.
Country code The Mobile Country Code (MCC) of the inserted SIM.
Network code The Mobile Network Code (MNC) of the inserted SIM.
Signal quality (Ec/Io)
Received signal code power (RSCP) The power level of the signal on the current connection’s particular channel.
DC Jack input voltage Displays the current voltage of the power input source provided via the DC Input jack
Power input mode Displays whether power is currently being sourced from the PoE Ethernet port or from the DC input jack.
HSUPA category Displays the HSUPA category (1-9) for the current uplink
HSDPA category Displays the HSDPA category (1-8) for the current downlink.
SIM ICCID The Integrated Circuit Card Identifier of the SIM card used with the router, a unique number up to 19 digits in length.
Primary scrambling code (PSC) The Primary scrambling code for the current signal.
Location area code (LAC) The ID of the cell tower grouping the current signal is broadcasting from.
Routing area code (RAC)
Cell ID A unique code that identifies the base station from within the location area of the current mobile network signal.
Channel number (UARFCN) The channel number of the current 3G/2G connection.
A measurement of the portion of the received signal that is usable. This is basically the signal strength minus the signal noise level.
The Routing Area Code is a subset of the Location Code and helps to identify the group of or individual cell towers the current connection’s is broadcasting from.
Table 10 - Status page item details
Vodafone MachineLink 3G
www.netcommwireless.com
21
Networking
The Networking section provides configuration options for Wireless WAN, LAN, Routing and VPN connectivity.
Data connection
The data connection has two modes of operation:
Transparent bridge ON
In this mode the router does not manage the status of the connection to the packet data network. The status of the connection is instead managed by a client device connected behind the router via a PPPoE session. Certain functions of the router are unavailable when running in transparent bridge mode such as Connect on demand, Routing, VPN, TR-069, Router firewall and Remote access. As the responsibility of maintaining the connection is passed to a client machine, only that device will have network access.
Transparent bridge OFF
This is the default mode of operation. When transparent bridging is turned off, the router manages the status of the connection allowing Connect on demand, Routing, VPN, TR-069, Router firewall and Remote access.
The data connection page allows you to configure and enable/disable up to six connection profiles or to alternatively bridge the data connection via a PPPoE session.
Each profile refers to a set of configuration items which are used by the router to activate a Packet Data (PDP) context. Under normal scenarios, you may have a single profile enabled. Multiple profiles can be used for simple fast-switching of PDP settings such as APN, or for advanced networking configuration where multiple simultaneous PDP contexts may be required.
When the transparent bridge function is off, you can configure the connection profiles by clicking the row.
Edit button to the right of each
Figure 17 – Data connection settings (Transparent bridge off)
Vodafone MachineLink 3G
22
www.netcommwireless.com
Data connection
Profile name list
Roaming settings
OFF
ITEM DEFINITION
Transparent Bridge (PPPoE) Toggles the transparent bridge function on and off.
Default Sets the corresponding profile to be the default connection profile.
Status Toggles the corresponding profile on and off. If your carrier supports it, two profiles may be turned on simultaneously.
APN The APN configured for the corresponding profile.
Username The username used to log on to the corresponding APN.
Allow data roaming
When set to ON, the router will allow local devices to access the Wireless WAN network when the MachineLink 3G is roaming onto a foreign network. When set to network. This setting is ON by default.
Table 11 - Data connection item details
, the router will deny network access when roaming onto a foreign
Vodafone MachineLink 3G
www.netcommwireless.com
23
Connecting to the mobile broadband network
The router supports the configuration of up to six APN profiles; these profiles allow you to configure the settings that the router will use to connect to the 2G/3G network and switch easily between different connection settings.
For advanced networking purposes, you may activate a maximum of two profiles simultaneously (dependant on network support). When activating two connection profiles, you should avoid selecting two profiles with the same APN as this can cause only one profile to connect. Similarly, activating two profiles which are both configured to automatically determine an APN (including two blank APN profiles when using a Vodafone SIM) can cause a conflict and result in neither profile establishing a connection. We recommend that the two active connection profiles have differing, manually configured APNs to avoid connection issues and ensure smooth operation.
Using a Vodafone Global SIM
When using a Vodafone Global SIM, the router is pre-configured with the APN field blank. A blank APN setting allows the network to determine the correct APN.
Figure 18 - Data connection profile settings - Vodafone Global SIM
Vodafone MachineLink 3G
24
www.netcommwireless.com
Using a non-Vodafone Global SIM
When using a non-Vodafone Global SIM, the MachineLink 3G Router gives you the option of turning Automatic APN selection on or off. By default, Profile 1 is configured with
When Automatic APN selection is turned on, the router selects an appropriate APN from an internal database of known APNs. If the SIM you have inserted into the router is not of a known carrier, you may need to manually enter an APN to obtain a network connection. See manually configuring a connection profile for details on entering an APN manually.
To see the automatically selected APN, view the Status page.
Profile1 and Automatic APN set to ON.
Figure 19 - Data connection profile settings –Non-Vodafone Global SIM - Automatic APN settings
Manually configuring a connection profile
To manually configure a connection profile:
1. Click the Edit button corresponding to the Profile that you wish to modify. The data connection profile settings page is
displayed.
Figure 20 - Data connection profile settings
2. Click the Profile toggle key to turn the profile on. Additional settings appear.
Vodafone MachineLink 3G
www.netcommwireless.com
25
Figure 21 - Data connection settings - Profile turned on
3. In the Profile name field, enter a name for the profile. This name is only used to identify the profile on the router
4. Ensure that the Automatic APN selection toggle key is set to off. If it is not, click it to toggle it to the off position.
5. In the APN field, enter the APN Name (Access Point Name) and if required, use the Username and Password fields to enter
your login credentials.
6. Next to Authentication type, select the either CHAP or PAP depending on the type of authentication used by your provider.
7. The Reconnect delay field specifies the number of seconds to wait between connection attempts. The default setting of 30
seconds is sufficient in most cases but you may modify it to wait up to 65535 seconds if you wish.
8. The Reconnect retries field specifies the number of times to attempt to connect to the network if the router fails to establish
a connection. It is set to 0 by default which causes the router to attempt to reconnect indefinitely.
9. The Metric value is used by router to prioritise routes (if multiple are available) and is set to 20 by default. This value is
sufficient in most cases but you may modify it if you are aware of the effect your changes will have on the service.
10. Use the NAT Masquerading toggle key to turn NAT Masquerading on or off. NAT masquerading, also known simply as NAT
is a common routing feature which allows multiple LAN devices to appear as a single WAN IP via network address translation. I this mode, the router modifies network traffic sent and received to inform remote computers on the internet that packets originating from a machine behind the router actually originated from the WAN IP address of the router’s internal NAT IP address. This may be disabled if a framed route configuration is required and local devices require WAN IP addresses.
11. For advanced networking, you may wish to configure a particular profile to route only certain traffic via that profile by
configuring a custom address and mask of traffic to send via that profile. To do this, in the Profile routing settings section, enter the please leave these fields blank, which will not designate any particular traffic to be routed via this profile.
12. Click the Save button when you have finished entering the profile details.
Network address and Network mask of the remote network. If you do not want to use this feature, or are unsure,
Vodafone MachineLink 3G
26
www.netcommwireless.com
Confirming a successful connection After configuring a packet data session, and ensuring that one is enabled, click on the Status menu item at the top of the page to
return to the Status page. When there is a mobile broadband connection, the Packet data connection status section is expanded showing the details of the connection. To see details on each connected session, you can click
Figure 22 - Packet data connection status section
Show data use button.
Vodafone MachineLink 3G
www.netcommwireless.com
27
Transparently bridging the mobile broadband connection via PPPoE
If desired, you can have a client device connected to the Ethernet port initiate the mobile broadband connection using a PPPoE session. This is particularly useful in situations where you wish to provide Wireless WAN data access to an existing router which you want to have full public WAN IP access and have control over routing functionality.
To enable transparent bridging via PPPoE:
1. Click the Networking menu item from the top menu bar.
2. On the Data connection page, click the Transparent bridge (PPPoE) toggle key so that it is ON.
Figure 23 - Transparent bridge configuration
3. In the APN name field, enter the APN that you wish to use for the mobile broadband connection.
4. (Optional) In the Service name field, enter a name that allows you to easily identify the connection.
5. Click the Save button to confirm the settings.
6. Click the Status menu item from the top menu bar to see the transparent bridging status.
Figure 24 - Transparent bridge mode status
7. Next you must configure your downstream device connected via Ethernet to the MachineLink 3G to initiate a network
connection a PPPoE client. The username and password used by the downstream device for the PPPoE session will be passed on and used by the MachineLink 3G as the packet data (PDP) context authentication settings.
Vodafone MachineLink 3G
28
www.netcommwireless.com
Connect on demand
The connect on demand feature keeps the Packet Data Protocol (PDP) context deactivated by default while making it appear that the router has a permanent connection to the mobile broadband network to locally connected devices. When a packet of interest arrives or an SMS wake-up command is received, the router attempts to establish a mobile broadband data connection. When the data connection is established, the router monitors traffic and terminates the link when it is idle.
Note: When interesting packets arrive, the recovery time for the wireless WAN connection is approximately 20-30 seconds.
Configuring connect on demand
To configure Connect on demand:
1. Click the Networking menu item from the top menu bar.
2. On the Connect on demand page, click the Connect on demand toggle key so that it is ON.
Figure 25 - Connect on demand configuration options
3. The Connect on demand feature is OFF by default. To use the feature, click the Connect on demand toggle key to turn it
ON. Additional settings appear.
Setting the router to dial a connection when traffic is detected on specific ports
In some situations, you may wish to have the internet connection disabled except at times when outbound traffic to a particular external host’s port or range of ports is sent to the router. To use this feature, click or list of port numbers separated by commas. When you select this option, all outbound ICMP/TCP/UDP packets to any remote host on the specified port(s) will trigger the connection to dial. Note that when this feature is enabled, the options to ignore specific packet types are not available.
Figure 26 - Connect on demand - Data activity triggered connection
You can allow Microsoft network awareness (NCSI) traffic through but if you prefer that they do not trigger the connection, click the Ignore Microsoft network awareness (NCSI) traffic toggle key to set it to ON.
Enable dial port filter and enter the port number
Figure 27 - Connect on demand - Ignore NCSI traffic
Vodafone MachineLink 3G
www.netcommwireless.com
29
Excluding certain packet types from triggering the connection to dial
Depending on your environment, you might prefer to exclude certain types of traffic passing through the router from triggering the data connection. You can tell the router to ignore outbound TCP, UDP or ICMP packets. When any of these options are checked the router will not dial a connection when that type of outbound destined data packet reaches the router from a locally connected device.
Figure 28 - Connect on demand - Excluding IP protocols
Excluding certain application types from triggering the connection to dial
Some devices may generate general traffic as a part of normal operation which you may not want to trigger the data connection. You can set the router to ignore Domain Name System (DNS), Network Time Protocol (NTP) or Microsoft network awareness (NCSI) traffic from devices behind the router. When you check the box for these options, it tells the router to ignore the request from that application type and will not dial a connection when this data type is received.
Figure 29 - Connect on demand - Excluding application types
Setting timers for dial-up and disconnection
The router has a number of timer settings which let you determine when a connection is dialled and when it is disconnected.
Figure 30 - Connect on demand - Connect and disconnect timers
Vodafone MachineLink 3G
30
www.netcommwireless.com
OPTION
DESCRIPTION
Connect regularly, every
When traffic as per the configured settings above appear, the router will either continue to stay
On data activity, stay online for at least
After connecting, stay online for at least
After hanging up, don’t redial for
Disconnect regardless of traffic after
Connect regularly, every
online, or dial a connection and will not disconnect it for the specified time period (min. 1 minute, max. 1 hour). This timer is continuously reset throughout the duration of a dial-up session, whenever data activity is detected matching the rules above.
This timer will not hang-up the connection for the specified time period after initially dialling the connection. This setting cannot be less than the keep online period above. This timer affects the connection only once per dial up session, at the beginning of the session.
After a connection has been disconnected, you can tell the router to rest for a period of time before re-dialling.
Forces the router to disconnect the connection regardless of the traffic passing through it. The default setting is
If you want to have the router dial a connection at regular intervals, use specify the interval between dials. Setting this to
The router also features the ability to randomise the time at which the first dial action is performed. This is useful in situations such as where you have numerous routers in an area where a power outage has occurred. Setting a random dial time helps to reduce network congestion when all the routers are powered on so they do not all try to connect simultaneously.
When it is set to at least 2 minutes, you are able to configure the router to randomise the time it begins to dial. The randomised dial timer only affects the initial dial after the unit powers on or after the settings are saved. For example, if you configure the router to dial every 2 minutes with a randomised dial time of 1 minute, the router will dial the initial connection at a time greater than 2 minutes, but less than 3 minutes. After the first dial, the router will dial the connection exactly every 2 minutes.
Table 12 - Connect on demand - Connect and disconnect timers descriptions
never
.
never
effectively disables this option.
to
Verbose logging
The router provides the option of logging all the data activity which matches the settings for the Connect on demand feature for advanced troubleshooting purposes. To enable the logging of the Connect on demand feature, click the
Log all matched activity to
the system log toggle key to switch it ON. See the System log section for more information.
Figure 31 - Connect on demand - Verbose logging configuration
Manually connecting/disconnecting
There may be times when you need to either force a connection to be made or force a disconnection manually. You can use the Manual connect and Manual disconnect buttons to do this whenever necessary. The online status of the connection is displayed above the buttons.
Figure 32 - Connect on demand - Online/Offline control
When you have finished configuring the options for the Connect on demand feature, click the Save button at the bottom to save your changes.
SMS Wake up
The router can also be woken up by means of an SMS message using the SMS diagnostics feature. See the Diagnostics section for details on using the SMS Wake up function.
Vodafone MachineLink 3G
www.netcommwireless.com
31
Cellular band settings
The Cellular band settings page enables you to select which frequency band you will use for your connection and enables you to scan for available network operators in your area.
Figure 33 – Band settings
Note: In order to change the cellular band settings, the data connection must be disabled. When you access this page, you are prompted to disable the data connection if it is already active.
You may want to do this if you’re using the router in a country with multiple frequency networks that may not all support High Speed Packet Access (HSPA). You can select the router to only connect on the network frequencies that suit your requirements.
Use the The following band settings options are available:
It is not necessary to change the default setting of All bands in most cases. In fact, locking to a particular band can cause connection difficulties if the device is moved to a location where the forced band selection is no longer available.
When card.
The GSM All and the WCDMA all options allow you to force the device to lock to either 2G networks only, or 3G networks only. Click the
Change band drop down list to select the band you wish to use.
All Bands
GSM All
WCDMA All
GSM 850
GSM 900
GSM 1800
GSM 1900
WCMDA 850
WCDMA 900
WCDMA 800
WCDMA 1900
WCDMA 2100
All bands is selected, the router attempts to find the most suitable band based on the available networks for the inserted SIM
Save button to save and apply your selection.
Operator settings
The operator settings feature allows you perform a scan of available networks, and to optionally lock to a particular network returned by the network scan. To scan for available networks, set the scan button. This operation can take a few minutes and requires that the packet data session be disconnected prior to scanning.
Select operator mode from automatic to Manual then click the
Vodafone MachineLink 3G
32
www.netcommwireless.com
Figure 34 – Operating settings
A list of the detected 3G service carriers in your area is displayed.
Figure 35 - Detected operator list
Select the most appropriate 3G service from the list shown and click Apply. When
Select operator mode is set to Automatic, the router selects the most appropriate operator based on the inserted SIM card.
This is the default option and is sufficient for most users.
Vodafone MachineLink 3G
www.netcommwireless.com
33
SIM security settings
The SIM security settings page can be used for authenticating SIM cards that have been configured with a security PIN.
Unlocking a PIN locked SIM
If the SIM card is locked, you will receive a notice when you access the Status page after which you will be directed to the PIN settings page to enter the PIN. The PIN settings page lists the status of the SIM at the top of the page.
If you are not redirected to the PIN settings page, to unlock the SIM:
a) Click on the Networking menu from the top menu bar, and then click SIM security settings.
b) Enter the PIN in the Current PIN field and then enter it again in the Confirm current PIN field to confirm the PIN. c) If you are placing the router in a remote, unattended location, you may wish to check the Remember PIN option. This
feature allows the router to automatically send the PIN to the SIM each time the SIM asks for it (usually at power up). This enables the SIM to be PIN locked (to prevent unauthorised re-use of the SIM elsewhere), while still allowing the router to connect to the cellular service.
When this feature is enabled, the PIN you enter when setting the locally on the router. The next time the SIM asks the router for the PIN, the router decrypts the PIN and automatically sends it to the SIM without user intervention.
When this feature is disabled and the SIM is PIN locked and the PIN must be manually entered via the router‘s configuration interface. In situations where the router will be unattended, this is not desirable.
Note: Select Remember PIN if you do not want to enter the PIN code each time the SIM is inserted.
d) Click the Save button. If successful, the router displays the following screen:
Figure 36 - SIM security settings - SIM PIN locked
Remember PIN feature is encrypted and stored
Enabling/Disabling SIM PIN protection
The security PIN protection can be turned on or off using the PIN protection toggle key.
Vodafone MachineLink 3G
34
www.netcommwireless.com
Figure 37 - PIN Settings
Changing the SIM PIN code
If you would like to change the PIN, click the PIN fields, then enter the desired PIN into the New PIN and Confirm new PIN fields and click the Save button.
Change PIN button and enter the current PIN into the Current PIN and Confirm current
Vodafone MachineLink 3G
Figure 38 - PIN settings - Change PIN
www.netcommwireless.com
35
When the PIN has been changed successfully, the following screen is displayed:
Figure 39 - SIM security settings – PIN unlock successful
Vodafone MachineLink 3G
36
www.netcommwireless.com
Unlocking a PUK locked SIM
After three incorrect attempts at entering the PIN, the SIM card becomes PUK (Personal Unblocking Key) locked and you are requested to enter a PUK code to unlock it.
Note: To obtain the PUK unlock code, you must contact Vodafone.
You will be issued a PUK to enable you to unlock the SIM and enter a new PIN. Enter the new PIN and PUK codes. Click the Save button when you have finished entering the new PIN and PUK codes.
.
Figure 40 - SIM security - SIM PUK locke d
Vodafone MachineLink 3G
www.netcommwireless.com
37
LAN
LAN configuration
The LAN configuration page is used to configure the LAN settings of the router and to enable or disable DNS Masquerading.
Figure 41 – LAN configuration settings
The default IP of the Ethernet port is 192.168.1.1 with subnet mask 255.255.255.0. To change the IP address or Subnet mask, enter the new IP Address and/or Subnet mask and click the Save button.
Note: If you change the IP address, remember to reboot the router and enter the new IP address into your browser address bar.
DNS masquerading DNS masquerading allows the router to proxy DNS requests from LAN clients to dynamically assigned DNS servers. When enabled,
clients on the router’s LAN can then use the router as a DNS server without needing to know the dynamically assigned cellular network DNS servers.
With DNS masquerading as the DNS server address to LAN clients. The downstream clients then send DNS requests to the MachineLink which proxies them to the upstream DNS servers.
With DNS masquerading so that downstream clients send DNS requests directly to the upstream DNS servers without being proxied by the MachineLink 3G.
You may also override the DNS Masquerading option by specifying custom DNS Server IP addresses in the DHCP Server configuration mentioned in the next section of this guide. In this case the DHCP server assigns downstream devices the manually configured addresses and the DNS Masquerading option is ignored.
In most cases, it is not necessary to disable DNS masquerading but if you need to, click the OFF and then click the Save button.
ON, the DHCP server embedded in the MachineLink 3G hands out its own IP address (e.g. 192.168.1.1)
OFF, the DHCP server hands out the upstream DNS server IP addresses to downstream clients directly,
DNS masquerading toggle key to turn it
Vodafone MachineLink 3G
38
www.netcommwireless.com
Automatic IP address assignment (DHCP)
The DHCP page is used to adjust the settings used by the router’s built in DHPC Server which assigns IP addresses to locally connected devices.
DHCP relay configuration
In advanced networks configurations where the MachineLink 3G Router should not be responsible for DHCP assignment, but instead an existing DHCP server is located on the Wireless WAN connection, the clients behind the MachineLink 3G are able to communicate with the DHCP server when DHCP relay is enabled. This enables the MachineLink 3G to accept client broadcast messages and to forward them onto another subnet.
To configure the router to act as a DHCP relay agent click the address into the
DHCP configuration
You can manually set the start and end address range to be used to automatically assign addresses within, the lease time of the assigned address, the default domain name suffix, primary and secondary DNS server, the primary and secondary WINS server, as well as the advanced DHCP settings such as NTP, TFTP and Option 150/Option 160 (VoIP options).
DHCP server address field. DHCP relay is disabled by default.
Figure 42 – DHCP relay configuration
DHCP relay toggle key to turn it ON and enter the DHCP server
Figure 43 - DHCP configuration
Vodafone MachineLink 3G
www.netcommwireless.com
39
OPTION
DESCRIPTION
DHCP start range Sets the first IP address of the DHCP range
DHCP end range Sets the last IP address of the DHCP range
DHCP lease time (seconds) The length of time in seconds that DHCP allocated IP addresses are valid
Specifies the default domain name suffix for the DHCP clients. A domain name suffix enables users
Default domain name suffix
DNS server 1 IP address Specifies the primary DNS (Domain Name System) server’s IP address.
DNS server 2 IP address Specifies the secondary DNS (Domain Name System) server’s IP address.
WINS server 1 IP address Specifies the primary WINS (Windows Internet Name Service) server IP address
WINS server 2 IP address Specifies the secondary WINS (Windows Internet Name Service) server IP address
NTP server (Option 42) Specifies the IP address of the NTP (Network Time Protocol) server
TFTP server (Option 66) Specifies the TFTP (Trivial File Transfer Protocol) server
DHCP option 150
DHCP option 160
Enter the desired DHCP options and click the
Address reservation list
DHCP clients are dynamically assigned an IP address as they connect, but you can reserve an address for a particular device using the address reservation list.
to access a local server, for example, server1, without typing the full domain name server1.domain.com
This is used to configure Cisco IP phones. When a Cisco IP phone starts, if it is not pre-configured with the IP address and TFTP address, it sends a request to the DHCP server to obtain this information. Specify the string which will be sent as a reply to the option 150 request.
This is used to configure Polycom IP phones. When a Polycom IP phone starts, if it is not pre­configured with the IP address and TFTP address, it sends a request to the DHCP server to obtain this information. Specify the string which will be sent as a reply to the option 160 request.
Save button.
To add a device to the address reservation list:
1. Click the +Add button.
2. In the Computer name field enter a name for the device.
3. In the MAC address field, enter the device’s MAC address.
4. In the IP address fields, enter the IP address that you wish to reserve for the device.
5. If the Enable toggle key is not set to ON, click it to switch it to the ON position.
6. Click the Save button to save the settings.
Figure 44 – DHCP – Address reservation list
Vodafone MachineLink 3G
40
www.netcommwireless.com
Dynamic DHCP client list
The Dynamic DHCP client list displays a list of the DHCP clients. If you want to reserve the current IP address for future use, click
Clone button and the details will be copied to the address reservation list fields. Remember to click the Save button under the
the Address reservation list section to confirm the configuration.
Figure 45 - Dynamic DHCP client list
Vodafone MachineLink 3G
www.netcommwireless.com
41
Routing
Static
Static routing is the alternative to dynamic routing used in more complex network scenarios and is used to facilitate communication between devices on different networks. Static routing involves configuring the routers in your network with all the information necessary to allow the packets to be forwarded to the correct destination. If you change the IP address of one of the devices in the static route, the route will be broken.
Figure 46 - Static routing list
Some routes are added by default by the router on initialisation such as the Ethernet subnet route for routing to a device on the Ethernet subnet.
Adding Static Routes To add a new route to the static routing list, click the +Add button. The Static routes page appears.
1. In the Route name field, type a name for the route so that it can be identified in the static routing list.
2. From the Network interface drop down list, select the interface for which you would like to create a static route.
3. In the Destination IP address field, enter the IP address of the destination of the route.
4. In the IP subnet mask field, enter the subnet mask of the route.
5. In the Gateway IP address field, enter the IP address of the gateway that will facilitate the route.
6. In the Metric field enter the metric for the route. The metric value is used by the router to prioritise routes. The lower the
value, the higher the priority. To give the route the highest priority, set it to 0.
7. Click the Save button to save your settings.
Vodafone MachineLink 3G
42
www.netcommwireless.com
Figure 47 - Adding a static route
Active routing list Static routes are displayed in the Active routing list.
Figure 48 - Active routing list
Deleting static routes From the static routing list, click the icon to the right of the entry you wish to delete.
Vodafone MachineLink 3G
Figure 49 - Deleting a static route
www.netcommwireless.com
43
RIP
RIP (Routing Information Protocol) is used for advertising routes to other routers. Thus all the routes in the router’s routing table will be advertised to other nearby routers. For example, the route for the router’s Ethernet subnet could be advertised to a router on the PPP interface side so that a router on this network will know how to route to a device on the router’s Ethernet subnet. Static routes must be added manually according to your requirements. See
Note: Some routers will ignore RIP.
Figure 50 - RIP configuration
To enable Routing Information Protocol (RIP)
1. Click the RIP toggle key to switch it to the ON position.
2. Using the Version drop down list, select the version of RIP that you would like to use.
3. Click the Save button to confirm your settings.
Adding Static Routes.
Vodafone MachineLink 3G
44
www.netcommwireless.com
Redundancy (VRRP)
Virtual Router Redundancy Protocol (VRRP) is a non-proprietary redundancy protocol designed to increase the availability of the default gateway servicing hosts on the same subnet. This increased reliability is achieved by advertising a “virtual router” (an abstract representation of master and backup routers acting as a group) as a default gateway to the host(s) instead of one physical router. Two or more physical routers are then configured to stand for the virtual router, with only one doing the actual routing at any given time. If the current physical router that is routing the data on behalf of the virtual router fails, an arrangement is made for another physical router to automatically replace it. The physical router that is currently forwarding data on behalf of the virtual router is called the master router.
Master routers have a priority of 255 and backup router(s) can have a priority between 1 and 254.
A virtual router must use 00-00-5E-00-01-XX as its (MAC) address. The last byte of the address (XX) is the Virtual Router Identifier (VRID), which is different for each virtual router in the network. This address is used by only one physical router at a time, and is the only way that other physical routers can identify the master router within a virtual router.
Figure 51 - VRRP configuration
To configure VRRP, configure multiple devices as follows and connect them all via an Ethernet network switch to downstream devices.
1. Click the Redundancy (VRRP) toggle key to activate VRRP.
2. In the Virtual ID field, enter an ID between 1 and 255. This is the VRRP ID which is different for each virtual router on the
network.
3. In the Router priority field, enter a value for the priority – a higher value is a higher priority.
4. The Virtual IP address field is used to specify the VRRP IP address – this is the virtual IP address that both virtual routers
share.
5. Click the Save button to save the new settings.
Note: Configuring VRRP changes the MAC address of the Ethernet port and therefore if you want to resume with the web configuration you must use the new IP address (VRRP IP) or on a command prompt type:
arp –d <ip address>
arp –d 192.168.1.1)
(i.e.
to clear the arp cache.(old MAC address).
Vodafone MachineLink 3G
www.netcommwireless.com
45
Port forwarding
The Port forwarding list is used to configure the Network Address Translation (NAT) rules currently in effect on the router.
Figure 52 – Port forwarding list
The purpose of the port forwarding feature is to allow mapping of inbound requests to a specific port on the WAN IP address to a device connected on the Ethernet interface.
Adding a port forwarding rule To create a new port forwarding rule:
1. Click the +Add button. The port forwarding settings screen is displayed.
2. Use the Protocol drop down list to select the type of protocol you want to use for the rule. The protocols selections
available are
3. In the Source IP address field, enter a “friendly” address that is allowed to access the router or a wildcard IP address
(0.0.0.0) that allows all IP addresses to access the router.
4. The Source port range (From) and (To) fields are used to specify the port(s) on the source side that are to be forwarded.
This allows you to send a range of consecutive port numbers by entering the first in the range in the in the range in the
5. In the Destination IP address field, enter the IP address of the client to which the traffic should be forwarded.
6. The Destination port range (From) and (To) fields are used to specify the port(s) on the destination side that are to be
forwarded. If the Source port range specifies a single port then the destination port may be configured to any port. If the Source port range specifies a range of port numbers then the Destination port range must be the same as the Source port range.
7. Click the Save button to confirm your settings.
TCP, UDP and All.
(From) field and the last
(To) field. To forward a single port, enter the port in the (From) field and repeat it in the (To) field.
To delete a port forwarding rule, click the button on the Port forwarding list for the corresponding rule that you would like to delete.
Figure 53 - Port forwarding settings
Vodafone MachineLink 3G
46
www.netcommwireless.com
DMZ
The Demilitarised Zone (DMZ) allows you to configure all incoming traffic on all protocols to be forwarded to a selected device behind the router. This feature can be used to avoid complex port forwarding rules, but it exposes the device to untrusted networks as there is no filtering of what traffic is allowed and what is denied.
The DMZ configuration page is used to specify the IP Address of the device to use as the DMZ host.
Figure 54 - DMZ configuration
1. Click the DMZ toggle key to turn the DMZ function ON.
2. Enter the IP Address of the device to be the DMZ host into the DMZ IP address field.
3. Click the Save button to save your settings.
MAC / IP / Port filtering
The MAC/IP/Port filter feature allows you apply a policy to the traffic that passes through the router so that network access can be controlled. When the filter is enabled with a default rule of “Accepted”, all connections will be allowed except those listed in the “Current MAC / IP / Port filtering rules in effect” list. Conversely, when the default rule is set to “Dropped”, all connections are denied except for those listed in the filtering rules list.
Figure 55 - MAC / IP / Port filtering
Creating a MAC / IP / Port filtering rule
To create a filtering rule:
1. Click the MAC / IP / Port filtering toggle key to switch it to the ON position.
2. Using the Default Rule (inbound/forward) drop down list, select the default action for the router to take when traffic reaches
it. By default, this is configured to at least one device access to the router, otherwise you will effectively be locked out of the router.
3. Click the Save button to confirm the default rule.
4. In the Current MAC / IP / Port filtering rules in effect section, click the +Add button.
Accepted. If you change this to Dropped, you should first configure a filter rule that allows
Figure 56 - Current MAC / IP/ Port filtering rules in effect
Vodafone MachineLink 3G
www.netcommwireless.com
47
OPTION
DESCRIPTION
Inbound
Outbound
Forward
All
TCP, UDP, UDP/TCP
ICMP.
(From)
(To)
(From)
(To)
Accept
Drop
Accept
Accept
Dropped
Drop
5. Enter the details of the rule in the section that is displayed and click the Save button.
Figure 57 - MAC / IP / Port filtering settings
Use the drop down list to select the direction of the traffic for which you want to apply to the rule.
refers to all traffic that is entering the router including data entering from the WAN and the
Bound
Protocol
MAC address
Source IP address Enter the IPv4 address that the traffic originates from and the subnet mask using CIDR notation.
Source port range (From) – (To)
Destination IP address Enter the IPv4 address that the traffic is destined for and the subnet mask using CIDR notation.
Destination port range (From) – (To)
Action
Comment [Optional] Use this field to enter a comment as a meaningful description of the rule.
LAN. WAN and traffic leaving in the direction of the LAN. WAN side and is forwarded to the opposite end.
Use the drop down list to select the protocol for the rule. You can have the rule apply to protocols,
Enter the MAC address in six groups of two hexadecimal digits separated by colons (:). e.g. 00:40:F4:CE:FA:1E
Only appears for TCP, UDP and UDP/TCP options. Use these fields to specify a port or range of ports from the source side to use for the rule. To specify a single port, repeat it in both the and
Only appears for TCP, UDP and UDP/TCP options. Use these fields to specify a port or range of ports on the destination side to use for the rule. To specify a single port, repeat it in both the and
Select the action to take for traffic which meets the above criteria. You can choose to packets. When the default rule is set to the rule is redundant. Likewise, if the default rule is set to
action.
Table 13 - Current MAC / IP / Port filtering rules in effect
refers to all traffic exiting the router including traffic leaving in the direction of the
or
fields.
fields.
, you cannot create a rule with an
specifies traffic that enters on the LAN or
you cannot create a rule with a
or
action since
6. The new rule is displayed in the filtering rules list. You can edit the rule by clicking the button or delete the rule by
clicking the button.
Vodafone MachineLink 3G
48
www.netcommwireless.com
Figure 58 - Completed filtering rule
Vodafone MachineLink 3G
www.netcommwireless.com
49
VPN
A Virtual Private Network (VPN) is a tunnel providing a private link between two networks or devices over a public network. Data to be sent via a VPN needs to be encapsulated and as such is generally not visible to the public network.
The advantages of a VPN connection include:
Data Protection
Access Control
Data Origin Authentication
Data Integrity
Each VPN connection has different configuration requirements. The following pages detail the configuration options available for the different VPN connection types.
Note: The following descriptions are an overview of the various VPN options available. More detailed instructions are available in separate whitepapers on the NetComm Wireless website.
IPSec
IPSec operates on Layer 3 of the OSI model and as such can protect higher layered protocols. IPSec is used for both site to site VPN and Remote Access VPN. The Vodafone MachineLink 3G supports IPsec end points and can be configured with Site to Site VPN tunnels with third party VPN routers.
Configuring an IPSec VPN
From the menu at the top of the screen, click Networking and under the VPN section, click IPSec. A list of configured IPSec VPN connections is displayed.
Click the
+Add button to begin configuring an IPSec VPN connection.
Figure 59 - IPSec VPN List
Vodafone MachineLink 3G
50
www.netcommwireless.com
Figure 60 – IPSec profile edit
Vodafone MachineLink 3G
www.netcommwireless.com
51
ESP, AH
Any
Main, Aggressive
Any
Browse
Browse
Local private key, Local public certificate
Remote public certificate, CA certificate, CRL certificate
Browse
The following table describes each of the fields of the IPSec VPN Connection Settings page.
ITEM DEFINITION
IPSec profile Enables or disables the VPN profile.
Profile name A name used to identify the VPN connection profile.
Remote IPSec server address The IP address of the IPSec server.
Remote LAN address Enter the IP address of the remote network for use on the VPN connection.
Remote LAN subnet mask Enter the subnet mask in use on the remote network.
Local LAN address Enter the IP address of the local network for use on the VPN connection.
Local LAN subnet mask Enter the subnet mask in use on the local network.
Encapsulation type Select the encapsulation protocol to use with the VPN connection. You can choose
IKE Mode Select the IKE mode to use with the VPN connection. You can choose
PFS Choose whether Perfect Forward Secrecy is ON or OFF for the VPN connection.
IKE encryption Select the cipher type to use for the Internet Key Exchange.
IKE hash
IPSec encryption Select the IPSec encryption type to use with the VPN connection.
IPSec hash
DH group Select the desired Diffie-Hellman group to use. Higher groups are more secure but also require longer to generate a key.
DPD action
DPD keep alive time Enter the time in seconds for the interval between Dead Peer Detection keep alive messages.
DPD timeout Enter the time in seconds of no response from a peer before Dead Peer Detection times out.
IKE rekey time Enter the time in seconds between changes of the encryption key. To disable changing the key, set this to 0.
SA life time Enter the time in seconds for the security association lifetime.
Key Mode
Pre-shared key The pre-shared key is the key that peers used to authenticate each other for Internet Key Exchange.
Remote ID Specifies the domain name of the remote network.
Local ID Specifies the domain name of the local network.
Update time Displays the last time the key was updated.
Local RSA key upload Select the RSA key file for the local router here by clicking the
Remote RSA key upload Select the RSA key file for the remote router here by clicking the
Private key passphrase
Key / Certificate
IPSec certificate upload Select the IPSec certificate to upload by clicking the
Select the IKE Hash type to use for the VPN connection. The hash is used for authentication of packets for the key exchange.
Select the IPSec hash type to use for the VPN connection. The hash is used for authentication of packets for the VPN connection.
Select the desired Dead Peer Detection action. This is the action to take when a dead Internet Key Exchange Peer is detected.
Select the type of key mode in use for the VPN connection. You can select from:
Pre Shared Key
RSA keys
Certificates
button.
button.
The Private key passphrase of the router is the passphrase used when generating the router’s private key using OpenSSL CA.
Select the type of key or certificate to use for authentication. You can select
.
button.
Table 14 - IPSec Configuration Items
or
or
.
.
,
Vodafone MachineLink 3G
52
www.netcommwireless.com
OpenVPN
OpenVPN is an open source virtual private network (VPN) program for creating point-to-point or server-to-multi-client encrypted tunnels between host computers. It can traverse network address translation (NAT) and firewalls and allows authentication by certificate, pre-shared key or username and password. OpenVPN works well through proxy servers and can run over TCP and UDP transports. Support for OpenVPN is available on several operating systems, including Windows, Linux, Mac OS, Solaris, OpenBSD, FreeBSD, NetBSD and QNX.
Configuring an Open VPN server
From the menu at the top of the screen, click Networking and from the VPN section on the left, click OpenVPN. A list of configured OpenVPN VPN connections is displayed.
Click the
Figure 61 - OpenVPN VPN List
+Add button for the type of OpenVPN server/client you would like to configure.
OpenVPN server
To configure an OpenVPN server:
1. Click the OpenVPN profile toggle key to switch it to the ON position.
2. Type a name for the OpenVPN server profile you are creating.
3. Use the Server port field to select a port number and then use the drop down list to select a packet type to use for your
OpenVPN Server. The default OpenVPN port is 1194 and default packet type is UDP.
4. In the VPN network address and VPN network subnet mask fields, enter the IP address and network subnet mask to
assign to your VPN. This is ideally an internal IP address which differs from your existing address scheme.
5. Next to Diffie-Hellman parameters, click the Generate DH button. This will create an encryption key to secure your
OpenVPN connection.
6. Under Server Certificates, enter the required details. All fields must be completed. The Country field must consist of two
characters only. When the details have been entered, click the Authority (CA) certificate based on this information.
7. Under the Server certificates section, select the Authentication type that you would like to use for the OpenVPN Server.
Note: The Diffie-Hellman parameters can take up to 10 minutes to generate. Please be patient.
Generate CA certificate button to generate the Certificate
Vodafone MachineLink 3G
www.netcommwireless.com
53
Certificate Authentication
a) In the Certificate Management section, enter the required details to create a client certificate. All fields are required. When
you have finished entering the details, click the
Generate button.
Figure 62 - OpenVPN server configuration – Certificate management
b) When it is done, you can click the Download button to save the certificate file. If for some reason the integrity of your
network has been compromised, you can return to this screen and use the Certificate drop down list to select the certificate and then press the Revoke button to disable it.
c) Optional: To inform the OpenVPN server of the network address scheme of the currently selected certificate, enter the
network address and network subnet mask in the respective fields and click the not enter the remote subnet here, any packet requests from the server to the client will not be received by the client network because it is not aware of the remote client’s subnet.
Set network information button. If you do
Vodafone MachineLink 3G
54
www.netcommwireless.com
Figure 63 – OpenVPN server profile settings
Vodafone MachineLink 3G
www.netcommwireless.com
55
Username / Password Authentication
a) In the Username/Password section, enter the username and password you would like to use for authentication on the
OpenVPN Server. Click the client.
Note: If you wish to have more than one client connect to this OpenVPN server, you must use Certificate authentication mode as Username/Password only allows for a single client connection.
Download CA certificate button to save the ca.crt file. This file will need to be provided to the
Figure 64 - OpenVPN Server – Username / Password section
b) Optional: To inform the OpenVPN server of the network address scheme of the currently selected certificate, enter the
network address and network subnet mask in the respective fields and click the not enter the remote subnet here, any packet requests from the server to the client will not be received by the client network because it is not aware of the remote client’s subnet.
c) When you have finished entering all the required information, click Save to finish configuring the OpenVPN server.
Set network information button. If you do
Configuring an OpenVPN Client
1. Click the OpenVPN profile toggle key to switch it to the ON position.
2. In the Profile name field, type a name for the OpenVPN client profile you are creating.
3. In the Server IP address field, type the WAN IP address of the OpenVPN server.
4. Use the Server port field to select a port number and then use the drop down list to select a packet type to use for the
OpenVPN server. The default OpenVPN port is 1194 and default packet type is UDP.
5. If the Default gateway option is applied on the OpenVPN client page, the OpenVPN server will enable connections to be
made to other client networks connected to it. If it is not selected, the OpenVPN connection allows for secure communication links between this router and the remote OpenVPN server only.
6. Use the Authentication type options to select the Authentication type that you would like to use for the OpenVPN client.
Vodafone MachineLink 3G
56
www.netcommwireless.com
Certificate Authentication
a) In the Certificate upload section at the bottom of the screen, click the Browse button and locate the certificate file you
downloaded when you configured the OpenVPN server. When it has been selected, click the the router.
Figure 65 - OpenVPN client - Certificate upload
Username / Password Authentication
a) Enter the username and password to authenticate with the OpenVPN server.
Upload button to send it to
Figure 66 - OpenVPN Client - Username/Password section
b) Use the Browse button to locate the CA certificate file you saved from the OpenVPN Server and then press the Upload
button to send it to the router.
7. Click the Save button to complete the OpenVPN Client configuration.
Configuring an OpenVPN P2P Connection
To configure an OpenVPN peer-to-peer connection:
1. Set Click the OpenVPN profile toggle key to switch it to the ON position.
2. In the Profile name field, type a name for the OpenVPN P2P profile you are creating.
3. On the router designated as the master, leave the Server IP address field empty. On the router designated as the slave,
enter the WAN IP address of the master.
Vodafone MachineLink 3G
www.netcommwireless.com
57
Figure 67 - OpenVPN P2P mode settings
4. Use the Server port field to select a port number and then use the drop down list to select a packet type to use for the
OpenVPN server. The default OpenVPN port is 1194 and default packet type is UDP.
5. In the Local IP address and Remote IP address fields, enter the respective local and remote IP addresses to use for the
OpenVPN tunnel. The slave should have the reverse settings of the master.
6. Under the Remote network section, enter the network Address and network Subnet mask. The Network Address and
Network Mask fields inform the Master node of the LAN address scheme of the slave.
7. Press the Generate button to create a secret key to be shared with the slave. When the timestamp appears, you can click
the
Download button to save the file to exchange with the other router.
8. When you have saved the secret key file on each router, use the Browse button to locate the secret key file for the master
and then press the secret key file to master.
9. When they are uploaded click the Save button to complete the peer-to-peer OpenVPN configuration.
Upload button to send it to the slave. Perform the same for the other router, uploading the slave’s
Vodafone MachineLink 3G
58
www.netcommwireless.com
PPTP client
The Point-to-Point Tunnelling Protocol (PPTP) is a method for implementing virtual private networks using a TCP and GRE tunnel to encapsulate PPP packets. PPTP operates on Layer 2 of the OSI model and is included on Windows computers.
Configuring the PPTP Client
To configure the PPTP client:
1. From the menu bar at the top of the screen, click Networking and then from the VPN section on the left side of the screen,
click
PPTP client. The PPTP client list is displayed.
Figure 68 - PPTP client list
2. Click the +Add button to begin configuring a new PPTP client profile. The PPTP client edit screen is displayed.
Figure 69 - VPN PPTP client edit
3. Click the Enable PPTP client toggle key to switch it to the ON position.
4. In the Profile name list, enter a profile name for the tunnel. This may be anything you like and is used to identify the tunnel
on the router.
5. Use the Username and Password fields to enter the username and password for the PPTP account.
6. In the PPTP server address field, enter the IP address of the PPTP server.
Vodafone MachineLink 3G
www.netcommwireless.com
59
7. From the Authentication type drop down list, select the Authentication type used on the server. If you do not know the
authentication method used, select There are 5 authentication types you can choose from:
8. CHAP – uses a three way handshake to authenticate the identity of a client.
9. MS-CHAP v1 – This is the Microsoft implementation of the Challenge Handshake Authentication Protocol for which support
was dropped in Windows® Vista.
10. MS-CHAP v2 - This is the Microsoft implementation of the Challenge Handshake Authentication Protocol which was
introduced in Windows® NT 4.0 and is still supported today.
11. PAP – The Password Authentication Protocol uses a password as a means of authentication and as such, is commonly
supported. PAP is not recommended because it transmits passwords unencrypted and is not secure.
12. EAP – Extensible Authentication Protocol. An Authentication protocol commonly used in wireless networks.
13. The metric value helps the router to prioritise routes and must be a number between 0 and 65535. The default value is 30
and should not be modified unless you are aware of the effect your changes will have.
14. The Use peer DNS option allows you to select whether the remote clients will use the Domain Name Server of the PPTP
server. Click the toggle key to set this to ON or OFF as required.
15. NAT masquerading allows the router to modify the packets sent and received to inform remote computers on the internet
that packets originating from a machine behind the router actually originated from the WAN IP address of the router’s internal NAT IP address. Click the toggle key to switch this to the ON position if you want to use this feature.
16. Set default route to PPTP sets all outbound data packets to go out through the PPTP tunnel. Click the toggle key to switch
this to the ON position if you want to use this feature.
17. The Verbose logging option sets the router to output detailed logs regarding the PPTP connection in the System Log
section of the router interface.
18. The Reconnect delay is the time in seconds that the router will wait before attempting to connect to the PPTP server in the
event that the connection is broken. The minimum time to wait is 30 seconds so as to not flood the PPTP server with connection requests, while the maximum time to wait is 65335 seconds.
19. The Reconnect retries is the number of connection attempts that the router will make in the event that the PPTP connection
goes down. If set to 0, the router will retry the connection indefinitely, otherwise the maximum number of times to retry cannot be greater than 65335.
20. Click the Save button to save the changes. The VPN will attempt to connect after your click Save. Click the Status button at
the top left of the interface to return to the status window and monitor the VPN’s connection state.
any and the router will attempt to determine the correct authentication type for you.
Vodafone MachineLink 3G
60
www.netcommwireless.com
GRE tunnelling
The Generic Route Encapsulation (GRE) protocol is used in addition to Point-to-Point Tunnelling Protocol (PPTP) to create VPNs (virtual private networks) between clients and servers or between clients only. Once a PPTP control session establishes the VPN tunnel GRE is used to securely encapsulate the data or payload.
Configuring GRE tunnelling
To configure GRE tunnelling:
1. From the menu bar at the top of the screen, click Networking and then from the VPN section on the left side of the screen,
click
PPTP client. The PPTP client list is displayed.
Figure 70 - GRE client list
2. Click the +Add button to begin configuring a new GRE tunnelling client profile. The GRE client edit screen is displayed.
Figure 71 – GRE client edit
3. Click the Enable VPN toggle key to switch it to the ON position.
4. In the Profile name, enter a profile name for the tunnel. This may be anything you like and is used to identify the tunnel on
the router.
5. In the GRE server address field, enter the IP address of the GRE server.
6. In the Local tunnel address field, enter the IP address you want to assign the tunnel locally.
Vodafone MachineLink 3G
www.netcommwireless.com
61
7. In the Remote tunnel address field, enter the IP address you want to assign to the remote tunnel.
8. In the Remote network address field, enter the IP address scheme of the remote network.
9. In the Remote network/mask field, enter the subnet mask of the remote network.
10. The TTL (Time To Live) field is an 8-bit field used to remove an undeliverable data packet from a network to avoid
unnecessary network traffic across the internet. The default value of 255 is the upper limit on the time that an IP datagram can exist. The value is reduced by at least one for each hop the data packet takes to the next router on the route to the datagram’s destination. If the TTL field reaches zero before the datagram arrives at its destination the data packet is discarded and an error message is sent back to the sender.
11. The Reconnect delay is the time in seconds that the router will wait before attempting to connect to the GRE server in the
event that the connection is broken. The minimum time to wait is 30 seconds so as to not flood the GRE server with connection requests, while the maximum time to wait is 65335 seconds.
12. The Reconnect retries is the number of connection attempts that the router will make in the event that the GRE connection
goes down. If set to 0, the router will retry the connection indefinitely, otherwise the maximum number of times to retry cannot be greater than 65335.
13. Click the Save button to save the changes. The VPN will attempt to connect after your click Save. Click the Status button at
the top left of the interface to return to the status window and monitor the VPN’s connection state.
Vodafone MachineLink 3G
62
www.netcommwireless.com
Services
Dynamic DNS
The DDNS page is used to configure the Dynamic DNS feature of the router. A number of Dynamic DNS hosts are available from which to select.
Dynamic DNS provides a method for the router to update an external name server with the current WAN IP address.
To configure dynamic DNS:
1. Click the DDNS configuration toggle key to switch it to the ON position.
2. From the Dynamic DNS drop down list, select the Dynamic DNS service that you wish to use. The available DDNS services
available are:
www.dhs.org
www.dyndns.org
www.dyns.cx
www.easydns.com
www.justlinux.com
www.ods.org
www.tzo.com
www.zoneedit.com
3. In the Username and Password fields, enter the logon credentials for your DDNS account. Enter the password for the
account again in the
4. Click the Save button to save the DDNS configuration settings.
Verify password field.
Figure 72 – Dynamic DNS settings
Vodafone MachineLink 3G
www.netcommwireless.com
63
Network time (NTP)
The NTP (Network Time Protocol) settings page allows you to configure the Vodafone MachineLink 3G to synchronise its internal clock with a global Internet Time server and specify the time zone for the location of the router. This provides an accurate timekeeping function for features such as System Log entries and Firewall settings where the current system time is displayed and recorded.
Any NTP server available publicly on the internet may be used. The default NTP server is 0.netcomm.pool.ntp.org.
Figure 73 - NTP settings
Configuring Timezone settings
To configure time zone settings:
1. The Current time field shows the time and date configured on the router. If this is not accurate, use the Time zone drop
down list to select the correct time zone for the router. If the selected zone observes daylight savings time, a savings time schedule link appears below the drop down list. Click the link to see the start and end times for daylight savings.
2. When you have selected the correct time zone, click the Save button to save the settings.
Daylight
Configuring NTP settings
To configure NTP settings:
1. Click the Network time (NTP) toggle key to switch it to the ON position.
2. In the NTP service field, enter the address of the NTP server you wish to use.
3. The Synchronisation on WWAN connection toggle key enables or disables the router from performing a synchronisation of
the time each time a mobile broadband connection is established.
4. The Daily synchronisation toggle key enables or disables the router from performing a synchronisation of the time each day.
5. When you have finished configuring NTP settings, click the Save button to save the settings.
Vodafone MachineLink 3G
64
www.netcommwireless.com
Ping watchdog
The Ping watchdog page is used to configure the behaviour of the Periodic Ping monitor function.
When configured, the Ping watchdog feature transmits controlled ping packets to 1 or 2 user specific IP addresses. Should the watchdog not receive responses to the pings, it will reboot the device in a last resort attempt to restore connectivity.
Please be very careful when considering using this feature in situations where the device is intentionally offline for a particular reason (e.g. user configured PDP session disconnect, or the Connect on demand feature enabled). This is because the ping watchdog feature expects to be able to access the internet at all times and will always eventually reboot the router if access isn’t restored by the time the various timers and retries expire.
It is due to the nature of the ping watchdog being a last resort standalone backup mechanism that it will continue to do its job and reboot the device even when the Connect on demand session is idle, or the PDP context is disabled by the user. Therefore, it is recommended to disable this feature if Connect on demand is configured, or if the PDP context will be intentionally disconnected on the occasion.
The feature operates as follows:
A. After every “Periodic Ping Timer” configured interval, the router sends 3 consecutive pings to the “First destination
address”.
B. If all 3 pings fail the router sends 3 consecutive pings to the “Second address”. C. The router then sends 3 consecutive pings to the “Destination address” and 3 consecutive pings to the “Second address”
every “Periodic Ping Accelerated Timer” configured interval.
D. If all accelerated pings in step C above fail then number of time configured in “Fail Count”, the router reboots. E. If any ping succeeds, the router returns to step A and does not reboot.
Note: The “Periodic Ping Timer” should not be to a value of less than 60 seconds to allow the router time to reconnect to the cellular network following a reboot.
To disable the periodic ping reset monitor, set
Fail count to 0.
Figure 74 – Ping watchdog settings
Vodafone MachineLink 3G
www.netcommwireless.com
65
Configuring Periodic PING settings
The Periodic PING settings configure the router to transmit controlled ping packets to 2 specified IP addresses. If the router does not receive responses to the pings, the router will reboot.
This works as follows:
1. After every Periodic Ping Timer configured interval, the router sends 3 consecutive pings to the First destination address.
2. If all 3 pings fail, the router sends 3 consecutive pings to the Second destination address.
3. The router then sends 3 consecutive pings to the First destination address and 3 consecutive pings to the Second
destination address every Periodic PING accelerated timer configured interval.
4. If all accelerated pings in step 3 above fail, the number of times configured in Fail count, the router reboots.
5. If any ping succeeds the router returns to step 1 and does not reboot.
Disabling the Periodic Ping reset function
To disable the Periodic Ping reset function, set Fail Count to 0.
Note: The traffic generated by the periodic ping feature is usually counted as chargeable data usage. Please keep this in mind when selecting how often to ping.
Configuring a Periodic reboot
The router can be configured to automatically reboot after a period of time specified in minutes. While this is not necessary, it does ensure that in the case of remote installations, the router will reboot if some anomaly occurs.
1. In the Force reboot every field, enter the time in minutes between forced reboots. The default value is 0 which disables the
Periodic reboot function. The minimum period between reboots is 5 minutes while the maximum value is 65535 minutes.
2. If you have configured a forced reboot time, you can use the Randomise reboot time drop down list to select a random
reboot timer. Randomising the reboot time is useful for preventing a large number of devices from rebooting simultaneously and flooding the network with connection attempts. The router will wait for the configured randomly reboot within the configured
3. Click the Save button to save the settings.
Randomise reboot time.
Force reboot every time and then
Vodafone MachineLink 3G
66
www.netcommwireless.com
SNMP
SNMP configuration
The SNMP page is used to configure the SNMP features of the router.
Figure 75 - SNMP configuration
SNMP (Simple Network Management Protocol) is used to remotely monitor the router for conditions that may warrant administrative attention. It can be used to retrieve information from the router such as the signal strength, the system time, the interface status, etc.
To configure SNMP:
1. Click the SNMP toggle key to switch it to the ON position.
2. Enter Read-only community name and Read-write community name which are used for client authentication.
Community names are used as a type of security to prevent access to reading and/or writing to the routers configuration. It
is recommended to change the Community names to something other than the default settings when using this feature.
3. Click the Save button to save any changes to the settings.
4. The Download button displays the Management information base (MIB) of the router. The MIB displays all the objects of the
router that can have their values set or report their status. The MIB is formatted in the SNMP-related standard RFC1155.
Vodafone MachineLink 3G
www.netcommwireless.com
67
SNMP traps
SNMP traps are messages from the router to the Network Management System sent as UDP packets. They are often used to notify the management system of any significant events such as whether the link is up or down.
Configuring SNMP traps
To configure SNMP traps:
1. In the Trap destination field, enter the IP address to which SNMP data is to be sent.
2. In the Heartbeat interval field, enter the number of seconds between SNMP heartbeats.
3. Use the Trap persistence field to specify the time in seconds that an SNMP trap persists.
4. Use the Trap retransmission time to specify the length of time in seconds between SNMP trap retransmissions.
Figure 76 - SNMP traps
To send a manual SNMP Heartbeat, click the
When you have finished configuring the SNMP traps, click the Save button to save the settings.
Send heartbeat button.
Vodafone MachineLink 3G
68
www.netcommwireless.com
TR-069
The TR-069 (Technical Report 069) protocol is a technical specification also known as CPE WAN Management Protocol (CWMP). It is a framework for remote management and auto-configuration of end-user devices such as customer-premises equipment (CPE) and Auto Configuration Servers (ACS). It is particularly efficient in applying configuration updates across networks to multiple CPEs.
TR-069 uses a bi-directional SOAP/HTTP-based protocol based on the application layer protocol and provides several benefits for the maintenance of a field of CPEs:
Simplifies the initial configuration of a device during installation
Enables easy restoration of service after a factory reset or replacement of a faulty device
Firmware and software version management
Diagnostics and monitoring
Note:
You must have your own compatible ACS infrastructure to use TR-069.
In order to access and configure the TR-069 settings you must be logged into the router as the root user.
TR-069 configuration
To configure TR-069:
1. Click the Enable TR-069 toggle key to switch it to the ON position.
2. In the ACS URL field, enter the Auto Configuration Server’s full domain name or IP address.
3. Use the ACS username field to specify the username for the Auto Configuration Server.
4. In the ACS password and Verify ACS password fields, enter the Auto Configuration Server password.
5. In the Connection request username field, enter the username to use for the connection requests.
6. In the Connection request password and Verify password fields, enter the connection request password.
7. The inform message acts as a beacon to inform the ACS of the existence of the router. Click the Enable periodic ACS
informs toggle key to turn on the periodic ACS inform messages.
8. In the Inform period field, enter the number of seconds between the inform messages.
9. Click the Save button to save the settings.
Vodafone MachineLink 3G
www.netcommwireless.com
69
Figure 77 - TR-069 configuration
Vodafone MachineLink 3G
70
www.netcommwireless.com
SMS Diagnostics and Commands
SMS messaging
The MachineLink 3G offers an advanced SMS feature set, including sending messages, receiving messages, redirecting incoming messages to another destination, as well as supporting remote commands and diagnostics messages.
Some of the functions supported include:
Ability to send a text message via a 2G/3G network and store it in permanent storage.
Ability to receive a text message via a 2G/3G network and store it in permanent storage.
Ability to forward incoming text messages via a 3G network to another remote destination which may be a TCP/UDP server or other mobile devices.
Ability to receive run-time variables from the device (e.g. uptime) on request via SMS
Ability to change live configuration on the device (e.g. connection APN) via SMS.
Ability to execute supported commands (e.g. reboot) via SMS
Ability to trigger the MachineLink 3G to download and install a firmware upgrade
Ability to trigger the MachineLink 3G to download and apply a configuration file
To access the SMS messaging functions of the MachineLink 3G, click on the select one of the options under the
SMS messaging section on the left hand menu.
Setup
The Setup page provides the options to enable or disable the SMS messaging functionality and SMS forwarding functionalities of the router. SMS messaging is enabled by default.
Services menu item from the top menu bar, and then
Figure 78 - SMS Function Setup
Vodafone MachineLink 3G
www.netcommwireless.com
71
General SMS configuration
SMS forwarding configuration
OPTION DEFINITION
SMS messaging Toggles the SMS functionality of the router on and off.
Messages per page (10-50) The number of SMS messages to display per page. Must be a value between 10 and 50.
The encoding method used for outbound SMS messages. GSM 7-bit mode permits up to 160
Encoding scheme
SMSC address
Forwarding Toggles the SMS forwarding function of the router on and off.
Redirect to mobile Enter a mobile number as the destination for forwarded SMS messages.
TCP address
TCP port The TCP port on which to connect to the remote destination.
UDP address
UDP port The UDP port on which to connect to the remote destination.
characters per message but drops to 50 characters if the message includes special characters. UCS-2 mode allows the sending of Unicode characters and permits a message to be up to 50 characters in length.
The short message service centre (SMSC) address is the number of your mobile broadband SMS provider. The SMSC address is used when sending text messages and is stored on the SIM card. If the SMSC address field is blank, the router will not be able to send any SMS messages.
Enter an IP address or domain name as the destination for forwarded SMS messages using TCP.
Enter an IP address or domain name as the destination for forwarded SMS messages using UDP.
Table 15 - SMS Setup Settings
SMS forwarding configuration
Incoming text messages can be redirected to another mobile device and/or a TCP/UDP message server.
Redirect to mobile
You can forward incoming text messages to a different destination number. This destination number can be another mobile phone or a 3G router phone number.
For Example:
If someone sends a text message and
Redirect to mobile is set to “0412345678”, this text message is stored on the router
and forwarded to “0412345678” at the same time.
To disable redirection to a mobile, clear the
Redirect to mobile field and click the Save button.
Redirect to TCP / UDP address
You can also forward incoming text messages to a TCP/UDP based destination. The TCP or UDP server can be any kind of public or private server if the server accepts incoming text-based message.
The TCP/UDP address can be an IP address or domain name. The port number range is from 1 to 65535. Please refer to your TCP/UDP based SMS server configuration for which port to use.
For Example:
If someone sends a text message and TCP address is set to “192.168.20.3” and TCP port is set to “2002”, this text message is stored in the router and forwarded to “192.168.20.3” on port “2002” at the same time.
To disable redirection to a TCP or UDP address, clear the
TCP address and UDP address fields and click the Save button.
Vodafone MachineLink 3G
72
www.netcommwireless.com
New message
The New message page can be used to send SMS text messages to a single or multiple recipients.
Figure 79 - New SMS message
A new SMS message can be sent to a maximum of 100 recipients at the same time. After sending the message, the result is displayed next to the destination number as “Success” or “Failure” if the message failed to send. By default, only one destination number field is displayed. Additional destination numbers may be added one at a time after entering a valid number for the current
destination number field. To add a destination number, click the button and to remove the last destination in the list, click the
button.
International destination numbers should begin with the “+” symbol. To send a message to an international number, enter the “+” symbol followed by the international country code and then the destination number.
“+61412345678”.
After entering the required recipient numbers, type your SMS message in the counter shows how many characters you have entered out of the total number available for your chosen encoding scheme. When you have finished typing your message and you are ready to send it, click the Send button.
For example:
To send a message to a mobile destination number 0412345678 in Australia from a network outside of Australia, enter
To send a message to a mobile destination number 0412345678 in Australia from a network in Australia, you may enter either “+61412345678” or “0412345678”.
New message field. As you type your message, a
Vodafone MachineLink 3G
www.netcommwireless.com
73
Inbox / Outbox
The Inbox displays all received messages that are stored on the router while the Outbox displays all sent messages.
Figure 80 - SMS Inbox
ICON DEFINITION
Forward button. Click this button to open a new message window where you can forward the corresponding message to another recipient.
Reply button. Click this button to open a new message window where you can reply to the sender.
Add to White list. Click this button to add the sender’s mobile number to the white list on the router.
Delete button. Click this button to delete the corresponding message.
Refresh button. Click this button to refresh the inbox or outbox to see new messages.
Figure 81 - SMS Outbox
Table 16 - Inbox/Outbox icons
Vodafone MachineLink 3G
74
www.netcommwireless.com
Diagnostics
The Diagnostics page is used to configure the SMS diagnostics and command execution configuration. This enables you to change the configuration, perform functions remotely and check on the status of the router via SMS commands.
SMS diagnostics and command execution configuration
Figure 82 - SMS diagnostics and command execution configuration
The options on this page are described below.
Enable remote diagnostics and command execution
Enables or disables the remote diagnostics feature. If this setting is enabled all incoming text messages are parsed and tested for remote diagnostics commands.
If remote diagnostics commands are found, the router executes those commands. This feature is enabled by default. All remote diagnostic commands that are received are stored in the Inbox.
Note: It is possible to adjust settings and prevent your router from functioning correctly using remote diagnostics. If this occurs, you will need to perform a factory reset in order to restore normal operation.
It is highly recommended that you use the white list and a password when utilising this feature to prevent unauthorised access. See the
White list description for more information.
Only accept authenticated SMS messages
Enables or disables checking the sender’s phone number against the allowed sender white list for incoming diagnostics and command execution SMS messages.
If authentication is enabled, the router will check if the sender’s number exists in the white list. If it exists, the router then checks the password (if configured) in the incoming message against the password in the white list for the corresponding sending number. If they match, the diagnostic or command is executed.
If the number does not exist in the white list or the password does not match, the router does not execute the incoming diagnostic or command in the SMS message.
This is enabled by default and it is strongly advised that you leave this feature enabled to maintain security.
Vodafone MachineLink 3G
www.netcommwireless.com
75
Send command acknowledgment replies
Enables or disables sending an acknowledgment message after execution of a any acknowledgement after execution of a sent.
This can be useful to determine if a command was received and executed by the router. This option is disabled by default.
set
command. All acknowledgment replies are stored in the Outbox after they have been
set
command. If disabled the router does not send
Send acknowledgment replies to
This option allows you to specify where to send acknowledgment messages after the execution of a
If a fixed number is selected, the acknowledgement message will be sent to the number defined in the Fixed number to send replies to field. If the sender’s number is selected, the acknowledgement message will be sent to the number that the SMS diagnostic or command message originated from. The default setting is to use
the sender’s number.
set, or exec
command.
Fixed number to send replies to
This field defines the destination number to which acknowledgement messages are sent after the execution of a command.
set, or exec
Send command error replies
Enables or disables the sending of an error message resulting from the execution of a are stored in the Outbox after they have been sent.
If disabled, the router does not send any error notifications after the execution of a enabled by default.
get, set
get, set
, or
, or
exec
command. All error replies
exec
command. This function is
Send error replies to
This option allows you to specify where to send error messages from the execution of a
If a fixed number is selected, any error messages will be sent to the number defined in the fixed number to send error replies to
the sender’s number is selected, any error messages will be sent to the number that the SMS diagnostic or command
field. If message originated from. The default setting is to use
the sender’s number.
get, set, or exec
command.
Fixed number to send error replies to
This field defines the destination number to which error messages are sent after the execution of a
get, set, or exec
command.
Send a maximum of ___ replies per ___
You can set the maximum number of acknowledgement and error messages sent when an SMS diagnostic or command is executed. The maximum limit can be set per hour, day, week or month. The router will send a maximum of 100 replies by default.
The number of messages sent is shown below the options. The total transmitted message count resets after a reboot or at the beginning of the time frame specified.
Vodafone MachineLink 3G
76
www.netcommwireless.com
White list for diagnostic or execution SMS
The white list is a list of mobile numbers that you can create which are considered “friendly” to the router. If Only accept authenticated SMS messages is enabled in the diagnostics section, the router will compare the mobile number of all incoming diagnostic and command messages against this white list to determine whether the diagnostic or command should be executed. You may optionally configure a password for each number to give an additional level of security. When a password is specified for a number, the SMS diagnostic or command message is parsed for the password and will only be executed if the number and password match.
Figure 83 - White list for diagnostic or execution SMS
A maximum of 20 numbers can be stored on the router in the white list.
One blank entry is shown by default and you can add a number by clicking the “+Add” button. The White List numbers and passwords can be cleared by pressing the button to the right of each entry. To add a number to the white list, enter it in the
Destination number field and optionally define a password in the Password field. When you have finished adding numbers click the Save button to save the entries.
Vodafone MachineLink 3G
www.netcommwireless.com
77
Sending an SMS diagnostic command
Follow the steps below to configure the router to optionally accept SMS diagnostic commands only from authenticated senders and learn how to send SMS diagnostic commands to the router.
1. Navigate to the Services > SMS messaging > Diagnostics page
2. Confirm that the Enable remote diagnostics and command execution toggle key is set to the ON position. If it is set to OFF
click the toggle key to switch it to the
3. If you wish to have the router only accept commands from authenticated senders, ensure that Only accept authenticated
SMS messages is set to the ON position. This is the default setting. In the White list for diagnostic or execution SMS section, click the appears. If you wish to also configure a password, enter the password in the destination number.
If you would prefer to accept SMS diagnostic commands from any sender, set the Only accept authenticated SMS messages toggle key to the OFF position.
Note: An alternative method of adding a number to the white list is to send an SMS message to the router, navigate to Services > SMS messaging > Inbox and then click the button next to the message which corresponds to the sender’s number.
4. Click the Save button.
+Add button and enter the sender’s number in international format into the Destination number field that
ON position.
Password field corresponding to the
Types of SMS diagnostic commands
There are three types of commands that can be sent; execute, get and set. The basic syntax is as follows:
1. execute COMMAND
2. get VARIABLE
3. set VARIABLE=VALUE
If authentication is enabled, each command must be preceded by the password:
1. PASSWORD execute COMMAND
2. PASSWORD get VARIABLE
3. PASSWORD set VARIABLE=VALUE
The following are some examples of SMS diagnostic commands:
1. password6657 execute reboot
2. get rssi
3. set apn1=testAPNvalue
SMS Acknowledgment replies
The router automatically replies to get commands with a value and execute commands with either a success or error response. Set commands will only be responded to if the Send Set command acknowledgement replies toggle key is set to ON. If the Send command error replies toggle key is set to ON, the router will send a reply if the command is correct but a variable or value is incorrect, for example, due to misspelling.
Vodafone MachineLink 3G
78
www.netcommwireless.com
SMS Command format Generic Format for reading variables: get VARIABLE PASSWORD get VARIABLE
Generic Format for writing to variables: set VARIABLE=VALUE PASSWORD set VARIABLE=VALUE
Generic Format for executing a command: Execute COMMAND PASSWORD execute COMMAND
Replies Upon receipt of a successfully formatted, authenticated (if required) command, the gateway will reply to the SMS in the following
format:
TYPE SMS CONTENTS NOTES
get command “VARIABLE=VALUE”
set command “Successfully set VARIABLE to VALUE”
execute command “Successfully executed command COMMAND”
Table 17 - SMS Diagnostic Command Syntax
Only sent if the acknowledgment message function is enabled
Where “VARIABLE” is the name of the value to be read Where “VARIABLE (x)” is the name of another value to be read Where “VALUE” is the content to be written to the “VARIABLE” Where “COMMAND” is a supported command to be executed by the device (e.g. reboot) Where “PASSWORD” is the password (if configured) for the corresponding sender number specified in the White List
Multiple commands can be sent in the same message, if separated by a semicolon.
For Example:
get VARIABLE1; get VARIABLE2; get VARIABLE3 PASSWORD get VARIABLE1; get VARIABLE2 set VARIABLE=VALUE1 ; set VARIABLE2=VALUE2 PASSWORD set VARIABLE1=VALUE1; set VARIABLE2=VALUE2; set VARIABLE3=VALUE3
If required, values can also be bound by an apostrophe, double apostrophe or back tick.
For Example:
“set VARIABLE=’VALUE’” “set VARIABLE=”VALUE”” “set VARIABLE=`VALUE`” “get VARIABLE”
Vodafone MachineLink 3G
www.netcommwireless.com
79
A password (if required), only needs to be specified once per SMS, but can be prefixed to each command if desired.
“PASSWORD get Variable1”; “get VARIABLE2” “PASSWORD set VARIABLE1=VALUE1”; “set VARIABLE2=VALUE2”
If the command sent includes the “reboot” command and has already passed the white list password check, the device keeps this password and executes the remaining command line after the reboot with this same password.
For Example:
“PASSWORD execute reboot; getVariable1”; “get VARABLE2” “PASSWORD execute reboot; PASSWORD get Variable1”; “get VARABLE2”
Note: Commands, variables and values are case sensitive.
List of valid commands
A list of valid commands which can be used in conjunction with the execute command are listed below: “pdpcycle”, “pdpdown” and “pdpup” commands can have a profile number suffix ‘x’ added. Without the suffix specified, the
command operates against the default profile configured on the profile list page of the Web-UI.
# COMMAND NAME DESCRIPTION
1 reboot Immediately performs a soft reboot.
2 pdpcycle or pdpcyclex
3 pdpdown or pdpdownx
4 pdpup or pdpupx
5 factorydefaults Performs a factory reset on the router.
6 download
Disconnects (if connected) and reconnects the 3G connection. If a profile number is selected in the command, try to disconnect/reconnect the specified profile in case the profile is active. If no profile number is selected, try to disconnect/reconnect the current active profile. Reports an error if no profile number is selected and there is no currently activated profile.
Disconnects the PDP. If a profile number is selected in the command, the router tries to disconnect the specified profile in case the profile is active. If no profile number is selected, try to disconnect the current active profile. Reports an error if no profile number is selected and there is no currently activated profile.
Reconnects the PDP. If a profile number is selected in the command, the router tries to connect with the specified profile. If no profile number is selected, the router tries to connect to the last active profile. The gateway will check the currently activated profile and disconnect this profile before executing the command. The router reports an error if no profile number is selected and there is no stored last active profile number.
Performs a download and install of a Firmware Upgrade (.cdi), Config File (.tar.gz) or a help document (.pdf) file.
If the file is a firmware image as in the case of a .cdi file, the router will apply the recovery
image first and then the main firmware image. The download location is specified immediately after the command and may be from an http or ftp source.
If the file is a .tar.gz file, the router will apply the file as a configuration file update for the
device and reboot afterwards.
If the file is a .pdf, the router will assume this is a user guide document and save it to the
router and make the file available for viewing via the help menu on the Web-UI.
Table 18 - List of Valid SMS diagnostic commands
Vodafone MachineLink 3G
80
www.netcommwireless.com
The following table lists valid variables where “x” is a profile number (1-6). If no profile is specified, variables are read from or written to for the current active profile. If a profile is specified, variables are read from or written to for the specified profile number (‘x’).
# RDB VARIABLE NAME
link.profile.x.enable link.profile.x.apn link.profile.x.user
0
link.profile.x.pass link.profile.x.auth_type link.profile.x.iplocal link.profile.x.status
1 link.profile.x.apn apn or apnx RW APN internet
link.profile.x.user
2
link.profile.x.pass
3
4 link.profile.x.auth_type authtype or authtypex RW
link.profile.x.iplocal
5
6 wwan.0.radio.information.signal_strength rssi R 3G signal strength 65 dBm
wwan.0.imei
7
statistics.usage_current
8
statistics.usage_current
9
10 /proc/uptime deviceuptime R Device up time 1 days 02:30:12
wwan.0.system_network_status.current_ba
11
nd
SMS VARIABLE
NAME
profile or profilex
username or usernamex RW 3G username Guest, could also return “null”
password or passwordx RW 3G password Guest, could also return “null”
wanip or wanipx R WAN IP address 202.44.185.111
imei R IMEI number 359102128941027512
usage R
wanuptime R
band R Current 3G frequency WCDMA 850
Table 19 - List of SMS diagnostics variables
READ/ WRITE
RW Profile
DESCRIPTION EXAMPLE VALUE
3G Authentication type
3G data usage of current session
Up time of current 3G session
Read: (profile no,apn,user,pass,auth,iplocal,status) 1,internet,username,password,
chap,202.44.185.111,up
Write: (apn, user, pass,auth) internet,username,password
”pap” or”chap”
“Rx 500 bytes, Tx 1024 bytes, Total 1524 bytes” or “Rx 0 byte, Tx 0 byte, Total 0 byte” when wwan down
1 days 02:30:12 or 0 days 00:00:00 when wwan down
Network scan and manual network selection by SMS
Performing a network scan
The
get plmnscan SMS command enables you to perform a scan of the cellular networks available at the time of the scan.
It returns the following semi-colon separated information for each network in range:
MCC
MNC
Network Type (3G, 2G)
Provider's Name
Operator Status (available, forbidden, current)
The following is an example of a response from the
plmnscan:505,3,7,vodafone AU,4;505,3,1,vodafone AU,1;505,2,7,YES OPTUS,1;505,2,1,YES OPTUS,1;505,1,1,Telstra Mobile,1;505,1,7,Telstra Mobile,1
Vodafone MachineLink 3G
get plmnscan SMS command:
www.netcommwireless.com
81
NETWORK
TYPE
7 Indicates a 3G network
1 Indicates a 2G network
Table 20 - Network types returned by get plmnscan SMS command
DESCRIPTION
OPERATOR
STATUS
1 Indicates an available operator which may be selected.
2 Indicates a forbidden operator which may not be selected (applies only to generic SIM cards).
4 Indicates the currently selected operator.
Table 21 - Operator status codes returned by get plmnscan SMS command
DESCRIPTION
Notes about the network connection status when using the get plmnscan command:
If the connection status is
Up and connection mode is Always on, the get plmnscan SMS will cause the connection to disconnect, perform the scan, send the result through SMS and then bring the connection back up again. If the connection status is Down, the router will perform the PLMN scan, send the result and keep the connection status down.
If the connection status is
connection status to
Waiting and connection mode is Connect on demand, the get plmnscan SMS will change the
Down, perform the scan, send the result through SMS and then restore the connection status to the
Waiting state.
If the connection status is
Up and connection mode is Connect on demand, the get plmnscan SMS will cause the connection to disconnect, perform the scan, send the result through SMS, and then restore the connection status to the Waiting state unless there is a traffic which triggers a connection in which case the connection status will be set to Up.
Setting the router to connect to a network
The router can be instructed by SMS to connect to one of the networks returned by the get plmnscan command. The set forceplmn command forces the router to connect to a specified operator network (if available) while the
get forceplmn command retrieves the
currently configured network on the router.
Command format:
set forceplmn=0|MCC,MNC| MCC,MNC,Network Type
For example:
set forceplmn=0
Sets the selection of operator and network type to automatic mode.
set forceplmn=505,3
Sets the operator to a manual selection made by the user where “505” is the Mobile Country Code for Australia and “3” is the Mobile Network Code for Vodafone. As no network type (i.e. 3G or 2G) is specified, it is selected automatically.
set forceplmn=505,3,7
Sets the operator and network type to a manual selection made by the user where “505” is the Mobile Country Code for Australia, “3” is the Mobile Network Code for Vodafone and “7” is the 3G network type.
Vodafone MachineLink 3G
82
www.netcommwireless.com
Notes about the set forceplmn command:
1. If the manual selection fails, the device will fall back to the previous ‘good’ network.
2. When enabled, the SMS acknowledgement reply reflects the success or failure of the manual selection with respect to the
set
command and includes the final MNC/MCC that was configured.
Confirming the currently configured operator and network type
You can retrieve the currently configured operator and network type using the The
get forceplmn command returns the operator and network type selection mode (Automatic/Manual), in addition to the MCC
get forceplmn command.
and MNC values, for example:
Automatic,505,3
This response indicates that the operator/network selection mode is Automatic, and the network used is Vodafone AU.
SMS diagnostics examples
The examples below demonstrate various combinations of supported commands. This is not an exhaustive list and serves as an example of possibilities only.
DESCRIPTION AUTHENTICATION INPUT EXAMPLE
Not required
Send SMS to change APN
Required
Send SMS to change the 3G username
Send SMS to change the 3G password
Send SMS to change the 3G authentication
Send SMS to reboot
Send SMS to check the WAN IP address
Send SMS to check the 3G signal strength
Send SMS to check the IMEI number
Send SMS to check the current band
Send SMS to Disconnect (if disconnected) and reconnect the 3G connection
Send SMS to disconnect the 3G connection
Send SMS to connection the 3G connection
Send multiple get command
Send multiple set command Not required set apn1=”3netaccecss”; set password1=’NetComm’
Not required set username=’NetComm’
Required PASSWORD set username= ”NetComm”
Not required set password= `NetComm`
Required PASSWORD set password= `NetComm`
Not required set authtype= ‘pap’
Required PASSWORD set authtype = pap
Not required execute reboot
Required PASSWORD execute reboot
Not required get wanip
Required PASSWORD get wanip
Not required get rssi
Required PASSWORD get rssi
Not required get imei
Required PASSWORD get imei
Not required get band
Required PASSWORD get band
Not required execute pdpcycle
Required PASSWORD execute “pdpcycle1”
Not required execute pdpdown1
Required PASSWORD execute “pdpdown1”
Not required execute pdpup
Required PASSWORD execute pdpup1
Not required get wanip; get rssi
Required PASSWORD get wanip; get rssi
set apn1=internet set apn2=”access”
PASSWORD set apn1=internet PASSWORD set apn2=access
Vodafone MachineLink 3G
www.netcommwireless.com
83
Send SMS to reset to factory default settings
Send SMS to retrieve status of router
Send SMS to retrieve the history of the session, including start time, end time and total data usage
Send SMS to configure the router to send syslog to a remote syslog server
Send SMS to wake up the router, turn on the default gateway and trigger the ‘connect on demand’ profile if in waiting state.
Send SMS to retrieve MCC, MNC, network type, provider’s name and operator status
Send SMS to retrieve current network type selection mode, MNC and MCC values.
Send SMS to force connection to a specific operator and network type
Send SMS to reboot the router
Send SMS to perform firmware upgrade when firmware is located on HTTP server
Send SMS to perform firmware upgrade when firmware is located on FTP server
Send SMS to turn off PPPoE
Send SMS to turn on PPPoE and set APN and service name
Send SMS to retrieve the PPPoE status, currently configured APN and service name
Send SMS to set the default data connection profile
Send SMS to retrieve the currently configured default data connection profile
Send SMS to set the LED mode timeout to 10 minutes
Send SMS to retrieve the current LED mode
Required PASSWORD set APN=”3netaccecss”; set password=NetComm
Not required execute factorydefaults
Required PASSWORD execute factorydefaults
Not required get status
Required PASSWORD get status
Not required get sessionhistory
Required PASSWORD get sessionhistory
Not required set syslogserver
Required PASSWORD set syslogserver
Not required (zero SMS)
Required PASSWORD (zero SMS)
Not required get plmnscan
Required PASSWORD get plmnscan
Not required get forceplmn
Required PASSWORD get forceplmn
Not required set forceplmn=505,1,7
Required PASSWORD set forceplmn=505,1,7
Not required execute reboot
Required PASSWORD execute reboot
Not required
Required
Not required
Required
Not required set pppoe=0
Required PASSWORD set pppoe=0
Not required set pppoe=1,internet, Vodafone
Required PASSWORD set pppoe=1,internet, Vodafone
Not required get pppoe
Required PASSWORD get pppoe
Not required set defaultprofile=1
Required PASSWORD set defaultprofile=1
Not required get defaultprofile
Required PASSWORD get defaultprofile
Not required set ledmode=10
Required PASSWORD set ledmode=10
Not required get ledmode
Required PASSWORD get ledmode
Table 22 - SMS diagnostics example commands
execute download http://download.com:8080/firmware_image.cdi execute download http://download.com:8080/firmware_image_r.cdi
PASSWORD execute download
http://download.com:8080/firmware_image.cdi
PASSWORD execute download
http://download.com:8080/firmware_image_r.cdi
execute download ftp://username:password@download.com:8080/firmware_image.cdi
execute download ftp://username:password@ download.com:8080/firmware_image_r.cdi
PASSWORD execute download ftp://username:password@ download.com:8080/firmware_image.cdi
PASSWORD execute download ftp://username:password@ download.com:8080/firmware_image_r.cdi
Vodafone MachineLink 3G
84
www.netcommwireless.com
System
Log
The Log pages are used to display or download the System log and IPSec logs on the router.
System log
The System Log enables you to troubleshoot any issues you may be experiencing with your MachineLink 3G router.
Log data is stored in RAM and therefore, when the unit loses power or is rebooted it will lose any log information stored in RAM. To ensure that log information is accessible between reboots of the router there are two options:
1. Enable the Log to non-volatile memory option
2. Use a remote syslog server
Enable log to non-volatile memory When the router is configured to log to non-volatile memory, the log data is stored in flash memory, making it accessible after a
reboot of the router. Up to 512kb of log data will be stored before it is overwritten by new log data. Flash memory has a finite number of program-erase operations that it may perform to the blocks of memory. While this number of program-erase operations is quite large, we recommend that you do not enable this option for anything other than debugging to avoid excessive wear on the memory.
Use a remote syslog server The router can be configured to output log data to a remote syslog server. This is an application running on a remote computer
which accepts and displays the log data. Most syslog servers can also save the log data to a file on the computer on which it is running allowing you to ensure that no log data is lost between reboots.
To configure the MachineLink 3G to output log data to a remote syslog server:
1. Click on the System menu from the top menu bar. The System log item is displayed.
2. Click on the Administration settings item from the menu on the left.
3. Under the Remote syslog server section, enter the IP address or hostname of the syslog server in the IP / Hostname
[:PORT] field. You can also specify the port number after the IP or hostname by entering a semi-colon and then the port number e.g. 192.168.1.102:514. If you do not specify a port number, the router will use the default UDP port 514.
4. Click the Save button to save the configuration.
Log file
The Log to non-volatile memory option, when enabled, stores the log data in a file in flash memory making it available after a reboot. Use the To download the System log for offline viewing, right-click the
System log, click the therefore in order to be displayed correctly with new lines shown, it is recommended to use a text file viewer which displays this format correctly (e.g. Notepad++).
Display level drop-down list to select a message level to be displayed. The message levels are described in the table below.
Download button and choose Save as.. to save the file. To clear the
Clear button. The downloaded log file is in Linux text format with carriage return (CR) only at the end of a line,
Vodafone MachineLink 3G
www.netcommwireless.com
85
ITEM DEFINITION
All Display all system log messages. Debug Show extended system log messages with full debugging level details. Info Show informational messages only. Notice Show normal system logging information. Warning Show warning messages only. Error Show error condition messages only.
Figure 84 - System log
Table 23 - System log detai l levels
Vodafone MachineLink 3G
86
www.netcommwireless.com
IPSec log
The IPSec log section provides the ability for you to download the log for the IPSec VPN function. This can assist in troubleshooting any problems you may have with the IPSec VPN.
Use the you change the logging level, any active IPSec VPN tunnels will be disconnected as a change in logging level requires the IPSec service to be restarted.
To download the IPSec log, click the
Log level drop down list to specify the type of detail you want to capture in the log and then click the Save button. When
IPSec log download button and you will be prompted to save the file.
Figure 85 - IPSec log
Vodafone MachineLink 3G
www.netcommwireless.com
87
System configuration
Settings backup and restore
The settings backup and restore page is used to backup or restore the router’s configuration or to reset it to factory defaults. In order to view the settings page you must be logged into the web user interface as root using the password admin. The backup and restore functions can be used to easily configure a large number of MachineLink 3G Routers by configuring one router with your desired settings, backing them up to a file and then restoring that file to multiple MachineLink 3G Routers.
Figure 86 – Settings backup and restore
Back up your router’s configuration
Log in to the web configuration interface, click on the If you want to password protect your backup configuration files, enter your password in the fields under
settings and click on Save. If you don’t want to password protect your files, just click on Save. The router will then prompt you to select a location to save the settings file.
Note: The following conditions apply:-
It is NOT possible to edit the contents of the file downloaded; if you modify the contents of the configuration file in any way
you will not be able to restore it later. You may change the name of the file if you wish but the filename extension must remain as “.cfg”
Restore your backup configuration
In the web configuration interface click on the From the Click
will reboot - click on
Restoring the router’s factory default configuration
Click the factory default settings. If you wish to continue with the restoring of factory defaults, click
Restore saved settings section, click on Browse and select the backup configuration file on your computer.
Restore to copy the settings to the new Vodafone MachineLink 3G router. The router will apply these settings and inform you it
OK.
Restore defaults button to restore the factory default configuration. The router asks you to confirm that you wish to restore
Note: All current settings on the router will be lost when performing a restore of factory default settings. The device IP address will change to 192.168.1.1 and the default username
System System menu and select Settings backup and restore.
System menu and select Settings backup and restore.
Save a copy of current
OK.
root
and default password
admin
will be configured.
Vodafone MachineLink 3G
88
www.netcommwireless.com
Upload
The Upload page allows you to upload firmware files, HTTPS certificates or user created application packages to the Vodafone MachineLink 3G. When firmware files have been uploaded, they can also be installed from this page. PDF files, such as this user guide may also be uploaded for access on the router’s help page.
For more information on application development, contact NetComm Wireless about our Software Development Kit.
Figure 87 - Upload page
Updating the Firmware
The firmware update process involves first updating the recovery image firmware, rebooting into the recovery mode of the router and then updating the main firmware image.
Note: In order to perform an update, you must be logged into the router with the root manager account (see the
to the MachineLink 3G router section for more details).
To update the MachineLink 3G firmware:
1. Under the File uploads section, click the Browse button. Locate the recovery firmware image file on your computer and
click
Open.
2. Click the Upload button. The recovery firmware image is uploaded to the storage on the router.
Logging on
Vodafone MachineLink 3G
www.netcommwireless.com
89
Figure 88 - File upload
The recovery firmware image is listed in the firmware image and then click
OK on the confirmation window that appears.
Uploaded files section. Click the Install link to begin installing the recovery
Figure 89 - Uploaded files
3. The recovery firmware image is flashed and when it is complete, the router displays “The firmware update was successful”
and returns to the main Upload screen.
4. Press and hold the reset button on the interface panel of the router for between 5 and 15 seconds until the all LEDs on the
front of the router start to flash on and off then release it. The router boots into the system recovery mode.
5. When the router has finished booting, navigate to http://192.168.1.1/ in your web browser. The router recovery console is
displayed.
Figure 90 - Recovery firmware flash process
Vodafone MachineLink 3G
90
www.netcommwireless.com
6.
Figure 91 - MachineLink 3G Recovery console banner
7. Click the Application installer link from the menu bar at the top then click the Browse button. Locate the main firmware
image file on your computer and click
Open. Click the Upload button to begin the firmware upload.
Figure 92 - Recovery console - Upload main firmware image
8. When the upload has completed, the screen refreshes to display the list of files on the router’s storage. Click the Install link
to the right of the main firmware image you uploaded and then click
OK to confirm that you want to continue with the
installation.
9. The installation is complete when you see the words “Done” as per the screenshot below.
Figure 93 - Recovery console – installing main firmware image
10. Click the Reboot menu item from the top menu bar then click the Reboot button. Click OK to confirm the reboot of the
router. The MachineLink 3G router boots up with the updated firmware.
Vodafone MachineLink 3G
www.netcommwireless.com
91
Software applications manager
The Software applications manager page is used to provide details of any user installed packages on the router and allow them to be uninstalled.
For more information on application development, contact NetComm Wireless about our Software Development Kit.
The Application name, Version number of the application, the architecture type and time of installation are all displayed. Clicking the Package details link will display a pop-up window with further details of the package.
To uninstall any software applications, click the Uninstall link.
Figure 94 – Software applications manager
Vodafone MachineLink 3G
92
www.netcommwireless.com
Administration settings
The Administration settings page is used to enable or disable the firewall, remote access control, telnet access, ping responses and logging to a remote syslog server.
Figure 95 - Administration page
Vodafone MachineLink 3G
www.netcommwireless.com
93
Router firewall
Remote router access control
Web User Interface account
root
admin
Telnet account
root
Remote syslog server
LED operation mode
Always on
Turn off after timeout
OPTION DEFINITION
Enable router firewall Enable or disable the in-built firewall on the router.
Enable HTTP Enable or disable remote HTTP access to the router. You can also set the port you would like remote HTTP access to be available on.
HTTP management port
Enable HTTPS Enable or disable remote HTTPS access to the router using a secure connection.
Remote HTTPS access port
Enable Telnet Enable or disable remote telnet (command line) access to the router.
Enable Ping Enable or disable remote ping responses on the WWAN connection.
Enter a port number between 1 and 65534 to use when accessing the router remotely.
Enter a port number between 1 and 65534 to use when accessing the router remotely over an HTTPS connection.
Username Use the drop down list to select the
Password Enter the desired web user interface password.
Confirm Password Re-enter the desired web user interface password.
Username Always displays
Password Enter the desired telnet access password.
Confirm Password Re-enter the desired telnet access password.
IP / Hostname [:PORT]
Mode
LED power off timer
Enter the IP address or hostname of the syslog server. You can also specify the port number after the IP or hostname by entering a semi-colon and then the port number e.g. 192.168.1.102:514. If you do not specify a port number, the router will use the default UDP port 514.
Sets the operation mode of the LEDs on the front panel of the router. To set the lights to operate at all times, set this to set the lights to turn off after a specified period, select
Specify the time in minutes to wait before the LEDs turn off. The valid values for this timer are 1 to 65535. This wait period begins from the time the save button is clicked. When the wait period expires, the LEDs will turn off. If the router is rebooted when the LEDs are off, the LEDs will turn on during the boot sequence and turn off again when the router has completed its boot sequence.
as this is the only account that can be used to access the router using telnet.
Table 24 - Administration configuration options
or
account to change its web user interface password.
.
To access the router’s configuration pages remotely:
1. Open a new browser window and navigate to the WAN IP address and assigned port number of the router, for example
http://123.209.130.249:8080
Note: You can find the router’s WAN IP address by clicking on the ”Status” menu. The Local field in the WWAN section shows the router’s WAN IP address.
2. Enter the username and password to login to the router and click Log in.
Note: To perform functions like Firmware upgrade, device configuration backup and to restore and reset the router to factory defaults, you must be logged in with the root manager account.
. To
Vodafone MachineLink 3G
94
www.netcommwireless.com
Reboot
The reboot option in the System section performs a soft reboot of the router. This can be useful if you have made configuration changes you want to implement.
To reboot the router:
1. Click the System menu item from the top menu bar.
2. Click the Reboot button from the menu on the left side of the screen.
Figure 96 - Reboot menu option
3. The router displays a warning that you are about to perform a reboot. If you wish to proceed, click the Reboot button then
click
OK on the confirmation window which appears.
Figure 97 - Reboot confirmation
Note: It can take up to 2 minutes for the router to reboot.
Logging out
To log out of the router, click the icon at the top right corner of the web user interface.
Vodafone MachineLink 3G
www.netcommwireless.com
95
Appendix A: Tables
Table 1 - Document Revision History ........................................................................................................................... 2
Table 2 - Device Dimensions ......................................................................................................................................... 7
Table 3 - LED Indicators ................................................................................................................................................ 8
Table 4 - Signal strength LED descriptions .................................................................................................................... 9
Table 5 - Interfaces ..................................................................................................................................................... 10
Table 6 - PoE power classes ........................................................................................................................................ 16
Table 7 - Locking power block pin outs ...................................................................................................................... 16
Table 8 - Average power consumption figures ........................................................................................................... 17
Table 9 - Management account login details ............................................................................................................. 18
Table 10 - Status page item details............................................................................................................................. 20
Table 11 - Data connection item details ..................................................................................................................... 22
Table 12 - Connect on demand - Connect and disconnect timers descriptions ......................................................... 30
Table 13 - Current MAC / IP / Port filtering rules in effect ......................................................................................... 47
Table 14 - IPSec Configuration Items .......................................................................................................................... 51
Table 15 - SMS Setup Settings .................................................................................................................................... 71
Table 16 - Inbox/Outbox icons ................................................................................................................................... 73
Table 17 - SMS Diagnostic Command Syntax ............................................................................................................. 78
Table 18 - List of Valid SMS diagnostic commands .................................................................................................... 79
Table 19 - List of SMS diagnostics variables ............................................................................................................... 80
Table 20 - Network types returned by get plmnscan SMS command ........................................................................ 81
Table 21 - Operator status codes returned by get plmnscan SMS command ............................................................ 81
Table 22 - SMS diagnostics example commands ........................................................................................................ 83
Table 23 - System log detail levels .............................................................................................................................. 85
Table 24 - Administration configuration options ....................................................................................................... 93
Table 25 - LAN Management Default Settings ........................................................................................................... 98
Table 26 - Web Interface Default Settings.................................................................................................................. 98
Table 27 - Telnet Access ............................................................................................................................................. 98
Table 28 - RJ-45 connector pin outs ......................................................................................................................... 105
Vodafone MachineLink 3G
96
www.netcommwireless.com
Appendix B: Device Mounting Dimensions
The image below is at 100% scale and may be used as a template for mounting the device. All dimensions shown are in millimetres.
Vodafone MachineLink 3G
Figure 98 - Device mounting dimensions
www.netcommwireless.com
97
Appendix C: Mounting Bracket
The image below is at 100% scale and may be used as a template for mounting the bracket. All dimensions shown are in millimetres.
Figure 99 - Mounting bracket
Vodafone MachineLink 3G
98
www.netcommwireless.com
Appendix D: Default Settings
The following tables list the default settings for the Vodafone MachineLink 3G.
LAN (MANAGEMENT)
Static IP Address: 192.168.1.1
Subnet Mask: 255.255.255.0
Default Gateway: 192.168.1.1
Table 25 - LAN Management Default Settings
Note: The admin manager account allows you to manage all settings of the router except functions such as firmware upgrade, device configuration backup and restore and reset to factory default settings, which are privileged only to the root manager account.
ADMIN MANAGER
ACCOUNT
Username: admin Username: root
Password: admin Password: admin
Table 26 - Web Interface Default Settings
VODAFONE MACHINELINK 3G TELNET
ACCESS
Username: root
Password: admin
Table 27 - Telnet Access
ROOT MANAGER
ACCOUNT
Vodafone MachineLink 3G
www.netcommwireless.com
99
Restoring factory default settings
Restoring factory defaults will reset the Vodafone MachineLink 3G to its factory default configuration. You may encounter a situation where you need to restore the factory defaults on your Vodafone MachineLink 3G such as:
You have lost your username and password and are unable to login to the web configuration page;
You are asked to perform a factory reset by support staff.
There are two methods you can use to restore factory default settings on your Vodafone MachineLink 3G:
Using the web-based user interface
Using the reset button on the interface panel of the router
Using the web-based user interface
To restore your router to its factory default settings, please follow these steps:
1. Open a browser window and navigate to the IP address of the router (default address is http://192.168.1.1). Login to the
router using
2. Click the System item from the top menu bar, then System configuration on the left menu and then click Settings backup
and restore.
3. Under the Restore factory defaults section, click the Restore defaults button. The router asks you to confirm that you wish
to restore factory defaults. Click
4. When the Power light returns to a steady red, the reset is complete. The default settings are now restored.
Using the reset button on the interface panel of the router
Use a pen to depress the Reset button on the device for 15-20 seconds. The router will restore the factory default settings and reboot.
When you have reset your Vodafone MachineLink 3G Router to its default settings you will be able to access the device’s configuration web interface using
root
as the User Name and
admin
as the password.
OK to continue. The router sets all settings to default. Click OK again to reboot the router.
http://192.168.1.1 with username admin or root and password admin.
Vodafone MachineLink 3G
100
www.netcommwireless.com
Recovery mode
The Vodafone MachineLink 3G features two independent operating systems, each with its own file systems. These two systems are referred to as 'Main' and 'Recovery'. It is always possible to use one in order to restore the other in the event that one system becomes damaged or corrupted (such as during a firmware upgrade failure).
Both systems have Web interfaces that can be used to manipulate the other inactive system. The MachineLink 3G starts up by default in the Main system mode, however the router may be triggered to start in recovery mode if desired.
To start the router in recovery mode:
1. Press and hold the physical reset button on the interface panel of the router for 5 to 15 seconds. When the LEDs on the
front panel change to amber and countdown in a sequence, release the reset button. The router then boots into recovery mode.
2. In your browser, navigate to
of the IP address that was configured in the main system. The router’s recovery console is displayed.
http://192.168.1.1. The router’s recovery mode is hardcoded to use this address regardless
Figure 100 - Recovery console
The recovery console provides limited functionality. Basic status information is available, as well as access to the System log for troubleshooting. The Application Installer can be used to upload and install different firmware, allowing you to roll back to a previous firmware in the event that an upgrade fails. The Settings menu provides the ability to reset the router to factory default settings and the Reboot tab allows you to perform a soft reboot of the router.
Vodafone MachineLink 3G
Loading...