Cambium Wireless Manager Quick Start Guide

System Release 4.0

Issue 1 May 2012 2012 Cambium Networks. All Rights Reserved.

Accuracy

Whilereasonableeffortshavebeenmadetoassuretheaccuracyofthisdocument,CambiumNetworksassumes noliabilityresultingfromanyinaccuraciesoromissionsinthisdocument,orfromuseoftheinformationobtained herein.Cambiumreservestherighttomakechangestoanyproductsdescribedhereintoimprovereliability, function,ordesign,andreservestherighttorevisethisdocumentandtomakechangesfromtimetotimein contenthereofwithnoobligationtonotifyanypersonofrevisionsorchanges.Cambiumdoesnotassumeany liabilityarisingoutoftheapplicationoruseofanyproduct,software,orcircuitdescribedherein;neitherdoesit conveylicenseunderitspatentrightsortherightsofothers.Itispossiblethatthispublicationmaycontain referencesto,orinformationaboutCambiumproducts(machinesandprograms),programming,orservicesthat arenotannouncedinyourcountry.SuchreferencesorinformationmustnotbeconstruedtomeanthatCambium intendstoannouncesuchCambiumproducts,programming,orservicesinyourcountry.
Copyrights

Thisdocument,Cambiumproducts,and3rdPartySoftwareproductsdescribedinthisdocumentmayincludeor describecopyrightedCambiumandother3rdPartysuppliedcomputerprogramsstoredinsemiconductor memoriesorothermedia.LawsintheUnitedStatesandothercountriespreserveforCambium,itslicensors,and other3rdPartysuppliedsoftwarecertainexclusiverightsforcopyrightedmaterial,includingtheexclusiverightto copy,reproduceinanyform,distributeandmakederivativeworksofthecopyrightedmaterial.Accordingly,any copyrightedmaterialofCambium,itslicensors,orthe3rdPartysoftwaresuppliedmaterialcontainedinthe Cambiumproductsdescribedinthisdocumentmaynotbecopied,reproduced,reverseengineered,distributed, mergedormodifiedinanymannerwithouttheexpresswrittenpermissionofCambium.Furthermore,the purchaseofCambiumproductsshallnotbedeemedtogranteitherdirectlyorbyimplication,estoppel,or otherwise,anylicenseunderthecopyrights,patentsorpatentapplicationsofCambiumorother3rdPartysupplied software,exceptforthenormalnonexclusive,royaltyfreelicensetousethatarisesbyoperationoflawinthesale ofaproduct.
Restrictions

Softwareanddocumentationarecopyrightedmaterials.Makingunauthorizedcopiesisprohibitedbylaw.Nopart ofthesoftwareordocumentationmaybereproduced,transmitted,transcribed,storedinaretrievalsystem,or translatedintoanylanguageorcomputerlanguage,inanyformorbyanymeans,withoutpriorwrittenpermission ofCambium.

License Agreements

ThesoftwaredescribedinthisdocumentisthepropertyofCambiumanditslicensors.Itisfurnishedbyexpress licenseagreementonlyandmaybeusedonlyinaccordancewiththetermsofsuchanagreement.Seetheend userlicensespublished(redundantly)intheuserguideortheserveradministrationguideforRelease4.0. 2012CambiumNetworks,Inc.AllRightsReserved.

Table of Contents
Accuracy...................................................................................................................................... 2 Copyrights ................................................................................................................................... 2 Restrictions ................................................................................................................................. 2 LicenseAgreements.................................................................................................................... 2

1 2

About this Guide............................................................................................ 5 Wireless Manager (WM) Requirements .............................................................. 7

2.1
2.1.1 2.1.2

HardwareRequirements................................................................................................. 7
ServerRequirements............................................................................................................... 7 ClientRequirements................................................................................................................ 7

2.2 2.3 2.4 2.5 2.6

ServerOperatingSystemRequirements ........................................................................ 8 FirewallConsiderations................................................................................................... 8 Linuxspecificinstallationinstructions............................................................................ 9 InstallingWMwithPrizmonthesameserver.............................................................. 10 ClientRequirements ..................................................................................................... 10

WM Installation.............................................................................................11
3.1 3.2
3.2.1 3.2.2

Licensing........................................................................................................................ 11 Upgrading...................................................................................................................... 11
UpgradingfromapreviousversionofWirelessManager .................................................... 11 UpgradingfromPrizm ........................................................................................................... 11

3.3 3.4 3.5 3.6

Linux.............................................................................................................................. 12 Windows ....................................................................................................................... 12 Installationscreens ....................................................................................................... 13 ServicePacks................................................................................................................. 17

BAM Installation............................................................................................19
4.1 4.2 4.3 ODBCInstallation .......................................................................................................... 19 Prizm/BAMDownloadandInstall................................................................................. 19 BAMDocumentation .................................................................................................... 26

