PLANET MAP-3020 User Manual

PLANET Mesh Network Manager Guide

Page 1 of 126

802.11a/b/g Indoor/Outdoor Wireless Mesh Network Access Point

MAP-3100 / MAP-3120 / MAP-3020

Mesh Network Man ager (MnM)

Management Uti lity User Manual

PLANET Mesh Network Manager Guide

Page 2 of 126

Copyright  2009 by PLANET Technology Corp. All rights reserved. No part of this publication may be reproduced, transmitted, transcribed, stored in a retrieval system, or translated into any language or computer language, in any form or by any means, electronic, mechanical, magnetic, optical, chemical, manual or otherwise, without the prior written permission of PLANET. PLANET makes no representations or warranties, either expressed or implied, with respect to the contents hereof and specifically disclaims any warranties, merchantability or fitness for any particular purpose. Any software described in this manual is sold or licensed "as is". Should the programs prove defective following their purchase, the buyer (and not PLANET, its distributor, or its dealer) assumes the entire cost of all necessary servicing, repair, and any incidental or consequential damages resulting from any defect in the software. Further, PLANET reserves the right to revise this publication and to make changes from time to time in the contents hereof without obligation to notify any person of such revision or changes.

All brand and product names mentioned in this manual are trademarks and/or registered trademarks of their respective holders.

Revision

Mesh Network Manager User’s Manual for PLANET Wireless Mesh Access Point Model: MAP-3020 / MAP-3120/MAP-3100 Rev: 4.0 (July, 2009) Part No. EM-MAP3K_MnMv4.doc

PLANET Mesh Network Manager Guide

Page 3 of 126

Table of Content

Table of Content 3

1 Overview 6 2 System Requirement 7 3 Utility Installation and Un-installation 8

3.1 Installation 8

3.1.1 Introduction 9

3.1.2 Choose Install Folder 9

3.1.3 Choose Shortcut Folder 10

3.1.4 Pre-Installation Summary 11

3.1.5 Installing 12

3.1.6 Installation Complete 13

3.2 Un-installation 13

3.2.1 Introduction 14

3.2.2 Uninstalling 14

3.2.3 Uninstallation Complete 15

4 How to Use PLANET Mesh Network Management Tools 16

4.1 Quick Start 16

4.2 Software Overview & Features 17

4.2.1 Software Layout 17

4.2.1.1 Map Container 17

4.2.1.2 MIB Reader 18

4.2.1.3 Alarm Viewer 19

4.2.2 Toolbar Reference 20

4.2.3 Features 22

4.2.3.1 Create Map 22

4.2.3.2 Open Map 23

4.2.3.3 Save Map 23

4.2.3.4 Topology Map 24

4.2.3.5 Set up New Scan 25

4.2.3.6 Map View 26

4.2.3.7 Status Pane 27

4.2.3.8 Scan IP Address 28

4.2.3.9 SNMP Community / Passwords (for Scan-IP) 28

4.2.3.10 Socket Port 30

4.2.3.11 SNMP Community / Passwords (for AP Unit) 30

4.2.3.12 Scan Interval 31

4.2.3.13 Import Background Image 32

4.2.3.14 Map Print 33

4.2.3.15 Map Zoom 34

4.2.3.16 Customize Map 35

4.2.3.17 Background Image Tra nspar e ncy 38

4.2.3.18 Block List 39

4.2.3.19 Lock / Unlock 40

4.2.3.20 Node details 41

PLANET Mesh Network Manager Guide

Page 4 of 126

4.2.3.21 Client Properties 42

4.2.3.22 Get/Set using MIB Reader 43

4.2.3.23 Load/Unload MIB 46

4.2.3.24 Alarm Table 47

4.2.3.25 Add Trap Agent 48

4.2.3.26 View Log Files 50

4.2.3.27 Show Route 51

4.2.3.28 Create VPN Connection 53

4.2.3.29 Configure Mesh APs 58

4.2.3.30 Discovery Tool 60

4.2.3.31 View Interface and Client Live Statistic 60

4.2.3.32 Logout Client 62

5 Configure the Mesh AP using AP Configurator 64

5.1 Overview of AP Configurator 64

5.2 How to use AP Configurator 65

5.3 Configure the Mesh AP 67

5.3.1 System > system 67

