virtual access GW2021 User manual

GW2020 Series User Manual
Issue:
2.3
Date:
08 May 2015

Table of Contents
_______________________________________________________________________________________________________
1Introduction ...............................................................................................10
1.1 Document scope ..................................................................................... 10
2GW2020 Series hardware ...........................................................................11
2.1 Hardware specification............................................................................. 11
2.1.1 GW2020 series router model variants.................................................. 11
2.2 Hardware features .................................................................................. 11
2.3 Serial ports ............................................................................................ 11
2.3.1 Serial ports on the GW2020 series ...................................................... 12
2.3.1.1 RS232 pinout for the GW2020 ..................................................................................12
2.3.1.2 RS485 pinout for the GW2020 ..................................................................................12
2.3.2 Serial ports on the GW2024P.............................................................. 12
2.3.2.1 RS232 pinout for the GW2024P ................................................................................13
2.3.2.2 RS485 pinout for the GW2024P ................................................................................13
2.3.3 Serial ports on the GW2028 series ...................................................... 13
2.3.3.1 RS232 pin-out for the GW2028.................................................................................13
2.3.3.2 RS485 pin-out for the GW2028.................................................................................14
2.4 GSM technology...................................................................................... 14
2.5 Power supply.......................................................................................... 14
2.5.1 GW2020 series................................................................................. 14
2.5.2 GW2024P series ............................................................................... 14
2.5.3 GW2028 series................................................................................. 14
2.6 Router dimensions .................................................................................. 15
2.7 Compliance ............................................................................................ 15
2.8 Operating temperature range ................................................................... 15
2.9 Antenna................................................................................................. 16
2.10 Components........................................................................................... 16
2.10.1 GW2020 Series components............................................................... 16
2.10.2 GW2024P components....................................................................... 17
2.10.3 GW2028 components ........................................................................ 17
2.11 Inserting the SIM cards ........................................................................... 17
2.12 Connecting the SIM lock .......................................................................... 18
2.13 Connecting cables................................................................................... 18
2.14 Connecting the antenna........................................................................... 18
2.15 Powering up the GW2020......................................................................... 18
2.16 Powering up the GW2024P....................................................................... 18
2.17 Reset button .......................................................................................... 19
3GW2020 Series LED behaviour....................................................................20
3.1 Main LED behaviour................................................................................. 20
3.2 Ethernet port LED behaviour .................................................................... 21
_______________________________________________________________________________________________________
© Virtual Access 2015
GW2020 Series User Manual
Issue: 2.3 Page 2 of 264

Table of Contents
_______________________________________________________________________________________________________
4GW2024P Series LED behaviour..................................................................22
5GW2028 Series LED behaviour....................................................................23
5.1 Main LED behaviour................................................................................. 23
5.2 Ethernet port LED behaviour .................................................................... 24
6Factory configuration extraction from SIM card .........................................25
7Accessing the router...................................................................................26
7.1 Over Ethernet......................................................................................... 26
7.2 Over a 3G or 4G interface ........................................................................ 26
8Upgrading router firmware.........................................................................27
8.1 Upgrading firmware using the web interface............................................... 27
8.2 Upgrading firmware using CLI .................................................................. 29
9File system .................................................................................................30
9.1 Configurations........................................................................................ 30
9.1.1 High level configuration commands..................................................... 30
9.1.2 Configuration file syntax.................................................................... 31
9.1.3 Command line utility ......................................................................... 32
9.1.3.1 Command line utility examples.................................................................................34
9.1.4 Configuration copying and deleting ..................................................... 35
9.1.5 Image files....................................................................................... 35
9.1.6 Viewing files..................................................................................... 35
9.1.7 Copying files .................................................................................... 36
9.1.8 Editing files...................................................................................... 37
9.1.9 Processes and jobs............................................................................ 37
9.1.10 System information........................................................................... 37
10 Command Line Interface ............................................................................39
10.1 Basics.................................................................................................... 39
10.2 Unified Configuration Interface (UCI)......................................................... 41
10.3 Configuration files................................................................................... 45
10.4 Configuration file syntax .......................................................................... 45
10.5 Examples............................................................................................... 46
10.5.1 Export an entire configuration ............................................................ 47
10.5.2 Display just the value of an option ...................................................... 47
11 Management configuration settings ...........................................................48
11.1 Autoload - boot up activation.................................................................... 48
11.2 Httpclient - Activator configuration............................................................ 50
11.3 System settings...................................................................................... 53
11.3.1 Configuring a router’s host name........................................................ 53
11.4 User management................................................................................... 56
11.4.1 Configuration file: config user............................................................. 56
11.4.2 UCI export and UCI show commands................................................... 58
_______________________________________________________________________________________________________
© Virtual Access 2015
GW2020 Series User Manual
Issue: 2.3 Page 3 of 264

