Upload
doanhanh
View
219
Download
0
Embed Size (px)
Citation preview
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.
WM Release 4.1 Server Administration Guide Issue 1 June 2014
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.
Issue 1 WM Release 4.1 Server Administration Guide June 2014
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
WM Release 4.1 Server Administration Guide Issue 1 June 2014
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
WM Release 4.1 Server Administration Guide Issue 1 June 2014
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
Issue 1 WM Release 4.1 Server Administration Guide June 2014
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
WM Release 4.1 Server Administration Guide Issue 1 June 2014
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.
Issue 1 WM Release 4.1 Server Administration Guide June 2014
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
WM Release 4.1 Server Administration Guide Issue 1 June 2014
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
Issue 1 WM Release 4.1 Server Administration Guide June 2014
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).
WM Release 4.1 Server Administration Guide Issue 1 June 2014
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
Issue 1 WM Release 4.1 Server Administration Guide June 2014
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.
WM Release 4.1 Server Administration Guide Issue 1 June 2014
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
1. OpentheWMAdministratorTool.(SeeWMAdministratorToolforServerAdministrationonPage119).
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
1. OpentheWMAdministratorTool.(SeeWMAdministratorToolforServerAdministrationonPage119).
2. IntheWMServerpaneloftheWMAdministratorTool,clicktheStopWMServerbutton.3. IntheleftpaneloftheWMAdministratorTool,clickLicensing.4. IntheLicensingpanel,clicktheStopLMbutton.
Issue 1 WM Release 4.1 Server Administration Guide June 2014
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.
WM Release 4.1 Server Administration Guide Issue 1 June 2014
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
Issue 1 WM Release 4.1 Server Administration Guide June 2014
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.
WM Release 4.1 Server Administration Guide Issue 1 June 2014
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
Issue 1 WM Release 4.1 Server Administration Guide June 2014
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
WM Release 4.1 Server Administration Guide Issue 1 June 2014
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
Issue 1 WM Release 4.1 Server Administration Guide June 2014
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
1. OpentheWMAdministratorTool.(SeeWMAdministratorToolforServerAdministrationonPage119).
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.
WM Release 4.1 Server Administration Guide Issue 1 June 2014
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
1. OpentheWMAdministratorTool.(SeeWMAdministratorToolforServerAdministrationonPage119).
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.
Issue 1 WM Release 4.1 Server Administration Guide June 2014
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
1. OpentheWMAdministratorTool.(SeeWMAdministratorToolforServerAdministrationonPage119).
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.
WM Release 4.1 Server Administration Guide Issue 1 June 2014
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.
WM Release 4.1 Server Administration Guide Issue 1 June 2014
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.
Issue 1 WM Release 4.1 Server Administration Guide June 2014
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.
WM Release 4.1 Server Administration Guide Issue 1 June 2014
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).
Issue 1 WM Release 4.1 Server Administration Guide June 2014
44
Perdevicetype,thetolerancescanbeeitherthedefaultsthatthedevicetemplatehasdefinedornewonesthattheserveradministratorhaseditedintothedevicetemplate.Administratorswhoeditdevicetemplatesshouldkeepinmindthattheeditsapplytoalldevicesofthedevicetypeuntilfurthereditsaremade.
Thetolerancethatyousetisthedistanceinmeterstothenorthwest,northeast,southwest,andsoutheastfromanelementofthisdevicetype.WMwilllogicallylinktheelementtoanyelementconfiguredbytheattributetheirDeviceTypeinaKinLocationtag,ifdiscoveryfindsthatitsgeolocationiswithinthetolerance(thevalueoftheattributetolerance_minthetag).Thefollowingareexamplesoftagcontentsinthecontextoftheirdevicespecifictemplatenames:
- -
- -
WM Release 4.1 Server Administration Guide Issue 1 June 2014
45
- - -
- -
WM Release 4.1 Server Administration Guide Issue 1 June 2014
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.
WM Release 4.1 Server Administration Guide Issue 1 June 2014
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:
Issue 1 WM Release 4.1 Server Administration Guide June 2014
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.
WM Release 4.1 Server Administration Guide Issue 1 June 2014
51
user1isthedevicet