5.3.1.1 System > Syslog 69

5.3.1.2 System > Advanced Tuning 69

5.3.1.3 Network > Network 72

5.3.1.4 Network > WAN (MAP-3100 only) 73

5.3.1.5 Network > VLAN 77

5.3.1.6 Network > Mesh 79

5.3.1.7 Network > Wireless Configuration 82

5.3.1.8 Network > Route 85

5.3.1.9 Network > IP Sec (MAP-3100 only) 86

5.3.1.10 Network > L2TP Client 88

5.3.1.11 Network > OLSR (MAP-3100 only) 89

5.3.1.12 Services > NTP 91

5.3.2 Services > DHCP (MAP-3100 only) 93

5.3.2.1 Services > MAC Access 95

5.3.2.2 Services > NAT (MAP-3100 only) 97

5.3.2.3 Services > Firewall (MAP-3100 only) 98

5.3.2.4 Services > Traffic Shaping (MAP-3100 only) 100

5.3.2.5 Services > PPTP Server (MAP-3100 only) 102

5.3.2.6 Services > Mobile IP (Future Feature) (MAP-

3100 only) 104

5.3.2.7 Services > Captive Portal 105

5.3.2.8 Services > Radius 107

5.3.2.9 Services > Dynamic DNS 109

5.3.2.10 Services > Zero Config (MAP-3100 only) 110

5.3.2.11 Services > Auto IP (MAP-3100 only) 110

5.3.2.12 Services -> Route Watch Dog (MAP-3100 only)

5.3.2.13 Services -> System Watch Dog (MAP-3100

only) 112

5.3.2.14 Services -> SSHD 112

5.3.2.15 Services > WME 113

5.3.2.16 Management > HTTPD 115

111

PLANET Mesh Network Manager Guide

Page 5 of 126

5.3.2.17 Management > SNMPD 117

5.3.2.18 Management > SNMP Trap 119

5.3.2.19 Management > NMS Address 122

5.3.2.20 Status > DHCP Client 123

5.3.2.21 Command > Reboot 123

5.3.2.22 Command > Reset 124

5.3.2.23 Command > Download/Upload 124

6 Technical Support 126

PLANET Mesh Network Manager Guide

Page 6 of 126

1 Overview

This document provides a details information and application guidance for the user of the management software, the PLANET Mesh Network Manager (MnM). This network management s ystem is intended to perf orm an overa ll m onitoring and conf igur ing features for the PLANET Mesh Network.

PLANET Mesh Network Manager Guide

Page 7 of 126

2 System Requirem ent

The PLANET Mesh Network Manager is written in JAVA, hence it has the feature of cross platform, capable to run in most of the platform. The following are the recommended system requirement.

- 256 MB RAM (recommended minimum)

- 10 MB hard disk space

- Microsoft Windows 2000, XP (recommended)

Besides, in order to enable the NMS to work properly, the following ports must be allowed through any firewall between the NMS and the agent:

- Port 161 (by default) – Use for standard SNMP Get and Set

- Port 162 (by default) – Use for listen to SNMP Trap

- Port 4608 (by default) – Used by the Discovery Tool

- Port 8188 (by default) – Use to listen for the Layer-2 node’s notification

PLANET Mesh Network Manager Guide

Page 8 of 126

3 Utility Installation and Un-installation

3.1 Installation

Insert the bundled CD into the CD-ROM drive to launch the auto run program. Once completed, a menu s creen will appear. Click the “PLANET Mesh Netw ork Manager v_2.8.7” hyperlink and select “Open” or “Run” to initiate the install wizard.

After the wizard completes preparation, follow the 6 easy steps directed by the wizard to perform the installation.

PLANET Mesh Network Manager Guide

Page 9 of 126

3.1.1 Introduction

Simply explain what this software is about. Press Next to proceed.

3.1.2 Choose Install Folder

PLANET Mesh Network Manager Guide

Page 10 of 126

Prompt user to choose t he install path (directory) and name the install folder. Press Next to proceed.

3.1.3 Choose Shortcut Folder

Specify where the software shortcut will be created at. Press Next to proceed.

PLANET Mesh Network Manager Guide

Page 11 of 126

3.1.4 Pre-Installation Summary

Let user have a quick review about the installation settings before start installing. Press Install button to start the installation.