Table of Contents
_______________________________________________________________________________________________________
11.5 Interfaces configuration........................................................................... 59
11.5.1 Interfaces ........................................................................................ 59
11.5.2 Options valid for all protocol types ...................................................... 60
11.5.3 Protocol "static"................................................................................ 61
11.5.4 Protocol "dhcp"................................................................................. 61
11.5.5 Protocol "3g" (PPP over EV-DO, CDMA, UMTS or GRPS) ......................... 61
11.5.6 Protocol "l2tp" (layer 2 tunneling protocol)........................................... 62
11.5.7 Aliases............................................................................................. 62
12 DHCP server and DNS configuration ...........................................................65
12.1 Common options section.......................................................................... 65
12.2 DHCP pools ............................................................................................ 69
12.3 Static leases........................................................................................... 71
13 VLAN configuration.....................................................................................72
13.1 VLAN web interface ................................................................................. 72
13.2 VLAN definition....................................................................................... 72
13.3 Port description ...................................................................................... 73
13.4 VLANs UCI interface ................................................................................ 74
13.4.1 config port ....................................................................................... 76
13.4.2 config vlan....................................................................................... 76
13.4.3 Config nat vlan................................................................................. 76
14 Static routes configuration .........................................................................77
14.1 IPv4 routes ............................................................................................ 77
14.2 IPv6 routes ............................................................................................ 78
15 BGP (Border Gateway Protocol)..................................................................80
15.1 Configuring the BGP web interface ............................................................ 80
15.2 Optionally configure BGP route map .......................................................... 81
15.3 Configure BGP neighbours........................................................................ 82
15.4 Routes statistics ..................................................................................... 82
15.5 BGP UCI interface ................................................................................... 83
16 Configuring WiFi.........................................................................................86
16.1 Configuring WiFi through the web interface ................................................ 86
16.2 Configuring WiFi in AP mode on an existing Ethernet interface...................... 86
16.3 Configuring WiFi in AP mode on a new interface.......................................... 90
16.4 Configuring WiFi in client mode................................................................. 95
16.5 Configuring WiFi via UCI .......................................................................... 99
16.5.1 Configuring Wi-Fi in AP mode on an existing Ethernet interface .............. 99
16.5.2 Configuring WiFI on a new interface.................................................. 101
16.6 Configuring WiFi in client mode............................................................... 103
17 Configuring a 3G/4G connection...............................................................105
18 Configuring SMS .......................................................................................108
_______________________________________________________________________________________________________
© Virtual Access 2015
GW2020 Series User Manual
Issue: 2.3 Page 4 of 264