Post Installation.............................................................................................27
5.1 5.2 5.3 5.4 ConfiguringtheProxyonaWMClient ......................................................................... 27 SetProxyInformationintheJavaControlPanel .......................................................... 27 SettheProxyInformationintheWebBrowser ........................................................... 30 UnabletolaunchtheapplicationError ........................................................................ 31

6 7 8

Starting and Stopping the WM Service .............................................................33 Starting the WM Client...................................................................................35 Device Discovery ..........................................................................................39
8.1 8.2 8.3 DiscoveryExample ........................................................................................................ 39 MonitoringtheDiscoveryProcess................................................................................ 41 DiscoveryTroubleshooting ........................................................................................... 42

Physical Map.................................................................................................43
9.1 9.2 PlacingDevicesonthePhysicalMap............................................................................ 43 PhysicalMapTroubleshooting...................................................................................... 44

Resources for Support ..........................................................................................45

CommunityForum .................................................................................................................... 45 TechnicalSupport ..................................................................................................................... 46

WM Release 4.0 Quick Start Guide

Issue 1 May 2012

About this Guide

ThisdocumentisintendedforWirelessManagerusersasthey prepareacomputerandoperatingsystemforWMinstall. installorupgradeWM. setupanynecessaryproxyinformation. discoverdevicesonthenetwork. useWMbasicfunctionsforthefirsttime.

ThisisasupplementtotheWirelessManageruserguideandWirelessManagerserveradministration guide,whichprovidemoreinformation.Thegoalofthisquickstartguideistogetauserupand runningquickly,byprovidingstepbystepinstructionsthatapplytomostsituations.TheHowto LicenseGuideprovidesinformationonthelicenseprocessandupgradeprocedures.TheWM4.0FAQ addressescommonquestionsthatincludetheupgradepaths.Allofthesedocumentscanbefoundat http://www.cambiumnetworks.com/support/planning/index.php?cat=1&type=0.

WM Release 4.0 Quick Start Guide

Issue 1 May 2012

Wireless Manager (WM) Requirements

WirelessManagerisaclientserverapplicationthatusesajavathickclientconnection.TheWM Servershouldbelocatedonapartofthenetworkthatcanconnecttothehardwaredevicestobe managedandmonitored.TheWMclientalsorequiresanetworkconnectiontotheWMserver. ThePhysicalMapoverlaysnetworkelementsontoaembeddedGooglemap.Thisallowsyouto visualizeandanalyzeawiderangeofcrucialinformationincludingconnectivitybetweennodes,link quality,range,anddeviceandnetworkavailability.Graphicalrepresentationsofdatahelpyouquickly determinenetworkstatus,identifyproblems,anddeterminetheseverityofimpactonthenetwork andendusers.Inthismapbasedview,youcanscaleandpantoviewanentirecityoraspecificarea. Intuitive,contextsensitivebubblesappearoverthemapandgivequickaccesstokeymanagement functions.IfthePhysicalMapfeatureistobeused,thentheWMclientrequiresanInternet connection.

2.1
2.1.1

Hardware Requirements
Server Requirements
Serverclasshardware,asopposedtodesktophardware,isrecommended. thefollowingminimumserverrequirements: 4GBRAM Dualcoreprocessor,atleast2GHz RAID1storage 8GBRAM Quadcoreprocessor,atleast2GHz RAID5Storage,atleast10,000rpmdrives

thefollowinglargeserverrequirements(formorethan100nodes):

anuninterruptiblepowersupply Iftheserverisshutdownabruptly(lossofpower),itcanresultincorruptionofthedatabase. ThiscanhaveacatastrophiceffectonWirelessManager.AUPSishighlyrecommended, alongwithaschemetoshuttheserverdowngracefullyduringapoweroutage.

2.1.2

Client Requirements
AnymoderndesktoporlaptophardwarethatcanrunawebbrowserandJava1.6shouldbeableto runtheWMclient.TheonlyofficiallysupportedoperatingsystemsfortheWMclientareWindowsXP andLinux.TheclientdoesnotsupportMacOS.

Issue 1 May 2012

WM Release 4.0 Quick Start Guide

2.2

Server Operating System Requirements

Thefollowingoperatingsystemsaresupported: WindowsServer2008R2orWindowsServer2008SP2(Standard,Enterprise,orDatacenter) RedHatEnterpriseLinux5.x32bit(not64bit)ES(notAS)orCentOS5.x32bit(not64bit)

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?
Thisisnotsupported.WirelessManagerrequiresspecificversionsoflibrariestobelocatedincertain places.CambiumTechnicalSupportcannothelpausercustomizeanOStomeettherequirements.

How many devices can Wireless Manager support?

