WM 4.1 Server Administration Guide - Amazon...

Cambium Wireless Manager Server Administration Guide System Release 4.1

Issue 1 June 2014 2014 Cambium Networks. All Rights Reserved.

Accuracy

Whilereasonableeffortshavebeenmadetoassuretheaccuracyofthisdocument,CambiumNetworksassumesnoliabilityresultingfromanyinaccuraciesoromissionsinthisdocument,orfromuseoftheinformationobtainedherein.Cambiumreservestherighttomakechangestoanyproductsdescribedhereintoimprovereliability,function,ordesign,andreservestherighttorevisethisdocumentandtomakechangesfromtimetotimeincontenthereofwithnoobligationtonotifyanypersonofrevisionsorchanges.Cambiumdoesnotassumeanyliabilityarisingoutoftheapplicationoruseofanyproduct,software,orcircuitdescribedherein;neitherdoesitconveylicenseunderitspatentrightsortherightsofothers.Itispossiblethatthispublicationmaycontainreferencesto,orinformationaboutCambiumproducts(machinesandprograms),programming,orservicesthatarenotannouncedinyourcountry.SuchreferencesorinformationmustnotbeconstruedtomeanthatCambiumintendstoannouncesuchCambiumproducts,programming,orservicesinyourcountry.

Copyrights

Thisdocument,Cambiumproducts,and3rdPartySoftwareproductsdescribedinthisdocumentmayincludeordescribecopyrightedCambiumandother3rdPartysuppliedcomputerprogramsstoredinsemiconductormemoriesorothermedia.LawsintheUnitedStatesandothercountriespreserveforCambium,itslicensors,andother3rdPartysuppliedsoftwarecertainexclusiverightsforcopyrightedmaterial,includingtheexclusiverighttocopy,reproduceinanyform,distributeandmakederivativeworksofthecopyrightedmaterial.Accordingly,anycopyrightedmaterialofCambium,itslicensors,orthe3rdPartysoftwaresuppliedmaterialcontainedintheCambiumproductsdescribedinthisdocumentmaynotbecopied,reproduced,reverseengineered,distributed,mergedormodifiedinanymannerwithouttheexpresswrittenpermissionofCambium.Furthermore,thepurchaseofCambiumproductsshallnotbedeemedtogranteitherdirectlyorbyimplication,estoppel,orotherwise,anylicenseunderthecopyrights,patentsorpatentapplicationsofCambiumorother3rdPartysuppliedsoftware,exceptforthenormalnonexclusive,royaltyfreelicensetousethatarisesbyoperationoflawinthesaleofaproduct.

Restrictions

Softwareanddocumentationarecopyrightedmaterials.Makingunauthorizedcopiesisprohibitedbylaw.Nopartofthesoftwareordocumentationmaybereproduced,transmitted,transcribed,storedinaretrievalsystem,ortranslatedintoanylanguageorcomputerlanguage,inanyformorbyanymeans,withoutpriorwrittenpermissionofCambium.

License Agreements

ThesoftwaredescribedinthisdocumentisthepropertyofCambiumanditslicensors.Itisfurnishedbyexpresslicenseagreementonlyandmaybeusedonlyinaccordancewiththetermsofsuchanagreement.SeeLegalNoticesandLicenseAgreementsonPage155.

2014CambiumNetworks,Inc.AllRightsReserved.

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

1 About This Administration Guide ....................................................................15

1.1 FeaturesNewinRelease4.1......................................................................................... 16 1.2 ContentNewinThisGuide ........................................................................................... 16 1.3 Chapters........................................................................................................................ 16 1.4 ReferencestoOtherWMDocuments .......................................................................... 18 1.5 LinkstoOtherImportantDocuments........................................................................... 18 1.6 FeedbackonThisGuide................................................................................................ 19 1.7 ReferencestoStartingandStoppingtheWMService ................................................. 19

2 Management of the WM Server Device ............................................................21

2.1 ServerRequirements .................................................................................................... 21 2.1.1 ServerHardwareRequirements............................................................................................ 21 2.1.2 ServerSoftwareRequirements ............................................................................................. 22

2.2 ClientRequirements ..................................................................................................... 23 2.2.1 ClientHardwareRequirements............................................................................................. 23 2.2.2 ClientSoftwareRequirements .............................................................................................. 23

2.3 LocalSetupforLaunchesofIncludedTools ................................................................. 24 2.4 PortManagement......................................................................................................... 25 2.5 NetworkInterfaceManagement .................................................................................. 27 2.6 MemoryManagement.................................................................................................. 28 2.7 IPAddressChangefortheWMServer ......................................................................... 29

2.7.1 AddressChangefortheServerinLinux ................................................................................ 29 2.7.2 AddressChangefortheServerinWindows.......................................................................... 29

2.8 UseofanUninterruptiblePowerSupply...................................................................... 30 2.9 Placementofpkg3FilesforNetworkElementUpgrades............................................. 30

3 MySQL Database Administration .....................................................................31

3.1 ChangingtheDatabaseAuthenticationinWM............................................................ 31 3.2 StartingtheDatabase ................................................................................................... 31 3.3 ReinitializingtheDatabase .......................................................................................... 31

3.4 RestoringtheWMDefaultDatabaseConfiguration..................................................... 32 3.5 BackingUptheEntireDatabase ................................................................................... 32 3.6 RestoringtheEntireDatabase...................................................................................... 33 3.7 MaintainingtheIntegrityoftheDatabase ................................................................... 33

3.7.1 AddressingTableCorruptiononaLinuxPlatform ................................................................ 33 3.7.2 AddressingContinuousGrowthofDataFilesonaWindowsPlatform................................. 34

3.8 RepairingaCrashedTable ............................................................................................ 35 3.8.1 RepairingaTableinLinux...................................................................................................... 36 3.8.2 RepairingaTableinWindows............................................................................................... 37

3.9 TuningtheDatabaseAttributesforOptimalUseofServerResources ........................ 38

4 Network Discovery Setup and Debug...............................................................41

4.1 ReadingDiscoveryDebugMessages ............................................................................ 41 4.2 TemporarilyDisablingUpdatestothePhysicalMaptoSpeedUpDiscovery .............. 42 4.3 GettingGenericElementsDiscovered.......................................................................... 43 4.4 ExpandingorShrinkingAreasforPresumedLogicalRelationships.............................. 43

5 Predefined Information Structures for Device Support ........................................47

6 Fault Management Configuration .....................................................................49

6.1 OpeningTrapPorts ....................................................................................................... 49 6.2 EnablingPrintforEventsandAlarms ........................................................................... 49

6.2.1 EnablingPrintinWindows .................................................................................................... 50 6.2.2 EnablingPrintinLinux ........................................................................................................... 51 6.2.3 EnhancingthePrintedOutput .............................................................................................. 51

6.3 ConfiguringFaultManagementParameters ................................................................ 51

7 Performance Management Configuration ..........................................................57

7.1 ManagedObjects.......................................................................................................... 57 7.2 OperatordefinedReports ............................................................................................ 60 7.3 CollectedStatisticsPlotforPollFailure ........................................................................ 61

8 Security Management Configuration.................................................................63

8.1 DefiningandManagingaGrouporaUser ................................................................... 63 8.2 DefiningandManagingAuthorizedandCustomViewScopes .................................... 64 8.3 AddingandManagingOperations ................................................................................ 64 8.4 EnablingtheAuthorizedModeforSecurityOperations .............................................. 64 8.5 ConfiguringSecurityManagementParameters ........................................................... 66 8.6 ConfiguringPasswordComplexity ................................................................................ 66

8.7 EnforcingaPasswordChangeRequirement................................................................. 67 8.8 EnforcingOneSessionperUser.................................................................................... 68 8.9 ManagingExpiryforUserAccountsandPasswords..................................................... 68 8.10 RestoringaDeletedsuperuserAccount ....................................................................... 68

9 Offline Physical Map Setup .............................................................................71

9.1 DeployingGeoServer .................................................................................................... 71 9.2 CreatingMapLayers ..................................................................................................... 72

9.2.1 Creatingalayerfromanimagefile ....................................................................................... 72 9.2.2 Creatingalayerfromashapefile ......................................................................................... 74

9.3 PrecachingtheMapImages ........................................................................................ 79 9.4 ChangingtheMaximumZoomLevel ............................................................................ 80

10 Optimization of WM Server Performance ......................................................81

10.1 OptimizingMySQLDatabasePerformance .................................................................. 81 10.2 LockingandTerminatingIdleClientSessions............................................................... 82

11 User Scripts Setup .....................................................................................83

12 Management of WM Server Logs..................................................................85

13 WM Software Upgrades and Downgrades......................................................87

13.1 WMUpgradetoRelease4.1......................................................................................... 87 13.2 MigrationofOperatorDataThroughWMUpgradePlusOSUpgrade......................... 98 13.3 ServicePackorFeaturePackInstallation ..................................................................... 99 13.4 ServicePackorFeaturePackUninstallation............................................................... 103 13.5 WMDowngradefromRelease4.1 ............................................................................. 105

14 WM Software and Feature Licensing ...........................................................111

14.1 LicenseTypes .............................................................................................................. 111 14.2 CalculationoftheNumberofNodestobeLicensed.................................................. 111 14.3 NotificationsofLicenseLimits .................................................................................... 112 14.4 WMLicenseReplacement .......................................................................................... 112 14.5 RecoveryFromForgottenPasswordfortheLicenseManagerAdministratorTool... 112 14.6 DeploymentofRedundantLicenseManagerServers ................................................ 114

14.6.1 PurposeofRedundancy .................................................................................................. 114 14.6.2 ConfigurationofLicenseKeyFilesforRedundancy........................................................ 114 14.6.3 RedundancyDeploymentProcess .................................................................................. 115

