WM4 0ServerAdministrationGuideIssue3

Cambium Wireless Manager Server Administration Guide
System Release 4.0
Issue 3 August 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.SeeLegal NoticesandLicenseAgreementsonPage137. 2012CambiumNetworks,Inc.AllRightsReserved.
Table of Contents
Accuracy...................................................................................................................................... 2 Copyrights ................................................................................................................................... 2 Restrictions ................................................................................................................................. 2 LicenseAgreements.................................................................................................................... 2
About This Administration Guide ....................................................................13

1.1 1.2 1.3 1.4 1.5 1.6 1.7 1.8 NewinThisIssue........................................................................................................... 14 FeaturesNewinRelease4.0......................................................................................... 14 CorrectionsinThisGuide.............................................................................................. 14 Chapters........................................................................................................................ 15 ReferencestoOtherWMDocuments .......................................................................... 16 LinkstoOtherImportantDocuments........................................................................... 17 FeedbackonThisGuide ................................................................................................ 17 ReferencestoStartingandStoppingtheWMService ................................................. 17
Management of the WM Server Device ............................................................19

2.1 2.2 2.3 2.4 2.5 2.6 LocalSetupforLaunchesofIncludedTools ................................................................. 19 PortManagement......................................................................................................... 20 NetworkInterfaceManagement .................................................................................. 22 IPAddressChangefortheWMServer ......................................................................... 22 UseofanUninterruptiblePowerSupply...................................................................... 23 Placementofpkg3FilesforNetworkElementUpgrades............................................. 23
MySQL Database Administration .....................................................................25

3.1 3.2 3.3 3.4 3.5 3.6 3.7
3.7.1 3.7.2
ChangingtheDatabaseAuthenticationinWM ............................................................ 25 StartingtheDatabase ................................................................................................... 25 ReinitializingtheDatabase .......................................................................................... 25 RestoringtheWMDefaultDatabaseConfiguration..................................................... 26 BackingUptheEntireDatabase ................................................................................... 26 RestoringtheEntireDatabase...................................................................................... 27 MaintainingtheIntegrityoftheDatabase ................................................................... 27
AddressingTableCorruptiononaLinuxPlatform ................................................................ 27 AddressingContinuousGrowthofDataFilesonaWindowsPlatform................................. 28
Network Discovery Setup and Debug...............................................................31

4.1 ReadingDiscoveryDebugMessages ............................................................................ 31
4.2 4.3 4.4
TemporarilyDisablingUpdatestothePhysicalMaptoSpeedUpDiscovery .............. 32 GettingGenericElementsDiscovered .......................................................................... 33 ExpandingorShrinkingAreasforPresumedLogicalRelationships.............................. 34
5 6
Predefined Information Structures for Device Support ........................................37 Fault Management Configuration .....................................................................39
6.1 6.2
6.2.1 6.2.2 6.2.3
OpeningTrapPorts ....................................................................................................... 39 EnablingPrintforEventsandAlarms ........................................................................... 39

EnablingPrintinWindows .................................................................................................... 40 EnablingPrintinLinux ........................................................................................................... 41 EnhancingthePrintedOutput .............................................................................................. 41
6.3
ConfiguringFaultManagementParameters ................................................................ 41
Performance Management Configuration ..........................................................47

7.1 7.2 7.3 ManagedObjects.......................................................................................................... 47 OperatordefinedReports ............................................................................................ 50 CollectedStatisticsPlotforPollFailure ........................................................................ 51
Security Management Configuration.................................................................55

8.1 8.2 8.3 8.4 8.5 8.6 8.7 8.8 8.9 DefiningandManagingaGrouporaUser ................................................................... 55 DefiningandManagingAuthorizedandCustomViewScopes .................................... 56 AddingandManagingOperations ................................................................................ 56 EnablingtheAuthorizedModeforSecurityOperations .............................................. 56 ConfiguringSecurityManagementParameters ........................................................... 58 ConfiguringPasswordComplexity ................................................................................ 58 EnforcingOneSessionperUser.................................................................................... 59 ManagingExpiryforUserAccountsandPasswords..................................................... 61 RestoringaDeletedsuperuserAccount ....................................................................... 61
Offline Physical Map Setup .............................................................................63

9.1 9.2 9.3 DeployingGeoServer .................................................................................................... 63 CreatingMapLayers ..................................................................................................... 64 PrecachingtheMapImages ........................................................................................ 66
10
10.1 10.2
Optimization of WM Server Performance ......................................................67

OptimizingMySQLDatabasePerformance .................................................................. 67 LockingandTerminatingIdleClientSessions............................................................... 68
11 12 13
13.1 13.2 13.3 13.4 13.5
User Scripts Setup .....................................................................................69 Management of WM Server Logs..................................................................71 WM Software Upgrades and Downgrades......................................................73
WMUpgradetoRelease4.0......................................................................................... 73 MigrationofOperatorDataThroughWMUpgradePlusOSUpgrade......................... 84 ServicePackorFeaturePackInstallation ..................................................................... 85 ServicePackorFeaturePackUninstallation................................................................. 89 WMDowngradefromRelease4.0 ............................................................................... 91
14
14.1 14.2 14.3 14.4 14.5 14.6
WM Software and Feature Licensing .............................................................95

LicenseTypes ................................................................................................................ 95 CalculationoftheNumberofNodestobeLicensed.................................................... 95 NotificationsofLicenseLimits ...................................................................................... 96 WMLicenseReplacement ............................................................................................ 96 RecoveryFromForgottenPasswordfortheLicenseManagerAdministratorTool..... 96 DeploymentofRedundantLicenseManagerServers .................................................. 98
PurposeofRedundancy .................................................................................................... 98 ConfigurationofLicenseKeyFilesforRedundancy.......................................................... 98 RedundancyDeploymentProcess .................................................................................... 99 FailureorRebootofaLicenseManagerServer.............................................................. 101 ChangeintheIPAddressofaLicenseManagerServer.................................................. 102 ServerRestartsinLMRedundancy ................................................................................. 102
14.6.1 14.6.2 14.6.3
14.7
WorkaroundforaLicenseServerFailure ................................................................... 101
14.7.1 14.7.2 14.7.3
15
15.1 15.2 15.3 15.4 15.5 15.6 15.7
WM Administrator Tool for Server Administration ........................................103

UsingtheWMServerPanel ........................................................................................ 103 ConfiguringtheBAMPanel......................................................................................... 105 ConfiguringtheDatabasePanel ................................................................................. 106 UsingtheLicensingPanel ........................................................................................... 107 ConfiguringtheNBIPanel........................................................................................... 110 UsingtheOfflinePhysicalMapPanel ......................................................................... 111 ConfiguringtheEmailConfigurationPanel ................................................................ 113
16
16.1 16.2
MIB Browser Usage..................................................................................115

InvokingtheMIBBrowser .......................................................................................... 115 ConfiguringtheMIBBrowser ..................................................................................... 116
16.2.1 16.2.2 16.2.3 16.2.4 16.2.5 16.2.6 16.2.7 16.2.8
SettingCommonParameters.......................................................................................... 116 StoringTableEntriesinaSerializedFile ......................................................................... 119 StoringTableEntriesinaDatabase ................................................................................ 119 SettingMIBParameters .................................................................................................. 120 LoadingMIBs................................................................................................................... 120 UnloadingMIBs............................................................................................................... 122 PerformingSNMPOperations ........................................................................................ 123 SettingSNMPTableOptions........................................................................................... 126
16.3 16.4
InterpretingMIBBrowserErrorMessages ................................................................. 129 FAQs ............................................................................................................................ 134
Legal Notices and License Agreements .................................................................137

CAMBIUMNETWORKS,LTDENDUSERLICENSEAGREEMENT............................................... 137 CAMBIUMPUBLICLYAVAILABLESOFTWARELEGALNOTICESANDENDUSERLICENSE AGREEMENTSFORPUBLICLYAVAILABLESOFTWARE ............................................................ 142 SoftwareIncludedbyCambium.............................................................................................. 143 PackagesThatUseApacheLicenseVersion2.0 ..................................................................... 147 THIRDPARTYPUBLICLYAVAILABLESOFTWARELEGALNOTICESANDENDUSERLICENSE AGREEMENTSFORPUBLICLYAVAILABLESOFTWARE ............................................................ 151 SoftwareIncludedbyCommercialThirdPartySoftware ....................................................... 152 PackagesThatUseGNULesserGeneralPublicLicenseVersion2.1 ...................................... 158 PackagesThatUseApacheSoftwareLicenseVersion1.1...................................................... 166
Abbreviations ....................................................................................................169 Technical Support..............................................................................................171

RunningtheCustomerSupportTool ...................................................................................... 171 OptionsforRunningtheSupportTool.................................................................................... 171 ContactingSupportRepresentatives...................................................................................... 172
List of Figures
Figure1:SecurityAdministrationTreeGroupOperations ...................................................................... 57 Figure2:CommandoptiontouploadanindividuallicensefiletoLicenseManager................................. 81 Figure3:UpdateManagerinterface........................................................................................................... 86 Figure4:ServicepackInstallationWizard .................................................................................................. 87 Figure5:ServicepackReadmewindow ..................................................................................................... 88 Figure6:ServicepackUninstallwindow .................................................................................................... 89 Figure7:ServicepackUninstallationstatuspanel ..................................................................................... 90 Figure8:LicensingConfigurationpanelinLicenseManagerwebserver................................................. 100 Figure9:LicensingStatuspanelinLicenseManagerwebserver............................................................. 101 Figure10:WMServerpanelofWMAdministratorTool.......................................................................... 103 Figure11:BAMpanelofWMAdministratorTool .................................................................................... 105 Figure12:DatabasepanelofWMAdministratorTool ............................................................................. 106 Figure13:LicensingpanelofWMAdministratorTool ............................................................................. 107 Figure14:UploadLicenseFiledialog........................................................................................................ 108 Figure15:LicenseManagerStatusdisplaywindow ................................................................................. 109 Figure16:NBIpanelofWMAdministratorTool,activeSNMPV3settings ............................................. 110 Figure17:NBIpanelofWMAdministratorTool,activeSNMPV1/V2settings ....................................... 111 Figure18:OfflinePhysicalMappanelofWMAdministratorTool ........................................................... 112 Figure19:EmailConfigurationpanelofWMAdministratorTool ............................................................ 114 Figure20:MIBBrowsermainGUI............................................................................................................. 115 Figure21:MibBrowserSettingsdialog ..................................................................................................... 117 Figure22:LoadaMIBFilePanelMIBSettingsTab ................................................................................ 121 Figure23:SNMPTable.............................................................................................................................. 126 Figure24:SNMPTableSettingsPanel ...................................................................................................... 127
List of Tables
Table1:Portsthatmustbeopen ............................................................................................................... 20 Table2:Structuredinformationresourcespergeneraldevicetype.......................................................... 37 Table3:FaultManagementconfigurablefields ......................................................................................... 41 Table4:PerformanceManagementconfigurablefields ............................................................................ 47 Table5:RecommendedMySQLparametervalues..................................................................................... 67 Table6:Logfilespresentbydefault ........................................................................................................... 71 Table7:MibBrowserGeneraltabfields ................................................................................................... 117 Table8:SecurityparametersforaccessingSNMPv3agents .................................................................... 118 Table9:MibBrowserErrorMessages ....................................................................................................... 129
List of Procedures
Procedure1:TosetupWindowstoallowallAdministratorstolaunchWMtools ................................... 19 Procedure2:Toconfigureserverclientcommunicationsafterinstallation .............................................. 21 Procedure3:TostarttheMySQLdaemonasaserveronLinux................................................................. 25 Procedure4:ToreinitializetheMySQLdatabase ..................................................................................... 25 Procedure5:TorestoretheinstalledWMdatabaseconfiguration ........................................................... 26 Procedure6:TodetectandrepaircorruptedMyISAMdatabasetables.................................................... 28 Procedure7:Toreclaimharddrivespacefromburgeoningdatabasefiles............................................... 29 Procedure8:Totemporarilydisableupdatestothephysicalmapdisplay................................................ 32 Procedure9:Todisplayandstorefailedstatisticspolls............................................................................. 51 Procedure10:Toenableauthorizationsupport......................................................................................... 56 Procedure11:Toaddpasswordcomplexity............................................................................................... 58 Procedure12:Toprohibitmultiplesimultaneoussessionsbyanyoftheusers ........................................ 59 Procedure13:Torestorethesuperuseraccountandthesecuritytoolcache .......................................... 61 Procedure14:TodeployGeoServer ........................................................................................................... 63 Procedure15:Tocreatealayerfromoneimage ....................................................................................... 64 Procedure16:TocreateadatastoreforGeoServerworkspaceimages ................................................... 64 Procedure17:ToverifythatGeoServerconnectstotheimagedatastore ............................................... 65 Procedure18:Toaddanimagetoanexistinglayer................................................................................... 65 Procedure19:Toprecachealltilesforalllevelsofzoom ......................................................................... 66 Procedure20:TooptimizetheMySQLdatabaseresourcesforWM ......................................................... 67 Procedure21:Toestablishsessionidletimelimits .................................................................................... 68 Procedure22:ToupgradeWMtoRelease4.0........................................................................................... 74 Procedure23:TomigrateoperatordatainupgradeofWMplustheOS .................................................. 84 Procedure24:Toinstallaservicepackorfeaturepack ............................................................................. 86 Procedure25:Touninstallaservicepackorfeaturepack ......................................................................... 89 Procedure26:ToresettheLicenseManagerAdministratorToolpassword ............................................. 97 Procedure27:Todeployredundantlicenseservers .................................................................................. 99 Procedure28:ToconfigureWMforofflinephysicalmapimages ........................................................... 112 Procedure29:ToreconfigureofflinephysicalmapimagesinWM.......................................................... 113 Procedure30:Toconfigureserverandadminemailsettings .................................................................. 114 Procedure31:ToinvoketheMIBBrowser ............................................................................................... 115
WM Release 4.0 Server Administration Guide
Issue 3 August 2012
1 About This Administration Guide

important ........... The installation tool for the WM server deposits an issue of the Cambium Wireless Manager Release 4.0 Server Administration Guide and the Cambium Wireless Manager Release 4.0 User Guide into the ...server/help directory on the WM server. These documents are placeholders. Immediately after your server installation is completed, visit http://www.cambiumnetworks.com/support/planning/index.php?cat=1&type=0. If a later iteration of either or both of these documents is present there, download it and delete the superseded book. Throughout the life of Release 4.0, this web site will always contain the latest supporting documents. Whenever the issue number available at this site is greater than what you currently have, you need to download the replacement.
AllinformationpertainingtotheWMserverfilesystemispresentedfortheserveradministrator acrossthefollowingdocuments: CambiumWirelessManager4.0QuickStartGuide.Thisguidedocuments thesystemrequirements theprocedureforafreshinstallation clientdevicesetup SNMPbroadcasttoggling startingandstoppingtheWMservice launchingtheclient settingup,monitoring,andtroubleshootinginitialdiscovery licensingWMsoftwareandthephysicalmap startingandstoppingtheWMservice portusage databaseadministration serversideadjustmentsfor discovery faultmanagement performancemanagement securitymanagement theofflinephysicalmap
WirelessManagerRelease4.0ServerAdministrationGuide.Thisguidedocuments
serverlogs licensingandupgradingWMsoftware backingupthesystem usingtheMIBbrowser
13
Issue 3 August 2012
1.1
New in This Issue

Issue3introducesthefollowingchangestothisguide: Asectionisaddedtochangecollectedstatisticsgraphingsuchthatfailedpollsto unresponsiveelementsareapparentinthedisplaysofstatistics.SeeCollectedStatisticsPlot forPollFailureonPage51. ConfiguringPasswordComplexityonPage58isaddedtodescribehowaschemetomake passwordsmoresecurebywayofmorecomplexcanbeintroduced. EnforcingOneSessionperUseronPage59isadded,providingtheinstructionsforan operatortoconfigureWMtodenyuserswhoattempttoopenasecondclientsession. ThefollowingsectionsareremovedandreplacedbyChapter10,OptimizationofWMServer PerformanceonPage67: OptimizationofSystemResources,previouslySection12.2 OptimizationofOperatorinstalledDatabase,previouslySection12.3
1.2
Features New in Release 4.0

Release4.0introducesthefollowingfeatures: eliminationoftheneedforoperatorstohavetheirownphysicalmaplicenses.Thisis reflectedin LicenseTypesonPage95. NotificationsofLicenseLimitsonPage96 Procedure22:ToupgradeWMtoRelease4.0onPage74
asystemconfiguredviewofeventsthatarerelatedtodiscovery.Aswithitemsthatthe NetworkEventsviewlists,theseDiscoveryEventsviewitemsarestoredinthedatabasefor sevendays,unlessoperatorconfiguredforremovalatashorterorlongerinterval,whichcan beaccomplishedbyeditingthevalueoftheCLEAN_EVENT_INTERVALparameterinthe NmsProcessesBE.conffileintheWMserver.SeeConfiguringFaultManagement ParametersonPage41. synchronizationfunctions(buttons)addedtotheWMServerpaneloftheWMAdministrator Tooltolaunchremovalofallevents,alarms,andtrapsinprocess,whileleavingallelements' statisticsuntouched.SeeUsingtheWMServerPanelonPage103. removaloftheSystemAdministrationwebinterface.ThisaffectsProcedure13:Torestore thesuperuseraccountandthesecuritytoolcacheonPage61,whichisrevisedtousethe SecurityAdministrationtoolintheWMclientapplication. variousotherimprovementsthataredocumentedinthereleasenotesand/ortheuser guide.
ForexistingWMoperators,theupgradepathtoRelease4.0andupgradeprocedureareprovided underWMUpgradetoRelease4.0onPage73.
1.3
Corrections in This Guide

Step8ofProcedure7:ToreclaimharddrivespacefromburgeoningdatabasefilesonPage29has beenremoved.ThebackupfilesthatStep8advisedtheoperatortocreateareinfactcreatedby MySQLwhenitrestarts.Usinganyotherbackupsforthesecancauseproblems.
14
Issue 3 August 2012
1.4
Chapters
Thisserveradministrationguideisorganizedasfollows: Thischapter describesthescopeofthisguideandprovides referencesandlinkstootherimportant documentsthatsupportWMandnetwork elements. Chapter2,ManagementoftheWMServerDevice liststheportsthatmustbeopeninthefirewall settingsontheserverdeviceanddescribesthe configurationthattheserverrequiresfor executingtools,forusingthepropernetwork interfacecard,andforadaptingtoanewIP address.Italsoemphasizestheimportanceof deployinganuninterruptiblepowersupplyand providesthelocationforplacementofdevice firmwarepackagefiles. Chapter3,MySQLDatabaseAdministration describeshowtoconfigure,start,andinitialize thedatabaseandhowtorestoretheWM configurationandbackupthedatabase. Chapter4,NetworkDiscoverySetupandDebug describeshowtomakeserversideadjustments tothewayWMisconfiguredforDiscoveryand wheretofindDiscoveryrelateddebugmessages.
Chapter5,PredefinedInformationStructuresforDeviceSupport liststhestructuredinformationresourcesfor supportdevicesincludedintheserverfilesystem. Chapter6,FaultManagementConfiguration describesserversideadjustmentstohowWM isconfiguredforFaultManagement. Chapter7,PerformanceManagementConfiguration describesserversideadjustmentstohowWM isconfiguredforPerformanceManagement. Chapter8,SecurityManagementConfiguration describesserversideadjustmentstohowWM isconfiguredforSecurityManagement.This discussionincludeshowgroupsandusers, authorizedandcustomview,andoperationsare configuredforsecurity,howtosetthe authorizationforsecurityadministration, configurecertainsecurityparameters,andset whenaccountsandpasswordsaretoexpire. Chapter9,OfflinePhysicalMapSetup describeshowtoinstallandconfigureGeoServer, createmaplayersfromimages,andprepare layersforefficientpanningandzooming.
15
Issue 3 August 2012 Chapter10,OptimizationofWMServerPerformance
providesspecificMySQLdatabaseconfiguration parametervaluesthatarerecommendedforall operatorsandstronglyrecommendedfor operatorswhomanagelargenetworks,andalso describeshowtolimitidleclienttimeby configuringautomaticlockupsandterminations forsessionsthatareidletoolong.
Chapter11,UserScriptsSetup providestheproperpathandmodeformounting operatordefinedscriptsontheserver. Chapter12,ManagementofWMServerLogs describeshowtomanagelogsthattheserver logs. Chapter13,WMSoftwareUpgradesandDowngrades describeshowtoupgradeWMtoRelease4.0. Chapter14,WMSoftwareandFeatureLicensing describesthelicensingandlicensemanagement schemesthatRelease4.0supports:licensetypes (WMserver,physicalmaps,andnodepacks),how tocalculatetheneededquantitiesofthese,and howtheWMclientcautionstheuserof approachinglicensedeficiencies.Thischapter alsoincludesinformationonhowtoreplacethe serverlicense. Chapter15,WMAdministratorToolforServerAdministration showsdefaultvaluesforfieldsofthetoolpanels anddescribeshowtosetupWMtoconnectto GeoServerandretrievemapimagesfromit. Chapter16,MIBBrowserUsage describeshowtoinvoke,configure,and troubleshoottheembeddedMIBbrowser.
1.5
References to Other WM Documents

Ifyouareaclientadministratororuser,usetheCambiumWirelessManagerRelease4.0UserGuide. ForhighleveldescriptionsofnewfeaturesincludedintheinitialdistributionofRelease4.0,orforall disclosuresaboutfeaturesthatthisdistributionsupports,seetheCambiumWirelessManager Release4.0ReleaseNotes. FordocumentationsupportwithBAMintegration,seethefollowingdocumentation: CambiumWirelessManager4.0QuickStartGuide Procedure22:ToupgradeWMtoRelease4.0onPage74ofthisserveradministrationguide CambiumWirelessManager4.0UserGuide
16
Issue 3 August 2012
1.6
Links to Other Important Documents

Forlinkstoimportantdocumentsaboutsupportednetworkelements,visitthefollowingwebpages: PTPdeviceandPTPLINKPlanneruserguidesandreleasenotesat http://www.cambiumnetworks.com/support/ptp/software/index.php?tag=linkplanner PMPdeviceuserguides,releasenotes,andMIBsat http://www.cambiumnetworks.com/support/pmp/software/index.php awiderangeofPMP320devicedocumentsat http://www.cambiumnetworks.com/support/pmp/software/index.php CMMuserguidesandreleasenotesat http://www.cambiumnetworks.com/support/pmp/software/index.php
Forlinkstoimportantdocumentsaboutmanagementtools,visitthefollowingwebpages: WirelessManagerguides,releasenotes,andservicepacknotesat http://www.cambiumnetworks.com/support/planning/index.php?cat=1&type=0 CambiumNetworkUpdaterTool(CNUT)onlinehelpfileandreleasenotesat http://www.cambiumnetworks.com/support/planning/index.php?cat=3&type=0 Prizmguides,releasenotes,anditsSDKat http://www.cambiumnetworks.com/support/planning/index.php?cat=2&type=0
Forlinkstonetworkelementfeaturesandspecifications,visitthefollowingwebpages. CambiumPTPandCambiumNetworksLINKPlannerat http://cambiumnetworks.com/support/ptp/software/index.php CambiumPMPathttp://cambiumnetworks.com/support/pmp/software/index.php
Fordeclarationsofconformityforindividualnetworkelementsintheirvariousfrequencyband ranges,seehttp://www.cambiumnetworks.com/doc.php.
1.7
Feedback on This Guide

Weencouragefeedbackonourdocumentation,including opinionsonthestructureorcontentofthedocuments. anotificationtousaboutadeficiencyinaccuracyorcompleteness. anyothercommentsyouhave.
Pleasesendyourfeedbacktosupport@cambiumnetworks.com.
1.8
References to Starting and Stopping the WM Service

Someproceduresinthisguide(suchasbackup,restore,andupgrade)requirestart,stop,orrestartof theservice.Youalsomayalsobeaskedtorestartservicesaspartoftroubleshootingeffortsunder theguidanceoftechnicalsupportstaff.Whenyouneedtorestartservices,usetheWM AdministratorToolwithitsJavainterfaceasdescribedunderUsingtheWMServerPanelon Page103.
17
Issue 3 August 2012
2 Management of the WM Server Device

Thischapterdocumentscertainsetupandconfigurationstepsthatarerequiredforproperoperation ofthegeneralfunctionsoftheWMserver.Chaptersthatfollowaddressrequirementsforspecific featuresofWM.
2.1
Local Setup for Launches of Included Tools

Bydefault,Windows2008imposesasecurityschemethatlimitstoolexecutionstothedefault Administratoraccount,theBuilt-in account for administering the computer/domain. Itdoesnotextendthisprivilegetootheraccountsthathavebeenconfiguredinthe BuiltinAdministratorsgroup.Toextendittoallofthem,thefollowingworkaroundsetsupthelocal Windowsdevicetopromptthoseadministrators,uponanattempttolaunchatool,forwhetherto allowJavathewriteaccessrequiredfortheexecution.Thisprocedureisrequiredonce,exceptifthe parametersthatitsetsbecomereconfigured.
Procedure 1: To set up Windows to allow all Administrators to launch WM tools

1. 2. 3. 4. 5. 6. 7. 8. LogintotheserverdeviceastheAdministratorwithadministrativeprivileges (theBuilt-in account for administering the computer/domain). NavigatetoC:\Cambium\WM\jre\bin. Rightclickthefilejava.exeandselectProperties. Intheresultingdialog,clicktheCompatibilitytab. Nearthebottomofthisdialog,clicktheChangesettingforallusersbutton. Nearthebottomoftheresultingdialog,checkthecheckboxofthe Runthisprogramasanadministratoroption. ClickOKtoconfirmanddismissthislatterdialog. ClickOKtodismisstheoriginaldialog.
NowwhenanymemberoftheBuiltinAdministratorsgroupintheActiveDirectoryDomainServices areaattemptstolaunchatoolfromtheC:\Cambium\WM\jre\binfolder(eitherdoubleclicksthe toolnameorrightclicksitandselectsOpen),Windowswillpromptthatuserforwhethertoallowthe program(Java)tomakechangestothecomputer.TheusershouldclicktheYesbuttoninresponseto thisprompt. Othersectionsofthisadministrationguideprovidevariousproceduresthatinvokesuchtools.These sectionsincludebutmaynotbelimitedto ReinitializingtheDatabaseonPage25 DefiningandManagingaGrouporaUseronPage55 RestoringaDeletedsuperuserAccountonPage61 ServicePackorFeaturePackInstallationonPage85 InvokingtheMIBBrowseronPage115 RunningtheToolfromtheServeronPage171
19
Issue 3 August 2012
2.2
Port Management
ThefollowinglistshowsalistofthespecificportassignmentsinusebyWirelessManager components.Eachmustbeopeninthefirewall,ifafirewallisimplemented.
Table 1: Ports that must be open

Server Port Usage
1
25 OutboundconnectiontoSMTPserverforemailconfiguration. 80 OutboundconnectiontoBAMservertolaunchitsinterface. 161 InboundUDPforthenorthboundinterface(NBI). 161 OutboundUDPfordeviceSNMPqueriesandconfigurations. 162 InboundUDPforSNMPtrapsfromdevices. 1234 InboundUDPforAPstorequestauthenticationsfromBAM. 1476 Configurationserver. 1482 Socketserver. 2000 Networkmanagementbackendserver. 2501 ToturntheSMAutoupdatefeatureonoroffinAPs.
WM
3306 QueriestotheMySQLdatabase. 6900 InboundTCPforTFTPconnectionsinthefirmwareupgradeprocess. 8003
OutboundUDPforSNMPresponseoverthenorthboundinterface (NBI). TCPconnectionsbyTomcatandwebserverforaccesstodevice managementwebpages.2
8009
8090 InbounddatafromtheBAMserver. 9090 InboundTCPforthewebserver. 32900
NMSSocketforTCPcommunicationbetweentheWMserverand WMclient.3 NMSFESecondaryforTCPcommunicationbetweentheWMserver andWMclient.4
33100
61001 OutboundUDPfromBAMtoAPs. 27000 WMtorequestlicenses.

5
LicenseManager
27443
SecurecommunicationsbetweenWMandthewebserverofLicense Manager.5
20
Issue 3 August 2012 Usage
Server
Port
1521
OptionalOracleJavaNamingandDirectoryInterface(JNDI) connectionpoolviaTomcat. CommunicationsbetweenWMandthewebadministrationinterface ofGeoServer.
GeoServer
8080
NOTES:
1. 2. 3. 4. 5.
Portnumberisreconfigurablein.../server/conf/WibbWMSConfiguration.xml. Portnumberisreconfigurablein.../server/Apache/Tomcat/conf/server.xml. Mustbeconfiguredin.../server/conf/transportProvider.confwithWMserver stoppedafterWMinstallation. Mustbeconfiguredin.../server/conf/serverparameters.confwithWMserver stoppedafterWMinstallation. Portnumberisreconfigurablein.../server/conf/licensing.xml. AsindicatedinNote3andNote4above,theNMSSocketportandNMSFESecondaryportmustbe configuredafterWMhasbeeninstalledandstopped.Todoso,performthefollowingsteps.
Procedure 2: To configure server-client communications after installation

1. 2. 3. 4. IftheWMserverisrunning,launchtheWMAdministratortool. StoptheWMserver,asdescribedunderUsingtheWMServerPanelonPage103. Openthefile.../server/conf/transportProvider.confforediting. Findthetag<PORT_TO_LISTEN>.
5.
Changeitsvaluefrom0tothatofanyavailableTCPport(forexample,32900).
21
Issue 3 August 2012 6. 7. 8. 9. Saveandclosethefile.
Openthefile.../server/conf/serverparameters.confforediting. Scrolltothebottomofthefile. Insertalinethathasthefollowingtext:

NMS_FE_SECONDARY_PORT 33100 where3100isanexampleavailableTCPport.
10. Saveandclosethefile. 11. StarttheWMserver,asdescribedunderUsingtheWMServerPanelonPage103.
2.3
Network Interface Management

ThelicensesthatCambiumNetworksprovidesdependontheparticularnetworkinterfacecard(NIC) thatyourLicenseManagerserverisusing.IfyouaddorremoveaNIConyourLMserverdevice,your WMlicensemayceasetobevalid.Ifthisoccurs,contactCambiumNetworkstorequesta replacementlicense. MultipleNICsonyourWMservermaypopulatetheincorrect(otherNIC)IPaddressintotheJava WebStartfile.TofixandpreventthisonaWindowsplatform,performthefollowingsteps: 1. 2. 3. 4. 5. OpentheControlPanel. Intheleftpanel,clickSwitchtoClassicView. Intherightpanel,doubleclickNetworkConnections. FromthemainmenuoftheNetworkConnectionswindow,select AdvancedAdvancedSettings. IntheAdaptersandBindingstaboftheAdvancedSettingswindow,ensurethatthe connectionoftheWMserverNICishigherinthelistthantheotherNIC.
2.4
IP Address Change for the WM Server

OnaLinuxplatform,wheretheWMserverIPaddressdiffersfromthatofitspreviousdeployment, somefurtheractionisrequired: IftheIPaddressisdynamic,thenarebootoftheserverdeviceallowstheservertoupdate itsinformation. IftheIPaddressisstatic,thenthe/etc/hostsfilemustbeupdatedtocontainavalid mappingofitsIPaddresstoitshostname(localhost.localdomainisnotvalid).
22
Issue 3 August 2012
2.5
Use of an Uninterruptible Power Supply

Aswithanysoftwarethatkeepsadatabase,aninterruptionofpowertothehostdeviceofthe softwarecanresultincorruptionofthedatabasethatrendersitscontentsirretrievableoruseless, becausethesoftwarecannotclosethedatabaseinpropersequence.Historicaldataaboutdevices thatWMwillcontinuetomanageislost.Tokeepthedatasaferfromcorruption,anoperatorcan deployanyofthefollowing: theWMHighAvailabilityfeaturewithdatabaseredundancy(seeCambiumHighAvailability forWirelessManagerServeronaLinuxPlatformSetupGuide) operatormanageddatabaseredundancyonaWindowsplatform anuninterruptiblepowersupply(UPS)
AUPSdeviceisrecommendedforatleastminimalprotection.
2.6
Placement of pkg3 Files for Network Element Upgrades

Placeandkeepinthe.../server/Tftpdirectoryoftheserverfilesystemall.pkg3filesthatneed tobeavailabletotheclientapplication.Thesewillbeautomaticallyloadedforpossibleselectionfrom PackageManagerbytheauthorizedclientuser.Inthatutility,theclient isnotcapableofbrowsingintheserverfilesystem. maybrowsetheclientdevicefilesystemtofindandloadadditional.pkg3files.Theserver willallowthosefilestobethenuploadedintothe.../server/Tftpdirectorysothatthey arelistedthenexttimethatPackageManagerislaunchedintheclient.
Giventhetworepositoriesforpackagefiles,eachhasthefollowingpotentialadvantage: thefilesinthe.../server/Tftpdirectoryoftheserverarealwaysautomaticallyloaded intoPackageManagerselection,regardlessofanyproblemstheoperatormayexperience withtheAddoperationinthatutility. thefilesselectedintheclientfromanywhereintheclientfilesystemareavailablefor loadingregardlessoftheanynetworkingconstraintsorconditionsthatwouldinhibit downloadsfromtheservertotheclient.
23
Issue 3 August 2012
3 MySQL Database Administration

ThischapterexplainshowtoconfigureWirelessManagertosupporttheMySQLdatabase.
3.1
Changing the Database Authentication in WM

IfthedatabaseusernameandpasswordinMySQLareeverchanged(forexample,throughthe commandlineinterfacetoMySQLServer),thenyoumustmakethecorrespondingchange(s)inthe DatabasepaneloftheWMAdministratorTool.SeeConfiguringtheDatabasePanelonPage106. Theseparameterscanbeedited,butultimatelymustmatchtheusernameandpasswordconfigured inthedatabaseitself.EditsintheDatabasepanelandcorrespondingchangesviathecommandline interfacetoMySQLcanalsobeusedtoovercomefromaforgottenpasswordorusernameforthe database.
important ........... Do not make any changes by directly editing the file /usr/local/cambium/wm/server/conf/database_params.conf in Linux (or the C:\Cambium\WM\server\conf\database_params.conf in Windows.
WMencryptsthedatabasepasswordthatisconfiguredintheWMAdministratorTool.So,the passwordstringdoesnotappearhumanreadableanywhereintheserverfilesystemortheclient application.
3.2
Starting the Database

WirelessManagerstartsandinitializestheMySQLdatabasebeforestartingWirelessManager modules.TheMySQLdaemonisstartedwhenthestartWMSscriptfilelocatedinthe C:\Cambium\WM\server\binfolderinWindowsisinvoked. InLinux,youneedtostarttheMySQLdaemonasaservicebeforestartingtheWirelessManager Server.
Procedure 3: To start the MySQL daemon as a server on Linux

1. 2. Loginasasuperuser. Enter$ /etc/rc.d/init.d/mysql start.
3.3
Re-initializing the Database

Performthefollowingprocedureifyouhavemodifiedanyofthedefaultsettingsandneedtore initializetheMySQLdatabase.Beawarethatthisprocedureremovesallofdatathatyourdatabaseis currentlystoring.Alldiscoveredelementsandallofthehistoricalinformationthatisassociatedwith themwillbedeleted.
Procedure 4: To re-initialize the MySQL database

1. 2. IftheWirelessManagerServerisalreadystarted,doapropershutdownofserver. Donotterminatetheprocessabnormallyorabruptly. IfWirelessManagerisalreadyinstalled,runthereinitialize_databasescriptfile locatedinthe/usr/local/cambium/wm/server/bindirectoryinLinux
25
Issue 3 August 2012
WM Release 4.0 Server Administration Guide (ortheC:\Cambium\WM\server\binfolderinWindows)tocleanupthetablesinthe database. 3. 4. MakesurethattheMySQLprocessisrunning. StarttheWirelessManagerServer.
Nowalloftheelementsmustberediscovered,andallperformancedatachartsandotherhistorical informationwillinitiallynotexist.
3.4
Restoring the WM Default Database Configuration

Performthefollowingprocedureonlyintheunlikelyeventthatyouchangedthetablestructureor deliberatelyalteredanyotherSQLsettingsandnowwanttoreverttotheconfigurationthattheWM installationtoolhadinstalled.
Procedure 5: To restore the installed WM database configuration

1. 2. IftheWirelessManagerserverisalreadystarted,doapropershutdownofserver. Donotterminatetheprocessabnormallyorabruptly. Copythedatabase_params.confandsnmpDatabaseSchema.conffileslocatedinthe /usr/local/cambium/wm/server/conf/MySQLdirectoryinLinux (ortheC:\Cambium\WM\server\conf\MySQLfolderinWindows)tothe /usr/local/cambium/wm/server/conf/directoryinLinux (ortheC:\Cambium\WM\server\conffolderinWindows). IfusingSNMPv3,adddatabaseconnectioninformationtothe
SnmpDefaultProperties.xmlfileinthe/usr/local/cambium/wm/server/conf directoryinLinux(ortheC:\Cambium\WM\server\conffolderinWindows).
3.
4. 5. 6.
Indatabase_params.conffileintheconfdirectory,specifythemachinenamewhere thedatabaseistorun,theusername,andthepasswordforthedatabase. MakesurethattheMySQLprocessisrunning. StarttheWirelessManagerserver.
3.5
Backing Up the Entire Database

GoodpracticeistoperiodicallyperformbackupsofyourWMdatabase.Thissectiondescribeshowto createabackupcopyofyourentiredatabase(itsconfigurationanditscontents)andtheentireWM systeminasingleoperation.Nodatabaseonlybackupissupported,andnonewouldalsobackupthe essentialinformationthatisstoredinfilesintheWMserverfilesystem.
note ............. Although the backup utility supports running while the WM service is up, it cannot keep stride with changes made via the Web Start client while the script is running. Thus, it is necessary to ensure that no Web Start client session is in progress at any time between when this script is launched and when it is finished. If a client session is running during the execution of the script, then a warning message informs the user of the backup operation and advises that all current requests will be satisfied when the backup is complete.
Theonlysupportedbackupisavailableasaclickoption(SystemBackup)intheWMAdministrator Tool.SeeUsingtheWMServerPanelonPage103.
26
Issue 3 August 2012
3.6
Restoring the Entire Database

RestoringtheMySQLdatabaseisaseffectiveasthedatabasesnapshotthatwasbackedup (seeBackingUptheEntireDatabaseabove).Nodatabaseonlybackupissupported,andnonewould alsobackuptheessentialinformationthatisstoredinfilesintheWMserverfilesystem.
note ............. To avoid confusion, ensure that no Web Start client session is in progress at any time between when the restore command option is launched and when it is finished.
Theonlysupportedrestoreisavailableasaclickoption(RestoreSystem)intheWMAdministrator Tool.SeeUsingtheWMServerPanelonPage103.Thisoptionrestoresnotonlythedatabase snapshot,butalsotheessentialfilesfromtheWMserverfilesystem.
3.7
Maintaining the Integrity of the Database

WMisdesignedtoproperlypopulateandreaditsownupdatesfromtheWMdatabase.Anychange indatabasecontentsthatanoperatordirectlymakesisexpresslynotsupportedandislikelytoresult inafailureofsomeproportioninthesystem. Itisstronglyrecommendedthatyoudeployanuninterruptiblepowersupply(UPS)fortheWMserver device.Eitherapoweroutageorahardrestartofthedevicewhileitisoperatingcanresultin corruptionofthedatabasetablesandmayrequirereinitializingthedatabaseandrediscoveringallof theelementsinyournetwork.AUPScansupplyenoughpowertoallowWMtoproperlyshutdown andavoiddamagetothedatabase. Despitegoodpractices,overtimeWMdatabaseswilllikelyrequirelocalmaintenance.Useoneofthe followingsectionstoavoidorcorrectWMdatabaseproblems: AddressingTableCorruptiononaLinuxPlatformonPage27 AddressingContinuousGrowthofDataFilesonaWindowsPlatformonPage28
3.7.1
Addressing Table Corruption on a Linux Platform

ThedefaultdatabaseengineforMySQLonaLinuxplatformisMyISAM.Withthisengine,database tablescanbecomecorrupted,regardlessofgoodoperatorpractices.Unexpectederrorssuchasthe followingmaysignalthatthishasoccurred:
Table './WMSDB/WMS_CUSTOMUSERPROPS' is marked as crashed and should be repaired
Periodicallysearchthecontentsofthefile.../server/logs/stderr*.txtforthepresenceof errorslikethis.Whenthesearepresent,useoneormoreofthefollowingprocedurestofindthe corruptedtable(s)andmakeappropriaterepairs: Reviewthedescriptionsofthetoolsandprocedures: http://www.databasejournal.com/features/mysql/article.php/3300511/RepairingDatabase CorruptioninMySQL.htm. Useaprocessofoneormoreofthefourstagesforcheckingalltablesatonceandrepairing corruptedtables:http://dev.mysql.com/doc/refman/5.0/en/myisamrepair.html.
27
Issue 3 August 2012

note ............. The process above requires stopping the MySQL service. The following does not.
UseProcedure6:TodetectandrepaircorruptedMyISAMdatabasetablesonPage28 todetectandrepaircorruptedtableswithouttheneedtostoptheMySQLservice.
Procedure 6: To detect and repair corrupted MyISAM database tables

1. 2. 3. SeeReferencestoStartingandStoppingtheWMServiceonPage17. StoptheWMservice. AtyourLinuxshellprompt,enteroneofthefollowingcommands:
mysqldump --user=root --password=public --databases wmsdb >wm_databases.sql mysqldump --user=root --password=public --databases wmsdb backedupdb1 [backedupdb2 ...backedupdb3] >wm_databases.sql mysqldump --user=root --password=public all-databases >wm_databases.sql
4. 5.
LogintoMySQL. Reviewhttp://dev.mysql.com/doc/refman/5.0/en/checktable.html.
note ............. In Steps 6, 8, and 9, the commands shown are to be executed on each table separately, not all tables in a single execution. The variable tablename represents the an individual table, such as wms_customuserprops.
6.
Todetecttablecorruptionineachtable,enterthefollowingcommandat themysql>prompt:
CHECK TABLE tablename;
7. 8.
Reviewhttp://dev.mysql.com/doc/refman/5.0/en/repairtable.html. Torepairatablethatwasfoundinthestepabovetobecorrupted,enterthefollowing commandatthemysql>prompt:

REPAIR TABLE tablename;
9.
Toverifythattherepairedtableisnolongercorrupted,enterthefollowingcommand atthemysql>prompt:
CHECK TABLE tablename;
10. Ifanytableremainscorrupted,see http://www.databasejournal.com/features/mysql/article.php/3300511/RepairingDatabase CorruptioninMySQL.htmand http://dev.mysql.com/doc/refman/5.0/en/myisamrepair.html. 11. Whenalltableshavebeencheckedandsuccessfullyrepaired,starttheWMservice. 12. Resumenormaloperations.
3.7.2
Addressing Continuous Growth of Data Files on a Windows Platform

ThedefaultdatabaseengineforMySQLonaWindowsplatformisInnoDB.Withthisengine,certain datafilescontinuouslygrowandeventuallyuseasignificantamountofharddrivespace.Nothing, evendeletingdatafromthedatabase,causestheirsizetoshrinkorlevelout.Atleastannually, reclaimthisstoragespacebyperformingProcedure7:Toreclaimharddrivespacefromburgeoning databasefilesonPage29.
28
Issue 3 August 2012
Procedure 7: To reclaim hard drive space from burgeoning database files

1. 2. 3. 4. Reviewhttp://dev.mysql.com/doc/refman/5.0/en/innodbdatalogreconfiguration.html. ReviewReferencestoStartingandStoppingtheWMServiceonPage17. StoptheWMservice. AtyourDOScommandutilityprompt,enteroneofthefollowingcommands:
mysqldump --user=root --password=public --databases wmsdb >wm_databases.sql mysqldump --user=root --password=public --databases wmsdb backedupdb1 [backedupdb2 ...backedupdb3] >wm_databases.sql mysqldump --user=root --password=public all-databases >wm_databases.sql
5. 6. 7.
StoptheMySQLservice. NavigatetotheMySQLdatafolder. Findallexistingtablespacefiles.
note ............. In the default WM implementation, these files are ib_logfile0, ib_logfile1, and ibdata1.
8. 9.
Deleteallexistingtablespacefilesfromthisfolder,includingtheibdata*andib_log* files. IfyouwanttoretaincopiesofthedatabasefoldersthatcorrespondtotheWMdatabase(s) thatyoubackedupwiththemysqldumpcommandinStep4,copythemtoportablemedia.
10. Deletethosedatabasefoldersfromtheharddrive. 11. StarttheMySQLservice. 12. Enterthefollowingcommandtoimportthedumpfilethatyoucreatedwiththemysqldump commandinStep4:

mysql --user=root --password=public < wm_databases.sql
13. IfapplicationsinadditiontoWMareusingtheinstanceofMySQL,usethisprocedureto backup,delete,andrestoretheirschemasaswell. 14. StarttheWMservice.
29
Issue 3 August 2012
4 Network Discovery Setup and Debug

AllchangesthataremadeintheDiscoveryConfiguratortooloftheWebStartclientareimmediately reflectedintheWMserverfilesystem.Onsubsequentstartups,theWirelessManagerserverreads thediscoveryconfigurationinformation,evenifthedatabaseisnotreinitialized.
4.1
Reading Discovery Debug Messages

Bydefault,detaileddiscoveryrelateddebugmessagesareloggedinthe AggregatedDiscoveryLogN.txtfileunderthe/usr/local/cambium/wm/server/logs directoryinLinux(ortheC:\Cambium\WM\server\logsfolderinWindows).Excerptsfromthislog areasfollows:
[16 Feb 2012 20:58:00:750] ================================================== Begin Basic Discovery Of: 10.60.2.35 ================================================== [16 Feb 2012 20:58:00:750] DISCOVERY(10.60.2.35:258): APDiscoveryFilter attempting discovery of [64 ed 57 20 15 4e] (isDHCP=true) [16 Feb 2012 processing. 20:58:00:765] DISCOVERY using a maximum of 6 threads for Deep Discovery
[16 Feb 2012 20:58:00:906] DISCOVERY(10.60.2.35:258): Device matched all 7 probes for device type PMP.320.AP (PMP.320.AP(e2.1.x)). [16 Feb 2012 [16 Feb 2012 valid MAC. 20:58:00:906] 20:58:02:359] DISCOVERY(10.60.2.35:258): Device has 7 Named Field(s) DISCOVERY(10.60.2.35:258): setNameToMac: MO name is a
[16 Feb 2012 20:58:02:359] DISCOVERY(10.60.2.35:258): validateExistingNode: No nodes exist with IP: [10.60.2.35] having invalid names. [16 Feb 2012 20:58:02:453] 57 20 15 4e to database [16 Feb 2012 [16 Feb 2012 for device 20:58:02:468] 20:58:02:468] DISCOVERY(10.60.2.35:258): Successfully added object 64 ed DISCOVERY using PDU max size 512 during deep discovery DISCOVERY(10.60.2.35:258): Creating Deep Discovery thread
[16 Feb 2012 20:58:02:468] DISCOVERY(10.60.2.35:258): APDiscoveryFilter completed shallow discovery of [64 ed 57 20 15 4e] (isDHCP=true) [16 Feb 2012 20:58:02:468] ================================================== End Basic Discovery Of: 10.60.2.35 ==================================================
AftertheDiscoverymoduleisinitialized,somediscoveryeventmessagesareavailableintheclient amongtheothernetworkeventmessages.TheDiscoveryLogtaboftheDiscoveryConfiguratorinthe clientprovidesthefullsetofdiscoverymessages,asitdisplaysthefullcontentsofthe discoveryLogs.txtserverfile.However,forrunningscriptsormakingselecteddumps,youmay findthataccesstothisserverfileismoreconvenient.
31
Issue 3 August 2012
Inaddition,someotherDiscoveryrelatedmessagesareloggedinthefilestdoutN.txtinthesame directory.Thefollowingareexamplemessagesfromthislog:
[24 Aug 2010 03:14:11:103] DISCOVERY(10.100.13.92:213): Unable to write to device while testing Write Community. Device is currently not writeable. Device's Write Community must be set manually. [24 Aug 2010 03:41:42:206] DEEPDISCOVERY(10.100.13.73:264): Device is 99% discovery complete. OIDs timed out: 280 [24 Aug 2010 03:41:43:123] ERRORLOG_POLLMGR(83): Polling Delayed for 5 minutes. Deep Discovery is still running for 4 devices.
4.2
Temporarily Disabling Updates to the Physical Map to Speed Up Discovery

Thephysicalmapmaysometimesnoticeablylagbehindthesecoresystems.Thisbehaviorisdesigned sothatupdatesinthephysicalmapdonotinterferewithWMcoredatagatheringandprocessing.In typicalnetworks,thedelaymaybeimperceptiblebut,especiallywhileWMisinitiallydiscovering thousandsofdevicesinaverylargenetwork,thephysicalmapmaydisplaytheupdatedinformation onlyafterminutesorevenhourshaveelapsed. Temporarilydisablingthecapabilityofthephysicalmaptodisplaychangescanspeedtheinitial devicediscoveryprocessbyafactorof3.Foryouroperations,thismaybemoreadvantageousthan experiencingthedesignedlag.Asserveradministrator,youcandosoasfollows.
Procedure 8: To temporarily disable updates to the physical map display

1. 2. 3. 4. StoptheWMserver. SeeReferencestoStartingandStoppingtheWMServiceonPage17. Navigatetothe/usr/local/cambium/wm/server/confdirectoryinLinux(orthe C:\Cambium\WM\server\conffolderinWindows). OpenthefileNmsprocessesBE.confforediting. Findthefollowinglines:
PROCESS com.motorola.wibb.ems.platform.server.starleaf.core.StarleafManager ARGS INCREMENTAL_DEVICE_UPDATE_ON true FULL_DATA_REFRESH_INTERVAL 86400
5. 6. 7. 8. SetthevalueofINCREMENTAL_DEVICE_UPDATE_ONtofalse. Saveandclosethefile. Starttheserver. SeeReferencestoStartingandStoppingtheWMServiceonPage17. Notifytheclientapplicationuserthatthisfeatureisdisabled.
32
Issue 3 August 2012
9.
Afterthediscovery(orotheroperationforwhichyoutemporarilydisabledthefeature)is completed,performthefollowingsteps:
10. StoptheWMserver. 11. ReopentheNmsprocessesBE.conffileforediting. 12. ResetthevalueofINCREMENTAL_DEVICE_UPDATE_ONtotrue. 13. Saveandclosethefile. 14. Starttheserver.
4.3
Getting Generic Elements Discovered

WMdiscoversasagenericelementanySNMPenablednonCambiumdeviceforwhichnovalid devicedefinitiontemplateexists.ThisisdistinguishedfromaCambiumdevices,forwhichadevice definitiontemplateispartoftheWMsoftwaredistribution,andfromanythirdpartydevicesfor whichtheoperatorhascreatedavaliddevicedefinitiontemplate. However,genericelementdiscoverydependsalsoonthefollowingworkaround.Checktosee whetherWMhasdiscoveredallofthegenericdevicesinthenetwork.ForanythatWMdidnot discover,performthefollowingsteps: 1. 2. 3. 4. SearchtheclientlogfortheIPaddressofthedevice. IfanentryisassociatedwiththatIPaddress,notewhethertheentryindicatesthatWM regardedthedeviceasunmanaged. Iftheentrydoes,openthefile...server\conf\devices\Generic_Element.xml forediting. IntheElement tag,adddisableDHCP="true",asshowninthefollowingeditedexcerpt:
- <ElementDefinition> - <Element type="Generic Element" specificType="Generic Element" version="1.0" treeIcon="images/Unknown_Device_16.png" mapIcon="Unknown_Device_55.png" vendor="Cambium Networks" disableDHCP="false" combined="false" relation="false" enableRelationshipCustomViews="true"> <IncludeTemplate name="templates/PhysicalMapBase.xml" /> <IncludeTemplate name="templates/GenericDashboardBase.xml" /> <ElementGroup name="Devices" displayName="Devices" treeIcon="images/Devices.png" mapIcon="Devices.png" />
5. 6.
Validatethexmlcontent. Writeandclosethefile.
TheresultisthatWMsucceedsindiscoveringallgenericelementsinyournetwork.However,WM willusetheMACaddressastheName(ID)ofanythatsupportandproperlyimplementDHCP.
33
Issue 3 August 2012
4.4
Expanding or Shrinking Areas for Presumed Logical Relationships

Basedoncomparisonsofcertainsettingsindevicetemplatesontheserverandthegeolocations definedfordevicesinyournetwork,thediscoveryengineinWMpresumeslogicalrelationships amongdevicesanddisplaysthese.Thepresumptionsaremadewheneverboth thegeolocationsliewithintemplatedefinedpositions(tolerances)thatestablishfour cornersofarectangle thedevicesareofdevicetypesthattogetherhaveapresumablehierarchicalrelationship (wouldconstituteanextendedfamily).
Perdevicetype,thetolerancescanbeeitherthedefaultsthatthedevicetemplatehasdefinedor newonesthattheserveradministratorhaseditedintothedevicetemplate.Administratorswhoedit devicetemplatesshouldkeepinmindthattheeditsapplytoalldevicesofthedevicetypeuntil furthereditsaremade. Thetolerancethatyousetisthedistanceinmeterstothenorthwest,northeast,southwest,and southeastfromanelementofthisdevicetype.WMwilllogicallylinktheelementtoanyelement configuredbytheattributetheirDeviceTypeinaKinLocationtag,ifdiscoveryfindsthatitsgeo locationiswithinthetolerance(thevalueoftheattributetolerance_minthetag).Thefollowingare examplesoftagcontentsinthecontextoftheirdevicespecifictemplatenames:

- <DefineTemplate name="pmp.ap.location.proximity.logical.family"> -  <KinLocation kinshipType="parent" myFieldSource="customUserProperties" myLatitudeName="Device Latitude" myLongitudeName="Device Longitude" theirDeviceType="PMP.CMM3" theirFieldSource="customUserProperties" theirLatitudeName="latitude" theirLongitudeName="longitude" theirSpecificType="any" tolerance_m="0.0" />
- <DefineTemplate name="cmm.location.proximity.logical.family"> -  <KinLocation kinshipType="parent" myFieldSource="customUserProperties" myLatitudeName="latitude" myLongitudeName="longitude" theirDeviceType="PMP.BHS" theirFieldSource="customUserProperties" theirLatitudeName="Device Latitude" theirLongitudeName="Device Longitude" theirSpecificType="any" tolerance_m="0.0" />
34
Issue 3 August 2012
- <DefineTemplate name="ptp.slave.location.proximity.logical.family"> -  -  <KinLocation allowSingleChildOnly="true" kinshipType="child" myFieldSource="customUserProperties" myLatitudeName="Device Latitude" myLongitudeName="Device Longitude" theirDeviceType="PMP.CMM3" theirFieldSource="customUserProperties" theirLatitudeName="latitude" theirLongitudeName="longitude" theirSpecificType="any" tolerance_m="0.0" />
35
Issue 3 August 2012
5 Predefined Information Structures for Device Support

Theserverfilesystemincludesstructuredinformationresourcestosupportdevicesasindicatedin Table2.
Table 2: Structured information resources per general device type

Predefined Structured Information Resource Devicedefinitiontemplate1 Configurationvalues pushtemplate
conf/devices/ Default Templates/Configuration Templates/
Path to Resource ...WM/server/
Configuredvaluesreporttemplate Default Templates/Report Templates/ Systemreport2 NOTES:

1. Default Templates/System Reports/
ThesetemplatesconfigurehowWMwillrecognizethedevicetypeduringdiscoveryand howWMshouldrepresentthedevicetypeintheuserinterface.Thetemplatesinthis directoryrefertoandpullinformationfromBasefilesinthetemplatessubdirectory. Unlikethetemplates,thesereportsdonotsupportgenericelements.
2.
37
Issue 3 August 2012
6 Fault Management Configuration

FaultManagementhandleserrorconditionsthatcauselossoffunctionalityofnetworkresourcesand itprovideseventmanagement,including alertgeneration automatedactions eventcorrelation filteringfortraps,events,andalerts parsingfortrapsandevents
Thesefeaturesenablenetworkoperatorstodetect,isolate,andrepairmalfunctionsinthenetwork andinitscontrolsubsystem.
6.1
Opening Trap Ports

AtrapportistheportonwhichtheWirelessManagerServerlistensforSNMPnotifications.Asthe serveradministrator,youcanconfigurethetrapportsinthefile /usr/local/cambium/wm/server/conf/trapport.confinLinux (ortheC:\Cambium\WM\server\conf\trapport.confinWindows).Thefollowingcaveatsapply: ThespecifiedportsarenotassociatedwithaparticularTrapParser,butageneral configuration. Whennoportisspecified,trapswillnotbereceivedatall. Multipleportscanbespecifiedusingacommaseparator,forexample8001,8002. Ensurethatthespecifiedportsarefree. Thedefaulttrapportis162.
6.2
Enabling Print for Events and Alarms

note ............. See also the section titled "Printing Events" in the Cambium Wireless Manager Release 4.0 User Guide.
Bydefault,theprintoptionforEventsandAlarmsinWirelessManagerisnotconfigured.Toenable printing,configurationmustbedoneinNmsProcessesBE.conffileinthe /usr/local/cambium/wm/server/confdirectoryinLinux (ortheC:\Cambium\WM\server\conffolderinWindows).Thiswillallowthecurrentcolumnsof analertsoreventspaneltobesenttoaprinterthatexistsinthenetworkoftheWMserver(and printingtoafileinthefilesystemof,orgreaternetworkof,theWMserver).Thefollowingisan excerptfromtheNmsProcessesBE.conffile:

#java com.adventnet.nms.eventdb.EventMgr [EVENT_DEBUG true/false] [SAVE_DIR save_dir] [PRINT_COMMAND print_command] [CLEAN_EVENT_INTERVAL num_days] [ALERT_DELETE_INTERVAL num_hours] [EVENT_WINDOW_SIZE logsize] [EVENT_OBJECTS_IN_MEMORY num] [MAX_EVENT_PROCESS_QUEUE num] [ALERT_OBJECTS_IN_MEMORY num] [EVENT_JDBC true/false] [ALERT_JDBC true/false] [ALERT_TO_MANAGEDOBJECT_PROPOGATION max/latest/none] [GROUP_ALERTS_MODE none/max/latest][ALERTS_USER_PROPERTY none/latest/append]
39
Issue 3 August 2012
TheprintfileargumentshouldbeconfiguredbasedonthevaluespecifiedforSAVE_DIRparameter. Whenyouexecutetheprintfunctionalityfromtheclient,WMtemporarilystoresalltheEvent/Alarm detailsinafilenamedprintfile.tmpintheSAVE_DIRdirectory.WhenPrintisinvokedthenext time,thedetailsintheprintfile.tmparereplacedbythosecorrespondingtothenextrequest.

note ............. The following sections include example values for print_command. All of these values are enclosed in double quotes, which are required for WM to read. When double quotes are not present, the system throws a TimedOutException 60 seconds after the client users launches the Print operation.
6.2.1
Enabling Print in Windows

ForaWMserveronWindows,theprintcommandshouldbeconfiguredasfollows:
PRINT_COMMAND "lpr -S server -P printername filename"
where
serveristhenameofthehostthatprovideslpdservice. printernameisthenameoftheprintqueue,whichismaintainedbytheprintertoputthe
jobintheprintqueueandprocess.
filenameisthenameofthetemporaryfilethatWMshouldwriteintotheSAVE_DIR
directory. Examples
SAVE_DIR state PRINT_COMMAND "lpr -S Duplex1 -P test state\\printfile.tmp"
where
Duplex1isthehostnameoftheserver. testisthenameoftheprintqueue. printfile.tmpisthefiletobeprintedinthestatedirectory.
Foraserverthatusesthesharedprinterofanotherdevice,theprintcommandshouldbeconfigured asfollows:
SAVE_DIR state PRINT_COMMAND "cmd /c copy state\\printfile.tmp \\\\user1\HPLaserJ"
where
printfile.tmpisthefiletobeprintedinthestatedirectory. user1isthedevicetowhichtheprinterisconnected. HPLaserJisthenameoftheshare.
40
Issue 3 August 2012
6.2.2
Enabling Print in Linux

ForaWMserveronWindows,theprintcommandshouldbeconfiguredasfollows:
PRINT_COMMAND "lpr filename"
where
filenameisthenameofthetemporaryfilethatWMshouldwriteintotheSAVE_DIRdirectory (forexample,save_dir//printfile.tmp).
6.2.3
Enhancing the Printed Output

Youmaywishtohavethecontentformattedbeforeitissentfortheprintprocess.Todoso,youcan scriptyourownprint.batorprint.shcommand,whichcallsthefmtcommandfirstandthentheprint commandasdocumentedabove.ForthiscaseinLinux,forexample,theprintcommandshouldbe configuredasfollows:
PRINT_COMMAND "sh print.sh"
6.3
Configuring Fault Management Parameters

TheFaultManagementmodulecanbeadministeredbyconfiguringthefollowingparametersin EventMgrprocessintheNmsProcessesBE.conffileinthe /usr/local/cambium/wm/server/confdirectoryinLinux (ortheC:\Cambium\WM\server\conffolderinWindows).
note ............. If you configure any parameter, you must restart the Wireless Manager server to put the new value into effect.
Thefollowingdescriptionsapplytotheconfigurableparameters.
Table 3: Fault Management configurable fields

Arguments Description Options
EVENT_DEBUG AsofthisRelease,this parameterisnotinuse.
Values Default
PRINT_COMMANDis dependentonSAVE_DIR. WhenPrintactionis invokedfromtheclient, thecontentswillbe temporarilysavedinafile printfile.tmpfileunder <SAVE_DIR>andthen printed.
Notes
SAVE_DIR
Usedtospecifythe directoryinwhichEvents andAlertsviewedbythe clientaretobesaved, whenthe'Save'optionis invokedfromtheclient.
Avalid& existing directory name,with thepath, relativeto WM_Home
state
41
Issue 3 August 2012
Arguments
Description Options
The Operating System specific command thatcould invokeprint actionfrom thesystem.
Values Default Notes
PRINT_COMMAND
Usedtospecifythe commandtobeexecuted, whentheuserinvokesthe Printoptionfromthe EventViewer/AlertViewer ofAppletclient.
PRINT_COMMANDis dependentonSAVE_DIR.
CLEAN_EVENT_INTERVAL
Usedtospecifythe numberofdaysafter whichtheEventshaveto becleanedup.
Anypositive integer value.
*7days
TheEventsolderthanthis numberofdays,willbe removedfromthesystem. Onceineveryhour,a checkforolderEventswill bedone. Whennegativevalueis specifiedforthe parameter,Eventswillnot bedeletedbasedontime interval. Onlythelatestnumberof eventsspecifiedbythis optionwillbemanagedby thesystem.Allother eventswillbeinthe database,butcannotbe viewedormanaged. However,thetotal numberofEventsinthe Clientmayexceedthe EVENT_WINDOW_SIZE, untilyourefreshit manuallyornavigatethe treenodes/pagesand thenrevisittheconcerned panel. Thisisbecause,oncethe totaleventcountreaches EVENT_WINDOW_SIZE, thenforeachandevery newEventadded,anold Eventshouldbefetched fromDBfordeletion, whichwillhaveabearing onPerformance.
EVENT_WINDOW_SIZE
Usedtospecifythe numberofeventsthat needtobeactively managedbythesystem.
10000
42
Issue 3 August 2012 Values Options Default Notes

Ifthesizeofthequeueis morethanthisnumber, theSysteminputwillbe suspendeduntilthe queuedEventsare processed.TheEvents thatyoutrytoaddatthis pointoftimewillnotbe addedintotheSystem. Youhavetotakecareof addingthoseEvents,after checkingthequeuesize usingthe is_inQ_SizeBeyondLimit() method.IftheEvent queuesizeisexceeded, waitforsometime(say1 sec)beforeretryingtoadd Events. MAX_EVENT_PROCESS_Q UEUEparameteris providedtoavoidsuch problemsandtokeepthe memoryundercontrol. Youcanconfigurethe Eventqueuesize(i.e.,the maximumnumberof Eventsthatcanbequeued whentheyareaddedinto thesystem)usingthis parameter. TheTrapPDUinformation intheEventscanbeused toeffectivelyparseand filterevents.
Arguments
Description
MAX_EVENT_PROCESS_QUEUE
Whentherateofincoming Eventsishighercompared totheprocessingrate,the additionalEventsmay havetobebufferedin memorywhichwillleadto anincreasedusageof memory.Atonepointof time,thereisapossibility ofanOutofMemoryError beingthrown.
*500
TRANSIENT_TRAP_PDU_IN_EVENT
Whethertomaintainthe receivedSNMPTrapPDU referenceintheEventor not. Whethertodropor continueprocessingthe SNMPtrap,ifits correspondingmanaged objectisinunmanaged state.
true/false
*false
DROP_TRAP_WHILE_UNMANAGED
true/false
*false
43
Issue 3 August 2012
Arguments
Description Options
Values Default Notes

Authorizationisthewayin whichanauthenticated userisvalidatedifheis authorized(hasbeen grantedthenecessary permission)whenhetries toperformaspecific operation.
AUTHORIZATION
Whethertoenable/ disableauthorization check,whenausertriesto performafault managementoperation, likepickingupalerts,and soon.
true/false
true
V3_AUTH
Whethertoenable/ disableauthenticationfor SNMPv3traps.
true/false
*false
InformRequestsare unsolicitednotifications sentby anAgenttoManager.
NEED_INFORM_ACK
Whethertoenable/disable WMtosend acknowledgment,forthe Informrequestsfromthe Agents.
true/false
*false
aManagertoManager. Inbothcases,an acknowledgmentwillbe sentbytheManagerafter itreceivesthenotification.
GRACEFUL_SHUT_DOWN
Whenaninterruptis receivedtoshutdownthe Server,wheresome Notificationsarestill pendingtobeparsedand filtered,howtodealwith themwhetherto (gracefully)shutdown aftercompletingthe furtherprocessingofthese Notificationsortostop processingandallowfor abruptshutdown. Batchupdateisusedwhen Eventsaretobeaddedto thedatabaseasabatchso astodecreasethenumber ofqueries,thereby enablinganincreasein performance.
true/false
false
BATCH_UPDATE
truebatch processingof Eventsis enabled falsebatch processingof Eventsis disabled.
*false
44
Issue 3 August 2012 Values Options Default Notes
Arguments
Description
Validfrom4.7SP1only Parametertoconfigure thefrequencyof CLEAN_EVENT_INTERVAL check.Bydefault,this checkwillbemadeevery onehour.
CLEANUP_QUERY_INTERVAL
Anyvalue from124
*1hour
Ifinvalidornegativevalue isspecified,WMwilltake thedefault1hour
PERSISTENCE_CLASS
Usedtospecifytheuser classesgeneratedby Generated extendingthe UserClass HbnEventPersistenceclass.
NOTE:*indicatesthattheoptionwillnotbepresentinNmsProcessesBE.confbydefault.
45
Issue 3 August 2012
7 Performance Management Configuration

7.1 Managed Objects
ThemaininputtotheperformancemoduleistheManagedObjectsthatarecreatedtorepresent networkdevices.TheseManagedObjectsarecreatedbytheWirelessManagerTopologymodule whenthediscoveryprocesstakesplace.ManagedObjectsholddetailsofnetworkelementssuchas: Name,Type,status,etc.DatacollectionisconfiguredfortheseManagedobjectsinthePerformance module. ThestartupoptionsofthePerformanceManagementmodulecanbemodifiedbyeditingthe parametersoftheCollectorprocessintheNmsProcessesBE.conffilelocatedinthe /usr/local/cambium/wm/server/confdirectoryinLinux (ortheC:\Cambium\WM\server\conffolderinWindows).
note ............. If you have updated any of the configuration parameters, be sure to restart the Wireless Manager Server.
Thefollowingaretheparametersthatyou,asanadministratorofthefilesystem,canadjustafter deployment.
Table 4: Performance Management configurable fields Parameter Description

Thisspecifiesthenumberofdaysafterwhichthedatacollected duringpolling(stringdataorstatsdata)havetobecleanedup.The dataolderthanthespecifiednumberofdayswillberemovedfrom thesystem.Thisdeletesthetableafterthespecifieddaysthatare appendedwiththedate.Ifasingletableisusedtostorethedatafor allthedays,thenthatwillnotgetdeleted. Defaultvalue:7 Thisspecifiesthemaximumnumberoftimesthesystemcantryto pingthedevicetoretrieveitsstatus.Thisindicatesthatrequestwill besentforSTATUS_POLL_PING_RETRIES+1times. Defaultvalue:0 Thisspecifiesthemaximumnumberoftimesthesystemcantryto performSNMPpingtothedevicetoretrieveitsstatus.Thisindicates thatrequestwillbesentforSTATUS_POLL_SNMP_RETRIES+1times Defaultvalue:0 Tospecifythetimeinsecondsfortheservertowaitfortherequest fromhost.ThisvalueisconfiguredforICMPPingwhennativepingis disabled Defaultvalue:1(i.e.,willwaitforonesecondifaparticularnodeis notreachable).
CLEAN_DATA_INTERVAL
STATUS_POLL_PING_RETRIES
STATUS_POLL_SNMP_RETRIES
STATUS_POLL_PING_TIMEOUT
47
Issue 3 August 2012
Parameter
Description
Thisspecifiesthemaximumnumberoftimesthesystemcantryto pingthedevicetoperformdatacollection(Polling).Thisindicates thatrequestwillbesentforDATA_COLLECTION_SNMP_RETRIES+1 times. Defaultvalue:0 PolledDatawiththesameAgent,ProtocolandPeriod(APP)are combinedanddependingonthisparameter,numberofpollstothe agentwillbedone.Forexample,iftheMAX_OIDS_IN_ONE_POLLis 10andthenumberofPolledDatawiththesameAPPis20,thentwo setsofpollswiththefirstsetcontaining10andsecondwith10willbe done,andthevalueswillbestoredinthetableinwhichtheyare intendedtogo. Defaultvalue:15
DATA_COLLECTION_SNMP_RETRIES
MAX_OIDS_IN_ONE_POLL
CUSTOMIZED_DATA_COLLECTOR
Thisspecifiesthefullyqualifiedclassnamewhichhasimplemented theinterfaceCustomDataCollection. Thisisacustomizer(basicallytheGUI)thatistobebroughtupwhile addingormodifyingapollingobject.Thisparameterallowstheuser tohavehis/herownPropertyforthepollingpoliciesinsteadofthe oneprovidedbydefault. Thisparameterisdeprecatedinlaterreleases. Theparameter,whensetas"true"printsoutdebuggingstatements inthelogfilewhichcanbeusedtoanalyzethedatacollection.Itcan
POLLING_POLICY_CUSTOMIZER
DEBUGGING_MODE
beturnedon/offusingthemethodsetDebugMode() inthe PollAPI.Whiledevelopinganapplication,thesedebuggingstatements willbeofgreatusetothedevelopertoknowabouttheproblemthat hasoccurred. Defaultvalue:false Whenthisparameterissetasfalse,theMultiplePolledDatafroma singletablewillbepolledseparately. Defaultvalue:true Thisspecifiestheintervalbetweentwosuccessivequeriestothe database,forstatuspolling. Defaultvalue:1500 Thisspecifiedtheintervalbetweentwosuccessivequeriesfor retrievingpollingunitstobepolled. noteThis parameter has been deprecated in later releases. The interval is now the value of the GlobalPerformancePollingInterval tag in the .../WM/server/conf/ WibbWMSConfiguration.xml file. However, the interval should be set in the Polling Configuration dialog, not in this configuration file on the server. Thisspecifieswhetherauthorizationisrequiredforalltheclient requestsornot. Defaultvalue:false
SEND_MULTIPLE_REQUEST
STATUS_POLL_QUERY_INTERVAL
DATA_COLLECTION_QUERY_INTERVAL
AUTHORIZATION
48
Issue 3 August 2012
Parameter
Description
WheneveramanagedobjectispassedthroughPolling.conf,and whenitsatisfiesthematchcriteriaspecifiedinthefirstPollingObject, PolledDatawillbecreatedandwillnotcheckthematchcriteriagiven inotherPollingObjects.Settingthevalueas"true"forthisparameter willmaketheManagedObjecttocheckallthematchcriteriainallthe PollingObjects.Inthiscase,evenifthematchcriteriaofthefirst PollingObjectgetsmatched,theManagedObjectwillbepassedtothe subsequentPollingObjectsalso. Defaultvalue:false Whenthisparameterissetas"true",thePollIDandits correspondingkeywillbestoredinthePollIDToKeyMaptable.This willbeuseful,ifyouwanttoaccessthecollecteddataforthedeleted PolledData. Defaultvalue:false Thisparameterisusedwhenyouwantthecollectedvaluestobe updatedinadatabase,afteraspecifiedtimeinterval.Thisparameter takesitsvalueinseconds.Theinsertsforthecollectedvalueswillbe storedinatemporarymemorytillthistime,andwillgetupdatedasa bulkinthedatabase.
PASS_THRO_ALL_POLLING_OBJECTS
RECOVER_DELETED_PDATAS
BULK_INSERT_INTERVAL
Fore.g.ifBULK_INSERT_INTERVALissetto30,thenforeverythirty secondsthecollecteddatawillbestoredinmemoryasasingleinsert statement.Assoonasthirtysecondsgetelapsed,theinsert statementswillbeexecutedanddatawillbeinsertedintodatabase. Defaultvalue:0 Bydefault,collecteddataisinsertedassoonasitiscollectedandnot accumulatedinmemoryasabulk. Thisparameterisusedwhenyouwantthecollectedvaluestobe updatedinadatabase,afteraspecifiednumberofinsertsgetting accumulatedinthetemporarymemory.Thisparameterwilltakean integervalueandmanyinsertswillbestoredinthememory,beforeit writesintothedatabase.Tousethisparameter,the BULK_INSERT_INTERVALparametershouldalsobeused. noteWhen MAX_ALLOWABLE_INSERT value is reached, the interval set for Bulk insert is not taken into consideration and the insertion takes place immediately. Fore.g.ifBULK_INSERT_INTERVALissetto30secondsand MAX_ALLOWABLE_INSERTissetto10thenifthenumberofinsert statementsinmemorygoesabove10thenthough BULK_INSERT_INTERVALisnotreached,insertstatementswillbe executedanddatawillbetransferredtodatabase. Defaultvalue:0
MAX_ALLOWABLE_INSERT
49
Issue 3 August 2012
Parameter
Description
Thisparameterisusedtospecifythetimeperiodforwhichtheserver hastowait(afterithasgotstarted)tostartthestatuspollingof managedobjects
STATUS_POLL_DELAY
Thisparametercanbeusedincaseswhereyouhavelargenetworks tobediscoveredduringserverstartupandyoudonotwantthe servertobeloadedwithbothdiscoveryandstatuspolling.By configuringthisparameter,youcanpostponethestatuspollingfor sometime. Defaultvalue:5minutes Duringdatacollectionthereispossibilitythat theagentmightbedown theagentmightbedelayingtheresponse thereispacketlosswhiledataistransferred.
DATA_COLLECTION_SNMP_TIMEOUT
Inallsuchcircumstances,thedelaycausedcanbeindefinite.Hence youcansetaTimeoutwhichwillindicatethatPollEngineshouldwait forthatnumberofseconds.Ifrequesteddataisnotreceivedbefore thattime,anerrormessageisregistered. Defaultvalue:5seconds WhenaPolledDataiscreated,youmaywishtostartdatacollection foritimmediatelyorinduceadelay.Thiscanbespecifiedinthis parameter.Numericvaluesstartingfrom0isallowed.Ifyouspecify zero,datacollectionwillstartimmediately.Notethatthissettingis commonforallPolledDatacreatedinthesystem. Defaultvalue:5minutes Bydefault,statuspollingisperformedforeachoftheMOs,whereby aqueryissenttoeachoftheMOs.ThestatuspollingofMOscanbe processedinbatchesalso.Toenablethis,addanewparameter ENABLE_STATUS_POLL_BATCH(notavailablebydefault)andsetitto true.
DATA_COLLECTION_STARTUP_DELAY
ENABLE_STATUS_POLL_BATCH
7.2
Operator-defined Reports
Networkoperatorscanaddtheirowncustomdefinedreportsforlaunchingfromtheclient.These canbecraftedbyeither copyingexistingreportsintheSystem Reportsfolderandtheneditingthemtothetype andamountofcustomizationdesired. composingthemwithoutthereuseofanypreexisting(furnished)report.
Thecustomdefinedreportisthenplacedintoeither the...server\Default Templates\System Reportsfolder,foradevicespecific report the...server\PHP Reports\System Reportsfolder,foragenericreport,whichwill bevalidforadeviceofanytype.
50
Issue 3 August 2012
Eachofthesecustomreportsmustthenbeimportedintotheclientapplicationthroughaclient sessionfromtheserverdevice,followingtheuserguideproceduretitled"Toimportsystemreports" andbrowsingtooneorbothofthefolderswhosepathisnotedabove. Anycontextorotherproblemsinanoperatordefinedreportmaypreventthereportfrombeing listedin,andthusavailableforlaunchfrom,theclient.Whenyoumountacustomreport,youmay wanttosendamessagetotheclients(seetheuserguidesectiontitled"BroadcastingaMessage"), advisingusersofthenewreportandremindingthemtoimportitintotheSystemReportspanelof theclientsothattheywillhaveaccesstoit.
7.3
Collected Statistics Plot for Poll Failure

Bydefault,collectedstatisticsgraphsintheWMclientapplicationomitdatafromfailedpolling attemptsandplottheaverageacrossthemissingpointinthegraph,andWMdoesnotlogeventsfor failedstatisticspolls.Thiscanmakeissuessuchasanelementbeingoutofservicedifficulttodetect inthegraphorstatstableandshowuponlylaterinthelog.Thistreatmentisbecausethevalueof thePollFailedActionEnableflagispresettofalse.TochangethissettingsothatWMwill displayandstore0forthefloatvaluereceivedandNot polledforthestringvaluereceived,and willgenerateandeventthatthrowsthefailedpolltothelog,performthefollowingsteps.
Procedure 9: To display and store failed statistics polls

1. 2. 3. 4. 5. Browsetothe/usr/local/cambium/wm/server/confdirectoryinLinux ortheC:\Cambium\WM\server\conffolderinWindows. Inthetexteditorofyourchoice,openthefileWibbWMSConfiguration.xmlfilefor editing. SearchforPollFailedActionEnable. Changeitsvaluefromfalsetotrue. Writeandsavethefile.
51
Issue 3 August 2012
53
Issue 3 August 2012
8 Security Management Configuration

TheSecurityManagementmoduleofWMmaintainsandconfiguressecurityinformation,including definitionsofusersandgroupsandtheirpermissions.SecurityManagementprovidesthefollowing flexibilityincontrollingaccesstoWMandyournetworks: Bydefiningandmanaginggroupsandusers,youcanauthorizeuserstoperformonlycertain functions,basedonwhethertheyaremembersofagroupforwhichyouhavedefinedthe permissions. Youcanspecifyaccessforonlyacertainuserorgrouptobeabletoseeaparticularview. YoucanlimittheWMexperienceforausertoaspecificdevicetype.
8.1
Defining and Managing a Group or a User

AgroupisasetofpermissionsthataspecificsetofassociateduserscarryastheyusetheWMWeb Startclient.AgroupisdefinedbyauserwhohasadministrativepermissionsintheWebStartclient andaccessestheSecurityAdministrationareaviaitsToolsmenu.Awizardacceptsthegroupname fromtheadministratoranddisplaystheOperationsTreeRoot.Theadministratorconfirmsandatany latertimecanconfigurethegroup,whoisnowlistedintheSecurityTree. IntheSecurityTree,theadministratorcancheckthecheckboxforanyspecificfunctiontoallowand anytodisallow.Foranyfunctionthattheadministratormakesnocheckmarks,theparentfunctional areapermission(allowedordisallowed)isinheritedforallmembersofthegroup. Theprocessofaddingandmanagingauserissimilar,exceptthatWMappliestheresultofthe administratorspecifiedpermissionstoonlytheindividualuser.Toaddauserfromthecommandline interfaceontheWMserver,youcanexecutetheUserConfig.shorUserConfig.batfilelocated in/usr/local/cambium/wm/server/bin/admintoolsdirectoryinLinux(orthe C:\Cambium\WM\server\bin\admintoolsfolderinWindows)fromthecommandlineasfollows:
UserConfig.sh/bat Add > WirelessManager UserName Password Group
where:
UserNameistheusernameofthenewuser. Passwordisthepasswordtoauthenticatetheuserduringhislogin. Groupisthegrouptowhichtheusershouldbelong.
Example:
UserConfig.sh/bat Add > C:\program files\adventnet\webnms guest xyz Admin 1100
whereanewusernamedguestisaddedtoAdmingroupwithapasswordofxyztothedatabase.
55
Issue 3 August 2012
8.2
Defining and Managing Authorized and Custom View Scopes

ScopesthataWebStartclientadministratordefinesallowordisallowthemembersofanygroup(s) anactivitybasedonthevaluesofspecificproperties.InthecaseofCustomViews,thepermissions areenforcedonwhatsetsofdataandrepresentationsthegroupsanduserswillbeallowedtoseein WM.
8.3
Adding and Managing Operations

YetanotherwaytocordonoffusersfromthefullsetoffunctionsinWMisforaWebStartclient administratortospecify,byoperationinatreeofpossibleoperations,whichgroup(s)andwhich user(s)arepermittedtoperformthem.Althoughmostoftheoperationsintheoperationstreewill alwaysbepresentbydefaultinWM,theadministratorcanaddoperations(foraddedsub applications,forexample)inwhichtograntspecificpermissionlevels.
8.4
Enabling the Authorized Mode for Security Operations

ThesecuritymanagementmoduleinWirelessManagerprovidesanauthorizedmodeofperforming securityoperationsforagrouporuser.Thisfeatureisfacilitatedbyconfiguringthestartupoptionsof thesecuritymodule.
Procedure 10: To enable authorization support

1. BeforeyoustarttheWirelessManagerserver,openthefileNmsProcessesBE.conf presentinthe/usr/local/cambium/wm/server/confdirectoryinLinux(orthe C:\Cambium\WM\server\conffolderinWindows)forediting. Findthefollowingprocess:
com.adventnet.nms.security.authorization.NmsAuthManager
2. 3. 4. 5.
Configuretheargumentauthorization_for_security_administrationtotrue. Bydefault,thisvalueissettofalse. Saveandclosethefile. StarttheWirelessManagerserver.
Aftersettingtheauthorization_for_security_administrationtotrue,theauthorization supportisenabledforallsecurityoperations.Thisactionwillcausealluserstonotbeabletoperform theoperationsandsetpermissions(forwhichtheyarenotauthorizedtodo)intheSecurity AdministrationUI. Example Thisexamplecapturestwodifferentscenarios:authorizedmodeforsecurityoperationsand unauthorizedmodeofsecurityoperations.Thisexamplerevealsthedifferencebetweenan authorizedandanunauthorizedmodeofperformingsecurityoperations.Followthestepsgiven belowtoaccomplishthetask. 1. BeforestartingtheWirelessManagerserver,setthe
authorization_for_security_administration argumenttotruein NmsProcessesBE.conffilepresentinthe/usr/local/cambium/wm/server/conf directoryinLinux(ortheC:\Cambium\WM\server\conffolderinWindows).Thisisthe
authorizedmode.
56
Issue 3 August 2012
2. 3. 4. 5. 6. 7. 8. 9.
StarttheWirelessManagerserver. LogintotheclientasanadministratorwiththedefaultuserIDofrootandapasswordof
public.
Fromthemainmenu,selectToolsSecurityAdministration. RightclickontheGroupsnodeinSecuritytreeandselectAddGroup. CreateanewgroupcalledGroup1. ClickNext. InthePermissionstreehierarchy,enabletheSecurityAdministrationnode. DisableAddGroup,RemoveGroup,andRemoveOperationoperations. Agraphicdepictingthisconfigurationisshownbelow.
Figure 1: Security Administration Tree Group Operations
10. RightclickontheUsersnodeinSecuritytreeandclickAddUser. 11. CreateanewuserGroup1Userwiththepasswordgroup. 12. Inthefinalscreenofthewizard,selectGroup1underAssignGroupsfortheuserfield. 13. ClickFinish. YouhavenowassociatedtheuserGroup1UserwiththegroupGroup1. 14. ClickFinishtoquittheSecurityAdministrationUIandtheWirelessManagerclient. 15. Logintotheclientagain,butthistimewithauserIDofGroup1Userandapasswordof group. 16. SelectToolsSecurityAdministration.TheSecurityAdministrationwindowisdisplayed. 17. SelectFileAddGroup. WirelessManagerdisplaysawarningpopupwiththemessageGroup1User is not authorized to perform the operation.Thisoccursbecausewehavedisabledthis particularuserfromaddinganewgroup. 18. Similarly,tryremovinganexistinggroup.Thesamemessageisdisplayed. 19. Tryremovinganexistingoperation.Thesamemessageisdisplayed.
57
Issue 3 August 2012 20. Closetheclientandshutdowntheserver.
21. Settheauthorization_for_security_administrationargumenttofalsein NmsProcessesBE.conffilepresentinthe/usr/local/cambium/wm/server/conf directoryinLinux(ortheC:\Cambium\WM\server\conffolderinWindows).Thisisthe unauthorizedmode. 22. Restarttheserver. 23. LogintotheclientwithuserIDGroup1Userandpasswordgroup. 24. SelectToolsSecurityAdministration.TheSecurityAdministrationwindowisdisplayed. 25. Trytoaddanewgroup. Youwillbeabletocreatethegroupandnoerrormessageisdisplayed.Thisisbecauseno authorizationsupportisprovidedforperformingthesecurityoperationsalone.
8.5
Configuring Security Management Parameters

ThestartupoptionsoftheSecurityManagementmodulecanbemodifiedbyeditingtheparameters ofNmsAuthenticationManagerandNmsAuthManagerprocessesintheNmsProcessesBE.conf filelocatedinthe/usr/local/cambium/wm/server/confdirectoryinLinux(orthe C:\Cambium\WM\server\conffolderinWindows).
note ............. You must restart the Wireless Manager server if any of the configurable Security parameters have been updated.
Theparametersthatcanbeconfiguredbyadministratorsareasfollows: Tosetthecountformaximumallowedunsuccessfulloginattempts: maximum_allowed_login_failed_countinNmsAuthenticationManager Tosetthetimeintervalinmillisecondsforthesecurityscheduler: time_interval_for_security_schedulerinNmsAuthManager Tochangethepasswordafterthefirsttimeloggingin: change_password_for_firsttime_logininNmsAuthManager
8.6
Configuring Password Complexity

WithServicePack1orlater,aWMoperatorcanoptionallysetupWMtorequirethatthepasswords forallnewaccountsmeetacomplexstandard,suchascontainatleastoneofeachofcertaintypesof characters.Acommentedoutconfigurationisprovidedandcanbeeasilyputintoeffect,asisor modified.Tochangepasswordrequirementsforallusers,performthefollowingsteps.
Procedure 11: To add password complexity

1. Navigatetothefollowingdirectoryintheserverfilesystem: /usr/local/cambium/wm/server/conf/inLinuxor C:\Cambium\WM\server\conf\inWindows. Intheeditorofyourchoice,openthefileWibbWMSConfiguration.xml. Findanduncommentthefollowinglines: <PasswordComplexityExpression value="((?=.*[a-z])(?=.*[A-Z])(?=.*\d)(?=.*[@#$]).{5,24})" /> <PasswordComplexityErrMsg value="Password can have minimum 5 characters and maximum 24; It must contain at least One uppercase character from 'A-Z' AND One lowercase character from 'a-z' AND One digit from '0-9' AND One special character from '@#$'" />
2. 3.
58
Issue 3 August 2012
4. 5.
Toremoveormodifyanyoftheserequirements,updateboththeexpressionvalueandthe errormessagevalue. Toenforcetheserequirements,saveandclosethefile.
Sincetheimplementationofthisfeatureissubjecttospecificoptionsoftheoperator,theUser Administrationdialogintheclientapplicationisunchanged,exceptthattheerrormessagethatyou configuredinStep3willbethrownforpasswordsenteredthatfailtocomply.
So,operatorswhoenforcenewrequirementswillneedtoinformalltheusersaboutthechanges.The changestakeeffectthenexttimethattheserverisrestarted.
8.7
Enforcing One Session per User

Bydefault,WMallowsanyusertohavemultiplesimultaneousclientsessionsopen.InServicePack1 orlater,WMRelease4.0allowstheoperatortoconfigureWMtolimitalluserstoasinglesessionat anygiventime.Toconfigurethislimit,performthefollowingsteps.
Procedure 12: To prohibit multiple simultaneous sessions by any of the users

1. 2. 3. 4. 5. Browsetothe/usr/local/cambium/wm/server/confdirectoryinLinux ortheC:\Cambium\WM\server\conffolderinWindows. Inthetexteditorofyourchoice,openthefileWibbWMSConfiguration.xmlfilefor editing. SearchforIsAllowedMultipleInstances. Changeitsvaluefromtruetofalse. Writeandsavethefile.
59
Issue 3 August 2012
8.8
Managing Expiry for User Accounts and Passwords

Useraccountexpiryandpasswordexpiryaretwodifferententities.Youcanseparatelygiveauser nameandapasswordexpiry.Passwordexpiryischeckedonlywhentheusertriestologin.Theuser accountexpiryischeckedataregulartimeinterval.Thistimeintervalcheckworksonlyif time_interval_for_security_scheduler_in_msparameterinNmsProcessesBE.conffile locatedinthe/usr/local/cambium/wm/server/confdirectoryinLinux(orthe C:\Cambium\WM\server\conffolderinWindows)isconfigured(inmilliseconds).Bydefault,the valueissetto0,whichwillcausetheschedulertonotstartandtheuserexpirationchecktonotbe performed.
8.9
Restoring a Deleted superuser Account

Theuserguidesectiontitled"DeletingaUser"cautionsagainstdeletionofthesuperuser(initially, root)accountintheWMclientinterfaceunlessanotheruserwiththesamecapabilitiescurrently exists.Ifauserdoessodespitethecaution,usethefollowingproceduretorestoreasuperuser accounttothesystemandreturnthegroupAdminaccountstotheirpreviousconfigurations.
Procedure 13: To restore the superuser account and the security tool cache
1. EnsurethattheWMserverisrunning.
note ............. The following step asks you to input a new superuser account name. Using the name root is discouraged.
2.
IftheserverdeviceisonaLinuxOS,performthefollowingsteps: a. b. a. b. c. d. e. Entercd /usr/local/cambium/wm/server/bin. Enter./createSuperUser.sh db_user db_password new_superuser. SelectStartRun. IntheOpenfieldoftheRundialog,typeincmd. ClickOK. AttheDOSprompt,entercd C:\Cambium\WM\server\bin. EntercreateSuperUser.bat db_user db_password new_superuser.
IftheserverdeviceisonaWindowsOS,performthefollowingsteps:
RESULT:Thesuperuseraccountnew_superuserisprovisionedwiththeinitialWMclient passwordpublic,eventhoughitisnotinitiallydisplayedintheSecuritytreeoftheinterface, andthegroupsettingsfortheAdmingrouparerestoredtodefaults.
3. 4. 5.
LaunchasessionintheWMclientinterface,logginginasnew_superuserwiththe passwordpublic. SelectToolsAdministrationSecurityAdministration. IntheleftpaneloftheSecurityAdministrationwindow,clicktohighlightGroupsAdmin.
61
Issue 3 August 2012 6. 7. 8. Intherightpanel,clicktheMemberstab. ClicktheSettingUsersbutton.
MoveuserstoandfromtheSelectedUsersblockuntilthelistinthatblockconsistsofthe samesetofuserswhobelongedtotheAdmingroupbeforethelonesuperuseraccountwas deletedandthenrestored. ClickOKintheSelectUserswindow.
9.
10. IntheleftpaneloftheSecurityAdministrationwindow,clicktohighlight Usersnew_superuser. 11. SelectEditChangePassword. 12. Typeanewpasswordtwicetosupersedethedefaultpasswordpublic. 13. ClickOKintheChangePasswordwindow.
62
Issue 3 August 2012
9 Offline Physical Map Setup

ThisfeaturesupportsoperatorswhouseWMwherenoconnectiontotheInternetisavailableand providesforthemageoreferencedrepresentationoftheentirenetworkintheWMclient,whilenot specificallydisablingtheonlinephysicalmap.Comparedtotheonlinemap,theofflinemapdiffersin thatitdoesnotinclude linkprofiles Googlesearch theShowAddresscapability GoogleStreetView draganddropdevicepositioning
ThisreleasesupportsGeoServerasthemaptileserverlocalorremote(especiallyforlargenetworks) totheWMserver.GeoserverdoesnotlimithowmanyimagesaWMoperatorcanuseforlayersof theofflinemap.Boththesourceimagesandthecachedimagetilesshouldbestoredonadriveofthe computerwhereGeoServerresides.WMsupportslayersthatarecreatedfromanyofthefollowing sourcefiletypes: GeoTIFF WorldImage ArcGrid JavaPropertyfile WebFeatureServer Directoryofspatialfiles Gtopo30 ImageMosaic PostGISDatabase Shapefile
InstructionsforusingsettingupWMtousethemapimagescreatedaccordingtothischapterare providedunderUsingtheOfflinePhysicalMapPanelonPage111.
9.1
Deploying GeoServer
TodeployGeoServer,performthefollowingsteps.
Procedure 14: To deploy GeoServer

1. 2. 3. 4. 5. 6. Visithttp://geoserver.org. DownloadthelatestversionoftheGeoServersoftware. Downloaditsassociateddocumentation. InstallGeoServeraccordingtoitsdocumentation. Launchyourwebbrowser. Navigatetohttp://GeoServerHost:8080/geoserver/web/. ThewebinterfacetoGeoServeropens. 63
Issue 3 August 2012
9.2
Creating Map Layers

Tocreateanofflinephysicalmaplayerfromasingleimage,performthefollowingsteps.
Procedure 15: To create a layer from one image

1. 2. 3. 4. 5. 6. UnderDataintheleftpanel,clickWorkspaces. TheWorkspacespanelopenstotheright. ClickthelinkforAddnewworkspace. IntheNametextbox,composeanamebywhichyouwilllaterrecognizethisworkspace. IntheNamespaceURItextbox,typeinanyfunctionalURL. ChecktheDefaultworkspacecheckbox. ClicktheSubmitbutton. WhentheWorkspacespanelrepaints,itincludesthenewnameinthelistofworkspace names.Nowadatastoreisneededfortheimagesthatthisworkspacewilluse.
Tocreateadatastorefortheimagethatyouwillcreate,performthefollowingsteps.
Procedure 16: To create a data store for GeoServer workspace images

1. 2. 3. 4. 5. 6. 7. 8. 9. OntheGeoServerhost,createthedirectory
GeoServer_Version/data_dir/data/WorkspaceDirectory.
Copytheimagefromwhichyouwanttocreatealayerintothisnewdirectory. IntheleftpaneloftheGeoServerinterface,clickStores. IntheStorespaneltotheright,clickAddnewStore. UnderNewdatasourceintheresultingrightpanel,clickthetypeofimagethatyoucopied tothedirectory. IntheAddRasterDataSourcepanel,usethedropdownmenutoselecttheWorkspace name. IntheDataSourceNametextbox,composeanamebywhichyouwillrecognizethedata source. IntheassociatedDescriptiontextbox,composeadescriptionthatwillhelpyoudistinguish thisdatasourcefromothersthatcreate. UnderConnectionParameters,usetheURLtextboxtopastethe
WorkspaceDirectory/ImageFileNameontotheendofthesuppliedstringfile:data/.
10. ClicktheSavebutton. TheNewLayerchooserpanelopensontheright. 11. Inthetableoflayers,clickthePublishbuttonintherowofthelayerthatyoujustcreated. 12. ReviewtheinformationprovidedintheresultingWorkspaceDirectory:LayerName panel. 13. ClicktheSavebutton. Theresultingrightpaneldisplaysatableofallofthepublishedlayers.Nowyouneedto verifythatGeoServercanconnecttothedatastore.
64
Issue 3 August 2012
ToverifythatGeoServerisproperlyconnectedtothestoredimagefile,performthefollowingsteps.
Procedure 17: To verify that GeoServer connects to the image data store
1. UnderServicesintheleftpaneloftheGeoServerwebinterface,clickGWC,whichrepresents GeoServerWebCache. TheGeoWebCachewebpageopens. UnderAutomaticallyGeneratedDemos,clickAlistofallthelayersandautomaticdemos. Intheresultingtable,findthelayerthatyoucreatedinthisprocedure. ClickoneofthefileformatsintheOpenLayerscolumnforyourlayer. Inspecttheimagetoverifythatitisasintended. UsethebackbuttoninyourbrowsertoreturntotheLayerswebpage.
2. 3. 4. 5. 6.
Tocreateanofflinephysicalmaplayerfrommultipleimages,performthefollowingsteps.
Procedure 18: To add an image to an existing layer

1. PerformProcedure16onPage64exceptthat,insteadofcreatingaWorkspacedirectory, usetheWorkspacedirectorythatyoucreatedtostorethefirstimage.Thenproceedas follows. Intheleftpanel,clickLayerGroups. IntheLayerGroupspaneltotheright,clickAddnewlayergroup. IntheNametextbox,composeanamebywhichyouwillrecognizethenewlayergroup. ClicktheSubmitbutton. BeneaththeGenerateBoundsbutton,clickAddLayer. IntheChoosenewlayerpopupwindow,clickthenameofthefirstlayertobeincludedin thislayergroup. ClickAddLayeragain. Clickthenameofthesecondlayertobeincluded.
2. 3. 4. 5. 6. 7. 8. 9.
note ............. Delay the Generate Bounds operation until all intended layers have been added.
10. IntheLayerstableoftheLayergrouppanel,togglethepositionsoftheimagesuntilthe desiredbaseimageisinthetoprow,theimagethatyouwantimposedonthatoneisinthe secondfromthetoprow,andsoforth. 11. NowclicktheGenerateBoundsbutton. 12. ClicktheSavebutton. 13. Intheleftpanel,clickWCS. 14. Ensurethatthenewlayergroupnameislistedamongthelayernames. 15. ClickoneofthefileformatsintheOpenLayerscolumnforyourlayergroup. 16. Inspectthelayergrouptoverifythatitisasintended. 17. UsethebackbuttoninyourbrowsertoreturntotheLayerswebpage.
65
Issue 3 August 2012
9.3
Pre-caching the Map Images

Atthispointintheprocess,youcouldretrievethelayergroupthatyouhavecreatedandviewit, panningandzoomingatwill.However,ifyoudid,youwouldobservethattheinterfaceencounters delaysasitpaintszoomedlevelsofalayer.Precachingimagesmitigatesthesedelays. Inthedirectorydata_dir/GWContheGeoServerhostcomputer,GeoServerhasstoredstorespre cachedoutputfromthelayersthatyouloadedintoitssystem,eachinasubdirectorynamedfromthe layername,withlowerdirectoriesforeachview(tile)thatyourenderedwhilezoomingandpanning. ThisautomaticfunctionofGeoServerfacilitatesspeedyloadingofallofthesetilesasyoudemand theminthefuture,butonlythosetilesthatyouviewedarerepresentedatthispoint.Toensurethat themapwillproperlyandquicklydisplayalllevelsofzoomofalltiles,youneedtoprecachethemin GeoServer.Todoso,performthefollowingsteps.
Procedure 19: To pre-cache all tiles for all levels of zoom

1. 2. 3. 4. 5. IntheleftpaneloftheGeoServerwebinterface,clickWCS. ClicktheSeedthislayerlinkassociatedwiththelayerthatyouwanttoprecache. Thisopensataskpageinwhichyoucanconfiguretheprecachingofthelayer. ForNumberofthreadstouse,selectthedesirednumber(forexample,16,recommended forthemaximum). ForTypeofoperation,selecteitherSeedtogenerateonlythosetilesthathavenotbeen cachedyetorReseed(recommended)togeneratecachesofalltiles. ForGridSet,selectESPG:4326.
important ........... No other setting will work with the physical map in WM. This is the only setting that employs a latitude/longitude format that is compatible with WM.
6. 7. 8. 9.
ForFormat,alwaysselectimage/pngformaximumcompatibilitywithWM. ForZoomstart,alwaysselect00asthelowestzoomlevel. ForZoomstop,alwaysselect16asthehighestzoomlevel. IgnoretheBoundingboxtextfields. ATasksubmittedpageopensandlistsallofthethreadsthatGeoServerisexecutingbased onthetaskthatyoujustdefined.Thispageremovesthreadsastheyarecompleted.
10. ClickSubmit.
tip ................ Attempt to avoid using the GeoServer computer resources for other purposes during the caching operations.
11. Tooptionallymonitortheprogressofthesethreads,clicktheRefreshlistlinkbeneaththe listofthreads.
66
Issue 3 August 2012
10 Optimization of WM Server Performance

10.1 Optimizing MySQL Database Performance
Thefollowingaregeneralrecommendationsforalloperators,verystronglyrecommendedfor operatorsoflargenetworks.However,theserecommendationsapplyonlywheretheattributeis currentlysettoavaluethatissmallerthantherecommendedvalue.
Procedure 20: To optimize the MySQL database resources for WM

1. 2. 3. StoptheserviceforMySQLServer. IntheMySQLserverfilesystem,findeitherthefilemy.cnforthefilemy.ini. Openthefileforediting.
note ............. A simple and fast way to accomplish the next step is to initially use the contents of the file my-huge and edit them.
4.
Foranyofthefollowingattributeswhosevalueissmallerthanthevaluerecommended here,increaseittotherecommendedvalue:
Table 5: Recommended MySQL parameter values

back_log=50 binlog_cache_size=1M bulk_insert_buffer_size=128M join_buffer_size=16M key_buffer_size=512M max_connections=150 max_connect_errors=10 max_allowed_packet=512M max_heap_table_size=64M query_cache_size=128M query_cache_limit=4M read_buffer_size=4M read_rnd_buffer_size=8M sort_buffer_size=2M table_open_cache=512 thread_cache_size=8 thread_stack=192K tmp_table_size=64M
5. 6. Saveandclosethefile. RestarttheserviceforMySQLServer.
67
Issue 3 August 2012
10.2
Locking and Terminating Idle Client Sessions

AconfigurablefileintheWMfilesystemincludestwoparametersfortheoperatortosetasthe maximumidletimeforanindividualclientsession.Therulesforthisparameterareasfollows: Uponserverstartup,thevaluesofxinALLOWED_IDLE_TIME_BEFORE_LOCKOUT="x"andy inALLOWED_IDLE_TIME_BEFORE_TERMINATION="y"arereadfromthe clientparameters.conffileinthefollowingdirectoriesoftheserverfilesystem:
/usr/local/cambium/wm/server/conf/inLinuxor C:\Cambium\WM\server\conf\inWindows /usr/local/cambium/wm/server/users/root/inLinuxor C:\Cambium\WM\server\users\root\inWindows /usr/local/cambium/wm/server/users/guest/inLinuxor C:\Cambium\WM\server\users\guest\inWindows /usr/local/cambium/wm/server/users/EachOtherUser/inLinuxor C:\Cambium\WM\server\users\EachOtherUser\inWindows
AlthoughWMenforcesthevaluethatisreadintheconfdirectory,itisrecommendedto keepthevaluesconsistentinallthreedirectories. Wherexis0,WMwillneverlockoutanyuserforidletime. Wherexisanumberotherthan0,WMwilllockoutanyuserwhosesessionidletime exceedsxminutes. Whereyis0,WMwillneverkillthesessionofanyuserforidletime. Whereyisanumberotherthan0,WMwillkillthesessionofanyuserwhosesessionidle timeexceedsyminutes. Wherebotharenonzeroandxisgreaterthany,asessionwillneverbelockedbecausethe sessionterminationpointisreachedfirst. Wherebotharenonzeroandyisgreaterthanx,asessionwillfirstbelocked,then terminatedaftermoreidletime.
Tosetthesevalues,performthefollowingsteps.
Procedure 21: To establish session idle time limits

1. 2. 3. 4. 5. 6. 7. 8. 9. Openthefirstinstanceofthefileclientparameters.conf. Observingtherulesstatedabove,changethevalueofxand/orytoanonzeronumberof minutestoenforce. Saveandclosethefile. Openthesecondinstanceofthefile. Changexand/orytovaluesthatareidenticaltothoseyousetinStep2. Saveandclosethefile. Openthethirdinstanceofthefile. Changexand/orytovaluesthatareidenticaltothoseyousetinStep2. Saveandclosethefile.
68
Issue 3 August 2012
11 User Scripts Setup

WMsupportstheexecutionofuserdefinedscriptsasimmediateorschedulabletasks.Thisfeature requires usersauthorizedbyaWMclientadministratorinthepermissionstreeoftheclient application. toolsthatare properlyscriptedtoexecutethedesiredtask. mountedinthe...\server\UserScriptsdirectorybyyou,theserveradministrator. madeexecutableintheirmodesettingbyyou,theserveradministrator.
Whenyouhavemountedthesescriptsatthespecifiedpath 1. 2. 3. 4. 5. openasessionintheWMclientapplication. executethescript.(Seetheuserguidesectiontitled"RunningaUserdefinedScript.") reviewtheresultsoftheexecution.(Seetheuserguideproceduretitled"Toviewresultsof lastexecutionofatask.") informtheclientadministrator(s)thatauthorizeduserswillnowbeabletolaunchthisscript fromthetaskschedulerinterface. ensurethatauthorizedusersareinformedthattheyareabletoviewandselectthescript fromtheDetailstabofthetaskschedulerinterface.
69
Issue 3 August 2012
12 Management of WM Server Logs

Theloggingserviceisusefulforvariouspurposessuchasidentifyingbugs,configurationerrors, andperformanceblockades;creatingaudits;andtrackinguseractivities. Allmessagesarestoredintheformoftextfiles(.txt).Allconfigurationinformationrelatedtothese logfilesisavailableinthelogging_parameters.conffilelocatedinthe /usr/local/cambium/wm/server/confdirectoryinLinux (ortheC:\Cambium\WM\server\conffolderinWindows).Thelogging_parameters.conffile containstheentriesofvarioususerspecified.txtfiles,suchasthemaximumnumberoflinestobe readfromafileandthenumberoffilestobeincluded.Thefollowingareamongthemostimportant attributesforwhichyoumaysetvaluesinthisfile: LogLevel FileName LogsDirectory MaxLines MaxLinesCached
Youcanconfiguretheloggingsettingsbyeditingthelogging_parameters.conffileusingthe RuntimeAdministrationtool.Usingthistoolupdatesthefileatruntimeandeliminatestheneedfor aWirelessManagerServerrestartafterconfiguration.Butifyouhaveeditedthefiledirectlythrough aneditor,besuretorestarttheServer.
Table 6: Log files present by default

Logfilename alert_audit.txt confChange_<SPVersion>.log discoveryLogs.txt Contents Inthisfile,informationaboutallthealertsthatareupdatedthroughevents arelogged.Newalertgeneration,alertdeletionetc.,areprinted. ThislogfileiscreatedwheneverServicePackupdateisperformed.The updatedetailsareprintedinthisfile. Inthisfile,alldiscoveryrelatedhappeningsarelogged.Addition/removalof Networks/nodes,startingofNetSearcher,nodesornetworksdiscoveredetc., areloggedinthisfile. MangementServerFrameworkrelatederrormessagesarestoredinthisfile. ManagementServerFrameworkrelatedoutputmessagesarestoredhere. AllimportantWebNMSrelatederrormessagesareloggedintothisfile. AllimportantWebNMSrelatedoutputmessagesareprintedinthisfile.This isquiteacomprehensivelogfilewhichholdsrecordofhappeningsrightfrom serverstartuptotheshutdown.Modulespecificoutputmessagebelonging to"POLL""POLICY""TOPO"EVENT""ALERT""MAP""CONFIG""PROV""MISC" "AGENT""CLI"modulesareloggedbydefault.
mserr.txt msout.txt nmserr.txt nmsout.txt
71
Issue 3 August 2012 Logfilename stderr.txt Contents
Bydefault,SystemErrormessagesaredirectedtothisfile.Thatis,ifyouuse System.err.println("Message")inyourmodule,theerrormessagesare directedtothisfile,bydefault. Bydefault,SystemOutputmessagesaredirectedtothisfile.Thatis,ifyou usesystem.out.println("Message")inyourmodule,theoutputmessagesare printedinthisfile,bydefault. AllPreparedStatementsobtainedusingtheConnectionPoolarerecordedin thisfile.Bydefault,loggingintotransactionLogs.txtisdisabled.To enableit,editthelog4j.xmlfileandsetLogging="true"forthe transactionLogs.txtentry.
stdout.txt
transactionLogs.txt
Bydefault,thefollowinglogfilesarepresentontheWMserverinthe /usr/local/cambium/wm/server/logsdirectoryinLinux (ortheC:\Cambium\WM\server\logsfolderinWindows). Althoughmostoftheimportantattributestosetareinthelogging_parameters.conffile,ifyou wantWMtobeabletosendemail,youwillneedtoconfiguresomeattributevaluesinthefile /usr/local/cambium/wm/server/conf/log4j_conf.xmlfileinLinux (ortheC:\Cambium\WM\server\conf\log4j_conf.xmlfileinWindows). Theseinclude thevaluefortheSMTPHostparameter.ThisistheIPaddressoftheSMTPserverthatwill handleoutboundemailfromtheWMserver. thevalueoftheToparameter.Thisistheaccountnameanddomainoftherecipientofemail fromtheWMserver. thevalueoftheFromparameter.ThisistheaccountnameanddomainthatWMwillusefor itselfasthesender.
 <appender name="mail" class="org.apache.log4j.net.SMTPAppender"> <param name="EvaluatorClass" value="com.adventnet.management.log.MessageBasedTEE"/> <param name="To" value="webnms-admin@adventnet.com"/> <param name="From" value="webnms-admin@adventnet.com"/> <param name="BufferSize" value="512"/> <param name="Subject" value="LOG4j mail testing"/> <param name="SMTPHost" value="192.168.4.41"/> <layout class="org.apache.log4j.PatternLayout"> <param name="ConversionPattern" value="[%d{dd MMM yyyy HH:mm:ss:SSS}] %-5c{2}: %m%n"/> </layout> </appender> 
72
Issue 3 August 2012
13 WM Software Upgrades and Downgrades

13.1 WM Upgrade to Release 4.0
UpgradetoWMRelease4.0issupportedonlyfromRelease3.0withServicePack3 onRedHatEnterpriseLinux5.xES,32bit onCentOS5.x,32bit onWindowsServer2008R2Enterprise
ThetwopossibleupgradepathstoRelease3.0withServicePack3areasfollows: startingwithRelease2.2withnopatchoranypatchotherthanPatch8: 1. 2.
1. 2. 3. 4. 5.
InstallRelease2.2Patch8asdescribedintheassociatedREADMEfile. Continuewiththefollowingpath. UpgradetoRelease3.0asdescribedintheserveradministrationguideforRelease3.0. InstallRelease3.0SP3asdescribedinServicePackorFeaturePackInstallationon Page85. StarttheWMserverprocessasdescribedunderUsingtheWMServerPanelon Page103. StoptheWMserverprocessasdescribedunderUsingtheWMServerPanelon Page103. UpgradetoRelease4.0asdescribedinProcedure22:ToupgradeWMtoRelease4.0on Page74.
startingwithRelease2.2Patch8:
NolaterversionofRedHatEnterpriseLinuxorofLinuxfromadifferentvendorissupported.Wireless Managerrequiresspecificversionsoflibrariestobelocatedincertainplaces.Evenlaterversionsof RedHatEnterpriseLinuxfailtosatisfytheselibraryrequirements.Cambiumtechnicalsupportcannot helpausercustomizeanOStomeettherequirements. VMwarevSphereissupportedontheRelease4.0serverdevice. Donotremovethepreviousreleaseoranyofthefilesthatitcreated.

note ............. The following procedure includes the step "Copy your purchased licenses" See License Types on Page 95 and Calculation of the Number of Nodes to be Licensed on Page 95.
CambiumNetworksprovidesanintegratedinstallationtoolforLinuxplatformsandasimilartoolfor WindowsplatformsfordownloadingbyoperatorswhowanttoinstallWMandoptionallyPrizm.This toolismadeavailableaspartofthelicenseprocurementprocess.Forinformationonlicensingthe softwareproducts,contactyourCambiumrepresentatives.AlsoseethesectiontitledWMSoftware andFeatureLicensingonPage95ofthisguide.

important ........... The following procedure presumes that the previous release with its latest service pack is already installed on the device and that you are merely upgrading the server software. For instructions on a fresh installation, including where one of these releases had been present and has been uninstalled, use the Cambium Wireless Manager Quick Start Guide for Release 4.0.
73
Issue 3 August 2012
Procedure 22: To upgrade WM to Release 4.0

1. 2. 3. DownloadtheWMintegratedinstallationtoolforyourplatform (WM_Installer_4_0_x.exe or WM_Installer_4_0_x.bin). UsetheMD5checksumprovidedatthedownloadwebsitetoverifythatthetoolwasnot corruptedbythedownload. IfthedeviceonwhichyouarereadytoupgradeWMsoftwarerunsonaLinuxOS a. performthefollowingsteps: 1) LogintotheOSasroot. 2) AttheOScommandprompt,enter/usr/sbin/sestatus. IfSecurityEnhancedLinux(SELinux)isalreadydisabled(thesystemreturns -256),skiptoStep8. Ifitisenabled(thesystemreturns0,continue. 3) Openthefile/etc/selinux/configforediting. 4) SearchforthestringthatbeginswithSELINUX=. 5) RevisethefullstringtoSELINUX=disabled. 6) SearchforthestringthatbeginswithSELINUXTYPE=. 7) RevisethefullstringtoSELINUXTYPE=targeted. 8) Saveandclosetheconffile. 9) Rebootthedevicetoeffectthechange. b. 4. disablethefirewallonthedevice. Launchtheinstallationtool. Theinterfaceprovidesaprogressbarforthestatusofitspreparations.
ThentheIntroductionpanelopens.
74
Issue 3 August 2012
5.
ReadtheIntroductionpanelandclickNext. TheLicenseAgreementpanelopens.
6.
IfyouagreetothetermswrittenintheLicenseAgreementpanel(scrolltoreadtheentire text),clicktheradiobuttonforIacceptthetermsoftheLicenseAgreementandclickNext.
note ............. If your OS is not explicitly supported for this WM release, the wizard provides the following pop-up message.
75
Issue 3 August 2012
..................... If you want to install an explicitly supported OS in conjunction with the WM upgrade, see Migration of Operator Data Through WM Upgrade Plus OS Upgrade on Page 84.
7.
ReviewtheoptionsintheFeatureSelectionpanel.
note ............. In the next step, the tool detects the presence of the previous WM release, License Manager, a MySQL Database on the device. Where these are present, the tool will upgrade only Wireless Manager and leave the others as they presently exist. Uncheck MySQL Database. If License Manager is already installed, uncheck it as well.
8.
LeavethecheckboxcheckedforeachcomponentthatyouwanttoinstallandclickNext.
note ............. In the typical upgrade case, License Manager and the MySQL Database are still present from the previous release, and the Release 4.0 installation tool detects their presence.
76
Issue 3 August 2012
9.
Whenthetoolpromptsforwhetheryouwanttocontinuegiventhatthepreviousrelease wasdetected,clickOK.
10. Whenthetoolindicatesthecomponentsthatwillnotbeinstalled,confirmthatyouchoseto notinstallthem. Aftertheconfirmation(s),thetoolpromptsforyourcurrentdatabaseauthentication information,whichitrequiresforproperinstallationoftheSystemReportsfeatureinthis release.
11. Typeinyourdatabasespecificusernameandpasswords,andthenclickNext. Thetoolprovidesasummaryofwhatitisreadytodo.
77
Issue 3 August 2012
12. ReviewthecontentsofthePreInstallationSummarypanel(scrollingtoseetheentire contents). 13. ClicktheInstallbutton. IftheWMserverisrunning,thetoolstopsit.Thenthetoolprovidesaconfirmationthatitis active.
78
Issue 3 August 2012
Thetoolbacksupcertainconfigurationfilesandthedatabaseandplacesthebackupsinto anewdirectorythatitcreatesimmediatelybeneaththesystemdrive,forexample
\WM_x.x.x_BACKUPinWindows /WM_Release vx.x_BACKUPinLinux
ThetooluninstallsthepreviousWMrelease,theninstallsRelease4.0asitprovidesvarious progress/confirmationmessages. 14. Ifyourfirewallaskswhethertoallowjre-6u6-x-exe,allowit. TheinstallationwizardpromptsforwhetheryouwanttostarttheAdministratorTool.
15. CopyyourpurchasedlicensestotheWMserverdeviceandnotetheirpath. 16. IntheRunServerAdministrationTool?window,clicktheYesbutton. ThewizardrespondswiththeInstallCompletepanel.
17. ClicktheDonebutton. TheWMAdministratorToolopens.
79
Issue 3 August 2012
18. IntheleftpaneloftheWMAdministratorToolinterface,clickLicensing. TheLicensingconfiguratoropenintherightpanelofthetoolinterface.
19. Ifyouaredeployingthreelicenseservers,clicktheRedundantLicenseServerradiobutton. Ifnot,leavetheLicenseServerbuttonchecked. Inthestepsthatfollow,referalsotoUsingtheLicensingPanelonPage107.
80
Issue 3 August 2012
20. ForeachLicenseManager(LM)serveryouaredeploying,performthefollowingsteps: a. IntheHostname/IPtextbox,either b. leavelocalhost,iftheLMserverislocaltotheWMserver. replacelocalhostwiththedottedIPaddressoftheLMserver,ifitisremoteto theWMserver. leavethedefault27000astheserverportoftheLMserver,wherelicenserequests fromWMwillbeprocessed. replace27000withaportnumberthatisunusedintheLMserver,if27000isor maybeusedbyanotherprogram.
IntheServerPorttextbox,either
c.
IntheLoginNametextbox,eitherleavethedefaultlmadminastheIDfortheWM ServerAdministratorTooltouseinauthenticatingitselftotheLMserverorreplaceit withanotherID. InthePasswordtextbox,eitherleavethepreconfiguredpasswordthatisassociated withthelmadminIDorreplaceitwithanotherpasswordfortheServerAdministrator TooltouseinauthenticatingitselftotheLMserver. IntheWebserverPorttextbox,either leavethedefault27443forsecureconnectionsfromtheWMservertotheLMweb server. replace27443with27100fornonsecureconnectionstotheLMwebserver.
d.
e.
21. IntheLicenseFileDatapaneloftheWMAdministratorTool,clicktheSaveConfiguration button. TheAdministratortoolconfirmsthesaveoperation. 22. IntheLicenseActionsblockoftheLicensingpanelintheWMAdministratorToolinterface, clicktheUploadLicensebutton.
Figure 2: Command option to upload an individual license file to License Manager
23. Browsetoandselectalicensetoupload,thenclickOpen. SeeFigure14onPage108.

note ............. If the file that you select is not a valid license file, the tool responds with an error.
24. IntheUploadLicenseFilewindow,clicktheUploadbutton. 25. RepeattheabovethreestepsuntilallWMrelatedlicenseshavebeenuploaded (WMServerVxandWMEMSPackVx). 26. ConfirmthelicenseuploadsbyclickingtheLicenseStatusbuttonintheLicenseActionsblock oftheLicensingpanel. Foranexampleoftheresultingdisplay,seeFigure15onPage109. 27. IntheleftpaneloftheWMAdministratorToolwindow,selectWMServer. 28. IntheServerActionsblockoftheWMServerpanel,clicktheStopWMServerbutton. SeeUsingtheWMServerPanelonPage103.
81
Issue 3 August 2012
WM Release 4.0 Server Administration Guide 29. Checkthefile...cambium\wm\Uninstall\installvariables.propertiesfor anyerrorsthatoccurredduringtheupgrade/installation.
82
Issue 3 August 2012
30. IfyouwantWMtoprocessauthenticationrequestsforPMPslavedevices a. b. c. d. e. f. g. h. i. j. k. procurealicensetouseBAM. downloadPrizmsoftwarefrom http://www.cambiumnetworks.com/support/planning/index.php?cat=2&type=1. installPrizmRelease3.3withouttheoptionalLicenseManagerandDatabase installationsthattheinstallationtooloffers. downloadPrizmdocumentationfromthesamesite. navigatetothe.../Canopy/Prizm_bindirectory. launchthePrizmEMSAdministratorTool. intheServerpanelofthetoolinterface,settheServerModetoBAMOnlyandclickthe Savebutton. fromthemainmenu,selectActionPrizmEMSServerStop. verifythattheservicesforLicenseManagerandMySQLdatabasearerunning. intheLicenseManagerpanelofthePrizmEMSAdministratorTool,configurePrizmto connecttotheinstanceofLicenseManagerthattheWMinstallationtoolinstalled. intheDatabasepanelofthePrizmEMSAdministratorTool l. configurePrizmtoconnecttotheMySQLdatabasethattheWMinstallationtool installed. ifyourWMserverisonaWindowsplatform,thenforDatasourceName(DNS), enterprizm_mysqlintothetextbox.
intheLicenseActionsblockoftheLicensingpaneloftheWMAdministratorTool,select UploadLicense.(SeeUsingtheLicensingPanelonPage107) BAMserverlicense BAMpacks
m. uploadallofthefollowinglicenses
31. IntheServerActionsblockoftheWMServerpanelintheWMAdministratorTool,clickthe StartWMServerbutton. 32. Optionally,closetheWMAdministratorTool. 33. Launchyourwebbrowser. 34. Navigatetohttp://localhost:9090. Iftheserverhasbeenproperlyconfigured,yourbrowserwillberedirectedtothelaunch webpage.
83
Issue 3 August 2012
Ifaproblemexists,thenthiswebpageincludesawarning.Inthiswarningcase,theLaunch WMClientoperationmayopenanerrormessageinsteadoftheclientinterface.Ifthis occurs,clickthelicenseloglinktotroubleshootthelicensingconfiguration.
13.2 Migration of Operator Data Through WM Upgrade Plus OS Upgrade

TopreserveconfigurationandperformancedatafromthepreviousreleaseintoRelease4.0while alsoupgradingtheOSoftheserverdevice,performthefollowinghighlevelprocess.
Procedure 23: To migrate operator data in upgrade of WM plus the OS

1. IfRelease4.0willbeinstalledonacomputerotherthanwhereyourcurrentWMreleaseis installed,orderafullsetofreplacementlicenses. AccordingtothesectionWMUpgradetoRelease4.0onPage73,upgradetheWMsoftware toRelease4.0. UsingtheRelease4.0userguide,verifythatRelease4.0isoperatingasexpected. Doubleclickthedesktopicon labeledWM Server Administration. IntheleftpaneloftheresultingWMAdministratorTooldialog,selectWMServer. (SeeUsingtheWMServerPanelonPage103.) Intherightpanel,clicktheServerActionsblockStopWMServerbuttonandleavethe WMAdministratorToolopen.
important ........... See Network Interface Management on Page 22 and License Types on Page 95.
2. 3. 4. 5. 6.
note ............. This breaks the connection of the client session. A pop-up confirmation asks whether you want to exit the client.
7. 8.
ClicktheYesbuttontoremovealltheopenclientinterfacewindows. IntheSystemBackupblockoftherightpanelintheWMAdministratorTool,clickthe SystemBackupbutton.
84
Issue 3 August 2012
note ............. This backs up the server data to a new directory that the operation creates: C:\Cambium\WM\server\backup\WM_Data_Backup\ or /usr/local/cambium/wm/server/backup/WM_Data_Backup. The data file that it places in the new directory is *.WMBACK.
9.
Copythefollowingdatatoarepositoryonotherthantheserverdevice: theoutputfile*.WMBACKproducedinStep10 alllicenses anyotherfilesthatareimportanttoyouroperations
10. ClosetheWMAdministratorTool. 11. UpgradetheOS(orinstallthenewOS). 12. CopythelicensefilesfromtherepositoryontothedeviceonwhichyouinstalledthenewOS. 13. AccordingtotheRelease4.0quickstartguideprocedureforafreshinstallation,installall threecomponents:WMRelease4.0,MySQLdatabaseserver,andLicenseManager.

important ........... Do not start the WM service yet.
14. Doubleclickthedesktopicon
labeledWM Server Administration.
15. IntheleftpaneloftheWMAdministratorToolinterface,selectLicensing. 16. AccordingtothesectionUsingtheLicensingPanelonPage107,uploadyourlicensesto LicenseManagerandleavetheWMAdministratorToolopen. 17. IntheleftpaneloftheWMAdministratorTool,selectWMServer. 18. Intherightpanel,clicktheServerActionsblockStartWMServerbuttonandleavethe WMAdministratorToolopen. 19. UsingtheRelease4.0userguide,verifythatRelease4.0isoperatingasexpected. 20. OpentheWMAdministratorTooltoitsWMServerpanel. 21. IntheWMAdministratorTool,clicktheStopWMServerbuttonandleavetheWM AdministratorToolopen. 22. Copytheremainingcontentsoftherepository(includingthefile*.WMBACK)tothedirectory C:\Cambium\WM\server\backup\WM_Data_Backup\or /usr/local/cambium/wm/server/backup/WM_Data_Backupinthenewinstanceof WMRelease4.0. 23. IntheWMAdministratorTool,clicktheSystemBackupbutton. 24. Pointthebackuputilitytothefile*.WMBACK. 25. Whentheutilityisfinished,clicktheStartWMServerbuttonintheWMAdministratorTool. 26. UsingtheRelease4.0userguide,verifythatRelease4.0isoperatingasexpected.
13.3 Service Pack or Feature Pack Installation

WhenCambiumNetworksmakesanewWMservicepackorfeaturepackavailablefordownload,you canlaunchtheUpdateManagertoolfromtheserverfilesystemtoautomaticallyandselectively replacesomeofthefilesandaddnewonesthatsupportnewdevicesand/orprovidenew capabilities,withoutinstallingafullWMsoftwareversion.Atanytime(forexample,beforeand/or afteryouinstalloruninstallaservicepackorfeaturepack,youcancheckthecurrentvalueofthe Service Pack Versioninthefile/usr/local/cambium/wm/server/logs/wmsout.txtor C:\Cambium\WM\server\logs\wmsout.txt.
85
Issue 3 August 2012
Toinstallaservicepackorfeaturepack,performthefollowingsteps.
Procedure 24: To install a service pack or feature pack

1. 2. 3. 4. 5. DownloadthenewservicepackorfeaturepackfromtheCambiumNetworkswebsite, notingitsdestinationpath. Intheserverdevice,navigateto/usr/local/cambium/wm/server/bininLinux orC:\Cambium\WM\server\bininWindows. LaunchthetoolServerAdminTool.shorServerAdminTool.bat. StoptheWMserver,asdescribedunderUsingtheWMServerPanelonPage103. LaunchthetoolUpdateManager.shorUpdateManager.bat. RESULT:Theinterfacetothetoolopens.Ifanypreviouslyinstalledservicepacksand/or featurepacksarecurrentlydeployed,thentheyarelistedintheInstalledPatchespanelof thewindow.AnexampleofthiswindowisshowninFigure3.
Figure 3: Update Manager interface
6. 7. 8. 9. Intheupdatepanel,clicktheBrowsebutton. Browsetoandselectthedownloaded.ppmservicepackorfeaturepackfile. ClicktheReadmebuttontoseeasummaryofthechangesthattheservicepackorfeature packwillinstall. ClickthePreviewbuttontoseethecontentsoftheservicepackorfeaturepack.
86
Issue 3 August 2012
10. ClicktheInstallbuttontodeploytheservicepackorfeaturepack. RESULT:TheInstallationWizardopens.AnexampleisshowninFigure4.
Figure 4: Service pack Installation Wizard
11. IfyouwanttoseethelistoffilesandreviewtheReadmetext,checkthecheckboxfor ViewReadmeandInstalledfiles. NOTE:AnexampleoftheReadmewindow,withReadmeandInstalledfilestabs,isshown inFigure5.
87
Issue 3 August 2012
Figure 5: Service pack Readme window
12. ClicktheClosebuttontocompletetheinstallation. RESULT:Theservicepackorfeaturepackisdeployed,andthefilesthatwerereplacedbyit havebeenmovedto/usr/local/cambium/wm/patch/PatchNameor C:\Cambium\WM\Patch\PatchNamedirectoryforautomaticrestoreincaseyouever uninstallthepatchthatsupersededthesefiles. 13. IntheServerActionsblockoftheWMServerpanelintheWMAdministratorTool,clickthe StartWMServerbutton.

caution............... If you are applying more than one service pack, then the next step (restarting UpdateManager) is required. Skipping this step between consecutive service pack installations will result in both a pop-up error stating that the .ppm file of the next installation is not compatible with the product and the loss of the previous service pack, if the next one were installed.
14. IfyouwanttousetheUpdateManagertooltoinstallyetanotherservicepack,closethetool andreopenitbeforerepeatingthisprocedure.
88
Issue 3 August 2012
13.4 Service Pack or Feature Pack Uninstallation

Ifyoueverwanttouninstallaservicepackorfeaturepackthatyoupreviouslyinstalled,performthe followingsteps.
Procedure 25: To uninstall a service pack or feature pack

1. 2. 3. 4. 5. 6. 7. Intheserverdevice,navigateto/usr/local/cambium/wm/server/bininLinux orC:\Cambium\WM\server\bininWindows. LaunchthetoolServerAdminTool.shorServerAdminTool.bat. IntheServerActionsblockoftheWMServerpanelintheWMAdministratorTool,clickthe StopWMServerbutton. LaunchthetoolUpdateManager.shorUpdateManager.bat. RESULT:Theinterfacetothetoolopens.AnexampleisshowninFigure3onPage86. Clicktohighlighttheservicepackorfeaturepackthatyouwanttoremovefrom deployment. Optionally,clicktheDetailsbuttontoseeinformationabouttheservicepackorfeature pack. ClicktheUninstallbuttontoremovetheservicepackorfeaturepackfromdeployment. RESULT:TheUninstallwindowopensasshowninFigure6,listingtheservicepacksor featurepacksthatwillbeuninstalled.
Figure 6: Service pack Uninstall window
89
Issue 3 August 2012

important ........... If you proceed by clicking the Finish button, then all service packs or feature packs that are later (higher-numbered than your selected one) will be automatically uninstalled as well.
8. 9.
Ifyouwanttoaborttheuninstallation,clicktheCancelbutton. Ifyouwanttoexecutetheuninstallation(s),clicktheFinishbutton. RESULT:TheUninstallationstatuspanelopenstodisplayprogress.Anexampleisshownin Figure7.
Figure 7: Service pack Uninstallation status panel
10. Either checkthecheckboxforAutomaticallycloseafteruninstallationandthenclicktheFinish button. waituntiltheprogressisshownas100% CompletedandthenclicktheClosebuttonto dismissthewindow.
11. IntheServerActionsblockoftheWMServerpanelintheWMAdministratorTool,clickthe StartWMServerbutton.
90
Issue 3 August 2012
13.5 WM Downgrade from Release 4.0

NodowngradepathexiststoretreatfromWMRelease4.0toanyearlierrelease.Todothis,youmust uninstallRelease4.0andthenreinstalltheearlierrelease.TheRelease4.0installationtoolplacedits uninstallationtoolat
C:\Cambium\WM\Uninstall\Uninstaller.exeinWindows.
/usr/local/cambium/wm/Uninstall/Uninstaller.bininLinux.
note ............. After the uninstallation tool finishes, you may or may not encounter the following error message in a pop-up window: Unknown or newerVersion Installation Detected. An instruction to remove the /etc/init.d/wmserver file may be included in this window, regardless of whether the OS is Windows or Linux. This error may be thrown under a variety of circumstances such as low resources, competing processes, or an interruption of uninstallation tool processes. Typically though, regardless of what circumstance triggers the error, the result that triggers the error is corruption of the InstallAnywhere Registry file. Continue through this section to resolve the error.
IfyourantheUninstallerscripttoremoveWMandtoremoveLicenseManageratthesametime, thenyoumustremovefromtheregistryfilethefeaturetagsforproductnames ...Wireless Manager...,...License Manager,andforcomponentnameLinLICor WinLIC.ThisisessentialforanysubsequentinstallationthatchecksforthepresenceofLicense Managertosucceed.Examplesofthecontentsfromaregistryfilefollow.
91
Issue 3 August 2012
- <product name="Cambium Networks Wireless Manager 4.0" id="c45ac526-1ee9-11b2-b9f1da59c1a72547" version="4.0.4.0" copyright="2012" info_url="" support_url="" location="C:\Cambium\WM" last_modified="2012-02-16 20:46:32"> <vendor name="" id="c45ac516-1ee9-11b2-b9f1-da59c1a72547" home_page="" email="" /> - <feature short_name="WMS" name="WMS" last_modified="2012-02-16 20:45:27"> - <![CDATA[ <Enter Product Feature description here -- do not forget to assign this Feature to desired Install Sets> ]]> <component ref_id="d34cf756-1ee9-11b2-bf14-da59c1a72547" version="1.0.0.0" location="C:\Cambium\WM\perl-DBI-1.40-8.i386.rpm" /> <component ref_id="c45ac565-1ee9-11b2-b9fb-da59c1a72547" version="1.0.0.0" location="C:\Cambium\WM\jre" /> <component ref_id="c4633bf4-1ee9-11b2-bbdf-da59c1a72547" version="1.0.0.0" location="C:\wmserver" /> </feature> - <feature short_name="MySQL S" name="MySQL Server" last_modified="2012-02-16 20:46:08"> - <![CDATA[ <Enter Product Feature description here -- do not forget to assign this Feature to desired Install Sets> ]]> <component ref_id="d34cf756-1ee9-11b2-bf14-da59c1a72547" version="1.0.0.0" location="C:\Cambium\WM\perl-DBI-1.40-8.i386.rpm" /> <component ref_id="c45ac565-1ee9-11b2-b9fb-da59c1a72547" version="1.0.0.0" location="C:\Cambium\WM\jre" /> <component ref_id="d303eec7-1ee9-11b2-857a-da59c1a72547" version="1.0.0.0" location="C:\Cambium\WM\mysql-enterprise-5.1.48-win32.msi" /> </feature> - <feature short_name="JRE" name="JRE" last_modified="2012-02-16 20:46:09"> - <![CDATA[ <Enter Product Feature description here -- do not forget to assign this Feature to desired Install Sets> ]]> <component ref_id="6140fa12-1eee-11b2-a328-c06f25b923f3" version="1.0.0.0" location="C:\Cambium\WM\jre-6u6-linux-i586.rpm" /> </feature> - <feature short_name="MS-VC++2005" name="MS-VC++2005" last_modified="2012-02-16 20:46:17"> - <![CDATA[ <Enter Product Feature description here -- do not forget to assign this Feature to desired Install Sets> ]]> <component ref_id="de73334a-1ef3-11b2-832f-c06f25b923f3" version="1.0.0.0" location="C:\Cambium\WM\visual_c_plusplus_2005_sp1_redist_x86.exe" /> </feature> - <feature short_name="License" name="License Manager" last_modified="2012-02-16 20:46:32"> - <![CDATA[ <Enter Product Feature description here -- do not forget to assign this Feature to desired Install Sets> ]]> <component ref_id="dad51170-1ef3-11b2-8422-c06f25b923f3" version="1.0.0.0" location="C:\Cambium\WM\license_manager.exe" /> </feature> </product>
92
Issue 3 August 2012
</product> - <product name="WM License Manager" id="925168a8-1ef3-11b2-b8b7-c06f25b923f3" version="4.0.1.0" copyright="2004-2012" info_url="www.canopywireless.com" support_url="www.canopywireless.com/support" location="C:\Cambium\LicenseManager" last_modified="2012-02-16 20:49:29"> <vendor name="Cambium Networks" id="5678ffb6-1ee9-11b2-8d91-da59c1a72547" home_page="www.cambiumnetworks.com" email="technical-support@canopywireless.com" /> - <feature short_name="LicMgr" name="License Manager" last_modified="2012-02-16 20:49:29"> - <![CDATA[ Install Prizm License Manager Server and License Manager Admin Web Server. ]]> <component ref_id="6ed1feae-1eed-11b2-9b06-a704e97cb190" version="4.0.1.0" location="C:\Cambium\LicenseManager\Uninstall\Uninstaller.exe" /> <component ref_id="6effe344-1ee8-11b2-b1bf-da59c1a72547" version="4.0.1.0" location="C:\Cambium\LicenseManager\_jvm" /> <component ref_id="1a26b7de-1ef5-11b2-843b-c06f25b923f3" version="4.0.1.0" location="C:\Documents and Settings\Administrator\Start Menu\Programs\Cambium Networks\LicenseManager\License Files.lnk" /> </feature> </product>
- <components> <component id="1a26b7de-1ef5-11b2-843b-c06f25b923f3" version="4.0.1.0" name="WinLIC" location="C:\Documents and Settings\Administrator\Start Menu\Programs\Cambium Networks\LicenseManager\License Files.lnk" /> <component id="6effe344-1ee8-11b2-b1bf-da59c1a72547" version="4.0.1.0" name="InstallAnywhere VM Component" location="C:\Cambium\LicenseManager\_jvm" vendor="Cambium Networks" /> <component id="c4633bf4-1ee9-11b2-bbdf-da59c1a72547" version="1.0.0.0" name="AGApplication, Install" location="C:\wmserver" /> <component id="d303eec7-1ee9-11b2-857a-da59c1a72547" version="1.0.0.0" name="AGInstall, MySQL D" location="C:\Cambium\WM\mysql-enterprise-5.1.48-win32.msi" /> <component id="dad51170-1ef3-11b2-8422-c06f25b923f3" version="1.0.0.0" name="AGLicense" location="C:\Cambium\WM\license_manager.exe" /> <component id="c45ac565-1ee9-11b2-b9fb-da59c1a72547" version="1.0.0.0" name="InstallAnywhere VM Component" location="C:\Cambium\WM\jre" /> <component id="d34cf756-1ee9-11b2-bf14-da59c1a72547" version="1.0.0.0" name="AGInstall, MySQL D" location="C:\Cambium\WM\perl-DBI-1.40-8.i386.rpm" /> <component id="6140fa12-1eee-11b2-a328-c06f25b923f3" version="1.0.0.0" name="AG- JRE" location="C:\Cambium\WM\jre-6u6-linux-i586.rpm" /> <component id="de73334a-1ef3-11b2-832f-c06f25b923f3" version="1.0.0.0" name="AG- MSVC++2005" location="C:\Cambium\WM\visual_c_plusplus_2005_sp1_redist_x86.exe" /> <component id="6ed1feae-1eed-11b2-9b06-a704e97cb190" version="4.0.1.0" name="AGPrizmEMS, LicMgr, Postgres" location="C:\Cambium\LicenseManager\Uninstall\Uninstaller.exe" vendor="Cambium Networks" /> </components>
93
Issue 3 August 2012
InWindows,thisfileisC:\Program Files\Zero G Registry\.com.zerog.registry.xml. AccesstoboththisfolderandthisfilerequirethatExplorerisconfiguredtodisplayhiddenfolders. Ifitisnotalreadyconfiguredtodisplaythem,performthefollowingsteps: 1. 2. 3. 4. 5. 6. 7. 8. 9. NavigatetothefolderZero G Registry. FromthemainWindowsmenu,selectToolsFolderOptions. ClicktheViewtab. SelectHiddenfilesandfoldersShowhiddenfilesandfolders. ClicktheApplybutton. Openthefile.com.zerog.registry.xmlforediting. Removethecontentsdescribedabove. Saveandclosethefile. Optionally,backintheFolderOptionswindow,selectDonotshowhiddenfilesandfolders.
InLinux,thisfileis/var/.com.zerog.registry.xml. IfyourantheUninstallerscripttoremoveWMRelease4.0thatwasinstalledasanupgrade,thenthe scriptdidnotpromptforwhethertouninstallMySQLServer.Thefollowingremainingpackagescould interferewithasubsequentWMinstallationandcausetheinstallationtooltothrowtheerror MySQL server detected:

MySQL-server-enterprise-version.rhel4 MySQL-client-enterprise-version.rhel4
IfyouuninstalledMySQLServerwithoutusingtheWMUninstallationscript,thenbeawarethatyour uninstallationdidnotremovethedatadirectory.
94
Issue 3 August 2012
14 WM Software and Feature Licensing

WMrequiresLicenseManagersoftware,distributedbyCambiumNetworks,toenforcethelicense requirementsandtobrokerflexibleunusedlicenses.LicenseManagerserveritselfdoesnotrequirea licensetofunction.However,thelicensesthatWMrequiresarelockedtotheMACaddressofthe device(s)whereLicenseManagerresides.OnesingleorthreeredundantLicenseManagerserversare supported. OperatorsmustensurethattheLicenseFileDatapaneloftheWMAdministratorToolcontinuouslyis populatedwithcorrectinformationfor eitherthehostnameortheIPaddressofeachLicenseManagerserver. portnumbersforeachLicenseManagerserveranditswebserver. theloginnameandpasswordforWMtousefromitsAPIwhenreturningtoandrequesting fromeachLicenseManagerserveranyflexiblelicensesthatarenotcurrentlyinuse.
OperatorsmaydeployLicenseManagerlocalorremotetotheWMserver. IfallLicenseManagerserversfailorloseconnectivitywiththeWMserver,licensesthatarealready checkedoutbymanageddevicesremainvalidandWMcontinuestomanagethelicensedelements withoutrestrictionorinterruption,butanyattemptsbyWMtocheckoutanunusedlicensewillfail untiltheserveroritsconnectionrecovers.Attemptstoreturnalicensethathadbeenusedbyanow deletedelementoranewlyunmanagedelementwillsucceedandwillberesyncedwithLicense Managerwhenitsservercomesbackup.
14.1 License Types

TheWMserveritselfrequiresthepurchasedlicensetypeWMServer.Thistypeisorderedand deployedinadenominationbasedonacountofthenumberofserversthatwillsharethelicense.An installedWMserverwillnotstartifitisnotlicensedbythisscheme.Alllicensesofallthreetypesare lockedtotheMACaddressoftheWMserverthatwilluseandmanagethem. ThefeaturessupportedbyWMarelicensedbyapracticablenumberofWMEMSPackpurchased licenses,oneforeachdeviceofalicenseddevicetype.Whennofreefloatinglicenseofthistypeis availableandanewelementisdiscovered,WMautomaticallygeneratesamajoralertstatingthata licensecheckoutattemptfortheelementfailed.Whenonebecomesavailable,WMonsubsequent discoveryautomaticallyobtainsitfromLicenseManagerandbeginstomanagetheelement.
14.2 Calculation of the Number of Nodes to be Licensed

TheWMEMSPacklicensecountsarehostedfromonlythemachinethathostsLicenseManager. Toorderalicenseofthistype,youmustknowthenumberofnodesthatyouneedittocover. Thefollowingfactorsaffectthatnumber: thedevicetypedetermineswhetherandhowanodeiscountedagainsttheWMlicense limit. eachnetworkelementofthefollowingtypesisnotcountedasanode: PMPSeriesSM PTPSeriesslave
95
Issue 3 August 2012
eachdeviceofamultiagentdeviceiscountedasonenode: eachCambiumdeviceofatypenotspecificallynotedinthislistcountsasonenode. eachthirdpartydevice(SNMPenablednonCambiumdevice)forwhichyouhavecreateda validdevicedefinitiontemplate. eachgenericdevice(SNMPenablednonCambiumdeviceforwhichnovaliddevice definitiontemplateexists)countsasonenode.
FollowingtheupgradetoRelease4.0 1. 2. theoperatorshoulduploadavalidlicenseofappropriatedevicecount. duringserverstartup,thenumberofdevicesthatarealreadystoredinthedatabaseis countedagainstthedevicelicensecount.Ifasufficientcountisnotavailableforthem,then theserverstartupfails. duringthefirstandanysubsequentautodiscovery,allnewdiscoverednodesthatWM Release4.0classifiesascountablearelicensedandaddedtothatcount,evenifsomepre existingnodesinthedatabaseareyettoberediscovered.
3.
Followingthefirstautodiscovery,thecountoflicensednodesisnolongeraffectedbythenumberof nodesthathadbeencontainedinthedatabaseinthepreviousrelease.
14.3 Notifications of License Limits

AWMserverchecksoutonecountofthelicensespecifiedintheWMEMSPacklicensewhenevera deviceotherthanaPMPSeriesSMorPTPSeriesSlaveisdiscoveredandmanagedbyWM.Whenthe numberofcheckedoutlicensecountsatthelicenseserverreaches90%ofthetotallicensecounts, WMthrowsamodaldialogwindowtousersincurrentsessionsandtouserswhoarelaunchingthe clientapplication,warningthatmoreWMEMSPacklicensecapacitywillberequired.Whenthe numberexceedsthetotaloflicenses,nolicensewillbemadeavailableforcheckoutuntilalicensed deviceisdeletedfromanetworkandtherebyforfeitsthefloatinglicensethatitheld.
14.4 WM License Replacement

IfyouareusingatimeboundlicensetooperatetheWMapplication,planaheadandhavea replacementlicensereadybythetimetheexistingoneexpires.WMdoesnotwarntheoperatorthat alicenseisnearexpirationandwillnotrestartafteritdoesexpire. Thissectionassumesthatthereplacementlicensehasbeenprocuredandcopiedtoafolderonthe server,andthatanactiveEthernetconnectionexistsintheserverdevice.ToreplaceaWMserver license,usetheinstructionsthatProcedure22onPage74ofthisguideprovides,beginningwithits Step13.
14.5 Recovery From Forgotten Password for the License Manager Administrator Tool
IfyoueverforgetthepasswordoftheLicenseManagerAdministratorTool,youwillneedtoresetitin theLicenseManagerserver.Todoso,performthefollowingsteps.
96
Issue 3 August 2012
Procedure 26: To reset the License Manager Administrator Tool password

1. OntheLicenseManagerwebserverdevice,stoptheserviceWMLicenseManagerWeb Server.HowtodothisdependsonyourOSand,inthecaseofWindows,yourControlPanel viewtoggle.AnexampleforWindowsXPProfessionalisasfollows: a. b. c. d. e. f. g. 2. SelectStartControlPanel. SelectSwitchtoClassicView. DoubleclickAdministrativeTools. DoubleclickServices. ClickthecolumnheadName. ClicktohighlightWMLicenseManagerWebServer. Intheleftpanel,clickStoptheservice.
IfyourLicenseManagerAdministratorToolisonaWindowsdevice,openthefile
C:\Cambium\LicenseManager\FLEXnet\api\www\config\licensing.xmlonthat
Windowsserver. IfyourLicenseManagerAdministratorToolisonLinux,openthefilelicensing.xml in/usr/local/cambium/LicenseManager/FLEXnet/api/www/config/onthatLinux server. 3. Findthelinethatissimilartothefollowing:

<server port="27000" webServerPort="27443" username="lmadmin" host="localhost" password="mypXJ8T7AW3GXzK+NvSzeg==" />
4.
Deletethecontentsofthepasswordattributeoftheserver tagandtheadmin tag. RESULT:Thelinenowreadsasfollows:

<server port="27000" webServerPort="27443" username="lmadmin" host="localhost" password="" /> <admin password="" username="lmadmin"/>
5. 6.
Saveandclosethefile. RestarttheLicenseManagerwebserver. NOTE:Thiscausesthewebservertoreadthenullcurrentcontentsofthepassword attribute. LaunchtheLicenseManagerwebsite. Login,leavingthepasswordfieldblank. ClickthePasswordbuttonintheLicenseManagerpanel. LaunchtheWMServerAdministratorTool.
7. 8. 9.
10. Populatethepassword. 11. Intheleftpaneloftoolinterface,clickonLicenseManager. 12. UpdatethecontentsofthePasswordfieldintheLicenseFileDatapanel. RESULT:TheAdministratorToolwillbeabletousethisnewpasswordtouploadfuture licensefilesintoLicenseManager. 13. ClicktheSaveConfigurationbutton.
97
Issue 3 August 2012
AfteryouhaveresetthepasswordbutbeforeyouusetheLicenseManagerAdministratorToolweb sitetoconfigureandinstalllicensefiles,youmustclickthelinkforLicensingConfiguration,then changethepasswordforthelocalserverandclicktheSaveChangesbutton.Thenyoucanuploadthe licensetothelocalLicenseManager.
14.6 Deployment of Redundant License Manager Servers

14.6.1 Purpose of Redundancy
RedundancyofLicenseManagerserversisanadvancedformofdeployment,usedonlytoprovide protectioninfailovercases.Thisdeploymentisnotforloadsharing. Theadministratormustconfigureandmaintainasetofthreelicenseserversthattogetherservea singlesetoflicenses.OnlytheonethatisdesignatedasthemastersuppliesthelicensestoWM.Ina threeserverdeployment,atleasttwolicenseserversarerequiredforlicensestobeserved.Iftwoof theserversgodownviafailureand/orreboots,thedeploymentfailsandcanbereestablishedonlyby properlyrestartingtheservers.Duringtheoutage,licensescannotbecheckedout,butpreviously assignedlicensesremainassigned.
14.6.2
Configuration of License Key Files for Redundancy

WhenyouidentifythreeserversforLicenseManagerredundancy,youmustensurethattheymeet thefollowingstandards: Theysharefastandreliablelinks. Theyallexistwithinthesamesubnet. Eachhasavalidhostnameotherthanlocalhostorlocalhost.localdomain.
Whenyourequestlicensestobemanagedbyredundantservers,youmustprovidetheMACaddress ofeachofthethreeservers. Bythetimethatyouuploadtheselicensesintothethreeservers,theMACaddressofallLicense Managerserversmustbelistedinidenticalorderineverylicensekeyfileoneachserver.Example contentsofalicensekeyfileisasfollows:

SERVER 172.16.5.8 0019bbdc013c 27000 SERVER 172.16.3.33 000bdbc56b9b 27000 SERVER 172.16.4.108 001ec938a5d9 27000 VENDOR motocnpy USE_SERVER
Theserverdetailsmustbeintheprimary,secondary,andtertiarylicenseserverorder.Iftheir sequentialorderinanyfilediffersfromtheorderinanyotherlicensefileheldamongthethree servers,licenseadministrationfails.Ifyouwish,youcanchangetheserverlisttoanorderdifferent fromtheorderyoureceivedfromCambiumNetworks.However,ifyoudo,youmustmakeidentical changestoalllicensesonallservers.
98
Issue 3 August 2012
14.6.3
Redundancy Deployment Process

TodeployredundantLicenseManagerservers,performthefollowingsteps.
Procedure 27: To deploy redundant license servers

1. 2. 3. 4. 5. 6. 7. 8. Oneachofthethreemachines,ensurethatthehostsfilecontainsavalidmappingofits IPaddresstoitshostname(localhost.localdomainisnotvalid). EnsurethattheWMLicenseManagerisinstalledoneachofthethreemachines. StoptheLicenseManagerservice. IntheLicenseManagerwebserver,navigatetothe
LicenseManager\FLEXnet\api\www\configdirectory.
Openthefilelicensing.xmlforediting. Changehost="localhost"tohost="MachineIPAddress". Writeandclosethefile. Inthestepsthatfollow,referalsotoUsingtheLicensingPanelonPage107. Uploadthelicensefiles,eveniftheywerepreviouslyuploaded.
note ............. This step resolves the this_host entry for SERVER in each license to the appropriate IP address.
9.
StarttheLicenseManagerservice.
10. Checkwhethermorethanonelicensehasbeenuploadedintoanyofthethreemachines.
note ............. This can be done by checking the license status page of the three machines. Only one license should be available for the dummy feature.
11. Ifanymachinehasmorethanoneuploadedlicense,performthefollowingsteps: a. b. StoptheLicenseManagerwebserverandLicenseManager. FromthedirectoryC:\Cambium\LicenseManager\FLEXnet\license_filesin Windows(or/usr/local/cambium\LicenseManager\FLEXnet\license_files inLinux),deleteeverylicensefileexceptdummy.licordummy.lic.RENAMED. Ifthelatterfileispresent,renameittodummy.lic. Startthetwoservers.
c. d.
12. OneachLicenseManagerwebserverthatwillbeusedastheredundantserver,performthe followingsteps: a. b. LogontotheLicenseManagerwebserver. ClicktheLicensingConfigurationlink.
99
Issue 3 August 2012
Figure 8: Licensing Configuration panel in License Manager web server
c. d.
IntheLicensingConfigurationwebpage,selecttheRedundantServercheckbox. EnterthelicenseserverIP,licenseserverport,licensewebserverusername,password, andport.
important ........... Ensure that the IP addresses are in sequence of primary, secondary, and then tertiary server and that the order is identical in every license file among the three servers. Also ensure that all IP addresses are routable from each of the servers.
e.
ClicktheSaveChangesbutton.
13. Logontothewebserverinterfaceoftheprimarylicenseserver. 14. ClicktheUploadLicenseFilelink. 15. Uploadthelicensefiles. 16. RepeatSteps6and7onthesecondaryandtertiaryservers. 17. Allthelicensesshouldbeuploadedtotherequiredlicenseservers. 18. CheckthedirectoryC:\Cambium\LicenseManager\FLEXnet\license_files inWindowsor/usr/local/cambium\LicenseManager\FLEXnet\license_filesin Linuxtoensurethatthefilenamesarepresent.
note ............. Do not use simple file copying to place these files into the directory. Use the scripted Upload License File selection.
19. Furthercheckthelicensesfortheirstatusasfollows: a. b. Logontothewebserverinterfaceoftheprimarylicenseserver. ClicktheLicensingStatuslink.
100
Issue 3 August 2012
Figure 9: Licensing Status panel in License Manager web server
c. d. e. f. g.
Checkthatthestatusreportshowsthetotalnumberoflicensesthatyouexpecttosee. Logontothewebserverinterfaceofthesecondaryserver. Checkthestatusreportforconsistencywiththatfromtheprimaryserver. Logontothewebserverinterfaceofthetertiaryserver. Checkthestatusreportforconsistencywiththosefromtheothertwoservers.
14.7 Workaround for a License Server Failure

14.7.1 Failure or Reboot of a License Manager Server
RestartingLicenseManagerisnecessaryinanyofthefollowingcases: Twoofthreeserversgodownbecauseofafailureorareboot. Onlytwoserversweredeployed,andoneisdownbecauseofafailureorreboot.
101
Issue 3 August 2012
Astandaloneserverisdownbecauseofafailureorreboot.
WheneveryouhaverestartedLicenseManager,restarttheWMserver.
14.7.2
Change in the IP Address of a License Manager Server

IftheIPaddressofanyofthethreeredundantlicensingserverschanges,performthefollowingsteps: 1. 2. 3. 4. 5. 6. Updatetheredundantserverconfigurationoneachofthelicensewebserver. StoptheLicenseManagerserviceonallthreeservers. IntheWMserver,navigatetothe/LicenseManager/FLEXnet/license_files directory. Ifthenameofthedummy.licfilechangedtodummy.lic.RENAMED,thenrenameitto dummy.lic. Exceptfordummy.lic,deletetheexistinglicensefilesinthefolder. InalllicensefilesreceivedfromCambiumNetworks,updatetheIPaddressofthemachine whoseaddresschanged. Uploadthesechangedlicensefiles. StarttheLicenseManagerintheorderprimary,thensecondary,andthentertiaryserver. IntheLicensingStatuslink(Figure9onPage101),verifythatallthelicensesareproperly uploaded.
note ............. Ensure that the changed line has the MAC address of that machine only.
7. 8. 9.
14.7.3
Server Restarts in LM Redundancy

ForrestartingtheredundantLicenseManager,allthreemustberestartedsothatthewholesetupis readytobeused.Theorderofrestartingmustbeprimary,thensecondary,andthentertiaryserver.
102
Issue 3 August 2012
15 WM Administrator Tool for Server Administration

TolaunchthispanelfromthemainmenuintheWMclient,select ToolsAdministrationServerAdministration. ThedefaultsforthevariouspanelsoftheWMAdministratorToolareasshowninthissection.The fieldsthatrequireattentioninatypicalsetuparenotedinothersectionsofthisguide. Ifyouperformanyactioninoneofthesepanelsandthenattempttoleavethetooloraccessanother panelwithapplyingyourchanges,theGUIpromptsyouforwhetheryouwanttoapplythem:
15.1 Using the WM Server Panel

TolaunchthispanelfromthemainmenuintheWMclient,select ToolsAdministrationServerAdministration;intheleftpaneloftheresultingWMAdministrator Tooldialog,selectWMServer.
Figure 10: WM Server panel of WM Administrator Tool
103
Issue 3 August 2012
TheSystemBackupoptioncopiesallinformationthatisnecessarytolaterreturnthesystemtothe currentstate.ThisincludestheentiredatabaseandallessentialfilesoftheWMserverfilesystem. TheRestoreSystemoptionreplacesthecurrentdatabaseandallessentialfilesoftheWMserverfile systemwiththethosethatwerelastcopiedusingtheSystemBackupcommandoption. TheseoperationscannotbeperformedintheclientunlesstheclientislocaltotheWMserver.Other clientsessionsthatcontinuetorunduringtheSystemBackupcauseatleastconfusionaboutwhat hasbeenbackedup,inthattheresultsofitscurrentandlateroperationsarenotrecordedintothe backup.Forthisreason,WMthrowsanerrorintothoseclientsessions,indicatingthatitwillpause untiltheremotebackup(ontheserverdevice)hasconcluded. Thefollowingarenotsupportedrestorescenarios,althoughtheymaysucceedincertaincases: RestoreSystemofthebackupdatathatwascreatedonanothermachine. RestoreSystemonthesamemachine,butwherethedatabasebackedupwasofadifferent MySQLversionfromtheMySQLversionthatisonthetargetdevice.
AlthoughtheremoteclientshavethispanelintheirversionoftheWMAdministratorTool,thepanel theredoesnotincludetheSystemBackupblockshownabove. TheServerActionsblockofthispanelisalsospecifictowhethertheserverislocal: InaclientsessiononthelocalWMserver StopWMServerisactivewhentheserverisrunning.Whenthisoptionisinvoked, WMproceedstoshutdownwithoutthrowingawarningoraconfirmation. StartWMServerisactivewhentheserverisnotrunning. RestartWMServerisactivewhentheserverisrunning.Whenthisoptionisinvoked, WMthrowsapopupmessageintoclient,sayingthattheconnectionhasbeenlostand promptingforwhethertoclosetheclientorresumethesessionwhentheservercomes backup.
note ............. Start differs from restart as follows: Start commands start the service; in a two-step automatic operation, Restart commands stop the running service and then restart it.
InaclientsessionremotetotheWMserver,neithertheServerActionsblocknoranyofthe commandoptionsdescribedabovearepresent.
ThefunctioninvokedbytheNEReSyncandNEReSyncafterbackupbuttonsistoremovethe eventsandalarmsofallthemanagedelementsaswellastheirtrapsthatWMiscurrentlyprocessing, andtorefreshtheirstatus,buttoallowtheirstatisticstocontinuetobestored.Ifyouselecteitherof these,WMthrowsawarning.
Thisamountofstatuspollingconsumesasignificantamountofresources.Considerthisadvisory carefullybeforeyouconsiderconfirmingbyclickingtheYesbutton.
104
Issue 3 August 2012
15.2 Configuring the BAM Panel

TolaunchthispanelfromthemainmenuintheWMclient,select ToolsAdministrationServerAdministration;intheleftpaneloftheresultingWMAdministrator Tooldialog,selectBAM.
Figure 11: BAM panel of WM Administrator Tool
TheBAMConfigurationblockdefaultstothefollowingattributevalues.
Tomakeanychangesfromthedefaults,clickintheValuecell.Thistransformsthecellfromreadonly dataintoatextbox.Typeinthesubstitutevalue.Then,toreturnthecelltoreadonly,clickelsewhere inthetable(intheAttributecolumnoroneofthecolumnheadings,forexample). BAMprivilegesareessentialtoitsmanagementfunctionalities,andeachmappedprivilegemustbeat theSystemAdministration(A)level.
105
Issue 3 August 2012
15.3 Configuring the Database Panel

note ............. Although the WM Administrator Tool provides GUI access to execute database backup and restore, these options are not included in the Database panel. See Using the WM Server Panel on Page 103.
TolaunchthispanelfromthemainmenuintheWMclient,select ToolsAdministrationServerAdministration;intheleftpaneloftheresultingWMAdministrator Tooldialog,selectDatabase.
Figure 12: Database panel of WM Administrator Tool
WMencryptsthedatabasePasswordsuchthatitisneverreadableineithertheWMserverfile systemortheWMclient.However,anychangethatyoumakeinthePasswordfieldofthispanel mustreflectthepasswordthatisconfiguredinMySQL. TheResetbuttonreturnsallofthevaluestotheirdefaults.Sincetheseareallconnectionrelated attributes,theResetoperationdoesnotreturntheoriginaldatabaseschemaaswell.Ifyouchanged thetablestructureordeliberatelyalteredanyotherSQLsettingsandnowneedtoreverttothe
106
Issue 3 August 2012
configurationthattheWMinstallationtoolhadinstalled,performthestepsofProcedure5:To restoretheinstalledWMdatabaseconfigurationonPage26. TheTestbuttonlaunchesatestoftheconnectionbetweenWMandthedatabase,usingthecurrent settingsinthispanel.Whenthevaluesareproperlyset,theexpectedresultoftheconnectiontestis thefollowingpopupmessage:
15.4 Using the Licensing Panel

OnesingleorthreeredundantLicenseManagerserversaresupported.Oneofthesemaybelocalto theWMserver.SeeWMSoftwareandFeatureLicensingonPage95. ThispanelconfigureshowWMcommunicateswiththelicensingserver(s)andalsoprovidesoptions tostart,stop,andrestartLicenseManager,andtouploadlicensefilesintoLicenseManager.To launchthispanelfromthemainmenuintheWMclient,select ToolsAdministrationServerAdministration;intheleftpaneloftheresultingWMAdministrator Tooldialog,selectLicensing.
Figure 13: Licensing panel of WM Administrator Tool
note ............. Start differs from restart as follows: Start commands start the service; in a two-step automatic operation, Restart commands stop the running service and then restart it.
107
Issue 3 August 2012
Changesthatyousaveandlicensesthatyouuploadarereflectedinthefile
.../server/conf/licensing.xml.RestartLMisnotnecessitatedbylicenseuploads.
TheUploadLicenseoptionopensabrowsertothelocalfilesystem.
Figure 14: Upload License File dialog
AnexampleofLicenseStatusinformationisasfollows.
108
Issue 3 August 2012
Figure 15: License Manager Status display window
...
109
Issue 3 August 2012
15.5 Configuring the NBI Panel

TheNorthboundInterface(NBI)providesanSNMPbasedJavaManagementExtension(JMX)agent forothermanagementsystemstopollWMforinformationaboutitsmanagedobjects,events, alarms,andperformancedata. TheNBIpanelconfigurestheagentofWM.TolaunchthispanelfromthemainmenuintheWM client,selectToolsAdministrationServerAdministration;intheleftpaneloftheresultingWM AdministratorTooldialog,selectNBI.
Figure 16: NBI panel of WM Administrator Tool, active SNMP V3 settings
TheNBIpanelallowsyoutochangetheNBIpasswordsforSNMPv3basedsecurity. TheAuthPasswordfieldistheSNMPv3Authenticationpassword. ThePrivPasswordfieldistheSNMPv3Privacypassword.
TousetheV3agent,youmustprovideboth.ThedefaultpasswordsareauthPasswordand
privPassword,respectively.
ThetwoSNMPsettingsblocksofthisdialogareactiveonlyiftheyhavecontextintheselected SNMPVersion.
110
Issue 3 August 2012
Figure 17: NBI panel of WM Administrator Tool, active SNMP V1/V2 settings
TomakeanychangeintheTrapForwardingConfigurationtable,youmustfirstcheckthe EnableTrapForwardingcheckbox.Afterthisisdone tochangeanexistingconfiguration,doubleclickthecellwhosecontentsyouwanttochange andtypethenewcontentintotheresultingtextboxthere. toremoveanexistingconfiguration,clickthehighlighttheconfigurationyouwanttodelete; thenclicktheRemoveTrapForwardingbutton. toaddaconfiguration,clicktheAddTrapForwardingbutton;thenforeachcolumn,double clickintheblankcellandtypethecontentsintotheresultingtextbox.
Toenforceallofthechangesyouhavemadeinthisdialog,clicktheApplybutton.Todismissthe dialog,clicktheOKbutton.
important ........... To ensure WM security, these passwords should be changed soon after installing WM.
15.6 Using the Offline Physical Map Panel

TheuseofthistoolinterfacepresumesthatyouhaveconfiguredofflinemaplayersinGeoServer.This toolmakesthoselayersavailabletoWMbyspecifyingtheimagelayers,pointingWMtotheproper connectionparametersforcommunicationwithGeoServer,andswitchingontheoptionaloffline physicalmapfeature.InstructionsandbackgroundinformationfortheGeoServersetupareprovided underOfflinePhysicalMapSetuponPage63. TolaunchthispanelfromthemainmenuintheWMclient,select ToolsAdministrationServerAdministration;intheleftpaneloftheresultingWMAdministrator Tooldialog,selectOfflinePhysicalMap.
111
Issue 3 August 2012
Figure 18: Offline Physical Map panel of WM Administrator Tool
note ............. The following operations require both a click of the Apply button and a new client session in order to be reflected in the client: Enable offline physical map, Add Layer, and Delete Layer.
TosetupWMtousetheimagelayersthatyouhaveconfiguredinGeoServer,performthefollowing steps:
Procedure 28: To configure WM for offline physical map images

1. 2. 3. 4. 5. 6. 7. 8. 9. ChecktheEnableofflinephysicalmapcheckbox. ClicktheAddLayerbutton. InthenewnullrowoftheOfflineMapLayerstable,clickintheDisplayNamecolumn. Composeanamebywhichyouwillrecognizethelayer. ClickintheLayerNamecolumn. TypeinthenameofthelayerorlayergroupasitwasspecifiedinGeoServer. ClickintheGeoServerHost/IPcolumn. TypeintheIPaddressofremoteGeoServerorlocalhost,ifGeoServerislocaltotheWM server. ClickintheGeoServerPortcolumn.
10. Typein8080. 11. ClicktheTestLayerbutton. ThislaunchesthedemoviewoftheGeoServerwebcacheforthecurrentlyselectedlayeror layergroup.
112
Issue 3 August 2012
12. ForanylayerorlayergroupthatisnotyetseededinGeoServer,optionallyclickthe SeedLayerbuttonandconfigurethethreadsasdescribedabove. 13. TooptionallylaunchtheGeoServerhomewebpage,clicktheLaunchGeoServerbutton. 14. ClicktheUpdatebutton(notshowninFigure18above)towritethelayerinformationto anxmlfileintheWMserverfilesystemforusefromtheWMclientapplication. ThesystemrespondswiththeInformationmessage

Successfully updated offline maps configuration. Please restart your client for the changes to take effect.
Tolatermakechangesintheconfigurationofalayer,performthefollowingsteps.
Procedure 29: To reconfigure offline physical map images in WM

1. 2. 3. 4. Clickthecellthatyouwanttoedit. Overwriteitstextualcontents. ClicktheApplybutton. WhenfinishedintheOfflinePhysicalMapConfigurationpanel,either clickanotherlinkintheleftpaneltoworkinthedesiredotherpanelofthetool. clicktheOKbuttontodismisstheWMAdministratorToolinterface.
15.7 Configuring the Email Configuration Panel

Forseveralvariouspurposes,theWMclientallowsyoutocomposeemailtoconfigurablerecipient addressesforimmediate,delayed,orconditionalsending.Theseinstancesincludeemail triggeredby aneventfilter. analarmfilter. anescalationpolicy.
tocommunicateanoticetooneormorecustomersofyournetworkservices. toaccompanydatagatheredtoinformtechnicalsupportefforts.
Inasinglepanel,theWMadministratortoolallowsyoutospecifyorreconfigurethesettingsthat determinehowtheseemailswillbeprocessed.TolaunchthispanelfromthemainmenuintheWM client,selectToolsAdministrationServerAdministration;intheleftpaneloftheresultingWM AdministratorTooldialog,selectEmailConfiguration.
113
Issue 3 August 2012
Figure 19: Email Configuration panel of WM Administrator Tool
Toconfigurethesesettings,performthefollowingsteps.
Procedure 30: To configure server and admin email settings

1. 2. 3. ForSMTPServerHost,replaceSMTP_SERVER_HOSTwiththehostnameofyourlocalSMTP server. Ifitsportisotherthan25,highlightandoverwrite25withthenumberoftheportthatis locallyreservedfortheSMTPhost. IfyouwantWMtorequireuserstoauthenticatethemselvesbeforetheyareallowedtosend emailorconfigureemailforlatersending,performthefollowingsteps: a. b. c. d. 4. ForLogin,specifytheSMTPusernameforWMtoauthenticateitselftotheSMTPserver. ForPassword,specifytheSMTPpasswordforWMtoauthenticateitselftotheSMTP server. TypethesamestringintotheConfirmPasswordtextbox. ClicktocheckthecheckboxassociatedwithAuthenticationrequired.
ForFromMailID,highlightwm_server@company.comandoverwritethisplaceholder addresswiththeFROMaddressthattheSMTPservershouldmarkintheoutboundemail thatistriggeredbyanescalationpolicyoraneventoralarmfilter. ForToMailID,highlightwm_admin@company.comandoverwritethisplaceholderaddress withtheFROMaddressthattheSMTPservershouldmarkintheoutboundemailthatis addressedtoeithercustomersortechnicalsupportstaff(possiblyinadditiontoothers addedtothesupporttoolbecausetheyaretobecopiedonsupportemails). ClicktheTestbuttontoensurethattheSMTPserveranditsportareproperlyconfiguredin thispanel. Ifthetestissuccessful,clicktheOKbuttontoapplyitssettings.
5.
6. 7.
114
Issue 3 August 2012
16 MIB Browser Usage

MIBBrowseralsoenablesviewingandoperatingthedataavailablethroughanSNMPagentina manageddevice.ThiscanbehelpfulifyoudoubtthatWMisperformingproperlyand,throughSNMP queriesviatheMIBbrowser,wanttoverifyconfigurationandperformancedatathatyouareseeing inWM.WMsupportstheWindowsversionoftheMIBBrowserthatisembeddedinWM.
16.1 Invoking the MIB Browser

YoucaninvoketheembeddedMIBBrowserasanapplicationoranappletfromtheWMserverfile system.
Procedure 31: To invoke the MIB Browser

1. Inthe/usr/local/cambium/wm/server/bindirectoryinLinux (ortheC:\Cambium\WM\server\binfolderinWindows,openthefileMibBrowser.exe orMibBrowser.batforediting. EnsurethattheJAVA_HOMEpathissetproperly. RunMibBrowser.exeorMibBrowser.bat.
2. 3.
Figure 20: MIB Browser main GUI
115
Issue 3 August 2012
TheimageabovedepictstheprimarywindowoftheMIBBrowser.Thebrowserconsistsofthe followingitems: MenuBar:Displaysalistofcommandstoperformvariousoperations. ToolBar:Displaysbuttonswithimagesthatactasshortcutstothemenuoptions. LeftFrame:HoldstheMIBtree.AMIBtreeisastructurethatdisplaysalltheloadedMIBs. TheMIBtreeenablestotraversethetree,viewtheloadedMIBs,andthedefinitionofeach node. RightFrame:Containstextfieldstospecifythebasicparameters,suchashost,community, andsoon.Italsocontainsatextareatodisplaytheresults.
TherearethreewaysinwhichtheprimarywindowoftheMIBBrowsercanbedisplayed.Theyarethe ResultDisplay,MIBDescription,andMultiVarbind.Tochangethedisplay,selectViewDisplayand selectthedesiredview.Bydefault,theMIBDescriptiondisplayisvisibleintheMIBBrowser.
16.2 Configuring the MIB Browser

TheMIBBrowsercanbeusedtoviewandoperateonthedataavailablethroughanSNMPagent.The MIBBrowsercanbeconfiguredintunewithperformingSNMPoperations. ToconfiguretheMIBBrowser,clicktheMIBBrowserSettingsbutton orselectEdit>Settings fromthemenu.YoucanalsousetheshortcutkeycombinationAlt+S. TheMIBBrowserSettingsdialogboxwillbedisplayed.Thedialoghastwotabs: General MIBSettings
16.2.1
Setting Common Parameters

Theparameters,suchashost,port,andcommunity,canbesetintheMIBBrowser'smainwindow. ApplicationsusethehostnameortheIPaddressofthedevicetocommunicatewiththeagentofthe deviceinaparticularportnumber.ThisremoteportnumberistheUDPPort161.Bydefault,allthe SNMPrequestmessagesarereceivedinthisport. SNMPmandatesthattheSNMPagentsshouldacceptrequestmessagesonlyifthecommunitystring inthemessagematchesitscommunityname.Therefore,themanagementapplicationshouldalways communicatewiththeagentsalongwiththeassociatedcommunityname.ThedefaultSNMP communitynamesare"public"forreadonly(GET)operationsand"private"forreadwrite(SET) operations.Themanagementapplicationsshouldhaveprovisiontoincludethecommunitynamesin theirrequestmessages. CommunitystringsareusedtoauthenticateSNMPPDUs.SinceSNMPpacketsareusuallysentusing UDPpackets,thereisnoconnectionestablishedasinthecaseofTCP/IPpackets.Therefore,whena UDPpacketissenttotheagent,theagentvalidatesthepacket.Itacceptsandsendsaresponseifthe communitystringofthePDUisequaltothatsetontheagent,orelsedropsthepacket.Theagent doesnotchangethecommunitynameaftercommunicating.Applicationstypicallycommunicatewith theSNMPagentsbyspecifyingthecommunitynameoftheagent.
116
Issue 3 August 2012
Thedefaultcommunitystringis"public"andthedefaultWriteCommunitystringisnull.WhenWrite Communityisnull,communityitselfisusedforSEToperations.Therefore,applicationsshould explicitlysettheWriteCommunity,beforetheycanuseitforSEToperations. TheotherparametersaresetintheGeneraltaboftheMIBBrowserSettingsframe.Thegeneral settingsincludethebasicprotocoloptionsrelatedtoSNMP,thedisplayoptions,andasectionfor encodingfield.TheimagedepictedbelowshowstheGeneraltaboftheMIBBrowserSettingsdialog box.
Figure 21: MibBrowser Settings dialog
Table 7: MibBrowser General tab fields

Options SNMPVersion Timeout1 Retries1 Encoding2 Default Values v1 5sec 0 ISO8859_1 v2corv3 anyuserdefinedvalue anyuserdefinedvalue anyencodingschemethatsupportstextformat Other Options
117
Issue 3 August 2012 Options MaxRepetitions3 NonRepeaters3 NOTES:

1.
Default Values 50 0
Other Options anyuserdefinedvalue anyuserdefinedvalue
Timeoutisthetimeintervalthatanapplicationwaitsforaresponsemessagefrom anagentbeforetimingout.Retriesisthenumberoftimesarequestissentwhena timeoutoccurs.IftheRetriesvalueis0,therequestisretransmittedonTimeout. Encoding,ingeneral,means,modifyinginformationintotherequiredtransmission format.Computersaroundtheworldstoreinformationusingavarietyofencoding schemes.TheMIBBrowsersupportstheISO8859_1,whichmeanstheISO8859_1 andtheLatinalphabetNo.1.Therearevariousotherencodingschemesthat supportvarioustextformats.Youcanusetheencodingschemethatbestsuitsyour requirementwhileperformingSNMPoperations. TheMaxRepetitionsandNonRepeatersoptionsareenabledonlywhentheSNMP versionissettoeitherv2corv3.ThisisbecausetheGETBULKoperationisavailable onlyinv2candv3.AGETBULKrequestisperformedbygivinganOIDalongwith twootherparameters,MaxRepetitionsvalueandNonRepeatersvalue.
3.
4.
TheValidateBroadcastAddresscheckboxenablesyoutocheckthevalidityofthebroadcastaddress provided.YouneedtoprovidetheNetMaskaddresstovalidatethebroadcastaddress.ANetMaskis astringof0'sand1'sthathidesthenetworkpartoftheIPaddressandallowsonlythehostIDto remain. IntheV3Optionssection,ContextNameandtheContextIDaretobeprovidedasadditional parametersforanSNMPv3request.AnSNMPcontextnameisacollectionofmanagement informationaccessiblebyanSNMPentity.Anitemofmanagementinformationmayexistinmore thanonecontext.AnSNMPentitypotentiallyhasaccesstomanycontexts.Inotherwords,if managementinformationhasbeendefinedundercertaincontextbyanSNMPv3entity,any managementapplicationcanaccessthatinformationbygivingthatcontextname.TheContextID uniquelyidentifiesanSNMPentitythatmayrecognizeaninstanceofacontextwithaparticular contextnamewithinanadministrativedomain. NextistheV3Settingssection.Thefollowingarethesecurityrelatedparametersforaccessingthe SNMPv3agents.Youcanadd,modify,ordeleteusersbyclickingtheAdd,Modify,orDeletebuttons.
Table 8: Security parameters for accessing SNMPv3 agents

Options Username Securitylevel AuthenticationProtocol PrivacyProtocol null noAuthnoPriv MD5(ifauthenticationis choseninsecuritylevel) CBCDES(ifprivacyis choseninsecuritylevel) Default Values Other Options anyuserdefinedvalue AuthnoPrivandAuthPriv SHA notavailable
118
Issue 3 August 2012 Default Values Other Options anyhostwithSNMPV3agent orproxyagent anyuserdefinedport
Options Authentication password Privacypassword Targethost Targetport
anyuserdefinedvalue anyuserdefinedvalue localhost 161
Ifthesecuritylevelis"NoAuthNoPriv",noadditionalparametersarerequired.Ifthesecuritylevelis "AuthNoPriv",theparametersAuthProtocolandAuthPasswordareset.Iftheusersecuritylevelis "AuthPriv",theprivacypasswordneedstobesetinadditiontotheotherparameters. TheV3Settingssectionhasanoptionforstoringthev3tableentries.Thev3tableentriescanbe storedin: aserializedfile adatabase
16.2.2
Storing Table Entries in a Serialized File

Toenableserializationofv3tableentries,selecttheSavev3SettingstoFileoption.Ifthisoptionis selected,theuserinformationisstoredintheserializedfilesnamelyUserEntry.serand EngineEntry.ser.WhentheMIBBrowserisinvokedthenexttime,theserializedfilesaredeserialized andthev3tableisupdated.Theadvantageofstoringtableentriesinserializedfilesisthatthe operationisfaster.
16.2.3
Storing Table Entries in a Database

Tostorev3tableentriesinadatabase,selecttheSavev3SettingstoDatabaseoption.Tousethis option,thedatabaseconnectionhastobeestablished.Clickingonthe"DatabaseSettings"button displaystheDatabaseParametersdialogbox. EnterthenecessarydatabaseparametersintheDatabaseParametersdialogbox,andclicktheOK button.Ifthedatabaseconnectionisestablishedsuccessfully,alltheuserinformationenteredis savedinthedatabase.WhentheMIBBrowserisinvokedthenexttime,v3detailswillberestored andthev3tablewillbeupdated. Theadvantagesofstoringv3tableentriesinadatabaseinclude: ScalabilityAnynumberofentriescanbemaintainedinthedatabase. AccessibilityAlltheauthenticatedusersofthedatabasecanaccesstheentries.
Thelastsectionisthefieldentrysectioninwhichthecorrespondingfieldsinthev3tableare displayedfordataentry.ThevariousbuttonsavailableinthefieldentrysectionareAdd,Modify,and Delete.
119
Issue 3 August 2012
Toaddanentry,entertherequiredparametersintherespectivefieldsandclicktheAddEntry button.Basedontheparametersandthesecuritylevel,DiscoveryandTimeSynchronizationaredone andUSMTableisupdatedandlistedinthev3table. Tomodifyanentry,selecttheentryinthev3table,modifytherequiredfields,andclicktheModify button.TimeSynchronizationisdoneandtheUSMtableisupdatedandlistedinthev3table.

note ............. The NoAuthNoPriv entry cannot be modified. Only the password fields in the AuthNoPriv entry and AuthPriv entry can be modified.
Todeleteanentryinthev3table,selecttheentryinthev3tableandclicktheDeletebutton.The entryisremovedfromtheUSMtable.
note ............. The settings are saved only on exiting the MIB Browser application and not every time the settings are modified. The 'Save v3 Settings to File' option is enabled only in the MIB Browser application and not in the MIB Browser applet because of certain security restrictions in applets. The Restore Defaults button is used to reset the default parameters.
16.2.4
Setting MIB Parameters

TheMIBSettingstabisusedtoloadMIBsinMIBBrowser.ThefirstsectiongivestheMIBloading options.Thenextsectiondisplaysthevariousparsinglevels.
16.2.5
Loading MIBs
ThebasicMIBoperationsareloading,unloading,andparsingMIBfiles.AMIBfilecanbeloaded directly,fromcompiledfiles,orfromadatabase.FollowthestepsgivenbelowtoloadaMIBfile. 1. ClicktheLoadMIBModulebutton orselectFileLoadMIBfromthemenu. Alternatively,youcanusetheshortcutcombinationCtrl+O.ThisdisplaystheLoadaMIBFile dialogbox. IntheLoadaMIBFiledialogbox,selecttheMIBfilefromthe
/usr/local/cambium/wm/server/mibsdirectoryinLinux(orthe C:\Cambium\WM\server\mibsfolderinWindows). note ............. If MIB Browser is used as an applet, the URL should be relative to the Web server path. If MIB Browser is used as an application, the specified URL can be absolute or relative. When you use the MIB Browser applet, it is not possible to read a file on some host that is not the applet's host because of the browser security. In the MIB Browser applet, remote browsing of MIB file is supported through SAS.
2.
3. 4.
ThereareotheroptionsforloadingtheMIBfile.ClicktheRecenttabtoloadtherecently loadedMIBfiles. SelectthecheckboxnexttotheMIBthatistobeloadedandclickOpentoloadtheMIBfile.
note ............. The Load All MIBs option in the File menu loads all the recently loaded MIBs.
ThefollowingsectionsprovideageneraloverviewofthevariousoptionsavailableintheMIBSettings sectionoftheLoadaMIBFiledialogbox.
120
Issue 3 August 2012
MIB Loading Options

ThevariousoptionsavailableforloadingMIBsare: LoadMIBsdirectly LoadMIBsfromcompiledfiles LoadMIBsfromadatabase
ThefollowingimagedepictstheMIBSettingstabintheLoadMIBdialogbox.
Figure 22: Load a MIB File PanelMIB Settings Tab
Load MIBs Directly

TheMIBfileisusuallyreadandparsedintoMIBmodulesanddisplayedintheMIBtree.Inthiscase, whenyouloadaMIBfile,itisparsedandthenloaded.Thisistimeconsumingbecauseparsingis doneeverytimeaMIBfileisloaded.
Loading MIBs from a Database

AnotheroptionisloadingoftheMIBfilesfromadatabase.TheMIBfilescanbestoredinanyRDBMS suchasMySQLorOracle.ApplicationscanloadtheseMIBfilesdirectlyfromthedatabase.This featureisparticularlyusefulwhentheMIBfilestobeloadedaremoreinnumber. TheMIBBrowserusesJDBC(JavaDatabaseConnectivity)forthedatabasesupport.Applications shoulduseavalidJDBCdriveroftherespectivedatabasestoenablethedatabasesupport.
121
Issue 3 August 2012
SelectingtheoptionLoadMIBsfromDatabaseenablesthetextfieldsintheJDBCParamssection.On initializingthenecessarydatabaseparametersinthissection,thedatabasesupportcanbeprovided forloadingMIBs.TherequiredJDBCParamsare: Drivernamenameofthedatabasedriver. URLURLpointingtothedatabasefilename. UserNamenameoftheuser. Passwordpasswordfortheuser.
Afterselectingthisloadingoption,selecttherequiredMIBfiletobeloadedfromtheOpentabofthe LoadaMIBFiledialogbox.IftheselectedMIBfileisalreadypresentinthedatabase,theMIBfileis read,parsed,andloadedfromthedatabase.IftheMIBfiledoesnotexistinthedatabase,theMIB BrowserwillparsetheMIBfile,writetheoutputtothedatabase,andthenloadtheMIBfile.

note ............. The recently loaded MIBs can be loaded automatically at startup by selecting the option Load recently loaded Mibs at startup.
TheloadingofMIBfilesfromtheOracledatabasehasbeentested.Thefollowingdatabase parametersaretobeconfiguredintheapplication. drivernameorg.jdbc.driver.OracleDriver urljdbc:oracle:thin:@<machinename>:1521:<databasename> usernameavalidusername passwordpasswordfortheuser
TheOracledriverhastobeincludedintheCLASSPATH.IfthejarisnotpresentintheCLASSPATH,the followingexceptionisthrown:
Java.lang.ClassNotFoundException:oracle.jdbc.driver.OracleDriver
Forotherdatabases,usetheequivalentparameters. AfewMIBfilesareprovidedinthemibsdirectory,i.e.,RFC1213MIB,RFC1271RMON,RFC1155SMI, RMON2MIB,TOKENRINGRMONMIB,andRFC1315FRAME.ItmaybeconvenienttocopyyourMIB modulefilesthataretobeloadedintothe"mibs"directory. MIBsarealwaysparsedbeforeloadingwhenthefollowingoperationsareperformed: LoadingMIBsdirectly LoadingMIBfromCompiledFileforthefirsttime Selectingthe"OverwriteexistingcompiledMIBfiles"option LoadingMIBfromdatabaseforthefirsttime
16.2.6
Unloading MIBs
ThenextbasicMIBoperationisunloading.TounloadtheMIB,selectthenodeoftheMIBtreeand clicktheUnloadMIBModulebutton orselectFile>UnLoadMIBfromthemenu.Alternatively, youcanpresstheDeletekey. Performinganyoftheabovepromptsyouforaconfirmation.Selecting'Yes'unloadstheMIBmodule. IfnomoduleisselectedintheMIBtree,alltheloadedMIBmodulesareunloaded.
122
Issue 3 August 2012
TheLoadAllMIBsoptioninthemenubarwouldloadallthepreviouslyloadedMIBsandUnloadAll MIBswouldunloadalltheloadedMIBsintheMIBtree.
16.2.7
Performing SNMP Operations

MIBBrowserallowstheusertoperformthetypicalSNMPoperations.Theoperationsarecategorized as: RetrievingDataGET,GETNEXT,GETBULK AlteringVariablesSET ReceivingUnsolicitedMessagesTraps
Toperformanybasicoperationascategorizedabove,itisessentialtospecifytheObjectID,the instance,hostname,andthecommunitystring.Changescanalsobemadetotheparametersinthe MIBBrowserSettingsdialogbox
Specifying the Index

TospecifyanobjecttoanSNMPagent,boththeObjectID(whichdefinesthetypeofobject)andthe instance(thespecificobjectofthegiventype)needtobeprovided.FromtheMIByoucangetthe ObjectID,towhichaninstanceneedstobeaddedtocompletelyidentifytheobjectofinterest. Fornontabularorscalarobjects,theinstanceis0.Forexample,sysDescrisascalarobjectunderthe systemgroupintheRFC1213MIBanditshouldbespecifiedassysDescr.0intheObjectIDfieldofthe MIBBrowser.IntheMIBBrowser,thisdoesnotneedtobespecifiediftheMIBisloaded,i.e.,the RFC1213MIB.TheMIBBrowseraddsittotheselectednodewhileperformingtheGEToperation. Fortabularobjects,theinstanceisdefinedintheMIBasindex,anditisasequenceofoneormore objects.Forexample,ifInOctetsofifTabledefinedintheRFC1213MIB,theindexislabeledasifIndex (INTEGER)andmaybespecifiedasifInOctets.1providedthatthereexistsarowwithindex1inthe queryingagent. AnotherexampleistcpConnStateoftcpConnTableundertcpgroupofRFC1213MIB.Theindexesof thetcpConnTablearetcpConnLocalAddress(IpAddress),tcpConnLocalPort(INTEGER), tcpConnRemAddress(IpAddress),tcpConnRemPort(INTEGER)andmaybespecifiedas tcpConnState.179.74.15.126.1192.225.226.126.197.80providedthatthereexistsarowwithIndex 179.74.15.126.1192.225.226.126.197.80inthequeryingagentwhere: 179.74.15.126representsthevalueofthefirstindextcpConnLocalAddress(IpAddress), 1192representsthevalueofthesecondindextcpConnLocalPort(INTEGER), 225.226.126.197representsthevalueofthethirdindextcpConnRemAddress(IpAddress) 80representsthevalueofthefourthindextcpConnRemPort(INTEGER).
TogettheinformationabouttheMIBNodeintheMIBTree,clicktheDescriptionicon orchoose ViewDescriptionmenuitemoruseashortcutofAlt+R.Thisgivesalistofallthevital characteristicsofthenodesuchastheNode,OID,Path,MIBModule,Syntax,Status,etc.
123
Issue 3 August 2012
Executing SNMP GET

TheGEToperationisperformedtogetoneormorevaluesfromthemanagedobjects.Followthe stepstoperformthisoperation. 1. 2. 3. LoadtheMIBfile.TheloadingofMIBsandtheoptionsavailablehasbeendealtwithindetail intheLoadingandUnloadingMIBssection. SelectthedesirednodeintheMIBtree. Clickthe"GetSNMPVariable"icon onthetoolbarorselectOperationsGetfromthe menubar.Alternatively,youcanusetheshortcutkeycombinationCtrl+G.
ThisoperationgetsallobjectsundertheselectedMIBobject,orthespecificobjectiftheMIBnode andinstancearespecified.
note ............. If the selected node in the MIB tree has child nodes or columnar nodes, the GET operation is performed as an SNMP walk. The values for all the nodes under that sub-tree are retrieved. If the MIB is not loaded in the MIB Browser, then the exact numbered OID with full instance (for example 1.3.0 for sysUpTime) should be specified and the GET operation should be performed.
Performing a Multi-Varbind Request

ToperformtheMultiVarbindrequest,followthestepsgivenbelow: 1. MaketheMultiVarbinddisplayvisibleintheMIBBrowser.Thiscanbemadevisibleby selectingViewDisplayMultiVarbindfromthemenu.YoucanalsousetheGeneral SettingstabintheMIBBrowserSettingspanel. SelecttheleafnodeandappendtheinstancebyclickingtheAddbutton.ItwilladdtheOID givenintheObjectIdentifierfieldandthevaluegivenintheSetValuefieldbothseparated withacolontothelist.IfvalueisnotgivenintheSetValuefield,NULLvalueisappended. Similarly,youcanaddasmanynumberofOIDsandvaluesasrequired.
2.
note ............. Ensure you select the Multi-var check box before doing an SNMP operation for multiple varbind SNMP request. Otherwise, it does a request for the OID in the Object Identifier field.
3. 4.
Todeletethevarbind(s)fromthelist,selectthevarbind(s)fromthelistandclicktheDelete button. Toeditthevarbind,selectavarbindandclicktheEditbutton.ItshowsanOIDandthevalue ofthevarbindinthetextfieldstoedit.EdititandclicktheOKbuttontomodifytheOIDand valueorclicktheCancelbuttontorestoretheoldvalues.
note ............. When the request is sent under Multi-varbind mode, it goes as a single PDU irrespective of the number of OIDs added. If you want to communicate with a v3 agent, you have to select the v3 option in the MIB Browser Settings dialog box and also make sure that the v3 parameters are set. Then perform the above steps for each of the operations.
124
Issue 3 August 2012
Finding MIB Nodes

YoucanfindaspecificnodeintheMIBtreeusingtheFinddialogbox.Thisisinvokedbyselecting EditFindNodefromthemenu.UsetheFindinAlloptionintheFinddialogboxtofindanodeinall theloadedMIBmodules.
Executing SNMP GETNEXT

ThisoperationissimilartotheSNMPGEToperation,butretrievesthevalueofthenextOIDinthe tree.ThisoperationisusedfortraversingtheMIBtree.Toperformthisoperation,performSteps1 and2ofExecutingSNMPGETonPage124.Thenproceedwiththefollowingstep: ClicktheGetNextSNMPVariablebutton onthetoolbarorselectOperationsGetNextfrom themenubar.Alternatively,youcanusetheshortcutkeycombinationCtrl+N. Thisoperationwillgetthenextobjectafterthespecifiedobject,orthespecificobjectinstance,ifa MIBnodeisspecified.Theinstancemayormaynotbespecified.Youcanalsoperformamulti varbindGETNEXTrequest.
Executing SNMP GETBULK

Toretrievevoluminousdatafromalargetable,theGETBULKoperationisperformed.AGETBULK requestisperformedbygivinganOIDalongwithtwootherparameters,namelyaMaxRepetitions valueandaNonRepeatersvalue.TheGETBULKoperationisperformedonlyonSNMPv2cand SNMPv3. Toperformthisoperation,performSteps1and2asinExecutingSNMPGETonPage124andthen continuewiththefollowingsteps. 1. ConfiguretheMIBBrowsertoeitherSNMPv2corSNMPv3asdesired.Thiscanbedoneusing eithertheEditSettingsoptioninthemenubarortheMIBBrowserSettingsicon onthe toolbar.YoucanalsousetheshortcutkeycombinationAlt+S. UnderthesameMIBBrowserSettingspanel,theMaxRepetitionsfieldandthe NonRepeatersfieldareenabled.TheMaxRepetitionsvaluespecifiesthenumberof lexicographicsuccessorstobereturnedfortheremainingvariablesinthevariablebindings list.Thedefaultvalueinthisfieldis50.TheNonRepeatersvaluespecifiesthenumberof variablesinthevariablebindingslistforwhichasinglelexicographicsuccessoristobe returned.Thedefaultvalueinthisfieldis0.Specifythevaluesforthesetwoparametersif youneedtoandthenproceedwiththeoperation. ClicktheGetBulkSNMPdatabuttonoricon onthetoolbarorchoose OperationGetBulkfromthemenubar.Alternatively,youcanusetheshortcutkey combinationCtrl+B.
2.
3.
ThiswillgetasequenceofNextObjectsimmediatelyafterthespecifiedobject.ThenumberofObject instancesreturnedisequaltotheMaxRepetitionsfield.
125
Issue 3 August 2012
16.2.8
Setting SNMP Table Options

TheMIBBrowserenablesyoutoviewtheSNMPTabledatainaseparatewindowcalledtheSNMP TablePanel.Thetablehasaveryuserfriendlyprofile.TheSNMPTablepanelhasvariousoptions usingwhichyoucanaddanddeleterows,viewgraphs,anduseindexeditor.
Retrieving Table Data

Thedatainthetablecanberetrievedwithease.Thefollowingstepsgiveinsightintohowtoopenthe DataTablepanelandworkonitusingthevariousoptions. 1. 2. 3. 4. 5. SpecifytheproperagenthostnameorIPaddressintheHostfieldofMIBBrowser. LoadtheMIBfileinMIBBrowser. SpecifyavalidOIDorselecttheOIDbytraversingthroughtheMIBTree. TheOIDshouldbeavalidtableOID. ClicktheViewSNMPdatatablebutton onthetoolbarorchooseViewSnmpTable fromthemenu.YoucanalsousetheshortcutkeycombinationAlt+T. TheSNMPTableforthespecifiedOIDisdisplayed.
Figure 23: SNMP Table
6.
ClicktheStartbuttonatthebottomoftheSNMPTablepanel. Theretrievalofdatabeginsandthecolumnarobjectsareobtainedanddisplayedinthe table.
126
Issue 3 August 2012
7. 8. 9.
ClicktheStartPollingbuttontostartthepollingofthetable. ThepollingintervalisbasedonthePollingIntervalvaluesetusingtheSettingsoption. ClicktheStopPollingbuttontostopthepolling. Whenyoudonotusethepollingoption,clicktheRefreshbuttontorefreshthetable. TheSNMPTablepanelmightretrievemoredatasothattheframedepictingthecolumnar objectswouldruntopages.
10. Whenyouneedtonavigatethroughthepages(rows),usetheNextandPrevbutton. ThePageoptionatthebottomofthepanelisusedtospecifyhowthetableretrievalneeds tobedone.Iftheoptionisorigin,thetableisretrievedfromtheorigin.Iftheoptionisindex, theusercansetanindexvaluefromwhichthetablecanberetrieved.Thehostnameas specifiedinMIBBrowserwillbedisplayedintheHostfield.Thepagenumberandthe numberofrowsinthatpagearedisplayednexttoit.ItispossibletoconfiguretheSNMP Tablepanel. 11. ClicktheSettingsbutton. ThisdisplaysadialogboxwithvariousoptionstoconfiguretheTablepanel.Thefigurebelow depictstheSNMPTableSettingspanel.
Figure 24: SNMP Table Settings Panel
Thevariousoptionsavailablearelistedbelow: PollingIntervalThisspecifiesthetimeintervalbetweeneachretrievalofdata.The defaultvalueis5secs. PageSize(Rows)Thenumberofrowstoberetrievedissethere.Thedefaultvalueis 50. NoOfColumnViewThisspecifiesthenumberofcolumnstobedisplayedintheSNMP Tablepanel.Thedefaultis5.
127
Issue 3 August 2012
SplitColumnsWhenthesizeofthePDUexceedsthelimit,theagentsendstheerror message"TooBigPDUError".ThisfieldservesasanoptionforsplittingthePDU.By default,thePDUissplitintohalf.Ifthenumberofvarbindsissetbytheuser,then multiplerequestwithPDUcontainingnumberofvarbindssetissent. NoofColumns/RequestThisfieldisenabledonselectingtheSplitColumnscheckbox. Youcanspecifythenumberforsplittingofcolumns. PortThisfieldspecifiestheporttowhichtherequestismade. TableThetableOIDisspecifiedhere. MaxRepetitionsThisvaluespecifiesthenumberoflexicographicsuccessorstobe returnedfortheremainingvariablesinthevariablebindingslist.Thedefaultvalueis5. ThisisenabledonlywhentheRetrievalModeoptionissettoGetBulk. SnmpVersionThisgivestheoptiontoswitchtoanyofthethreeversionsofSNMPv1, v2c,andv3. GraphTypeThisgivestheoptiontoswitchbetweenLineGraphandBarGraph. RetrievalModeBydefault,GETNEXTisenabled.TheGETBULKoptionisenabledonly onselectingv2corv3.
12. Ifyouneedtoviewthegraph,clickthebutton. 13. Optionally,addrows. 14. Optionally,deleterows. Inatable,ifoneoftheindexcolumnsisanexternalindex(iftheindexvalueissharedby someothertable),thenthetableiscalledaugmented,andadependencyexistsbetween rowsoftwotables.ThissituationmightarisewhenaparticularMIBimportsanotherMIB andsharesasingletable.Forexample,ifXTabledefinedinIFMIBisanaugmentedtable, whichhasanexternalindexifIndexaugmentedfromifTable. 15. Toseethecolumnsofthetablethataugmentstheindexfromtheoriginaltable,clickthe AugmentedTablebutton. 16. ClicktheIndexEditorbuttontoedittheindexandviewtherowsfromcorrespondingindex. 17. Tomakechangestoaparticularcolumn'svalues,rightclickthecolumn. Thevariousoptionsavailableare: viewcolumnnodedetailsThisoptiongivestheMIBNodeInformationoftheselected column. edittheheadernameforselectedcolumnThisinvokesadialogboxinwhichyoucan changetheheaderfortheselectedcolumn. viewgraphforselectedcell(s)Thisoptioninvokesthegraph.Itispossibletoviewthe graphicalrepresentationformorethanonecellbymultipleselectionofdesiredcells. addanewrowtothetableThisoptionisthesameastheAddoptionavailableinthe Tablepanel. deletetheselectedrowsfromThisoptionisthesameastheDeleteoptionavailablein theTablepanel. viewthenotaccessibleindexArequestcannotbesenttoanindexthatisnot accessible.Inthetable,thenotaccessibleindexisnotvisible.Selectingthisoption wouldenableyoutoviewthenotaccessibleindexvalues.
128
Issue 3 August 2012
16.3 Interpreting MIB Browser Error Messages

ThefollowingtablelistsMIBBrowserrelatedErrorMessagesandthedifferentscenariosatwhich theywillbedisplayed.
Table 9: MibBrowser Error Messages

Error Message NoObjectIDSpecified. NoHostSpecified. HostNameShouldBeEntered. When it is displayed OIDisnotspecifiedbeforemakingarequest. HostNameisnotspecifiedbeforemakingaquery. SnmpTableisstartedwithoutspecifyingthehost name. ThespecifiedOIDisnotavalidone.Beforemaking anyquery,InvalidOIDFormatexceptionisthrown. InvalidOIDFormat ItshouldbeeitherIntegertypeorStringtype. ItwillbethrownduringinstantiatingLine/BarGraph, SnmpTable,andoperations,suchasGET,GETNEXT, GETBULK,SET,etc. InvalidTableOID TableOIDshouldbespecified ErrorLoadingMIB:xyz java.io.FileNotFoundException: CouldnotOpenstreamfor home/../AdventNet/SNMPv3/mibs/xyz.parser SnmpTableisstartedafterspecifyinganinvalidOID intheOIDTextfield. SnmptablestartedwithoutspecifyinganyTableOID InvalidfileisloadedintheLoadMibDialogTextField forloadingMIBsFile. ButinthedescriptionTextFieldofMIBBrowser,the messagethrownis"LoadingMibs:xyz" Theerrormessageisthrownwhendoingthe operationssuchasGET,GETNEXT,andSETandfor creatingSnmpTable,LineGraphorBarGraph window. IftheagentdoesnotimplementtheOIDthatis queried. RequestFailed:Error:RequestTimedOutToLocalHost Iftheagentqueriedisnotpresentinthenetwork. Iftheportnumbersetisnotvalidfortheagent queried. IftheCommunityandWriteCommunityspecified arenotcorrect. IftheOIDquerieddoesnotcontainanydata. Ifforv3agentssecurityparametersarenotset.
129
Issue 3 August 2012 Error Message
When it is displayed Theerrormessageisthrownwhendoingset operation If,theOIDisnotinstrumentedbytheagentfor whichitissettingvalue.
RequestFailed:GetResponsePDUreceivedfrom 192.168.1.001 ErrorIndicationInResponse:Thereisnosuchvariable nameinthismib. ErrIndex:
Iftheagentqueriedisnotpresentinthenetwork. IftheWriteCommunityspecifiedisnotrightone. IftheSyntaxofthevalueyouaresettingisnotas thatrequiredbytheOID. ThesameExceptionisalsothrownwhenplottinga GraphforaleafNodeisnotperformedbytheagent forwhomitissettingavalue. AndalsowhenqueryingfordatainanSnmpTable Ifdataisnotavailable.
RequestFailed:GetResponsePDUreceivedfrom 192.168.1.001 ErrorIndicationInResponse:Anotwritableerror occurred. ErrIndex:1 ErrorSendingSetRequest: TheErrorMessageisthrownduringsetoperation,if com.adventnet.snmp.beans.DataException:Error:OIDnot theOIDselectedisnotaleafnode. aleafnode. Errorsendingsetrequest:com.adventnet.snmp.beans: DataException:Error:CreatingVariable Ifsettingvalueforacolumnnodeofatabledoesnot haverowstatus. TheexceptionisthrownwhenplottingGraphfora leafNode, IfvalueofOIDselectedisnotofInteger/TimeTicks/ type. WhileplottingLine/BarGraph, iftheselectedOID/LeafNodehassyntax PhysAddress,NetworkAddress,IPAddress,OBJECT IDENTIFIER. SnmpTableisstartedwithOIDwhichisnotaTable OID. TheexceptionisthrownwhilecreatingSnmpTable, Ifthehostnamespecified,isofdifferentversion thanv3whichissetinsettingstable. IftheOID/LeafNodechosenforplottingGraphisof StringType. TheleafNodeorOIDforwhichyouaresettingvalue hasnoread/writeaccess.
LineGraphBeanError:cannotplotstringvalueRoot.....
LineGraphBeanError:cannotplotthesevalues .1.3..6.1.2.1..........................:value ................................................:value ................................................:value Error:com.adventnet.snmp.beans.DataException: InvalidTableOID:(oidchosen) ErrorSendingPDU:FailedtoAuthenticatetheSecurity Parameters,foruserSnmpEngineEntrynotfoundfor address(hostname)port(portNo.) LineGraphBeanError:cannotplotstringvaluexyz.
130
Issue 3 August 2012 When it is displayed IfwrongportnumberissetintheMIBSettings panel. Ifwrongusername/userpassword/privpassword/ TargetHost/SecurityLevelissetintheMIBSettings panel IfDriverName/URL/UserName/Passwordhasbeen setwrongwhenloadingMIBsfromdatabase
Error Message Discoveryfailedforaddress(hostname)port(portno.)
TimeSyncFailedforuser(username) ErrorinGettingDataBaseConnection:Pleasecheckthe jdbcparameters: com.adventnet.snmp.beans.MibException: java.lang.ClassNotFoundException: ErrorinGettingDataBaseConnection:Pleasecheckthe jdbcparameters:java.lang.ClassNotfoundException: (DriverNameset) PleaseentertheUserName SentrequesttohostName:portno. RequestFailed:SNMPv3ErrorinResponse. usmStatsUnknownUserNames(.1.3.6.1.2.1.1...)Counter value=2HostName EntertheFileNameofMIBModule ErrorLoadingMIB:(filename) javaioFileNotFoundException:Couldn'topenstreamfor filename.cmi ErrorLoadingMIB:(filenamewithfullpathfromhome dir).cds com.adventnet.snmp.mibs.MibException:The.cdsfile couldnotbeloaded. ErrorSendingPDU:FailedtoAuthenticatetheSecurity ParametersforuserauthUserUSMUserEntrynotfound forthisuser.TimeSynchronizationFailurecouldhave occurred. Errorin(get/getNext/getBulk)requesttohostName:port no.
Ifthemysql.jarclassisnotpresentintheclasses directory. IftheUsernameisnotsetforthev3User.
IfSecurityparametersaresetaftersettingthe versionv3forav1/v2agentandrequestismade.
WhileloadingtheMIBsfileifOKbuttonisclicked withoutselectinganyfilein"LoadMibDialog".
IfanyfilechosenfromoutsidetheMIBsdirectory.
Whena.cdsfileisloaded.
IfContextName/ContextEngineIDisnotsetbefore makingqueryforSnmpTable.(DatabaseMode)
IfContextName/ContextEngineIDisnotsetbefore FailedtoAuthenticatetheSecurityParametersforuser makingget/getNext/getBulkrequest authUserUSMUserEntrynotfoundforAddresshostname: 161
131
Issue 3 August 2012 Error Message
When it is displayed getRequestforav3User(Databasemode)
Erroringetrequestfrom<hostname>:161 UnabletoencodePDU.
AuthProtocol:MD5 ContextName,ContextEngineIDarenotspecified. Sameexceptionisthrownforgetnext,getbulkand setoperationalso.(forAuthProtocolMD5&SHA)
Erroringetrequestfrom<hostname>:161 Failedtoauthenticatethesecurityparametersforuser privuserauthKeylengthhastobe20. cannotplotthechosenvariable: iso.org.dod.internet.mgmt.mib2.interfaces.ifTable sentgetrequesttotonyjpaul:161
getRequestforav3User(Databasemode) AuthProtocol:SHA ContextName,ContextEngineIDarenotspecified. IfIfTableOIDischosenforplottingGraph. TheErrorwillbethrowniftheOIDchosenisnota leafOID. DuringgetRequestforav3user
RequestFailed:SNMPv3ErrorinResponse:usmStatsNot ContextName,ContextEngineIDnotspecified. InTimeWindows(.1.3.6.1.6.3.1.5.1.1.2.0)CounterValue SameErrorMessageisThrownforotheroperations =13tonyjpaul likegetNext,getBulk,set sentgetbulkrequesttolocalhost:161 RequestFailed:GetResponsePDUreceivedfrom 127.0.0.1. ErrorIndicationinresponse:ThisisaendofMIBView. ObjectID:.1.3.6.1.2.1.1.9.1.4.9 NULLOBJECT:NULL ErrorSendingsetRequest: com.adventnet.snmp.beans.DataException:Error:Mib nodeunavailableforOID. sentgetrequestto<hostname>:161 RequestFailed:GetResponsePDUreceivedfrom 192.168.1.182 ErrorIndicationinresponse:Thereisnosuchinstancein thisMIB. ObjectID:.1.3.6.1.2.1.1.9.1.4.9 NULLOBJECT:NULL GetOperationonsysServicesnodeforav3agent. ThisErroristhrowniftheleafnodesysServicesisnot implementedbytheagent. IfgetBulkOperationisdonefor"org".(setting versionv2/v3forav1host) iftheOID/LeafNodeselectedisthelastnodeofthe mib. ThesameExceptionwillbethrownforoperations likegetNext,getBulkalso. SettingvalueforanOIDwhichisnothavingany leafnode. Nowit'sthrownifwearechoosinganyOIDfrom "enterprises".
132
Issue 3 August 2012 When it is displayed DuringsetoperationonipRouteDestwhichhasread writeaccess&syntaxofdatatype:IPAddressforav3 user. AsvaluescannotbesetifthecolumnisnotofRow Statustype. Whendoingagetrequestforav2agentatOID "transmission"(.1.3.6.1.2.1.10) Exceptionisthrownwhennodataisavailablefor thatparticularinstanceofOID. Erroristhrownwhenconnectingtothedatabasefor anagentofanyversion,iftheDriverNamesetisnot correct.
Error Message sentgetrequestto<hostname>:161 RequestFailed:GetResponsePDUreceivedfrom 192.168.1.182 ErrorIndicationinresponse:Anocreationerror occurred. Errindex:1 sentgetrequestto<hostname>:161 Nodataavailableinthissubtree ErroringettingDatabaseConnection.Pleasecheckthe jdbcParameters: com.adventnet.snmp.mibs.MibException:java.sql.SQL Exception:NosuitableDriver. ErrorinGettingDataBaseConnection:Pleasecheckthe jdbcParameters:java.sql.SQLException:Nosuitable Driver.
ThiserroristhrownwhentheURLsetisnotavalid URLforconnectingtodatabase.(mysql>msql)
ErrorinGettingDataBaseConnection:Pleasecheckthe jdbcParameters:java.sql.SQLException:Cannotconnect toMYSQLseveronsmplinux:3306.Isthereamysqlserver ThiserroristhrownwhentheURLsetisnotavalid isrunninginthemachine/portyouaretryingtoconnect URLforconnectingtodatabase.(snmplinux >smplinux) to? (java.net.UnknownHostException) ErrorinGettingDataBaseConnection:Pleasecheckthe jdbcParameters:java.sql.SQLException:Generalerror: Unknowndatabase"<tst>" sentsetrequestto<hostname>:161 RequestFailed:SNMPv3ErrorinResponse: usmStatsNotInTimeWindows(.1.3.6.1.6.3.15.1.1.2.0)Coun tervalue=75<hostname> sentgetrequestto<hostname>:161 RequestFailed:GetResponsePDUreceivedfrom 192.168.1.182 ErrorIndicationinresponse:Thereisnosuchobjectin thisMIB. ObjectID:.1.3.6.1.2.1.8.1.0 NULLOBJECT:NULL ThisOIDisnotinstrumentedfortheagentyouare queryingforornodataisavailableinthisOID. Errorthrowniftherequestismadeafteracertain intervaloftime.. ThiserroristhrownwhentheURLsetisnotavalid URLforconnectingtodatabase.(test>tst)
133
Issue 3 August 2012
16.4 FAQs
How do I give Hex strings for SET values in MIB Browser?
TheSnmpStringclassacceptsHexstringsinacertainformat.Anystringthatstartsandendswitha singlequote(')isinterpretedasanHexstring.Theindividualbytesshouldbeseparatedusinga colon(:).Forexample,ifyouneedtoenter0x2a304cab,itshouldbesuppliedas'2a:30:4c:ab'.
How do I give Hex values in the ContextEngineID or in the ContextName text fields?
TheHexvaluesshouldstartwitha0xor0X.Therefore,ifyousetavalueforcontextIDor contextName,itshouldbe0xHHHHHH.
What are the units for timeout and retry values?

Boththetimeoutandretryvaluesshouldbegiveninseconds.Ifyougivethetimeoutvaluein milliseconds,ittakesmuchtimetogettimedout.Forexample,avalueof1000waitsfor1000 seconds.
How do I set values for the table variables?

Tocreateanewrowinatable: 1. 2. 3. DefineacolumnwithSYNTAXRowStatus,andthedefinitionforthetableshouldhave RowStatusobjectdefined. SelecttheTablenodefromthetreeandtheTablebuttonfromthetoolbartodisplaythe correspondingtable. Rightclickonthetableheaderwherethenameofthecolumnisdisplayed. Itdisplaysamenuwiththefollowingoptions: 4. 5. 6. ViewGraphforSelectedRows AddaNewRowtotheTable DeletetheSelectedRowsfromtheTable
SelectAddaNewRowtotheTable. Itdisplaysawindowforenteringthevaluesofthetable. ThevalueforthecolumnwithRowStatussyntaxshouldbe4forcreatinganewrow. ClickOKafterenteringallthevalues.
IfRowStatusisnotpresentinthetabledefinition,youcanonlymodifytheexistingrowbydouble clickingthecorrespondingcellinthetable.
If I load the MIB Browser applet, I get the error "Error Sending PDUSecurity Exception connecting to remote host" in the browser. Why is this so?
AppletsarenotallowedtotalktoanyhostapartfromtheWebserverfromwhichtheywere downloaded.MakesurethatSASisalsorunningalongwiththeWebserver.
134
Issue 3 August 2012
I do not get the "NO HOST Specified" error. What should I do?
Beforemakinganyrequest,thehostnameortheIPaddressofthemachineinwhichtheagentis runningshouldbespecifiedinthe"Host"textfieldofMIBBrowser.
How can I load multiple MIB files in MIB Browser?

ToloadmultipleMIBs,filesshouldbeseparatedbyablankspaceandbegivenwithindoublequotes. Forexample:
java MibBrowserApplication -m "mibs/RFC1213-MIB mibs/RFC1271-MIB mibs/RFC1155-MIB" -h localhost -c public
IfyouuseMibBrowser.sh,editthefileaccordingly.
When I ask for 10 rows in an SNMP table, the GETBULK returns only 6 rows and the last attribute of the sixth row is null. The sixth row seems to be truncated. What should I do?
ThenumberofrowsyougetbackmaybelimitedbythePDUsizepermittedbyyouragent,manager, ortransport.
I use JDK 1.2. How do I invoke MIB Browser as an applet through applet viewer?
FromJDK1.1,theappletviewernolongertakestheCLASSPATHsettingintoconsideration.Therefore fortheapplets,thefollowingcommandistobegiven.
appletviewer -J-Xbootclasspath:.; ..\..\jars\AdventNetSnmp.jar;..\..\jars\AdventNetLogging.jar; ..\..\sasapps.jar; c:\jdk1.2\jre\lib\rt.jar
Toloadfromthebrowsers,theHTMLfileshouldalsobechangedaccordingly. Appletscouldinsteadbepackagedintojarfilesforeasyuse.Also,withJDK1.2,youcanspecify dependenciesonotherjarsthroughextensions.Therefore,ifyoucreateanappletthatuses AdventNetBeansandthetargetplatformistheJDK1.2plugin,youneedtoincludetheCLASSPATH.
135
Issue 3 August 2012
Legal Notices and License Agreements

CAMBIUM NETWORKS, LTD END USER LICENSE AGREEMENT
CAMBIUMNETWORKS,LTD(Cambium)iswillingtolicenseitsWirelessManagersoftwareandthe accompanyingdocumentation(collectively,theSoftware,asfurtherdefinedbelow)toyouonlyonthecondition thatyouacceptallthetermsinthisEndUserLicenseAgreement(thisAgreement). IMPORTANT:READTHEFOLLOWINGTERMSANDCONDITIONSBEFOREUSINGTHESOFTWAREANDANY EQUIPMENTAND/ORPRODUCTSTHATACCOMPANYTHESOFTWARE. BYCLICKINGONTHEACCEPTBUTTONDURINGINSTALLATION,YOUACKNOWLEDGETHATYOUHAVEREAD THISAGREEMENT,UNDERSTANDITANDAGREETOBEBOUNDBYTHETERMSOFTHISAGREEMENT. IFYOUDONOTAGREETOTHETERMSOFTHISAGREEMENT,CAMBIUMISNOTWILLINGTOLICENSETHE SOFTWARETOYOUANDYOUSHOULDCLICKONTHEDONOTACCEPTBUTTONTODISCONTINUETHE INSTALLATIONPROCESS.IFYOUDONOTAGREETOTHESETERMSANDCONDITIONS,YOUMAY,FORAFULL REFUND:(I)RETURNTHESOFTWARETOTHEENTITYFROMWHOMYOUPURCHASEDIT;OR,(II)FOR DOWNLOADEDSOFTWARE,PROVIDETOTHEENTITYFROMWHOMYOUPURCHASEDTHESOFTWAREYOUR WRITTENVERIFICATIONOFDELETIONOFALLCOPIESOFTHESOFTWARE. 1.Definitions.InthisAgreement,thewordSoftwarereferstothesetofinstructionsforcomputingdevices,in executableformandinanymedia(whichmayincludediskette(s),CDROM(s),downloadableInternetfile(s), hardware,firmware,etc.),andincludeswithoutlimitationinterfaces,content,fonts,images,photographs, animations,video,audio,musictext,appletsandincludeddata,aswellastheaccompanyingdocumentation, suchasmanualsandinstructionalaids,whetherinprintedorelectronicform,forthesoftwareproductidentified above. 2.General.TheSoftwareislicensed,andnotsold,toyoubyCambiumforuseonlyunderthetermsofthis Agreement.Cambiumand/orCambiumslicensor(s)retainallright,titleandinterestinandtotheSoftware,and thecopyrightsandotherintellectualpropertyrightsthereinandthereto,andreserveallrightsnotexpressly grantedtoyouinthisAgreement.ThetermsofthisAgreementwillgovernanyupdate(s)and/orupgrade(s)tothe SoftwareprovidedbyCambiumthatreplaceand/orsupplementtheoriginalSoftware,unlesssuchupdate(s) and/orupgrade(s)areaccompaniedbyaseparatelicenseinwhichcasethetermsofthatlicensewillgovern. 3.GrantofLicense.Cambiumgrantsyou(Licenseeoryou)alimited,personal,nonexclusiveandnon transferable(exceptasotherwiseprovidedherein)licensetousetheSoftwaresubjecttotheConditionsofUseset forthinSection4andtheremainingtermsandconditionsofthisAgreement.Anytermsorconditionsappearingon thefaceorreversesideofanypurchaseorder,purchaseorderacknowledgmentorotherorderdocumentthatare differentfrom,orinadditionto,thetermsofthisAgreementwillnotbebindingontheparties,evenifpaymentis accepted. 4.ConditionsofUse;RestrictionsonUse.TheSoftwareisprotectedbyinternationalintellectualpropertylawsand treaties,andotherapplicablelaws.AnyuseoftheSoftwareinviolationofthetermsandconditionssetforthin thisAgreementisstrictlyprohibitedandwillbedeemedabreachofthisAgreement.Inadditiontotheotherterms andconditionsofthisAgreement,youagreetothefollowingspecificconditionsandrestrictions: 4.1. YouwillusetheSoftwareincompliancewithallapplicablelaws,includinglocallawsofthecountryor regioninwhichyouresideorinwhichyouusetheSoftware. 4.2. Onlyyou,youremployeesoragentsmayusetheSoftware.Youwilltakeallnecessarystepstoinsure thatyouremployeesandagentsabidebythetermsofthisAgreement. 4.3. YouwillusetheSoftware:(i)onlyforyourinternalbusinesspurposes;(ii)onlyasdescribedinthe Software;and,(iii)instrictaccordancewiththisAgreement.
137
Issue 3 August 2012 4.4. 4.5.
YouwillinstallandusetheSoftwareonasinglecomputingdevice. TotheextenttheSoftwareincludesfeaturesinvolvingmaps,youwilltakeallreasonableeffortsnot exceed20,000mappageviewsperyear.Cambiumreservestherighttodisabletheusageoffeatures involvingmapsifyourannualusageofmappageviewsexceeds20,000mappageviews.4.6.Youwill not,andyouwillnotenableothersto,copy(exceptforbackuppurposesasexpresslypermittedby thisAgreement),decompile,bootleg,reverseengineer,disassemble,attempttoderivethesource codeof,decrypt,modify,translate,orcreatederivativeworksfromtheSoftware,oranypartthereof (exceptas,andonlytotheextent,anyforegoingrestrictionisprohibitedbyapplicablelaw).Any attempttodosoisaviolationoftherightsofCambiumand/oritslicensor(s)intheSoftware. YouwillnotattempttodefeatanycopyprotectiondeviceincludedwiththeSoftware.
4.7.
4.8. IftheSoftwareisprovidedonmultipletypesofmedia,youwilluseonlythemediathatbestmeets yourspecificneeds,andyouwillnotloan,rent,leaseortransfertheothermediacontainedinthe packagewithoutCambiumswrittenconsent. 4.9. Youwillnotremoveanyproprietarynotices,marks,labels,orlogosfromtheSoftware. 4.10 Unlessotherwiseprovidedherein,youwillnotrent,lease,sublicenseortransfertheSoftware,orany partthereof,toanyotherpartywithoutCambiumspriorwrittenconsent. 4.11. YouwillnotusetheSoftwareforanypurposesprohibitedbyapplicablelaw,includingwithout limitationthedevelopment,design,manufactureorproductionofnuclear,missiles,orchemicalor biologicalweapons. USEOFTHESOFTWAREINANYMANNEROTHERTHANASPROVIDEDHEREINISSTRICTLYPROHIBITED ANDMAYINFRINGEONTHEINTELLECTUALPROPERTYRIGHTSOFCAMBIUMAND/ORITSLICENSOR(S), SUBJECTINGYOUTOCIVILANDCRIMINALPENALTIES,INCLUDINGWITHOUTLIMITATIONMONETARY DAMAGESANDIMPRISONMENTFORCOPYRIGHTINFRINGEMENT.
5.BackUps.NotwithstandinganythingtothecontraryinthisAgreement,youmaymakeone(1)copyofthe Softwareinmachinereadableformforbackuppurposesonly.IfthedocumentationfortheSoftwareisinprinted form,itmaynotbecopied.WithregardtoallcopiesoftheSoftwarepermittedherein,youagreetoreproduceon suchcopiesallCambiumcopyrightnotices,andotherproprietarynoticesappearingonandintheoriginal Software. 6.Export.Youmaynotexport,reexportortransfer,directlyorindirectly,theSoftwareexceptasauthorizedby UnitedStateslaworbythelawsofthejurisdiction(s)inwhichtheSoftwarewasobtained.Bywayofexample,but withoutlimitationoftheforegoing,ifyourSoftwarewasobtainedintheUnitedStates,theSoftwaremaynotbe exported,reexportedortransferred:(a)intoanyU.S.embargoedcountries;or,(b)toanyoneontheU.S.Treasury Department'slistofSpeciallyDesignatedNationalsortheU.S.DepartmentofCommerceDeniedPersonsListor EntityList.ByusingtheSoftware,yourepresentandwarrantthatyouarenotlocatedinanysuchcountryoron anysuchlist. 7.Confidentiality.YouacknowledgethattheSoftwarecontainsvaluableproprietaryinformationandtradesecrets andthatunauthorizedorimproperuseoftheSoftwarewillresultinirreparableharmtoCambiumforwhich monetarydamageswouldbeinadequateandforwhichCambiumwillbeentitledtoimmediateinjunctiverelief. Accordingly,youwilllimitaccesstotheSoftwaretothoseofyouremployeesandagentswhoneedtousethe Softwareforyourinternalbusinesspurposes,andyouwilltakeappropriateactionwiththoseemployeesand agentstopreservetheconfidentialityoftheSoftware,usingthesamedegreeofcaretoavoidunauthorizedor improperdisclosureasyouusefortheprotectionofyourownproprietarysoftware,butinnoeventlessthan reasonablecare.Youhavenoobligationtopreservetheconfidentialityofanyinformationthat:(i)wasinthe publicdomainatthetimeofdisclosure;(ii)enteredthepublicdomainthroughnofaultofyours;(iii)wasgivento youfreeofanyobligationtokeepitconfidential;(iv)isindependentlydevelopedbyyou;or,(v)isdisclosedas requiredbylawprovidedthatyounotifyCambiumpriortosuchdisclosureandprovideCambiumwitha reasonableopportunitytorespond.
138
Issue 3 August 2012
8.RighttoUseCambiumsName.ExceptasrequiredinSection5above,youwillnot,duringthetermofthis Agreementorthereafter,useanytrademarkofCambium,oranywordand/orsymbollikelytobeconfusedwith anyCambiumtrademark,eitheraloneorinanycombinationwithotherwordsand/orsymbols. 9.Transfer.InthecaseofSoftwaredesignedtooperateonCambiumequipment,youmaynottransferthe Softwaretoanotherpartyexcept:(i)ifyouareanenduser,whenyouaretransferringtheSoftwaretogetherwith theCambiumequipmentonwhichitoperates;or,(ii)ifyouareaCambiumauthorizeddistributor,whenyouare transferringtheSoftwareeithertogetherwithsuchCambiumequipmentoraretransferringtheSoftwareasa licenseddulypaidforupgrade,update,patch,newrelease,enhancementorreplacementofapriorversionofthe Software.IfyouareaCambiumauthorizeddistributor,whenyouaretransferringtheSoftwareaspermittedinthis Agreement,youagreetotransfertheSoftwarewithalicenseagreementhavingtermsandconditionsnoless restrictivethanthosecontainedinthisAgreement.AlltransfersoftheSoftwareunderthisSection9arestrictly subjecttotheconditionsprecedentthat:(iii)theotherpartyagreestoacceptthetermsandconditionsofthis Agreement;and,(ii)youdestroyanycopyoftheSoftwareyoudonottransfertothatparty.Unlessotherwise providedherein,theSoftwaremaynotbetransferred,andthisAgreementmaynotbeassigned,byyouwithout Cambiumspriorwrittenconsent. 10.UpgradesandUpdates.IftheSoftwareislicensedtoyouasanupgradeorupdatetosoftwarepreviously licensedtoyou,youmustdestroythesoftwarepreviouslylicensedtoyou,includinganycopies,within30daysof yourreceiptoftheSoftware. 11.MaintenanceandSupport.CambiumisnotresponsibleformaintenanceorsupportoftheSoftware,orthe equipmentonwhichtheSoftwareresidesorisused,underthisAgreement.Byacceptingthelicensegrantedunder thisAgreement,youagreethatCambiumwillbeundernoobligationtoprovideanysupport,maintenanceor serviceinconnectionwiththeSoftwareorsuchequipment.MaintenanceandsupportoftheSoftwareand/orsuch equipmentbyCambiummaybeavailableunderthetermsofaseparateagreement. 12.LimitedWarranty.Allphysicalmedia,suchasdiskettesorCDROMS,onwhichtheSoftwareisfurnishedby Cambium(theMedia)arewarrantedtobefreefrommanufacturingandmaterialdefectsforninety(90)days aftertheshipmentdateoftheMediatoyou.Mediathatbecomesdefectiveduringsuchperiodwillberepairedor, atCambiumsoption,replaced.ThislimitedwarrantyiscontingentuponproperuseoftheMediaanddoesnot coverMediathathasbeentamperedwith,modifiedorsubjectedtounusualphysicalorelectricalstress. TamperingwithorremovinganyfactorysealorlabelonanyMediavoidsthiswarrantyandreleasesCambium fromanyandallliability.TheentireliabilityofCambium,andyourexclusiveremedyunderthewarrantyprovided inthisSection12willbe,atCambiumsoption,torepairorreplaceanyMediafoundtobedefectivewithinthe warrantyperiod,ortorefundthepurchasepriceandterminatethisAgreement.Toseeksucharemedy,youmust returntheSoftwaretoCambium,withacopyoftheoriginalpurchasereceipt,withinthewarrantyperiod. 13.Disclaimer.EXCEPTFORTHEABOVEEXPRESSLIMITEDWARRANTYFORTHEMEDIA,ANDTOTHEMAXIMUM EXTENTPERMITTEDBYAPPLICABLELAW,THESOFTWAREISPROVIDED"ASIS"ANDASAVAILABLE,WITHOUT WARRANTYOFANYKIND,ANDCAMBIUMONBEHALFOFITSELFANDITSLICENSOR(S)HEREBYDISCLAIMSALL WARRANTIESANDCONDITIONSWITHRESPECTTOTHESOFTWARE,EXPRESS,IMPLIEDORSTATUTORY,INCLUDING WITHOUTLIMITATIONTHEIMPLIEDWARRANTIESAND/ORCONDITIONSOFMERCHANTABILITY,OFSATISFACTORY QUALITY,OFFITNESSFORAPARTICULARPURPOSE,OFACCURACY,OFQUIETENJOYMENT,ANDOFNON INFRINGEMENTOFTHIRDPARTYRIGHTS.CAMBIUMALSODOESNOTWARRANTTHATTHEFUNCTIONS CONTAINEDIN,PERFORMEDAND/ORPROVIDEDBYTHESOFTWAREWILLMEETYOURREQUIREMENTS,THATTHE OPERATIONOFTHESOFTWAREWILLBEUNINTERRUPTEDORERRORFREE,THATTHESOFTWAREWILLBE COMPATIBLEORWORKWITHANYTHIRDPARTYSOFTWARE,APPLICATIONSORDEVICES,ORTHATDEFECTSINTHE SOFTWAREWILLBECORRECTED.CAMBIUMMAKESNOWARRANTYWITHRESPECTTOTHECORRECTNESS, ACCURACY,ORRELIABILITYOFTHESOFTWARE,ANDYOUEXPRESSLYACKNOWLEDGEANDAGREETHAT,TOTHE EXTENTPERMITTEDBYAPPLICABLELAW,YOURUSEOFTHESOFTWAREISATYOURSOLERISKANDTHATTHE ENTIRERISKASTOSATISFACTORYQUALITY,PERFORMANCE,ACCURACYANDEFFORTISWITHYOU.YOUFURTHER ACKNOWLEDGEANDAGREETHATTHESOFTWAREISNOTINTENDEDORSUITABLEFORUSEINSITUATIONSOR ENVIRONMENTSWHERETHEFAILUREORTIMEDELAYSOF,ORERRORSORINACCURACIESINTHECONTENT,DATA ORINFORMATIONPROVIDEDBYTHESOFTWARECOULDLEADTODEATH,PERSONALINJURY,ORSEVEREPHYSICAL
139
Issue 3 August 2012
ORENVIRONMENTALDAMAGE.NOORALORWRITTENINFORMATIONORADVICEGIVENBYCAMBIUMORAN AUTHORIZEDCAMBIUMREPRESENTATIVESHALLCREATEAWARRANTY. SOMEJURISDICTIONSDONOTALLOWTHEEXCLUSIONOFIMPLIEDWARRANTIESORLIMITATIONSONAPPLICABLE STATUTORYRIGHTSOFACONSUMER,SOTHEABOVEEXCLUSIONANDLIMITATIONSMAYNOTAPPLYTOYOU. 14.LimitationofLiability.THETOTALLIABILITYOFCAMBIUMFORANYDAMAGESUNDERTHISAGREEMENTWILL NOTEXCEEDTHETOTALAMOUNTPAIDBYYOUFORTHESOFTWARELICENSEDUNDERTHISAGREEMENT.TOTHE EXTENTNOTPROHIBITEDBYAPPLICABLELAW,INNOEVENTSHALLCAMBIUMBELIABLEFORPERSONALINJURY, ORANYINCIDENTAL,SPECIAL,INDIRECTORCONSEQUENTIALDAMAGESWHATSOEVER,INCLUDINGWITHOUT LIMITATIONDAMAGESFORLOSSOFPROFITS,LOSSOFDATA,BUSINESSINTERRUPTIONORANYOTHER COMMERCIALDAMAGESORLOSSES,ARISINGOUTOFORRELATEDTOYOURUSEORINABILITYTOUSETHE SOFTWARE,ORANYTHIRDPARTYSOFTWARE,APPLICATIONSAND/ORDEVICESINCONJUNCTIONWITHTHE SOFTWARE,HOWEVERCAUSED,REGARDLESSOFTHETHEORYOFLIABILITY(CONTRACT,TORTOROTHERWISE) ANDEVENIFCAMBIUMHASBEENADVISEDOFTHEPOSSIBILITYOFSUCHDAMAGES.SOMEJURISDICTIONSDO NOTALLOWTHELIMITATIONOFLIABILITYFORPERSONALINJURY,OROFINCIDENTALORCONSEQUENTIAL DAMAGES,SOTHISLIMITATIONMAYNOTAPPLYTOYOU. 15.U.S.GovernmentEndUsers.TheSoftwareisaCommercialItem,asthattermisdefinedat48C.F.R.2.101, consistingofCommercialComputerSoftwareandCommercialComputerSoftwareDocumentation,assuch termsareusedin48C.F.R.12.212or48C.F.R.227.7202,asapplicable.Consistentwith48C.F.R.12.212or48 C.F.R.227.72021through227.72024,asapplicable,theCommercialComputerSoftwareandCommercial ComputerSoftwareDocumentationarebeinglicensedtoU.S.Governmentendusers:(i)onlyasCommercial Items;and,(ii)withonlythoserightsasaregrantedtoallotherenduserspursuanttothetermsandconditions herein,notwithstandinganyotherFARorothercontractualclausetothecontraryinanyagreementintowhichthis AgreementmaybeincorporatedorwhichCambiummayprovidetoGovernmentenduser.UseoftheSoftware constitutesagreementbytheU.S.GovernmentthattheSoftwareisCommercialComputerSoftwareand CommercialComputerSoftwareDocumentation,andconstitutesacceptanceoftherightsandrestrictionsherein. UnpublishedrightsAREreservedunderthecopyrightlawsoftheUnitedStates.Thenameandaddressofthe contractorforUnitedStatesGovernmentendusersis:CambiumNetworks,Ltd,acompanyregisteredinEngland andWalesundercompanynumber07752773,withanaddressat1299E.AlgonquinRoad,Schaumburg,IL60196. 16.TermandTermination.ThisAgreement,andyourrighttousetheSoftware,willbeginwhenyouclickthe ACCEPTbutton,whichconstitutesacceptanceofthetermsandconditionsinthisAgreement,andwillcontinuein perpetuityunlessterminatedasfollows.ThisAgreementwillterminateimmediatelyandautomaticallywithout noticeuponabreachofthisAgreementbyyou.Youmayalsoterminatethisagreementbyceasinguseofthe Software.UpontheterminationofthisAgreementforanyreason,youmustceasealluseoftheSoftwareand destroyallcopiesoftheSoftwareinyourpossessionorcontrol. 17.GoverningLawandSeverability.ThisAgreementisgovernedbythelawsoftheUnitedStatesofAmerica,to theextentthattheyapply,andotherwisebythelawsoftheStateofIllinois,excludingitsconflictsoflaws principles.ThisAgreementshallnotbegovernedbytheUnitedNationsConventiononContractsforthe InternationalSaleofGoods,theapplicationofwhichisexpresslyexcluded.Ifforanyreasonacourtofcompetent jurisdictionfindsanyprovisionofthisAgreement,orportionthereof,tobeunenforceable,theremainderofthis Agreementshallcontinueinfullforceandeffect. 18.Survival.Thepartiesagreethatwherethecontextofanyprovisionindicatesanintentthatitsurvivestheterm ofthisAgreement,thenitwillsurvive. 19.EntireAgreement.ThisAgreementconstitutestheentireagreementbetweenyouandCambiumrelatingto theSoftwarelicensedhereunderandsupersedesallpriororcontemporaneousunderstandingsregardingsuch subjectmatter.NoamendmenttoormodificationofthisAgreementwillbebindingunlessinwritingandsignedby Cambium,exceptthatCambiummaymodifyand/ortranslatethisAgreementasnecessarytocomplywith applicablelaws.IntheeventofadisputebetweentheEnglishversionandanynonEnglishversions,theEnglish versionofthisAgreementshallgovern,totheextentnotprohibitedbythelocallawinyourjurisdiction. 20.ThirdPartySoftware.TheSoftwaremaycontainoneormoreitemsofthirdpartysoftwaresuppliedbythird partysuppliers(collectively,ThirdPartySoftware).ThetermsofthisAgreementgovernyouruseofanyThird
140
Issue 3 August 2012
PartySoftwareUNLESSASEPARATETHIRDPARTYSOFTWARELICENSEISINCLUDED,INWHICHCASEYOURUSEOF THETHIRDPARTYSOFTWAREWILLTHENBEGOVERNEDBYTHESEPARATETHIRDPARTYLICENSE.Useofthe GoogleMapsserviceissubjecttothefollowingadditionalterms:GoogleMapsTermsofServiceavailableat http://maps.google.com/help/terms_maps.htmlandGoogleMapsLegalNoticesat http://maps.google.com/help/legalnotices_maps.html.ByusingtheSoftwareyouareagreeingbeboundbythe termsofuseforallThirdPartySoftware.IftheSoftwarelicensedunderthisAgreementcontainspubliclyavailable (opensource)ThirdPartySoftware,thetermsandconditionsgoverningtheuseofsuchpubliclyavailableThird PartySoftwareareinthesoftwarelicensesofthecopyrightowner(s)ofsuchsoftwareandnotthisAgreement.If thereisaconflictbetweenthetermsandconditionsofthisAgreementandthetermsandconditionsofthe publiclyavailableThirdPartySoftwarelicense(s)governingyouruseofthepubliclyavailableThirdPartySoftware, thetermsandconditionsofthelicenseoftheapplicablepubliclyavailableThirdPartySoftwarelicense(s)willtake precedenceoverthelicensegrantedinthisAgreement.ThelicenseagreementsforpubliclyavailableThirdParty SoftwareincludedbyCambiumareavailableinthefileCambiumPubliclyAvailableSoftwareLegalNotices.htm installedintheserverfilesystemduringinstallationoftheSoftware.Thesoftwarelicenseagreementsforpublicly availableThirdPartySoftwareincludedbythirdpartiesareavailableinthefileThirdPartyPubliclyAvailable SoftwareLegalNotices.htminstalledintheserverfilesystemduringinstallationoftheSoftware. 21.Privacy.YouruseoftheSoftwareissubjecttoCambiumsPrivacyPolicyavailableat: http://cambiumnetworks.com/legal/terms_of_use.phpaswellastheGoogleMapsprivacypolicydescribedat http://www.google.com/privacy.html,thetermsofwhichareincorporatedhereinbyreference. IFTHEFOREGOINGTERMSANDCONDITIONSAREACCEPTABLETOYOU,PLEASEINDICATEYOURAGREEMENT ANDACCEPTANCEBYCLICKINGONTHEBUTTONLABELEDACCEPT.IFTHEFOREGOINGTERMSAND CONDITIONSARENOTACCEPTABLETOYOU,PLEASECLICKONTHEDONOTACCEPTBUTTON. WIRELESSMANAGER,CAMBIUM,CAMBIUMNETWORKS,andtheCambiumNetworksLogoaretrademarksof CambiumNetworks,Ltd. Copyright2012CambiumNetworks,LtdAllrightsreserved.
141
Issue 3 August 2012
CAMBIUM PUBLICLY AVAILABLE SOFTWARE LEGAL NOTICES AND END USER LICENSE AGREEMENTS FOR PUBLICLY AVAILABLE SOFTWARE
TheWirelessManagersoftwaremayincludeCambiumsoftware,commercialthirdpartysoftware,and/or publiclyavailable(opensource)software. TheCambiumsoftwareincludedintheWirelessManagersoftwareiscopyright(c)byCambiumNetworks,LTD (Cambium),anditsuseissubjecttothelicenses,termsandconditionsoftheagreementinforcebetweenthe purchaseroftheWirelessManagersoftwareandCambium.Thecommercialthirdpartysoftwarethatmaybe includedinorwiththeWirelessManagersoftwareissubjecttothelicenses,termsandconditionsofthe agreementinforcebetweenyouandCambium,unlessaseparatecommercialthirdpartysoftwarelicenseis included,inwhichcase,youruseofthecommercialthirdpartysoftwarewillthenbegovernedbytheseparate commercialthirdpartylicense.ThepubliclyavailablesoftwarethatmaybeincludedinorwiththeWireless Managersoftwareislistedbelow.Theuseofthelistedpubliclyavailablesoftwareissubjecttothelicenses, termsandconditionsoftheagreementinforcebetweenyouandCambium,aswellasthetermsandconditionsof thelicenseofeachpubliclyavailablesoftwarepackage.Copiesofthelicensesforthelistedpubliclyavailable software,aswellas,allattributions,acknowledgements,andsoftwareinformationdetails,areincludedbelow. Cambiumisrequiredtoreproducethesoftwarelicenses,acknowledgmentsandcopyrightnoticesasprovidedby theauthorsandowners,thus,allsuchinformationisprovidedinitsnativelanguageform,withoutmodificationor translation. ThepubliclyavailablesoftwareinthelistbelowincludesthepubliclyavailablesoftwareincludedbyCambium.The publiclyavailablesoftwareincludedbycommercialthirdpartysoftwarethatisusedintheWirelessManager softwareisdisclosedintheThirdPartyPubliclyAvailableSoftwareLegalNoticesaccompanyingtheWireless Managersoftware. ForinstructionsonhowtoobtainacopyofanysourcecodebeingmadepubliclyavailablebyCambiumrelatedto softwareusedintheWirelessManagersoftwareyoumaysendyourrequestinwritingto: CambiumNetworks,LTD Attention:OpenSourceSoftwareManager 1299E.AlgonquinRoad Schaumburg,IL60196 Inyourrequest,pleaseincludetheversionoftheWirelessManagersoftware,alongwiththepubliclyavailable softwarespecifics,suchasthepubliclyavailablesoftwarenameandversion. Note:thesourcecodeforthepubliclyavailablesoftwaremayberesidentontheCambiumproductinstallation media,oronsupplementalCambiumproductmediaand/orCambiumwebsites.Pleasereferenceandreviewthese entireCambiumPubliclyAvailableSoftwareLegalNoticesandEndUserLicenseAgreementsforPubliclyAvailable Softwareforthedetailsonlocationandmethodsofobtainingthesourcecode. Note:dependentonthelicensetermsofthepubliclyavailablesoftware,sourcecodemaynotbeprovided.Please referenceandreviewtheseentireCambiumPubliclyAvailableSoftwareLegalNoticesandEndUserLicense AgreementsforPubliclyAvailableSoftwareforthedetailsonlocationandmethodsofobtainingthesourcecode. Toviewadditionalinformationregardinglicenses,acknowledgmentsandrequiredcopyrightnoticesforpublicly availablesoftwareusedintheWirelessManagersoftware,pleaseselectLegalNoticesdisplayfromtheGUI(if applicable),orreviewthelegalnoticesandenduserlicenseagreementsintheREADMEfilesorotherfilescreated duringinstallation,inthedocumentation,ontheinstallationmedia,orresidentintheWirelessManager software. WIRELESSMANAGER,CAMBIUM,CAMBIUMNETWORKS,andtheCambiumNetworksLogoaretrademarksof CambiumNetworks,LTD.Allothertrademarks,logos,andservicemarksarethepropertyoftherespectivethird partyowners.YouarenotpermittedtouseanymarkswithoutthepriorwrittenconsentofCambiumorsuchthird partywhichmayownthemarks.
142

Software Included by Cambium
Issue 3 August 2012
ThefollowingaretheenduserlicenseagreementsforpubliclyavailablesoftwarethatCambiumhasincluded. AntContrib Version:1.0b3 Description:TheAntContribprojectisacollectionoftasks(andatonepointmaybetypesandothertools)for ApacheAnt.Usedtofacilitateautomationofbuildscripts. Softwaresite:http://sourceforge.net/projects/antcontrib SourceCode:ThesourcepackagesforAntContrib1.0b3areavailablefromtheoriginalsoftwaresite,ormaybe acquiredfromCambium.ToobtainthesoftwarefromCambium,pleasecontactCambiumusingthemethods describedinthepreambleofthisdocument. License:TheApacheSoftwareLicense,Version1.1 Copyright(c)20012003AntContribproject.Allrightsreserved. Redistributionanduseinsourceandbinaryforms,withorwithoutmodification,arepermittedprovidedthatthe followingconditionsaremet: 1.Redistributionsofsourcecodemustretaintheabovecopyrightnotice,thislistofconditionsandthefollowing disclaimer. 2.Redistributionsinbinaryformmustreproducetheabovecopyrightnotice,thislistofconditionsandthe followingdisclaimerinthedocumentationand/orothermaterialsprovidedwiththedistribution. 3.Theenduserdocumentationincludedwiththeredistribution,ifany,mustincludethefollowing acknowledgment: "ThisproductincludessoftwaredevelopedbytheAntContribproject (http://sourceforge.net/projects/antcontrib)." Alternately,thisacknowledgmentmayappearinthesoftwareitself,ifandwhereversuchthirdparty acknowledgmentsnormallyappear. 4.ThenameAntContribmustnotbeusedtoendorseorpromoteproductsderivedfromthissoftwarewithout priorwrittenpermission.Forwrittenpermission,pleasecontactantcontribdevelopers@lists.sourceforge.net. 5.Productsderivedfromthissoftwaremaynotbecalled"AntContrib"normay"AntContrib"appearintheir nameswithoutpriorwrittenpermissionoftheAntContribproject. THISSOFTWAREISPROVIDED`ÀSIS''ANDANYEXPRESSEDORIMPLIEDWARRANTIES,INCLUDING,BUTNOT LIMITEDTO,THEIMPLIEDWARRANTIESOFMERCHANTABILITYANDFITNESSFORAPARTICULARPURPOSEARE DISCLAIMED.INNOEVENTSHALLTHEANTCONTRIBPROJECTORITSCONTRIBUTORSBELIABLEFORANYDIRECT, INDIRECT,INCIDENTAL,SPECIAL,EXEMPLARY,ORCONSEQUENTIALDAMAGES(INCLUDING,BUTNOTLIMITEDTO, PROCUREMENTOFSUBSTITUTEGOODSORSERVICES;LOSSOFUSE,DATA,ORPROFITS;ORBUSINESS INTERRUPTION)HOWEVERCAUSEDANDONANYTHEORYOFLIABILITY,WHETHERINCONTRACT,STRICTLIABILITY, ORTORT(INCLUDINGNEGLIGENCEOROTHERWISE)ARISINGINANYWAYOUTOFTHEUSEOFTHISSOFTWARE, EVENIFADVISEDOFTHEPOSSIBILITYOFSUCHDAMAGE. GeoAPI Version:2.1 Description:JavalibraryforGeospatialdatamanipulation Softwaresite:http://geoapi.sourceforge.net/ SourceCode:ThesourcepackagesforGeoAPIareavailablefromtheoriginalsoftwaresite,ormaybeacquired fromCambium.ToobtainthesoftwarefromCambium,pleasecontactCambiumusingthemethodsdescribedin thepreambleofthisdocument. License:OGC(OpenGeospatialConsortium)
143
Issue 3 August 2012
ThisOGCwork(includingsoftware,documents,orotherrelateditems)isbeingprovidedbythecopyrightholders underthefollowinglicense.Byobtaining,using,and/orcopyingthiswork,you(thelicensee)agreethatyouhave read,understood,andwillcomplywiththefollowingtermsandconditions:Permissiontouse,copy,andmodify thissoftwareanditsdocumentation,withorwithoutmodification,foranypurposeandwithoutfeeorroyaltyis herebygranted,providedthatyouincludethefollowingonALLcopiesofthesoftwareanddocumentationor portionsthereof,includingmodifications,thatyoumake: 1.ThefulltextofthisNOTICEinalocationviewabletousersoftheredistributedorderivativework. 2.Anypreexistingintellectualpropertydisclaimers,notices,ortermsandconditions.Ifnoneexist,ashortnotice ofthefollowingform(hypertextispreferred,textispermitted)shouldbeusedwithinthebodyofany redistributedorderivativecode:"Copyright[$dateofdocument]OpenGeospatialConsortium,Inc.AllRights Reserved.http://www.opengeospatial.org/Legal/(Hypertextispreferred,butatextualrepresentationis permitted.) 3.NoticeofanychangesormodificationstotheOGCfiles,includingthedatechangesweremade.(We recommendyouprovideURLstothelocationfromwhichthecodeisderived.) THISSOFTWAREANDDOCUMENTATIONISPROVIDED"ASIS,"ANDCOPYRIGHTHOLDERSMAKENO REPRESENTATIONSORWARRANTIES,EXPRESSORIMPLIED,INCLUDINGBUTNOTLIMITEDTO,WARRANTIESOF MERCHANTABILITYORFITNESSFORANYPARTICULARPURPOSEORTHATTHEUSEOFTHESOFTWAREOR DOCUMENTATIONWILLNOTINFRINGEANYTHIRDPARTYPATENTS,COPYRIGHTS,TRADEMARKSOROTHER RIGHTS.COPYRIGHTHOLDERSWILLNOTBELIABLEFORANYDIRECT,INDIRECT,SPECIALORCONSEQUENTIAL DAMAGESARISINGOUTOFANYUSEOFTHESOFTWAREORDOCUMENTATION. ThenameandtrademarksofcopyrightholdersmayNOTbeusedinadvertisingorpublicitypertainingtothe softwarewithoutspecific,writtenpriorpermission.Titletocopyrightinthissoftwareandanyassociated documentationwillatalltimesremainwithcopyrightholders. Javolution Version:5.2.5 Description:JavalibraryforGeospatialdatamanipulation Softwaresite:http://javolution.org/ SourceCode:ThesourcepackagesforJavolutionareavailablefromtheoriginalsoftwaresite,ormaybeacquired fromCambium.ToobtainthesoftwarefromCambium,pleasecontactCambiumusingthemethodsdescribedin thepreambleofthisdocument. License:JavolutionJava(tm)SolutionforRealTimeandEmbeddedSystems Copyright(c)20052007Javolution(http://javolution.org/).Allrightsreserved. Redistributionanduseinsourceandbinaryforms,withorwithoutmodification,arepermittedprovidedthatthe followingconditionsaremet: 1.Redistributionsofsourcecodemustretaintheabovecopyrightnotice,thislistofconditionsandthefollowing disclaimer. 2.Redistributionsinbinaryformmustreproducetheabovecopyrightnotice,thislistofconditionsandthe followingdisclaimerinthedocumentationand/orothermaterialsprovidedwiththedistribution. THISSOFTWAREISPROVIDEDBYTHECOPYRIGHTHOLDERSANDCONTRIBUTORS"ASIS"ANDANYEXPRESSOR IMPLIEDWARRANTIES,INCLUDING,BUTNOTLIMITEDTO,THEIMPLIEDWARRANTIESOFMERCHANTABILITYAND FITNESSFORAPARTICULARPURPOSEAREDISCLAIMED.INNOEVENTSHALLTHECOPYRIGHTOWNEROR CONTRIBUTORSBELIABLEFORANYDIRECT,INDIRECT,INCIDENTAL,SPECIAL,EXEMPLARY,ORCONSEQUENTIAL DAMAGES(INCLUDING,BUTNOTLIMITEDTO,PROCUREMENTOFSUBSTITUTEGOODSORSERVICES;LOSSOFUSE, DATA,ORPROFITS;ORBUSINESSINTERRUPTION)HOWEVERCAUSEDANDONANYTHEORYOFLIABILITY, WHETHERINCONTRACT,STRICTLIABILITY,ORTORT(INCLUDINGNEGLIGENCEOROTHERWISE)ARISINGINANY WAYOUTOFTHEUSEOFTHISSOFTWARE,EVENIFADVISEDOFTHEPOSSIBILITYOFSUCHDAMAGE.
144
Issue 3 August 2012
JScience Version:4.3.1 Description:JavalibraryforGeospatialdatamanipulation Softwaresite:http://jscience.org SourceCode:ThesourcepackagesforJScienceareavailablefromtheoriginalsoftwaresite,ormaybeacquired fromCambium.ToobtainthesoftwarefromCambium,pleasecontactCambiumusingthemethodsdescribedin thepreambleofthisdocument. License:JScienceJava(TM)ToolsandLibrariesfortheAdvancementofSciences Copyright(C)2006JScience(http://jscience.org/).Allrightsreserved. Redistributionanduseinsourceandbinaryforms,withorwithoutmodification,arepermittedprovidedthatthe followingconditionsaremet: *Redistributionsofsourcecodemustretaintheabovecopyrightnoticeandincludethislicenseagreement. *Redistributionsinbinaryformmustreproducetheabovecopyrightnotice,thislistofconditionsandthe followingdisclaimerinthedocumentationand/orothermaterialsprovidedwiththedistribution. THISSOFTWAREISPROVIDEDBYTHECOPYRIGHTHOLDERSANDCONTRIBUTORS"ASIS"ANDANYEXPRESSOR IMPLIEDWARRANTIES,INCLUDING,BUTNOTLIMITEDTO,THEIMPLIEDWARRANTIESOFMERCHANTABILITYAND FITNESSFORAPARTICULARPURPOSEAREDISCLAIMED.INNOEVENTSHALLTHECOPYRIGHTOWNEROR CONTRIBUTORSBELIABLEFORANYDIRECT,INDIRECT,INCIDENTAL,SPECIAL,EXEMPLARY,ORCONSEQUENTIAL DAMAGES(INCLUDING,BUTNOTLIMITEDTO,PROCUREMENTOFSUBSTITUTEGOODSORSERVICES;LOSSOFUSE, DATA,ORPROFITS;ORBUSINESSINTERRUPTION)HOWEVERCAUSEDANDONANYTHEORYOFLIABILITY, WHETHERINCONTRACT,STRICTLIABILITY,ORTORT(INCLUDINGNEGLIGENCEOROTHERWISE)ARISINGINANY WAYOUTOFTHEUSEOFTHISSOFTWARE,EVENIFADVISEDOFTHEPOSSIBILITYOFSUCHDAMAGE. XStream Version:4.2.6 Description:Java,JSONandXMLserializationlibrary Softwaresite:http://xstream.codehaus.org/ SourceCode:ThesourcepackagesforXStreamareavailablefromtheoriginalsoftwaresite,ormaybeacquired fromCambium.ToobtainthesoftwarefromCambium,pleasecontactCambiumusingthemethodsdescribedin thepreambleofthisdocument. License:XStreamisopensourcesoftware,madeavailableunderaBSDlicense. Copyright(c)20032006,JoeWalnes Copyright(c)20062007,XStreamCommitters Allrightsreserved. Redistributionanduseinsourceandbinaryforms,withorwithoutmodification,arepermittedprovidedthatthe followingconditionsaremet:Redistributionsofsourcecodemustretaintheabovecopyrightnotice,thislistof conditionsandthefollowingdisclaimer.Redistributionsinbinaryformmustreproducetheabovecopyrightnotice, thislistofconditionsandthefollowingdisclaimerinthedocumentationand/orothermaterialsprovidedwiththe distribution.NeitherthenameofXStreamnorthenamesofitscontributorsmaybeusedtoendorseorpromote productsderivedfromthissoftwarewithoutspecificpriorwrittenpermission. THISSOFTWAREISPROVIDEDBYTHECOPYRIGHTHOLDERSANDCONTRIBUTORS"ASIS"ANDANYEXPRESSOR IMPLIEDWARRANTIES,INCLUDING,BUTNOTLIMITEDTO,THEIMPLIEDWARRANTIESOFMERCHANTABILITYAND FITNESSFORAPARTICULARPURPOSEAREDISCLAIMED.INNOEVENTSHALLTHECOPYRIGHTOWNEROR CONTRIBUTORSBELIABLEFORANYDIRECT,INDIRECT,INCIDENTAL,SPECIAL,EXEMPLARY,ORCONSEQUENTIAL DAMAGES(INCLUDING,BUTNOTLIMITEDTO,PROCUREMENTOFSUBSTITUTEGOODSORSERVICES;LOSSOFUSE, DATA,ORPROFITS;ORBUSINESSINTERRUPTION)HOWEVERCAUSEDANDONANYTHEORYOFLIABILITY, WHETHERINCONTRACT,STRICTLIABILITY,ORTORT(INCLUDINGNEGLIGENCEOROTHERWISE)ARISINGINANY WAYOUTOFTHEUSEOFTHISSOFTWARE,EVENIFADVISEDOFTHEPOSSIBILITYOFSUCH.
145
Issue 3 August 2012 NetCDF Version:2.2.22 Description:Usedtocalculatelatitude/longitudepoints Softwaresite:http://www.unidata.ucar.edu/software/netcdfjava/
SourceCode:ThesourcepackagesforNetCDFareavailablefromtheoriginalsoftwaresite,ormaybeacquired fromCambium.ToobtainthesoftwarefromCambium,pleasecontactCambiumusingthemethodsdescribedin thepreambleofthisdocument. License:Copyright19932008UniversityCorporationforAtmosphericResearch/Unidata PortionsofthissoftwareweredevelopedbytheUnidataProgramattheUniversityCorporationforAtmospheric Research.Accessanduseofthissoftwareshallimposethefollowingobligationsandunderstandingsontheuser. Theuserisgrantedtheright,withoutanyfeeorcost,touse,copy,modify,alter,enhanceanddistributethis software,andanyderivativeworksthereof,anditssupportingdocumentationforanypurposewhatsoever, providedthatthisentirenoticeappearsinallcopiesofthesoftware,derivativeworksandsupporting documentation.Further,UCARrequeststhattheusercreditUCAR/Unidatainanypublicationsthatresultfromthe useofthissoftwareorinanyproductthatincludesthissoftware,althoughthisisnotanobligation.Thenames UCARand/orUnidata,however,maynotbeusedinanyadvertisingorpublicitytoendorseorpromoteany productsorcommercialentityunlessspecificwrittenpermissionisobtainedfromUCAR/Unidata.Theuseralso understandsthatUCAR/Unidataisnotobligatedtoprovidetheuserwithanysupport,consulting,trainingor assistanceofanykindwithregardtotheuse,operationandperformanceofthissoftwarenortoprovidetheuser withanyupdates,revisions,newversionsor"bugfixes." THISSOFTWAREISPROVIDEDBYUCAR/UNIDATA"ASIS"ANDANYEXPRESSORIMPLIEDWARRANTIES, INCLUDING,BUTNOTLIMITEDTO,THEIMPLIEDWARRANTIESOFMERCHANTABILITYANDFITNESSFORA PARTICULARPURPOSEAREDISCLAIMED.INNOEVENTSHALLUCAR/UNIDATABELIABLEFORANYSPECIAL, INDIRECTORCONSEQUENTIALDAMAGESORANYDAMAGESWHATSOEVERRESULTINGFROMLOSSOFUSE,DATA ORPROFITS,WHETHERINANACTIONOFCONTRACT,NEGLIGENCEOROTHERTORTIOUSACTION,ARISINGOUTOF ORINCONNECTIONWITHTHEACCESS,USEORPERFORMANCEOFTHISSOFTWARE. YahooYuiwidgets Version:2.5.2 Description:Javascriptbasedclientmappinglogwidget Softwaresite:http://developer.yahoo.com/yui/ SourceCode:ThesourcepackagesforYahooYuiWidgetsareavailablefromtheoriginalsoftwaresite,ormaybe acquiredfromCambium.ToobtainthesoftwarefromCambium,pleasecontactCambiumusingthemethods describedinthepreambleofthisdocument. License:SoftwareLicenseAgreement(BSDLicense) Copyright(c)2009,Yahoo!Inc.Allrightsreserved. Redistributionanduseofthissoftwareinsourceandbinaryforms,withorwithoutmodification,arepermitted providedthatthefollowingconditionsaremet:Redistributionsofsourcecodemustretaintheabovecopyright notice,thislistofconditionsandthefollowingdisclaimer.Redistributionsinbinaryformmustreproducetheabove copyrightnotice,thislistofconditionsandthefollowingdisclaimerinthedocumentationand/orothermaterials providedwiththedistribution.NeitherthenameofYahoo!Inc.northenamesofitscontributorsmaybeusedto endorseorpromoteproductsderivedfromthissoftwarewithoutspecificpriorwrittenpermissionofYahoo!Inc. THISSOFTWAREISPROVIDEDBYTHECOPYRIGHTHOLDERSANDCONTRIBUTORS"ASIS"ANDANYEXPRESSOR IMPLIEDWARRANTIES,INCLUDING,BUTNOTLIMITEDTO,THEIMPLIEDWARRANTIESOFMERCHANTABILITYAND FITNESSFORAPARTICULARPURPOSEAREDISCLAIMED.INNOEVENTSHALLTHECOPYRIGHTOWNEROR CONTRIBUTORSBELIABLEFORANYDIRECT,INDIRECT,INCIDENTAL,SPECIAL,EXEMPLARY,ORCONSEQUENTIAL DAMAGES(INCLUDING,BUTNOTLIMITEDTO,PROCUREMENTOFSUBSTITUTEGOODSORSERVICES;LOSSOFUSE, DATA,ORPROFITS;ORBUSINESSINTERRUPTION)HOWEVERCAUSEDANDONANYTHEORYOFLIABILITY,
146
Issue 3 August 2012
WHETHERINCONTRACT,STRICTLIABILITY,ORTORT(INCLUDINGNEGLIGENCEOROTHERWISE)ARISINGINANY WAYOUTOFTHEUSEOFTHISSOFTWARE,EVENIFADVISEDOFTHEPOSSIBILITYOFSUCHDAMAGE. dnsjava Version:2.0.6 Description:dnsjavaisanimplementationofDNSinJava.Itsupportsalldefinedrecordtypes(includingthe DNSSECtypes),andunknowntypes.Itcanbeusedforqueries,zonetransfers,anddynamicupdates. Softwaresite:http://www.dnsjava.org/ SourceCode:Thesourcepackagesfordnsjavaareavailablefromtheoriginalsoftwaresite,ormaybeacquired fromCambium.ToobtainthesoftwarefromCambium,pleasecontactCambiumusingthemethodsdescribedin thepreambleofthisdocument. License:dnsjavaisplacedundertheBSDlicense.Severalfilesarealsounderadditionallicenses;seetheindividual filesfordetails. Copyright(c)19992005,BrianWellington.Allrightsreserved. Redistributionanduseinsourceandbinaryforms,withorwithoutmodification,arepermittedprovidedthatthe followingconditionsaremet:Redistributionsofsourcecodemustretaintheabovecopyrightnotice,thislistof conditionsandthefollowingdisclaimer.Redistributionsinbinaryformmustreproducetheabovecopyrightnotice, thislistofconditionsandthefollowingdisclaimerinthedocumentationand/orothermaterialsprovidedwiththe distribution.Neitherthenameofthednsjavaprojectnorthenamesofitscontributorsmaybeusedtoendorseor promoteproductsderivedfromthissoftwarewithoutspecificpriorwrittenpermission. THISSOFTWAREISPROVIDEDBYTHECOPYRIGHTHOLDERSANDCONTRIBUTORS"ASIS"ANDANYEXPRESSOR IMPLIEDWARRANTIES,INCLUDING,BUTNOTLIMITEDTO,THEIMPLIEDWARRANTIESOFMERCHANTABILITYAND FITNESSFORAPARTICULARPURPOSEAREDISCLAIMED.INNOEVENTSHALLTHECOPYRIGHTOWNEROR CONTRIBUTORSBELIABLEFORANYDIRECT,INDIRECT,INCIDENTAL,SPECIAL,EXEMPLARY,ORCONSEQUENTIAL DAMAGES(INCLUDING,BUTNOTLIMITEDTO,PROCUREMENTOFSUBSTITUTEGOODSORSERVICES;LOSSOFUSE, DATA,ORPROFITS;ORBUSINESSINTERRUPTION)HOWEVERCAUSEDANDONANYTHEORYOFLIABILITY, WHETHERINCONTRACT,STRICTLIABILITY,ORTORT(INCLUDINGNEGLIGENCEOROTHERWISE)ARISINGINANY WAYOUTOFTHEUSEOFTHISSOFTWARE,EVENIFADVISEDOFTHEPOSSIBILITYOFSUCHDAMAGE. Finalnotes: ThankstoNetworkAssociates,Inc.forsponsoringsomeoftheoriginaldnsjavaworkin19992000. ThankstoNominum,Inc.forsponsoringsomeworkondnsjavafrom2000tothepresent.
Packages That Use Apache License Version 2.0
ThefollowingsixpackagesusetheApacheLicense,Version2.0,January2004,whosefulltextisprovidedunder ApacheLicenseVersion2.0,January2004. Axis.jar Version:1.4 Description:UsedtoaccessPrizmAPIsexposedthroughWebServicesfromWM Softwaresite:http://ws.apache.org/axis/ SourceCode:ThesourcepackagesforAxisareavailablefromtheoriginalsoftwaresite,ormaybeacquiredfrom Cambium.ToobtainthesoftwarefromCambium,pleasecontactCambiumusingthemethodsdescribedinthe preambleofthisdocument. JAXRPC1.1 Version:1.1 Description:UsedtoaccessPrizmAPIsexposedthroughWebServicesfromWM Softwaresite:http://ws.apache.org/axis/
147
Issue 3 August 2012
SourceCode:ThesourcepackagesforJAXRPC1.1areavailablefromtheoriginalsoftwaresite,ormaybe acquiredfromCambium.ToobtainthesoftwarefromCambium,pleasecontactCambiumusingthemethods describedinthepreambleofthisdocument. log4j1.2.12.jar Version:1.2.12 Description:UsedtoaccessPrizmAPIsexposedthroughWebServicesfromWM Softwaresite:http://sourceforge.net/projects/log4j SourceCode:Thesourcepackagesforlog4j1.5.12.jarareavailablefromtheoriginalsoftwaresite,ormaybe acquiredfromCambium.ToobtainthesoftwarefromCambium,pleasecontactCambiumusingthemethods describedinthepreambleofthisdocument. wsdl4j1.5.1.jar Version:1.5.1 Description:UsedtoaccessPrizmAPIsexposedthroughWebServicesfromWM Softwaresite:http://sourceforge.net/projects/wsdl4j SourceCode:Thesourcepackagesforwsdl4j1.5.1.jarareavailablefromtheoriginalsoftwaresite,ormaybe acquiredfromCambium.ToobtainthesoftwarefromCambium,pleasecontactCambiumusingthemethods describedinthepreambleofthisdocument. commonslogging1.0.4.jar Version:1.0.4 Description:UsedtoaccessPrizmAPIsexposedthroughWebServicesfromWM Softwaresite:http://commons.apache.org/logging/ SourceCode:Thesourcepackagesforcommonslogging1.0.4.jarareavailablefromtheoriginalsoftwaresite,or maybeacquiredfromCambium.ToobtainthesoftwarefromCambium,pleasecontactCambiumusingthe methodsdescribedinthepreambleofthisdocument. commonsdiscovery0.2.jar Version:0.2 Description:UsedtoaccessPrizmAPIsexposedthroughWebServicesfromWM Softwaresite:http://commons.apache.org/discovery/ SourceCode:Thesourcepackagesforcommonsdiscovery0.2.jarareavailablefromtheoriginalsoftwaresite,or maybeacquiredfromCambium.ToobtainthesoftwarefromCambium,pleasecontactCambiumusingthe methodsdescribedinthepreambleofthisdocument. ApacheLicense Version2.0,January2004 http://www.apache.org/licenses/ TERMSANDCONDITIONSFORUSE,REPRODUCTION,ANDDISTRIBUTION 1.Definitions."License"shallmeanthetermsandconditionsforuse,reproduction,anddistributionasdefinedby Sections1through9ofthisdocument."Licensor"shallmeanthecopyrightownerorentityauthorizedbythe copyrightownerthatisgrantingtheLicense."LegalEntity"shallmeantheunionoftheactingentityandallother entitiesthatcontrol,arecontrolledby,orareundercommoncontrolwiththatentity.Forthepurposesofthis definition,"control"means(i)thepower,directorindirect,tocausethedirectionormanagementofsuchentity, whetherbycontractorotherwise,or(ii)ownershipoffiftypercent(50%)ormoreoftheoutstandingshares,or(iii) beneficialownershipofsuchentity."You"(or"Your")shallmeananindividualorLegalEntityexercising permissionsgrantedbythisLicense."Source"formshallmeanthepreferredformformakingmodifications, includingbutnotlimitedtosoftwaresourcecode,documentationsource,andconfigurationfiles."Object"form shallmeananyformresultingfrommechanicaltransformationortranslationofaSourceform,includingbutnot limitedtocompiledobjectcode,generateddocumentation,andconversionstoothermediatypes."Work"shall
148
Issue 3 August 2012
meantheworkofauthorship,whetherinSourceorObjectform,madeavailableundertheLicense,asindicatedby acopyrightnoticethatisincludedinorattachedtothework(anexampleisprovidedintheAppendixbelow). "DerivativeWorks"shallmeananywork,whetherinSourceorObjectform,thatisbasedon(orderivedfrom)the Workandforwhichtheeditorialrevisions,annotations,elaborations,orothermodificationsrepresent,asawhole, anoriginalworkofauthorship.ForthepurposesofthisLicense,DerivativeWorksshallnotincludeworksthat remainseparablefrom,ormerelylink(orbindbyname)totheinterfacesof,theWorkandDerivativeWorks thereof."Contribution"shallmeananyworkofauthorship,includingtheoriginalversionoftheWorkandany modificationsoradditionstothatWorkorDerivativeWorksthereof,thatisintentionallysubmittedtoLicensorfor inclusionintheWorkbythecopyrightownerorbyanindividualorLegalEntityauthorizedtosubmitonbehalfof thecopyrightowner.Forthepurposesofthisdefinition,"submitted"meansanyformofelectronic,verbal,or writtencommunicationsenttotheLicensororitsrepresentatives,includingbutnotlimitedtocommunicationon electronicmailinglists,sourcecodecontrolsystems,andissuetrackingsystemsthataremanagedby,oronbehalf of,theLicensorforthepurposeofdiscussingandimprovingtheWork,butexcludingcommunicationthatis conspicuouslymarkedorotherwisedesignatedinwritingbythecopyrightowneras"NotaContribution." "Contributor"shallmeanLicensorandanyindividualorLegalEntityonbehalfofwhomaContributionhasbeen receivedbyLicensorandsubsequentlyincorporatedwithintheWork. 2.GrantofCopyrightLicense.SubjecttothetermsandconditionsofthisLicense,eachContributorherebygrants toYouaperpetual,worldwide,nonexclusive,nocharge,royaltyfree,irrevocablecopyrightlicensetoreproduce, prepareDerivativeWorksof,publiclydisplay,publiclyperform,sublicense,anddistributetheWorkandsuch DerivativeWorksinSourceorObjectform. 3.GrantofPatentLicense.SubjecttothetermsandconditionsofthisLicense,eachContributorherebygrantsto Youaperpetual,worldwide,nonexclusive,nocharge,royaltyfree,irrevocable(exceptasstatedinthissection) patentlicensetomake,havemade,use,offertosell,sell,import,andotherwisetransfertheWork,wheresuch licenseappliesonlytothosepatentclaimslicensablebysuchContributorthatarenecessarilyinfringedbytheir Contribution(s)aloneorbycombinationoftheirContribution(s)withtheWorktowhichsuchContribution(s)was submitted.IfYouinstitutepatentlitigationagainstanyentity(includingacrossclaimorcounterclaiminalawsuit) allegingthattheWorkoraContributionincorporatedwithintheWorkconstitutesdirectorcontributorypatent infringement,thenanypatentlicensesgrantedtoYouunderthisLicenseforthatWorkshallterminateasofthe datesuchlitigationisfiled. 4.Redistribution.YoumayreproduceanddistributecopiesoftheWorkorDerivativeWorksthereofinany medium,withorwithoutmodifications,andinSourceorObjectform,providedthatYoumeetthefollowing conditions: (a) (b) (c) YoumustgiveanyotherrecipientsoftheWorkorDerivativeWorksacopyofthisLicense;and YoumustcauseanymodifiedfilestocarryprominentnoticesstatingthatYouchangedthefiles;and Youmustretain,intheSourceformofanyDerivativeWorksthatYoudistribute,allcopyright,patent, trademark,andattributionnoticesfromtheSourceformoftheWork,excludingthosenoticesthatdo notpertaintoanypartoftheDerivativeWorks;and IftheWorkincludesa"NOTICE"textfileaspartofitsdistribution,thenanyDerivativeWorksthatYou distributemustincludeareadablecopyoftheattributionnoticescontainedwithinsuchNOTICEfile, excludingthosenoticesthatdonotpertaintoanypartoftheDerivativeWorks,inatleastoneofthe followingplaces:withinaNOTICEtextfiledistributedaspartoftheDerivativeWorks;withinthe Sourceformordocumentation,ifprovidedalongwiththeDerivativeWorks;or,withinadisplay generatedbytheDerivativeWorks,ifandwhereversuchthirdpartynoticesnormallyappear.The contentsoftheNOTICEfileareforinformationalpurposesonlyanddonotmodifytheLicense.You mayaddYourownattributionnoticeswithinDerivativeWorksthatYoudistribute,alongsideorasan addendumtotheNOTICEtextfromtheWork,providedthatsuchadditionalattributionnoticescannot beconstruedasmodifyingtheLicense.
(d)
YoumayaddYourowncopyrightstatementtoYourmodificationsandmayprovideadditionalordifferentlicense termsandconditionsforuse,reproduction,ordistributionofYourmodifications,orforanysuchDerivativeWorks
149
Issue 3 August 2012
asawhole,providedYouruse,reproduction,anddistributionoftheWorkotherwisecomplieswiththeconditions statedinthisLicense. 5.SubmissionofContributions.UnlessYouexplicitlystateotherwise,anyContributionintentionallysubmittedfor inclusionintheWorkbyYoutotheLicensorshallbeunderthetermsandconditionsofthisLicense,withoutany additionaltermsorconditions.Notwithstandingtheabove,nothinghereinshallsupersedeormodifythetermsof anyseparatelicenseagreementyoumayhaveexecutedwithLicensorregardingsuchContributions. 6.Trademarks.ThisLicensedoesnotgrantpermissiontousethetradenames,trademarks,servicemarks,or productnamesoftheLicensor,exceptasrequiredforreasonableandcustomaryuseindescribingtheoriginofthe WorkandreproducingthecontentoftheNOTICEfile. 7.DisclaimerofWarranty.Unlessrequiredbyapplicablelaworagreedtoinwriting,LicensorprovidestheWork (andeachContributorprovidesitsContributions)onan"ASIS"BASIS,WITHOUTWARRANTIESORCONDITIONSOF ANYKIND,eitherexpressorimplied,including,withoutlimitation,anywarrantiesorconditionsofTITLE,NON INFRINGEMENT,MERCHANTABILITY,orFITNESSFORAPARTICULARPURPOSE.Youaresolelyresponsiblefor determiningtheappropriatenessofusingorredistributingtheWorkandassumeanyrisksassociatedwithYour exerciseofpermissionsunderthisLicense. 8.LimitationofLiability.Innoeventandundernolegaltheory,whetherintort(includingnegligence),contract, orotherwise,unlessrequiredbyapplicablelaw(suchasdeliberateandgrosslynegligentacts)oragreedtoin writing,shallanyContributorbeliabletoYoufordamages,includinganydirect,indirect,special,incidental,or consequentialdamagesofanycharacterarisingasaresultofthisLicenseoroutoftheuseorinabilitytousethe Work(includingbutnotlimitedtodamagesforlossofgoodwill,workstoppage,computerfailureormalfunction, oranyandallothercommercialdamagesorlosses),evenifsuchContributorhasbeenadvisedofthepossibilityof suchdamages. 9.AcceptingWarrantyorAdditionalLiability.WhileredistributingtheWorkorDerivativeWorksthereof,You maychoosetooffer,andchargeafeefor,acceptanceofsupport,warranty,indemnity,orotherliabilityobligations and/orrightsconsistentwiththisLicense.However,inacceptingsuchobligations,YoumayactonlyonYourown behalfandonYoursoleresponsibility,notonbehalfofanyotherContributor,andonlyifYouagreetoindemnify, defend,andholdeachContributorharmlessforanyliabilityincurredby,orclaimsassertedagainst,such Contributorbyreasonofyouracceptinganysuchwarrantyoradditionalliability. ENDOFTERMSANDCONDITIONS APPENDIX:HowtoapplytheApacheLicensetoyourwork. ToapplytheApacheLicensetoyourwork,attachthefollowingboilerplatenotice,withthefieldsenclosedby brackets"[]"replacedwithyourownidentifyinginformation.(Don'tincludethebrackets!)Thetextshouldbe enclosedintheappropriatecommentsyntaxforthefileformat.Wealsorecommendthatafileorclassnameand descriptionofpurposebeincludedonthesame"printedpage"asthecopyrightnoticeforeasieridentification withinthirdpartyarchives.Copyright[yyyy][nameofcopyrightowner]LicensedundertheApacheLicense, Version2.0(the"License");youmaynotusethisfileexceptincompliancewiththeLicense. YoumayobtainacopyoftheLicenseathttp://www.apache.org/licenses/LICENSE2.0. Unlessrequiredbyapplicablelaworagreedtoinwriting,softwaredistributedundertheLicenseisdistributedon an"ASIS"BASIS,WITHOUTWARRANTIESORCONDITIONSOFANYKIND,eitherexpressorimplied.SeetheLicense forthespecificlanguagegoverningpermissionsandlimitationsundertheLicense.
150
Issue 3 August 2012
THIRD PARTY PUBLICLY AVAILABLE SOFTWARE LEGAL NOTICES AND END USER LICENSE AGREEMENTS FOR PUBLICLY AVAILABLE SOFTWARE
TheWirelessManagersoftwaremayincludeCambiumsoftware,commercialthirdpartysoftware,and/or publiclyavailable(opensource)software. TheCambiumsoftwareincludedintheWirelessManagersoftwareiscopyright(c)byCambiumNetworks,LTD (Cambium),anditsuseissubjecttothelicenses,termsandconditionsoftheagreementinforcebetweenthe purchaseroftheWirelessManagersoftwareandCambium.Thecommercialthirdpartysoftwarethatmaybe includedinorwiththeWirelessManagersoftwareissubjecttothelicenses,termsandconditionsofthe agreementinforcebetweenyouandCambium,unlessaseparatecommercialthirdpartysoftwarelicenseis included,inwhichcase,youruseofthecommercialthirdpartysoftwarewillthenbegovernedbytheseparate commercialthirdpartylicense.ThepubliclyavailablesoftwarethatmaybeincludedinorwiththeWireless Managersoftwareislistedbelow.Theuseofthelistedpubliclyavailablesoftwareissubjecttothelicenses, termsandconditionsoftheagreementinforcebetweenyouandCambium,aswellasthetermsandconditionsof thelicenseofeachpubliclyavailablesoftwarepackage.Copiesofthelicensesforthelistedpubliclyavailable software,aswellas,allattributions,acknowledgements,andsoftwareinformationdetails,areincludedbelow. Cambiumisrequiredtoreproducethesoftwarelicenses,acknowledgmentsandcopyrightnoticesasprovidedby theauthorsandowners,thus,allsuchinformationisprovidedinitsnativelanguageform,withoutmodificationor translation. Thepubliclyavailablesoftwareinthelistbelowincludesthepubliclyavailablesoftwareincludedbycommercial thirdpartysoftwarethatisusedintheWirelessManagersoftware.Thepubliclyavailablesoftwareincludedby CambiumthatisusedintheWirelessManagersoftwareisdisclosedintheCambiumPubliclyAvailableSoftware LegalNoticesandEndUserLicenseAgreementsforPubliclyAvailableSoftwareaccompanyingtheWireless Managersoftware. ForinstructionsonhowtoobtainacopyofanysourcecodebeingmadepubliclyavailablebyCambiumrelatedto softwareusedintheWirelessManagersoftwareyoumaysendyourrequestinwritingto: CambiumNetworks,LTD Attention:OpenSourceSoftwareManager 1299E.AlgonquinRoad Schaumburg,IL60196 Inyourrequest,pleaseincludetheversionoftheWirelessManagersoftware,alongwiththepubliclyavailable softwarespecifics,suchasthepubliclyavailablesoftwarenameandversion. Note:thesourcecodeforthepubliclyavailablesoftwaremayberesidentontheCambiumproductinstallation media,oronsupplementalCambiumproductmediaand/orCambiumwebsites.Pleasereferenceandreviewthese entireThirdPartyPubliclyAvailableSoftwareLegalNoticesandEndUserLicenseAgreementsforPubliclyAvailable Softwareforthedetailsonlocationandmethodsofobtainingthesourcecode. Note:dependentonthelicensetermsofthepubliclyavailablesoftware,sourcecodemaynotbeprovided.Please referenceandreviewtheseentireThirdPartyPubliclyAvailableSoftwareLegalNoticesandEndUserLicense AgreementsforPubliclyAvailableSoftwareforthedetailsonlocationandmethodsofobtainingthesourcecode. Toviewadditionalinformationregardinglicenses,acknowledgmentsandrequiredcopyrightnoticesforpublicly availablesoftwareusedintheWirelessManagersoftware,pleaseselectLegalNoticesdisplayfromtheGUI(if applicable),orreviewthelegalnoticesandenduserlicenseagreementsintheREADMEfilesorotherfilescreated duringinstallation,inthedocumentation,ontheinstallationmedia,orresidentintheWirelessManager software. WIRELESSMANAGER,CAMBIUM,CAMBIUMNETWORKS,andtheCambiumNetworksLogoaretrademarksof CambiumNetworks,LTD.Allothertrademarks,logos,andservicemarksarethepropertyoftherespectivethird partyowners.YouarenotpermittedtouseanymarkswithoutthepriorwrittenconsentofCambiumorsuchthird partywhichmayownthemarks.
151
Issue 3 August 2012

Software Included by Commercial Third Party Software
Thefollowingaretheenduserlicenseagreementsforpubliclyavailablesoftwarethatcommercialthirdparty softwarehasincluded. openorb_tools1.2.0.jar Version:1.2 Description:CORBA SoftwareSite:http://sourceforge.net/project/showfiles.php?group_id=43608&package_id=36153 SourceCode:Thesourcepackagesforopenorb_toolsareavailablefromtheoriginalsoftwaresite,ormaybe acquiredfromCambium.ToobtainthesoftwarefromCambium,pleasecontactCambiumusingthemethods describedinthisdocument. License: TheOpenORBCommunitySoftwareLicense,Version1.0 Copyright(C)2002TheOpenORBProject.Allrightsreserved. Redistributionanduseinsourceandbinaryforms,withorwithoutmodification,arepermittedprovidedthatthe followingconditionsaremet: 1.Redistributionsofsourcecodemustretaintheabovecopyrightnotice,thislistofconditionsandthefollowing disclaimer. 2.Redistributionsinbinaryformmustreproducetheabovecopyrightnotice,thislistofconditionsandthe followingdisclaimerinthedocumentationand/orothermaterialsprovidedwiththedistribution. 3.Theenduserdocumentationincludedwiththeredistribution,ifany,mustincludethefollowing acknowledgment:"ThisproductincludessoftwaredevelopedbytheOpenORBCommunityProject (http://sourceforge.net/projects/openorb/)."togetherwiththeduecreditstatementslistedbelow.Alternately, thisacknowledgmentandduecreditsmayappearinthesoftwareitself,ifandwhereversuchthirdparty acknowledgmentsnormallyappear. THISSOFTWAREISPROVIDED`ÀSIS''ANDANYEXPRESSEDORIMPLIEDWARRANTIES,INCLUDING,BUTNOT LIMITEDTO,THEIMPLIEDWARRANTIESOFMERCHANTABILITYANDFITNESSFORAPARTICULARPURPOSEARE DISCLAIMED.INNOEVENTSHALLTHEMEMBERSOFTHEOPENORBCOMMUNITYPROJECTORITSCONTRIBUTORS BELIABLEFORANYDIRECT,INDIRECT,INCIDENTAL,SPECIAL,EXEMPLARY,ORCONSEQUENTIALDAMAGES (INCLUDING,BUTNOTLIMITEDTO,PROCUREMENTOFSUBSTITUTEGOODSORSERVICES;LOSSOFUSE,DATA,OR PROFITS;ORBUSINESSINTERRUPTION)HOWEVERCAUSEDANDONANYTHEORYOFLIABILITY,WHETHERIN CONTRACT,STRICTLIABILITY,ORTORT(INCLUDINGNEGLIGENCEOROTHERWISE)ARISINGINANYWAYOUTOF THEUSEOFTHISSOFTWARE,EVENIFADVISEDOFTHEPOSSIBILITYOFSUCHDAMAGE. ThissoftwareconsistsofvoluntarycontributionsmadebymanyindividualstotheOpenORBCommunityProject. FormoreinformationontheOpenORBCommunityProject,pleasereferto http://sourceforge.net/projects/openorb/. DueCredits ThisproductincludessoftwaredevelopedbytheApacheSoftwareFoundation(http://www.apache.org/), includingtheAvalonFramework,AvalonLogkit,andrelatedExcaliburutilities.DuecredittotheApacheSoftware Foundationisherebyacknowledged. ThisproductisderivedfrominitialworkspublishedundertheExolabGroup,(http://www.exolab.org</a>).Due credittotheExolabGroupisherebyacknowledged.Partsofthissoftwarearederivedfromandsubjecttothe termsoftheExolablicense.AcopyoftheExolablicenseiscontainedinrespectivedistributions. ExolabGroupLicense Copyright(C)19992001Intalio,Inc.AllRightsReserved.
152
Issue 3 August 2012
Redistributionanduseofthissoftwareandassociateddocumentation("Software"),withorwithoutmodification, arepermittedprovidedthatthefollowingconditionsaremet: 1.Redistributionsofsourcecodemustretaincopyrightstatementsandnotices.Redistributionsmustalsocontaina copyofthisdocument. 2.Redistributionsinbinaryformmustreproducetheabovecopyrightnotice,thislistofconditionsandthe followingdisclaimerinthedocumentationand/orothermaterialsprovidedwiththedistribution. 3.Thename"ExoLab"mustnotbeusedtoendorseorpromoteproductsderivedfromthisSoftwarewithoutprior writtenpermissionofExoLabGroup.Forwrittenpermission,pleasecontactinfo@exolab.org. 4.ProductsderivedfromthisSoftwaremaynotbecalled"ExoLab"normay"ExoLab"appearintheirnames withoutpriorwrittenpermissionofExoLabGroup.ExolabisaregisteredtrademarkofExoLabGroup. 5.DuecreditshouldbegiventotheExoLabGroup(http://www.exolab.org). THISSOFTWAREISPROVIDEDBYINTALIO,INC.ANDCONTRIBUTORS''ASIS''ANDANYEXPRESSEDORIMPLIED WARRANTIES,INCLUDING,BUTNOTLIMITEDTO,THEIMPLIEDWARRANTIESOFMERCHANTABILITYANDFITNESS FORAPARTICULARPURPOSEAREDISCLAIMED. INNOEVENTSHALLINTALIO,INC.ORITSCONTRIBUTORSBELIABLEFORANYDIRECT,INDIRECT,INCIDENTAL, SPECIAL,EXEMPLARY,ORCONSEQUENTIALDAMAGES(INCLUDING,BUTNOTLIMITEDTO,PROCUREMENTOF SUBSTITUTEGOODSORSERVICES;LOSSOFUSE,DATA,ORPROFITS;ORBUSINESSINTERRUPTION)HOWEVER CAUSEDANDONANYTHEORYOFLIABILITY,WHETHERINCONTRACT,STRICTLIABILITY,ORTORT(INCLUDING NEGLIGENCEOROTHERWISE)ARISINGINANYWAYOUTOFTHEUSEOFTHISSOFTWARE,EVENIFADVISEDOFTHE POSSIBILITYOFSUCHDAMAGE. jython.jar Version:2.1 Description:Jythonisanimplementationofthehighlevel,dynamic,objectorientedlanguagePythonwrittenin 100%PureJava,andseamlesslyintegratedwiththeJavaplatform.ItthusallowsyoutorunPythononanyJava platform. SoftwareSite:http://www.jython.org SourceCode:ThesourcepackagesforJythonareavailablefromtheoriginalsoftwaresite,ormaybeacquired fromCambium.ToobtainthesoftwarefromCambium,pleasecontactCambiumusingthemethodsdescribedin thisdocument. License: A.TERMSANDCONDITIONSFORACCESSINGOROTHERWISEUSINGJYTHONPYTHONSOFTWAREFOUNDATION LICENSEVERSION2 1.ThisLICENSEAGREEMENTisbetweenthePythonSoftwareFoundation("PSF"),andtheIndividualor Organization("Licensee")accessingandotherwiseusingthissoftware("Jython")insourceorbinaryformandits associateddocumentation. 2.SubjecttothetermsandconditionsofthisLicenseAgreement,PSFherebygrantsLicenseeanonexclusive, royaltyfree,worldwidelicensetoreproduce,analyze,test,performand/ordisplaypublicly,preparederivative works,distribute,andotherwiseuseJythonaloneorinanyderivativeversion,provided,however,thatPSF's LicenseAgreementandPSF'snoticeofcopyright,i.e.,"Copyright(c)2007PythonSoftwareFoundation;AllRights Reserved"areretainedinJythonaloneorinanyderivativeversionpreparedbyLicensee. 3.IntheeventLicenseepreparesaderivativeworkthatisbasedonorincorporatesJythonoranypartthereof,and wantstomakethederivativeworkavailabletoothersasprovidedherein,thenLicenseeherebyagreestoinclude inanysuchworkabriefsummaryofthechangesmadetoJython. 4.PSFismakingJythonavailabletoLicenseeonan"ASIS"basis.PSFMAKESNOREPRESENTATIONSOR WARRANTIES,EXPRESSORIMPLIED.BYWAYOFEXAMPLE,BUTNOTLIMITATION,PSFMAKESNOANDDISCLAIMS
153
Issue 3 August 2012
ANYREPRESENTATIONORWARRANTYOFMERCHANTABILITYORFITNESSFORANYPARTICULARPURPOSEOR THATTHEUSEOFJYTHONWILLNOTINFRINGEANYTHIRDPARTYRIGHTS. 5.PSFSHALLNOTBELIABLETOLICENSEEORANYOTHERUSERSOFJYTHONFORANYINCIDENTAL,SPECIAL,OR CONSEQUENTIALDAMAGESORLOSSASARESULTOFMODIFYING,DISTRIBUTING,OROTHERWISEUSINGJYTHON, ORANYDERIVATIVETHEREOF,EVENIFADVISEDOFTHEPOSSIBILITYTHEREOF. 6.ThisLicenseAgreementwillautomaticallyterminateuponamaterialbreachofitstermsandconditions. 7.NothinginthisLicenseAgreementshallbedeemedtocreateanyrelationshipofagency,partnership,orjoint venturebetweenPSFandLicensee.ThisLicenseAgreementdoesnotgrantpermissiontousePSFtrademarksor tradenameinatrademarksensetoendorseorpromoteproductsorservicesofLicensee,oranythirdparty. 8.Bycopying,installingorotherwiseusingJython,Licenseeagreestobeboundbythetermsandconditionsofthis LicenseAgreement. Jython2.0,2.1License Copyright(c)2000,2001,2002,2003,2004,2005,2006,2007JythonDevelopers.Allrightsreserved. Redistributionanduseinsourceandbinaryforms,withorwithoutmodification,arepermittedprovidedthatthe followingconditionsaremet: Redistributionsofsourcecodemustretaintheabovecopyrightnotice,thislistofconditionsandthefollowing disclaimer. Redistributionsinbinaryformmustreproducetheabovecopyrightnotice,thislistofconditionsandthefollowing disclaimerinthedocumentationand/orothermaterialsprovidedwiththedistribution. NeitherthenameoftheJythonDevelopersnorthenamesofitscontributorsmaybeusedtoendorseorpromote productsderivedfromthissoftwarewithoutspecificpriorwrittenpermission. THISSOFTWAREISPROVIDEDBYTHECOPYRIGHTHOLDERSANDCONTRIBUTORS"ASIS''ANDANYEXPRESSOR IMPLIEDWARRANTIES,INCLUDING,BUTNOTLIMITEDTO,THEIMPLIEDWARRANTIESOFMERCHANTABILITYAND FITNESSFORAPARTICULARPURPOSEAREDISCLAIMED.INNOEVENTSHALLTHEREGENTSORCONTRIBUTORSBE LIABLEFORANYDIRECT,INDIRECT,INCIDENTAL,SPECIAL,EXEMPLARY,ORCONSEQUENTIALDAMAGES (INCLUDING,BUTNOTLIMITEDTO,PROCUREMENTOFSUBSTITUTEGOODSORSERVICES;LOSSOFUSE,DATA,OR PROFITS;ORBUSINESSINTERRUPTION)HOWEVERCAUSEDANDONANYTHEORYOFLIABILITY,WHETHERIN CONTRACT,STRICTLIABILITY,ORTORT(INCLUDINGNEGLIGENCEOROTHERWISE)ARISINGINANYWAYOUTOF THEUSEOFTHISSOFTWARE,EVENIFADVISEDOFTHEPOSSIBILITYOFSUCHDAMAGE. p6spy.jar Version:1.3 Description:DebugTool SoftwareSite:http://www.p6spy.com/ SourceCode:Thesourcepackagesforp6spy.jarareavailablefromtheoriginalsoftwaresite,ormaybeacquired fromCambium.ToobtainthesoftwarefromCambium,pleasecontactCambiumusingthemethodsdescribedin thisdocument. License: TheP6SpySoftwareLicense,Version1.2 ThislicenseisderivedandfullycompatiblewiththeApacheSoftwarelicense,see http://www.apache.org/LICENSE.txt.Copyright(c)20012003AndyMartin,Ph.D.andJeffGokeAllrightsreserved. Redistributionanduseinsourceandbinaryforms,withorwithoutmodification,arepermittedprovidedthatthe followingconditionsaremet: 1.Redistributionsofsourcecodemustretaintheabovecopyrightnotice,thislistofconditionsandthefollowing disclaimer. 2.Redistributionsinbinaryformmustreproducetheabovecopyrightnotice,thislistofconditionsandthe followingdisclaimerinthedocumentationand/orothermaterialsprovidedwiththedistribution.
154
Issue 3 August 2012
3.Theenduserdocumentationincludedwiththeredistribution,ifany,mustincludethefollowing acknowledgment: TheoriginalconceptandcodebaseforP6SpywasconceivedanddevelopedbyAndyMartin,Ph.D.who generouslycontributedthefirstcompletereleasetothepublicunderthislicense.Thisproductwasdueto thepioneeringworkofAndythatbeganinDecemberof1995developingapplicationsthatcouldseamlessly bedeployedwithminimaleffortbutwithdramaticresults.ThiscodeismaintainedandextendedbyJeffGoke andwiththeideasandcontributionsofotherP6Spycontributors.(http://www.p6spy.com)Alternately,this acknowledgmentmayappearinthesoftwareitself,ifandwhereversuchthirdpartyacknowledgments normallyappear. 4.Thenames"P6Spy","JeffGoke",and"AndyMartin"mustnotbeusedtoendorseorpromoteproductsderived fromthissoftwarewithoutpriorwrittenpermission.Forwrittenpermission,pleasecontactlicense@p6spy.com. 5.Productsderivedfromthissoftwaremaynotbecalled"P6Spy"normay"P6Spy"appearintheirnameswithout priorwrittenpermissionofJeffGokeandAndyMartin. THISSOFTWAREISPROVIDED`ÀSIS''ANDANYEXPRESSEDORIMPLIEDWARRANTIES,INCLUDING,BUTNOT LIMITEDTO,THEIMPLIEDWARRANTIESOFMERCHANTABILITYANDFITNESSFORAPARTICULARPURPOSEARE DISCLAIMED.INNOEVENTSHALLTHEAPACHESOFTWAREFOUNDATIONORITSCONTRIBUTORSBELIABLEFOR ANYDIRECT,INDIRECT,INCIDENTAL,SPECIAL,EXEMPLARY,ORCONSEQUENTIALDAMAGES(INCLUDING,BUTNOT LIMITEDTO,PROCUREMENTOFSUBSTITUTEGOODSORSERVICES;LOSSOFUSE,DATA,ORPROFITS;ORBUSINESS INTERRUPTION)HOWEVERCAUSEDANDONANYTHEORYOFLIABILITY,WHETHERINCONTRACT,STRICTLIABILITY, ORTORT(INCLUDINGNEGLIGENCEOROTHERWISE)ARISINGINANYWAYOUTOFTHEUSEOFTHISSOFTWARE, EVENIFADVISEDOFTHEPOSSIBILITYOFSUCHDAMAGE. TrademarkNotices Sun,theSunlogo,SunMicrosystems,JavaSoft,JavaBeans,JDK,Java,HotJava,HotJavaViews,VisualJava,Solaris, NEO,Joe,Netra,NFS,ONC,ONC+,OpenWindows,PCNFS,SNM,SunNetManager,Solarissunburstdesign, Solstice,SunCore,SolarNet,SunWeb,SunWorkstation,TheNetworkIsTheComputer,ToolTalk,Ultra, Ultracomputing,Ultraserver,WhereTheNetworkIsGoing,SunWorkShop,XView,JavaWorkShop,theJavaCoffee Cuplogo,andVisualJavaaretrademarksorregisteredtrademarksofSunMicrosystems,Inc.intheUnitedStates andothercountries. Windows,WindowsNT,andWin32areregisteredtrademarksofMicrosoftCorp. JBossandJBossGrouparetrademarksofMarcFleuryunderoperationbyJBossGroup,LLC. Sybase,SQLAnywhere,andAdaptiveServerAnywherearetrademarksofSybase,Inc. MicrosoftSQLServerisatrademarkoftheMicrosoftCorporation. BEA,WebLogic,Tuxedo,andJoltareregisteredtrademarks,andHowBusinessBecomesEBusiness,BEAWebLogic EBusinessPlatform,BEABuilder,BEAeLink,BEAWebLogicEnterprise,BEAWebLogicExpress,BEAWebLogic Integration,BEAWebLogicPersonalizationServer,BEAWebLogicPortal,andBEAWebLogicServeraretrademarks ofBEASystems,Inc. Oracleisaregisteredtrademark,andConText,OracleAllianceandOracle8aretrademarksorregistered trademarksofOracleCorporation. DB2,DB2OLAPServer,WebSphere,andIBMaretrademarksorregisteredtrademarksofInternational. BusinessMachinesCorporationintheUnitedStates,othercountriesorboth. MySQLisatrademarkofMySQLABintheUnitedStatesandothercountries. Otherproductnamesmentionedhereinandthroughoutthethiswebsitearethetrademarksoftheirrespective owners. Zlib Version:1.1.14 Description:Compressionlibraryusedbylibpng
155
Issue 3 August 2012 SoftwareSite:http://www.zlib.net
SourceCode:ThesourcepackagesforZLibareavailablefromtheoriginalsoftwaresite,ormaybeacquired fromCambium.ToobtainthesoftwarefromCambium,pleasecontactCambiumusingthemethodsdescribedin thisdocument. License: Licensezlib.hinterfaceofthe'zlib'generalpurposecompressionlibrary version1.2.2,October3rd,2004 Copyright(C)19952004JeanloupGaillyandMarkAdler Thissoftwareisprovided'asis',withoutanyexpressorimpliedwarranty.Innoeventwilltheauthorsbeheld liableforanydamagesarisingfromtheuseofthissoftware. Permissionisgrantedtoanyonetousethissoftwareforanypurpose,includingcommercialapplications,andto alteritandredistributeitfreely,subjecttothefollowingrestrictions: 1.Theoriginofthissoftwaremustnotbemisrepresented;youmustnotclaimthatyouwrotetheoriginal software.Ifyouusethissoftwareinaproduct,anacknowledgmentintheproductdocumentationwouldbe appreciatedbutisnotrequired. 2.Alteredsourceversionsmustbeplainlymarkedassuch,andmustnotbemisrepresentedasbeingtheoriginal software. 3.Thisnoticemaynotberemovedoralteredfromanysourcedistribution. JeanloupGaillyjloup@gzip.org MarkAdlermadler@alumni.caltech.edu Org.w3c.dom Version:1 Description:DocumentObjectModel SoftwareSite:http://www.w3.org/DOM SourceCode:ThesourcepackagesforOrg.w3c.domareavailablefromtheoriginalsoftwaresite,ormaybe acquiredfromCambium.ToobtainthesoftwarefromCambium,pleasecontactCambiumusingthemethods describedinthisdocument. License:http://www.w3.org/Consortium/Legal/2002/copyrightsoftware20021231 Thiswork(andincludedsoftware,documentationsuchasREADMEs,orotherrelateditems)isbeingprovidedby thecopyrightholdersunderthefollowinglicense.Byobtaining,usingand/orcopyingthiswork,you(thelicensee) agreethatyouhaveread,understood,andwillcomplywiththefollowingtermsandconditions. Permissiontocopy,modify,anddistributethissoftwareanditsdocumentation,withorwithoutmodification,for anypurposeandwithoutfeeorroyaltyisherebygranted,providedthatyouincludethefollowingonALLcopiesof thesoftwareanddocumentationorportionsthereof,includingmodifications: ThefulltextofthisNOTICEinalocationviewabletousersoftheredistributedorderivativework.Anypreexisting intellectualpropertydisclaimers,notices,ortermsandconditions.Ifnoneexist,theW3CSoftwareShortNotice shouldbeincluded(hypertextispreferred,textispermitted)withinthebodyofanyredistributedorderivative code. Noticeofanychangesormodificationstothefiles,includingthedatechangesweremade. (WerecommendyouprovideURLstothelocationfromwhichthecodeisderived.) THISSOFTWAREANDDOCUMENTATIONISPROVIDED"ASIS,"ANDCOPYRIGHTHOLDERSMAKENO REPRESENTATIONSORWARRANTIES,EXPRESSORIMPLIED,INCLUDINGBUTNOTLIMITEDTO,WARRANTIESOF MERCHANTABILITYORFITNESSFORANYPARTICULARPURPOSEORTHATTHEUSEOFTHESOFTWAREOR DOCUMENTATIONWILLNOTINFRINGEANYTHIRDPARTYPATENTS,COPYRIGHTS,TRADEMARKSOROTHER
156
Issue 3 August 2012
RIGHTS.COPYRIGHTHOLDERSWILLNOTBELIABLEFORANYDIRECT,INDIRECT,SPECIALORCONSEQUENTIAL DAMAGESARISINGOUTOFANYUSEOFTHESOFTWAREORDOCUMENTATION. ThenameandtrademarksofcopyrightholdersmayNOTbeusedinadvertisingorpublicitypertainingtothe softwarewithoutspecific,writtenpriorpermission.Titletocopyrightinthissoftwareandanyassociated documentationwillatalltimesremainwithcopyrightholders. LibPNG Version:1.2.5 Description:PNGencoding/decoding SoftwareSite:http://www.libpng.org/pub/png/libpng.html SourceCode:ThesourcepackagesforPNGareavailablefromtheoriginalsoftwaresite,ormaybeacquiredfrom Cambium.ToobtainthesoftwarefromCambium,pleasecontactCambiumusingthemethodsdescribedinthis document. License: Thiscopyofthelibpngnoticesisprovidedforyourconvenience.Incaseofanydiscrepancybetweenthiscopyand thenoticesinthefilepng.hthatisincludedinthelibpngdistribution,thelattershallprevail. COPYRIGHTNOTICE,DISCLAIMER,andLICENSE: Ifyoumodifylibpngyoumayinsertadditionalnoticesimmediatelyfollowingthissentence. libpngversions1.2.6,August15,2004,through1.2.35,February14,2009,areCopyright(c)2004,20062008Glenn RandersPehrson,andaredistributedaccordingtothesamedisclaimerandlicenseaslibpng1.2.5withthe followingindividualaddedtothelistofContributingAuthors: CosminTruta libpngversions1.0.7,July1,2000,through1.2.5October3,2002,areCopyright(c)20002002GlennRanders Pehrson,andaredistributedaccordingtothesamedisclaimerandlicenseaslibpng1.0.6withthefollowing individualsaddedtothelistofContributingAuthors: SimonPierreCadieux EricS.Raymond GillesVollant andwiththefollowingadditionstothedisclaimer: Thereisnowarrantyagainstinterferencewithyourenjoymentofthelibraryoragainstinfringement.Thereis nowarrantythatoureffortsorthelibrarywillfulfillanyofyourparticularpurposesorneeds.Thislibraryis providedwithallfaults,andtheentireriskofsatisfactoryquality,performance,accuracy,andeffortiswith theuser. libpngversions0.97,January1998,through1.0.6,March20,2000,areCopyright(c)1998,1999GlennRanders Pehrson,andaredistributedaccordingtothesamedisclaimerandlicenseaslibpng0.96,withthefollowing individualsaddedtothelistofContributingAuthors: TomLane GlennRandersPehrson WillemvanSchaik libpngversions0.89,June1996,through0.96,May1997,areCopyright(c)1996,1997AndreasDilgerDistributed accordingtothesamedisclaimerandlicenseaslibpng0.88,withthefollowingindividualsaddedtothelistof ContributingAuthors: JohnBowler KevinBracey SamBushell MagnusHolmgren
157
Issue 3 August 2012 GregRoelofs TomTanner
libpngversions0.5,May1995,through0.88,January1996,areCopyright(c)1995,1996GuyEricSchalnat,Group 42,Inc.Forthepurposesofthiscopyrightandlicense,"ContributingAuthors"isdefinedasthefollowingsetof individuals: AndreasDilger DaveMartindale GuyEricSchalnat PaulSchmidt TimWegner ThePNGReferenceLibraryissupplied"ASIS".TheContributingAuthorsandGroup42,Inc.disclaimallwarranties, expressedorimplied,including,withoutlimitation,thewarrantiesofmerchantabilityandoffitnessforany purpose.TheContributingAuthorsandGroup42,Inc.assumenoliabilityfordirect,indirect,incidental,special, exemplary,orconsequentialdamages,whichmayresultfromtheuseofthePNGReferenceLibrary,evenif advisedofthepossibilityofsuchdamage. Permissionisherebygrantedtouse,copy,modify,anddistributethissourcecode,orportionshereof,forany purpose,withoutfee,subjecttothefollowingrestrictions: 1.Theoriginofthissourcecodemustnotbemisrepresented. 2.Alteredversionsmustbeplainlymarkedassuchandmustnotbemisrepresentedasbeingtheoriginalsource. 3.ThisCopyrightnoticemaynotberemovedoralteredfromanysourceoralteredsourcedistribution. TheContributingAuthorsandGroup42,Inc.specificallypermit,withoutfee,andencouragetheuseofthissource codeasacomponenttosupportingthePNGfileformatincommercialproducts.Ifyouusethissourcecodeina product,acknowledgmentisnotrequiredbutwouldbeappreciated. A"png_get_copyright"functionisavailable,forconvenientusein"about"boxesandthelike: printf("%s",png_get_copyright(NULL)); Also,thePNGlogo(inPNGformat,ofcourse)issuppliedinthefiles"pngbar.png"and"pngbar.jpg(88x31)and "pngnow.png"(98x31). LibpngisOSICertifiedOpenSourceSoftware.OSICertifiedOpenSourceisacertificationmarkoftheOpenSource Initiative. GlennRandersPehrson glennrp@users.sourceforge.net February14,2009
Packages That Use GNU Lesser General Public License Version 2.1
ThefollowingninepackagesusetheGNULESSERGENERALPUBLICLICENSE,Version2.1,February1999,whosefull textisprovidedunderGNULesserGeneralPublicLicenseVersion2.1,February1999. jasperreports.jar Version:1.0 Description:JasperReports SoftwareSite:http://sourceforge.net/project/showfiles.php?group_id=36382&package_id=28579 SourceCode:Thesourcepackagesforjasperreports.jarareavailablefromtheoriginalsoftwaresite,ormaybe acquiredfromCambium.ToobtainthesoftwarefromCambium,pleasecontactCambiumusingthemethods describedinthisdocument.
158
Issue 3 August 2012
Jfreechart.jar Version:0.9.15 Description:Chartingtool SoftwareSite:http://sourceforge.net/project/showfiles.php?group_id=15494&package_id=12428 SourceCode:ThesourcepackagesforJfreechart.jarareavailablefromtheoriginalsoftwaresite,ormaybe acquiredfromCambium.ToobtainthesoftwarefromCambium,pleasecontactCambiumusingthemethods describedinthisdocument. bsh1.2b3.jar Version:1.2 Description:Scriptingfiles SoftwareSite:SourcecodenotavailablefromAdventNet SourceCode:Thesourcepackagesforbsh1.2b3.jarareavailablefromtheoriginalsoftwaresite,ormaybe acquiredfromCambium.ToobtainthesoftwarefromCambium,pleasecontactCambiumusingthemethods describedinthisdocument. jvcs.jar Version:2.1 Description:Scriptingtool SoftwareSite:http://www.jcvs.org/download/jcvs/jcvs522.tgz SourceCode:ThesourcepackagesforJvcsareavailablefromtheoriginalsoftwaresite,ormaybeacquiredfrom Cambium.ToobtainthesoftwarefromCambium,pleasecontactCambiumusingthemethodsdescribedinthis document. ftp.jar Version:2.1 Description:FTPpackage SoftwareSite:http://www.enterprisedt.com/downloads/ftp/ftp1.1.tar.gz SourceCode:ThesourcepackagesforFTPareavailablefromtheoriginalsoftwaresite,ormaybeacquiredfrom Cambium.ToobtainthesoftwarefromCambium,pleasecontactCambiumusingthemethodsdescribedinthis document. jcommon Version:1.0.0 Description:GeneralpurposeclassesusedbyJfreechart SoftwareSite:http://www.jfree.org/jcommon/download/ SourceCode:Thesourcepackagesforjcommonareavailablefromtheoriginalsoftwaresite,ormaybeacquired fromCambium.ToobtainthesoftwarefromCambium,pleasecontactCambiumusingthemethodsdescribedin thisdocument. MySQLConnector Version: LinuxMM.MySQL3.0.8 SolarisMM.MySQL3.0.8 WindowsMM.MySQL3.0.8 Description:JDBCDriver SoftwareSite:http://Mysql.com SourceCode:ThesourcepackagesforMySQLConnectorareavailablefromtheoriginalsoftwaresite,ormaybe acquiredfromCambium.ToobtainthesoftwarefromCambium,pleasecontactCambiumusingthemethods describedinthisdocument.
159
Issue 3 August 2012 itext1.02b.jar Version:1.0.2 Description:TextParser SoftwareSite:http://www.lowagie.com/iText/
SourceCode:Thesourcepackagesforitextareavailablefromtheoriginalsoftwaresite,ormaybeacquiredfrom Cambium.ToobtainthesoftwarefromCambium,pleasecontactCambiumusingthemethodsdescribedinthis document. j2sshcommon.jar,j2sshcore.jar(SSHTools) Version:j2ssh0.2.7 Description:SSHTools SoftwareSite:http://sourceforge.net/project/showfiles.php?group_id=60894&package_id=57233 SourceCode:ThesourcepackagesforSSHToolsareavailablefromtheoriginalsoftwaresite,ormaybeacquired fromCambium.ToobtainthesoftwarefromCambium,pleasecontactCambiumusingthemethodsdescribedin thisdocument. GNULesserGeneralPublicLicense Version2.1,February1999 Copyright(C)1991,1999FreeSoftwareFoundation,Inc. 51FranklinStreet,FifthFloor,Boston,MA021101301USA Everyoneispermittedtocopyanddistributeverbatimcopiesofthislicensedocument,butchangingitisnot allowed. [ThisisthefirstreleasedversionoftheLesserGPL.ItalsocountsasthesuccessoroftheGNULibraryPublic License,version2,hencetheversionnumber2.1.] Preamble Thelicensesformostsoftwarearedesignedtotakeawayyourfreedomtoshareandchangeit.Bycontrast,the GNUGeneralPublicLicensesareintendedtoguaranteeyourfreedomtoshareandchangefreesoftwaretomake surethesoftwareisfreeforallitsusers. Thislicense,theLesserGeneralPublicLicense,appliestosomespeciallydesignatedsoftwarepackagestypically librariesoftheFreeSoftwareFoundationandotherauthorswhodecidetouseit.Youcanuseittoo,butwe suggestyoufirstthinkcarefullyaboutwhetherthislicenseortheordinaryGeneralPublicLicenseisthebetter strategytouseinanyparticularcase,basedontheexplanationsbelow. Whenwespeakoffreesoftware,wearereferringtofreedomofuse,notprice.OurGeneralPublicLicensesare designedtomakesurethatyouhavethefreedomtodistributecopiesoffreesoftware(andchargeforthisservice ifyouwish);thatyoureceivesourcecodeorcangetitifyouwantit;thatyoucanchangethesoftwareanduse piecesofitinnewfreeprograms;andthatyouareinformedthatyoucandothesethings. Toprotectyourrights,weneedtomakerestrictionsthatforbiddistributorstodenyyoutheserightsortoaskyou tosurrendertheserights.Theserestrictionstranslatetocertainresponsibilitiesforyouifyoudistributecopiesof thelibraryorifyoumodifyit. Forexample,ifyoudistributecopiesofthelibrary,whethergratisorforafee,youmustgivetherecipientsallthe rightsthatwegaveyou.Youmustmakesurethatthey,too,receiveorcangetthesourcecode.Ifyoulinkother codewiththelibrary,youmustprovidecompleteobjectfilestotherecipients,sothattheycanrelinkthemwith thelibraryaftermakingchangestothelibraryandrecompilingit.Andyoumustshowthemthesetermssothey knowtheirrights. Weprotectyourrightswithatwostepmethod:(1)wecopyrightthelibrary,and(2)weofferyouthislicense, whichgivesyoulegalpermissiontocopy,distributeand/ormodifythelibrary. Toprotecteachdistributor,wewanttomakeitveryclearthatthereisnowarrantyforthefreelibrary.Also,ifthe libraryismodifiedbysomeoneelseandpassedon,therecipientsshouldknowthatwhattheyhaveisnotthe
160
Issue 3 August 2012
originalversion,sothattheoriginalauthor'sreputationwillnotbeaffectedbyproblemsthatmightbeintroduced byothers. Finally,softwarepatentsposeaconstantthreattotheexistenceofanyfreeprogram.Wewishtomakesurethata companycannoteffectivelyrestricttheusersofafreeprogrambyobtainingarestrictivelicensefromapatent holder.Therefore,weinsistthatanypatentlicenseobtainedforaversionofthelibrarymustbeconsistentwith thefullfreedomofusespecifiedinthislicense. MostGNUsoftware,includingsomelibraries,iscoveredbytheordinaryGNUGeneralPublicLicense.Thislicense, theGNULesserGeneralPublicLicense,appliestocertaindesignatedlibraries,andisquitedifferentfromthe ordinaryGeneralPublicLicense.Weusethislicenseforcertainlibrariesinordertopermitlinkingthoselibraries intononfreeprograms. Whenaprogramislinkedwithalibrary,whetherstaticallyorusingasharedlibrary,thecombinationofthetwois legallyspeakingacombinedwork,aderivativeoftheoriginallibrary.TheordinaryGeneralPublicLicensetherefore permitssuchlinkingonlyiftheentirecombinationfitsitscriteriaoffreedom.TheLesserGeneralPublicLicense permitsmorelaxcriteriaforlinkingothercodewiththelibrary. Wecallthislicensethe"Lesser"GeneralPublicLicensebecauseitdoesLesstoprotecttheuser'sfreedomthanthe ordinaryGeneralPublicLicense.ItalsoprovidesotherfreesoftwaredevelopersLessofanadvantageover competingnonfreeprograms.ThesedisadvantagesarethereasonweusetheordinaryGeneralPublicLicensefor manylibraries.However,theLesserlicenseprovidesadvantagesincertainspecialcircumstances. Forexample,onrareoccasions,theremaybeaspecialneedtoencouragethewidestpossibleuseofacertain library,sothatitbecomesadefactostandard.Toachievethis,nonfreeprogramsmustbeallowedtousethe library.Amorefrequentcaseisthatafreelibrarydoesthesamejobaswidelyusednonfreelibraries.Inthiscase, thereislittletogainbylimitingthefreelibrarytofreesoftwareonly,soweusetheLesserGeneralPublicLicense. Inothercases,permissiontouseaparticularlibraryinnonfreeprogramsenablesagreaternumberofpeopleto usealargebodyoffreesoftware.Forexample,permissiontousetheGNUCLibraryinnonfreeprogramsenables manymorepeopletousethewholeGNUoperatingsystem,aswellasitsvariant,theGNU/Linuxoperatingsystem. AlthoughtheLesserGeneralPublicLicenseisLessprotectiveoftheusers'freedom,itdoesensurethattheuserof aprogramthatislinkedwiththeLibraryhasthefreedomandthewherewithaltorunthatprogramusinga modifiedversionoftheLibrary. Theprecisetermsandconditionsforcopying,distributionandmodificationfollow.Paycloseattentiontothe differencebetweena"workbasedonthelibrary"anda"workthatusesthelibrary".Theformercontainscode derivedfromthelibrary,whereasthelattermustbecombinedwiththelibraryinordertorun. TERMSANDCONDITIONSFORCOPYING,DISTRIBUTIONANDMODIFICATION 0.ThisLicenseAgreementappliestoanysoftwarelibraryorotherprogramwhichcontainsanoticeplacedbythe copyrightholderorotherauthorizedpartysayingitmaybedistributedunderthetermsofthisLesserGeneral PublicLicense(alsocalled"thisLicense").Eachlicenseeisaddressedas"you". A"library"meansacollectionofsoftwarefunctionsand/ordatapreparedsoastobeconvenientlylinkedwith applicationprograms(whichusesomeofthosefunctionsanddata)toformexecutables. The"Library",below,referstoanysuchsoftwarelibraryorworkwhichhasbeendistributedundertheseterms.A "workbasedontheLibrary"meanseithertheLibraryoranyderivativeworkundercopyrightlaw:thatistosay,a workcontainingtheLibraryoraportionofit,eitherverbatimorwithmodificationsand/ortranslated straightforwardlyintoanotherlanguage.(Hereinafter,translationisincludedwithoutlimitationintheterm "modification".) "Sourcecode"foraworkmeansthepreferredformoftheworkformakingmodificationstoit.Foralibrary, completesourcecodemeansallthesourcecodeforallmodulesitcontains,plusanyassociatedinterface definitionfiles,plusthescriptsusedtocontrolcompilationandinstallationofthelibrary. Activitiesotherthancopying,distributionandmodificationarenotcoveredbythisLicense;theyareoutsideits scope.TheactofrunningaprogramusingtheLibraryisnotrestricted,andoutputfromsuchaprogramiscovered
161
Issue 3 August 2012
onlyifitscontentsconstituteaworkbasedontheLibrary(independentoftheuseoftheLibraryinatoolfor writingit).WhetherthatistruedependsonwhattheLibrarydoesandwhattheprogramthatusestheLibrary does. 1.YoumaycopyanddistributeverbatimcopiesoftheLibrary'scompletesourcecodeasyoureceiveit,inany medium,providedthatyouconspicuouslyandappropriatelypublishoneachcopyanappropriatecopyrightnotice anddisclaimerofwarranty;keepintactallthenoticesthatrefertothisLicenseandtotheabsenceofany warranty;anddistributeacopyofthisLicensealongwiththeLibrary. Youmaychargeafeeforthephysicalactoftransferringacopy,andyoumayatyouroptionofferwarranty protectioninexchangeforafee. 2.YoumaymodifyyourcopyorcopiesoftheLibraryoranyportionofit,thusformingaworkbasedontheLibrary, andcopyanddistributesuchmodificationsorworkunderthetermsofSection1above,providedthatyoualso meetalloftheseconditions: *a)Themodifiedworkmustitselfbeasoftwarelibrary. *b)Youmustcausethefilesmodifiedtocarryprominentnoticesstatingthatyouchangedthefilesandthe dateofanychange. *c)Youmustcausethewholeoftheworktobelicensedatnochargetoallthirdpartiesunderthetermsof thisLicense. *d)IfafacilityinthemodifiedLibraryreferstoafunctionoratableofdatatobesuppliedbyanapplication programthatusesthefacility,otherthanasanargumentpassedwhenthefacilityisinvoked,thenyoumust makeagoodfaithefforttoensurethat,intheeventanapplicationdoesnotsupplysuchfunctionortable, thefacilitystilloperates,andperformswhateverpartofitspurposeremainsmeaningful. (Forexample,afunctioninalibrarytocomputesquarerootshasapurposethatisentirelywelldefined independentoftheapplication.Therefore,Subsection2drequiresthatanyapplicationsuppliedfunctionortable usedbythisfunctionmustbeoptional:iftheapplicationdoesnotsupplyit,thesquarerootfunctionmuststill computesquareroots.) Theserequirementsapplytothemodifiedworkasawhole.Ifidentifiablesectionsofthatworkarenotderived fromtheLibrary,andcanbereasonablyconsideredindependentandseparateworksinthemselves,thenthis License,anditsterms,donotapplytothosesectionswhenyoudistributethemasseparateworks.Butwhenyou distributethesamesectionsaspartofawholewhichisaworkbasedontheLibrary,thedistributionofthewhole mustbeonthetermsofthisLicense,whosepermissionsforotherlicenseesextendtotheentirewhole,andthus toeachandeverypartregardlessofwhowroteit. Thus,itisnottheintentofthissectiontoclaimrightsorcontestyourrightstoworkwrittenentirelybyyou;rather, theintentistoexercisetherighttocontrolthedistributionofderivativeorcollectiveworksbasedontheLibrary. Inaddition,mereaggregationofanotherworknotbasedontheLibrarywiththeLibrary(orwithaworkbasedon theLibrary)onavolumeofastorageordistributionmediumdoesnotbringtheotherworkunderthescopeofthis License. 3.YoumayopttoapplythetermsoftheordinaryGNUGeneralPublicLicenseinsteadofthisLicensetoagiven copyoftheLibrary.Todothis,youmustalterallthenoticesthatrefertothisLicense,sothattheyrefertothe ordinaryGNUGeneralPublicLicense,version2,insteadoftothisLicense.(Ifanewerversionthanversion2ofthe ordinaryGNUGeneralPublicLicensehasappeared,thenyoucanspecifythatversioninsteadifyouwish.)Donot makeanyotherchangeinthesenotices. Oncethischangeismadeinagivencopy,itisirreversibleforthatcopy,sotheordinaryGNUGeneralPublic Licenseappliestoallsubsequentcopiesandderivativeworksmadefromthatcopy. ThisoptionisusefulwhenyouwishtocopypartofthecodeoftheLibraryintoaprogramthatisnotalibrary. 4.YoumaycopyanddistributetheLibrary(oraportionorderivativeofit,underSection2)inobjectcodeor executableformunderthetermsofSections1and2aboveprovidedthatyouaccompanyitwiththecomplete correspondingmachinereadablesourcecode,whichmustbedistributedunderthetermsofSections1and2 aboveonamediumcustomarilyusedforsoftwareinterchange.
162
Issue 3 August 2012
Ifdistributionofobjectcodeismadebyofferingaccesstocopyfromadesignatedplace,thenofferingequivalent accesstocopythesourcecodefromthesameplacesatisfiestherequirementtodistributethesourcecode,even thoughthirdpartiesarenotcompelledtocopythesourcealongwiththeobjectcode. 5.AprogramthatcontainsnoderivativeofanyportionoftheLibrary,butisdesignedtoworkwiththeLibraryby beingcompiledorlinkedwithit,iscalleda"workthatusestheLibrary".Suchawork,inisolation,isnota derivativeworkoftheLibrary,andthereforefallsoutsidethescopeofthisLicense. However,linkinga"workthatusestheLibrary"withtheLibrarycreatesanexecutablethatisaderivativeofthe Library(becauseitcontainsportionsoftheLibrary),ratherthana"workthatusesthelibrary".Theexecutableis thereforecoveredbythisLicense.Section6statestermsfordistributionofsuchexecutables. Whena"workthatusestheLibrary"usesmaterialfromaheaderfilethatispartoftheLibrary,theobjectcodefor theworkmaybeaderivativeworkoftheLibraryeventhoughthesourcecodeisnot.Whetherthisistrueis especiallysignificantiftheworkcanbelinkedwithouttheLibrary,oriftheworkisitselfalibrary.Thethresholdfor thistobetrueisnotpreciselydefinedbylaw. Ifsuchanobjectfileusesonlynumericalparameters,datastructurelayoutsandaccessors,andsmallmacrosand smallinlinefunctions(tenlinesorlessinlength),thentheuseoftheobjectfileisunrestricted,regardlessof whetheritislegallyaderivativework.(ExecutablescontainingthisobjectcodeplusportionsoftheLibrarywillstill fallunderSection6.) Otherwise,iftheworkisaderivativeoftheLibrary,youmaydistributetheobjectcodefortheworkunderthe termsofSection6.AnyexecutablescontainingthatworkalsofallunderSection6,whetherornottheyarelinked directlywiththeLibraryitself. 6.AsanexceptiontotheSectionsabove,youmayalsocombineorlinka"workthatusestheLibrary"withthe LibrarytoproduceaworkcontainingportionsoftheLibrary,anddistributethatworkundertermsofyourchoice, providedthatthetermspermitmodificationoftheworkforthecustomer'sownuseandreverseengineeringfor debuggingsuchmodifications. YoumustgiveprominentnoticewitheachcopyoftheworkthattheLibraryisusedinitandthattheLibraryandits usearecoveredbythisLicense.YoumustsupplyacopyofthisLicense.Iftheworkduringexecutiondisplays copyrightnotices,youmustincludethecopyrightnoticefortheLibraryamongthem,aswellasareference directingtheusertothecopyofthisLicense.Also,youmustdooneofthesethings: *a)AccompanytheworkwiththecompletecorrespondingmachinereadablesourcecodefortheLibrary includingwhateverchangeswereusedinthework(whichmustbedistributedunderSections1and2above); and,iftheworkisanexecutablelinkedwiththeLibrary,withthecompletemachinereadable"workthatuses theLibrary",asobjectcodeand/orsourcecode,sothattheusercanmodifytheLibraryandthenrelinkto produceamodifiedexecutablecontainingthemodifiedLibrary.(Itisunderstoodthattheuserwhochanges thecontentsofdefinitionsfilesintheLibrarywillnotnecessarilybeabletorecompiletheapplicationtouse themodifieddefinitions.) *b)UseasuitablesharedlibrarymechanismforlinkingwiththeLibrary.Asuitablemechanismisonethat(1) usesatruntimeacopyofthelibraryalreadypresentontheuser'scomputersystem,ratherthancopying libraryfunctionsintotheexecutable,and(2)willoperateproperlywithamodifiedversionofthelibrary,if theuserinstallsone,aslongasthemodifiedversionisinterfacecompatiblewiththeversionthatthework wasmadewith. *c)Accompanytheworkwithawrittenoffer,validforatleastthreeyears,togivethesameuserthe materialsspecifiedinSubsection6a,above,forachargenomorethanthecostofperformingthis distribution. *d)Ifdistributionoftheworkismadebyofferingaccesstocopyfromadesignatedplace,offerequivalent accesstocopytheabovespecifiedmaterialsfromthesameplace. *e)Verifythattheuserhasalreadyreceivedacopyofthesematerialsorthatyouhavealreadysentthisuser acopy.
163
Issue 3 August 2012
Foranexecutable,therequiredformofthe"workthatusestheLibrary"mustincludeanydataandutility programsneededforreproducingtheexecutablefromit.However,asaspecialexception,thematerialstobe distributedneednotincludeanythingthatisnormallydistributed(ineithersourceorbinaryform)withthemajor components(compiler,kernel,andsoon)oftheoperatingsystemonwhichtheexecutableruns,unlessthat componentitselfaccompaniestheexecutable. Itmayhappenthatthisrequirementcontradictsthelicenserestrictionsofotherproprietarylibrariesthatdonot normallyaccompanytheoperatingsystem.SuchacontradictionmeansyoucannotuseboththemandtheLibrary togetherinanexecutablethatyoudistribute. 7.YoumayplacelibraryfacilitiesthatareaworkbasedontheLibrarysidebysideinasinglelibrarytogetherwith otherlibraryfacilitiesnotcoveredbythisLicense,anddistributesuchacombinedlibrary,providedthatthe separatedistributionoftheworkbasedontheLibraryandoftheotherlibraryfacilitiesisotherwisepermitted,and providedthatyoudothesetwothings: *a)AccompanythecombinedlibrarywithacopyofthesameworkbasedontheLibrary,uncombinedwith anyotherlibraryfacilities.ThismustbedistributedunderthetermsoftheSectionsabove. *b)GiveprominentnoticewiththecombinedlibraryofthefactthatpartofitisaworkbasedontheLibrary, andexplainingwheretofindtheaccompanyinguncombinedformofthesamework. 8.Youmaynotcopy,modify,sublicense,linkwith,ordistributetheLibraryexceptasexpresslyprovidedunderthis License.Anyattemptotherwisetocopy,modify,sublicense,linkwith,ordistributetheLibraryisvoid,andwill automaticallyterminateyourrightsunderthisLicense.However,partieswhohavereceivedcopies,orrights,from youunderthisLicensewillnothavetheirlicensesterminatedsolongassuchpartiesremaininfullcompliance. 9.YouarenotrequiredtoacceptthisLicense,sinceyouhavenotsignedit.However,nothingelsegrantsyou permissiontomodifyordistributetheLibraryoritsderivativeworks.Theseactionsareprohibitedbylawifyoudo notacceptthisLicense.Therefore,bymodifyingordistributingtheLibrary(oranyworkbasedontheLibrary),you indicateyouracceptanceofthisLicensetodoso,andallitstermsandconditionsforcopying,distributingor modifyingtheLibraryorworksbasedonit. 10.EachtimeyouredistributetheLibrary(oranyworkbasedontheLibrary),therecipientautomaticallyreceivesa licensefromtheoriginallicensortocopy,distribute,linkwithormodifytheLibrarysubjecttothesetermsand conditions.Youmaynotimposeanyfurtherrestrictionsontherecipients'exerciseoftherightsgrantedherein. YouarenotresponsibleforenforcingcompliancebythirdpartieswiththisLicense. 11.If,asaconsequenceofacourtjudgmentorallegationofpatentinfringementorforanyotherreason(not limitedtopatentissues),conditionsareimposedonyou(whetherbycourtorder,agreementorotherwise)that contradicttheconditionsofthisLicense,theydonotexcuseyoufromtheconditionsofthisLicense.Ifyoucannot distributesoastosatisfysimultaneouslyyourobligationsunderthisLicenseandanyotherpertinentobligations, thenasaconsequenceyoumaynotdistributetheLibraryatall.Forexample,ifapatentlicensewouldnotpermit royaltyfreeredistributionoftheLibrarybyallthosewhoreceivecopiesdirectlyorindirectlythroughyou,thenthe onlywayyoucouldsatisfybothitandthisLicensewouldbetorefrainentirelyfromdistributionoftheLibrary. Ifanyportionofthissectionisheldinvalidorunenforceableunderanyparticularcircumstance,thebalanceofthe sectionisintendedtoapply,andthesectionasawholeisintendedtoapplyinothercircumstances. Itisnotthepurposeofthissectiontoinduceyoutoinfringeanypatentsorotherpropertyrightclaimsorto contestvalidityofanysuchclaims;thissectionhasthesolepurposeofprotectingtheintegrityofthefreesoftware distributionsystemwhichisimplementedbypubliclicensepractices.Manypeoplehavemadegenerous contributionstothewiderangeofsoftwaredistributedthroughthatsysteminrelianceonconsistentapplication ofthatsystem;itisuptotheauthor/donortodecideifheorsheiswillingtodistributesoftwarethroughanyother systemandalicenseecannotimposethatchoice. ThissectionisintendedtomakethoroughlyclearwhatisbelievedtobeaconsequenceoftherestofthisLicense. 12.Ifthedistributionand/oruseoftheLibraryisrestrictedincertaincountrieseitherbypatentsorbycopyrighted interfaces,theoriginalcopyrightholderwhoplacestheLibraryunderthisLicensemayaddanexplicitgeographical distributionlimitationexcludingthosecountries,sothatdistributionispermittedonlyinoramongcountriesnot thusexcluded.Insuchcase,thisLicenseincorporatesthelimitationasifwritteninthebodyofthisLicense.
164
Issue 3 August 2012
13.TheFreeSoftwareFoundationmaypublishrevisedand/ornewversionsoftheLesserGeneralPublicLicense fromtimetotime.Suchnewversionswillbesimilarinspirittothepresentversion,butmaydifferindetailto addressnewproblemsorconcerns. Eachversionisgivenadistinguishingversionnumber.IftheLibraryspecifiesaversionnumberofthisLicense whichappliestoitand"anylaterversion",youhavetheoptionoffollowingthetermsandconditionseitherofthat versionorofanylaterversionpublishedbytheFreeSoftwareFoundation.IftheLibrarydoesnotspecifyalicense versionnumber,youmaychooseanyversioneverpublishedbytheFreeSoftwareFoundation. 14.IfyouwishtoincorporatepartsoftheLibraryintootherfreeprogramswhosedistributionconditionsare incompatiblewiththese,writetotheauthortoaskforpermission.ForsoftwarewhichiscopyrightedbytheFree SoftwareFoundation,writetotheFreeSoftwareFoundation;wesometimesmakeexceptionsforthis.Our decisionwillbeguidedbythetwogoalsofpreservingthefreestatusofallderivativesofourfreesoftwareandof promotingthesharingandreuseofsoftwaregenerally. NOWARRANTY 15.BECAUSETHELIBRARYISLICENSEDFREEOFCHARGE,THEREISNOWARRANTYFORTHELIBRARY,TOTHE EXTENTPERMITTEDBYAPPLICABLELAW.EXCEPTWHENOTHERWISESTATEDINWRITINGTHECOPYRIGHT HOLDERSAND/OROTHERPARTIESPROVIDETHELIBRARY"ASIS"WITHOUTWARRANTYOFANYKIND,EITHER EXPRESSEDORIMPLIED,INCLUDING,BUTNOTLIMITEDTO,THEIMPLIEDWARRANTIESOFMERCHANTABILITYAND FITNESSFORAPARTICULARPURPOSE.THEENTIRERISKASTOTHEQUALITYANDPERFORMANCEOFTHELIBRARY ISWITHYOU.SHOULDTHELIBRARYPROVEDEFECTIVE,YOUASSUMETHECOSTOFALLNECESSARYSERVICING, REPAIRORCORRECTION. 16.INNOEVENTUNLESSREQUIREDBYAPPLICABLELAWORAGREEDTOINWRITINGWILLANYCOPYRIGHT HOLDER,ORANYOTHERPARTYWHOMAYMODIFYAND/ORREDISTRIBUTETHELIBRARYASPERMITTEDABOVE, BELIABLETOYOUFORDAMAGES,INCLUDINGANYGENERAL,SPECIAL,INCIDENTALORCONSEQUENTIAL DAMAGESARISINGOUTOFTHEUSEORINABILITYTOUSETHELIBRARY(INCLUDINGBUTNOTLIMITEDTOLOSSOF DATAORDATABEINGRENDEREDINACCURATEORLOSSESSUSTAINEDBYYOUORTHIRDPARTIESORAFAILUREOF THELIBRARYTOOPERATEWITHANYOTHERSOFTWARE),EVENIFSUCHHOLDEROROTHERPARTYHASBEEN ADVISEDOFTHEPOSSIBILITYOFSUCHDAMAGES. ENDOFTERMSANDCONDITIONS HowtoApplyTheseTermstoYourNewLibraries Ifyoudevelopanewlibrary,andyouwantittobeofthegreatestpossibleusetothepublic,werecommend makingitfreesoftwarethateveryonecanredistributeandchange.Youcandosobypermittingredistribution undertheseterms(or,alternatively,underthetermsoftheordinaryGeneralPublicLicense). Toapplytheseterms,attachthefollowingnoticestothelibrary.Itissafesttoattachthemtothestartofeach sourcefiletomosteffectivelyconveytheexclusionofwarranty;andeachfileshouldhaveatleastthe"copyright" lineandapointertowherethefullnoticeisfound. onelinetogivethelibrary'snameandanideaofwhatitdoes. Copyright(C)yearnameofauthor Thislibraryisfreesoftware;youcanredistributeitand/ormodifyitunderthetermsoftheGNULesserGeneral PublicLicenseaspublishedbytheFreeSoftwareFoundation;eitherversion2.1oftheLicense,or(atyouroption) anylaterversion. Thislibraryisdistributedinthehopethatitwillbeuseful,butWITHOUTANYWARRANTY;withouteventhe impliedwarrantyofMERCHANTABILITYorFITNESSFORAPARTICULARPURPOSE.SeetheGNULesserGeneral PublicLicenseformoredetails. YoushouldhavereceivedacopyoftheGNULesserGeneralPublicLicensealongwiththislibrary;ifnot,writeto theFreeSoftwareFoundation,Inc.,51FranklinStreet,FifthFloor,Boston,MA021101301USA Alsoaddinformationonhowtocontactyoubyelectronicandpapermail.
165
Issue 3 August 2012
Youshouldalsogetyouremployer(ifyouworkasaprogrammer)oryourschool,ifany,tosigna"copyright disclaimer"forthelibrary,ifnecessary.Hereisasample;alterthenames: Yoyodyne,Inc.,herebydisclaimsallcopyrightinterestin thelibrary`Frob'(alibraryfortweakingknobs)writtenbyJamesRandomHacker. signatureofTyCoon,1April1990 TyCoon,PresidentofVice That'sallthereistoit!

Packages That Use Apache Software License Version 1.1
ThefollowingfourpackagesusetheApacheSoftwareLicense,Version1.1,20012003,whosefulltextis providedunderApacheSoftwareLicenseVersion1.1. Log4j Version:1.2.12 Description:LogFramework SoftwareSite:http://logging.apache.org/log4j/1.2/index.html SourceCode:ThesourcepackagesforLog4jareavailablefromtheoriginalsoftwaresite,ormaybeacquiredfrom Cambium.ToobtainthesoftwarefromCambium,pleasecontactCambiumusingthemethodsdescribedinthis document. Struts Version:1.1 Description:WebFramework SoftwareSite:http://www.apache.org/dist/jakarta/struts/binaries/jakartastruts1.1.zip http://www.ibiblio.org/pub/packages/infosystems/WWW/servers/apache/jakarta/struts/binaries/jakartastruts 1.1rc1.zip SourceCode:ThesourcepackagesforStrutsareavailablefromtheoriginalsoftwaresite,ormaybeacquiredfrom Cambium.ToobtainthesoftwarefromCambium,pleasecontactCambiumusingthemethodsdescribedinthis document. Apache Version:2.0.47 Description:TheApacheHTTPServerprovidesasecure,efficientandextensibleserverthatprovidesHTTP servicesinsyncwiththecurrentHTTPstandards. SoftwareSite:http://www.apache.org/dist/httpd/ SourceCode:ThesourcepackagesforApacheareavailablefromtheoriginalsoftwaresite,ormaybeacquired fromCambium.ToobtainthesoftwarefromCambium,pleasecontactCambiumusingthemethodsdescribedin thisdocument. TomCat Version:4.1.27 Description:ApacheTomcatisanimplementationoftheJavaServletandJavaServerPagestechnologies.TheJava ServletandJavaServerPagesspecificationsaredevelopedundertheJavaCommunityProcess. SoftwareSite:http://tomcat.apache.org/download41.cgi SourceCode:ThesourcepackagesforTomCatareavailablefromtheoriginalsoftwaresite,ormaybeacquired fromCambium.ToobtainthesoftwarefromCambium,pleasecontactCambiumusingthemethodsdescribedin thisdocument.
166
Issue 3 August 2012
ApacheSoftwareLicense Version1.1 Copyright(c)20012003AntContribproject.Allrightsreserved. Redistributionanduseinsourceandbinaryforms,withorwithoutmodification,arepermittedprovidedthatthe followingconditionsaremet: 1.Redistributionsofsourcecodemustretaintheabovecopyrightnotice,thislistofconditionsandthefollowing disclaimer. 2.Redistributionsinbinaryformmustreproducetheabovecopyrightnotice,thislistofconditionsandthe followingdisclaimerinthedocumentationand/orothermaterialsprovidedwiththedistribution. 3.Theenduserdocumentationincludedwiththeredistribution,ifany,mustincludethefollowing acknowledgment: "ThisproductincludessoftwaredevelopedbytheAntContribproject (http://sourceforge.net/projects/antcontrib)."Alternately,thisacknowledgmentmayappearinthesoftware itself,ifandwhereversuchthirdpartyacknowledgmentsnormallyappear. 4.ThenameAntContribmustnotbeusedtoendorseorpromoteproductsderivedfromthissoftwarewithout priorwrittenpermission.Forwrittenpermission,pleasecontactantcontribdevelopers@lists.sourceforge.net. 5.Productsderivedfromthissoftwaremaynotbecalled"AntContrib"normay"AntContrib"appearintheir nameswithoutpriorwrittenpermissionoftheAntContribproject. THISSOFTWAREISPROVIDED`ÀSIS''ANDANYEXPRESSEDORIMPLIEDWARRANTIES,INCLUDING,BUTNOT LIMITEDTO,THEIMPLIEDWARRANTIESOFMERCHANTABILITYANDFITNESSFORAPARTICULARPURPOSEARE DISCLAIMED.INNOEVENTSHALLTHEANTCONTRIBPROJECTORITSCONTRIBUTORSBELIABLEFORANYDIRECT, INDIRECT,INCIDENTAL,SPECIAL,EXEMPLARY,ORCONSEQUENTIALDAMAGES(INCLUDING,BUTNOTLIMITEDTO, PROCUREMENTOFSUBSTITUTEGOODSORSERVICES;LOSSOFUSE,DATA,ORPROFITS;ORBUSINESS INTERRUPTION)HOWEVERCAUSEDANDONANYTHEORYOFLIABILITY,WHETHERINCONTRACT,STRICTLIABILITY, ORTORT(INCLUDINGNEGLIGENCEOROTHERWISE)ARISINGINANYWAYOUTOFTHEUSEOFTHISSOFTWARE, EVENIFADVISEDOFTHEPOSSIBILITYOFSUCHDAMAGE.
167
Issue 3 August 2012
Abbreviations
API DHCP DNS EMS GUI IP JDBC MAC ApplicationProgrammingInterface DynamicHostConfigurationProtocol DomainNameServer ElementManagementSystem GraphicalUserInterface InternetProtocol JavadatabaseConnectivity MediaAccessControl
WMSDB WirelessManagerDatabase MIB NBI NMI NMS OID RDBMS SMI SNMP UDP UI VLAN ManagementInformationBase NorthBoundInterface NetworkManagementInformation(Server) NetworkManagementSystem ObjectIdentifier RelationalDatabaseManagementSystem StructureManagementInformation SimpleNetworkManagementProtocol UserDatagramProtocol UserInterface VirtualLocalAreaNetwork
169
Issue 3 August 2012
Technical Support
BeforeyoucontacttheCambiumNetworkssupportrepresentatives,itistypicallyadvisabletorunthe SupportToolandavoiddeletinganyofthefilesthatitgenerates.Afteryourunthetoolandattempt tosolvetheproblembyusingthedocumentationandthetroubleshootingmethodsthatits proceduresanddescriptionsimply,youcancontactyourdesignatedrepresentativeasindicatedin ContactingSupportRepresentativesonPage172.
Running the Customer Support Tool

WMprovidesatoolforusersontheclientapplicationortheadministratorontheservertolaunch whentroubleexceedslocaldiagnosticefforts.Thistoolassemblesintooneormoreencryptablefiles mostoftheinformationthatSupportrepresentativesrequiretodiagnosetypicalproblems encounteredinWMoperations.Thetoolalsoallowstheoperatortosplitthefileto enabletransmittaloffilesthatthetooloutputsaslargerthan1.5MB. speeduptransmittaloffilesthatarebetween1and1.5MBinsize.
Options for Running the Support Tool

DependingonwhetherthetoolislaunchedfromtheclientapplicationortheWMserver,thedata mayinclude variousWMlogfiles. licensefilecontentsandusage,ifWMandLicenseManagerrunonthesamemachine. theplatformandenvironmentonwhichtheWMserveroperates. devicetemplates,includinganythatwerelocallycreatedormodified. WMconfiguration(allxml)files. installationlogs. theidentificationofallrunningprocesses. individualdevicedataforselecteddevices. additionalinformationthatyouvoluntarilyenterintheinterfacetothetool.
Ifthetoolislaunchedfromboththeclientandtheserver,thenthecompositeofthedatafilesthat thetoolproducescanincludealloftheabovelistedinformation.Bydefault,thetoolstoresthe outputinthefilesystemoftheserverdevice.
Running the Tool from the Server

Whenrunfromtheserver(byexecutingC:\Cambium\WM\server\bin\SupportTool.bator /usr/local/cambium/WM/server/bin/SupportTool.sh),thetooldoesnotcollectinformation fromthedatabase.Typically,thisisrecommendedonlywhentheserverprocessisnotrunning.The resultingdataislimitedtoinformationabouttheenvironment,WMconfigurationfiles,andextra logs.However,theserveradministratorcanattachadditional,locallywrittenscriptsinVisualBasic,
171
Issue 3 August 2012
Perl,shell,andorSQLbyaddingtheirfilenamestoanexternalscriptslistintheserver.Thisis especiallyusefulunderthedirectionofaCambiumNetworkssupportrepresentative. Instructionsforrunningthetoolfromtheclientapplicationareprovidedintheuserguidesection titled"TechnicalSupport."
Contacting Support Representatives

YoucanobtainsupportforWirelessManagerfromanyorallofthefollowingsources: WirelessManagersetupguide,administrationguide,andreleasenotes. CambiumNetworkssupportwebpage:http://www.cambiumnetworks.com/support. Thispageprovideslinkstoinformationonallproductsandtools,aswellasaccessto customersupportmaterialsandinteractivesupportforums.Someoftheseresourcesare restrictedtoregisteredusersandchannelpartners.
theCommunityForum.Visithttp://www.cambiumnetworks.com/forum/. 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.
172

WM4 0ServerAdministrationGuideIssue3

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

WM4 0ServerAdministrationGuideIssue3

Uploaded by

Copyright:

Available Formats

Cambium Wireless Manager Server Administration Guide

System Release 4.0

Issue 3 August 2012 2012 Cambium Networks. All Rights Reserved.

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

ThesoftwaredescribedinthisdocumentisthepropertyofCambiumanditslicensors.Itisfurnishedbyexpress licenseagreementonlyandmaybeusedonlyinaccordancewiththetermsofsuchanagreement.SeeLegal NoticesandLicenseAgreementsonPage137. 2012CambiumNetworks,Inc.AllRightsReserved.

About This Administration Guide ....................................................................13

Management of the WM Server Device ............................................................19

MySQL Database Administration .....................................................................25

Network Discovery Setup and Debug...............................................................31

4.2 4.3 4.4

TemporarilyDisablingUpdatestothePhysicalMaptoSpeedUpDiscovery .............. 32 GettingGenericElementsDiscovered .......................................................................... 33 ExpandingorShrinkingAreasforPresumedLogicalRelationships.............................. 34

OpeningTrapPorts ....................................................................................................... 39 EnablingPrintforEventsandAlarms ........................................................................... 39

Performance Management Configuration ..........................................................47

Security Management Configuration.................................................................55

Offline Physical Map Setup .............................................................................63

Optimization of WM Server Performance ......................................................67

WM Software and Feature Licensing .............................................................95

14.6.1 14.6.2 14.6.3

WorkaroundforaLicenseServerFailure ................................................................... 101

14.7.1 14.7.2 14.7.3

WM Administrator Tool for Server Administration ........................................103

MIB Browser Usage..................................................................................115

16.2.1 16.2.2 16.2.3 16.2.4 16.2.5 16.2.6 16.2.7 16.2.8

InterpretingMIBBrowserErrorMessages ................................................................. 129 FAQs ............................................................................................................................ 134

Legal Notices and License Agreements .................................................................137

Abbreviations ....................................................................................................169 Technical Support..............................................................................................171

WM Release 4.0 Server Administration Guide

Issue 3 August 2012

1 About This Administration Guide

serverlogs licensingandupgradingWMsoftware backingupthesystem usingtheMIBbrowser

Issue 3 August 2012

WM Release 4.0 Server Administration Guide

New in This Issue

Features New in Release 4.0

Corrections in This Guide

WM Release 4.0 Server Administration Guide

Issue 3 August 2012

Issue 3 August 2012 Chapter10,OptimizationofWMServerPerformance

WM Release 4.0 Server Administration Guide

providesspecificMySQLdatabaseconfiguration parametervaluesthatarerecommendedforall operatorsandstronglyrecommendedfor operatorswhomanagelargenetworks,andalso describeshowtolimitidleclienttimeby configuringautomaticlockupsandterminations forsessionsthatareidletoolong.

References to Other WM Documents

WM Release 4.0 Server Administration Guide

Issue 3 August 2012

Links to Other Important Documents

Forlinkstonetworkelementfeaturesandspecifications,visitthefollowingwebpages. CambiumPTPandCambiumNetworksLINKPlannerat http://cambiumnetworks.com/support/ptp/software/index.php CambiumPMPathttp://cambiumnetworks.com/support/pmp/software/index.php

Feedback on This Guide

References to Starting and Stopping the WM Service

WM Release 4.0 Server Administration Guide

Issue 3 August 2012

2 Management of the WM Server Device

Local Setup for Launches of Included Tools

Procedure 1: To set up Windows to allow all Administrators to launch WM tools

Issue 3 August 2012

WM Release 4.0 Server Administration Guide

Table 1: Ports that must be open

3306 QueriestotheMySQLdatabase. 6900 InboundTCPforTFTPconnectionsinthefirmwareupgradeprocess. 8003

OutboundUDPforSNMPresponseoverthenorthboundinterface (NBI). TCPconnectionsbyTomcatandwebserverforaccesstodevice managementwebpages.2

8090 InbounddatafromtheBAMserver. 9090 InboundTCPforthewebserver. 32900

NMSSocketforTCPcommunicationbetweentheWMserverand WMclient.3 NMSFESecondaryforTCPcommunicationbetweentheWMserver andWMclient.4

61001 OutboundUDPfromBAMtoAPs. 27000 WMtorequestlicenses.

WM Release 4.0 Server Administration Guide

Issue 3 August 2012 Usage

OptionalOracleJavaNamingandDirectoryInterface(JNDI) connectionpoolviaTomcat. CommunicationsbetweenWMandthewebadministrationinterface ofGeoServer.

Deleteallexistingtablespacefilesfromthisfolder,includingtheibdataandib_log files. IfyouwanttoretaincopiesofthedatabasefoldersthatcorrespondtotheWMdatabase(s) thatyoubackedupwiththemysqldumpcommandinStep4,copythemtoportablemedia.