WirelessManagersupportsupto10,000devices.Thetotalnumberofdevicessupportedwillvary withthefollowing: typesofdevicesbeingmonitored. speedofthenetworkbetweentheWMServerandthedevicesbeingmonitored pollingfrequency speedoftheWMserverhardware

2.3

Firewall Considerations
InorderfortheWMservertobeabletocommunicatewithboththemanageddevicesandtheWM client,certainnetworkportsmustbeopenforinboundtraffic.IfafirewallisbeingusedfortheWM server,thefollowingportsmustbeopened. Port6900/tcpinboundisrequiredforcorrectuseoftheTFTPconnectionbythefirmware upgradeprocess. Port9090/tcpinboundisusedtoaccesstheinitialwebpageontheWMServer. Port161/udpinboundisusedbytheNorthboundInterface(NBI).

Therearetwotcpports(NMSFESecondaryandNMSSocket)requiredforcommunicationbetween theWMserverandWMclient.Asshipped,theWMserverusesrandomportnumbers.Alternatively, thesetwoportscanbespecifiedinordertobeusedwithafirewall.Afreeportnumbermustbe assignedtoeach.Anyfreetcpportscanbeused.Inthefollowingexample,Port33100isassignedfor NMSFESecondary,andPort32900isassignedforNMSSocket. Thefollowingstepsdescribehowtospecifytheseports,whichmustbedoneonlyafterWMhasbeen installed: 1. 2. Stoptheserver.(SeeStartingandStoppingtheWMServiceonPage33.) Locatetheserverparameters.conffileintheconfdirectory.Afterastandard installation,thisfileislocatedat
/usr/local/cambium/wm/server/conf/inLinux. C:\Cambium\WM\server\conf\inWindows.

WM Release 4.0 Quick Start Guide Atthebottomofserverparameters.conf,addthefollowingtext:

NMS_FE_SECONDARY_PORT 33100
1

Issue 1 May 2012

3. 4.

LocatethetransportProvider.conffileintheconfdirectory.Afterastandard installation,thisfileislocatedat
/usr/local/cambium/wm/server/conf/inLinux. C:\Cambium\WM\server\conf\inWindows.

5. 6.

EditthetransportProvider.conf andlocatethetag<PORT_TO_LISTEN>. Replacethevalue0withtheportofyourchoice,asdemonstratedinredbelow.

<?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. Starttheserver.(SeeStartingandStoppingtheWMServiceonPage33.)

2.4

Linux-specific installation instructions

IfanewOSinstallationwillbeperformedfortheWMserver,hereareinstructionsthatwillhelp configuretheOSforWM:
1. 2.

DisablethefirewallandSELinux. Installthefollowingsoftwarepackages: thebasicdefaultpackagesfromRedHat MozillaforgraphicalInternetaccess

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.

CertainpackagesarespecificallyconsideredproblematicforaWMplatform: XENvirtualizationsoftware,inanyWMconfiguration clusterpackages,wheretheHighAvailability(HA)configurationisimplemented.

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.

Anytcpportnumbercanbeusedforthis.

Issue 1 May 2012

WM Release 4.0 Quick Start Guide

2.5

Installing WM with Prizm on the same server

WirelessManagerdoesnotsupportcoinstallationwithPrizmEMS.However,PrizminBAMonly modecoinstallationissupported.SeetheBAMInstallationonPage19.

2.6

Client Requirements
TheWMclientrequiresthefollowing: JRE1.6orgreater Mozillaversion2or3,orInternetExplorerversion6,7,or8 WindowsXP,WindowsVistaBusiness,Windows7,orRedHatEnterpriseLinux.Other versionsofWindowsandLinuxcanbeattempted,butarenotsupported.MacOSisnot supported.

10

WM Release 4.0 Quick Start Guide

Issue 1 May 2012

3
3.1

WM Installation
ExceptforUpgradingonPage11,theseinstructionsassumeafreshWMinstallation.

Licensing
Obtainyourlicensepriortoinstallationofthesoftware.SeetheHowtoLicenseguide,availableat http://www.cambiumnetworks.com/support/planning/index.php?cat=1&type=0. Obtainyourlicensepriortoinstallationofthesoftware.

3.2

Upgrading
TherearecertainupgradepathsbothfrompreviousversionsofWirelessManager.Theseare explainedintheCambiumWirelessManagerServerAdministrationGuideforRelease4.0.Foran upgradefromPrizm,seethePrizmtoWirelessManagerMigrationGuide(PrizmRelease3.3toWM Release4.0).

3.2.1

Upgrading from a previous version of Wireless Manager

WirelessManagerRelease3.0withServicePack3isrequiredtoupgradetoRelease4.0.ServicePacks areavailableathttp://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