14.7 WorkaroundforaLicenseServerFailure ................................................................... 118

14.7.1 FailureorRebootofaLicenseManagerServer.............................................................. 118 14.7.2 ChangeintheIPAddressofaLicenseManagerServer.................................................. 118 14.7.3 ServerRestartsinLMRedundancy ................................................................................. 118

15 WM Administrator Tool for Server Administration ........................................119

15.1 UsingtheWMServerPanel ........................................................................................ 119 15.2 ConfiguringtheBAMPanel......................................................................................... 122 15.3 ConfiguringtheDatabasePanel ................................................................................. 123 15.4 UsingtheLicensingPanel ........................................................................................... 124 15.5 ConfiguringtheNBIPanel........................................................................................... 127 15.6 UsingtheOfflinePhysicalMapPanel ......................................................................... 128 15.7 ConfiguringtheEmailConfigurationPanel ................................................................ 130

16 MIB Browser Usage..................................................................................133

16.1 InvokingtheMIBBrowser .......................................................................................... 133 16.2 ConfiguringtheMIBBrowser ..................................................................................... 134

16.2.1 SettingCommonParameters.......................................................................................... 134 16.2.2 StoringTableEntriesinaSerializedFile ......................................................................... 137 16.2.3 StoringTableEntriesinaDatabase ................................................................................ 137 16.2.4 SettingMIBParameters .................................................................................................. 138 16.2.5 LoadingMIBs................................................................................................................... 138 16.2.6 UnloadingMIBs............................................................................................................... 140 16.2.7 PerformingSNMPOperations ........................................................................................ 141 16.2.8 SettingSNMPTableOptions........................................................................................... 144

16.3 InterpretingMIBBrowserErrorMessages ................................................................. 147 16.4 FAQs ............................................................................................................................ 152

Legal Notices and License Agreements .................................................................155

CAMBIUMNETWORKS,LTDENDUSERLICENSEAGREEMENT............................................... 155 CAMBIUMPUBLICLYAVAILABLESOFTWARELEGALNOTICESANDENDUSERLICENSEAGREEMENTSFORPUBLICLYAVAILABLESOFTWARE ............................................................ 160 SoftwareIncludedbyCambium.............................................................................................. 161 PackagesThatUseApacheLicenseVersion2.0 ..................................................................... 165 THIRDPARTYPUBLICLYAVAILABLESOFTWARELEGALNOTICESANDENDUSERLICENSEAGREEMENTSFORPUBLICLYAVAILABLESOFTWARE ............................................................ 169 SoftwareIncludedbyCommercialThirdPartySoftware ....................................................... 170 PackagesThatUseGNULesserGeneralPublicLicenseVersion2.1 ...................................... 176 PackagesThatUseApacheSoftwareLicenseVersion1.1...................................................... 184

Abbreviations ....................................................................................................187

Technical Support..............................................................................................189

RunningtheCustomerSupportTool ...................................................................................... 189 OptionsforRunningtheSupportTool.................................................................................... 189 ContactingSupportRepresentatives...................................................................................... 190

List of Figures Figure1:SecurityAdministrationTreeGroupOperations ...................................................................... 65 Figure2:CommandoptiontouploadanindividuallicensefiletoLicenseManager................................. 95 Figure3:UpdateManagerinterface......................................................................................................... 100 Figure4:ServicepackInstallationWizard ................................................................................................ 101 Figure5:ServicepackReadmewindow ................................................................................................... 102 Figure6:ServicepackUninstallwindow .................................................................................................. 104 Figure7:ServicepackUninstallationstatuspanel ................................................................................... 105 Figure8:LicensingConfigurationpanelinLicenseManagerwebserver................................................. 116 Figure9:LicensingStatuspanelinLicenseManagerwebserver............................................................. 117 Figure10:WMServerpanelofWMAdministratorToollaunchedfromexecutable............................... 120 Figure11:BAMpanelofWMAdministratorTool .................................................................................... 122 Figure12:DatabasepanelofWMAdministratorTool ............................................................................. 123 Figure13:LicensingpanelofWMAdministratorTool ............................................................................. 124 Figure14:UploadLicenseFiledialog........................................................................................................ 125 Figure15:LicenseManagerStatusdisplaywindow ................................................................................. 126 Figure16:NBIpanelofWMAdministratorTool,activeSNMPV3settings ............................................. 127 Figure17:NBIpanelofWMAdministratorTool,activeSNMPV1/V2settings ....................................... 128 Figure18:OfflinePhysicalMappanelofWMAdministratorTool ........................................................... 129 Figure19:EmailConfigurationpanelofWMAdministratorTool ............................................................ 131 Figure20:MIBBrowsermainGUI............................................................................................................. 133 Figure21:MibBrowserSettingsdialog ..................................................................................................... 135 Figure22:LoadaMIBFilePanelMIBSettingsTab ................................................................................ 139 Figure23:SNMPTable..............................................................................................................................144 Figure24:SNMPTableSettingsPanel ...................................................................................................... 145

List of Tables Table1:HardwarerequirementsfortheWMserver ................................................................................. 21 Table2:SoftwarerequirementsfortheWMserver .................................................................................. 22 Table3:HardwarerequirementsfortheWMclientapplication ............................................................... 23 Table4:SoftwarerequirementsfortheWMclientapplication................................................................. 23 Table5:Portsthatmustbeopen ............................................................................................................... 25 Table6:Structuredinformationresourcespergeneraldevicetype.......................................................... 47 Table7:FaultManagementconfigurablefields ......................................................................................... 52 Table8:PerformanceManagementconfigurablefields ............................................................................ 57 Table9:RecommendedMySQLparametervalues..................................................................................... 81 Table10:Logfilespresentbydefault ......................................................................................................... 85 Table11:MibBrowserGeneraltabfields ................................................................................................. 135 Table12:SecurityparametersforaccessingSNMPv3agents .................................................................. 136 Table13:MibBrowserErrorMessages ..................................................................................................... 147

List of Procedures Procedure1:TosetupWindowstoallowallAdministratorstolaunchWMtools ................................... 24 Procedure2:Toconfigureserverclientcommunicationsafterinstallation.............................................. 26 Procedure3:ToassignaparticularIPaddresstotheWMserver.............................................................. 27 Procedure4:TosetWMserverasthefirstconnectionthatWindowsnetworkserviceswillaccess .......28 Procedure5:Toconfigurememoryanddailybackup................................................................................ 28 Procedure6:TochangetheIPaddressofthephysicalstandaloneserverinLinux................................... 29 Procedure7:TochangetheIPaddressofthephysicalstandaloneserverinWindows ............................ 29 Procedure8:TostarttheMySQLdaemonasaserveronLinux................................................................. 31 Procedure9:ToreinitializetheMySQLdatabase ..................................................................................... 31 Procedure10:TorestoretheinstalledWMdatabaseconfiguration ......................................................... 32 Procedure11:TodetectandrepaircorruptedMyISAMdatabasetables.................................................. 34 Procedure12:Toreclaimharddrivespacefromburgeoningdatabasefiles............................................. 35 Procedure13:ToobserveinthelogsthataMySQLdatabasetablehasbecomecorrupted .................... 36 Procedure14:ToconfirminLinuxthatthetableneedsrepair.................................................................. 36 Procedure15:TorepairaMySQLtableinaLinuxplatform....................................................................... 36 Procedure16:ToconfirminWindowsthatthetableneedsrepair ........................................................... 37 Procedure17:TorepairaMySQLtableinaWindowsplatform ................................................................ 38 Procedure18:ToadjustdatabasevaluesinLinuxforoptimalserverperformance.................................. 38 Procedure19:ToadjustdatabasevaluesinWindowsforoptimalserverperformance ........................... 38 Procedure20:Totemporarilydisableupdatestothephysicalmapdisplay.............................................. 42 Procedure21:Todisplayandstorefailedstatisticspolls........................................................................... 61 Procedure22:Toenableauthorizationsupport......................................................................................... 64 Procedure23:Toaddpasswordcomplexity............................................................................................... 66 Procedure24:Toenforcethepasswordchangerequirementforfirsttimeusers.................................... 67 Procedure25:Toprohibitmultiplesimultaneoussessionsbyanyoftheusers ........................................ 68 Procedure26:Torestorethesuperuseraccountandthesecuritytoolcache .......................................... 68 Procedure27:TodeployGeoServer ........................................................................................................... 71 Procedure28:Tocreatealayerfromoneimage ....................................................................................... 72 Procedure29:TocreateadatastoreforGeoServerworkspaceimages ................................................... 72 Procedure30:ToverifythatGeoServerconnectstotheimagedatastore ............................................... 73 Procedure31:Toaddanimagetoanexistinglayer................................................................................... 73

Procedure32:Todownloadashapefile .................................................................................................... 74 Procedure33:Toconverta.osm.pbfor.osm.bz2fileto.osm................................................................... 74 Procedure34:Toconverta.osmfileto.shpusingQGIS............................................................................ 75 Procedure35:TocreateadatastoreforGeoServerworkspaceshapes ................................................... 76 Procedure36:Toconfigurethenewlayer ................................................................................................. 78 Procedure37:Toverifythenewlayerconfiguration ................................................................................. 78 Procedure38:Toprecachealltilesforalllevelsofzoom ......................................................................... 79 Procedure39:Tosetadifferentmaxzoomlevelfortheofflinemap........................................................ 80 Procedure40:TooptimizetheMySQLdatabaseresourcesforWM ......................................................... 81 Procedure41:Toestablishsessionidletimelimits .................................................................................... 82 Procedure42:ToupgradeWMtoRelease4.1........................................................................................... 87 Procedure43:TomigrateoperatordatainupgradeofWMplustheOS .................................................. 98 Procedure44:Toinstallaservicepackorfeaturepack ........................................................................... 100 Procedure45:Touninstallaservicepackorfeaturepack ....................................................................... 103 Procedure46:ToresettheLicenseManagerAdministratorToolpassword ........................................... 113 Procedure47:Todeployredundantlicenseservers ................................................................................ 115 Procedure48:ToconfigureWMforofflinephysicalmapimages ........................................................... 129 Procedure49:ToreconfigureofflinephysicalmapimagesinWM.......................................................... 130 Procedure50:Toconfigureserverandadminemailsettings .................................................................. 131 Procedure51:ToinvoketheMIBBrowser ............................................................................................... 133