PLANET Mesh Network Manager Guide

Page 12 of 126

3.1.5 Installing

Installation is in progress. Once the installation is com pleted it will direc t the user to the nex t step.

PLANET Mesh Network Manager Guide

Page 13 of 126

3.1.6 Installation Complete

Indicating the installat ion is completed, and user can s elect to restart the s ystem instantly or afterward, in order to complete the installation. Press Done to conclude the ins tal lat ion. After that, you may launch the NMS through the shortcut you created previously.

3.2 Un-installation

In order to unins tall the PL ANET Mesh Net work Manager f rom your terminal , you can get the uninstaller wizard from the software directory. The uninstaller, namely Uninstall PLANET Mesh Tools, is located at the U ninstall_PLANET Mesh Tools folder. Launch the uninstaller wizard by double-click the executable file. Follows the following steps:

PLANET Mesh Network Manager Guide

Page 14 of 126

3.2.1 Introduction

An introduction regarding the uninstallation of the PLANET Mesh Management Tool. Click Uninstall to start the process.

3.2.2 Uninstalling

PLANET Mesh Network Manager Guide

Page 15 of 126

Uninstallation is in the pro gress. Once the progr ess is completed, it will aut omatically direct you to the next step.

3.2.3 Uninstallation Complete

The software is uninstalled. You may choose to restart the term inal instantly or afterward in order to complete the process.

PLANET Mesh Network Manager Guide

Page 16 of 126

4 How to Use PLANET Mesh Network

Management Tools

4.1 Quick Start

First of all, make sure the terminal where you installed your PLANET Mesh Network Management Tools is connected to the network, via W ireles s or Wired LAN. Then, launch th e NMS at the location where you install it.

For a Layer 3 Mesh network:

Click the Creat e Map butto n on t h e too lb ar t o ge nerat e a ne w map profile. A dialog box would appear, select SNMP Map and enter the name of th e ne w pr of ile . After th at, hit t h e OK button to complete the set up. A new map will be inserted into the NMS.

Then, click on the drop-do wn list on the toolbar of th e new profile, where it prom pts users to insert the Scan IP Address, the d estination IP Address to be scanned. Enter the desired IP and click the button next t o the list to save the I P. Finally, select the Start Scan button on the map’s toolbar, the scan will be initiated and run . The result of the scan w ill be plotted on the map area. User is free to adjust the position of the found-unit on the map.

For a Layer 2 Mesh network:

Prior to set up the utilit y, u ser is required to add the IP address of the NMS terminal on the web page (Management > NMS Addresses) of Layer 2 nodes.

After the Layer 2 node configuration is done, activate the NMS and click the Create Map button. A dialog box would appear, select Layer-2 M ap and enter the name of the new profile. After that, hit the OK button to complete the setup. A new map will be inserted into the NMS.

Before shutting do wn the NMS, us er can s ave the profile settings , includi ng the c oordinat e of the found Mesh AP units on the map, by click on the Save Map button on the m ap toolbar. The saved profile can be lo aded dir ectl y to the NMS next time using the Op en Map butto n on the toolbar.

For further description regarding the functions and features of the PLANET Mesh Network Management Tools, user may refer to the following section.

PLANET Mesh Network Manager Guide

Page 17 of 126

4.2 Software Overview & Features

4.2.1 Software Layout

Before we procee d further, let us have an overview at the layout of the NMS. Basically, the PLANET Mesh Network Management Tools is consists of three major sections:

 Map Container  MIB Reader  Alarm Viewer

User can switch t he vie w of the NMS by sel ec t th e tab s at t he left bo ttom corner, as illustrated, or through the menu bar.

4.2.1.1 Map Contai ner

The Map Container is the section where user can monitor an d manage the mesh network. The network will be disp layed in the form of graphical topolog y map, and the status will be updated periodically.

The center frame of the Map Container is the space t o plot the topolo gy map. More tha n one map can be created and run simultaneously. The status of the map will be logged to the status pane at the bottom of the map. Each topology map has its own status pane.

The panel at the left of the map space is the Node Details panel. It is used to display the properties of the s elected Mesh A P unit on the topolog y map. The inform ation of the AP will be loaded into the table, an d the gr aph bel o w th e table sho ws the s i gna l st rengt h between the selected AP with its neighbour APs. The column at th e bottom of this panel is used to invok e the live stat monitoring feature.