ThereisnotadirectupgradepathfromPrizmtoWirelessManager.Theyarecompletelydifferent platforms. PrizminBAMonlymodecanrunconcurrentlywithWM4.0onthesameserver,howeverPrizmEMS cannot.IfyouwishtoinstallWMRelease4.0onaPrizmserver,firstputtheserverinBAMonlymode usingPrizmsLicenseManager. AmigrationtoolisprovidedtoassistinexportingdatafromPrizmandimportingthatdatainto WirelessManager.SeethePrizmtoWirelessManagerMigrationGuideat http://www.cambiumnetworks.com/support/planning/index.php?cat=1&type=0.

11

Issue 1 May 2012

WM Release 4.0 Quick Start Guide

3.3

Linux
Afewitemsmustbesetregardingthehostnamepriortoinstall.Theproceduredependsonwhether yoursystemisusingastaticIPaddressoranaddressfromaDHCPServer.Ifyouarenotsurewhich yoursystemisusing,consultyournetworkadministrator. ForstaticIPsystems,the/etc/hostsfilemustbeeditedpriortoWMinstallation.Thegoal istoremovethehostnamefromtheloopback(127.0.0.1)andtoassignauniquehostname foreachnetworkcardorIPaddress.Thehostnamescanbewhateveryoulike. 1. 2. In/etc/hosts,set127.0.0.1 localhost.localdomain localhost. SubstitutetheIPaddressofeachcard,andchooseahostname,accordingtothe followingexamples:
[ip_address_of_card] [hostname_of_your_choice] [ip_address_of_card2] [hostname_of_your_choice2]

3. 4.
1. 2. 3. 4.

Saveandclosethefile/etc/hosts. Reboottheserver. In/etc/nsswitch.conf,findthehosts:line. Movefilestotheendofthelistonthatline. Example:hosts: dns files Saveandclosethefile/etc/nsswitch.conf. Reboottheserver.

ForDHCPsystems:

Thenlaunchtheinstallationtoolasfollows:
1. 2. 3. 4. 5.

MovetheinstallationtoolfileWM_Installer_*.bintothe/usr/localdirectory. Rightclickonthedesktop. SelectOpenTerminaltolaunchanewterminalshell. Usethemd5filetoverifythattheinstallationtoolfilehasnotencountereddamage. Executethefollowingcommands:

cd /usr/local /usr/local/WM_Installer_*.bin

3.4

Windows
NospecialhostnameproceduresareneededunderWindows.Launchtheinstallationtoolasfollows:
1. 2. 3. 4.

MovetheinstallationtoolfileWM_Installer_*.exetotheC:\folder. FromtheDesktopmenu,selectStartRun. IntheC:\folder,doubleclickonthemd5filetoverifythattheinstallationtoolfilehasnot encountereddamage. IntheC:\folder,doubleclickontheWM_Installer_*.exefile.

12

WM Release 4.0 Quick Start Guide

Issue 1 May 2012

3.5

Installation screens

ClickNext.

AccepttheLicenseAgreementandclickNext.

13

Issue 1 May 2012

WM Release 4.0 Quick Start Guide

Allthreeofthesecomponentsarerequired.IfyouareupgradingfromWMRelease3.0,uncheck MySQLDatabase. IfyouareusingWindows,youwillnowhavetheopportunitytodefinethepathfortheinstallation. TherestofthisdocumentassumesthedefaultpathC:\Cambium\WMforWindowsand /usr/local/cambium/wmforLinux.

Youmayeitheraccepthedefaultsfordatabaseaccessorenteryourown.Ifyouchangethese,make noteofyourchanges.Theywillberequiredforaccesstothedatabase.

14

WM Release 4.0 Quick Start Guide

Issue 1 May 2012

Youmayeitheracceptthedefaultreadonlyusernameandpasswordorcustomizethem.

Checktheinstallationinformation,thenclickInstall.TheWirelessManagerinstallationwillfinish.

15

Issue 1 May 2012

WM Release 4.0 Quick Start Guide

Ifthisisanewinstallation,theLicenseManagerandtheServerAdministrationToolwillnowbe installed.IftheServerAdministrationToolwaspreviouslyinstalled,itwillremainasis.Inanycase, thispopupwillappearattheend.ClickYes.

Theinstallationiscomplete.ClickDone. TheServerAdministrationToolopensandincludesLicenseManagerconfigurationandtheabilityto starttheserver.Youmustapplyyourlicensebeforetheservercanstart.

16

WM Release 4.0 Quick Start Guide

Issue 1 May 2012

IntheWMAdministratorTool,performthefollowingsteps:
1. 2. 3. 4. 5.

Intheleftpanel,selectLicensing. ClicktheUploadLicensebutton. Browsetoyourlicensefileorfiles.(SeeLicensingonPage11formoreinformation.) Uponsuccessfulinstallationofthelicensefile,selectWMServerintheleftpanel. ClickStartWMServer.

note ............. both the Apache Service and the WM Service should show as Started.