WM Release 4.1 Server Administration Guide Issue 1 June 2014

15

1 About This Administration Guide important ........... The installation tool for the WM server deposits an issue of the

Cambium Wireless Manager Release 4.1 Server Administration Guide and the Cambium Wireless Manager Release 4.1 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/management-tools/wireless-manager/. 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.1, 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.

AllinformationpertainingtotheWMserverfilesystemispresentedfortheserveradministratoracrossthefollowingdocuments:

CambiumWirelessManagerQuickStartGuide.Thisguidedocuments thesystemrequirements theprocedureforafreshinstallation clientdevicesetup SNMPbroadcasttoggling startingandstoppingtheWMservice launchingtheclient settingup,monitoring,andtroubleshootinginitialdiscovery licensingWMsoftwareandthephysicalmap

CambiumWirelessManagerServerAdministrationGuide.Thisguidedocuments startingandstoppingtheWMservice portusage databaseadministration serversideadjustmentsfor

discovery faultmanagement performancemanagement securitymanagement theofflinephysicalmap

serverlogs licensingandupgradingWMsoftware backingupthesystem usingtheMIBbrowser

http://www.cambiumnetworks.com/support/management-tools/wireless-manager/

Issue 1 WM Release 4.1 Server Administration Guide June 2014

16

1.1 Features New in Release 4.1 Release4.1introducesthefollowingfeatures:

installationtoolthatobveatesservicepacks.ThisisreflectedinWMUpgradetoRelease4.1onPage87.

supportforradioRelease13.0. supportforePMPnetworkelementsrunningtheirRelease2.0. APsupportforoperatingspectrumanalysiswithouttemporarilytransformingintoanSM.

ForexistingWMoperators,theupgradepathtoRelease4.1andupgradeprocedureareprovidedunderWMUpgradetoRelease4.1onPage87.

1.2 Content New in This Guide SectionMemoryManagementonPage28introducesaproceduretoincreaseservermemoryandkeepitefficientlyused.

Networkelementperformancedatacollectedbetweenthetimeofabackupandthetimeofitsrestoreispresentaftertherestore.Thisisnowstatedinthefollowingsections:

ServicePackorFeaturePackUninstallationonPage103 WMDowngradefromRelease4.1onPage105 UsingtheWMServerPanelonPage119

1.3 Chapters Thisserveradministrationguideisorganizedasfollows:

Thischapter describesthescopeofthisguideandprovidesreferencesandlinkstootherimportantdocumentsthatsupportWMandnetworkelements.

Chapter2,ManagementoftheWMServerDevice liststheportsthatmustbeopeninthefirewallsettingsontheserverdeviceanddescribestheconfigurationthattheserverrequiresforexecutingtools,forusingthepropernetworkinterfacecard,andforadaptingtoanewIPaddress.Italsoemphasizestheimportanceofdeployinganuninterruptiblepowersupplyandprovidesthelocationforplacementofdevicefirmwarepackagefiles.

Chapter3,MySQLDatabaseAdministration describeshowtoconfigure,start,andinitializethedatabaseandhowtorestoretheWMconfigurationandbackupthedatabase.

Chapter4,NetworkDiscoverySetupandDebug describeshowtomakeserversideadjustmentstothewayWMisconfiguredforDiscoveryandwheretofindDiscoveryrelateddebugmessages.


17

Chapter5,PredefinedInformationStructuresforDeviceSupport liststhestructuredinformationresourcesforsupportdevicesincludedintheserverfilesystem.

Chapter6,FaultManagementConfiguration describesserversideadjustmentstohowWMisconfiguredforFaultManagement.

Chapter7,PerformanceManagementConfiguration describesserversideadjustmentstohowWMisconfiguredforPerformanceManagement.

Chapter8,SecurityManagementConfiguration describesserversideadjustmentstohowWMisconfiguredforSecurityManagement.Thisdiscussionincludeshowgroupsandusers,authorizedandcustomview,andoperationsareconfiguredforsecurity,howtosettheauthorizationforsecurityadministration,configurecertainsecurityparameters,andsetwhenaccountsandpasswordsaretoexpire.

Chapter9,OfflinePhysicalMapSetup describeshowtoinstallandconfigureGeoServer,createmaplayersfromimages,andpreparelayersforefficientpanningandzooming.

Chapter10,OptimizationofWMServerPerformance providesspecificMySQLdatabaseconfigurationparametervaluesthatarerecommendedforalloperatorsandstronglyrecommendedforoperatorswhomanagelargenetworks,andalsodescribeshowtolimitidleclienttimebyconfiguringautomaticlockupsandterminationsforsessionsthatareidletoolong.

Chapter11,UserScriptsSetup providestheproperpathandmodeformountingoperatordefinedscriptsontheserver.

Chapter12,ManagementofWMServerLogs describeshowtomanagelogsthattheserverlogs.

Chapter13,WMSoftwareUpgradesandDowngrades describeshowtoupgradeWMtoRelease4.1.

Chapter14,WMSoftwareandFeatureLicensing describesthelicensingandlicensemanagementschemesthatRelease4.1supports:licensetypes(WMserver,physicalmaps,andnodepacks),howtocalculatetheneededquantitiesofthese,andhowtheWMclientcautionstheuserofapproachinglicensedeficiencies.Thischapteralsoincludesinformationonhowtoreplacetheserverlicense.

Chapter15,WMAdministratorToolforServerAdministration showsdefaultvaluesforfieldsofthetoolpanelsanddescribeshowtosetupWMtoconnecttoGeoServerandretrievemapimagesfromit.

Chapter16,MIBBrowserUsage describeshowtoinvoke,configure,andtroubleshoottheembeddedMIBbrowser.


18

1.4 References to Other WM Documents Ifyouareaclientadministratororuser,usetheCambiumWirelessManagerUserGuideforRelease4.1.

ForhighleveldescriptionsofnewfeaturesincludedintheinitialdistributionofRelease4.1,orforalldisclosuresaboutfeaturesthatthisdistributionsupports,seetheCambiumWirelessManagerRelease4.1ReleaseNotes.

FordocumentationsupportwithBAMintegration,seethefollowingdocumentation:

CambiumWirelessManagerQuickStartGuide Procedure42:ToupgradeWMtoRelease4.1onPage87ofthisserveradministrationguide CambiumWirelessManagerUserGuide

1.5 Links to Other Important Documents Forlinkstoimportantdocumentsaboutsupportednetworkelements,visithttps://support.cambiumnetworks.com/files.AfterloggingintotheSupportCenteratthisaddress,youwillhaveaccesstothefollowingtypesofdocuments:

PTPdeviceandPTPLINKPlanneruserguidesandreleasenotes PMPdeviceuserguides,releasenotes,andMIBs awiderangeofPMP320devicedocuments CMMuserguidesandreleasenotes

Forlinkstoimportantdocumentsaboutmanagementtools,visitthefollowingwebpages:

WirelessManagerguides,releasenotes,andservicepacknotesathttp://www.cambiumnetworks.com/support/managementtools/wirelessmanager/

CambiumNetworkUpdaterTool(CNUT)onlinehelpfileandreleasenotesathttp://www.cambiumnetworks.com/support/managementtools/cnut/

Prizmguides,releasenotes,anditsSDKathttp://www.cambiumnetworks.com/support/managementtools/prizmbam

Forlinkstonetworkelementfeaturesandspecifications,visitthefollowingwebpages.

CambiumPTP: theportfolioathttp://www.cambiumnetworks.com/products/ptp PTP100athttp://www.cambiumnetworks.com/products/ptp/ptp100 PTP200athttp://www.cambiumnetworks.com/products/ptp/ptp200 PTP500athttp://www.cambiumnetworks.com/products/ptp/ptp500 PTP600athttp://www.cambiumnetworks.com/products/ptp/ptp600 PTP650athttp://www.cambiumnetworks.com/products/ptp/ptp650 PTP800athttp://www.cambiumnetworks.com/products/ptp/ptp800 PTP810athttp://www.cambiumnetworks.com/products/ptp/ptp810 CambiumNetworksLINKPlannerat

http://www.cambiumnetworks.com/products/planningtools/linkplanner

https://support.cambiumnetworks.com/fileshttp://www.cambiumnetworks.com/support/management-tools/wireless-manager/http://www.cambiumnetworks.com/support/management-tools/cnut/http://www.cambiumnetworks.com/support/management-tools/prizm-bamhttp://cambiumnetworks.com/products/index.php?id=ptp_overviewhttp://www.cambiumnetworks.com/products/ptp/ptp-100http://www.cambiumnetworks.com/products/ptp/ptp-100http://www.cambiumnetworks.com/products/ptp/ptp-100http://www.cambiumnetworks.com/products/ptp/ptp-100http://www.cambiumnetworks.com/products/ptp/ptp-100http://www.cambiumnetworks.com/products/ptp/ptp-100http://www.cambiumnetworks.com/products/ptp/ptp-100http://www.cambiumnetworks.com/products/planning-tools/link-planner


19