Table of Contents
_______________________________________________________________________________________________________
18.1 Monitoring SMS .................................................................................... 109
18.2 Outgoing messages............................................................................... 109
19 Configuring Multi-WAN .............................................................................110
19.1 Multi-WAN web interface........................................................................ 110
19.2 Multi-WAN UCI interface ........................................................................ 113
20 Automatic operator selection....................................................................116
20.1 Introduction to automatic operator selection ............................................ 116
20.2 Configuring automatic operator selection ................................................. 116
20.3 Configuring automatic operator selection via the web interface................... 116
20.3.1 PMP + roaming: pre-empt enabled.................................................... 116
20.3.1.1 Creating primary predefined interface ...............................................................117
20.3.1.2 Setting multi-WAN options for primary predefined interface............................119
20.3.1.3 Setting options for automatically created interfaces .........................................121
20.3.2 PMP + roaming: pre-empt disabled................................................... 126
20.3.3 Roaming: no PMP defined ................................................................ 127
20.3.4 Disable roaming.............................................................................. 128
21 Configuring IPSec.....................................................................................129
21.1 Common settings.................................................................................. 129
21.2 Connection settings............................................................................... 130
21.3 Shunt connection.................................................................................. 134
21.4 Secret settings ..................................................................................... 134
22 Configuring firewall..................................................................................137
22.1 Defaults section.................................................................................... 137
22.2 Zones section....................................................................................... 137
22.3 Forwarding sections .............................................................................. 138
22.4 Redirects ............................................................................................. 139
22.5 Rules................................................................................................... 140
22.6 Includes............................................................................................... 141
22.7 IPv6 notes ........................................................................................... 141
22.8 Implications of DROP vs. REJECT ............................................................ 142
22.9 Note on connection tracking................................................................... 143
22.10 Firewall examples .............................................................................. 143
22.10.1 Opening ports ............................................................................. 143
22.10.2 Forwarding ports (destination NAT/DNAT)....................................... 143
22.10.3 Source NAT (SNAT)...................................................................... 144
22.10.4 True destination port forwarding.................................................... 145
22.10.5 Block access to a specific host ....................................................... 145
22.10.6 Block access to the internet using MAC........................................... 145
22.10.7 Block access to the internet for specific IP on certain times............... 145
22.10.8 Restricted forwarding rule............................................................. 146
_______________________________________________________________________________________________________
© Virtual Access 2015
GW2020 Series User Manual
Issue: 2.3 Page 5 of 264

Table of Contents
_______________________________________________________________________________________________________
22.10.9 Transparent proxy rule (same host) ............................................... 146
22.10.10 Transparent proxy rule (external) .................................................. 146
22.10.11 Simple DMZ rule.......................................................................... 147
22.10.12 IPSec passthrough....................................................................... 147
22.10.13 Manual iptables rules.................................................................... 148
22.11 Firewall management ......................................................................... 148
22.12 Debug generated rule set.................................................................... 149
23 Configuring SNMP.....................................................................................150
23.1 agent .................................................................................................. 150
23.2 system ................................................................................................ 151
23.3 com2sec .............................................................................................. 151
23.4 access ................................................................................................. 154
23.5 SNMP traps .......................................................................................... 155
24 Configuring HTTP server...........................................................................156
24.1 Server settings ..................................................................................... 156
24.2 HTTPS certificate settings and creation .................................................... 158
24.3 Basic authentication (httpd.conf) ............................................................ 159
24.4 Securing uHTTPd .................................................................................. 160
24.5 SSH server configuration ....................................................................... 160
25 Virtual Router Redundancy Protocol (VRRP) ............................................161
25.1 Software versions ................................................................................. 161
25.2 VRRP web interface............................................................................... 162
25.3 Configuring VRRP using UCI ................................................................... 165
26 Multicasting using PIM and IGMP interfaces.............................................167
26.1 Configuring PIM and IGMP via the web interface ....................................... 167
26.2 PIM and IGMP UCI interface ................................................................... 169
27 Dynamic Multipoint Virtual Private Network (DMVPN) .............................171
27.1 The advantage of using DMVPN .............................................................. 171
27.2 DMVPN scenarios .................................................................................. 171
27.3 Configuring DMVPN via the web interface................................................. 173
27.3.1Configuring IPSec for DMVPN ........................................................... 174
27.4 DMVPN hub settings.............................................................................. 180
27.5 UCI interface........................................................................................ 181
27.5.1 IPSec configuration using CLI........................................................... 181
27.6 Configuring DMVPN using CLI................................................................. 183
28 Terminal Server ........................................................................................185
28.1 Introduction ......................................................................................... 185
28.2 Terminal Server interfaces ..................................................................... 185
28.3 Configuring Terminal Server................................................................... 185
28.3.1 Configuring Terminal Server using the web interface ........................... 185
_______________________________________________________________________________________________________
© Virtual Access 2015
GW2020 Series User Manual
Issue: 2.3 Page 6 of 264