WMinstallationiscomplete,licenseisloaded,andtheserviceisstarted.TheserverisreadyforaWM clienttoconnect.

3.6

Service Packs
Navigatetohttp://www.cambiumnetworks.com/support/planning/index.php?cat=1&type=1and checkforanyavailableservicepackstoapply.Applythemaftertheserverhasbeengivenan opportunitytostartupandinitializeeverything.

17

WM Release 4.0 Quick Start Guide

Issue 1 May 2012

BAM Installation
IftheWM/BAMcombinationpackagewaspurchased,theBAMportionshouldbeinstalledafterWM hasbeeninstalledandlicensed.ForBAMfunctionality,thePrizmsoftwareisusedinBAMonlymode. IfBAMwasnotpurchased,proceedtoPostInstallationonPage27.

4.1

ODBC Installation
TheMySQLODBCDrivermustbeinstalledbeforethePrizminstallation.Thisdriverisnotprovided withtheinstallation,butisavailableathttp://dev.mysql.com/downloads/connector/odbc/3.51.html. FollowtheinstructionstoobtaineithertheLinuxorWindowsversionoftheODBCDriverandinstall it.

4.2

Prizm/BAM Download and Install

Prizmcanbedownloadedfrom http://www.cambiumnetworks.com/support/planning/index.php?cat=2&type=1.Thefileto downloadisPrizm3.3.10InstallerforLinux(orWindows).Besuretochoosethecorrectplatform foryourserver,LinuxorWindows. Runthefileonyourserver.

ClickNext.

19

Issue 1 May 2012

WM Release 4.0 Quick Start Guide

ThisdialogwillbeshownforonlyWindowsinstallations.IfWirelessManagerwasinstalledonthis server,thispackagehasalreadybeeninstalled.Thesecondoptioncanbeselected.Thispackagewill showupinAdd/RemoveProgramsasMicrosoft Visual C++ 2005 Redistributable. ClickNext.

ReadandaccepttheLicenseAgreement,thenclickNext.

20

WM Release 4.0 Quick Start Guide

Issue 1 May 2012

SelectonlyPrizmEMSandUserGuides.DonotselecttheLicenseManagerandPostgreSQLDatabase options. ClickNext.

InspectthePreInstallationSummary,thenclickInstall.

21

Issue 1 May 2012

WM Release 4.0 Quick Start Guide

Thisscreenmayappear.Selectionshouldbeyourpreference,basedonlocaloperations.

SelectYestoruntheServerAdmintoolafterinstallation.

22

WM Release 4.0 Quick Start Guide

Issue 1 May 2012

Theinstallationiscomplete.ClickDone. ThePrizmServerAdminToolwillrun.ThefollowingstepsillustratethemethodofconfiguringPrizm toruninBAMonlymodeandtousetheinfrastructureprovidedbyWirelessManager. ForServerMode,selectBAMOnlyasillustrated.

23

Issue 1 May 2012 SelectDatabasefromthecolumnontheleft.

WM Release 4.0 Quick Start Guide

SelectMySQLastheDatabaseType. UsetheODBCDriverpulldownmenuandselectthedriverinstalledearlier. CreateauseranddatabaseforPrizmintheexistingMySQLinstallation. MySQLwillneedtobeusedfromthecommandline.

Linux:run/usr/bin/mysql user=root -p Windows:runc:\MySQL Server 5.0\bin\mysql user=root p ThesystemwillpromptfortheMySQLrootpassword.Thedefaultpasswordispublic.

24

WM Release 4.0 Quick Start Guide

Issue 1 May 2012

CreatethePrizmdatabaseviacreate database prizm;asshown. Verifythecurrentdatabaselistviashow databases;

CreatetheuserexpectedbyPrizm. GranttheuseraccesstothePrizmdatabaseasfollows:
GRANT ALL on prizm.* to 'bost_user'@localhost IDENTIFIED BY 'bost_user';

Thedatabaseanduserhavenowbeencreated.Usequit;toclosemysql.

TheJDBCdrivermustbeloaded.ThesedriversareincludedintheWirelessManagerinstall. ClickBrowseandnavigatetothefollowinglocation: Windows:C:\Cambium\WM\server\mysql\driver Linux: /usr/local/cambium/wm/server/mysql/driver

ClicktheTestbuttontoverifytheconnectiontotheMySQLdatabase.Iftheconnectionis unsuccessful,ensurethatthedatabase,user,andpasswordcreatedmatchthosethatwereexpected byPrizm.

25

Issue 1 May 2012

WM Release 4.0 Quick Start Guide

4.3

BAM Documentation
DocumentationforPrizm/BAMisprovidedasthe"UsingtheBandwidthandAuthenticationManager (BAM)Subsystem"sectionoftheWMuserguide.

26

WM Release 4.0 Quick Start Guide