The right panel, m eanwhile, is to dis play the details of the c lients associated to t he Mesh AP unit. The panel is divided into two parts, the Client Properties and Client Signal Strength portion. Each portion will be autom atically updated every minute, to provide the admin user the live result regarding the clients.

PLANET Mesh Network Manager Guide

Page 18 of 126

4.2.1.2 MIB Reader

The MIB Reader provides user a sim ple user-interface to retrieve as well as configure the settings of the Mesh AP unit through t he standard or vendor proprietary MIB files. W ith the correct community and password, user can perform the SNMP actions such a s SNMPGet, SNMPSet and SNMPTable.

PLANET Mesh Network Manager Guide

Page 19 of 126

The left pane displa ys the lis t of MIB and its tr ee. Use r can lo ad and unload M IB f ile from the desired location. More th an one f ile can b e lo ade d in to the MIB Reader. In order to read or set an item, expand the MIB tree, selec t the desired node . Select the SNM P version; fill in the IP Address and other necessary keyword. Then click on the command button (SnmpGet, SnmpSet, SnmpWalk, Load Table, etc..) on the toolbar. T he output will be shown on the Output column.

4.2.1.3 Alarm Viewer

The Alarm Viewer is a trap receiver. It received the SNMP alarms and notifications directed by the Mesh AP units and display in the table at the center frame. Select the table e ntry in order to view the description of the trap.

Note that the table is a read-only table, which displays the trap’s source IP Address, description, severity and the time when the trap or alarm was caught. These alarms should be deleted once they were reviewed and resolved, by clicking the Delete button.

PLANET Mesh Network Manager Guide

Page 20 of 126

Button

Name

Function

Create Map

Open Map

View Tile

View the topology map in grid layout

View Cascade

View the topology map in cascade layout

SnmpGet

SnmpGet the data from MIB tree

SnmpSet

Load Table

Load the SNMP table from MIB tree

Refresh Table

Refresh the SNMP table from MIB tree

4.2.2 Tool ba r Reference

This section provides a quick reference for the buttons in the toolbar of the NMS. The description of the toolbar of the NMS is illustrated at the table below:

Create a new topology map profile

Open a pre-saved topology map profile

SnmpSet the data from MIB tree

PLANET Mesh Network Manager Guide

Page 21 of 126

Add Table Row

Add a row to SNMP Table

Del Table Row

Delete a row from SNMP Table

SnmpWalk

Walk the selected item from the MIB tree

Start Trap

Initiate the Alarm Host system

Stop Trap

Stop the Alarm Host system Button

Name

Function

Import

Save Profile

Save the current topology map

Scan Start

Start the network scanning (SNMP Map only)

Scan Stop

Initiate Port

Open port to listen to La yer-2 notification ( Layer-2

Close Port

Close Layer-2 notification port (Layer-2 Map only)

Zoom In

Zoom in the topology map by 25%

Zoom Out

Zoom out the topology map by 25%

Zoom Fit

Zoom the topology map to a size that fit the

Lock

Lock the AP units on the map

Unlock

Unlock the AP units on the map

Block List

Open the block list window

On the other hand, the following table shows the description of the toolbar of the map container:

Import an image file to use as the background

Background

image of the topology map

Stop the network scanning (SNMP Map only)

Map only)

screen

PLANET Mesh Network Manager Guide

Page 22 of 126

4.2.3 Features

4.2.3.1 Create Map

In the NMS, two to polog y m aps are availa ble: SNMP Map and La yer-2 Map. T hes e two types of map look similar. The main difference between them is the method to get the topology information.

• The SNMP Map is the ordinary t ype, where it uses the SNMP protoco l to collect the topology from the nodes di sc overed, and then plot the map using the collaborat e data.

• Whereas the Layer-2 M ap opens a specific port to listen for the notif ication from the nodes, in order to p lot the map. Prior to this, us er is r equ ir ed to the NMS terminal (IP Address) to the no de. Thus in fact, the Layer-2 Map can recei ve the notification not only from the layer-2 m ode AP, but any other m ode as well, as long as the NMS Address table is set.