Table of Contents
_______________________________________________________________________________________________________
28.3.1.1 Main settings.......................................................................................................185
28.3.1.2 Port settings ........................................................................................................186
28.3.1.3 Port settings: general section .............................................................................186
28.3.1.4 Port settings: serial section.................................................................................188
28.3.1.5 Port settings: network section ............................................................................190
28.4 Configuring Terminal Server using UCI .................................................... 192
28.5 Terminal Server operation...................................................................... 202
28.5.1 General ......................................................................................... 202
28.5.2 Starting Terminal Server.................................................................. 202
28.5.3 Checking the status of Terminal Server ............................................. 202
28.5.4 Stopping Terminal Server ................................................................ 203
29 GRE interfaces ..........................................................................................204
29.1 GRE web interface................................................................................. 204
29.2 GRE UCI interface ................................................................................. 206
30 Configuring a COSEM HDLC Bridge............................................................208
30.1 COSEM HDLC web interface.................................................................... 208
30.2 Checking the status of COSEM HDLC Bridge ............................................. 209
31 Event system ............................................................................................210
31.1 Implementation of the event system ....................................................... 210
31.2 Supported events.................................................................................. 210
31.3 Supported targets................................................................................. 210
31.4 Supported connection testers ................................................................. 211
31.5 Configuring the event system via the web interface................................... 211
31.6 Configuring the event system via UCI...................................................... 211
31.6.1 Main section................................................................................... 211
31.6.2 Forwardings ................................................................................... 212
31.6.3 Connection testers.......................................................................... 212
31.6.3.1 Ping connection tester ........................................................................................213
31.6.3.2 Link connection tester.........................................................................................213
31.6.4 Supported targets........................................................................... 214
31.6.4.1 Syslog target........................................................................................................214
31.6.4.2 Email target.........................................................................................................215
31.6.4.3 SNMP target ........................................................................................................216
31.6.4.4 Exec target ..........................................................................................................216
31.6.5 Example and export ........................................................................ 217
32 Configuring SLA reporting on Monitor.......................................................223
32.1 Introduction ......................................................................................... 223
32.2 Configuring SLA reporting ...................................................................... 223
_______________________________________________________________________________________________________
© Virtual Access 2015
GW2020 Series User Manual
Issue: 2.3 Page 7 of 264

Table of Contents
_______________________________________________________________________________________________________
32.2.1 Configuring a content template......................................................... 223
32.3 Adding an SLA report ............................................................................ 226
32.4 Viewing an SLA report ........................................................................... 228
32.5 Viewing automated SLA reports.............................................................. 229
32.6 Configuring router upload protocol .......................................................... 230
33 Configuring SLA for a router.....................................................................231
33.1 Configuring SLA for a router via the web interface..................................... 231
33.2 Configuring SLA for a router via UCI interface........................................... 233
33.3 SLA statistics........................................................................................ 234
34 Diagnostics...............................................................................................236
34.1 ADSL diagnostics .................................................................................. 236
34.1.1 ADSL PPPoA connections.................................................................. 236
34.1.2 ADSL PPPoEoA connections .............................................................. 236
34.1.3 ADSL bridge connections ................................................................. 237
34.2 ALL diagnostics..................................................................................... 238
34.3 Automatic operator selection diagnostics via the web interface ................... 239
34.3.1 Checking the status of the Multi-WAN package ................................... 239
34.4 Automatic operator selection diagnostics via UCI ...................................... 240
34.5 CESoPSN diagnostics............................................................................. 242
34.5.1 cesop show config........................................................................... 242
34.5.2 cesop show status........................................................................... 244
34.5.3 cesop show stats ............................................................................ 244
34.5.4 cesop clear stats............................................................................. 245
34.6 DMVPN diagnostics................................................................................ 246
34.7 File system diagnostics.......................................................................... 248
34.8 Firewall diagnostics............................................................................... 249
34.8.1 IP tables........................................................................................ 252
34.8.2 Debug ........................................................................................... 252
34.9 GPS diagnostic commands ..................................................................... 253
34.10 Interfaces diagnostics......................................................................... 253
34.10.1 Interfaces status.......................................................................... 253
34.10.2 Route status................................................................................ 254
34.10.3 Mobile status............................................................................... 254
34.10.4 ADSL status ................................................................................ 255
34.11 ISDN pseudowire diagnostics............................................................... 256
34.11.1 Packages .................................................................................... 256
34.11.2 Asterisk CLI diagnostics................................................................ 257
34.11.3 ISDN LED status.......................................................................... 258
34.12 IPSec diagnostics............................................................................... 258
34.13 Multi-WAN diagnostics........................................................................ 259
_______________________________________________________________________________________________________
© Virtual Access 2015
GW2020 Series User Manual
Issue: 2.3 Page 8 of 264