Issue 1 May 2012

5
5.1

Post Installation
Configuring the Proxy on a WM Client
IftheWMclientdoesnotneedaproxyservertoreachtheInternet,thissectionmaybeskipped entirely. IfaProxyServerisusedtoaccesstheInternet,thereareafewissuesthatmustbeaddressedbefore boththePhysicalMapandclient/serverconnectionwilloperateproperly.Twopossibilitiesexist: Case1wheretheclientandserverareonseparatemachines Case2,whereserverandclientareonthesamemachine

Directlyafterinstallation,mostuserswillbeunderCase2,astheywillwanttotrytoruntheclienton thesamemachineastheserver.Thismeansthatalltheseinstructionsmustbefollowed,asthe machineisperformingbothclientandserverduties.

IfaproxyisneededforInternetconnectivity,thisinformationmustbeenteredinboththeJava ControlPanelandthewebbrowser.

5.2

Set Proxy Information in the Java Control Panel

LaunchtheJavaControlPanel: WindowsStartSettingsControlPanelJava Linux/usr/local/cambium/wm/jre/bin/jcontrol

27

Issue 1 May 2012

WM Release 4.0 Quick Start Guide

ClickNetworkSettingsfromtheGeneral tab.

SelectUseproxyserverandenteryour proxyinformation(whatisshownisonly anexample). Often,youwillneedtospecifythatthe proxynotbeusedforlocaladdresses,of whichtheWMServermightbe. CheckBypassproxyserverforlocal addresses,thenclickAdvanced.

28

WM Release 4.0 Quick Start Guide

Issue 1 May 2012

EntertheIPaddressorIPmaskthatwill matchtheaddress(es)onyourserver. Yournetworkadministratorwillbeableto helpyouwiththis. Rememberthismustbefollowedforeach clientmachinewhereaproxywillbeused.

29

Issue 1 May 2012

WM Release 4.0 Quick Start Guide

5.3

Set the Proxy Information in the Web Browser

WhenaProxyServerisused,an exceptionisusuallyspecifiedso thattheWMServercanbe reached.Thefollowingexample explainshowtodothisinMozilla Firefox3inWindows.Otherweb browserswillalsohaveafacility forthis;yournetwork administratorshouldbeableto helpwiththissetup. InFirefox,selectToolsOptions. SelecttheNetworktabandclick SettingsintheConnectionsection.

TheHTTPProxyinformationwould mostlikelyalreadyexisthere.Ifit doesnot,itwouldneedtobe added,otherwisetheweb browserwouldnotbeableto reachtheInternet. AtNoProxyfor:,entertheIP addressorIPMaskthatmatches theserverIP.Thiswillbethesame informationaswasenteredinthe JavaControlPanel,howeverthe formatmightbeslightlydifferent. Inthisexample,weused
10.0.0.0/8,whichmeansthe

computerwilllooknotlooktothe ProxyforanyIPaddressmatching 10.x.x.x. Differentwebbrowserswillhavea similarmethodforadding exceptions,butitmightlook slightlydifferent.

30

WM Release 4.0 Quick Start Guide

Issue 1 May 2012

5.4

Unable to launch the application Error

Youwillalsoreceivethiserrorifanyof theproxyinformation(Javaorweb browser)isincorrect.SeetheConfiguring theProxyonaWMClientonPage27. Ifyouhavealreadyconfiguredtheproxy information,youmightneedtoflush Javasfilecache,sothenewfilecanbe loaded.

FromtheJavaControlPanel,select SettingsfromtheTemporaryInternet Filessection.

31

Issue 1 May 2012

WM Release 4.0 Quick Start Guide

ClickDeleteFiles,anddeleteboth ApplicationsandAppletsandTraceand LogFiles. ClickOK. TrytolaunchtheWebStartClientagain.

32

WM Release 4.0 Quick Start Guide

Issue 1 May 2012

Starting and Stopping the WM Service

ThepropermethodofstartingandstoppingtheWMServicediffersdependingontheoperating system.Thissectionreferstotheservicethatisrunningontheserver,nottheclientapplication. Linux,fromthecommandlineoftheserver:
service wmserver startwillstarttheserver service wmserver stopwillstoptheserver service wmserver restartwillstop,thenstarttheserver service wmserver statuswillreturnthecurrentserverstatus net start wmserverwillstarttheserver net stop wmserverwillstoptheserver

Windows,fromthecommandlineoftheserver:

Alternatively,youcanuseWindowsGUI: ControlPanelAdministrativeToolsServices.Theservicenameiswmserver.

33

WM Release 4.0 Quick Start Guide

Issue 1 May 2012

Starting the WM Client

Afteranynecessarypostinstallationtasksarecompleted,andtheWMServiceisstarted,theclient canbelaunched.EnsuretheclientcomputermeetstherequirementsasoutlinedunderClient RequirementsonPage7.
1. 2. 3.