CambiumPMP: theportfolioathttp://www.cambiumnetworks.com/products/pmp PMP100athttp://www.cambiumnetworks.com/products/pmp/pmp100/ PMP320athttp://www.cambiumnetworks.com/products/pmp/pmp320/ PMP400athttp://www.cambiumnetworks.com/products/pmp/pmp400/ PMP430athttp://www.cambiumnetworks.com/products/pmp/pmp430/ PMP450athttp://www.cambiumnetworks.com/products/pmp/pmp450/

Fordeclarationsofconformityforindividualnetworkelementsintheirvariousfrequencybandranges,see

http://www.cambiumnetworks.com/support/ecdocforECconformity http://www.cambiumnetworks.com/support/weeecomplianceforWEEEcompliance

1.6 Feedback on This Guide Weencouragefeedbackonourdocumentation,including

opinionsonthestructureorcontentofthedocuments. anotificationtousaboutadeficiencyinaccuracyorcompleteness. anyothercommentsyouhave.

Pleasecallwithyourfeedbacktotheappropriatephonenumberfromthelistathttp://www.cambiumnetworks.com/support/contactsupport.

1.7 References to Starting and Stopping the WM Service Someproceduresinthisguide(suchasbackup,restore,andupgrade)requirestart,stop,orrestartoftheservice.Youalsomayalsobeaskedtorestartservicesaspartoftroubleshootingeffortsundertheguidanceoftechnicalsupportstaff.Whenyouneedtorestartservices,usetheWMAdministratorToolwithitsJavainterfaceasdescribedunderUsingtheWMServerPanelonPage119.

http://www.cambiumnetworks.com/products/pmphttp://www.cambiumnetworks.com/products/pmp/pmp-100/http://www.cambiumnetworks.com/products/pmp/pmp-320/http://www.cambiumnetworks.com/products/pmp/pmp-400/http://www.cambiumnetworks.com/products/pmp/pmp-430/http://www.cambiumnetworks.com/products/pmp/pmp-450/http://www.cambiumnetworks.com/support/ec-dochttp://www.cambiumnetworks.com/support/open-a-support-casehttp://www.cambiumnetworks.com/support/contact-support


21

2 Management of the WM Server Device ThischapterdocumentscertainsetupandconfigurationstepsthatarerequiredforproperoperationofthegeneralfunctionsoftheWMserver.ChaptersthatfollowaddressrequirementsforspecificfeaturesofWM.

2.1 Server Requirements

2.1.1 Server Hardware Requirements

TheWMserverrequiresthefollowinghardwarecharacteristicsforitsproperoperation.

Table 1: Hardware requirements for the WM server

Requirement type With 100 nodes With > 100 nodes Virtual machine

hardwareclass server,notdesktop server,notdesktop server,notdesktop

RAM 4GB 8GB 8GBfor 100nodes

12GBformore

processor dualcore 2GHz quadcore 2GHz 2GHz

dualcorefor 100nodes

quadcoreformore

storage RAID1 RAID5, 10,000rpmdrives

RAID1for 100nodes

uninterruptiblepowersupply(UPS)

highlyrecommended highlyrecommended highlyrecommended

schemeforgracefulshutdownduringpoweroutage

highlyrecommended highlyrecommended highlyrecommended


22

2.1.2 Server Software Requirements

TheWMserverrequiresthefollowingsoftwareversionsorconfigurationsforitsproperoperation.

Table 2: Software requirements for the WM server

Requirement type Version

Operatingsystem1 WindowsServer2008R2

WindowsServer2008SP2(Standard,Enterprise,orDatacenter)

RedHatEnterpriseLinux5.x32bit(not64bit)ES(notAS)

RedHatEnterpriseLinux6.x32bit(not64bit)ES(notAS)

CentOS5.x32bit(not64bit)

CentOS6.x32bit(not64bit)

Firewall SeePortManagementonPage25.

Java InstalledaspartoftheWMdistribution

database MySQLServerVersion5.1,optionallyinstalledbytheWMdistributiontool

licensing LicenseManager,installedbytheWMdistributiontool

dos2unixpackage WMonCentOSrequiresthatthedos2unixpackageisinstalledbeforeWMininstalled.Ifitisnot,thenLicenseManager,webserver,andWMserverservicesdonotstart;andthescriptsintheWMserverarenotproperlyread.

Specialconsiderationsforsoftwareinstallations

CertainpackagesarespecificallyconsideredproblematicforaWMplatform:

XENvirtualizationsoftware,inanyWMconfiguration

clusterpackages,wheretheHighAvailability(HA)configurationisimplemented.

ifvirtualizationisinstalled VMwarevSphere.Seehttp://www.vmware.com/support/pubs/vsphereesxivcenterserverpubs.html

NOTES:1. CambiumTechnicalSupportcannothelpanetworkoperatorcustomizeanOS,for

exampleobtainspecialLinuxlibrarypackages,tomakeWMworkonanunsupportedversion.

http://www.vmware.com/support/pubs/vsphere-esxi-vcenter-server-pubs.htmlhttp://www.vmware.com/support/pubs/vsphere-esxi-vcenter-server-pubs.html


23

2.2 Client Requirements

2.2.1 Client Hardware Requirements

TheWMclientrequiresthefollowinghardwarecharacteristicsforitsproperoperation.

Table 3: Hardware requirements for the WM client application

Requirement type Supported

hardwareclass anymoderndesktoporlaptop

storage 15MB

linkspeed 1Mbps

screenresolution 1024x768

2.2.2 Client Software Requirements

TheWMclientrequiresthefollowingsoftwareversionsforitsproperoperation.

Table 4: Software requirements for the WM client application

Requirement type Software and version

Operatingsystem1 Windows7Professional,32bit

WindowsServer2008R2Enterprise

RedHatEnterpriseLinux5.5ES

RedHatEnterpriseLinux6.xES

Browser MozillaFirefox3,32bit,iftheclientisonaLinuxOSdevice

InternetExplorer6,7,or8;32bit,iftheclientisonaWindowsOSdevice

Java JRE1.6.0_10orlater2

NOTES:1. MacOSisnotsupported.ThefollowingadditionalOSs

areexpectedtoworkbuthavenotbeentestedwiththeclientapplication:

Windowsversionsotherthanthoseshownabove,assumingtheyare32bit

CentOS5.5or6.x,32bit

2. UseofanearlierJREversionwithWMRelease4.0SP3orlatercanresultinanOutOfMemoryerror.


24

2.3 Local Setup for Launches of Included Tools Bydefault,Windows2008imposesasecurityschemethatlimitstoolexecutionstothedefaultAdministratoraccount,theBuilt-in account for administering the computer/domain.ItdoesnotextendthisprivilegetootheraccountsthathavebeenconfiguredintheBuiltinAdministratorsgroup.Toextendittoallofthem,thefollowingworkaroundsetsupthelocalWindowsdevicetopromptthoseadministrators,uponanattempttolaunchatool,forwhethertoallowJavathewriteaccessrequiredfortheexecution.Thisprocedureisrequiredonce,exceptiftheparametersthatitsetsbecomereconfigured.

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

1. LogintotheserverdeviceastheAdministratorwithadministrativeprivileges(theBuilt-in account for administering the computer/domain).

2. NavigatetoC:\Cambium\WM\jre\bin.3. Rightclickthefilejava.exeandselectProperties.4. Intheresultingdialog,clicktheCompatibilitytab.5. Nearthebottomofthisdialog,clicktheChangesettingforallusersbutton.6. Nearthebottomoftheresultingdialog,checkthecheckboxofthe

Runthisprogramasanadministratoroption.

7. ClickOKtoconfirmanddismissthislatterdialog.8. ClickOKtodismisstheoriginaldialog.

NowwhenanymemberoftheBuiltinAdministratorsgroupintheActiveDirectoryDomainServicesareaattemptstolaunchatoolfromtheC:\Cambium\WM\jre\binfolder(eitherdoubleclicksthetoolnameorrightclicksitandselectsOpen),Windowswillpromptthatuserforwhethertoallowtheprogram(Java)tomakechangestothecomputer.TheusershouldclicktheYesbuttoninresponsetothisprompt.

Othersectionsofthisadministrationguideprovidevariousproceduresthatinvokesuchtools.Thesesectionsincludebutmaynotbelimitedto

ReinitializingtheDatabaseonPage31 DefiningandManagingaGrouporaUseronPage63 RestoringaDeletedsuperuserAccountonPage68 ServicePackorFeaturePackInstallationonPage99 InvokingtheMIBBrowseronPage133 RunningtheToolfromtheServeronPage189


25

2.4 Port Management ThefollowinglistshowsalistofthespecificportassignmentsinusebyWirelessManagercomponents.Eachmustbeopeninthefirewall,ifafirewallisimplemented.

Table 5: Ports that must be open

Server Port Usage

25 OutboundconnectiontoSMTPserverforemailconfiguration.1

80 OutboundconnectiontoBAMservertolaunchitsinterface.

161 InboundUDPforthenorthboundinterface(NBI).

161 OutboundUDPfordeviceSNMPqueriesandconfigurations.

162 InboundUDPforSNMPtrapsfromdevices.

1234 InboundUDPforAPstorequestauthenticationsfromBAM.

1476 Configurationserver.

1482 Socketserver.

2000 Networkmanagementbackendserver.

2501 ToturntheSMAutoupdatefeatureonoroffinAPs.

3306 QueriestotheMySQLdatabase.

6900 InboundTCPforTFTPconnectionsinthefirmwareupgradeprocess.

8003OutboundUDPforSNMPresponseoverthenorthboundinterface(NBI).

8009TCPconnectionsbyTomcatandwebserverforaccesstodevicemanagementwebpages.2

8090 InbounddatafromtheBAMserver.

9090 InboundTCPforthewebserver.

