Cambium Wireless Manager Quick Start Guide System Release 4.0
Issue 1 May 2012 Š 2012 Cambium Networks. All Rights Reserved.
Accuracy
While reasonable efforts have been made to assure the accuracy of this document, Cambium Networks assumes no liability resulting from any inaccuracies or omissions in this document, or from use of the information obtained herein. Cambium reserves the right to make changes to any products described herein to improve reliability, function, or design, and reserves the right to revise this document and to make changes from time to time in content hereof with no obligation to notify any person of revisions or changes. Cambium does not assume any liability arising out of the application or use of any product, software, or circuit described herein; neither does it convey license under its patent rights or the rights of others. It is possible that this publication may contain references to, or information about Cambium products (machines and programs), programming, or services that are not announced in your country. Such references or information must not be construed to mean that Cambium intends to announce such Cambium products, programming, or services in your country. Copyrights
This document, Cambium products, and 3rd Party Software products described in this document may include or describe copyrighted Cambium and other 3rd Party supplied computer programs stored in semiconductor memories or other media. Laws in the United States and other countries preserve for Cambium, its licensors, and other 3rd Party supplied software certain exclusive rights for copyrighted material, including the exclusive right to copy, reproduce in any form, distribute and make derivative works of the copyrighted material. Accordingly, any copyrighted material of Cambium, its licensors, or the 3rd Party software supplied material contained in the Cambium products described in this document may not be copied, reproduced, reverse engineered, distributed, merged or modified in any manner without the express written permission of Cambium. Furthermore, the purchase of Cambium products shall not be deemed to grant either directly or by implication, estoppel, or otherwise, any license under the copyrights, patents or patent applications of Cambium or other 3rd Party supplied software, except for the normal non‐exclusive, royalty free license to use that arises by operation of law in the sale of a product. Restrictions
Software and documentation are copyrighted materials. Making unauthorized copies is prohibited by law. No part of the software or documentation 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, without prior written permission of Cambium. License Agreements
The software described in this document is the property of Cambium and its licensors. It is furnished by express license agreement only and may be used only in accordance with the terms of such an agreement. See the end user licenses published (redundantly) in the user guide or the server administration guide for Release 4.0. © 2012 Cambium Networks, Inc. All Rights Reserved.
Table of Contents Accuracy...................................................................................................................................... 2 Copyrights ................................................................................................................................... 2 Restrictions ................................................................................................................................. 2 License Agreements.................................................................................................................... 2
1
About this Guide............................................................................................ 5
2
Wireless Manager (WM) Requirements .............................................................. 7 2.1 2.1.1 2.1.2
3
5
Server Requirements............................................................................................................... 7 Client Requirements................................................................................................................ 7
2.2
Server Operating System Requirements ........................................................................ 8
2.3
Firewall Considerations................................................................................................... 8
2.4
Linux‐specific installation instructions............................................................................ 9
2.5
Installing WM with Prizm on the same server.............................................................. 10
2.6
Client Requirements ..................................................................................................... 10
WM Installation.............................................................................................11 3.1
Licensing........................................................................................................................ 11
3.2
Upgrading...................................................................................................................... 11
3.2.1 3.2.2
4
Hardware Requirements................................................................................................. 7
Upgrading from a previous version of Wireless Manager .................................................... 11 Upgrading from Prizm ........................................................................................................... 11
3.3
Linux.............................................................................................................................. 12
3.4
Windows ....................................................................................................................... 12
3.5
Installation screens ....................................................................................................... 13
3.6
Service Packs................................................................................................................. 17
BAM Installation............................................................................................19 4.1
ODBC Installation .......................................................................................................... 19
4.2
Prizm/BAM Download and Install................................................................................. 19
4.3
BAM Documentation .................................................................................................... 26
Post Installation.............................................................................................27 5.1
Configuring the Proxy on a WM Client ......................................................................... 27
5.2
Set Proxy Information in the Java Control Panel .......................................................... 27
5.3
Set the Proxy Information in the Web Browser ........................................................... 30
5.4
Unable to launch the application Error ........................................................................ 31
6
Starting and Stopping the WM Service .............................................................33
7
Starting the WM Client...................................................................................35
8
Device Discovery ..........................................................................................39
9
8.1
Discovery Example ........................................................................................................ 39
8.2
Monitoring the Discovery Process................................................................................ 41
8.3
Discovery Troubleshooting ........................................................................................... 42
Physical Map.................................................................................................43 9.1
Placing Devices on the Physical Map............................................................................ 43
9.2
Physical Map Troubleshooting...................................................................................... 44
Resources for Support ..........................................................................................45 Community Forum .................................................................................................................... 45 Technical Support ..................................................................................................................... 46
WM Release 4.0 Quick Start Guide
1
Issue 1 May 2012
About this Guide This document is intended for Wireless Manager users as they
prepare a computer and operating system for WM install.
install or upgrade WM.
set up any necessary proxy information.
discover devices on the network.
use WM basic functions for the first time.
This is a supplement to the Wireless Manager user guide and Wireless Manager server administration guide, which provide more information. The goal of this quick start guide is to get a user up and running quickly, by providing step‐by‐step instructions that apply to most situations. The How‐to‐ License Guide provides information on the license process and upgrade procedures. The WM 4.0 FAQ addresses common questions that include the upgrade paths. All of these documents can be found at http://www.cambiumnetworks.com/support/planning/index.php?cat=1&type=0.
5
WM Release 4.0 Quick Start Guide
2
Issue 1 May 2012
Wireless Manager (WM) Requirements Wireless Manager is a client‐server application that uses a java thick‐client connection. The WM Server should be located on a part of the network that can connect to the hardware devices to be managed and monitored. The WM client also requires a network connection to the WM server. The Physical Map overlays network elements onto a embedded Google map. This allows you to visualize and analyze a wide range of crucial information including connectivity between nodes, link quality, range, and device and network availability. Graphical representations of data help you quickly determine network status, identify problems, and determine the severity of impact on the network and end users. In this map‐based view, you can scale and pan to view an entire city or a specific area. Intuitive, context‐sensitive bubbles appear over the map and give quick access to key management functions. If the Physical Map feature is to be used, then the WM client requires an Internet connection.
2.1 2.1.1
Hardware Requirements Server Requirements Server class hardware, as opposed to desktop hardware, is recommended.
the following minimum server requirements: −
4 GB RAM
−
Dual‐core processor, at least 2 GHz
−
RAID 1 storage
the following large server requirements (for more than 100 nodes): −
8 GB RAM
−
Quad‐core processor, at least 2 GHz
−
RAID 5 Storage, at least 10,000‐rpm drives
an uninterruptible power supply If the server is shut down abruptly (loss of power), it can result in corruption of the database. This can have a catastrophic effect on Wireless Manager. A UPS is highly recommended, along with a scheme to shut the server down gracefully during a power outage.
2.1.2
Client Requirements Any modern desktop or laptop hardware that can run a web browser and Java 1.6 should be able to run the WM client. The only officially supported operating systems for the WM client are Windows XP and Linux. The client does not support MacOS.
7
Issue 1 May 2012
2.2
WM Release 4.0 Quick Start Guide
Server Operating System Requirements The following operating systems are supported:
Windows Server 2008 R2 or Windows Server 2008 SP 2 (Standard, Enterprise, or Datacenter)
Red Hat Enterprise Linux 5.x 32‐bit (not 64‐bit) ES (not AS) or CentOS 5.x 32‐bit (not 64‐bit)
note ............. a graphical user interface environment is required for installation of Wireless Manager.
Can I use a different version of Red Hat Enterprise Linux, or Linux from a different company? This is not supported. Wireless Manager requires specific versions of libraries to be located in certain places. Cambium Technical Support cannot help a user customize an OS to meet the requirements.
How many devices can Wireless Manager support? Wireless Manager supports up to 10,000 devices. The total number of devices supported will vary with the following:
2.3
types of devices being monitored.
speed of the network between the WM Server and the devices being monitored
polling frequency
speed of the WM server hardware
Firewall Considerations In order for the WM server to be able to communicate with both the managed devices and the WM client, certain network ports must be open for inbound traffic. If a firewall is being used for the WM server, the following ports must be opened.
Port 6900/tcp inbound is required for correct use of the TFTP connection by the firmware upgrade process.
Port 9090/tcp inbound is used to access the initial web page on the WM Server.
Port 161/udp inbound is used by the Northbound Interface (NBI).
There are two tcp ports (NMS FE Secondary and NMS Socket) required for communication between the WM server and WM client. As shipped, the WM server uses random port numbers. Alternatively, these two ports can be specified in order to be used with a firewall. A free port number must be assigned to each. Any free tcp ports can be used. In the following example, Port 33100 is assigned for NMS FE Secondary, and Port 32900 is assigned for NMS Socket. The following steps describe how to specify these ports, which must be done only after WM has been installed:
8
1.
Stop the server. (See Starting and Stopping the WM Service on Page 33.)
2.
Locate the serverparameters.conf file in the conf directory. After a standard installation, this file is located at ◦
/usr/local/cambium/wm/server/conf/ in Linux.
◦
C:\Cambium\WM\server\conf\ in Windows.
WM Release 4.0 Quick Start Guide
3.
Issue 1 May 2012
At the bottom of serverparameters.conf, add the following text: 1
NMS_FE_SECONDARY_PORT 33100
4.
Locate the transportProvider.conf file in the conf directory. After a standard installation, this file is located at ◦
/usr/local/cambium/wm/server/conf/ in Linux.
◦
C:\Cambium\WM\server\conf\ in Windows.
5.
Edit the transportProvider.conf and locate the tag <PORT_TO_LISTEN>.
6.
Replace the value 0 with the port of your choice, as demonstrated in red below.
<?xml version="1.0" encoding="ISO-8859-1"?> <TRANSPORT> <PROTOCOL NAME = "TCP" SERVER_CLASS_NAME = “com.adventnet.management.transport.TcpServerTransportImpl" CLIENT_CLASS_NAME = "com.adventnet.management.transport.TcpClientTransportImpl" > <PORT_TO_LISTEN> 32900 </PORT_TO_LISTEN> <SERVER_BACK_LOG> 300 </SERVER_BACK_LOG>
7.
2.4
Start the server. (See Starting and Stopping the WM Service on Page 33.)
Linux-specific installation instructions If a new OS installation will be performed for the WM server, here are instructions that will help configure the OS for WM: 1.
Disable the firewall and SE Linux.
2.
Install the following software packages: ◦
the basic default packages from Red Hat
◦
Mozilla for graphical Internet access
note ............. The recommendations listed above are based on configurations that Cambium has tested. Any configurations that differ from these, such as additional loaded packages, may not work.
Certain packages are specifically considered problematic for a WM platform:
XEN virtualization software, in any WM configuration
cluster packages, where the High Availability (HA) configuration is implemented.
note ............. It is not necessary to install Apache, MySQL, or Java during the OS installation. These are automatically installed as part of the WM installation process.
1
Any tcp port number can be used for this.
9
Issue 1 May 2012
2.5
WM Release 4.0 Quick Start Guide
Installing WM with Prizm on the same server Wireless Manager does not support co‐installation with Prizm EMS. However, Prizm in BAM‐only mode co‐installation is supported. See the BAM Installation on Page 19.
2.6
Client Requirements The WM client requires the following:
10
JRE 1.6 or greater
Mozilla version 2 or 3, or Internet Explorer version 6, 7, or 8
Windows XP, Windows Vista Business, Windows 7, or Red Hat Enterprise Linux. Other versions of Windows and Linux can be attempted, but are not supported. MacOS is not supported.
WM Release 4.0 Quick Start Guide
3
Issue 1 May 2012
WM Installation Except for Upgrading on Page 11, these instructions assume a fresh WM installation.
3.1
Licensing Obtain your license prior to installation of the software. See the How‐to‐License guide, available at http://www.cambiumnetworks.com/support/planning/index.php?cat=1&type=0. Obtain your license prior to installation of the software.
3.2
Upgrading There are certain upgrade paths both from previous versions of Wireless Manager. These are explained in the Cambium Wireless Manager Server Administration Guide for Release 4.0. For an upgrade from Prizm, see the Prizm‐to‐Wireless Manager Migration Guide (Prizm Release 3.3 to WM Release 4.0).
3.2.1
Upgrading from a previous version of Wireless Manager Wireless Manager Release 3.0 with Service Pack 3 is required to upgrade to Release 4.0. Service Packs are available at http://www.cambiumnetworks.com/support/planning/index.php?cat=1&type=1. important ........... Do not uninstall Wireless Manager 3.0 on your server. Instead, apply Service Pack 3 and allow the Wireless Manager 4.0 installation tool to detect Release 3.0 and upgrade WM. This ensures a seamless transition. If you uninstall the older version, the database will need to be destroyed, and you will lose all previous data and risk corruption of the InstallAnywhere Registry file. The upgrade process and its inherent uninstallation of the previous release are the purview of the administration guide.
3.2.2
Upgrading from Prizm There is not a direct upgrade path from Prizm to Wireless Manager. They are completely different platforms. Prizm in BAM‐only mode can run concurrently with WM 4.0 on the same server, however Prizm EMS cannot. If you wish to install WM Release 4.0 on a Prizm server, first put the server in BAM‐only mode using Prizm’s License Manager. A migration tool is provided to assist in exporting data from Prizm and importing that data into Wireless Manager. See the Prizm‐to‐Wireless Manager Migration Guide at http://www.cambiumnetworks.com/support/planning/index.php?cat=1&type=0.
11
Issue 1 May 2012
3.3
WM Release 4.0 Quick Start Guide
Linux A few items must be set regarding the hostname prior to install. The procedure depends on whether your system is using a static IP address or an address from a DHCP Server. If you are not sure which your system is using, consult your network administrator.
For static IP systems, the /etc/hosts file must be edited prior to WM installation. The goal is to remove the hostname from the loopback (127.0.0.1) and to assign a unique hostname for each network card or IP address. The hostnames can be whatever you like. 1.
In /etc/hosts, set 127.0.0.1 localhost.localdomain localhost.
2.
Substitute the IP address of each card, and choose a hostname, according to the following examples: [ip_address_of_card] [hostname_of_your_choice] [ip_address_of_card2] [hostname_of_your_choice2]
3.
Save and close the file /etc/hosts.
4.
Reboot the server.
For DHCP systems: 1.
In /etc/nsswitch.conf, find the hosts: line.
2.
Move files to the end of the list on that line. Example: hosts: dns files
3.
Save and close the file /etc/nsswitch.conf.
4.
Reboot the server.
Then launch the installation tool as follows: 1.
Move the installation tool file WM_Installer_*.bin to the /usr/local directory.
2.
Right‐click on the desktop.
3.
Select Open Terminal to launch a new terminal shell.
4.
Use the md5 file to verify that the installation tool file has not encountered damage.
5.
Execute the following commands: cd /usr/local /usr/local/WM_Installer_*.bin
3.4
Windows No special hostname procedures are needed under Windows. Launch the installation tool as follows:
12
1.
Move the installation tool file WM_Installer_*.exe to the C:\ folder.
2.
From the Desktop menu, select StartRun.
3.
In the C:\ folder, double‐click on the md5 file to verify that the installation tool file has not encountered damage.
4.
In the C:\ folder, double‐click on the WM_Installer_*.exe file.
WM Release 4.0 Quick Start Guide
3.5
Issue 1 May 2012
Installation screens
Click Next.
Accept the License Agreement and click Next.
13
Issue 1 May 2012
WM Release 4.0 Quick Start Guide
All three of these components are required. If you are upgrading from WM Release 3.0, uncheck MySQL Database. If you are using Windows, you will now have the opportunity to define the path for the installation. The rest of this document assumes the default path C:\Cambium\WM for Windows and /usr/local/cambium/wm for Linux.
You may either accept he defaults for database access or enter your own. If you change these, make note of your changes. They will be required for access to the database.
14
WM Release 4.0 Quick Start Guide
Issue 1 May 2012
You may either accept the default read‐only username and password or customize them.
Check the installation information, then click Install. The Wireless Manager installation will finish.
15
Issue 1 May 2012
WM Release 4.0 Quick Start Guide
If this is a new installation, the License Manager and the Server Administration Tool will now be installed. If the Server Administration Tool was previously installed, it will remain as is. In any case, this pop‐up will appear at the end. Click Yes.
The installation is complete. Click Done. The Server Administration Tool opens and includes License Manager configuration and the ability to start the server. You must apply your license before the server can start.
16
WM Release 4.0 Quick Start Guide
Issue 1 May 2012
In the WM Administrator Tool, perform the following steps: 1.
In the left panel, select Licensing.
2.
Click the Upload License button.
3.
Browse to your license file or files. (See Licensing on Page 11 for more information.)
4.
Upon successful installation of the license file, select WM Server in the left panel.
5.
Click Start WM Server.
note ............. both the Apache Service and the WM Service should show as Started.
WM installation is complete, license is loaded, and the service is started. The server is ready for a WM client to connect.
3.6
Service Packs Navigate to http://www.cambiumnetworks.com/support/planning/index.php?cat=1&type=1 and check for any available service packs to apply. Apply them after the server has been given an opportunity to start up and initialize everything.
17
WM Release 4.0 Quick Start Guide
4
Issue 1 May 2012
BAM Installation If the WM/BAM combination package was purchased, the BAM portion should be installed after WM has been installed and licensed. For BAM functionality, the Prizm software is used in BAM‐only mode. If BAM was not purchased, proceed to Post Installation on Page 27.
4.1
ODBC Installation The MySQL ODBC Driver must be installed before the Prizm installation. This driver is not provided with the installation, but is available at http://dev.mysql.com/downloads/connector/odbc/3.51.html. Follow the instructions to obtain either the Linux or Windows version of the ODBC Driver and install it.
4.2
Prizm/BAM Download and Install Prizm can be downloaded from http://www.cambiumnetworks.com/support/planning/index.php?cat=2&type=1. The file to download is “Prizm 3.3.10 Installer for Linux (or Windows)”. Be sure to choose the correct platform for your server, Linux or Windows. Run the file on your server.
Click Next.
19
Issue 1 May 2012
WM Release 4.0 Quick Start Guide
This dialog will be shown for only Windows installations. If Wireless Manager was installed on this server, this package has already been installed. The second option can be selected. This package will show up in Add/Remove Programs as Microsoft Visual C++ 2005 Redistributable. Click Next.
Read and accept the License Agreement, then click Next.
20
WM Release 4.0 Quick Start Guide
Issue 1 May 2012
Select only Prizm EMS and User Guides. Do not select the License Manager and PostgreSQL Database options. Click Next.
Inspect the Pre‐Installation Summary, then click Install.
21
Issue 1 May 2012
WM Release 4.0 Quick Start Guide
This screen may appear. Selection should be your preference, based on local operations.
Select Yes to run the Server Admin tool after installation.
22
WM Release 4.0 Quick Start Guide
Issue 1 May 2012
The installation is complete. Click Done. The Prizm Server Admin Tool will run. The following steps illustrate the method of configuring Prizm to run in BAM‐only mode and to use the infrastructure provided by Wireless Manager. For Server Mode, select BAM Only as illustrated.
23
Issue 1 May 2012
WM Release 4.0 Quick Start Guide
Select Database from the column on the left.
Select MySQL as the Database Type. Use the ODBC Driver pull‐down menu and select the driver installed earlier. Create a user and database for Prizm in the existing MySQL installation. MySQL will need to be used from the command line.
Linux: run /usr/bin/mysql –user=root -p Windows: run c:\MySQL Server 5.0\bin\mysql –user=root –p The system will prompt for the MySQL root password. The default password is public.
24
WM Release 4.0 Quick Start Guide
Issue 1 May 2012
Create the Prizm database via create database prizm; as shown. Verify the current database list via show databases;
Create the user expected by Prizm. Grant the user access to the Prizm database as follows: GRANT ALL on prizm.* to 'bost_user'@localhost IDENTIFIED BY 'bost_user';
The database and user have now been created. Use quit; to close mysql.
The JDBC driver must be loaded. These drivers are included in the Wireless Manager install. Click Browse and navigate to the following location: Windows: C:\Cambium\WM\server\mysql\driver Linux: /usr/local/cambium/wm/server/mysql/driver
Click the Test button to verify the connection to the MySQL database. If the connection is unsuccessful, ensure that the database, user, and password created match those that were expected by Prizm.
25
Issue 1 May 2012
4.3
WM Release 4.0 Quick Start Guide
BAM Documentation Documentation for Prizm/BAM is provided as the "Using the Bandwidth and Authentication Manager (BAM) Subsystem" section of the WM user guide.
26
WM Release 4.0 Quick Start Guide
5 5.1
Issue 1 May 2012
Post Installation Configuring the Proxy on a WM Client If the WM client does not need a proxy server to reach the Internet, this section may be skipped entirely. If a Proxy Server is used to access the Internet, there are a few issues that must be addressed before both the Physical Map and client/server connection will operate properly. Two possibilities exist:
Case 1 where the client and server are on separate machines
Case 2, where server and client are on the same machine
Directly after installation, most users will be under Case 2, as they will want to try to run the client on the same machine as the server. This means that all these instructions must be followed, as the machine is performing both client and server duties.
If a proxy is needed for Internet connectivity, this information must be entered in both the Java Control Panel and the web browser.
5.2
Set Proxy Information in the Java Control Panel Launch the Java Control Panel: Windows ‐ StartSettingsControl PanelJava Linux ‐ /usr/local/cambium/wm/jre/bin/jcontrol
27
Issue 1 May 2012
WM Release 4.0 Quick Start Guide
Click Network Settings from the General tab.
Select Use proxy server and enter your proxy information (what is shown is only an example). Often, you will need to specify that the proxy not be used for local addresses, of which the WM Server might be. Check Bypass proxy server for local addresses, then click Advanced.
28
WM Release 4.0 Quick Start Guide
Issue 1 May 2012
Enter the IP address or IP mask that will match the address(es) on your server. Your network administrator will be able to help you with this. Remember this must be followed for each client machine where a proxy will be used.
29
Issue 1 May 2012
5.3
WM Release 4.0 Quick Start Guide
Set the Proxy Information in the Web Browser
When a Proxy Server is used, an exception is usually specified so that the WM Server can be reached. The following example explains how to do this in Mozilla Firefox 3 in Windows. Other web browsers will also have a facility for this; your network administrator should be able to help with this setup. In Firefox, select ToolsOptions. Select the Network tab and click Settings in the Connection section.
The HTTP Proxy information would most likely already exist here. If it does not, it would need to be added, otherwise the web browser would not be able to reach the Internet. At No Proxy for:, enter the IP address or IP Mask that matches the server IP. This will be the same information as was entered in the Java Control Panel, however the format might be slightly different. In this example, we used 10.0.0.0/8, which means the
computer will look not look to the Proxy for any IP address matching 10.x.x.x. Different web browsers will have a similar method for adding exceptions, but it might look slightly different.
30
WM Release 4.0 Quick Start Guide
Issue 1 May 2012
5.4
Unable to launch the application Error
You will also receive this error if any of the proxy information (Java or web browser) is incorrect. See the Configuring the Proxy on a WM Client on Page 27. If you have already configured the proxy information, you might need to flush Java’s file cache, so the new file can be loaded.
From the Java Control Panel, select Settings from the Temporary Internet Files section.
31
Issue 1 May 2012
WM Release 4.0 Quick Start Guide
Click Delete Files, and delete both Applications and Applets and Trace and Log Files. Click OK. Try to launch the Web Start Client again.
32
WM Release 4.0 Quick Start Guide
6
Issue 1 May 2012
Starting and Stopping the WM Service The proper method of starting and stopping the WM Service differs depending on the operating system. This section refers to the service that is running on the server, not the client application.
Linux, from the command line of the server: −
service wmserver start will start the server
−
service wmserver stop will stop the server
−
service wmserver restart will stop, then start the server
−
service wmserver status will return the current server status
Windows, from the command line of the server: −
net start wmserver will start the server
−
net stop wmserver will stop the server
Alternatively, you can use Window’s GUI: Control PanelAdministrative ToolsServices. The service name is wmserver.
33
WM Release 4.0 Quick Start Guide
7
Issue 1 May 2012
Starting the WM Client After any necessary post‐installation tasks are completed, and the WM Service is started, the client can be launched. Ensure the client computer meets the requirements as outlined under Client Requirements on Page 7. 1.
From the client, launch a web browser.
2.
Find the IP address of the WM Server.
3.
Type and open this URL in the web browser: http://WMServerIPAddress:9090.
4.
If you do not see a page as pictured above, ensure that the WM Server is running, that the IP address is correct, and that you have followed the information in Configuring the Proxy on a WM Client on Page 27.
5.
Click the Web Start Client button. Depending on your browser, the next dialog box might look slightly different. The goal is to open the WebNMS.jnlp file with Java. In the case below, click OK.
35
Issue 1 May 2012
WM Release 4.0 Quick Start Guide
If the option to open with Java is not available, ensure you have installed Java as noted under Client Requirements on Page 7.
If you see the following error dialog, this indicates that exceptions were not set correctly on the web browser’s proxy, or the Java cache must be purged. See Unable to launch the application Error on Page 31.
If all is well, the WM client authentication dialog should appear. Enter the User ID and Password as shown below , then click Connect.
The default User ID is root and the associated Password is public. Upon successful authentication, the WM client opens.
36
WM Release 4.0 Quick Start Guide
Issue 1 May 2012
37
WM Release 4.0 Quick Start Guide
8
Issue 1 May 2012
Device Discovery Upon initial launch of the WM Client, the Inventory will be empty. You now need to use Discovery to find and add your devices to WM. Here is what is needed for this process:
You must know the IP addresses of the devices, or on which subnet(s) the devices reside.
The devices must be reachable from the WM Server. Otherwise, no communication can take place.
You must know the SNMP port, community, and any authentication information (if necessary) for the devices. WM supports SNMP v1, v2c, and v3.
The following information is used in the Discovery example:
8.1
device IP = 10.24.1.1
SNMP info −
version = SNMP v1
−
Community string = pubic
−
Port = 161
Discovery Example
From the main menu, select ToolsDiscovery Configurator.
On the General tab, check these boxes:
AutoDiscovery
Rediscovery Already Discovered
Enable Log
39
Issue 1 May 2012
WM Release 4.0 Quick Start Guide
Select the Node Discovery tab. For this example, we only discover a single node as a test. Enter the IP Address, SNMP Version, and SNMPAgentPort that corresponds to a device on your network.
Click Add. The information you entered should appear in the table at the top of the dialog box. Click Apply.
40
In the above example, a single IP has been submitted for Discovery. The Network Discovery tab works the same way; however, with this method an entire IP subnet can be scanned at one time. For a large group of devices that all reside on the same subnet, use Network Discovery, e.g. 10.24.1.x.
WM Release 4.0 Quick Start Guide
8.2
Issue 1 May 2012
Monitoring the Discovery Process After applying a new Discovery set, the results can be monitored elsewhere in WM. This continues from the example above.
From the left‐side tree, expand Inventory and select Networks.
The Networks window will show all Discoveries that have been submitted and their current status.
Right‐click on a line to reveal options for that Discovery (Stop Discovery or Start Discovery). Delete Object and Traces will delete that Discovery. To watch the results of the Discovery process, expand Fault Management from the left‐side tree, and select Discovery Events.
41
Issue 1 May 2012
WM Release 4.0 Quick Start Guide
In this example the node at 10.24.1.1 was successfully discovered, and then went into “Clear” status.
8.3
Discovery Troubleshooting If a Discovery is not successful, perform the following checks:
Confirm that the device exists.
Confirm that it is reachable from the WM Server. Devices must be reachable via the network from the WM server. Being reachable from the WM client is irrelevant. From the WM server, try to ping the device’s IP address or pull up its web page, if applicable.
Verify that the following SNMP credentials used were correct: −
SNMP version
−
SNMP port
−
SNMP community string (case‐sensitive)
−
in SNMP v3, all the security credentials.
Check the Discovery logs. Looking at the Discovery logs can be very helpful in determining what is happening on the server. The logs provide much more information than is given in the WM client GUI. Look for the latest discoverylogs*.txt file at Linux ‐ /usr/local/cambium/wm/server/logs Windows – C:\Cambium\WM\server\logs
42
WM Release 4.0 Quick Start Guide
9
Issue 1 May 2012
Physical Map Wireless Manager has a Physical Map module that allows operators to place their devices with respect to real‐world location, visualize the devices geographically, and see the consequences of problems. For the Physical Map to operate, the WM Client must have an Internet connection with correct proxy settings, if applicable. See Configuring the Proxy on a WM Client on Page 27.
9.1
Placing Devices on the Physical Map There are a few methods of placing devices on the physical map.
Individual devices can be manually placed. From the Inventory screen, right‐click on a device and select Set Location in Physical Map. The device will appear in the Physical Map and a variety of options will be presented, including click and drag, address search, and latitude/longitude entry.
PMP devices will be placed on the Physical Map automatically after Discovery if the Latitude, Longitude, and Altitude fields are already populated with valid data in the correct format. Latitude and Longitude are in decimal degrees, with Southern and Western Hemispheres as negative numbers. For example, New York City would be represented as: Latitude: 40.756 Longitude: ‐73.986 The Altitude field is interpreted as the device height above terrain, in meters.
Devices can be placed on the Physical Map by creating a geo‐location file and importing it. This will work for any set of devices.
The format for the geo‐location file is a comma‐delimited text file as follows: Version: <version> Create Date: <mm/dd/yy> Name(ID), latitude, longitude, height, description (optional) Name(ID), latitude, longitude, height, description (optional) [etc] note ............. The 2-line header must be present in the file.
The Name(ID) column must correspond to the values as they appear in the device’s Name(ID) column in the Inventory.
43
Issue 1 May 2012
WM Release 4.0 Quick Start Guide
To place these items, a geo‐location file would look like this: Version: 1 Create Date: 01/24/09 02 05 12 10 09 40, 30.27715,-97.69645,8 02 05 12 10 42 f1, 30.26291,-97.74009,10 02 05 12 10 43 b4, 30.27248,-97.73625,20
Alternatively, colons can be used as the delimiter instead of spaces for the MAC address: Version: 1 Create Date: 01/24/09 02:05:12:10:09:40, 30.27715,-97.69645,8
After the location file is created, import it via ToolsPhysical MapGeo‐location Import (CSV).
9.2
Physical Map Troubleshooting If you see the following message in the Physical Map panel, it indicates a failure to connect due to network problems. Verify your Internet connection and proxy, if applicable. See Configuring the Proxy on a WM Client on Page 27.
If you see the following message, it means that the system clock is set incorrectly on the server. Be sure to check time zone as well.
44
WM Release 4.0 Quick Start Guide
Issue 1 May 2012
Resources for Support Community Forum The technical support Community Forum is part of the support web site and can be used for asking questions directly to the support team. Questions and answers are accessible to all so that any customer can benefit from the same dialogue. To access this forum, visit http://www.cambiumnetworks.com/forum/. The following is an example of the contents of the forum page:
This forum requires authentication for posting.
45
Issue 1 May 2012
WM Release 4.0 Quick Start Guide
Technical Support You can obtain support for Wireless Manager from any or all of the following sources:
46
Wireless Manager setup guide, administration guide, and release notes.
Cambium Networks support web page: http://www.cambiumnetworks.com/support. This page provides links to information on all products and tools, as well as access to customer support materials and interactive support forums. Some of these resources are restricted to registered users and channel partners.
the Community Forum. Visit http://www.cambiumnetworks.com/forum/. See Community Forum on Page 45.
direct contact with Cambium Networks Technical Support. This contact is available 7 days a week, 24 hours a day. To find the appropriate phone number based on your country or region, visit http://www.cambiumnetworks.com/support/technical.php.
a technical support case, which you can open at http://www.cambiumnetworks.com/support/support_case.php. The case captures basic information about answers you are seeking or the problem that your network is experiencing and provides this to the support team, who are available 7 days a week, 24 hours a day, and will respond. They will also provide a case number by which you and they can continue to track progress on issues that require deeper investigation.