Fromtheclient,launchawebbrowser. FindtheIPaddressoftheWMServer. TypeandopenthisURLinthewebbrowser: http://WMServerIPAddress:9090.

4.

Ifyoudonotseeapageaspicturedabove,ensurethattheWMServerisrunning,thattheIP addressiscorrect,andthatyouhavefollowedtheinformationinConfiguringtheProxyona WMClientonPage27. ClicktheWebStartClientbutton.Dependingonyourbrowser,thenextdialogboxmight lookslightlydifferent.ThegoalistoopentheWebNMS.jnlpfilewithJava.Inthecase below,clickOK.

5.

35

Issue 1 May 2012

WM Release 4.0 Quick Start Guide

IftheoptiontoopenwithJavaisnotavailable,ensureyouhaveinstalledJavaasnoted underClientRequirementsonPage7. Ifyouseethefollowingerrordialog,thisindicatesthatexceptionswerenotsetcorrectlyon thewebbrowsersproxy,ortheJavacachemustbepurged.SeeUnabletolaunchthe applicationErroronPage31.

Ifalliswell,theWMclientauthenticationdialogshouldappear.EntertheUserIDandPasswordas shownbelow,thenclickConnect.

ThedefaultUserIDisrootandtheassociatedPasswordispublic. Uponsuccessfulauthentication,theWMclientopens.

36

WM Release 4.0 Quick Start Guide

Issue 1 May 2012

37

WM Release 4.0 Quick Start Guide

Issue 1 May 2012

Device Discovery
UponinitiallaunchoftheWMClient,theInventorywillbeempty.YounowneedtouseDiscoveryto findandaddyourdevicestoWM.Hereiswhatisneededforthisprocess: YoumustknowtheIPaddressesofthedevices,oronwhichsubnet(s)thedevicesreside. ThedevicesmustbereachablefromtheWMServer.Otherwise,nocommunicationcantake place. YoumustknowtheSNMPport,community,andanyauthenticationinformation (ifnecessary)forthedevices.WMsupportsSNMPv1,v2c,andv3.

ThefollowinginformationisusedintheDiscoveryexample: deviceIP=10.24.1.1 SNMPinfo version=SNMPv1 Communitystring=pubic Port=161

8.1

Discovery Example

Fromthemainmenu,selectToolsDiscovery Configurator.

OntheGeneraltab,checktheseboxes:

AutoDiscovery RediscoveryAlreadyDiscovered EnableLog

39

Issue 1 May 2012

WM Release 4.0 Quick Start Guide

SelecttheNode Discoverytab.For thisexample,we onlydiscovera singlenodeasa test. Enterthe IPAddress, SNMPVersion,and SNMPAgentPort thatcorrespondsto adeviceonyour network.

ClickAdd. Theinformationyou enteredshould appearinthetable atthetopofthe dialogbox. ClickApply.

Intheaboveexample,asingleIPhasbeensubmittedforDiscovery.TheNetworkDiscovery tabworksthesameway;however,withthismethodanentireIPsubnetcanbescannedat onetime.Foralargegroupofdevicesthatallresideonthesamesubnet,useNetwork Discovery,e.g.10.24.1.x.

40

WM Release 4.0 Quick Start Guide

Issue 1 May 2012

8.2

Monitoring the Discovery Process

AfterapplyinganewDiscoveryset,theresultscanbemonitoredelsewhereinWM.Thiscontinues fromtheexampleabove.

Fromtheleftside tree,expand Inventoryand selectNetworks.

TheNetworks windowwillshow allDiscoveries thathavebeen submittedand theircurrent status.

Rightclickona linetoreveal optionsforthat Discovery (StopDiscovery orStart Discovery). DeleteObject andTraceswill deletethat Discovery. Towatchthe resultsofthe Discovery process,expand Fault Management fromtheleftside tree,andselect DiscoveryEvents.

41

Issue 1 May 2012

WM Release 4.0 Quick Start Guide

Inthisexamplethenodeat10.24.1.1wassuccessfullydiscovered,andthenwentintoClearstatus.

8.3

Discovery Troubleshooting
IfaDiscoveryisnotsuccessful,performthefollowingchecks: Confirmthatthedeviceexists. ConfirmthatitisreachablefromtheWMServer. DevicesmustbereachableviathenetworkfromtheWMserver.Beingreachablefromthe WMclientisirrelevant.FromtheWMserver,trytopingthedevicesIPaddressorpullupits webpage,ifapplicable. VerifythatthefollowingSNMPcredentialsusedwerecorrect: SNMPversion SNMPport SNMPcommunitystring(casesensitive) inSNMPv3,allthesecuritycredentials.