Table of Contents
_______________________________________________________________________________________________________
34.14 PAD diagnostics................................................................................. 260
34.14.1 Showing Log ............................................................................... 260
34.14.2 Debugging guidelines................................................................... 261
34.15 Terminal Server diagnostics ................................................................ 262
34.16 VRRP diagnostics ............................................................................... 263
34.16.1 VRRP diagnostics web interface ..................................................... 263
34.16.2 VRRP diagnostics using the command line interface ......................... 263
34.17 Diagnostics for WiFi AP mode .............................................................. 264
34.18 Diagnostics for WiFi client mode .......................................................... 264
_______________________________________________________________________________________________________
© Virtual Access 2015
GW2020 Series User Manual
Issue: 2.3 Page 9 of 264

1: Introduction
_______________________________________________________________________________________________________
1Introduction
This user manual describes the features and how to configure a Virtual Access
GW2020 Series router.
The Virtual Access GW2020 Series router is a versatile 3G/4G LTE/CDMA450
wireless router suitable for a variety of business and industrial deployments. The
compact and rugged structure makes it a suitable product for deployments in
M2M applications such as CCTV, ATM, telemetry, SCADA, retail (POS), digital
signage, and intelligent traffi c systems. The product line supports the following
radio access technologies: HSPA+, HSPA, UMTS, EDGE, CDMA450, GPRS and
GSM.
3G is the third generation of mobile phone standards and technology. It is based
on the International Telecommunication Union (ITU) family of standards under
the International Mobile Telecommunications programme, IMT-2000.
4G is a mobile communications standard intended to replace 3G, allowing
wireless internet access at a much higher speed.
3G and 4G technologies enable network operators to offer users a wider range of
more advanced services, while achieving greater network capacity through
improved spectral effiecieny. Services include wide-area wireless voice
telephony, video calls, and broadband wireless data, all in a mobile environment.
1.1 Document scope
This document covers the following models in the GW2020 Series.
GW2021:
Single Ethernet and 3G, 4G/LTE
GW2022: Dual Ethernet and 3G, 4G/LTE
GW2023: Dual Ethernet, 3G, 4G/LTE and dual RS232
GW2024: Dual Ethernet, 3G, 4G/LTE, single RS232 and single RS485
GW2024P:
Dual Ethernet, 3G, 4G/LTE, single RS232 and single RS485, plastic case
GW2027: Dual Ethernet, 3G, 4G/LTE, CDMA450, single RS232 and single RS485, Digital I/O
Note: the second input is either RS232 or RS485 and is specified at time of
ordering and fixed in manufacturing.
GW2028: Quad Ethernet, 3G, 4G/LTE, CDMA450,single RS232 and single RS485, Digital I/O
Note: the second input is either RS232 or RS485 and is specified at time of
ordering and fixed in manufacturing.
Throughout this document:
•We use the host name ‘VA_router’.
•We refer to the GW2020 Series for configuration and UCI instructions.
_______________________________________________________________________________________________________
© Virtual Access 2015
GW2020 Series User Manual
Issue: 2.3 Page 10 of 264