32900NMSSocketforTCPcommunicationbetweentheWMserverandWMclient.3

33100NMSFESecondaryforTCPcommunicationbetweentheWMserverandWMclient.4

WM

61001 OutboundUDPfromBAMtoAPs.

27000 WMtorequestlicenses.5

LicenseManager27443

SecurecommunicationsbetweenWMandthewebserverofLicenseManager.5


26

Server Port Usage

1521OptionalOracleJavaNamingandDirectoryInterface(JNDI)connectionpoolviaTomcat.

GeoServer

8080CommunicationsbetweenWMandthewebadministrationinterfaceofGeoServer.

NOTES:

3. Portnumberisreconfigurablein.../server/conf/WibbWMSConfiguration.xml.4. Portnumberisreconfigurablein.../server/Apache/Tomcat/conf/server.xml.

5. Mustbeconfiguredin.../server/conf/transportProvider.confwithWMserverstoppedafterWMinstallation.

6. Mustbeconfiguredin.../server/conf/serverparameters.confwithWMserverstoppedafterWMinstallation.

7. Portnumberisreconfigurablein.../server/conf/licensing.xml.

AsindicatedinNote3andNote4above,theNMSSocketportandNMSFESecondaryportmustbeconfiguredafterWMhasbeeninstalledandstopped.Todoso,performthefollowingsteps.

Procedure 2: To configure server-client communications after installation

1. IftheWMserverisrunning,launchtheWMAdministratortool.2. StoptheWMserver,asdescribedunderUsingtheWMServerPanelonPage119.3. Openthefile.../server/conf/transportProvider.confforediting.4. Findthetag.

5. Changeitsvaluefrom0tothatofanyavailableTCPport(forexample,32900).


27

6. Saveandclosethefile.7. Openthefile.../server/conf/serverparameters.confforediting.8. Scrolltothebottomofthefile.9. Insertalinethathasthefollowingtext:

NMS_FE_SECONDARY_PORT 33100where3100isanexampleavailableTCPport.

10. Saveandclosethefile.11. StarttheWMserver,asdescribedunderUsingtheWMServerPanelonPage119.

2.5 Network Interface Management ThelicensesthatCambiumNetworksprovidesdependontheparticularnetworkinterfacecard(NIC)thatyourLicenseManagerserverisusing.IfyouaddorremoveaNIConyourLicenseMangagerserverdevice,yourWMlicensemayceasetobevalid.Ifthisoccurs,contactCambiumNetworkstorequestareplacementlicense.

TheexistenceofmultipleNICsonyourWMserverdevicecanpopulatetheother(incorrect)NICIPaddressintotheJavaWebStartfile.Tofixandpreventthis,performthefollowingprocedure(s).

Procedure 3: To assign a particular IP address to the WM server

1. OpentheWMAdministratorTool.(SeeWMAdministratorToolforServerAdministrationonPage119).

2. IntheWMServerpaneloftheWMAdministratorTool,clicktheStopWMServerbutton.3. IntheWMserverfilesystem,navigatetothedirectory

wm_server_install_directory/server/bininLinuxorthefolderC:\Cambium\WM\server\bininWindows.

4. OpenthefilestartWM.shinLinux(orstartWM.batinWindows)forediting.5. Findthestringcom.adventnet.nms.startnms.NmsMainBE.6. Immediatelybeforethisstring,add

-Dnms.server.host="IP_Address_you_want_to use_for_WM_server"followedbyaspace.

EXAMPLE:Thefinishedlinelookslikethis:$JAVA_HOME/bin/java -cp $CLASS_PATH -Dcatalina.home=$TOMCAT_HOME -Dmysql.home=$MYSQL_HOME -Dwebserver.port=$WEBSERVER_PORT -Dresource_check="$WEBSERVER_PORT,$WEBCONTAINER_PORT,$TOMCAT_SHUTDOWNPORT" -Dwebserver.rootdir=$WEBSERVER_HOME -Djava.rmi.server.codebase="$CODEBASE_LIST" -Xmx$MAX_HEAP_SIZE_STR -Dcom.sun.management.jmxremote.port=16000 -Dcom.sun.management.jmxremote.authenticate=false


28

-Dcom.sun.management.jmxremote.ssl=false -Dcom.sun.management.snmp.interface=`hostname` -Dcom.sun.management.snmp.acl=false -Dcom.sun.management.snmp.port=16500 -Dnms.server.host="IP_Address_you_want_to_use_for_WM_server" com.adventnet.nms.startnms.NmsMainBE NMS_BE_PORT 2000 ROOT_DIR $NMS_HOME NATIVE_PING false $*

7. Saveandclosethefile.8. IntheWMServerpaneloftheWMAdministratorTool,clicktheStartWMServerbutton.

Procedure 4: To set WM server as the first connection that Windows network services will access

1. OpentheControlPanel.2. Intheleftpanel,clickSwitchtoClassicView.3. Intherightpanel,doubleclickNetworkConnections.4. FromthemainmenuoftheNetworkConnectionswindow,select

AdvancedAdvancedSettings.

5. IntheAdaptersandBindingstaboftheAdvancedSettingswindow,usetheupordownarrowtoensurethattheconnectionoftheWMserverNICishigherinthelistthantheotherNIC.

2.6 Memory Management Usethefollowingstepstoincreaseservermemoryandkeepitefficientlyused.

Procedure 5: To configure memory and daily backup

1. StoptheWMserver.2. OpentheWindowsfolderC:\Cambium\WM\server\bin\ortheLinuxdirectory

\usr\local\cambium\wm\server\bin\.3. OpenthefilestartWM.batorstartWM. shforediting.4. Searchforthefollowingtextinthefile:set MAX_HEAP_SIZE_MB=1024.

(Here,1024represents,inMegabytes,thememoryWMisusing.)5. Increasethisvalueto1280,1536or1756.6. Saveandclosethefile.7. StarttheWMserver.

RESULT:Theservermemoryhasbeenreconfigured.8. OpentheWindowsfolderC:\Cambium\WM\server\confortheLinuxdirectory

\usr\local\cambium\wm\server\conf.9. OpenthefileBackUp.confforediting.10. Searchforthefollowingtextinthefile:

BACKUP className="jdbc.CustomBackupDB" 11. IftheDAILYattributeinthesamelineissettotrue,changeittofalse.12. RestarttheWMserver.

RESULT:Automaticbackupshavebeensuppressed.


29

2.7 IP Address Change for the WM Server ThissectionprovidesasetofinstructionsspecifictotheoperatingsystemoftheWMserverdevice.

2.7.1 Address Change for the Server in Linux

OnaLinuxplatform,wheretheWMserverIPaddressdiffersfromthatofitspreviousdeployment,somefurtheractionisrequired:

IftheIPaddressisdynamic,thenarebootoftheserverdeviceallowstheservertoupdateitsinformation.

IftheIPaddressisstatic,thenthe/etc/hostsfilemustbeupdatedtocontainavalidmappingofitsIPaddresstoitshostname(localhost.localdomainisnotvalid).

Procedure 6: To change the IP address of the physical standalone server in Linux


2. IntheWMServerpaneloftheWMAdministratorTool,clicktheStopWMServerbutton.3. IntheleftpaneloftheWMAdministratorTool,clickLicensing.4. IntheLicensingpanel,clicktheStopLMbutton.5. UsethemethodappropriatetoyourLinuxversiontochangetheIPaddressofthephysical

server.

6. AttheLinuxOSprompt,enterservice network restart.7. IntheHostname/IPfieldoftheLicensingpanelintheWMAdministratorTool,replacethe

hostnameorIPaddresswiththeaddressconfiguredinStep5above.

8. ClicktheSaveConfigurationbutton.9. ClicktheRestartLMbutton.10. ClicktheLicenseStatusbutton.11. CheckthesystemresponsetoverifythatLicenseManagerisrunningproperly.12. Ifthelicensewasnotretrieved,returntoStep7ofthisprocedureandenterthecorrectnew

IPaddress.

13. IntheleftpaneloftheWMAdministratorTool,clickWMServer.14. IntheWMServerpanel,clicktheStartWMServerbutton.

2.7.2 Address Change for the Server in Windows

Procedure 7: To change the IP address of the physical standalone server in Windows


2. IntheWMServerpaneloftheWMAdministratorTool,clicktheStopWMServerbutton.3. IntheleftpaneloftheWMAdministratorTool,clickLicensing.4. IntheLicensingpanel,clicktheStopLMbutton.


30

5. UsethemethodappropriatetoyourWindowsversiontochangetheIPaddressofthephysicalserver.

6. IntheHostname/IPfieldoftheLicensingpanelintheWMAdministratorTool,replacethehostnameorIPaddresswiththeaddressconfiguredinStep5above.

7. ClicktheSaveConfigurationbutton.8. ClicktheRestartLMbutton.9. ClicktheLicenseStatusbutton.10. CheckthesystemresponsetoverifythatLicenseManagerisrunningproperly.11. Ifthelicensewasnotretrieved,returntoStep6ofthisprocedureandenterthecorrectnew

IPaddress.

12. IntheleftpaneloftheWMAdministratorTool,clickWMServer.13. IntheWMServerpanel,clicktheStartWMServerbutton.

2.8 Use of an Uninterruptible Power Supply Aswithanysoftwarethatkeepsadatabase,aninterruptionofpowertothehostdeviceofthesoftwarecanresultincorruptionofthedatabasethatrendersitscontentsirretrievableoruseless,becausethesoftwarecannotclosethedatabaseinpropersequence.HistoricaldataaboutdevicesthatWMwillcontinuetomanageislost.Tokeepthedatasaferfromcorruption,anoperatorcandeployanyofthefollowing:

theWMHighAvailabilityfeaturewithdatabaseredundancy(seeCambiumHighAvailabilityforWirelessManagerServeronaLinuxPlatformSetupGuide)

operatormanageddatabaseredundancyonaWindowsplatform anuninterruptiblepowersupply(UPS)

AUPSdeviceisrecommendedforatleastminimalprotection.

2.9 Placement of pkg3 Files for Network Element Upgrades Placeandkeepinthe.../server/Tftpdirectoryoftheserverfilesystemall.pkg3filesthatneedtobeavailabletotheclientapplication.ThesewillbeautomaticallyloadedforpossibleselectionfromPackageManagerbytheauthorizedclientuser.Inthatutility,theclient

isnotcapableofbrowsingintheservrfilesystem. maybrowsetheclientdevicefilesystemtofindandloadadditional.pkg3files.Theserver

willallowthosefilestobethenuploadedintothe.../server/TftpdirectorysothattheyarelistedthenexttimethatPackageManagerislaunchedintheclient.

Giventhetworepositoriesforpackagefiles,eachhasthefollowingpotentialadvantage:

thefilesinthe.../server/TftpdirectoryoftheserverarealwaysautomaticallyloadedintoPackageManagerselection,regardlessofanyproblemstheoperatormayexperiencewiththeAddoperationinthatutility.

thefilesselectedintheclientfromanywhereintheclientfilesystemareavailableforloadingregardlessoftheanynetworkingconstraintsorconditionsthatwouldinhibitdownloadsfromtheservertotheclient.


31

3 MySQL Database Administration ThischapterexplainshowtoconfigureWirelessManagertosupporttheMySQLdatabase.

3.1 Changing the Database Authentication in WM IfthedatabaseusernameandpasswordinMySQLareeverchanged(forexample,throughthecommandlineinterfacetoMySQLServer),thenyoumustmakethecorrespondingchange(s)intheDatabasepaneloftheWMAdministratorTool.SeeConfiguringtheDatabasePanelonPage123.Theseparameterscanbeedited,butultimatelymustmatchtheusernameandpasswordconfiguredinthedatabaseitself.EditsintheDatabasepanelandcorrespondingchangesviathecommandlineinterfacetoMySQLcanalsobeusedtoovercomefromaforgottenpasswordorusernameforthedatabase.

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,thepasswordstringdoesnotappearhumanreadableanywhereintheserverfilesystemortheclientapplication.

3.2 Starting the Database WirelessManagerstartsandinitializestheMySQLdatabasebeforestartingWirelessManagermodules.TheMySQLdaemonisstartedwhenthestartWMSscriptfilelocatedintheC:\Cambium\WM\server\binfolderinWindowsisinvoked.InLinux,youneedtostarttheMySQLdaemonasaservicebeforestartingtheWirelessManagerServer.

Procedure 8: To start the MySQL daemon as a server on Linux

1. Loginasasuperuser.2. Enter$ /etc/rc.d/init.d/mysql start.

3.3 Re-initializing the Database PerformthefollowingprocedureifyouhavemodifiedanyofthedefaultsettingsandneedtoreinitializetheMySQLdatabase.Beawarethatthisprocedureremovesallofdatathatyourdatabaseiscurrentlystoring.Alldiscoveredelementsandallofthehistoricalinformationthatisassociatedwiththemwillbedeleted.

Procedure 9: To re-initialize the MySQL database

1. IftheWirelessManagerServerisalreadystarted,doapropershutdownofserver.Donotterminatetheprocessabnormallyorabruptly.

2. IfWirelessManagerisalreadyinstalled,runthereinitialize_databasescriptfilelocatedinthe/usr/local/cambium/wm/server/bindirectoryinLinux


32

(ortheC:\Cambium\WM\server\binfolderinWindows)tocleanupthetablesinthedatabase.

3. MakesurethattheMySQLprocessisrunning.4. StarttheWirelessManagerServer.

Nowalloftheelementsmustberediscovered,andallperformancedatachartsandotherhistoricalinformationwillinitiallynotexist.

3.4 Restoring the WM Default Database Configuration PerformthefollowingprocedureonlyintheunlikelyeventthatyouchangedthetablestructureordeliberatelyalteredanyotherSQLsettingsandnowwanttoreverttotheconfigurationthattheWMinstallationtoolhadinstalled.

Procedure 10: To restore the installed WM database configuration

1. IftheWirelessManagerserverisalreadystarted,doapropershutdownofserver.Donotterminatetheprocessabnormallyorabruptly.

2. 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).

3. IfusingSNMPv3,adddatabaseconnectioninformationtotheSnmpDefaultProperties.xmlfileinthe/usr/local/cambium/wm/server/confdirectoryinLinux(ortheC:\Cambium\WM\server\conffolderinWindows).

4. Indatabase_params.conffileintheconfdirectory,specifythemachinenamewherethedatabaseistorun,theusername,andthepasswordforthedatabase.

5. MakesurethattheMySQLprocessisrunning.6. StarttheWirelessManagerserver.

3.5 Backing Up the Entire Database GoodpracticeistoperiodicallyperformbackupsofyourWMdatabase.Thissectiondescribeshowtocreateabackupcopyofyourentiredatabase(itsconfigurationanditscontents)andtheentireWMsysteminasingleoperation.Nodatabaseonlybackupissupported,andnonewouldalsobackuptheessentialinformationthatisstoredinfilesintheWMserverfilesystem.

important ........... Do not launch a backup while the WM server is running, because this can result in inconsistency between the contents of the backup and the contents of the database.

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)intheWMAdministratorTool.SeeUsingtheWMServerPanelonPage119.


33

3.6 Restoring the Entire Database RestoringtheMySQLdatabaseisaseffectiveasthedatabasesnapshotthatwasbackedup(seeBackingUptheEntireDatabaseabove).Nodatabaseonlybackupissupported,andnonewouldalsobackuptheessentialinformationthatisstoredinfilesintheWMserverfilesystem.

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)intheWMAdministratorTool.SeeUsingtheWMServerPanelonPage119.Thisoptionrestoresnotonlythedatabasesnapshot,butalsotheessentialfilesfromtheWMserverfilesystem.

3.7 Maintaining the Integrity of the Database WMisdesignedtoproperlypopulateandreaditsownupdatesfromtheWMdatabase.Anychangeindatabasecontentsthatanoperatordirectlymakesisexpresslynotsupportedandislikelytoresultinafailureofsomeproportioninthesystem.

Itisstronglyrecommendedthatyoudeployanuninterruptiblepowersupply(UPS)fortheWMserverdevice.Eitherapoweroutageorahardrestartofthedevicewhileitisoperatingcanresultincorruptionofthedatabasetablesandmayrequirereinitializingthedatabaseandrediscoveringalloftheelementsinyournetwork.AUPScansupplyenoughpowertoallowWMtoproperlyshutdownandavoiddamagetothedatabase.

Despitegoodpractices,overtimeWMdatabaseswilllikelyrequirelocalmaintenance.UseoneofthefollowingsectionstoavoidorcorrectWMdatabaseproblems:

AddressingTableCorruptiononaLinuxPlatformonPage33 AddressingContinuousGrowthofDataFilesonaWindowsPlatformonPage34

3.7.1 Addressing Table Corruption on a Linux Platform

ThedefaultdatabaseengineforMySQLonaLinuxplatformisMyISAM.Withthisengine,databasetablescanbecomecorrupted,regardlessofgoodoperatorpractices.Unexpectederrorssuchasthefollowingmaysignalthatthishasoccurred:

Table './WMSDB/WMS_CUSTOMUSERPROPS' is marked as crashed and should be repaired

Periodicallysearchthecontentsofthefile.../server/logs/stderr*.txtforthepresenceoferrorslikethis.Whenthesearepresent,useoneormoreofthefollowingprocedurestofindthecorruptedtable(s)andmakeappropriaterepairs:

Reviewthedescriptionsofthetoolsandprocedures:http://www.databasejournal.com/features/mysql/article.php/3300511/RepairingDatabaseCorruptioninMySQL.htm.

Useaprocessofoneormoreofthefourstagesforcheckingalltablesatonceandrepairingcorruptedtables:http://dev.mysql.com/doc/refman/5.0/en/myisamrepair.html.

http://www.databasejournal.com/features/mysql/article.php/3300511/Repairing-Database-Corruption-in-MySQL.htmhttp://www.databasejournal.com/features/mysql/article.php/3300511/Repairing-Database-Corruption-in-MySQL.htmhttp://dev.mysql.com/doc/refman/5.0/en/myisam-repair.html


34

note .............The process above requires stopping the MySQL service. The following does not.

UseProcedure11:TodetectandrepaircorruptedMyISAMdatabasetablesonPage34todetectandrepaircorruptedtableswithouttheneedtostoptheMySQLservice.

Procedure 11: To detect and repair corrupted MyISAM database tables

1. SeeReferencestoStartingandStoppingtheWMServiceonPage19.2. StoptheWMservice.3. 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. LogintoMySQL.5. 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,enterthefollowingcommandatthemysql>prompt:

CHECK TABLE tablename; 7. Reviewhttp://dev.mysql.com/doc/refman/5.0/en/repairtable.html.8. Torepairatablethatwasfoundinthestepabovetobecorrupted,enterthefollowing

commandatthemysql>prompt:REPAIR TABLE tablename;

9. Toverifythattherepairedtableisnolongercorrupted,enterthefollowingcommandatthemysql>prompt:

CHECK TABLE tablename; 10. Ifanytableremainscorrupted,see