ChecktheDiscoverylogs. LookingattheDiscoverylogscanbeveryhelpfulindeterminingwhatishappeningonthe server.ThelogsprovidemuchmoreinformationthanisgivenintheWMclientGUI.Lookfor thelatestdiscoverylogs*.txtfileat Linux/usr/local/cambium/wm/server/logs WindowsC:\Cambium\WM\server\logs

42

WM Release 4.0 Quick Start Guide

Issue 1 May 2012

Physical Map
WirelessManagerhasaPhysicalMapmodulethatallowsoperatorstoplacetheirdeviceswith respecttorealworldlocation,visualizethedevicesgeographically,andseetheconsequencesof problems.ForthePhysicalMaptooperate,theWMClientmusthaveanInternetconnectionwith correctproxysettings,ifapplicable.SeeConfiguringtheProxyonaWMClientonPage27.

9.1

Placing Devices on the Physical Map

Thereareafewmethodsofplacingdevicesonthephysicalmap. Individualdevicescanbemanuallyplaced.FromtheInventoryscreen,rightclickonadevice andselectSetLocationinPhysicalMap.ThedevicewillappearinthePhysicalMapanda varietyofoptionswillbepresented,includingclickanddrag,addresssearch,and latitude/longitudeentry. PMPdeviceswillbeplacedonthePhysicalMapautomaticallyafterDiscoveryiftheLatitude, Longitude,andAltitudefieldsarealreadypopulatedwithvaliddatainthecorrectformat. LatitudeandLongitudeareindecimaldegrees,withSouthernandWesternHemispheresas negativenumbers.Forexample,NewYorkCitywouldberepresentedas: Latitude:40.756 Longitude:73.986 TheAltitudefieldisinterpretedasthedeviceheightaboveterrain,inmeters. DevicescanbeplacedonthePhysicalMapbycreatingageolocationfileandimportingit. Thiswillworkforanysetofdevices.

Theformatforthegeolocationfileisacommadelimitedtextfileasfollows:
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.

TheName(ID)columnmustcorrespondtothevaluesastheyappearinthedevicesName(ID)column intheInventory.

43

Issue 1 May 2012

WM Release 4.0 Quick Start Guide

Toplacetheseitems,ageolocationfilewouldlooklikethis:
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,colonscanbeusedasthedelimiterinsteadofspacesfortheMACaddress:
Version: 1 Create Date: 01/24/09 02:05:12:10:09:40, 30.27715,-97.69645,8

Afterthelocationfileiscreated,importitviaToolsPhysicalMapGeolocationImport(CSV).

9.2

Physical Map Troubleshooting

IfyouseethefollowingmessageinthePhysicalMappanel,itindicatesafailuretoconnectdueto networkproblems.VerifyyourInternetconnectionandproxy,ifapplicable.SeeConfiguringtheProxy onaWMClientonPage27.

Ifyouseethefollowingmessage,itmeansthatthesystemclockissetincorrectlyontheserver.Be suretochecktimezoneaswell.

44

WM Release 4.0 Quick Start Guide

Issue 1 May 2012

Resources for Support

Community Forum
ThetechnicalsupportCommunityForumispartofthesupportwebsiteandcanbeusedforasking questionsdirectlytothesupportteam.Questionsandanswersareaccessibletoallsothatany customercanbenefitfromthesamedialogue.Toaccessthisforum,visit http://www.cambiumnetworks.com/forum/.Thefollowingisanexampleofthecontentsofthe forumpage:

Thisforumrequiresauthenticationforposting.

45

Issue 1 May 2012

WM Release 4.0 Quick Start Guide

Technical Support
YoucanobtainsupportforWirelessManagerfromanyorallofthefollowingsources: WirelessManagersetupguide,administrationguide,andreleasenotes. CambiumNetworkssupportwebpage:http://www.cambiumnetworks.com/support. Thispageprovideslinkstoinformationonallproductsandtools,aswellasaccessto customersupportmaterialsandinteractivesupportforums.Someoftheseresourcesare restrictedtoregisteredusersandchannelpartners.

theCommunityForum.Visithttp://www.cambiumnetworks.com/forum/.SeeCommunity ForumonPage45. directcontactwithCambiumNetworksTechnicalSupport.Thiscontactisavailable7days aweek,24hoursaday.Tofindtheappropriatephonenumberbasedonyourcountryor region,visithttp://www.cambiumnetworks.com/support/technical.php. atechnicalsupportcase,whichyoucanopenat http://www.cambiumnetworks.com/support/support_case.php.Thecasecapturesbasic informationaboutanswersyouareseekingortheproblemthatyournetworkis experiencingandprovidesthistothesupportteam,whoareavailable7daysaweek, 24hoursaday,andwillrespond.Theywillalsoprovideacasenumberbywhichyouand theycancontinuetotrackprogressonissuesthatrequiredeeperinvestigation.

46