In order to create a new Topology map profile, user can click on the Create New button on the main toolbar, or select File > Create Ne w from the menu bar. A window would turn out to prompt user for the type and name of the new map. User may select the t ype of the profile from the drop down list, and enter the name in the provided column.

add the inform at ion of

Please be aware that spec ial character s uch as #, $, % (exc ept _), are not allow ed to use as the name of the topolo gy map name to a void data corrupti on, since the n ame of the m ap will be used as the header of their data f ile. On the other hand, the system also not allow user to create a new profile with the name of the existing map in the NMS. Two Profile Types can be found, SNMP Map and Layer 2 Map . Please chose SNMP Map for Layer 3 mode Mesh Network Management and Layer 2 Map for Layer 2 Mode Mesh Network Management.

Hit the OK button to proceed, or Cancel to close the window.

PLANET Mesh Network Manager Guide

Page 23 of 126

guide section 3.5.10 for more.

Please make sure your Layer 2 Mesh Nodes are pre-configured for this MnM installed PC. Otherwise, MnM can not display your Mesh nodes in the map also

Note

cannot show the correct information at the mean time. Please also refer to Web

4.2.3.2 Open Map

In stead of create a br and new topo log y map, user ca n re-open the map pr ofile t hat has been saved previousl y. Click the Open M ap button, or select File > Open Map from menu bar, a file chooser window would appear on t he screen, to prom pt user to choos e a map. Select t he desired one, and hit the Open button. The profile will be loaded to the NMS with all its settings.

4.2.3.3 Save Map

As mentioned previously, the settings of the map profile can be saved to be loaded in the future. Details of the m ap, for instance, the coordinate and SNMP passwords of the Mesh AP units on the map, background image and block list, will be saved as a setting file.

In order to save a profile, select the Save Map button or File > Save Map from the map container toolbar of that particular m ap profile you wish to save. N ote that if user is trying to save a map profile tha t has a same nam e as one of the existin g profile, a warning m essage would appear to get confirmation from the user to overwrite the file. To proceed with the action, click the OK button.

PLANET Mesh Network Manager Guide

Page 24 of 126

Icon

Indication

Layer-2 AP, which did not notify the NMS (disc overed as

By default, the profile will be s aved t o the Map folder in the progr am’s directory, with the name of the map profile and ex te ns ion .map or .l2map.

4.2.3.4 Topology Map

The topology map is actually the graphical representation of the actual Mesh network topology which is bein g scanned. W hen a new scan is initiat ed, the result of the scan will be processed by the NMS, and output to the map.

The AP unit would appear in different colors:-

Inactive AP

Accessible gateway AP

Inaccessible gateway AP

Accessible relay AP

Inaccessible relay AP

Accessible client-relay AP

Inaccessible client-relay AP

Layer-2 gateway AP, which notified the NMS Layer-2 gateway AP, which did not notify the NMS

(discovered as neighbour) Layer-2 AP, which notified the NMS

neighbour) AP Bridge

AP Router

PLANET Mesh Network Manager Guide

Page 25 of 126

The blue line in between the APs designates the solid link; whereas the red, dashed line shows th e indirect link . On the other hand, user may hit the Help > Legend opt ion from the menu bar to view the legend regarding the topology.

4.2.3.5 Set up New Scan

In order to set up a new scan for a SNMP topology map, c lick on the Start Scan button, or select Map > Start Scan from the menu b ar. Conversely, hit the Stop Scan button or se lect Map > Stop Scan to halt the scanning process. The status of the map will be updated periodically, hence whenever there is a change in t he network, us er might be a ble to m onitor via the NMS. The status bar at the bottom of the map displays the status of the scan. On the other hand, in order to set up a new scan f or the Layer-2 topology map, c lick on the Initiate Port button, or select Map > Initiate Port from the menu bar. The map will receive the notification sent by the AP and plot th e topology on the map. Convers ely, hit the Close Po rt button or select Map > Close Port from the menu bar to stop listen to the notification.

PLANET Mesh Network Manager Guide

Page 26 of 126

Every new found Mesh AP unit will be place on the right top angle on the map, with zero coordinate. Then user is f ree to move the AP unit around the m ap. Once user com pletes the positioning, save th e map, and the system wil l remember the new coordi nates in the future scan.

4.2.3.6 Map View