http://www.databasejournal.com/features/mysql/article.php/3300511/RepairingDatabaseCorruptioninMySQL.htmandhttp://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,certaindatafilescontinuouslygrowandeventuallyuseasignificantamountofharddrivespace.Nothing,evendeletingdatafromthedatabase,causestheirsizetoshrinkorlevelout.Atleastannually,reclaimthisstoragespacebyperformingProcedure12:ToreclaimharddrivespacefromburgeoningdatabasefilesonPage35.

http://dev.mysql.com/doc/refman/5.0/en/check-table.htmlhttp://dev.mysql.com/doc/refman/5.0/en/repair-table.htmlhttp://www.databasejournal.com/features/mysql/article.php/3300511/Repairing-Database-Corruption-in-MySQL.htmhttp://www.databasejournal.com/features/mysql/article.php/3300511/Repairing-Database-Corruption-in-MySQL.htmhttp://dev.mysql.com/doc/refman/5.0/en/myisam-repair.html


35

Procedure 12: To reclaim hard drive space from burgeoning database files

1. Reviewhttp://dev.mysql.com/doc/refman/5.0/en/innodbdatalogreconfiguration.html.2. ReviewReferencestoStartingandStoppingtheWMServiceonPage19.3. StoptheWMservice.4. 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. StoptheMySQLservice.6. NavigatetotheMySQLdatafolder.7. Findallexistingtablespacefiles.

note ............. In the default WM implementation, these files are ib_logfile0, ib_logfile1, and ibdata1.

8. Deleteallexistingtablespacefilesfromthisfolder,includingtheibdata*andib_log*files.

9. 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.

3.8 Repairing a Crashed Table BothofthefollowinginstancesareamongpossiblecausesofMySQLtablecorruption:

anabruptshutdownoftheWMserver(uponasuddenpoweroutage,forexample) insufficientharddiskspace.

WhencorruptioninaMySQLdatabasetablehasoccurred,theWMoperatormayrecognizethisbyobservingthat

theWMservicehangsduringstartup. theWMservercrashesafterstartup.

http://dev.mysql.com/doc/refman/5.0/en/innodb-data-log-reconfiguration.html


36

Ifyouobserveeitherofthese,performthefollowingsteps.

Procedure 13: To observe in the logs that a MySQL database table has become corrupted

1. Navigatetothedirectory/usr/local/cambium/wm/server/logsinLinuxorC:\Cambium\WM\server\logsinWindows.

2. Lookinthelofilesforanyofthefollowingindiicationsoftabledamage: tbl_name.frm is locked against change Can't find file tbl_name.MYI (Errcode: nnn) Unexpected end of file Record file is crashed Got error nnn from table handler

UseoneofthefollowingOSdependentprocedurestorepairacorruptedtable.

3.8.1 Repairing a Table in Linux

Youmustrepairyourtablesusingmyisamchk.myismchkisatoolprovidedbyMySQLwhichcanusuallydetectandfixmostproblemsthatoccur.Torepairthecrashedtables,performthestepsgivenbelow:

Procedure 14: To confirm in Linux that the table needs repair


2. IntheWMServerpaneloftheWMAdministratorTool,clicktheStopWMServerbutton.3. LogintotheLinuxsystemasroot.4. AttheLinuxcommandprompt,enterthefollowingcommand:

service mysqld stop 5. Enterthefollowingcommand:

myisamchk e update-state /var/lib/mysql/WMSDB/*.MYI >/usr/local/db_check.txt 6. Ifthesystemreturnsnooutput,stop.(Notablesarecorrupted.)

Ifthesystemreturnsanyoutput,performProcedure15:TorepairaMySQLtableinaLinuxplatform.

Procedure 15: To repair a MySQL table in a Linux platform

1. IfProcedure14hasnotbeenperformed,performitnow.2. AttheLinuxcommandprompt,enterthefollowingcommand:

myisamchk r -q update-state /var/lib/mysql/WMSDB/*.MYI >/usr/local/db_repair.txt 3. Allowtimesufficientfortablestoberepaired.4. Ifthesystemreturnsnooutput,stop.

Ifthesystemreturnsanyoutput,enterthefollowingcommand:myisamchk o -f update-state /var/lib/mysql/WMSDB/*.MYI >/usr/local/db_repair.txt

5. Allowtimesufficientfortablestoberepaired.


37

6. Enterthefollowingcommand:service mysqld start

7. IntheWMServerpaneloftheWMAdministratorTool,clicktheStartWMServerbutton.

3.8.2 Repairing a Table in Windows

Procedure 16: To confirm in Windows that the table needs repair


2. IntheWMServerpanel,clicktheStopWMServerbutton.3. FromtheWindowsOSmenu,openStartRun.4. IntheOpenfieldoftheRundialog,enterservices.msc.5. IntheresultingServicesdialog,clicktheStandardtab.6. ClicktohighlighttherowoftheWMMySQLservicethatisrunning.7. RightclicktherowandselectStopfromthedropdownlistofoptions.8. NavigatethefilesystemtothefolderC:\MySQL Server 5.1\.9. Rightclickthefilemy.iniandselectOpenWithNotepad.10. SelectEditFind.11. IntheFindwhattextbox,typedefault-storage-engine.12. ClicktheFindNextbutton.13. IfthevalueofthisoptionisnotsettoINNODB,advancetoStep14.

IfthevalueofthisoptionissettoINNODB,performthefollowingstepsnow:a. Scrolltothebottomofthefile.b. Fixthecursorattheleftedge.c. Typeinthefollowingnewlineoftext:

innodb_force_recovery=6 d. IntheServicesdialog,clicktohighlighttherowoftheWMMySQLservice.e. RightclicktherowandselectStartfromthedropdownlistofoptions.f. IfWMMySQLsuccessfullystarts,clicktheStartWMServerbuttonintheWM

AdministratorToolandstopthisprocedure.

IfWMMySQLfailstostart,continue.

14. IntheOpenfieldoftheRundialog,entercmd.15. Attheresultingcommandprompt,entercd C:\MySQL Server 5.1\bin.16. Entermyisamchk e ..\data\wmsdb\*.MYI > db_check.txt.17. Ifthesystemreturnsnooutput,stop.

Ifthesystemreturnsanyoutput,performProcedure17:TorepairaMySQLtableinaWindowsplatform.


38

Procedure 17: To repair a MySQL table in a Windows platform

1. IfProcedure16hasnotbeenperformed,performitnow.2. AttheWindowscommandprompt,enterthefollowingcommand:myisamchk r -q update-state /var/lib/mysql/WMSDB/*.MYI > db_repair.txt

3. Allowtimesufficientfortablestoberepaired.4. Ifthesystemreturnsnooutput,stop.

Ifthesystemreturnsanyoutput,enterthefollowingcommand:myisamchk o -f update-state /var/lib/mysql/WMSDB/*.MYI > db_repair.txt

5. IntheServicesdialog,clicktohighlighttherowoftheWMMySQLservice.6. RightclicktherowandselectStartfromthedropdownlistofoptions.7. ClicktheStartWMServerbuttonintheWMAdministratorTool.

3.9 Tuning the Database Attributes for Optimal Use of Server Resources DramaticimprovementintheuseofsystemresourcesfortheWMserverispossiblethroughtheadjustmentofthevaluesforcertainattributethatcontrolthedatabase.Theprocedureforadjustingthesevaluesisspecifictotheoperatingsystem.

Procedure 18: To adjust database values in Linux for optimal server performance


2. IntheWMServerpaneloftheWMAdministratorTool,clicktheStopWMServerbutton.3. LogintotheLinuxsystemasroot.4. AttheLinuxcommandprompt,enterthefollowingcommand:

service mysqld stop 5. Enterthefollowingcommand:

mysqld_safe key_buffer_size=2G 6. Enterthefollowingcommand:

service mysqld start 7. IntheWMServerpaneloftheWMAdministratorTool,clicktheStartWMServerbutton.

Procedure 19: To adjust database values in Windows for optimal server performance

1. IntheWMAdministratorTool.(SeeWMAdministratorToolforServerAdministrationonPage119).

2. IntheWMServerpanel,clicktheStopWMServerbutton.3. FromtheWindowsOSmenu,openStartRun. 4. IntheOpenfieldoftheRundialog,enterservices.msc.5. IntheresultingServicesdialog,clicktheStandardtab.6. ClicktohighlighttherowoftheWMMySQLservicethatisrunning.7. RightclicktherowandselectStopfromthedropdownlistofoptions.


39

8. NavigatethefilesystemtothefolderC:\MySQL Server 5.1\.9. Rightclickthefilemy.iniandselectOpenWithNotepad. 10. SelectEditFind. 11. IntheFindwhattextbox,typeinnodb_.12. ClicktheFindNextbutton.13. Resetinnodbattributestothefollowingvalues:

innodb_flush_log_at_at_trx_commit=2 innodb_log_buffer_size=1M innodb_buffer_pool_size=2G1innodb_thread_concurrency=8 innodb_file_per_table=1

14. IntheServicesdialog,clicktohighlighttherowoftheWMMySQLservice.15. RightclicktherowandselectStartfromthedropdownlistofoptions.16. WhenWMMySQLstarts,clicktheStartWMServerbuttonintheWMAdministratorTool.

1Or80%ofthesizeofthephysicalmemoryinthemachine,exceptnotgreaterthan3.5G(GB)ofuserlevelmemoryperprocessina32bitsystem.


41

4 Network Discovery Setup and Debug AllchangesthataremadeintheDiscoveryConfiguratortooloftheWebStartclientareimmediatelyreflectedintheWMserverfilesystem.Onsubsequentstartups,theWirelessManagerserverreadsthediscoveryconfigurationinformation,evenifthedatabaseisnotreinitialized.

4.1 Reading Discovery Debug Messages Bydefault,detaileddiscoveryrelateddebugmessagesareloggedintheAggregatedDiscoveryLogN.txtfileunderthe/usr/local/cambium/wm/server/logsdirectoryinLinux(ortheC:\Cambium\WM\server\logsfolderinWindows).Excerptsfromthislogareasfollows:

[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 20:58:00:765] DISCOVERY using a maximum of 6 threads for Deep Discovery processing. [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 20:58:00:906] DISCOVERY(10.60.2.35:258): Device has 7 Named Field(s) [16 Feb 2012 20:58:02:359] DISCOVERY(10.60.2.35:258): setNameToMac: MO name is a valid MAC. [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] DISCOVERY(10.60.2.35:258): Successfully added object 64 ed 57 20 15 4e to database [16 Feb 2012 20:58:02:468] DISCOVERY using PDU max size 512 during deep discovery [16 Feb 2012 20:58:02:468] DISCOVERY(10.60.2.35:258): Creating Deep Discovery thread for device [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,somediscoveryeventmessagesareavailableintheclientamongtheothernetworkeventmessages.TheDiscoveryLogtaboftheDiscoveryConfiguratorintheclientprovidesthefullsetofdiscoverymessages,asitdisplaysthefullcontentsofthediscoveryLogs.txtserverfile.However,forrunningscriptsormakingselecteddumps,youmayfindthataccesstothisserverfileismoreconvenient.


42

Inaddition,someotherDiscoveryrelatedmessagesareloggedinthefilestdoutN.txtinthesamedirectory.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.ThisbehaviorisdesignedsothatupdatesinthephysicalmapdonotinterferewithWMcoredatagatheringandprocessing.Intypicalnetworks,thedelaymaybeimperceptiblebut,especiallywhileWMisinitiallydiscoveringthousandsofdevicesinaverylargenetwork,thephysicalmapmaydisplaytheupdatedinformationonlyafterminutesorevenhourshaveelapsed.

Temporarilydisablingthecapabilityofthephysicalmaptodisplaychangescanspeedtheinitialdevicediscoveryprocessbyafactorof3.Foryouroperations,thismaybemoreadvantageousthanexperiencingthedesignedlag.Asserveradministrator,youcandosoasfollows.

Procedure 20: To temporarily disable updates to the physical map display

1. StoptheWMserver.SeeReferencestoStartingandStoppingtheWMServiceonPage19.

2. Navigatetothe/usr/local/cambium/wm/server/confdirectoryinLinux(ortheC:\Cambium\WM\server\conffolderinWindows).

3. OpenthefileNmsprocessesBE.confforediting.4. Findthefollowinglines:

PROCESS com.motorola.wibb.ems.platform.server.starleaf.core.StarleafManager ARGS INCREMENTAL_DEVICE_UPDATE_ON true FULL_DATA_REFRESH_INTERVAL 86400

5. SetthevalueofINCREMENTAL_DEVICE_UPDATE_ONtofalse.6. Saveandclosethefile.7. Starttheserver.

SeeReferencestoStartingandStoppingtheWMServiceonPage19.

8. Notifytheclientapplicationuserthatthisfeatureisdisabled.9. Afterthediscovery(orotheroperationforwhichyoutemporarilydisabledthefeature)is

completed,performthefollowingsteps:

10. StoptheWMserver.


43

11. ReopentheNmsprocessesBE.conffileforediting.12. ResetthevalueofINCREMENTAL_DEVICE_UPDATE_ONtotrue.13. Saveandclosethefile.14. Starttheserver.

4.3 Getting Generic Elements Discovered WMdiscoversasagenericelementanySNMPenablednonCambiumdeviceforwhichnovaliddevicedefinitiontemplateexists.ThisisdistinguishedfromaCambiumdevices,forwhichadevicedefinitiontemplateispartoftheWMsoftwaredistribution,andfromanythirdpartydevicesforwhichtheoperatorhascreatedavaliddevicedefinitiontemplate.

However,genericelementdiscoverydependsalsoonthefollowingworkaround.ChecktoseewhetherWMhasdiscoveredallofthegenericdevicesinthenetwork.ForanythatWMdidnotdiscover,performthefollowingsteps:

1. SearchtheclientlogfortheIPaddressofthedevice.2. IfanentryisassociatedwiththatIPaddress,notewhethertheentryindicatesthatWM

regardedthedeviceasunmanaged.

3. Iftheentrydoes,openthefile...server\conf\devices\Generic_Element.xmlforediting.

4. IntheElement tag,adddisableDHCP="true",asshowninthefollowingeditedexcerpt:- -

5. Validatethexmlcontent.6. Writeandclosethefile.

TheresultisthatWMsucceedsindiscoveringallgenericelementsinyournetwork.However,WMwillusetheMACaddressastheName(ID)ofanythatsupportandproperlyimplementDHCP.

4.4 Expanding or Shrinking Areas for Presumed Logical Relationships

Basedoncomparisonsofcertainsettingsindevicetemplatesontheserverandthegeolocationsdefinedfordevicesinyournetwork,thediscoveryengineinWMpresumeslogicalrelationshipsamongdevicesanddisplaysthese.Thepresumptionsaremadewheneverboth

thegeolocationsliewithintemplatedefinedpositions(tolerances)thatestablishfourcornersofarectangle

thedevicesareofdevicetypesthattogetherhaveapresumablehierarchicalrelationship(wouldconstituteanextendedfamily).


44

Perdevicetype,thetolerancescanbeeitherthedefaultsthatthedevicetemplatehasdefinedornewonesthattheserveradministratorhaseditedintothedevicetemplate.Administratorswhoeditdevicetemplatesshouldkeepinmindthattheeditsapplytoalldevicesofthedevicetypeuntilfurthereditsaremade.

Thetolerancethatyousetisthedistanceinmeterstothenorthwest,northeast,southwest,andsoutheastfromanelementofthisdevicetype.WMwilllogicallylinktheelementtoanyelementconfiguredbytheattributetheirDeviceTypeinaKinLocationtag,ifdiscoveryfindsthatitsgeolocationiswithinthetolerance(thevalueoftheattributetolerance_minthetag).Thefollowingareexamplesoftagcontentsinthecontextoftheirdevicespecifictemplatenames:

- -

- -


45

- - -

- -


47

5 Predefined Information Structures for Device Support

TheserverfilesystemincludesstructuredinformationresourcestosupportdevicesasindicatedinTable6.

Table 6: Structured information resources per general device type

Predefined Structured Information Resource

Path to Resource ...WM/server/

Devicedefinitiontemplate1 conf/devices/Configurationvaluespushtemplate

Default Templates/Configuration Templates/

Configuredvaluesreporttemplate Default Templates/Report Templates/ Systemreport2 Default Templates/System Reports/NOTES:

1. ThesetemplatesconfigurehowWMwillrecognizethedevicetypeduringdiscoveryandhowWMshouldrepresentthedevicetypeintheuserinterface.ThetemplatesinthisdirectoryrefertoandpullinformationfromBasefilesinthetemplatessubdirectory.

2. Unlikethetemplates,thesereportsdonotsupportgenericelements.


49

6 Fault Management Configuration FaultManagementhandleserrorconditionsthatcauselossoffunctionalityofnetworkresourcesanditprovideseventmanagement,including

alertgeneration automatedactions eventcorrelation filteringfortraps,events,andalerts parsingfortrapsandevents

Thesefeaturesenablenetworkoperatorstodetect,isolate,andrepairmalfunctionsinthenetworkandinitscontrolsubsystem.

6.1 Opening Trap Ports AtrapportistheportonwhichtheWirelessManagerServerlistensforSNMPnotifications.Astheserveradministrator,youcanconfigurethetrapportsinthefile/usr/local/cambium/wm/server/conf/trapport.confinLinux(ortheC:\Cambium\WM\server\conf\trapport.confinWindows).Thefollowingcaveatsapply:

ThespecifiedportsarenotassociatedwithaparticularTrapParser,butageneralconfiguration.

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 User

Guide.

Bydefault,theprintoptionforEventsandAlarmsinWirelessManagerisnotconfigured.Toenableprinting,configurationmustbedoneinNmsProcessesBE.conffileinthe/usr/local/cambium/wm/server/confdirectoryinLinux(ortheC:\Cambium\WM\server\conffolderinWindows).ThiswillallowthecurrentcolumnsofanalertsoreventspaneltobesenttoaprinterthatexistsinthenetworkoftheWMserver(andprintingtoafileinthefilesystemof,orgreaternetworkof,theWMserver).ThefollowingisanexcerptfromtheNmsProcessesBE.conffile:


50

#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] TheprintfileargumentshouldbeconfiguredbasedonthevaluespecifiedforSAVE_DIRparameter.Whenyouexecutetheprintfunctionalityfromtheclient,WMtemporarilystoresalltheEvent/Alarmdetailsinafilenamedprintfile.tmpintheSAVE_DIRdirectory.WhenPrintisinvokedthenexttime,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,whichismaintainedbytheprintertoput

thejobintheprintqueueandprocess.

filenameisthenameofthetemporaryfilethatWMshouldwriteintotheSAVE_DIRdirectory.

Examples

SAVE_DIR state PRINT_COMMAND "lpr -S Duplex1 -P test state\\printfile.tmp"

where

Duplex1isthehostnameoftheserver. testisthenameoftheprintqueue. printfile.tmpisthefiletobeprintedinthestatedirectory.

Foraserverthatusesthesharedprinterofanotherdevice,theprintcommandshouldbeconfiguredasfollows:

SAVE_DIR state PRINT_COMMAND "cmd /c copy state\\printfile.tmp \\\\user1\HPLaserJ"

where

printfile.tmpisthefiletobeprintedinthestatedirectory.


51

user1isthedevicet

WM 4.1 Server Administration Guide - Amazon...

Documents

Transcript of WM 4.1 Server Administration Guide - Amazon...