More than one topology map can be loaded to the NMS at the same time. By default, the maps are viewed in cascade m ode, where user needs to click on the tab at the bottom to switch the map to view.

In order to change the vie w type, click the Tile button on t he main toolbar, or select View > Tile from the menu bar. The tile mode arranges the topol og y maps in a grid la yout. To convert the view mode to casc ade, hit t he Cascade button, or View > Cascade. T he fol lowing f igures illustrate the difference between the two modes .

(Cascade mode)

PLANET Mesh Network Manager Guide

Page 27 of 126

(Tile Mode)

4.2.3.7 Status Pane

The status pane is located at the bottom of the map container. It displays the nodes’ status with the time and date; enable users to keep track of the changes in the topology.

The type of message can be varied by the color of the text. Green text indicating positive message such as sc an started or no des found; r ed tex t s hows the n egati ve mes sage such as nodes down or tim eout; whereas cyan text dis playing system message, for instance, s ystem settings changed.

PLANET Mesh Network Manager Guide

Page 28 of 126

The Copy All and C lea r All buttons on t he top of the pane perf orms the cop y an d delet e text action in the status pane. Tick the checkbox at the bottom to log th e status message to the alarm log file, which will be saved to the folder Alarm_Log at the install directory.

4.2.3.8 Scan IP Address

The Scan IP Address is the I P Address that the scannin g process uses when initiate a scan for a SNMP Map.

User might enter the IP Address at the drop down list, or choose from the list. In order to apply the new Scan I P, user is required to restart the network scanning. ( A running scan will be stopped when a new IP Address is selected.)

On the other hand, the Scan IP can also be set by selecting Settings > Scan IP from the map container’s toolbar. A window would appear to prompt user for the new IP Address. Hit the OK button to apply the change.

4.2.3.9 SNMP Community / Passwords (for Scan-IP)

The PLANET Mesh Network Management Tools use the SNMP method to read the t opology of the network. T here are two types of SNMP key used for the topo logy scan, which are the Scan-IP key and the AP Unit key. More details about the latter please click

Commonly, the use of SNMP varies b y its version. If a us er select v ersion 2c, the SNMP key to use is a community; on the other hand, if version 3 is used, the SNMP key will be a SNMPv3 usernam e, with its c orres ponding a uthent icat ion pass word and privac y pass phrase. As you can see throughout this document, every feature that implements SNMP will have both options (use version 2c or 3).

PLANET Mesh Network Manager Guide

here.

PLANET Mesh Network Manager Guide

Page 29 of 126

Basically, the Scan-IP ke y is the SNMP ke y tha t used for the Scan-I P which initiat es the scan. In order to configure the community of the Scan-IP, select Settings > Scan-IP v2c

Community from the map container menu. On the other hand, select Sett ings > Scan-I P v3 Passwords to change the SNMP versio n 3 Passwords. A window would turn up to prom pt

user for the new key(s).

Press Change and Use SNM P Version X button t o proceed. If the change is successfully, the following dialog box wo uld app ear, to remind user to r eset th e scan i n order to let the ne w community or passwords to take effect.

PLANET Mesh Network Manager Guide

Page 30 of 126

The default value for Scan-IP: Community: public Username: snmpv3rouser Password: snmpv3password Passphrase: snmpv3passphrase

4.2.3.10 Socket Port

The notification of an AP node is sent according to its NMS Address Table. The table defines the IP Address and port number of the destination (NMS). For instance, if the admin has added a table entry with port number 8000 at the AP, the NMS user can change the socket port number to 8000 in order to receive the notification.

In order to update the socket port, select Settings > Socket Port from the menu bar. A dialog box would appear on the screen to prompt for the port number, which range from 1 to 65535. Hit OK to confirm the change.

4.2.3.11 SNMP Com m uni ty / Passwords (for AP Unit)

In case if a Mesh A P utilizes a different community o r passwords from the others , the NMS might fail to read the top ology from it. Hence, user might nee d to edit the individual AP unit SNMP keys, by right-click the desired activ e node. Select Change v2c Community from the popup menu to change the community; or click Change v3 Passwords to change the v3 keys; enter the correct value in the dialog box and click Change and Use SNMP Version X.

PLANET Mesh Network Manager Guide

+ 96 hidden pages