NetworkUpdater4 1OnLineHelpIssue1

Cambium Network Updater On-Line Help
Issue 1 System Release 4.1
August 2012 2012 Cambium Networks. All Rights Reserved.
Accuracy
Whilereasonableeffortshavebeenmadetoassuretheaccuracyofthisdocument,CambiumNetworksassumes noliabilityresultingfromanyinaccuraciesoromissionsinthisdocument,orfromuseoftheinformationobtained herein.Cambiumreservestherighttomakechangestoanyproductsdescribedhereintoimprovereliability, function,ordesign,andreservestherighttorevisethisdocumentandtomakechangesfromtimetotimein contenthereofwithnoobligationtonotifyanypersonofrevisionsorchanges.Cambiumdoesnotassumeany liabilityarisingoutoftheapplicationoruseofanyproduct,software,orcircuitdescribedherein;neitherdoesit conveylicenseunderitspatentrightsortherightsofothers.Itispossiblethatthispublicationmaycontain referencesto,orinformationaboutCambiumproducts(machinesandprograms),programming,orservicesthat arenotannouncedinyourcountry.SuchreferencesorinformationmustnotbeconstruedtomeanthatCambium intendstoannouncesuchCambiumproducts,programming,orservicesinyourcountry.
Copyrights
Thisdocument,Cambiumproducts,and3rdPartySoftwareproductsdescribedinthisdocumentmayincludeor describecopyrightedCambiumandother3rdPartysuppliedcomputerprogramsstoredinsemiconductor memoriesorothermedia.LawsintheUnitedStatesandothercountriespreserveforCambium,itslicensors,and other3rdPartysuppliedsoftwarecertainexclusiverightsforcopyrightedmaterial,includingtheexclusiverightto copy,reproduceinanyform,distributeandmakederivativeworksofthecopyrightedmaterial.Accordingly,any copyrightedmaterialofCambium,itslicensors,orthe3rdPartysoftwaresuppliedmaterialcontainedinthe Cambiumproductsdescribedinthisdocumentmaynotbecopied,reproduced,reverseengineered,distributed, mergedormodifiedinanymannerwithouttheexpresswrittenpermissionofCambium.Furthermore,the purchaseofCambiumproductsshallnotbedeemedtogranteitherdirectlyorbyimplication,estoppel,or otherwise,anylicenseunderthecopyrights,patentsorpatentapplicationsofCambiumorother3rdPartysupplied software,exceptforthenormalnonexclusive,royaltyfreelicensetousethatarisesbyoperationoflawinthesale ofaproduct.
Restrictions
Softwareanddocumentationarecopyrightedmaterials.Makingunauthorizedcopiesisprohibitedbylaw.Nopart ofthesoftwareordocumentationmaybereproduced,transmitted,transcribed,storedinaretrievalsystem,or translatedintoanylanguageorcomputerlanguage,inanyformorbyanymeans,withoutpriorwrittenpermission ofCambium.

License Agreements
ThesoftwaredescribedinthisdocumentisthepropertyofCambiumanditslicensors.Itisfurnishedbyexpress licenseagreementonlyandmaybeusedonlyinaccordancewiththetermsofsuchanagreement.SeeLegal NoticesandLicenseAgreementonPage111. 2012CambiumNetworks,Inc.AllRightsReserved.
Table of Contents
1 Introduction................................................................................................... 9
1.1 1.2
1.2.1 1.2.2 1.2.3
AbouttheNetworkUpdaterTool................................................................................... 9 AboutthisHelpDocument ............................................................................................. 9

NewinThisIssue ..................................................................................................................... 9 IntendedUse ........................................................................................................................... 9 Terminology ............................................................................................................................ 9
HighlightedElement.......................................................................................................................................................... 9 SelectedElement ............................................................................................................................................................ 10 Modulesvs.Radios ......................................................................................................................................................... 10
1.2.4 1.2.5
RelatedDocumentation ........................................................................................................ 10 Feedback ............................................................................................................................... 10
FeedbackonNetworkUpdaterTool ............................................................................................................................... 10 FeedbackonHelpFile ..................................................................................................................................................... 10
1.3
RecommendedMinimumComputerConfiguration..................................................... 11
Key Network Updater Concepts ......................................................................13

2.1 2.2 2.3 2.4 2.5 2.6 2.7 2.8 2.9 2.10 2.11 2.12 2.13 AutoDiscovery.............................................................................................................. 13 BackOffice .................................................................................................................... 13 SMAutoupdateFeature ............................................................................................... 13 Network ........................................................................................................................ 15 NetworkElementAddressingIPAddressesandHostnames..................................... 16 ImagePackageFiles ...................................................................................................... 16 ElementGroups(Folders) ............................................................................................. 16 InstallationPackage ...................................................................................................... 16 NetworkLayersandOrdersofUpdatingEquipment ................................................... 17 UpgradingHighspeedBackhauls ................................................................................. 17 TimeDurationEstimatestoCompleteaNetworkUpgrade......................................... 18 ScriptEngine ................................................................................................................. 20 SubscriberModulesAccessibility:RoutableIPsversusAPLUIDs................................. 20
Installation....................................................................................................21
3.1 3.2
3.2.1 3.2.2 3.2.3
UninstallingNetworkUpdater...................................................................................... 21 InstallingNetworkUpdateronRedHatLinux .............................................................. 21

Assumptions .......................................................................................................................... 21 Instructions............................................................................................................................ 21 ProgramUsage ...................................................................................................................... 22
3.2.4
Caveats .................................................................................................................................. 22
3.3
3.3.1 3.3.2 3.3.3
InstallingNetworkUpdateronWindows ..................................................................... 23
Assumptions .......................................................................................................................... 23 Instructions............................................................................................................................ 23 ProgramLaunch .................................................................................................................... 27
Configuration and Settings..............................................................................29

4.1 4.2
4.2.1 4.2.2 4.2.3
SecurityofToolandData.............................................................................................. 29 ConfigurationFilesandDirectories .............................................................................. 29

ArchivedLogFiles.................................................................................................................. 29 NetworkArchiveFiles............................................................................................................ 29 PreferenceFile ...................................................................................................................... 29
4.3 4.4
4.4.1 4.4.2 4.4.3
NetworkCommunications ............................................................................................ 30 ToolDependencies ....................................................................................................... 30

OperatingSystemsSupported .............................................................................................. 30 Java........................................................................................................................................ 31 ReleaseSupported ................................................................................................................ 31
4.5
4.5.1 4.5.2
ExternalToolsIncluded................................................................................................. 31
CustomLocalTools................................................................................................................ 32 ConfigureAdvantagePlatformScheduler............................................................................. 33
Features .......................................................................................................................................................................... 33 SpecificOperations ......................................................................................................................................................... 34 GUI .................................................................................................................................................................................. 35 RunningParallelInstancesofTool .................................................................................................................................. 36
4.5.3
GatherCustomerSupportInformation................................................................................. 37
Features .......................................................................................................................................................................... 37 SpecificOperations ......................................................................................................................................................... 38 GeneratingaReportFileinvolvingseveralElementsinaNetworkUpdaterArchive................................................. 38 ExtractingandViewingtheContentsofaReportFile ............................................................................................... 39
4.5.4 4.5.5 4.5.6 4.5.7 4.5.8
RebootUnit ........................................................................................................................... 39 SetAccessPointAuthenticationMode ................................................................................. 41 SetAutoupdateAddressonAPs............................................................................................ 42 SetSNMPAccessibility .......................................................................................................... 44 SetSM/CPESecurity.............................................................................................................. 45
Network Updater Operations ..........................................................................49

5.1
5.1.1
QuickStartExamples .................................................................................................... 49
UpgradingaSingleRadioBeforeDeployment ...................................................................... 49
Assumptions.................................................................................................................................................................... 49 StepstoPerformaSingleRadioLocalUpgrade .............................................................................................................. 49
5.1.2
UpgradingaSingleAPanditsAssociatedSMs...................................................................... 50
Assumptions.................................................................................................................................................................... 50 StepstoPerformaSingleAPSectorUpgrade................................................................................................................. 50
5.1.3
MinimumActionstoPerformFutureNetworkUpgrades..................................................... 51
5.2
DetailedProceduralOperations ................................................................................... 51
CreatingaNewNetworkArchiveFile ................................................................................... 51 AddingNetworkElements..................................................................................................... 52 DetectingSMsinNetwork..................................................................................................... 55 ViewingCurrentVersions...................................................................................................... 56 CurrentStateInformationonNetworkElements ................................................................. 57 IdentifyingInstallationPackageforPerformingUpgrades ................................................... 58 EnsuringtheNetworkisConfiguredforUsingSMAutoupdate............................................ 58 DeterminingWhereSMsWillObtainPackageFiles.............................................................. 59 InitiatingorDiscontinuingaNetworkUpgrade .................................................................... 59 SchedulinganUpgradeforaFutureTime ........................................................................ 61 ExaminingtheNetworkforStragglerElementstobeUpgraded ..................................... 61 DisablingAutoupdateafterallSMshavebeenUpgraded................................................ 62 SavingCurrentStatusInformationintheNetworkArchiveFile....................................... 62 RefreshingtheStatusInformationUponStartUp ........................................................... 62 UsingNetworkUpdatertoRunAuxiliaryScriptsAgainstyourNetwork.......................... 62 FileMenu............................................................................................................................... 63
5.2.1 5.2.2 5.2.3 5.2.4 5.2.5 5.2.6 5.2.7 5.2.8 5.2.9 5.2.10 5.2.11 5.2.12 5.2.13 5.2.14 5.2.15
5.3
5.3.1
GUIMenuOperations................................................................................................... 63
FileNewNetworkArchive ............................................................................................................................................ 63 FileLoadNetworkArchive............................................................................................................................................ 63 FileSaveNetworkArchive............................................................................................................................................ 64 FileSaveNetworkArchiveAs ....................................................................................................................................... 64 Fileanyoffivemostrecentfiles .................................................................................................................................. 64 FileExit ......................................................................................................................................................................... 64
5.3.2
EditMenu .............................................................................................................................. 64
EditPreferences ........................................................................................................................................................... 65 EditShow/HideExtendedElementInformation .......................................................................................................... 67 EditManageSubscriberModulePasswordList............................................................................................................ 68 EditAddElementstoHighlightedElement .................................................................................................................. 69 EditAddElementstoNetworkRoot............................................................................................................................. 70 EditRemoveSelectedElements ................................................................................................................................... 71 EditModifyHighlightedNetworkElementAccess ....................................................................................................... 71 EditChangeNetworkElementType............................................................................................................................. 73 EditMoveSelectedNetworkElements ........................................................................................................................ 73 EditOpenHighlightedNetworkElementWebPage .................................................................................................... 73 EditUndoNetworkChanges ........................................................................................................................................ 74 EditFind........................................................................................................................................................................ 74
5.3.3
ViewMenu ............................................................................................................................ 74
ViewRefresh/DiscoverEntireNetwork........................................................................................................................ 74
ViewRefresh/DiscoverSelectedNetworkElements .................................................................................................... 74 ViewRefresh/DiscoverSelectedNetworkBranches .................................................................................................... 75 ViewContinuousRefresh ............................................................................................................................................. 75 ViewClearHistoryLogWindow ................................................................................................................................... 75 ViewShowFullHistoryLog .......................................................................................................................................... 76 ViewHorizontalScrollDeepTree ................................................................................................................................. 76
5.3.4
UpdateMenu ........................................................................................................................ 76
SMAutoupdateConfigurationTab ............................................................................................................................ 79 HPAPChannelBandwidthTab ................................................................................................................................... 81
UpdateConfigure ......................................................................................................................................................... 77
UpdateHttpServerConfigure...................................................................................................................................... 84 UpdateManagePackages ............................................................................................................................................ 85 UpdateUpdateEntireNetworkRoot ........................................................................................................................... 88 UpdateUpdateSelectedNetworkElements................................................................................................................ 89 UpdateUpdateSelectedNetworkBranches ................................................................................................................ 89 UpdateEnable/DisableAPsforSMAutoupdate .......................................................................................................... 90 UpdateScheduleNetworkUpdate............................................................................................................................... 90 UpdateUploadCertificatetoSelectedElements ......................................................................................................... 92 UpdateUploadCertificatetoSelectedBranches ......................................................................................................... 93
5.3.5
ToolsMenu............................................................................................................................ 93
ToolsAddExternalTooltoMenu ................................................................................................................................. 93 ToolsEditExternalToolMenu...................................................................................................................................... 94 ToolsLaunchExternalTool........................................................................................................................................... 94 IncludedNetworkUpdaterExternalTools ...................................................................................................................... 95
5.3.6
HelpMenu............................................................................................................................. 96
HelpContents............................................................................................................................................................... 96 HelpToolsToolName................................................................................................................................................. 96 HelpAbout ................................................................................................................................................................... 96
5.4
5.4.1 5.4.2 5.4.3 5.4.4 5.4.5 5.4.6 5.4.7 5.4.8
UserConvenienceActions ............................................................................................ 96
Rightclicktomanipulateselectedelement .......................................................................... 96 Doubleclicktomodifyelement ............................................................................................ 97 SelectallElementsofabranch ............................................................................................. 97 SortingNetworkElementsbyColumnValues....................................................................... 97 ChangeOrderofColumnsDisplayed .................................................................................... 97 ChangeDisplaySizeofColumnDisplayed............................................................................. 97 LastSettingsonExternalToolsRemembered....................................................................... 98 MouseOverDisplayofTreeContents .................................................................................. 98
Command Line Operations .............................................................................99

6.1 6.2 Introduction .................................................................................................................. 99 Usage............................................................................................................................. 99
Building Custom External Tools.....................................................................103

7.1 ParametersPassedtoExternalTools ......................................................................... 103
HostAddress....................................................................................................................................................... 103 ESN(ElementSerialNumber) ............................................................................................................................. 103 MACAddress ...................................................................................................................................................... 103 ElementType...................................................................................................................................................... 104 EncryptionType.................................................................................................................................................. 104 SNMPCommunityString .................................................................................................................................... 104 DeviceLoginID/Password .................................................................................................................................. 104 SoftwareVersionString ...................................................................................................................................... 105 SoftwareBootString .......................................................................................................................................... 105 FPGAVersionString............................................................................................................................................ 105 SiteName ........................................................................................................................................................... 105 SiteContact ........................................................................................................................................................ 105 SiteLocation ....................................................................................................................................................... 105 DetectedParent ................................................................................................................................................. 105 DetectedParentPassword ................................................................................................................................. 105
7.2 7.3
7.3.1
ExternalToolHelp....................................................................................................... 106 ExternalToolExtendedAttributes.............................................................................. 106

JavaExtendedManifestAttributes ..................................................................................... 106
Acronyms and Abbreviations ...............................................................................109 Legal Notices and License Agreement...................................................................111 Troubleshooting ................................................................................................117
AutoupdatesourceaddressisnotsetonAPs .................................................................................................... 117 AnerroristhrownwhenItrytoenableSMAutoupdateonanAP.................................................................... 117 Updateofnetworkelementsworks,butSMAutoupdateneveractivatesonAPs............................................. 117 NetworkUpdaterserverIPaddresschanged,andSMAutoupdatenolongerworks ........................................ 117 SMAutoupdatewithexternalTFTPserverisnotworking ................................................................................. 118 APtelnetInterfaceshowsAutoupdatedisabledafterNetworkUpdaterenablesit .......................................... 118 NetworkUpdatertriestoupdateanalreadyupdatedSMwhenusingSMAutoupdate.................................... 118 Updateofradiodevicesworksfine,butupdatesofCMMmicroplatformsfail................................................. 118 Iamapplyinganupdatetoanunsupportedrelease .......................................................................................... 119 NetworkUpdaterdoesnotdiscoverorupdateSMs .......................................................................................... 119 AnAPgoesdownduringanupdate ................................................................................................................... 119 Ifmyradiowebinterfaceislockingup,willNetworkUpdaterstillwork? ......................................................... 119 IcannotdowngrademyR8.xradiostoR7.x ....................................................................................................... 120 AnHSBHlinkdroppedduringanupgrade,andthefarendHSBHdoesnotrespond ........................................ 120 NetworkUpdaterhangsloadingpackagesorperforminganupdate................................................................. 120
Resources for Support ........................................................................................121

NetworkUpdaterHelp............................................................................................................ 121 CommunityForum .................................................................................................................. 121
TechnicalSupport ................................................................................................................... 122
Network Updater On-Line Help
Issue 1 August 2012
1
1.1
Introduction
About the Network Updater Tool
TheNetworkUpdaterToolisafreeofchargetoolthatappliespackagestoupgradethedevicetypes thatthereleasenotesforthereleasethatyouareusinglistassupported.Becausethistoolis available,anoperatordoesnotneedtovisiteachmoduleinthenetwork,oreveneachAPwhere theywouldotherwiseusetheSMAutoupdatecapabilityoftheradios. CertaindevicessuchasPMP320SeriesAPsandSMsandsomebackhaulsdonotsupportthe SMAutoupdatefeature.Forthesecases,NetworkUpdaterreportstotheuserthatthisfeaturedoes notapply.
1.2
1.2.1
About this Help Document

New in This Issue
AnadmonishmenthasbeenaddedtoSMAutoupdateFeatureonPage13andEnsuringtheNetwork isConfiguredforUsingSMAutoupdateonPage58,statingthatSMautoupdateissupportedforSMs whoseNetworkAccessibilityparameter(intheIPtaboftheSM'sConfigurationmanagementweb page)issettoLocal,notPublic.
1.2.2
Intended Use
ThisHelpdocumentationshouldbeusedwiththeNetworkUpdatertool.Theaudienceforthistool anddocumentincludessystemoperatorsandnetworkadministrators. Thesehelpfilescovertheentiregraphicaluserinterfacesofthetool,aswellasthesupporting conceptsandconfigurationsrequiredensuringproperoperationofthetool.Inadditiontodetailed functionaldescriptionsofeachfeaturefoundunderGUIMenuOperationsonPage63,thishelpfile providesDetailedProceduralOperationsonPage51forperformingnetworkupgradesandprovidea setofQuickStartExamplesonPage49onhowtousethetool.Troubleshootingandsupport informationisincludedattheendofthehelpfile.
1.2.3
Terminology
Highlighted Element
Whenthisdocumentmentionsthehighlightedelement,itreferstomovingyourmouseoverany portionofitsrowandclickingonitsuchthattherowbecomeshighlighted.Thisactionistypically usedwhenyouaremanipulatingasinglenetworkelement.
Issue 1 August 2012
Selected Element
WhenthisdocumentoraGUIoptionmentionstheselectedelement,itreferstoclickinginthecheck boxatthefrontofanetworkelementlinesuchthatacheckmarkappearsinthatbox.Thismethodis usedtospecifyoneormorenetworkelementsuponwhichtoperformacomplexoperation,suchas initiatinganupdateto,launchinganexternaltoolon,orperformingmasschangestoelements.
Modules vs. Radios

Thesehelpfilesmakeuseofthetermmoduleswhenreferringtoallnetworkcomponents,suchas APs,SMs,BHs,andCMMs.WhenacommentonlyappliestotheRFportionsofthenetwork,theterm radiosisused.Inthiscontextthetermradioscanbeconsideredasubsetofmodules.
1.2.4
Related Documentation
Theusermayfindotherdocumentationusefulinunderstandingconceptsormanipulatingthe networkinconjunctionwiththeNetworkUpdatertool;inparticular systemreleasenotes(ontheradios) clustermanagementmodule(CMM)userguides(onmanuallyupdatingaCMM). Releasespecificsystemuserguidesandtheirsuccessor,FixedWirelessBroadbandIP NetworksUserGuide:PMP100PMP400/430PTP100PTP200,(onmanuallyupdating anAP,configuringanAPfornetworkcommunicationsandmanagementcontrol,andthe SMAutoupdatefeature). PrizmRelease3.3UserGuide(onnetworkdiscovery).
1.2.5
Feedback
CambiumNetworkswelcomesandencouragesfeedbackonourproductsandourdocumentation. Pleasefeelfreetomakeuseofthesemechanismsforlettingusknowyourthoughtsandinputson theNetworkUpdatertool.
Feedback on Network Updater Tool

IfyouhaveinputonhowNetworkUpdatertoolisworkingorneedtoreportaproblemwiththetool, weencourageyoutosendthosetotechnicalsupportattheemailaddresslistedunderTechnical SupportonPage122foryourregion.
Feedback on Help File

Wewelcomeyourfeedbackondocumentation,includingfeedbackonstructure,content,accuracy, completeness,orothercommentsyouhave.Pleasesendyourfeedbackto support@cambiumnetworks.com.
10
Issue 1 August 2012
1.3
Recommended Minimum Computer Configuration

ThefollowingshouldbeconsideredwhenselectingacomputertoruntheNetworkUpdatertool. TheNetworkUpdatertoolsupportseitherWindowsorRedHatEnterpriseLinuxplatforms. Specifically,thisNetworkUpdaterreleasesupports WindowsPlatforms(32bitOS) Windows2000 WindowsServer2003 WindowsXPorXPProfessional Version4 Version5
RedHatEnterpriseLinux(32BitOS)
Thecomputerwillneednetworkaccesstoconnecttothedevicesbeingupgraded. Thecomputershouldalsohavesufficientmemorytoruntheapplicationaswellasloadthevarious softwarepackagesthatwillbeusedtoupgradethedevices.Aminimumof512MBofRAMis recommended,thoughdependingonyournetworksizeandnumberofuniquetypesofdevices,you maybeabletogetawaywithlessRAM.SeethetopicNetworkUpdaterhangsloadingpackagesor performinganupdateonPage120inthetroubleshootingsectionformoreinformationonmemory restrictionissues.
11
Issue 1 August 2012
2
2.1
Key Network Updater Concepts

Auto Discovery
AutoDiscoveryisthecapabilityfortheNetworkUpdatertooltoautomaticallypopulateitsnetwork componentlistwiththeSMsthatareinyournetwork.Thisinformationisautomaticallypulledfrom theAPs,thussavingthenetworkadministratorthetroubleofenteringallofthatinformation,and helpingtoensureconsistenceandaccuracyofthenetworkcomponentsbeingmanipulated.Itshould benotedthatautodiscoveredSMsarereferencedthroughtheAPLUIDcapabilityinsteadofthrough adirectIPaddresstotheSM.Becauseofthisfact,autodiscoveredSMsmustbeupdatedusingthe SMAutoupdatecapabilityofthesystem.SeeSMAutoupdateFeatureonPage13formoredetails.
2.2
Back Office
TheBackOfficeisthelocation(s)thenetworkoperatorrunssupportinfrastructurefortheirnetwork thatdoesnotneedtobelocatedateithertheCPEorthebasestationlocations.Suchsupport infrastructuremayincludeBillingandProvisioning,NetworkMonitoring,Networkfirewall,Mail servers,Internetinterconnectionequipment,etc.
2.3
SM Autoupdate Feature
TheradiosinseriesotherthanPMP320haveafeaturecalledAutoupdate,whichallowsanAPto instructanSMtoperformasoftwareupgrade.WewillusethetermSMAutoupdateinthis documenttoclarifythatthisAutoupdateoperationonlyaffectsSMsinthenetwork.TheAPexamines thecurrentsoftwareversionandFPGAversionsontheSMtodetermineifanupdateisrequired,and ifrequireditgivesthecommandtotheSMtoperformtheappropriateupdate.Asapartofthe command,theAPtellstheSMwhereitcanobtainthelatestsoftwareandfirmware.Optionsinclude from theAP. aspecifiedCNUTHTTPserver. aspecifiedlocalTFTPserver.
note ............. Network Updater only uses TFTP in conjunction with SM Autoupdate if it is located on the same network computer that the Network Updater program is running on.
Thisfeaturereducestheamountofindividualradiomanipulationthatisrequiredtoupgradean entirenetwork,butonitsowndoesnotpreventthenetworkadministratorfromindividually accessingAPandBHradiosandmanuallyperformingupgradesoftheseradios.TheNetworkUpdater ToolextendsthecapabilitiesprovidedbytheSMAutoupdatefeaturestomakeaonetouchnetwork upgradepossible. SMAutoupdatecanmakeupgradingofanetworkbothfastandefficientbut,forautodiscovered SMs,istheonlymechanismtoautomaticallyupgradethesoftwareandFPGAontheSMs.Thisis because,withoutadirectIPaddress,theNetworkUpdatercannotdirectlycommunicatewithanSM, andthereforemustrelyonthevirtualproxycapabilitythroughtheAPprovidedbytheSM AutoupdatefeaturetoinitiateupgradesoftheseSMs.
13
Issue 1 August 2012

important ........... SM Autoupdate is supported for SMs whose Network Accessibility parameter (in the IP tab of the SM's Configuration management web page) is set to Local, not Public. Even where Network Updater can discover SMs as children of their APs, if their Network Accessibility is set to Public, then Network Updater must discover them directly.
NetworkUpdaterinitiatesandterminatestheSMAutoupdatemodewithinAPsbyusingtheHTTP, HTTPS,orTFTPprotocol.TheSMAutoupdatemodeinanAPremainsactiveonlyuntiltheuserturnsit off(manuallyorthroughanothercommandthatNetworkUpdatersends)ortheAPreboots.For securitypurposes,theAPacceptsthiscommandfromasingleIPaddress,whichisspecifiedintheAP configurationpages.Forconvenience,NetworkUpdaterautomaticallysetsthisvalueintheAPtothe IPaddressoftheNetworkUpdaterserverwhenitperformsanyoftheupdatecommands (UpdateUpdateEntireNetworkRootonPage88,UpdateUpdateSelectedNetworkElementson Page89,orUpdateUpdateSelectedNetworkBranchesonPage89).Theseoperationscanuse eitheranIPaddressspecifiedbytheuserorandetectedIPaddressthattheAPderivesfromits communicationswithNetworkUpdater.Aslongastheuserperformsanupdateoperationbefore enablingtheSMAutoupdatecapabilitiesontheAP(byusingtheoperationUpdateEnable/Disable APsforSMAutoupdateonPage90),therewillbenocommunicationissuebetweenNetworkUpdater andtheAP.ForthecasewheretheuserwishestosettheIPaddressintheAPseparatefromthe automaticsetting,NetworkUpdaterprovidesanauxiliaryscriptthatallowstheusertodothis.For detailsonthisscript,seeSetAutoupdateAddressonAPsonPage42. 1 TheusershouldbeawarethatsinceNetworkUpdaterusestheUDPcommandmethodforenabling anddisablingofSMAutoupdateonAPs,theusermaynotgetanaccuratestatusresponsefromthe APiftheyareusingtheTelnetinterfaceonanAPtoinquireonthestatusofAutoupdateontheAP. ThisisbecausetheTelnetinterfacewillonlyreportonthestatusofAutoupdatebasedonprevious TelnetcommandswithouttakingintoaccountiftheAPreceivedaseparateUDPcommandfor Autoupdate. StartingwiththedeviceRelease8.1,softwareimagesweredeliveredintwoplatformformats(big EndianandlittleEndianformats)tosupporttwodifferentCPUsrunningontheradios.Thecapacityof thefilesystemonanAPhandlesthesoftwareimagesforonlyoneplatformatatime.Thismeansthat SMAutoupdate,whenfinishedwiththeAPastheimagedistributionsite,canhandleonlyonetypeof SMatatime.ToaddresstheissuewhereasingleAPiscommunicatingwithSMsofbothCPUformats, NetworkUpdaterautomaticallymonitorstheprogressofSMAutoupdateineachsectorofthe network,andswitchestheimagesandinstructionsgiventotheAPfromonesetofimagestothe otherafterallSMsoftheinitialformathavebeenupdated.NetworkUpdaterstartstheAutoupdate processonagivensectorusingtheimageformatassociatedwiththemajorityoftheSMswithinthe sector.AfterAutoupdateactivitywithinthesectorceasesforaperiodoftime,NetworkUpdater detectswhetherSMsoftheotherplatformtypeexistinthesectorand,iftheydo,switchestheAPto administerSMAutoupdateimagesfortheotherplatformtype.ThisimageswappingontheAPcan continueuntileitherallactiveSMsareupdatedorSMAutoupdateisturnedoffinNetworkUpdater. LaterpackagessupporttheNetworkUpdatercapabilityto 1. 2. scantheSMsthatareregisteredtotheselectedAPandthusretrievetheirhardware platformversions. runAutoupdatetothoseSMsthathavethemostcommonhardwareplatformversioninthe sector,thenrunittothosethathavethenextmostcommon,andsoforth.
FormoreinformationonNetworkUpdaterscriptcapabilities,seeScriptEngineonPage20.
14
Issue 1 August 2012
2.4
Network
TheNetworkreferredtobytheNetworkUpdateristhesetofAP,SM,BHradiosaswellasCMM platformsthathaveupgradeablesoftware(suchasCMMMicro).Itisassumedthatthenetwork operatorhasdeployedthesecomponentswithinasinglenetworklayout,suchthatacomputerinthe backofficeoratthePOPcancommunicatewiththesemodulesformanagementpurposes.Although NetworkUpdaterreferstoNetworkElementsinagenericsense,theusercanassumethateach networkelementrepresentsadeviceintheirnetwork. Thefollowingsetofnetworkelementtypesaresupported:
NetworkUpdaterusesthefollowingsetoficonstorepresentvariouselementswithinyournetwork: Icon Device Type PTP300/400HSBH PTP110BH2/BH4 PTP120BH PTP130/200BH20 PTP230BHUL PTP230BH10 PMP320SeriesAP PMP100/400/430/500AP PMP100APAS PMP100APL PMP100/400/430/500SM PMP320SeriesSM
15
Issue 1 August 2012 Icon Device Type CMMmicro CMM4 CMM4ES14(14portswitch) CMM4ES8(8portswitch) Group(nonelement)
2.5
Network Element Addressing IP Addresses and Hostnames

NetworkelementsaredirectlyreferencedbytheNetworkUpdaterthroughtheuseofIPAddresses suppliedbytheuser.TheNetworkUpdateralsosupportstheuseofstandardHostnames,whichare basicallyaliasnamesforIPaddresses.HostnamesareautomaticallytranslatedbytheNetworkOS layerintoIPaddressesthroughtheuseofeitherDNSserversoralocal/etc/hostsfileonLinuxor theC:\WINDOWS\system32\drivers\etc\hostsfileonWindowsplatforms.
2.6
Image Package Files

Cambiumnetworksusesavarietyofimagepackagefilesforcontrollingmodules.Foragivendevice, thesemaybeasoftwarefile(referredtobyitssoftwarereleasename),asoftwarebootfile(referred tobyitsbootfilename),andafirmwarefile(referredtobyitsfirmwarefilename).Thefirmwarefile sometimesreferredtoasanFPGArelease.ForCMMswithupgradeablesoftware,thereisoneCMM softwarefile(referredtobyitsCMMsoftwarename).NetworkUpdaterhidesmostofthiscomplexity fromtheusersbypackagingallvariationsoftheupgradefilesintoasingleinstallationpackagefile (seeInstallationPackageonPage16).
2.7
Element Groups (Folders)

Foruserconvenience,networkelementscanbecombinedintouserdefinedelementgroups (folders).Thesegroupsorfolderscanhelporganizethedisplayofthevariousnetworkelements,such asbyAPclusterorregionaldistribution.Byselectingagrouplevelitem,theusercansimultaneously performoperationsonallelementswithinthegroup.Groupleveldefaultscanbesetforthedevice loginIDandpasswordaswellastheSNMPcommunitystringvaluestobeusedforallelementswithin thegroup.
note ............. Any element within the group can override the group level default with a specific value for only that element if required. The user need not create any groups if they dont wish to, but there is always one group created at the top level by the Network Updater tool, which is referred to as Network Root.
2.8
Installation Package
AninstallationpackageforNetworkUpdaterisaprepackagedsetofsoftware,boot,andhardware filesforallversionsofradiosandCMMplatforms.Theadministratordoesnotneedtoopenor individuallymanipulatethesefileswhenusingNetworkUpdater.NetworkUpdatercanintelligently extractthecorrectfilesfromthepackageforthespecificmodulesinquestion,including
16
Issue 1 August 2012
distinguishingtheneedforAESorDESencryptionloads.Amanifestfilethatisembeddedineach package,whichcanbeviewedthroughtheManagePackagesoperation,providesdetailsofthe contentsofeachpackage(seeUpdateManagePackagesonPage85). TherearethreeversionsoftheNetworkUpdaterInstallationPackageformat: Network Updater Version 1.00 1.10 2.00 2.20 3.10 3.20 4.0,4.1 NOTES:
1. 2.
Radio System Release 4.1through7.3 4.1through7.3 7.x1andlater 7.3.62andlater 8.4andlater
Package
Usespackageformat.pkg
Usespackageformat.pkg2
Usespackageformat.pkg3
Notallhistoricalreleasemaybeavailableinthenewpackageformat. ConsulttheCambiumNetworkswebsiteforpackageavailability. EarlierpackagesifneededmaybeavailablethroughTechnicalSupport.
2.9
Network Layers and Orders of Updating Equipment

Anetworkcancontainmultiplelayersofequipment;withalayermeaningthatonepieceof equipmentisbehind(receivingitsnetworkconnectivitythrough)anotherpieceofequipment.For exampleanAPmaybebehindaBH,orSMsarebehindanAP.Itisimportanttoproperlyportray theselayersofthenetworkwithinNetworkUpdater,sothatNetworkUpdatercanperformmodule andAPclusterupgradesinanappropriateorder.ProperlayerinformationensuresthatNetwork UpdaterdoesnotcommandanAPthatisbehindanotherAP/SMpair(suchasaremoteAP installation)todoanupgradeatthesametimeastheSMthatisfeedingtheAP.Ifthiswasdonethen theremoteAPwouldloseitsnetworkconnectioninthemiddleofanupgradewhentheSMitwas attachedtocompleteditsupgradeandrebooted.ThesectionAddingNetworkElementsonPage52 containsadditionaldetailsaboutlayingoutyournetworkhierarchywithinNetworkUpdater, specificallyforAPs,SMs,PTP100SeriesEthernetbridges,andCMMtypedevices.Whenupgrading HSBHssomeadditionalcareisneededindefiningtheelementhierarchy,thisisdocumentedunder UpgradingHighspeedBackhaulsonPage17.
2.10
Upgrading High-speed Backhauls

HSBHshavetheuniquerequirementthatthefarsideofalinkmustbeupgradedpriortothenear side.ByfarsideitismeantthesideofthelinkforwhichcommunicationsfromtheNetworkUpdater computerarerequiredtotraversethewirelesslinkbetweenthetwoendsofthebackhaulpair. DuringtheupgradeprocessoftheHSBHsthetwoendsofthelinkwilllosecommunicationsafterone unithasbeenupdated,andwillnotregaincommunicationuntilthesecondsideisupdatedtothe
17
Issue 1 August 2012
samesoftwarereleaseasthefirstunit.Therefore,ifthefarsideisnotupgradedfirst,thelossof communicationwillpreventaccesstothefarsideandpreventasuccessfulupgradeofthebackhaul link. Tosupportthisrequirement,NetworkUpdaterwillautomaticallyplacePTPlinksinahierarchalmode whenrefreshingthenetworkelements.DuringaFirmwareupgrade,NetworkUpdaterwillupdate bothendsofthelinkssimultaneously.Thiswillpreventanyissueswithunitslosingconnectivity. Whiletheaboveprocessisautomatic,itmaybenecessarytomanuallyperformupdatesonunits. ThefollowingisthemanualwaythatHSBHsshouldbeupdatedusingtheNetworkUpdatertool: 1. 2. 3. 4. WhendefiningthehierarchyoftheHSBHlink,theparentdeviceshouldbethefarsideofthe linkandthechildshouldbethenearsideofthelink. Upgradesshouldalwaysoperateonbothsidesofthelinkinthesameoperation. TheContinueUpdatingChildElementsifParentElementFailstoUpdateoptionmustbeset beforeinitiatingtheupgradeoftheHSBHpair(seeUpdateConfigureonPage77). Aftertheparentunit(farside)isupdated,theNetworkUpdaterwillattempttoverifythe upgrade.Thisverificationwillfailduetothelossofthelinkduringtheupgradeprocess. Ignorethisfailureerror. Afterthechildunit(nearside)isupdated,NetworkUpdaterwillperformaverificationofthe childsupgrade,whichcompletewithasuccessfulstatemessage. Aftertheupgradeoperationhascompleted,performaRefresh/DiscoverSelectedNetwork Elementsoperationontheparentunits(seeViewRefresh/DiscoverSelectedNetwork ElementsonPage74).Thiswillgathercurrentinformationonthefarsideofthelinkwhich shouldnowbecommunicatingwiththenearsideagainandclearoutthefailuremessage seeninStep4above.
5. 6.
BecauseofthisslightlydifferentprocessandparadigminvolvedinupgradingHSBHsinthenetwork, theNetworkUpdaterusermayfinditeasiertocreateaseparateNetworkArchivefilejustfor performingupgradesontheirHSBHelementsoftheirnetwork.
2.11
Time Duration Estimates to Complete a Network Upgrade

Theamountoftimeitwilltaketoupgradeanyparticularnetworkwillvarybasedonmultiplefactors, suchas(generallyinorderofbiggestimpacttosmallest): Thetotalupgradetimewillalsobeaffectedbythespeedandperformanceofthecomputer thatisrunningtheNetworkUpdatertoolandthenumberofsimultaneousupdatesessions theyspecifyintheUpdateConfigurationwindow(seeUpdateConfigureonPage77). WhetherornotSMAutoupdateisbeingusedtoupgradetheSMsinthenetwork. Thetotalnumberofnetworkelementsbeingupdated, Theconfiguration(hierarchy)ofthenetworkelements, Thetypeofelementsbeingupdated
Ittakesapproximately4.5minutestoupdateanetworkelement.Thistimeincludesfiletransfertime topushthenewsoftwareandFPGAtotheelement,programmingtimetoburninthenewfilestothe module,andtimetoreboottheelementusingthenewlyupgradedsoftwareandFPGA.Thistimeis reducedifonlythesoftwareoronlytheFGPAoftheelementisbeingupgraded.
18
Issue 1 August 2012
Anetworkupgradetypicallyrequiresthefollowingamountsoftime: 30secondstotransferthesoftwareandFPGAfilestoanelement 80secondstoburnintheFPGAloadintoanelement 130secondstoburninthesoftwareloadintoanelement 30secondstorebootanelement
TheAPinSMAutoupdatemodehasthefollowingcapacity: APSupportsupto4simultaneousupdatesofsoftware/FPGAfilestoSMswhen SMAutoupdateisenabledandtheAPisusedasthefileserver. APSupportsupto20simultaneousupdatesofsoftware/FPGAfilestoSMswhen SMAutoupdateisenabledandalocalHTTPorTFTPserverisused.
Thefollowingtablesshowssomenetworkupgradetimes.Theseassumeareleasewithnewsoftware andFPGAforeachelement,thatSMdistributionisevenacrossallAPs,andthatallSMsareonthe networkandavailableforupdate.Thelayernumberreferstohowmanyhopsawaythefurthest networkelementisfromtheNetworkUpdatercomputer. Estimated example network upgrade durations Layer 1 1BH 1BH 3BH +6AP 3BH +6AP 3BH +12AP 3BH +12AP
NOTES: 1. 2. 3. 4. 5.
Layer 2 1BH 1BH 3BHs +100SM 3BHs +100SM 3BHs +1,000SM 3BH +1,000SM
Layer 3 6APs 6APs 36AP 36AP 2BH +36AP
Layer 4 200SM 200SM 2,000SM 2,000SM 2BH +3,000 SM
Layer 5 N/A N/A N/A N/A
Layer 6 N/A N/A N/A N/A
Elements 208 208 2,148 2,148
Notes 1,3,5 2,4,5 1,3,5 2,4,5
Estimate 59mins 23mins 122mins 41mins
24AP 2,000SM
6,082
1,3,5
189mins
2BHs 2BH +36AP +3,000SM
24AP 2,000SM
6,082
2,4,5
68mins
UsestheAPasthefiletransferserverforSMAutoupdate. UsesanexternalTFTPserverforSMAutoupdateassumesTFTPservercanhandleallconnection requestsandnetworkbandwidthisnotalimitingfactorbetweenTFTPserverandSMs. Usesdefaultvalueof4simultaneousupdatesfromNetworkUpdater. IncreasessimultaneousupdatesfromNetworkUpdaterto20. TimeestimatesdonottakeintoaccounttimeforswitchingSMAutoupdateimagetypesonanAP. EstimatesassumeonlyoneimagetypeofSMsisonthesameAP. OveralltheseexamplesaremeanttoemphasizethattheprocessingpoweroftheNetworkUpdater computer(tosupporthighersimultaneousupdates)andthedepthofthenetworktreearethemost significantfactorstodeterminehowlonganetworkupgradewilltake.Thebreadthofthetree, thoughitrepresentsthemajorityoftheelementsinthenetwork,doesnotgreatlyaffecttheupgrade timewhentheSMAutoupdatecapabilitiesarefullyused.
19
Issue 1 August 2012
SincetheSMAutoupdatefeatureisnotavailableinPMP320sectors,thebreadthofthetreecanbea significantfactorinthetimerequiredtocompleteacompletesectorupgrade.
2.12
Script Engine
TheScriptEngineisthecapabilitywithintheNetworkUpdatertorunanyuserdefinedscriptagainst anynetworkcomponentorgroupofcomponents.Thiscanbeveryusefulformanagementscriptsor anyotherscriptthatisrunrepetitivelyacrossyourNetwork.Byhavingthiscapabilitywithinthe NetworkUpdateritensuresyouarerunningyourscriptacrossallofyourcomponents(becauseof theNetworkUpdatersAutoDiscoverycapability),andallowsyoutomaintainonemasterlistofall equipmentyouneedtorunscriptsagainst.TheNetworkUpdaterreferstotheseuserdefinedscripts asExternalTools.SeeBuildingCustomExternalToolsonPage103foradditionalinformationonthis topic.
2.13
Subscriber Modules Accessibility: Routable IPs versus AP LUIDs

TherearetwowaysSMsinanetworkcanbeaccessed.ThemoredirectwayisifaroutableIPaddress isassignedtotheSMsuchthatauseronamanagementserveronthenetworkcandirectlyaccess theSM(suchasthroughtheNetworkUpdatertool).BydefaultanSMhasanonroutableIP addressedassigned,sounlessthenetworkoperatorchangesthisfortheSM,directaccesstotheSM isnotpossible.Inthatinstance,theSMcanbeaccessedbyfirstcommunicatingwiththeAPthatthe SMisattachedto,andthenreferencingtheSMbytheLUIDassignedbytheAPtotheSM.TheLUIDis avalueassignedbytheAPwhentheSMregisterswithit.TheNetworkUpdaterwillonlybeableto directlyupdateSMsthathaveroutableIPaddressesassignedtothem.
AllotherSMsmustbeupdatedthroughtheuseoftheSMAutoupdatefeature(seeSMAutoupdate FeatureonPage13),whichcanbecontrolledandmanagedthroughtheNetworkUpdater.Ingeneral, mostSMsshouldbeupdatedbytheSMAutoupdatecapabilityasitallowsgreaterconcurrent updatestooccurthroughoutthenetworkthusminimizingtheoveralltimeanetworkupgrade requires.However,SMAutoupdateisnotavailableinPMP320seriessectors.Inthesesectors,SMs areupdatedinparalleldirectlybyNetworkUpdater,andtheAPplaysnoroleintheupdate. IndividualupgradestoaddressoneoffissuescanbedonedirectlytoanSMininstanceswheremost ofthenetworkdoesnotneedtobeupgraded,oraspecialsoftwareloadisbeingputononeormore SMsfortestingorotherpurposes.
20
Issue 1 August 2012
3
3.1
Installation
Uninstalling Network Updater
TheNetworkUpdaterToolcomeswithanuninstallprogramthatcanberunbytheuser.Generally, whenupgradingfromoneversionofNetworkUpdatertoanother,thereisnoneedtouninstallthe previousversion.Ifyouwishtodowngradefromahigherversiontoalower,youmaynotbeableto dothiswithoutuninstallingthehigherreleaseversionfirst.Ifthisisnotdone,theninstallationerrors, suchasnotbeingabletoproperlyselecttheinstallationdirectoryforthedowngrademayoccur.
important ........... When downgrading Network Updater from a new version to an older version, it may be necessary to uninstall the newer version before installing the older version.
3.2
3.2.1
Installing Network Updater on Red Hat Linux

Assumptions
1. 2. 3. YouhaveaLinuxmachinewithasupportedversionalreadyinstalledandareabletoopena commandlineterminal. YouhaverootaccesstotheLinuxmachineinwhichyouwillbeinstallingthissoftware. ThereisafunctioningwebbrowseravailableonthemachineforusebytheNetwork Updaterhelpsystem,underoneofthefollowingcommands:
mozilla firefox htmlview
Ifthisisnottrue,thentheusermayneedtoedittheCNUTLauncher.shscriptwithintheNetwork Updaterinstallationdirectorytoindicatethenameand/orlocationoftheirwebbrowserbeforebeing abletoaccessonlinehelpforthetool.
3.2.2
Instructions
1. DownloadtheNetworkUpdatersetuppackageatthefollowingwebaddressusingthe MozillawebbrowserthatcomesincludedwithRedHatLinux: http://www.cambiumnetworks.com/support/planning/index.php?cat=3&type=1 2. 3. Savethefilein/tmp. SkiptoStep4ifyou'realreadyloggedinasroot.Otherwise,enterthefollowingshell command: su 4. EntertherootpasswordwhenpromptedandpresstheEnterkey.
21
Issue 1 August 2012 5. Enteroneofthefollowingsetsofcommands: ToperformaGUIbasedinstallation,enter

cd /tmp chmod 755 setupCNUT.bin ./setupCNUT.bin
wheresetupCNUTisthenameoftheLinuxinstallerdownloadedfromthesoftware deliverywebsite. Toperformaconsolebasedinstallation,enter

cd /tmp chmod 755 setupCNUT.bin ./ setupCNUT.bin -console
wheresetupCNUTisthenameoftheLinuxinstallerdownloadedfromthesoftware deliverywebsite. 6. Followtheonscreeninstructionsforreviewingandacceptingthesoftwarelicense agreementandcompletingtheinstallation.
3.2.3
Program Usage
1. 2. TypethefollowingcommandataLinuxterminal:
CNUTLauncher.sh
Ifyoureceiveanerroraboutthenetworkupdatercommandnotbeingfound,itprobably meansthatyourPATHenvironmentvariableisnotsetup.YoucaneitherupdateyourPATH environmentvariablewiththefollowingcommand:

export PATH=$PATH: /usr/local/canopy/networkupdater
Alternatively,youcansimplyruntheprogrambyspecifyingthefulllocationtothe networkupdaterprogram:
/usr/local/canopy/networkupdater/CNUTLauncher.sh
YouwillseetheNetworkUpdatermenubarappearonscreen.
3.2.4
Caveats
IfyouchoosetoperformacustominstallationanddidnotinstallJavathen,whenyoustartthe NetworkUpdater,youmaybepromptedtolocatejavaonyoursystem.Thisinformationwillbe storedonthesystemforfutureuse,andyouwillnotbepromptedagain.Becauseofthis,please makesurethatallusersofthisprogramhaveaccesstothesameJavainstallation(forexample,avoid installingJavainahomedirectorywhenrunningasaregularuser,asthismaypreventotherusers fromusingyourJavainstallation). Theinstallerwritesoutalogfileofinstallationintheeventthatyoushouldencounteranyinstallation difficulty.Thisfileislocatedat/usr/local/canopy/networkupdater/log.txt.
22
Issue 1 August 2012
3.3
3.3.1
Installing Network Updater on Windows

Assumptions
YouhaveaWindowsmachinewithasupportedWindowsoperatingsystem. YouhaveadministratoraccesstotheWindowsmachineinwhichyouwillbeinstallingthis software.
note ............. Network Updater installs its own instance of Java.
3.3.2
Instructions
1. 2. 3. 4. 5. 6. Downloadthereleasenotesat http://www.cambiumnetworks.com/support/planning/index.php?cat=3&type=0. Readthereleasenotes. DownloadNetworkUpdaterToolv4.x.x(Windows)at http://www.cambiumnetworks.com/support/planning/index.php?cat=3&type=1. LoginasAdministratorforthesystemonwhichyouwillinstallorupgradeNetworkUpdater. Unzipthedownloadedsoftwarepackage. DoubleclickthesetupCNUT_4_0_x.exeicontobegininstallationdownloadedfromthe softwaredeliverywebsite.Theinstallationprogrampromptsforinformation. TheCNUTInstallerInstallAnywherewizardopenstoitsIntroductionpanel.
7.
ClicktheNextbutton. TheLicenseAgreementpanelopens.
23
Issue 1 August 2012
8. 9.
ScrolltoreadthefulltextoftheLicenseAgreement. Ifyouagree,selecttheIacceptthetermsoftheLicenseAgreementradiobutton.
10. ClicktheNextbutton. 11. IfapreviousreleaseofCNUTispresentonyourlocaldevice,andthewizardopentheCNUT Upgradepanel,clicktheNextbutton.
24
Issue 1 August 2012
12. WhentheChooseInstallFolderpanelopens,either clicktheChoosebuttontobrowsetoapathwhereyouwanttoinstallorupgradeCNUT andthenclicktheNextbutton. clicktheNextbuttontoacceptthedisplayeddefaultpath

C:\Canopy\NetworkUpdater.
ThePreInstallationSummarypanelopens.
25
Issue 1 August 2012
13. Ensurethattherequiredamountofdiskspaceisreportedinthispanelasavailable. 14. ClicktheInstallbutton. TheInstallingNetworkUpdaterpanelopenstoindicateprogress.
Whentheprocesshasconcluded,theInstallCompletepanelopensandindicatessuccess.
26
Issue 1 August 2012
15. ClicktheDonebutton. TheinstallationtoolplacestheNetworkUpdatershortcutontothedesktop.
3.3.3
Program Launch
Clickthe iconor,fromtheStartmenu,select ProgramsCanopyNetworkUpdater4.1NetworkUpdater.w Thislaunchestheapplication.
27
Issue 1 August 2012
4
4.1
Configuration and Settings

Security of Tool and Data
TheNetworkUpdaterTooldoesnotprovideanysecuritytorestrictaccesstothetoolitselforthe datastoredwithinitsPreferencesettingsorNetworkArchiveFiles.ItisassumedthattheNetwork UpdaterToolisinstalledonaninherentlysecureworkstationorserverandonlyauthorizedpersonnel haveaccesstothetoolanditsrelatedfiles.Itisnotrecommendedthatthetoolbeinstalledona computeropentotheoutsideworldwithoutproperexternalsecuritymeasuresbeingimplemented.
4.2
Configuration Files and Directories

NetworkUpdatermakesuseofseveraldirectorieswithinitsinstallationarea,andseveral configurationfiles.
4.2.1
Archived Log Files

ArchivedLogfilesarecreatedwhenthecurrentlogfilereachesitsmaximumsize.Archivedlogfiles haveanameofnwupdaterwiththeendingdateandtimeofthefileappendedtotheendofthe filename.Archivedlogfilesarestoredwithinthelogssubdirectory.Usersmayusethesearchived logfilesasneeded,includingparsingthemforrelevantinformationusingscriptsorother mechanisms.
4.2.2
Network Archive Files

Networkarchivefilesareusedtostoreallinformationenteredbytheuserorautomatically discoveredaboutanetwork.Thisincludeselementdata,elementgroupings,andpackagefilestobe usedforupgradingthenetwork.NetworkArchivefilesarestoredinXMLformatandshouldendwith .netextensions.ThelastusedNetworkArchivedFileisrememberedbyNetworkUpdatertoallow theusertoautomaticallyopenthatfileuponstartup.
4.2.3
Preference File
Sessionpreferenceinformationandinformationonthescreenlayoutsettings,lastopenedNetwork ArchiveFile,andothersessionrelatedinformationarestoredinthe cambium_nwupdater_pref.txt fileintheprefsubdirectory.SessioninformationissavedonExit fromtheNetworkUpdater.Theusershouldnoteditormodifythisfile.
29
Issue 1 August 2012
4.3
Network Communications
NetworkUpdaterrunsonacomputerinthebackofficeenvironment,butneedstocommunicate withthevariousnetworkelementsinthenetwork,includingAPs,SMs,BHs,andCMMs.Toensure properfunction,theusermustensurethatrequiredportsforcommunicationsbetweenthe computerrunningNetworkUpdaterandnetworkelementsareopen. ThefollowingarethecommunicationsprotocolsandportsthroughwhichNetworkupdater communicateswiththenetworkelements.Dependingonyournetworkconfiguration,enablingthese mayinvolveyourrouter,firewall,andanyhardwareorsoftwareprotocolfiltersyouhaverunning. Service FTP(Active) FTP(Passive) Telnet HTTP HTTPS TFTP SNMP SMAutoupdate Enable/Disable Port Used 20 21 21 23 80 443 69 161 2501 Protocol tcp tcp tcp tcp tcp udp udp udp
TFTPisanUDPserviceandthusconnectionless.Sincecommunicationsisrequiredinbothdirections forthisservice,ensurethattwowaycommunicationonthelistedportisenabled(fromtheNetwork UpdaterservertothenetworkandfromthenetworktotheNetworkUpdaterserver).
4.4
Tool Dependencies
NetworkUpdaterisdependantonsomethirdpartysoftwarecomponentstobeproperlyinstalled priortorunningNetworkUpdater.TheNetworkUpdaterinstallationscriptsshouldhelpidentify thesedependenciesfortheuserandperformsomebasiccheckstoensuretheyareconfigured appropriatelyforNetworkUpdatersuse.
4.4.1
Operating Systems Supported

NetworkUpdaterhasbeentestedonWindows2000,WindowsServer2003,WindowsXP,andRed HatEnterpriseLinuxv4.Otheroperatingsystemsmayalsowork,buthavenotbeentestedand cannotbeofficiallysupportedbythesupportorganization.
30
Issue 1 August 2012
4.4.2
Java
SincetheexternaltoolsinthisreleaserequirethatJREisrunningonthehostmachine,the installationtoolforthisreleaseloadsaproperversionofJREfortheexclusiveuseoftheNetwork UpdaterTool.
4.4.3
Release Supported
NetworkUpdatersupportsupgradingordowngradingnetworkfromortoallreleasesstartingwith systemrelease4.1.Ifanoperatorhasanetworkthatisnotyetrunningrelease4.1,theyshouldfirst upgradetheirnetworkmanuallytorelease4.1priortorunningNetworkUpdater. StartingwithR8.0ofthesystemsoftware,installationpackagesfortheNetworkUpdatertoolwill onlyworkwithNetworkUpdaterv2.0orgreaterreleases.Theoperatorshouldalsobeawarethat radiosthatareshippedfromthefactorywithR8.0orhighersystemreleasescannotbedowngraded belowR8.0.SeeTroubleshootingonPage117formoredetailsonthistopic.
4.5
External Tools Included

ThefollowingExternalToolsareautomaticallysuppliedwiththeNetworkUpdater.Eachoftheseis actuallyeitheraJavajarfileoraPerlscript.Thesespecificexternaltoolscomepreloadedwithin NetworkUpdater,andeachoneincludesonlinehelpforthetoolitself(seeHelpToolsToolName onPage96formoreinformationonexternaltoolhelp). Theexternaltoolsareintendedforoptionaluseandcustomizedexecution.Forthisreason,the NetworkUpdaterGUIprovidesthecapabilitytoeditanincludedtooloreventoremoveitfrom,and optionallyreplaceitin,theselectionlist(editthetoollist).
IfyouhighlightoneofthetoolsintheExternalToolEditorwindow(accessedviathe ToolsEditExternalToolMenucommandoption),clicktohighlightaspecifictool,andthenclickthe Editbutton,youcanmodifythepropertiesofthattool.
31
Issue 1 August 2012
Forexample,youcanrewritethescriptforNetworkUpdatertocalloreventhescriptthatprovides helptextforthetoolwhenyouselecttheHelpToolsToolNamecommandoption. IfyouunchecktheoptionSupportsHelp(AddtoHelpMenu)andsaveyourchanges,thattoolcan laterbeaddedbackintothesetoftoolsforyoutoaccess.
4.5.1
Custom Local Tools

Youcanalsoaddatoolofyourowncreationtothelist,usingtheToolsAddExternalTooltoMenu commandoption.
Similarly,youcanlaunchalocalscriptthatyouhavekeptoutofthemenuofexternaltools.Todoso, selecttheToolsLaunchExternalToolcommandoption.
32
Issue 1 August 2012
4.5.2
Configure Advantage Platform Scheduler

Thepurposeofthisexternaltoolistoprovideoperatorswithaconvenientandcontrolled/safe mannerforenabling/disablingtheHardwareSchedulingfeatureontheAdvantageproductline.This toolonlyworksonpreR8.0releaseofSystemsoftware,sinceallR8.0andhigherreleasesuseonly HardwareScheduling. DeviceRelease6.1implementedaHardwareSchedulerthatimprovesthecommunicationspipe betweenCanopyRadios.AnoptionexiststotogglebetweenHardwareSchedulingandSoftware Scheduling. Inorderforthisnewfeaturetofunction,itisnecessaryforbothsidesofthecommunicationspipeto utilizethesamescheduler: SubscriberModules(SMs)withhardwareschedulingenabledwillonlybeableto communicate/registerwithAccessPoints(APs)withhardwareschedulingenabled. SubscriberModules(SMs)withsoftwareschedulingenabledwillonlybeableto communicate/registerwithAccessPoints(APs)withsoftwareschedulingenabled.
FornewerSubscriberModules,HardwareSchedulingcanbeenabledbyselectingaConfiguration optionontheSubscriberModuleWebPage.ForolderSubscriberModules,HardwareSchedulingcan onlybeenabledinaseparateHardwareSchedulerFPGA.
Features
TheNetworkUpdaterExternalToolforperformingbatchconfiguringoftheSchedulerOptionwill supportthefollowingoptions: EnsurethatonlyAdvantageAccessPoints(APs)withReleaseof6.1uptobutnotincluding 8.0canbeconfigured. AllowConfiguringofSubscriberModules(SMs)withReleaseof6.1uptobutnotincluding 8.0orabove. AllowTogglingbetweenHardwareandSoftwareScheduling. AllowtheconfigurationoptiontobeautomaticallypropagatedtoSubscriberModules currentlyregisteredwiththeAP. ProvideaGUItotheusertoallowselectionoftheaboveoptions.
33
Issue 1 August 2012
Specific Operations
1. UserhasinstalledRelease6.1toAPandSM,andwishestoenableHardwareScheduling: a. b. c. d. e. IdentifytheAPstoconfigurebyselectingthemonthetreeviewdisplay. LaunchtheNetworkUpdaterExternalTool. SelecttheHardwareSchedulerOption.Bydefault,theOptiontopropagatetoSMsis checked. InitiatetheConfigurationchanges ForeachAPinthelist,theToolwill: i. ChecktoensurethattheAPiscapableofsupportingHardwareScheduling. 1. IfanyAPisnotcapableofHWscheduling,skipit,andnotifytheuser. ii. ChecktoensurethattheSMsattachedtotheAPareataminimumreleaseof 6.1. iii. IfanySMisnotcapableofHardwareScheduling,skiptheAP,andnotifythe user.(ThisistoensuretherearenostrandedSMs) iv. SettheSchedulerOptionforallSMsandrebootthem. 1. IftheSMisanewerSM,thenjustsettheHWSchedulingFlag 2. Else,FlashtheSMwiththeHWSchedulingFPGA v. SettheSchedulerOptionfortheAPandrebootit.
2.
3.
UserhasturnedonHWScheduling,butneedstorecoveranystrandedSMsthatarestillin SWSchedulingmode. a. IdentifytheAPstoconfigurebyselectingthemonthetreeviewdisplay. b. LaunchtheNetworkUpdaterExternalTool. c. SelecttheRecoverMisconfiguredModulesOption.Bydefault,theOptionto propagatetoSMsisdisabled. d. InitiatetheConfigurationchanges e. ForeachAPinthelist,theToolwill: i. SettheAPtotheoppositeoftheTargetedConfiguration. ii. ReboottheAP. iii. AllowsufficienttimeforanymisconfiguredSMstoregistertotheAP. iv. ApplytheTargetConfigurationtoanySMsandrebootit. 1. IfHardwareSchedulerisselectedandtheSMisnotcapableof HWScheduling,flaganerrorandskiptheAP. a. TheAPwillbeleftatthecurrentconfigurationsothat theusercanreapplyNetworkUpdatetoupdatetheSMs toR6.1. b. OncompletionofNetworkUpdate,theUsercanre launchthisexternaltooltoreconfiguretoHardware Scheduler 2. ResettheAPtothetargetConfigurationandrebootit. 3. WaitforAllSMstoregistertotheAP. 4. VerifythattheTotalSMsisasexpected(OriginalCount+ RecoveredCount). UserhasinstalledRelease6.1toAPandSM,andwishestoenableSoftwareScheduling: a. IdentifytheAPstoconfigurebyselectingthemonthetreeviewdisplay. b. LaunchtheNetworkUpdaterExternalTool. c. SelecttheSoftwareSchedulerOption.Bydefault,theOptiontopropagatetoSMsis checked. d. InitiatetheConfigurationchanges
34
Issue 1 August 2012
4.
ForeachAPinthelist,theToolwill: i. SettheSchedulerOptionforallSMsandrebootthem. 1. IftheSMisanewerSM,justselecttheSWSchedulingOption 2. ElseforolderSMsFlashtheSMwiththeSWSchedulingFPGA ii. SettheSchedulerOptionfortheAPandrebootit. UserwishestodirectlyconvertanolderSMtoHardwareScheduling: a. AddtheSMtoNetworkUpdater,andensurethatNetworkUpdatercan communicatetoit(DirectconnecttheSMtothePCrunningNetworkUpdater) b. IdentifytheSMstoconfigurebycheckingthemonthetreeviewdisplay. c. LaunchtheNetworkUpdaterExternalTool. d. SelecttheHardwareSchedulerOption. e. InitiatetheConfigurationchanges f. TheToolwill: i. ChecktoensurethattheSMisataminimumreleaseof6.1andisbelow Release8.0. ii. SettheSchedulerOptionfortheSMandrebootit. 1. IftheSMisanewerSM,thenjustsettheHWSchedulingflag. 2. Else,forolderSMs,FlashtheSMwiththeHWSchedulingFPGA.
e.
GUI IfthetoolisunabletoidentifyapackagethatcontainsFPGAsforHardwareSchedulerandSoftware Scheduler,thetoolpopsupadialogboxtoselectaparticularpackagethatcontainstheFPGAsfor bothkindsofscheduler.

note ............. The tool does not get an up-to-date list of currently selected packages from the Network Updater tool, so you may see this message and be required to specify an appropriate package even if you have such a package active within the Network Updater Manage Packages dialogue.
Otherwise,themainwindowofthetoolwilldirectlyappear.
35
Issue 1 August 2012
Options: RefreshElement:ConnecttotheElement,QueryitsstateandthatofitsSubscriberModules (IfApplicable). VerifyConfiguration:CheckAllElementsagainstthedesiredTargetConfiguration(Hardware orSoftwareScheduler). RunNow:ExecutetheCurrentConfigurationagainsttheSelectedElements. RunLater:ExecutetheCurrentConfigurationataLaterTime(SeeScreenShotsBelow).
note ............. The scheduled time will be based on your Network Updater computer clock, not any time set on the elements being manipulated.
Exit:ExittheProgram.
Running Parallel Instances of Tool

TooptimizetheamountoftimeittakestochangealargenumberofAPsandSMsovertoAdvantage Scheduler,itispossibletorunmultipleinstancesoftheConfigureAdvantageSchedulerPlatformtool inparallel,eachoperatingonadifferentsetofAPs. Toinitiatesuchparallelinstances,thefollowingprocesscanbefollowed: 1. 2. 3. 4. SelecttheAP(s)thefirstinstanceoftheConfigureAdvantageSchedulerPlatformtoolshould operateon. LaunchthetoolfromtheToolsmenu. ConfigureandinitiatetheConfigureAdvantageSchedulerPlatformtool. Whilethetoolisrunning,returntotheNetworkUpdatermainwindow.
36
Issue 1 August 2012
5.
SelecttheAP(s)forthesecondinstanceoftheConfigureAdvantageSchedulerPlatformtool. LaunchthetoolfromtheToolsmenu. ConfigureandinitiatetheConfigureAdvantageSchedulerPlatformtool. Repeatasneeded,uptotheperformancecapabilitiesofthecomputerthatisbeingused.
note ............. Remember to unselect the previous set of APs
6. 7. 8.
TheusercanalsomakeuseoftheschedulingcapabilityoftheConfigureAdvantageScheduler Platformtoolforeachinstanceofthetoolstarted.Inthiswaytheymaybeabletoinitiatesome instancesoftheConfigureAdvantageSchedulerPlatformimmediately,andscheduleotherstostart inthefutureatapointwheretheyestimatetheinitialsetofinstancesoftheConfigureAdvantage SchedulerPlatformtoolhavealreadycompletedtheiroperation.

note ............. It is highly recommended that all of the APs on a single cluster of APs be upgraded together by the same instance of the Configure Advantage Scheduler Platform. This is due to the fact that as SMs on the cluster are upgraded it is possible (depending on color code and frequency settings on the cluster) for an SM to move from one AP to another during the upgrade process (especially if the SM falls on the barrier line between two AP sectors). The Configure Advantage Scheduler Platform tool has accounted for this possibility, and during the verification step will ensure all SMs have been upgraded across the entire pool of APs it was working on. Therefore if an SM was properly upgrade, but moved to another AP, this will not be flagged as an issue and will allow the Configure Advantage Scheduler Platform tool to still complete normally.
4.5.3
Gather Customer Support Information

Thepurposeofthisexternaltoolistoprovideoperatorswithaconvenientyeteffectivemethodto collectpertinentinformationfromtheNetworkUpdaterToolandNetworkElementsforthepurposes ofsubmittingtotheCustomerSupportTeam.Whenexecuted,theToolwillgenerateaZipfilethat contains currentNetworkUpdaterSettingsandLogs. Status,EventLogandConfigurationWebPagesforanynetworkelementsthatareselected.
ThezipfilecanthenbeemailedtotheCustomerSupportteam,whocanusetheinformation containedinthezipfiletoaidinresolvingfieldissues.
Features
TheExternalToolforcollectingcustomersupportinformationsupportsthefollowingoptions: AttachthecurrentCNUTPreferencesFile. AttachthecurrentCNUTNetworkArchiveFile.
ThearchivefileprovidescontextualinformationontheHierarchyoftheNetworkElements. TheToolmaintainsthesecurityofthecustomernetworkbyremovingallPasswordinformationfrom theNetworkArchivefile. AttachthecurrentCNUTEventLogFile. AttachtheStatus/EventLogandConfigurationWebPagesofSelectedNetworkElements
TheToolextractswebpagesforallelements,eitherdirectly(throughIPAddress),orviatheAPLUID proxy(forSubscriberModulesthatarenotdirectlyaddressable).
37
Issue 1 August 2012
Specific Operations
Generating a Report File involving several Elements in a Network Updater Archive

1. SelectthenetworkelementsfromwithinNetworkUpdater.
note ............. The larger the number of Network Elements that are selected, the longer the Tool will have to execute. This will also result in a larger zip file.
2.
LaunchToolsGatherCustomerSupportInformation.
3. 4. 5.
CheckthecheckboxforSendNetworkElementInformation. Selecttheradiobuttonofoneoftheoptions(SelectedNetworkBranchesor SelectedNetworkElements). ClickOK.
6. 7.
Ifdesired,changethedefaultfileattachmentoptions. ClicktheRunNowbutton.
38
Issue 1 August 2012
TheCustomerSupportInformationToolgeneratesazipfilebythefollowingprocess: 1. 2. 3. 4. 5. 6. 7. ItattachesthecurrentCNUTPreferenceFiletotheZipFile. ItloadsthecurrentCNUTNetworkArchiveFile. ItremovesallpasswordinformationfromtheNetworkArchiveFile,thenattachesthisfile. ItattachesthecurrentCNUTEventLogFiletotheZipFile. ItiteratesthroughalltheselectedNetworkElement'sandprocesstheirWebPages. IftheElementisdirectlyaccessibleviaIPAddress,itcollectsthewebpagesviatheWeb interface(e.g.,http://ipaddress/status.html),andattachesthemtotheZipFile. IftheElementisaSubscriberModulewithoutadirectlyaccessibleIPAddress (e.g.,AP:[169.254.253.10].LUID:[002]),itsetsthecurrentLUIDintheAccessPoint,access theSubscriberModuleswebpagesviatheProxyaddress (e.g.,http://ipaddress:1080/status.html),andattachesthemtotheZipFile. Whenfinished,itdisplaysaMessageBoxindicatingthatithascompletedgeneratingthe ReportFile.
8.
Extracting and Viewing the Contents of a Report File

Thereportfileisjustasimplezipfile. 1. 2. Extractittoafolderinyourfilesystem. Foraformattedviewofthereport,openthefile(index.html)inaWebBrowser.Aframes pagewiththreeframeswillbedisplayed. Thetopleftframeindicatestheitemsthatarecontainedinthereport.Thisincludesthe attachedconfiguration/logfilesaswellasthelistofelementsthatwereselected. Whenanelementisselected,thebottomleftframecontainsalistofwebpagesthat canbeviewedfortheelement. Therightframe(themainone)providesaviewofthefilethatisselectedbytheleft frames.
TheattachedNetworkArchiveFile(*.net)canbeopenedusingtheNetworkUpdaterTool.
4.5.4
Reboot Unit
ThistoolisusedtocauseselectedradiostorebootassoonasyouselectToolsRebootUnit,soyou shouldensurethatthedevicesselectedareonlythoseintendedforarebootbeforeyoumakethis optionselection.
39
Issue 1 August 2012
HelpforthistoolisavailableatHelpToolsRebootUnit.
However,ifthisHelp:RebootUnitwindowcontinuestostatethatthetelnetinterfaceisused,be awarethat,foranyelementthathasavalidIPaddressinNetworkUpdater,thisapplicationuses SNMP,nottelnet,toforcethereboot.
40
Issue 1 August 2012
4.5.5
Set Access Point Authentication Mode

Thistoolallowsyoutoquicklyandeasilychangetheauthenticationparametersofaccesspoints managedbyBAMserverorRADIUSserver,usingtheNetworkUpdatertoolratherthanhavingto accesseachAPswebinterface.Thistooleasesmigrationbyprovidingthecapabilitytotemporarily disableauthenticationduringtheupgradesothatyourcustomersarenotaffected.Thistoolalso allowsyoutoeasilyresumeauthenticationrequiredwhentheupgradeiscomplete.Inaddition,it allowsyoutoconfiguretheauthenticationserverIPaddressesintoeachofyouraccesspoints. Tousethetool,identifytheAPstomanagebycheckingthemonthetreeviewdisplayandthen launchToolsSetAccessPointAuthenticationMode.
TheHelpToolsSetAccessPointAuthenticationModeoptiondisplaysthefollowingoverviewof thisNetworkUpdaterutility:
41
Issue 1 August 2012
TheIPaddresssectionofthedialogboxwillallowyoutoleaveanentryblank.Whenthisisdone,you areindicatingthatforeachAP,youwishtoleavethecurrentlyconfiguredvalueasisforthatIPentry. Arebootoperationtomaketheconfiguredvalueseffectiveisautomatic.
4.5.6
Set Autoupdate Address on APs

ThisexternaltoolisusedtosetthevalidaddressfromwhichAPswillacceptAutoupdatecommands. ThistoolisnotsupportedforuseonPMP320APs.Tousethetool,identifytheAPstomanageby checkingthemonthetreeviewdisplayandthenlaunchToolsSetAutoupdateAddressonAPs.
42
Issue 1 August 2012
TheHelpToolsSetAutoupdateAddressonAPsoptiondisplaysthefollowingoverviewofthis NetworkUpdaterutility:
note ............. If you use the Update commands on the network, this address will automatically be set without the need for this external tool. See SM Autoupdate Feature on Page 13 for more information on this subject.
43
Issue 1 August 2012
4.5.7
Set SNMP Accessibility

Thisexternaltoolisusedtosetthevalidnetworkmaskforindicatingfromwhichmachinesthe moduleswillacceptSNMPrequests.
TheHelpToolsSetSNMPAccessibilityoptiondisplaysthefollowingoverviewofthisNetwork Updaterutility:
ThistoolmayberequiredifthecurrentSNMPmaskvalueonthemodulesistoorestrictiveinthatit willnotallowtheNetworkUpdaterservertocommunicatewiththemodulesthroughSNMP.
44
Issue 1 August 2012
4.5.8
Set SM/CPE Security

TheinstallationtoolforNetworkUpdaterdepositsalloftheprescriptedtoolsintothefolder C:\Canopy\NetworkUpdater\toolsoritsLinuxcounterpartpath.Thissetoftoolsincludesnot onlythosethattheapplicationusercaninvokefromthemainmenubyselectingToolsToolName, butalsotheSetSM/CPESecuritytoolforconfiguringRADIUSauthenticationoptionsinPMPSMsand PMP320CPEdevices. Toputaccesstothistoolintotheapplicationmenu,selectToolsAddexternalTooltoMenu.Inthe resultingAddExternalTooldialog,clickthebrowsebutton(labeledwithanellipsis).
BrowsetothepathstatedaboveandselectthefileSetSMCPESecurity.jar.IntheNamefieldabove CommandLinewherethenewtoolisshownastheargumenttoajavacommand,typeinanameby whichyouwilldistinguishthistoolwhenyouwishtoexecuteit;Set SM/CPE Security,for example.
45
Issue 1 August 2012
Adjusttheothersettingsinthisdialog,thenclickOK.Fromthispointforward,wheneveryouselect ToolsSetSM/CPESecurity,theinterfacespecifictothisutilitywillopen.Theinterfaceforthisutility consistsoftwotabs: onefortargetPMPSMs
46
Issue 1 August 2012
theotherfortargetPMP320CPEdevices
ForinformationaboutAAAauthentication,thetwocertificatepositions,andtheeffectofapplying certificates,seetheuserguideandreleasenotesthatsupportthetargetdevice(s).Seealso UpdateUploadCertificatetoSelectedElementsonPage92 UpdateUploadCertificatetoSelectedBranchesonPage93.
47
Issue 1 August 2012
5
5.1
Network Updater Operations

Quick Start Examples
ThissectionprovidesexamplesofhowtheNetworkUpdaterToolmaybeusedtosolvespecific problemsorusecasesforauser.InaddressingthesescenariosnotalloftheNetworkUpdaterTool capabilitiesandcomponentsmaybeusedorneeded.RefertoDetailedProceduralOperationson Page51formorecoverageonalltheaspectsofusingtheNetworkUpdaterToolpresentedinamore robustexample/walkthru.
5.1.1
Upgrading a Single Radio Before Deployment

InsomeinstancesitmaybenecessarytoupgradethesoftwareorFPGAonanewradiopriorto deployingitinyournetwork.TheNetworkUpdatertoolcanbeusedtoperformthisoperationquickly andefficiently.Thefollowingstepscouldbeusedtoperformanupgradeofanewradiothatisinits defaultfactoryconfiguration:
Assumptions
NetworkUpdaterisinstalledandoperationalonyourcomputer. TheradioisconnectedtothesameLANastheNetworkUpdaterComputer.Thesimplest waytodothisistodirectlyplugtheEthernetoutputoftheradiopoweradaptorintothe NetworkUpdatercomputerEthernetport. important faswitchorhubisusedtoconnecttheradioandNetworkUpdatercomputer, I thenonlyoneradioshouldbeontheLANatatime,sinceindefaultmodetheyallhavethe sameIPaddress. TheNetworkUpdatercomputerhasanIPaddressthatcandirectlyaccessthedefaultIPon theradio,whichis169.254.1.1ThiscanbedoneinthecaseofaWindowscomputerby addingsimplyanadditionalIPaddresstothecomputernetworkinterfacewithanIPaddress of169.254.1.2andasubnetmaskof255.255.255.0. TheInstallationPackageneededtoupgradetheradiohasbeendownloadedfromthe websiteandaddedtotheNetworkUpdaterthroughtheManagePackagesoperation(see UpdateManagePackagesonPage85).
Steps to Perform a Single Radio Local Upgrade

1. 2. 3. 4. StartNetworkUpdater. Ifyoudontstartupwithablanknewnetworkfile,thenopenanewnetworkfilewiththe NewNetworkArchiveoperation(seeFileNewNetworkArchiveonPage63). EnteranewnetworkelementtotheemptynetworktreeusingtheAddElementsto NetworkRootoperation(seeEditAddElementstoNetworkRootonPage70). OntheAddElementsdialogue,selectatypeofSubscriberModuleandentertheIPaddress of169.254.1.1withintheElementHostNamesareaofthedialogue.
49
Issue 1 August 2012 5. 6.
MakesuretheproperInstallationPackageisactivewiththePackageManagerdialogue (seeUpdateManagePackagesonPage85). Toverifyconnectivitywiththeradio,performaRefresh/DiscoverEntireNetworkoperation (seeViewRefresh/DiscoverEntireNetworkonPage74).Youshouldseethedetails columnsforthenewelementfilledinwithESNandsoftwareversioninformation. InitiatetheupgradeofradiousingtheUpdateEntireNetworkRootoperation (seeUpdateUpdateEntireNetworkRootonPage88).Whenthisoperationfinishes,the radioisdonebeingupgraded.
7.
5.1.2
Upgrading a Single AP and its Associated SMs

ThefollowingstepscanbeusedtoupdateasingleAPandallofitsSMsinarapidfashion,exceptin PMP320sectors.Thiscanbeusefulifasinglesectorisbeingupdatedfortestingpurposes.Also, theseoperationsarealogicalbuildingblockforperforminglargerupdatesacrossyourentire network.
Assumptions
NetworkUpdaterisinstalledandoperationalonyourcomputer. TheAPhasaroutableIPaddressthattheNetworkUpdatercomputercancommunicate. AlloftheSMsassociatedwiththeAParepoweredupandcurrentlyregisteredtotheAP. TheInstallationPackageneededtoupgradetheradiohasbeendownloadedfromthe websiteandaddedtotheNetworkUpdaterthroughtheManagePackagesoperation(see UpdateManagePackagesonPage85).
Steps to Perform a Single AP Sector Upgrade

1. 2. 3. 4. 5. 6. StartNetworkUpdater. Ifyoudontstartupwithablanknewnetworkfile,thenopenanewnetworkfilewiththe NewNetworkArchiveoperation(seeFileNewNetworkArchiveonPage63). EnteranewnetworkelementtotheemptynetworktreeusingtheAddElementstoNetwork Rootoperation(seeEditAddElementstoNetworkRootonPage70). OntheAddElementsdialogue,selectatypeofAccessPointandentertheIPaddressofthe APwithintheElementHostNamesareaofthedialogue. MakesuretheproperInstallationPackageisactivewiththePackageManagerdialogue (seeUpdateManagePackagesonPage85). ToverifyconnectivitywiththeradioandtoautomaticallygatherthelistofSMsattachedto theAP,performaDiscoverEntireNetworkoperation(seeViewRefresh/DiscoverEntire NetworkonPage74).YoushouldseethedetailscolumnsfortheAPbefilledinwithESNand softwareversioninformationandyoushouldseealistofSMsappearwithintheSubscriber Modules(AutoDetected)branchofthetree. ConfigurethesystemtouseAutoupdatetoupgradetheSMsassociatedwiththeAP automaticallyaftertheAPhasbeenupgraded.ThisisdonebyopeningtheUpdate Configuration(UpdateConfigure)dialogueandcheckingtheEnableSMAutoupdatewhen anAccessPointisUpdatedoption(seeUpdateConfigureonPage77).
7.
50
Issue 1 August 2012
8.
InitiatetheupgradeoftheAPanditsSMsusingtheUpdateEntireNetworkRootoperation (seeUpdateUpdateEntireNetworkRootonPage88).WhenthedirectupdateoftheAPis completedadialoguewillopenindicatingSMAutoupdatehasbeenstarted. LeavetheSMAutoupdatestarteddialogueopenandmonitortheprogressoftheSMsbeing updated.
9.
10. WhenallSMsshowupdatedsoftwareandFPGAversion,theAPsectorupgradeiscomplete. YoushouldnowdisabletheSMAutoupdatemodeontheAPbyselectingtheAPelement andusingtheEnable/DisableAPsforSMAutoupdateoperation(see UpdateEnable/DisableAPsforSMAutoupdateonPage90).
5.1.3
Minimum Actions to Perform Future Network Upgrades

Oncetheuserhasdefinedanetworklayoutandperformedanupgradeatleastonceontheir network,subsequentnetworkupgradesarepracticallyonetouchoperations.Thefollowingminimum stepscouldbeusedtoinitiatefuturenetworkupgrades: 1. Downloadthenewinstallationpackagefromthewebsiteat http://www.cambiumnetworks.com/support/pmp/software/index.phpforPMPdevices and/orhttp://www.cambiumnetworks.com/support/ptp/software/index.phpforPTP devices. OpenyourcurrentnetworkarchivewithinNetworkUpdater. LinkthenewInstallationPackagetoNetworkUpdater,usingtheManagePackages operation(seeUpdateManagePackagesonPage85). EnsureSMAutoupdateisenabledonthenetwork,ifyouareusingthatoption,byeither havingitautomaticallysetwithintheUpdateConfigurationwindow(seeUpdateConfigure onPage77),orbyusingtheEnable/DisableAPsforSMAutoupdateoperation(see UpdateEnable/DisableAPsforSMAutoupdateonPage90)afterthenextUpdate operation(nextstep)iscomplete. InitiatethenetworkupgradebyusingtheUpdateEntireNetworkRootoperation (seeUpdateUpdateEntireNetworkRootonPage88). Allowtheupdateoperationtocomplete,andcheckthestatusofthenetworkwitha DiscoverEntireNetworkoperation(seeViewRefresh/DiscoverEntireNetworkonPage74) asappropriate.
2. 3. 4.
5. 6.
5.2
Detailed Procedural Operations

Thissectionismeanttowalktheuserthroughthemajoroperationsinvolvedinperformingnetwork upgradesusingtheNetworkUpdatertool.Thematerialhereispresentedinthelogicalorderauser wouldneedtoperformeachoperationthefirsttimetheyuseNetworkUpdater.
5.2.1
Creating a New Network Archive File

TheNetworkUpdaterusesalocaldatafileforkeepingtrackofinformationenteredbytheuseror automaticallydiscoveredaboutthenetworkinquestion.ThisfileisreferredtoasaNetworkArchive File.TheusercancreateanewarchivefileatanytimebyusingtheNewNetworkArchiveoperation (seeFileNewNetworkArchiveonPage63).Thisoperationwillclearthecurrentnetwork(ifany)
51
Issue 1 August 2012
fromNetworkUpdaterandprovideacleanslatetotheuserforenteringnewnetworkinformation. ThecreationofaNetworkArchivefileisnotactuallycompleteduntiltheuserdoesaSaveNetwork Archiveoperation(seeFileSaveNetworkArchiveonPage64),atwhichtimetheywillbeprompted forapathandfilenametoidentifytheactualarchivefile. Ifanetworkarchivefilealreadyexists,thentheusercanjustloaditwiththeLoadNetworkArchive operation(seeFileLoadNetworkArchiveonPage63).Networkupdaterwillalsorememberthelast loadednetworkarchivefileandautomaticallyreloadituponstartup.
5.2.2
Adding Network Elements

important ........... Because of how Network Updater processes passwords, HTML entity symbols (special characters such as, but not limited to ~, !, and @, , , , , , , and ) as characters in configured passwords typically prevent the associated user from logging into Network Updater. Although a particular symbol may not prevent log in, all operators are advised to ensure that none of passwords associated with users, even the root user, contain any of the entity symbols. Similarly, the inclusion of these special characters in the values of the Site Name, Site Location, and Site Contact fields typically causes processing problems for Network Updater storage as XML data and should be avoided.
ThefirstoperationthatausermustdoforanewnetworkistoenterinformationaboutAPs,BHs,and CMMsforthenetwork.AllthevarioustypesofdevicesarereferredtoasNetworkElementsinthis documentandwithintheGUIoftheNetworkUpdater.Thebasicinformationthatisrequiredforeach ofthesetypesofnetworkelementsaddedisanIPaddress.Itisalsoimportantfortheusertoenter anappropriatehierarchyofdevices(seeNetworkLayersandOrdersofUpdatingEquipmentonPage 17).Thisisneededtoensurethatmodulesareupdatedinanappropriateorderonthenetworkto avoidcausingmodulestobestrandedduringanupgradeprocessdototheirparentbeingupgraded concurrently. Initially,theuserseestwotoplevelbranchesintheNetworkUpdaternetworktreewindow:

Network RootandSubscriber Modules (Auto-Detected):
...
AllelementsaddedbytheusershouldbeaddedbelowtheNetworkRootbranch.Theuserwillnotbe allowedtoenterelementsdirectlytotheSubscriberModules(AutoDetected)branch,asthatis reservedforinformationthattheNetworkUpdaterfindsonthenetworkitself.
52
Issue 1 August 2012
Theusercaninitiateanaddelementinthreeways: EditAddElementstoHighlightedElementonPage69,whichrequiresanelementtobe selectedonthenetworktreewindow,suchastheNetworkRoot EditAddElementstoNetworkRootonPage70 Selectanelement(suchasNetworkRoot)andrightclicktoaccesstheAddNetworkElement operation.
Allthreeoftheseoperationswillperformthesameoperation,allowingtheusertoaddanew networkelement.Forgroupingandmanagementpurposes,itmayhelptocreateelementgroups (folders)tocontaindifferentsetsofelementswithinyournetworktree,suchascreatinganelement grouptocontainalltheAPsandBHsrelatedtosinglecluster.Youcanentermultipleelementsatthe sametimebyenteringmultiplehostnames,IPaddresses,orIPaddressrangesintheAddNetwork Elementwindow. Thefollowingexampleisanetworkofthreemainclusters,eachwith4sectors,withbackhaul connectionstoasinglePOPlocation.Oneoftheclustersintheexample(DowntownTower)isdaisy chainedtothePOPthroughthebackhaulofanothercluster(SouthTower).Eachclusterlocationand themainPOPhaveaCMMforsynchronizationpurposes.Forreadability,theexampleisusinghost namesthatwouldberesolvedbythe/etc/hostsfileonthelocalmachine.Itisalsopossibleto enterthedirectIPaddressesintheAddElementwindowifhostnameswerentdefinedortheuser didntwanttousethem.TheNetworkUpdatertoolwillmakeuseofacombinationofSNMPand HTTPaccesstotheelementstoobtainadditionalinformationabouttheelementrelatedtoitscurrent configuration. Thefollowingdiagramisarepresentationofthisexamplenetwork:
53
Issue 1 August 2012
54
Issue 1 August 2012
ThefollowingNetworkUpdaternetworktreerepresentsthisnetworkinanappropriatehierarchical mannerthatensuresradiosandCMMswillbeupdatedinanonconflictingmanner:
note ............. The use of the Element Groupings South Tower, Downtown Tower, and North Tower were purely a matter of choice. They could have been left out if the user desired, though they do provide an easy way to select all the radios associated with a particular CMM.
Atoggletypecommandoptioninthemainmenuenableshorizontalscrollbar.Theoption ViewHorizontalScrollDeepTreeonPage76allowstheusertoseesubfoldersbeyondthe55th recordtoanydesireddepthofelements.
5.2.3
Detecting SMs in Network

ItisnotnecessaryforausertoentertheSMsthatexistwithintheirnetworkaslongastheyhave enteredalloftheAPstowhichtheirSMscommunicate.TheusermayoptionallyaddSMstotheir NetworkRoot.ThismaybeusefulforsituationswherethenetworkoperatorhasremoteAP configurations(anAPhardlinkedtoaSM,wheretheSMisprovidingthebackhaultotheAP).The usershouldbeawarethatifthesameSMisautodetectedbyNetworkUpdater,itmightalsoappear intheSubscriberModules(AutoDetected)sectionaswell.Therearenonegativesideeffectsof havingtheSMappearinbothplaces.
55
Issue 1 August 2012
NetworkUpdaterhastheabilitytocommunicatewiththeAPsanddetectalloftheSMsthatare connectedtotheAPs.ThisinformationisusedtoautopopulatetheSubscriberModule(Auto Detected)networkbranch. OnceyourAPshavebeenenteredyoucandoanautomaticdiscoveryofalltheSMsonyournetwork, aswellascurrentinformationontheotherelementsofthenetworkthatyoujustentered,byusing theoptionViewRefresh/DiscoverEntireNetworkonPage74.Thisoperationwilltalkwitheach elementinthenetwork,detectingSMsanddiscoveringcurrentsoftware,boot,andFPGAversion informationforeachdevice.Theusermaywatchtheprogressofthenetworkdiscoveryboththrough theEventWindowatthebottomoftheNetworkUpdaterwindowandinaprogressbarthatappears inthecenterofthescreen. IftheusercancelsthisoperationbeforeitfinishesthensomeSMsmaynotbeautodetectedand someAP,BH,andCMMinformationmaynotbegathered.
note ............. Only information on currently registered SMs can be auto-detected. Therefore it may be necessary to periodically re-run the refresh network operation to gather information on new SMs.
OnceanSMhasbeenautodetecteditwillremainwithintheNetworkUpdatertreeuntiltheuser manuallyremovesit,eveniftheSMisnotregisteredtoanAPthenexttimearefreshoperationis done.
5.2.4
Viewing Current Versions

Atthispointafullpictureofyournetworkincludingenteredandautodetectedelementsisavailable intheNetworkUpdaterwindow.Theusercanviewtheversioninformationforallsoftware,boot, andFPGAversionstodeterminewhere,ifanywhere,thereareinconsistencies.Theycanalsosee MACaddressinformationforeachelementinthenetwork.Thelastaccessedcolumnprovides informationonthelasttimethedisplayedNetworkUpdaterinformationwasrefreshedforany particularnetworkelement.
56
Issue 1 August 2012
NetworkUpdaterwillvalidatetheelementtypevaluewhenitcommunicateswiththeelementonthe network.Iftheuserenteredthewrongtypeofelementoriginallywhentheyaddedthenetwork elementtothenetworktree,NetworkUpdaterwillupdatetheelementtypevaluetoreflectthereal elementtypeasdiscoveredinthenetwork.
5.2.5
Current State Information on Network Elements

NetworkUpdatercapturescurrentstateinformationoneachelementasitinteractswiththe element.ThisinformationisshowedintheStatecolumn.ManyNetworkUpdateroperationscan updatethisstatefieldindicatingsuccessfuloperationorerrorconditions.Thisstatecanalsobeused tomonitortheprogressofaRefreshorUpdateoperationonthenetwork.Stateinformationwill correlatetoactioninformationloggedtotheeventwindow.
57
Issue 1 August 2012
5.2.6
Identifying Installation Package for Performing Upgrades

ThenextlogicaloperationtheuserneedstodoistoidentifytheInstallationPackagesforNetwork Updatertousewhenupdatingthenetwork.ThisisdonethroughtheManagePackagesoperation (seeUpdateManagePackagesonPage85).Installationpackagescanbedownloadedoffthe website,fromtheNetworkUpdaterdownloadpage.
important ........... Normal image package files for devices can also be downloaded from the website, but do not work with Network Updater, so be sure to download Network Updater installation packages for the software you need.
Theusermayhaveoneormorepackagesactiveinthesystematthesametime.Inthecaseof multiplepackages,thenthepackagesatthetopoftheManagePackagewindowwilltake precedence.NetworkUpdaterwillsearchthepackagesfromthetopdownuntilitfindspackagefiles foranyparticularelementtypeitisrequiredtoupdate.Becauseofthisfact,ifasinglepackages containsalltheupgradesrequiredforthisnetworkupgradeactivity,thentheusermaywanttobe surethatonlythatsinglepackageisselected(bycheckingtheboxnexttothepackagename). ToallowtheSMAutoupdateprocesstofinishasquicklyasitcan,loadonlythosepackagesontothe APthatareappropriatefortheSMsinthesector.Forexample,donotloadanyP7throughP9 packagesontoanOFDMAPora5.4GHzAP,sincethesepackagesarenotsupportedbytheSMsin thesectorofthesetypesofAP.Usingseparatepackageloadandupdateoperationsformixed networks,whileittakesalittlebitmoreoperatortime,takesconsiderablylessupdatetimeoverall.
5.2.7
Ensuring the Network is Configured for Using SM Autoupdate

NetworkUpdaterwilldirectlyupdateallspecifiedAPs,BHs,andCMMsinyournetwork.Forsectors otherthanPMP320series,therearetwowaystoupgradetheSMs,eitherdirectlybyselectingthem andinstructingNetworkUpdatertoperformanupgradeonthem,orbyusingtheSMAutoupdate feature.SeeSMAutoupdateFeatureonPage13formoreinformationonthatmechanismfor performingSMupgrades.
note ............. This feature is not available in PMP 320 sectors.
ConfiguringtheSMAutoupdateFeaturesettingsaredonethroughtheConfigureoperation(see UpdateConfigureonPage77).Seethatsectionforadditionalinformationonwhyyoumaywantto usetheSMAutoupdatefeatureinfavorofdirectSMupdatesthroughNetworkUpdater.Ingeneral, youroverallnetworkupgradewillproceedmuchquickerbyfullyleveragingthepoweroftheSM Autoupdatecapabilitiesofthenetwork. TheSMAutoupdatecapabilityiscontrolledonanAPbyAPbasisbysettingtheSMAutoupdate optionontheAP.TheNetworkUpdaterhastheabilitytoenableordisableSMAutoupdateonallor anyportionoftheAPsinyournetwork.ThisisdoneusingtheEnable/DisableAPsforSM Autoupdateoperation(seeUpdateEnable/DisableAPsforSMAutoupdateonPage90).Whenthis operationischosen,aprogresswindowwillappearwhiletheNetworkUpdateriscommunicating withtheappropriateAPs.
important ........... SM Autoupdate is supported for SMs whose Network Accessibility parameter (in the IP tab of the SM's Configuration management web page) is set to Local, not Public. Even where Network Updater can discover SMs as children of their APs, if their Network Accessibility is set to Public, then Network Updater must discover them directly.
58
Issue 1 August 2012
note ............. Canceling this operation before its completion may result in the desired SM Autoupdate configuration change not being set on all the specified APs.
5.2.8
Determining Where SMs Will Obtain Package Files

WhenusingtheSMAutoupdatecapability,itisnecessarytospecifyfromwhereSMsshoulddirectly obtainpackagefiles.SMAutoupdatesupportsthecapabilitytoputtheSMpackagefilesontheAPs,a localTFTPserver,oraCNUTHTTPserver.NetworkUpdaterplacestheSMpackagefilesinthe appropriatelocationfortheSMstoobtainthem.Allyouneedtodois specifythefileservertypeintheUpdateConfigurationdialog(seeUpdateConfigureon Page77). wherealocalTFTPserverisspecifiedandtheNetworkUpdaterdevicehasmultiplenetwork interfacecards(morethanoneIPaddress),specifyitsIPaddress. whereCNUTHTTPserverisspecified,specifyitsIPaddress.
5.2.9
Initiating or Discontinuing a Network Upgrade

Afterenteringthecorenetworkelementinformation,theoperator 1. 2. 3. 4. specifiesinstallationpackageswiththeimagefiles. decideswhethertousetheSMAutoupdatefeature. configuresSMAutoupdate,ifthatfeatureisused. initiatesanupgradeonalloranypartoftheirnetwork,throughoneofthefollowing operations: UpdateUpdateEntireNetworkRootonPage88 UpdateUpdateSelectedNetworkElementsonPage89 UpdateUpdateSelectedNetworkBranchesonPage89
Theupgradeoperationwalksthenetworkaccordingtothespecifiedhierarchyandtheversionofthe updateoperationselected,andthenperformsdirectupgradesofallAPs,BHs,CMMs,andany specificallyselectedSMs.Attheendofeachdeviceupgrade,thedeviceisremotelyrebooted. NetworkUpdaterdoesnotproceedtolowertiersofelementsinthehierarchyuntiluppertier deviceshavecompletedtheirupgradecycle.NetworkUpdaterproceedstootherbranchesofthe networkwhiledevicesinanotherarebeingrebooted.Whiletheupgradeoperationisinprogress,a statuswindowopensfortheusertomonitor.
59
Issue 1 August 2012
Aftertheupgradeoperationonthespecifiedmodulesiscompleted,theprogressstatuswindow automaticallyclosesandasuccessmessageopens.
IfthecurrentconfigurationincludesautomaticallyenablingSMAutoupdatewhenthedirectelement upgradesarecompleted(seeUpdateConfigureonPage77),andatleastonenetworkelementthat wasupdatedwasanAP,thenMessagewindowopens,statingAuto Update process in progress.ThisindirectlyadvisestheuserthattheNetworkUpdaterportionoftheupgradeis completed,andthatAutoupdateoftheSMsisoccurring. IftheSMAutoupdateoptionwasnotautomaticallysetwithinthecurrentconfiguration,theusercan initiatetheSMAutoupdateactivitiesdirectlybyusingtheEnable/DisableAPsforSMAutoupdate operation(seeUpdateEnable/DisableAPsforSMAutoupdateonPage90).Thisdialoguecanbe closedandotherNetworkUpdateractivitiescanbepreformedwhileSMAutoupdateisenabledfor theAPs.Theusercanseeprogressoftheoverallsystembyexaminingthelistofautodiscovered SMs,specificallytheircurrentversioninformationandthestatusfields,totrackprogressonSM Autoupdateactivity.Thesymbol appearsnexttothedevicetypeicontoindicatetheAPis activelyintheSMAutoupdatemode.Thefollowingscreenshowshowthissymbolisused,aswellas howtheStatecolumnoftheAPsindicatesAutoupdatehasbeenenabled,andtheAutoUpdate columnindicatesAutoupdateisEnabled:
NetworkUpdatercontinuestoupdatethestatusoftheautodiscoveredSMsinSMAutoupdate activities.
important ........... Closing the Network Updater application will not turn off SM Autoupdate on the APs in your network, but if your network contains a mixture of older and newer CPU formats, then closing the application ends Network Updaters ability to automatically switch the APs on your network between different image types. This can have the effect of preventing some SMs on the network from being upgraded, even though SM Autoupdate is still running on the APs.
60
Issue 1 August 2012
SMAutoupdatecontinuestorunontheAPuntiloneofthefollowingscenariosexists: SMAutoupdateisdisabledontheAPwithinNetworkUpdater. arebootoftheAP,Ifonlyonetypeofimageisbeingusedonthesector. shuttingoffNetworkUpdaterandrebootingtheAP,iftwotypesofimagesarebeingusedon thesector.
NetworkUpdatertransitionstheAPbetweenthevarioussoftwareimagesuponthefollowing conditions: 1. 2. NoAutoupdateactivityhasbeendetectedfor20minutesonthenetwork. NetworkUpdaterinformationregardingtheAPinquestionindicatesthattherearestillSMs ofthealternateimagetypethatrequireupgradingtothespecifiedpackage.
caution............... Ensure that the Network Updater computer can receive all the associated SM Autoupdate UPD packets communicated on your network so that image transitions do not occur prematurely.
5.2.10
Scheduling an Upgrade for a Future Time

Itmaybedesiredtoscheduleanupgradeforaspecificfuturetime,suchasoffpeakusagetimeinthe middleofthenight.NetworkUpdaterprovidesthiscapabilitythroughtheScheduleNetworkUpdate operation(seeUpdateScheduleNetworkUpdateonPage90).
5.2.11
Examining the Network for Straggler Elements to be Upgraded

Afterthenetworkupgradeprocessiscompleted,andtheuserhasperformedaRefresh/Discover EntireNetworkoperation(seeViewRefresh/DiscoverEntireNetworkonPage74),anypreviously identifiedordiscoverednetworkelementsthatwerenotsuccessfullyupgradedareobviousisascan ofthelistofelements,inthatNetworkUpdaternotshowthenewsoftware,boot,andFPGAversion forthem.Forthesecases,theusermustidentifythereason(s).Possiblereasonsmightbe: Theelementwasapartofabranchthatwasspecificallyomittedfromtheupdateactivity(by theusernotselectingtheelement/branchandchoosingtheoperationUpdateUpdate SelectedNetworkElementsonPage89orUpdateUpdateSelectedNetworkBrancheson Page89,insteadoftheUpdateUpdateEntireNetworkRootoperation. Thenetworkelementisnotcurrentlyonthenetwork(forexample,anSMispowered down). Noimagefileswerefoundamongthecurrentlyactivepackagestosupportthatelement type. Therewasaproblemupgradingtheelement.Manuallyvalidatethehealthandoperationsof theelement.
61
Issue 1 August 2012
5.2.12
Disabling Autoupdate after all SMs have been Upgraded

AfterallSMsonanAPorgroupofAPshavebeenupdatedtothedesiredsoftwareandFPGAversions, itisrecommendedthatSMAutoupdatebeturnedoffforthoseAPs.DisablingofSMAutoupdateis donethroughtheoperationUpdateEnable/DisableAPsforSMAutoupdateonPage90.Performing thisoperationwillhelpensurethat theAPdoesnotinadvertentlydowngradenewSMsthatmaybeaddedtothesector. unnecessarytrafficisnotgenerated,as NetworkUpdaterconstantlyswitchesimagesontheAPinanticipationofnewSMs upgrading. everySMdistinguishesduringregistrationwhetheritshouldbeupgraded.
Additionally,noreliablemeansexiststodetecttheenabledordisabledAutoupdatemodeofanAP.
5.2.13
Saving Current Status Information in the Network Archive File

Theusermustinitiatesavesofthecurrentnetworktothenetworkarchivefiletoensurethatthe informationentered,detected,anddiscoveredonthenetworkismaintainedforthenextsessionof NetworkUpdater.TheusercanusethesaveoperationFileSaveNetworkArchiveonPage64(or FileSaveNetworkArchiveAsonPage64,ifthisisanewfile).UponExit(seeFileExitonPage64), oruponarequesttoloadanalternatenetworkarchivefile(usingFileLoadNetworkArchiveon Page63),NetworkUpdaterpromptstheusertosavethecurrentfilefirst,ifanychangeshavebeen made.
5.2.14
Refreshing the Status Information Upon Start-Up

WhentheuserstartsNetworkUpdater,thepreviouslyloadednetworkarchiveisautomatically loadedasthecurrentnetwork.Sinceitispossiblethatthenetworkcouldhavechangedsincethe userlastenteredNetworkUpdater(forexample,whennewSMsjoinednetworkorfurtherprogress ofanongoingSMAutoupdateoperationhasoccurred),theusermaywantthenetworkarchivedata refreshedbasedonthecurrentnetwork.Forthisreason,NetworkUpdaterautomaticallyasksthe userwhethertoperformaRefresh/DiscoverEntireNetworkoperationuponstartup(see ViewRefresh/DiscoverEntireNetworkonPage74). Thisisfortheconvenienceoftheuser,whocanbecancelitiftheuserdoesnotwantarefresh, knowsnothinghaschanged,orisnotcurrentlylinkedtothenetwork,inwhichcasetheoperation wouldfail.
5.2.15
Using Network Updater to Run Auxiliary Scripts Against your Network

Inupgradingandmanagingthenetwork,performingelementupgradesmaybeonlyoneamongother activitiesthatthenetworkoperatorwantsorneedstoperform.NetworkUpdaterhasabuiltinscript runningenginethatallowsuserdefinedscriptstoberunagainstalloranypartoftheirdefined network.Scriptscanberunoncefortheentirenetwork,oronceforanyselectedelementsinthe
62
Issue 1 August 2012
network.NetworkUpdaterpassesastandardlistofparameterstothescript,givingthescriptallthe informationitmayneedtocommunicatewithandmanipulatenetworkelementsandtheir information. ItisanticipatedthatnetworkoperatorswillfindmanyusesforscriptsrunwithintheirNetwork Updaterenvironment,includingbutnotlimitedtoconfiguration,manipulationofgenericelements thatmaybeassociatedwithorattachedtoCambiumelements,andreportingelementinformation. NetworkUpdaterisdistributedwithasetofscriptstohelptheuserperformoperationsthatare anticipatedtobecommonamongoperators.Giventhestandardinterfaceforinitiatingscripts,and parameterspassedalongwiththem,operatorsmaywishtosharescriptsamongeachother. SeeToolsAddExternalTooltoMenuonPage93formoreinformationoncreatingandrunningyour ownscripts.
5.3
5.3.1
GUI Menu Operations

File Menu
FileNew Network Archive

Clearsthecurrentnetworkinformationfromtheactiveinterfaceinpreparationfortheenteringand discoveryofanewsetofnetworkinformation.Theusershouldsavetheirworkpriortostartinga newnetwork,asunsavedworkwillbelost. ChangestotheactivenetworkarenotsaveduntiltheoperationFileSaveNetworkArchiveon Page64orFileSaveNetworkArchiveAsonPage64isperformed.Untiltheactivenetworkhasbeen assignedaname,theSaveNetworkArchiveoperationwillnotwork,butwillinsteadlaunchtheSave NetworkArchiveAsoperation.
FileLoad Network Archive

Theuserispromptedforthenetworkarchivefiletobeloadedastheactivenetwork.Network archivefileswillendwith.netextensions.Theusershouldsaveworkbeforestartinganewnetwork, becauseunsavedworkislostwhenanewnetworkstarts.Whenanetworkarchiveisopened,the userhasthechoiceofautomaticallyinitiatingaRefresh/DiscoverEntireNetworkoperationofthe networktobringtheirinformationonthenetworkuptodate(seeViewRefresh/DiscoverEntire NetworkonPage74).Thisismostusefulifanactiveupgradeofthenetworkwasongoing(through theSMAutoupdatefeature)whileNetworkUpdaterwasnotactivelyrunning(seeSMAutoupdate FeatureonPage13).
63
Issue 1 August 2012
FileSave Network Archive

Theoperationcausesthecurrentlyactivenetworkinformationtobesavedtothenetworkarchivefile previouslyidentifiedthrougheitheraLoadNetworkArchiveorSaveNetworkArchiveAsoperation (seeFileLoadNetworkArchiveonPage63andFileSaveNetworkArchiveAsonPage64).Untilthe activenetworkhasbeenassignedaname,theSaveNetworkArchiveoperationswillnotwork,but willinsteadtriggertheSaveNetworkArchiveAsoperation.Networkarchivefilesshouldendwith .netextensions.
FileSave Network Archive As

Thisoperationpromptstheuserforafilenameandlocationtocreateanewnetworkarchivefilewith thenetworkinformationfromthecurrentlyactivenetwork.Networkarchivefilesshouldendwith .netextensions.Iftheuserdoesnotsupplyanextensionontheirnetworkarchivefilename,then .netwillautomaticallybeappended.OncetheSaveNetworkArchiveAsoperationasbeen performed,theusermayusetheSaveNetworkArchiveoperationtoupdatethenetworkarchivefile inthefuturewithoutrespecifyingthenetworkarchivefilename(seeFileSaveNetworkArchiveon Page64).
File any of five most recent files

Thisoperationpresentsalistofthefivemostrecentlyusednetworkarchivefilesforquickloading withoutbrowsing.
FileExit
ThisoperationcausestheNetworkUpdatertooltoterminate.Iftheactivenetworkhashadchanges performedtoitsincelastbeingsaved,theuserwillbepromptedtosavetheirchangespriortothe Exitoperationbeingperformed.Iftheuserchoosesnottosavetheirchangesandexitsanyway,all changestotheactivenetworkwillbelost.TheusermayalsoCanceltheExitoperation,inwhichcase theywillbereturnedbacktonormalNetworkUpdateroperations.
5.3.2
Edit Menu
64
Issue 1 August 2012
EditPreferences
ThefollowingscreenisusedtocaptureuserpreferencesforusebyNetworkUpdater.These preferencesaremaintainedthroughmultiplesessionsofNetworkUpdater.
TheMaxHistoryLogFileSizesettingforthehistorylogisusedtocontrolhowlargeNetworkUpdater willallowtheEventLogfiletogrow.WhenthecurrentEventLogfile,nwupdater.loglocatedinthe logsdirectorybelowtheNetworkUpdaterdirectory,reachesthespecifiedmaximumsize,itis archivedintothesamedirectoryandafreshNetworkUpdaterlogfileiscreated.Archivedlogfiles havetheirfilenamesappendedwiththedateandtimeofthelastentryinthefile. TheGatherSMPasswordsandExtractIPAddressandSNMPSettingsoptionisusedtospecify whethertheNetworkUpdatershouldautomaticallyattempttodiscoverSMIPaddressesandSNMP communitystringinformationforSNMPv1andv2cSMs.Ifthisisenabled,thenwheneveranewSM isautodiscovered,NetworkUpdaterattemptstoextractitsIPaddressandcommunitystringfromits webconfigurationpages.TocompletethisactivityandtosupportdirectsoftwareupdatestotheSMs aftertheIPaddressisdetermined,NetworkUpdaterneedsthewriteaccesspasswordforeachSM.
note ............. This write-access password should be the Full Access password for releases prior to 8.0, and should be the password/login ID for the account with admin privileges for Releases 8.0 and later.
65
Issue 1 August 2012
TheDefaultNetworkSettingsareusedtospecifypasswordandSNMPcommunitystringvaluesthat applytoalloralargepartofthenetwork.ThesevaluesarethedefaultvaluesthatNetworkUpdater willattempttousetoobtaininformationandinteractwithelements.InUserAccount,setthe DeviceLoginIDtotheadminlevelaccount.Ifthesevaluesarenotcorrectforaspecificelement, thenNetworkUpdatermayprompttheuserforelementspecificvalues(wheretheDevicePassword isincorrect)orshowincompleteinformationforanelement,suchasonlysitelocationandsite contact(wheretheSNMPCommunityisincorrect).HavingthecorrectSNMPCommunityspecified mayalsoimprovetheperformanceofNetworkUpdaterduringtheinitialdiscoveryactivityfor infrastructureelements(elementsaddedtoNetworkUpdaterbyspecifyinganIPaddress).

note ............. This password should be the Full Access password for releases prior to 8.0, and should be the password for the specified login ID for Releases 8.0 and later.
ThefieldsoftheDefaultNetworkSettingsblockarecontextsensitiveasfollows: Field SecurityLevel AuthProtocol AuthPassword PrivacyProtocol PrivacyPassword NOTES:

1. 2.
Settable in SNMP Version v3 v31 v31 v32 v32
Not Settable in SNMP Version
v1,v2c
OnlyifSecurityLevelissettoeitherAUTH_NOPRIV orAUTH_PRIV. OnlyifSecurityLevelissettoAUTH_PRIV.
ForSNMPVersion,selecttheversionnumberfromthedropdownlist.Ifyouselectv3,selecta SecurityLevelfromthedropdownlist.Thislistprovidesthealternativesforchecksumalgorithm (authentication)andencryption(privacy): NOAUTH_NOPRIVfornoauthenticationandnoprivacy AUTH_NOPRIVforauthenticationwithoutprivacy AUTH_PRIVforauthenticationandprivacy
IfSecurityLevelissettoeitherAUTH_NOPRIVorAUTH_PRIV,then forAuthProtocol,selecteitherMD5orSHA. forAuthPassword,typeastringthatoperatorswhousethisSNMPaccountwillneedto remember.
IfSecurityLevelissettoAUTH_PRIV,then forPrivacyProtocol,selecteitherDESorAES. forPrivacyPassword,typeastringthatoperatorswhousethisSNMPaccountwillneedto remember.
NetworkUpdaterattemptstouseaknownlistofSMpasswordsfirstand,ifnoneofthesegainaccess totheradio,itwillthenprompttheuserforthewritelevelpasswordforthespecificSM.See EditManageSubscriberModulePasswordListonPage68formoredetailsonSMPasswordusage.
66
Issue 1 August 2012
TheHTTPSettingsblock,theselectionofHTTPorHTTPSisatoggle.Devicesthatoperateintheir securemodecanbeupdatedbyonlytheHTTPSserver,regardlessofwhethertheSMAutoupdate featureisactive.Thesedevicesintheirinsecuremode,aswellasdevicesthatoperateanearlier devicesoftwarerelease,canbeupdatedbyonlytheHTTPserveriftheSMAutoupdatefeatureis active.ThoseonanearlierreleasewillbeupdatedbythelocalHTTPorTFTPserver,buttheHTTP selectionhereinthepreferenceswillnotinhibitthatprocess.Theassociatedportnumbersforthese selectionsarenotreconfigurableandmustbeunimpededbythelocalfirewall. TheAutoupdateServerAddressfieldisusedtospecifythedefaultIPaddressthatshouldbegivento APsfortheirAutoupdateauthorizationvalue,whichistheIPaddressthatisallowedtoinitiate AutoupdatecommandswiththeAP.ThisshouldbetheIPaddressofthecomputerrunningthe NetworkUpdaterTool,asseenbytheAP.Foradescriptionofhowthevalueofthisfieldwasset,see SMAutoupdateFeatureonPage13. Ifthisvalueisleftblank,thentheIPaddresstobeusedwillbeautodetectedbasedonactual communicationsbetweentheNetworkUpdaterToolandtheAPinotherwordsthenetwork updatertoolwillasktheAPbywhatIPaddressdoyouseemycommunications?andusethatIP addresstoloadintotheAP.Inmostsituations,thisvalueshouldbeleftblank.Ifyouhaveanunusual networkconfiguration,suchastheNetworkUpdaterToolbehindaNATbox,thenyoumayneedto specifythisvaluedirectlyinorderfortheAPstoaccepttheAutoupdatecommandsfromNetwork Updater.
EditShow/Hide Extended Element Information

Additionalattributesaboutnetworkelementsmaybeavailablethroughtheextendedelement informationlist.TheseattributesincludeSiteName,SiteLocation,SiteContact,UpTime,and DetectedParent.
Theseattributesarefilledinonlyifinformationisavailableforthemonthenetworkelements.The followingisanexampleofanetworkarchivefilethatisdisplayingtheextendedattributecolumns.
67
Issue 1 August 2012
DetectedParentisavailableforonlySMsthatappearwithintheAutoDetectedSMlist.This informationshownhastheformat
AP:[ Host_Name_or_IP].LUID:[#]
whereHost_Name_or_IPisthehostnameorIPaddressasspecifiedbytheuserwhentheyentered theAPinformationintoNetworkUpdater,and#istheLUIDnumberassignedtotheSMbytheAP. ForSMsthatdonothaveadirectIPassociatedwiththemandshownwithintheElementcolumnfor theSM,theDetectedParentvaluemaybeaduplicateoftheinformationshowintheElement columnfortheSM. UpTimerepresentstheamountoftimesincethelastrebootofthenetworkelement.

note ............. This value has a maximum limit of ~497days, at which time the counter that is reported automatically wraps back around to zero. Therefore, this value may not be entirely accurate if the element has been continuously running for more than 497 days.
ChannelBandwidthappliestoonlyPMP430SeriesHighperformanceAP(HPAP)inRelease10.2or laterandtheregisteredSMsinitssector. GPSTimingPulseappliestoonlytheCMMandindicatesitssynchmode.PossiblevaluesareMaster andSlave.
EditManage Subscriber Module Password List

TheNetworkUpdaterautomaticallygathersalistofpasswordsusedforSMwriteaccess.Thislistis gatheredbypromptingtheuserwhenanewSMisdiscoveredandtheexistingpasswordlistdoesnot alreadycontainthewriteaccesspasswordforthatSM.
note ............. This write-access password should be the Full Access password for releases prior to R8.0, and should be the password for the root account for releases 8.0 and later.
TheexistingpasswordlistconsistsofthepasswordfortheAPthattheSMisregisteredto,thedefault systempassword,andanypreviouslyenteredSMpasswordsbytheuser.Thepurposeofgathering thislistofpasswordsistolettheNetworkUpdaterautomaticallydetermineIPaddressesandSNMP communitystringinformationofSMs.WiththisinformationtheNetworkUpdatercanautomatically setupAutoDiscoveredSMsfordirectsoftwareupdates,aswellasdisplaythefulllistofextended attributesfortheSMs(SiteLocation,SiteContact,andUpTime).SeeEditShow/HideExtended ElementInformationonPage67formoredetailsontheseattributes.
68
Issue 1 August 2012
ThiseditcapabilityallowsuserstomanagethelistofSMpasswordsautomaticallygatheredbythe NetworkUpdater,includingremovingpasswordsthatarenolongerinusebyanyelementsinthe system.ThismenuoptionisonlyavailableiftheGatherSMPasswordsandExtractIPAddressand SNMPSettingsinthePreferences/DefaultSettingswindowischecked(seeEditPreferences onPage65).
EditAdd Elements to Highlighted Element

Theelementaddedbythisoperationwillappearundertheelementcurrentlyselectedinthenetwork tree.ThemeaningofthetiersorlevelsfortheitemsinvolvestheorderofupdatingbytheNetwork Updatertool.Higherlevelelementswillbeupdatedfirst.Allelementsatthesamelevelmaybe updatedsimultaneously.RefertoNetworkLayersandOrdersofUpdatingEquipmentonPage17and themaximumnumberofconcurrentupdatessetwithintheUpdateConfigurationscreenformore informationonhowNetworkUpdaterperformsconcurrentupdates(seeUpdateConfigureon Page77).
Whenaddinganelement,theusermustselecteitherNetworkElementorNetworkElementGroup (Folder)fromthepulldownmenu.Bydefaultitisassumedtheelementwillusethedefaultnetwork passwordtoaccessit,anditusesthedefaultSNMPcommunitystring.Ifthisisnotthecasethenthe defaultboxshouldbeunchecked,andthespecificpasswordandcommunitystringshouldbe entered.Forsecurity,theenteredpasswordappearsasallasterisksintheinterface.
69
Issue 1 August 2012

note ............. This password should be the Full Access password for releases prior to R8.0, and should be the password for the specified login id for releases 8.0 and later.
WhereUseDefault/InheritSettingsfromParentElementisunchecked,thedefinitionsandguidance providedunderEditPreferencesfortheUserAccount,HTTPSettings,andSNMPSettingsapply. Whereitischecked,thefieldsoftheseblocksareinheritedfromtheparentandnotreconfigurable. Thehostnames,IPaddresses,orrangesofIPaddressesforallelementstobeaddedshouldbeputin theElementHostName(s)/IPAddress(s)box.Thiswindowallowscuttingandpasting.Notethateach entryshouldbeputonaseparateline.NonIPaddresstextstringsareassumedtobehostnamesand arecomparedagainstthehostfileontheworkstationthatisrunningNetworkUpdateratthetime whencommunicationwiththeelementisrequired. Afteraddingelements,youmustuseoneofthefollowingRefresh/Discoveroptions: ViewRefresh/DiscoverEntireNetworkonPage74 ViewRefresh/DiscoverSelectedNetworkElementsonPage74 ViewRefresh/DiscoverSelectedNetworkBranchesonPage75 ViewContinuousRefreshonPage75
EditAdd Elements to Network Root

ThisoperationbehavessimilartoEditAddElementstoHighlightedElementonPage69,exceptthat theelementsaddedwillbeaddedtotherootlevelregardlessofwhatbranchiscurrentlyselected.All otheractionsarethesame.
70
Issue 1 August 2012
Afteraddingelements,youmustuseoneoftheRefresh/Discoveroptions: ViewRefresh/DiscoverEntireNetworkonPage74 ViewRefresh/DiscoverSelectedNetworkElementsonPage74 ViewRefresh/DiscoverSelectedNetworkBranchesonPage75 ViewContinuousRefreshonPage75
EditRemove Selected Elements

Theusercanremoveoneormorenetworkelementsusingthisoperation.Allcurrentlyselected elementswillberemovedfromtheactivenetwork.Elementsareselectedbycheckingtheboxtothe leftoftheelementinthetreewindow.Ifahigherlevelelementgroupisselectedthenallitems belowitareaautomaticallyselected.Theuserwillbepromptedtoconfirmthedeletecommand.
EditModify Highlighted Network Element Access

TheusercanchangetheHost/IPaddressforanyelementorthegroupnameforanyelementgroup byhighlightingtheelementandselectingthisoperation.
71
Issue 1 August 2012
Additionally,theuseofthedefaultpasswordanddefaultSNMPcommunitystringforanyspecific elementorelementgroupcanbecontrolledonthisscreen.
note ............. This password should be the Full Access password for releases prior to R8.0, and should be the password for the specified login id for releases 8.0 and later.
WhereUseDefault/InheritSettingsfromParentElementisunchecked,thedefinitionsandguidance providedunderEditPreferencesfortheUserAccount,HTTPSettings,andSNMPSettingsapply. Whereitischecked,thefieldsoftheseblocksareinheritedfromtheparentandnotreconfigurable. ForPMP320APs,theoperatormustentertheusernameandpassword,separatedbyunderscore,of theadminaccount(notthereadonlyaccessstringassociatedwiththeguestortheinstalleraccount) intheSNMPCommunitystringfield.Wheretheusernameandpasswordareunchangedfromthe factory,theoperatormustenterthedefaultadmin_admin.Whereeitherhasbeenchanged,the operatormustspecifythestringcomposedfromandformattedasusername_password.Network UpdaterwillnotdiscovertheSNMPCommunityorsendadefaultstringwheretheoperatoromits populatingthisfield. TheSNMPVersionfieldshouldbesettotheversionoftheagentintheselectedelementorofthe agentsthatarehierarchicallyassociatedwiththeselectedfolder.Possiblevaluesfortheagent(s)are v1,v2c,andv3. TheAutoUpdateServerAddressfieldisusedtospecifythedefaultIPaddressthatshouldbegivento APsfortheirAutoupdateauthorizationvalue,whichistheIPaddressthatisallowedtoinitiate AutoupdatecommandswiththeAP.ThisshouldbetheIPaddressofthecomputerrunningthe NetworkUpdaterTool,asseenbytheAP.Ifthisvalueisleftblank,thentheIPaddresstobeusedwill beautodetectedbasedonactualcommunicationsbetweentheNetworkUpdaterToolandtheAP inotherwordsthenetworkupdatertoolwillasktheAPbywhatIPaddressdoyouseemy communications,andusethatIPaddresstoloadintotheAP.Inmostsituations,thisvalueshouldbe
72
Issue 1 August 2012
leftblank.Ifyouhaveanunusualnetworkconfiguration,suchastheNetworkUpdaterToolbehinda NATbox,thenyoumayneedtospecifythisvaluedirectlyinorderfortheAPstoacceptthe AutoupdatecommandsfromtheNetworkupdater.ThisfielddoesnotapplytothePMP320AP, whichdoesnotsupporttheSMAutoupdatefeature.
EditChange Network Element Type

note ............. Some network elements may lose information when they are changed to a different element type. The user will be notified which elements are about to lose information, and will be prompted to confirm the operation before continuing.
Thisoperationallowstheusertochangethetypeofnetworkelementforallcurrentlyselecteditems inthetree.
ElementGroupmaybechangedaswellasnormalnetworkelements,buttheymayonlybechanged throughtherightclickconveniencefunctionaccesstotheModifyElementTypeoperationdueto howthenormalmodifyoperationaffectssubitemsinthetreestructure.
EditMove Selected Network Elements

ThisoperationallowstheusertomovethelocationofaspecificelementwithintheNetworkUpdater treestructure.Thisisveryusefulifyoudecideafterenteringyourbasenetworktocreateelement groups,ortofixhierarchicalorderingissueswithyournetworktree.Thisoperationwillaffectthe currentlyselectednetworkelements.Asecondnetworktreewindowwillappearallowingtheuserto selectwheretheywouldliketheselectedelementmovedto.Itispossibletomoveanautodetected SMfromtheSubscriberModule(AutoDetected)treetotheusermanagedNetworkRoottree,butit isnotpossibletomovenetworkelementstheotherway,intotheSubscriberModule(AutoDetected) tree.
EditOpen Highlighted Network Element Web Page

Thisoperationopensthewebbrowsertothemanagementinterfaceoftheelementthatiscurrently highlighted.Thisoperationissimilarlyavailablethrougharightclickontheelementfollowedby selectionoftheOpenNetworkElementWebPagefromtheresultingdropdownlistofoptions.
73
Issue 1 August 2012
EditUndo Network Changes

ThisoperationrollsbackallchangesthathavebeenmadesincethelastexecutionoftheSave NetworkArchivecommandoptionoccurred(seeFileSaveNetworkArchiveonPage64).Thismay beuseful,forexample,inthecasewhereelementsthathavebeendeletedshouldberestored.
EditFind
Thefindoperationisusedtosearcheitherthenetworkelementstreeorthehistorylogforaphrase orword.Theusercancontrolthedirectionofthesort(upordown)andwalkthroughallthe matchinginstanceswiththeFindNextbutton.Whensearchingwithinthenetworkelementtreeall fieldsrelatedtotheelementswillbesearchedforthespecifiedphrase.
5.3.3
View Menu
ViewRefresh/Discover Entire Network

ThisoperationwillinstructNetworkUpdatertocommunicate(throughacombinationofSNMPand telnetcapabilities)witheachnetworkelementtogathertheirrelevantinformation(software versions,hardwareversions,etc)aswellasinquireastothelatestupdatedlistofSMsthatareseen belowtheindicatedAPs.NetworkUpdaterwillvalidatetheelementtypevalueforeachnetwork element,andifincorrect(basedonactualelementtypeinformationdetectedfromthenetwork),this fieldwillalsobeupdatedasapartoftherefresh/discoveroperation.Foreachelementthat informationisgatheredon,NetworkUpdaterwillupdatetheLastAccesscolumnindicatedasof whentheinformationisvalid.TheStatecolumnwillindicateiftheelementwassuccessfully refreshed,orifanSMwasnewlydiscovered,oriftherewasanyerrorsincommunicatingwiththe element.
ViewRefresh/Discover Selected Network Elements

ThisoperationwillactsimilartoViewRefresh/DiscoverEntireNetworkonPage74,exceptitwill onlyoperateonthenetworkelementscurrentlyselectedbycheckingtheboxtotheleftofeach networkelementinthetree.Elementsbelowtheselectedelementswillnotbeoperateduponunless theyarealsoindividuallyselected.
74
Issue 1 August 2012
ViewRefresh/Discover Selected Network Branches

ThisoperationissimilartoViewRefresh/DiscoverEntireNetworkonPage74,exceptitwillonly operateonthenetworkelementsandbranchesthatarecurrentlyselectedbycheckingtheboxtothe leftofeachnetworkelementinthetree.Theelementsphysicallyselected,aswellasallelements belowthoseselectedelementswithinthetreestructure(eveniftheyarenotselected)willbe refreshed.
ViewContinuous Refresh
ThisoperationcanbeusedtohavetheNetworkUpdatercontinuouslypollthenetworkelementsfor theirsoftwareversioninformation.Theusercandoacontinuousrefreshontheentirenetwork,the selectedbranches,ortheselectedelements.Thiscanbeusefulwhentheuserwishestomonitorthe progressofautomatedupdatesoccurringonthenetwork.Thecontinuousrefresheswillrepeatbased ontheintervalspecifiedonthedialoguepresentedtotheuser.
ToinitiatecontinuousrefreshestheusermustpresstheEnableContinuousRefreshbuttononthe dialogue.WhenContinuousRefreshesareenabled,theuserwillseeaContinuousRefresh(Enabled) popupwindowthatincludesthemessageCurrent Status: Refresh in progress ..as wellasbuttonstodisablethisfeatureorclosetheprogresswindow. ContinuousrefresheswillcontinueuntiltheuserselectseithertheClosebuttonorthe DisableContinuousRefreshbutton.Iftheuserwishestochangetheintervalatwhichrefreshesare occurring,theycanpressDisableContinuousRefresh,changetheintervalvalue,andpress EnableContinuousRefreshagain.
ViewClear History Log Window

ThisoperationclearstheHistoryLogWindowofalleventhistory.Thisoperationhasnoeffectonthe HistoryLogHistoryFile,asalleventsareautomaticallysavedtotheHistoryFile.Thisoperationis meanttoaidtheuserintrackingcurrenteventswithouttheclutterofhistoricaleventsbeingonthe displaywindow.
75
Issue 1 August 2012
ViewShow Full History Log

IftheShowFullHistoryLogoptionisselected,thenNetworkUpdaterwillloadtheentirehistorylog intotheeventviewerwindowuponstartuporupontheselectionofthisoption.Otherwise,onlythe neweventsgeneratedsinceNetworkUpdaterwasstartedwillbeshowninthewindow.
tip ................ It is more efficient if only the latest events are shown in the window, so the user may want this option off until a time where they need to view historical events. The user should be aware that if this option is turned on, and they select the Clear History Log Window option, the full history log will no longer be displayed in the Event Window (see ViewClear History Log Window on Page 75). To redisplay the full history log the user would either need to restart the Network Updater, or unselect and reselect the Show Full History Log option.
ViewHorizontal Scroll Deep Tree

Atoggletypecommandoptioninthemainmenuenableshorizontalscrollbar.TheViewHorizontal ScrollDeepTreeselectionallowstheusertoseesubfoldersbeyondthe55threcordtoanydesired depthofelements.
5.3.4
Update Menu
76
Issue 1 August 2012
UpdateConfigure
ThisoperationallowstheusertoconfiguresettingsrelatedtotheUpdateoperations.Theusercan control: howmanyconcurrentupdateswillberun. whethertheAP 2shouldbeusedasafilemanager,oralocalHTTPorTFTPservershouldbe usedbytheSMstoaccesssoftware,boot,andFPGAimagefiles. theIPaddressofthelocalTFTPserveraccess,ifthisservertypeistobeused. whetherNetworkUpdaterandassociatedExternalToolsshoulduseActiveorPassiveFTP whencommunicatingtothenetworkelements. theorderinwhichtoloadsoftwareimagesontotheAP,dependingonselectedfirmware type(s). inthecaseofthehighperformancePMP430AP aspecificchannelbandwidthtoinstructtheHPAPtoswitchitsoperationto,basedon itscurrentchannelbandwidth. whethertoproceedwithorabandonthechannelbandwidthswitchingoperationinthe casewheretheHPAPhasatleastonecurrentlyregisteredSM.
Thespecificconfigurablesettingsareasfollows. WhereTheAccessPointisselectedasthefileservertype:
OnlywheretheAPsupportsSMAutoupdate.
77
Issue 1 August 2012 WhereCNUTHTTPServerisselectedasthefileservertype:
WhereLocalTFTPServerisselectedasthefileservertype:
TheMaximumConcurrentUpdatesshouldbeanattributeoftheprocessingpowerandavailable RAMonthecomputerrunningNetworkUpdater.Thisnumberofupdatesappliestothenumberof APs,BHs,andCMMs,thatwillbeupdateddirectlybyNetworkUpdater.SMsarenotdirectlyupdated bytheNetworkUpdaterunlesstheyhavearoutableIPaddressdefinedforthemandaredirectly selectedforupdating,butinsteadSMsarecommandedtoupdatethemselvesbytheirparentAP, typicallyaftertheAPhasitselfbeenupdated(seeSMAutoupdateFeatureonPage13).Ageneralrule isthatoneupdateper20MBofavailableRAMcanbesupported.So,ifthecomputerhas256MBof RAM,thenavalueofapproximately13concurrentupdatescouldbesupported.Actualperformance willvarysotheusermayneedtodeterminetheappropriatevaluefortheirnetworkaccordingto theirsituationandconfiguration.
78
Issue 1 August 2012
TheusermustalsoconsiderhowconcurrentupdatesbothbyNetworkUpdaterandthroughtheSM Autoupdatefeature,willaffectnetworkbandwidth(duetousageofavailablebandwidthinorderto delivertheimagefilestothevariousnetworkelements).Theusermaywishtonotmaximizethe parallelismoftheupgradeprocess,orchoosetorunthenetworkupgradeduringoffhourswhenthe bandwidthutilizationwillnotimpactactivecustomerusage. IftheEnableSMAutoupdateWhenanAccessPointisUpdatedoptionischecked,thentheNetwork UpdaterwillautomaticallyenableSMAutoupdateonallselectedAPsafterthedirectelement updatesarecompleted.UsingthisoptionsavestheuserfromhavingtoseparatelyturnonSM AutoupdateusingUpdateEnable/DisableAPsforSMAutoupdateonPage90.Bywaitinguntilall selectednetworkelements(includingSMsiftheyareselectedbytheuser)aredirectlyupdated beforeenablingSMAutoupdate,NetworkUpdaterhelpstoavoidproblemsthatcouldoccurwhen concurrentlyusingSMAutoupdateatmultiplelevelsinthenetworktreehierarchy.
caution............... The Continue updating child elements if parent fails to update option has the inherent risk of putting the child elements out of ability to communicate with the parent. So, extreme caution is advised when this option is considered for selection.
SM Autoupdate Configuration Tab

Tohelpoptimizetheupgradeperformanceonasector,theselectionsTheAccessPointandtheCNUT HTTPServerincludetheAutoUpdateSMTypeblockoptionstoMoveUporMoveDownanSMType andtherebyreordertheupdatesbySMtype.Differentsoftwareimagesareneeded,dependingon whethertheplatformrevisionisP7/P8/P9,P10,orP11,andanAPcanholdonlyonesetofthe imagesatatime.Becauseofthis,itisnecessarytoswitchtheimageontheAPfromonetotheother toensureallSMsonthesectorcanbeupgraded.Theupgradepackageitselfwillattemptto determinewhichimageisbesttoloadontheAPfirstduringtheAutoupdatesequence,butifit cannotdetermineagoodfirstchoiceitwillmakeuseofthevaluesetheretocontrolwhichimage typetoloadfirst.Therefore,ifyouarerunninganetworkofonlyoneimagetype,andyouseeadelay inAutoupdatecommencingonyournetwork,youcanswitchthisoptionsettingtotrytoexpediteit. However,acheckboxisavailableforOrderbyRegisteredSMNumber.Ifyoucheckthischeckbox, WMcountsthenumberofregisteredSMsofeachAutoupdateSMType(howmanyP7/P8/P9,how manyP10,andhowmanyP11),andfirstupdatestheallofthetypewiththemost,thenallofthe typewiththesecondmost,andthenallofthetypewiththeleast,ignoringtheverticalorder specifiedintheAutoUpdateSMTypeblock.Ifyouleavethisboxunchecked,itusestheorderinthe block. IftheContinueUpdatingChildElementifParentElementFailtoUpdateoptionissetthenNetwork Updaterwillcontinuetoperformupdateoperationsonnetworkelementsthatappearinthenetwork treebelowanelementthatfailedtoupdate.Ifthisoptionisnotchecked,thennonetworkelements underafailedelementwillbeupdatedifahigherlevelelementfailedtoupdate.Thisoptionallows theusertoensureconsistentreleasesbetweenparentsandchildreninthenetwork,ifthatisa concern.Ontheotherhand,ifthisisnotaconcerntotheuser,thenbyhavingthisoptionchecked theycouldensurethatNetworkUpdaterwillupdatethelargestpossibleportionofthenetwork automatically.
79
Issue 1 August 2012
Somenonfatalcausesforthetreefailingtoupdateanelementareasfollows: Theaddressfortheelementisnonroutableorincorrectlyspecified,orthereisnohostvalue inthehostfile. ThecurrentInstallationPackagesdonotcontainanyupgradefilesforthetypeofnetwork elementencountered. Thenetworkelementisnotonthenetworkatthetimetheupdateisperformed.
Inseveraloftheseinstances,itmaybepossibleandsafetocontinueupgradingelementsinthe networktreebelowtheelementinquestion. TheSMAutoupdateConfigurationsectionallowstheusertospecifywhatamongthefollowingmeans shouldbeusedforthefileserverfromwhichSMsobtaintheirupgradefiles: toallowNetworkUpdatertoactasanHTTP/HTTPSserver.ThisoptionconfiguresNetwork UpdatertoallowdevicestopulltheirimagefilesfromtheHTTP/HTTPSserverandto monitorupgradestatusviaSNMPmessages.WhenCNUTHTTPServerisselectedasthefile servertype,setthetoggleforeither UpdateWithAllImages(TheupdateprocessusestheorderspecifiedintheAuto UpdateImageOrderblockorautomaticallychoosestheorderifthatcapabilityis supportedinthefirmware.) UpdateFollowingImageOrderSettings(theupdateprocessusestheorderspecifiedin theAutoUpdateImageOrderblockforalldevicesthatareflaggedforupdating)
tousethelocalTFTPserver.Withthisoption,ifthefirmwaresupportsasecuremode,then thedevicemustbesettoitsinsecuremode. ThisLocalTFTPServeroptionrequiresaconfiguredIPaddressfortheTFTPserverandthe rootdirectorywhereNetworkUpdaterstorethefilesfortheSMstopull.Onamultihomed computer(onewithmultiplenetworkinterfacecardsandIPaddresses),theaddressto selectfromthedropdownlististheoneonwhichthenetworkresides. TheoperatorisresponsibleforconfiguringtheTFTPserverappropriately,ensuringitison thenetworkforallSMstoaccess,andforsettinguptherootdirectory.IftheTFTPserveris configuredcorrectly,theTestTFTPServeroperationshouldreturnasuccessmessage. UpdateprogressismonitoredbyFTPmessaging. WhenanetworkTFTPserverisused,asmanyas20SMsperAPcanperformconcurrent upgrades.YoucanconfigureNetworkUpdatertoallowfewerifyouareconcernedabout overloadingthecapabilityoftheTFTPserver.
tohavetheAPsservetheupgradefiles(TheAccessPoint).Thistypicallyistheleast favorableoption,sincetheotheroptionsoffloadprocessingfromtheAPsandsupport agreaternumberofsimultaneousSMupdatesinthenetwork.WhenanAPisusedasa fileserver,only4SMsassociatedwithaparticularAPcanperformconcurrentupgrades. TheupdateprocessusestheorderspecifiedintheAutoUpdateImageOrderblockforall devicesthatareflaggedforupdating.UpdateprogressismonitoredbyFTPmessaging.
note ............. An external TFTP server can be used only if the SMs on the network can communicate with the IP address that is specified. In most networks, where the SMs have been configured with an IP address with local Network Accessibility, this will not be the case. The Test TFTP Server button will only verify that the TFTP server is active, and that the TFTP root folder has been correctly configured. It does not guarantee that SM Autoupdate will function correctly for an SM. In order to determine if an SM can communicate with the TFTP server, telnet into the SM, and ping the TFTP server. If the ping test fails, SM Autoupdate will not be able to function. In this case, it is suggested that the user default to using the Access Point as the File Server. SM Autoupdate will always work in this configuration.
80
Issue 1 August 2012
HPAP Channel Bandwidth Tab

ImproperuseofthistabcanresultinSMsdroppingtheirconnectionstotheHPAPandnotbeingable toreconnect: ThePMP430SeriesSMthatoperatesonRelease10.0or10.1.1cannotcommunicatewith anAPthatoperatesonRelease10.2orlater.So,undernocircumstancesshouldyou upgradeanyPMP430SeriesAPtoRelease10.2orlateruntilallofitsSMshavefirstbeen upgradedtothatrelease. Similarly,aRelease10.2orlaterHPAPthatissettoachannelbandwidththatdiffersfrom thatofitsSMscannotcommunicatewithitsSMs.So,thedesiredchannelbandwidthshould neverbesetintheHPAPuntilitissetinalloftheSMsinthesector. InthecasewhereyouwanttodowngradeasectorfromRelease10.2orlatertoRelease 10.1or10.0,youmustfirstchangethesectortothe10MHzchannelbandwidth(SMsfirst) andthendowngradealloftheSMsbeforeyoudowngradetheHPAP.
However,inherentinasectorofanyconsiderablesizeisthefactthat,atanygiventime(whenyou wouldliketocutovertothenewreleaseorlatertothenewchannelbandwidth),someoftheSMs arelikelytobeoutofservice(powereddownbytheenduserorencounteringtransientRFproblems, forexample).Toavoidorminimizetrouble,youcan 1. 2. 3. usePrizmtoidentifytheoutofserviceSMsbytheirrediconcolor. usePrizmtodisplaythecorrelatedcustomercontactinformation. asktheendcustomertoattempttoreestablishthelinkbeforeyouproceedwiththe operationthathasthehazardofstrandingSMs.
Properuseofthistabisassequencedinthefollowingexample.Thegoalintheexamplecaseisto haveanentirePMP430HPAPtowerlinkedat20MHzchannelbandwidth,andnoSMsthatare unabletoreconnecttotheHPAPincasetheygooutofserviceforsomereasonaftersuccessful connectionatthatsizeofchannel.Performthefollowingsteps: 1. 2. 3. 4. 5. 6. 7. 8. 9. Planyourupgradesessiontooccuratadateandtimewhenhistoricaldatasuggeststhatthe fewestSMsarenotinservice. Whenthedateandtimearrive,sendablasttoallcustomers,urgingthemtokeeptheir sessionsup. UsealternativemeanstoaskcustomerswhoseSMsareoutofsessiontoattemptto reconnecttheRFlink. Inthenetworkbrowserofthemainconsolewindow,highlightallAPsofthetower. Fromthemainmenu,selectUpdateManagePackages(seePage85). CheckonlytheupgradepackageforRelease10.2orlater(inAESorDES)anduncheckany othersthatarecheckedinthePackageList. ClickClose. Fromthemainmenu,selectUpdateEnable/DisableAPsforSMAutoupdate(seePage90). IntheElementsblockoftheresultingEnable/DisableAPsforSMAutoupdatedialogwindow, selecteither SelectedNetworkElementsforupdatingonlytheSMsimmediatelybeneaththeAPs thatyouhighlighted. SelectedNetworkBranchesforupdatingalloftheSMsthatareunderthefoldersorAPs thatyouhighlighted.
81
Issue 1 August 2012 10. IntheModeblockofthisdialogwindow,selectEnable. 11. Atthebottomofthisdialogwindow,clickOK.
12. Fromthemainmenu,selectUpdateUpdateSelectedNetworkElements(seePage89). 13. ClickYestoconfirmthatNetworkUpdatershouldexecutetheupdateoperation. RESULT:AlloftheregisteredSMsinthesectorareupgradedtoRelease10.2andthen droptheirregistrationstotheAP. 14. WhenallinsessionSMshavebeenupgraded,makeanotherattempttogetanythatarestill runningtheoldreleaseupgraded. IMPORTANT:Anythatyoustillcannotupgradewillrequireatruckrollbeforetheywillbe abletoreconnecttotheHPAP. 15. Fromthemainmenu,selectUpdateEnable/DisableAPsforSMAutoupdate(seePage90). 16. IntheModeblockoftheresultingEnable/DisableAPsforSMAutoupdatedialogwindow, selectDisable. 17. Atthebottomofthisdialogwindow,clickOK. 18. Fromthemainmenu,selectUpdateUpdateSelectedNetworkElements(seePage89). 19. ClickYestoconfirmthatNetworkUpdatershouldexecutetheupdateoperation. RESULT:TheAPsareupgradedtoRelease10.2asHPAPs,andthenalloftheupgradedSMs reregisterintotheirHPAPs. 20. WaituntilalloftheupgradedSMshavereregistered. 21. Fromthemainmenu,selectUpdateConfigure(seePage77). 22. UsetheHPAPChannelBandwidthtabtosettheTargetBandwidthto20MHzforthe CurrentBandwidth.ClickintheTargetBandwidthcolumnattheproperrowtoexposethe dropdownselectionlist. 23. IntheChannelBandwidthSwitchModeblockofthistab,selectSwitchChannelBandwidth EvenifSMsarePresent. 24. Atthebottomofthistab,clickOK. 25. Fromthemainmenu,selectUpdateEnable/DisableAPsforSMAutoupdate(seePage90). 26. IntheModeblockoftheresultingEnable/DisableAPsforSMAutoupdatedialogwindow, selectAutoupdateSMChannelBandwidth. 27. Atthebottomofthistab,clickOK. 28. Fromthemainmenu,selectUpdateUpdateSelectedNetworkElements(seePage89). 29. ClickYestoconfirmthatNetworkUpdatershouldexecutetheupdateoperation. RESULT:ThechannelbandwidthofallconnectedSMsischangedto20MHz,andthey droptheirconnectionstotheirHPAPs. 30. Fromthemainmenu,selectUpdateEnable/DisableAPsforSMAutoupdate(seePage90). 31. IntheModeblockoftheresultingEnable/DisableAPsforSMAutoupdatedialogwindow, selectDisable. 32. Atthebottomofthistab,clickOK. 33. Fromthemainmenu,selectUpdateUpdateSelectedNetworkElements(seePage89). 34. ClickYestoconfirmthatNetworkUpdatershouldexecutetheupdateoperation. RESULT:ThechannelbandwidthoftheHPAPsischangedto20MHz,andallsectorsofthe towerareoperationalwhenalloftheSMshavereregisteredfollowingthereboot,except forthoseSMsthatwerenotinsessionduringboththeupgradeandthechannelbandwidth change,andconsequentlywillrequireatruckroll.
82
Issue 1 August 2012
Inasecondexamplethatfollowshere,thegoalistodowngradeanentirePMP430HPAPtowerfrom Release10.2orlatertoRelease10.1.1,andhavenoSMsthatareunabletoreconnecttotheHPAP. Performthefollowingsteps: 1. 2. 3. 4. 5. Planyourdowngradesessiontooccuratadateandtimewhenhistoricaldatasuggeststhat thefewestSMsarenotinservice. Whenthedateandtimearrive,sendablasttoallcustomers,urgingthemtokeeptheir sessionsup. UsealternativemeanstoaskcustomerswhoseSMsareoutofsessiontoattemptto reconnecttheRFlink. Inthenetworkbrowserofthemainconsolewindow,highlightallHPAPsofthetower. IntheHPAPChannelBandwidthtab,clickintheTargetBandwidthcolumnatthe5.0(MHz) CurrentBandwidthrowtoexposethedropdownselectionlistandselect10.0(MHz)for TargetBandwidth. ClickintheTargetBandwidthcolumnatthe10.0(MHz)CurrentBandwidthrowtoexpose thedropdownselectionlistandselect10.0(MHz)forTargetBandwidth. ClickintheTargetBandwidthcolumnatthe20.0(MHz)CurrentBandwidthrowtoexpose thedropdownselectionlistandselect10.0(MHz)forTargetBandwidth. AtthebottomoftheHPAPChannelBandwidthtab,clickOK. Fromthemainmenu,selectUpdateEnable/DisableAPsforSMAutoupdate(seePage90).
6. 7. 8. 9.
10. IntheElementsblockoftheresultingEnable/DisableAPsforSMAutoupdatedialogwindow, selecteither SelectedNetworkElementsforupdatingonlytheSMsimmediatelybeneaththeAPs thatyouhighlighted. SelectedNetworkBranchesforupdatingalloftheSMsthatareunderthefoldersorAPs thatyouhighlighted.
11. IntheModeblockofthisdialog,selectAutoupdateSMChannelBandwidth. 12. Atthebottomofthethisdialog,clickOK. 13. Fromthemainmenu,selectUpdateUpdateSelectedNetworkElements(seePage89). 14. ClickYestoconfirmthatNetworkUpdatershouldexecutetheupdateoperation. RESULT:Thechannelbandwidthischangedto10.0MHzintheSMs.

note ............. When this occurs, connection between the HPAPs and these SMs is dropped, except where the HPAPs are already operating in 10-MHz channel bandwidth.
15. WhenallinsessionSMshavebeenreconfiguredto10MHzoperation,makeanother attempttogetanythatarestilloperatingineitherthe5orthe20MHzchannelbandwidth reconfiguredto10MHzandclickOKagainintheEnable/DisableAPsforSMAutoupdate dialogwindowtoreconfigurethem.

important ........... Any that you still cannot reconfigure to 10 MHz will require a truck roll before they will be able to reconnect to the HPAP.
16. AllowsufficienttimefortheSMswhoseconnectionsweredroppedtoreregisterintheirAPs afterthereboot. 17. Fromthemainmenu,selectUpdateManagePackages(seePage85). 18. CheckonlytheCANOPY101_1_Downgrade_OFDM_AESorDES.pkg3packageanduncheck anyothersthatarecheckedinthePackageList. 19. ClickClose.
83
Issue 1 August 2012
20. Fromthemainmenu,selectUpdateEnable/DisableAPsforSMAutoupdate(seePage90). 21. IntheModeblockofthisdialog,selectEnable. 22. ClickOK. 23. Inthemainmenu,selectUpdateUpdateSelectedNetworkElements(seePage89). RESULT:OnlytheregisteredSMs(nottheHPAPsalso)aredowngradedtoRelease10.1.1. TheywilldroptheirconnectionstotheHPAPsandbeunabletoreregister. 24. ClickYestoconfirmthatNetworkUpdatershouldexecutetheupdateoperation. 25. Fromthemainmenu,selectUpdateEnable/DisableAPsforSMAutoupdate(seePage90). 26. IntheModeblockofthisdialog,selectDisable. 27. ClickOK. 28. Fromthemainmenu,selectUpdateUpdateSelectedNetworkElements(seePage89). 29. ClickYestoconfirmthatNetworkUpdatershouldexecutetheupdateoperation. RESULT:Thistime,theHPAPsaredowngradedtoRelease10.1.1.TheSMconnectionswill dropandthenbereestablishedafterthereboot,atwhichpointallsectorsofthetowerwill beoperatingonRelease10.1.1,exceptforthoseSMsthatwerenotinsessionduringboth thechannelbandwidthchangeandthedowngrade,andconsequentlywillrequireatruck roll.
UpdateHttp Server Configure

TheSMAutoupdateConfigurationsectionallowstheusertospecifyNetworkUpdatertoactasan HTTP/HTTPSserverfordevicesthatsupportthisoption.ItconfiguresNetworkUpdatertopushimage filestothedevicesviaSNMPcommands,tomonitorupgradestatusviaSNMPmessages,andtoallow thedevicestopullimagefilesfromtheconfiguredHTTP/HTTPSserver.Updateprogressismonitored bySNMPmessaging.
WhenCNUTHTTPServerisselectedasthefileservertype(seeUpdateConfigureonPage77),this interfaceallowsyoutospecify HTTP(forupdatingdevicesthatareoperatingintheirinsecuremode) HTTPS(forupdatingdevicesthatareineithertheirsecureorinsecuremode,underthe SMAutoupdatefeature) BOTH(tocovereverycase).Thisistherecommendedsetting.
84
Issue 1 August 2012
Theportnumbersassociatedwiththeseserversaredisplayedbutnotreconfigurable.TheIPaddress thatyouselectinthecaseofamultihomedNetworkUpdatercomputer(onewithmultiplenetwork interfacecardsandIPaddresses)mustbeboththeaddressofNetworkUpdaterandreachablefrom everydevicethatwillbepullingimagefilesfromitsfileserver. Uponsystemstartup,NetworkUpdaterbydefaultattemptstostartthefileserverthatisconfigured here.Ifyouwishtosuppressthatfileserverstartupattempt,unchecktheStartserverbydefault optioninthisinterface.
Whenyouchangeanyconfiguredsettinginthisinterface,yourchangewillnottakeeffectunlessyou applyitbyaclickoftheRestartbutton. IntheServerStatusblockatthetopofthisinterface,NetworkUpdaterindicatesthefileserverstatus witheitherHttp Server StoppedorHttp Server Started.Tostartthefileserverifitis currentstopped,clicktheStartbutton.Wheneverthefileserverisrunning(started),youcantestits connectivitytotheNetworkUpdaterapplicationbyclickingtheTestbutton.Asuccessfultestreturns thefollowingaseitherlocalhost/index.htmlorhttps://localhost/index.html,dependingonwhether thetestisappliedtotheconnectionisinHTTPorHTTPS:
UpdateManage Packages
ThisoperationletstheusertellNetworkUpdateraboutavailableupgradepackagesthatcanbeused forupgradingthenetwork.NetworkUpdatercanbetoldaboutunlimitedpackages,andbetoldto useoneormoreofthematatime.
85
Issue 1 August 2012
NewPackagescanbeaddedthroughtheAddfunction.Theuserwillbepromptedtoselectthe packagethroughafilebrowser.Packagesthatarenolongerusedoroutofdatecanberemovedfrom theManagePackagewindowbyusingtheRemoveoperation.Thiscanhelptheuserreduceclutter andpossibleupgradeconfusion.

note ............. The currently highlighted (versus currently checked) packages are what will be removed. You can only remove one package at a time.
ThecurrentpackagesthatNetworkUpdaterwillusewhenperformingupgradesareindicatedby checkingthedesiredpackagesinthepackagelist.AllcheckedpackageswillbeexaminedbyNetwork Updaterforrequiredsoftwareandfirmwaretoperformupgradesfrom. TheorderthatthepackagesappearinthelististheorderwhichNetworkUpdaterwillexaminethem inordertofindasoftwareorfirmwareloadtoupgradeanyparticularnetworkelement.Network Updaterwillcontinuetolookatthepackagesuntilitcomesuponacomponentwithinapackagethat canbeusedforaparticularnetworkelement.Onlythefirstacceptablecomponentforthenetwork elementwillbeused.Ingeneralmostsoftwarepackagescontainsoftwareforalltypesofradiosand platforms,soselectingjustthelatestsoftwarepackagewillbesufficienttoperformmostupgrades. TheusercanchangetheorderthatNetworkUpdaterwillexaminethepackagesbyhighlightingany particularpackageandusingtheMoveUporMoveDownoperations. ThePackageInfowindowdisplaystherelevantinformationaboutthepackagecontents.Thiswindow showsthenameofthepackage,filelocation,andtheversionnamesofthefollowingsub componentsofaupgradepackage,iftheyareincludedinthepackage: SoftwareVersionString BootVersionString HardwareVersionString(FPGA) CMMSoftwareVersionString
Afterdownloadingapackagefile,verifyingitschecksumvalueagainstthevalueofthecompanion md5fileisrecommendedtoensurethatthepackagefiledidnotbecomecorruptedduringthe downloadprocess.NetworkUpdaterprovidesanefficientmeansfortheoperatortodothis.Inthe PackageManagerinterface,clicktheVerifyChecksumtab.
86
Issue 1 August 2012
Usethisfeatureasfollows: 1. ForFileName,clicktheassociatedellipsisbuttonandbrowsetoandselectthepackagefile.
2. 3.
ClicktheCalculate/VerifyChecksumbutton. ForCompareTo,clicktheassociatedellipsisbuttonandbrowsetoandselectthemd5file.
87
Issue 1 August 2012
4.
VisuallycomparethevaluesthataredisplayedintheFileChecksumandCompareTofields.
Ifthesevaluesmatch,theconditionofthepackagefileisvalid.Iftheydonot,thepackagefilehas beencorrupted.Inthiscase,repeatthedownloadofthepackagefileandrepeatthisverification procedureonthenewerdownloadedfile.

note ............. The utility of this feature extends to any type of downloaded file that has a companion md5 value. It is not limited to Network Updater package files.
UpdateUpdate Entire Network Root

ThisoperationwillcausetheNetworkUpdatertoaccesseachnetworkelementbelowtheNetwork Roottochecksitscurrentsoftware,boot,andFPGAversionsasapplicable.Sincethisoperationwill causechangesonthenetworkelements,theuserisaskedtoconfirmtheoperationpriorto continuing.
88
Issue 1 August 2012
ThisoperationwillnotoperateonanySMsthathavebeenautodetected.Iftheversionsarenotthe sameasthefirstsetofsoftware,boot,orFPGAfilesfoundinthecurrentlyactivePackages(see UpdateManagePackagesonPage85),thenanupdateofthenetworkelementwillbeinitiated. FornonPMP320sectors,itispossibletoupdateSMsinthenetworkintwoways,eitherenablingthe SMAutoupdatecapabilityontheAPs(seeUpdateEnable/DisableAPsforSMAutoupdateon Page90andSMAutoupdateFeatureonPage13),ordirectlyupdatingtheSMfromNetwork Updater.IfaSMisselectedwhenthisoperationisperformed,NetworkUpdaterwilllooktoseeifa routableIPaddresshasbeenspecifiedfortheSM.IfanIPaddresshasbeenspecified,thenNetwork UpdaterwillaccesstheSMandperformtheupgradedirectly.IfanIPisnotspecified,andonlyLUID throughanAPisknown,thenNetworkUpdatewillnotbeabletoperformadirectupgrade.Inthis instanceeitheraroutableIPaddressmustbeprovidedfortheSM,ortheAPthattheSMisattached toshouldhaveSMAutoupdateenabledtoforcetheSMtoupgradeitself. TheusercanmonitortheprogressoftheNetworkUpdaterupdatesintheHistoryLogWindow. Additionally,theStatecolumnwillshowthecurrentstatusofelementsbeingupdated.Network Updaterwillperformtheupdatestomultiplenetworkelementssimultaneouslybasedonthetree structuredefinedbytheuser(seeNetworkLayersandOrdersofUpdatingEquipmentonPage17) andthemaximumnumberofconcurrentupdatessetwithintheUpdateConfigurationscreen(see UpdateConfigureonPage77). NetworkUpdatervalidatesanelement'stypebeforeperforminganupdateoperation,thusensuring thatincorrectoroutofdateinformationinthetooldoesnotcauseissuesontheactualnetwork elements.Whenalloftheselectednetworkelementshavebeenvisitedandupdated,themain NetworkUpdaterscreenwillberefreshedshowingthenewversionsofsoftware,boot,andhardware (FPGA)foreachnetworkelement,asapplicable.
UpdateUpdate Selected Network Elements

ThisoperationwillactsimilartoUpdateUpdateEntireNetworkRootonPage88,exceptitwillrun againstonlynetworkelementsthatarecurrentlyselectedusingthecheckboxesoneachrow.This operationdoesallowtheusertoselectautodetectedSMstobedirectlyupdatedbytheNetwork Updatertool.
UpdateUpdate Selected Network Branches

ThisoperationwillactsimilartoUpdateUpdateSelectedNetworkElementsonPage89,exceptit willrunagainstallnetworkelementsbelowanyselectedNetworkBranches,evenifthenetwork elementsthemselvesarenotcurrentlyselected.Thisoperationdoesallowtheusertoselectauto detectedSMstobedirectlyupdatedbytheNetworkUpdatertool.
89
Issue 1 August 2012
UpdateEnable/Disable APs for SM Autoupdate

ThisoperationallowstheusertoenableordisableSMAutoupdateontheAPs(seeSMAutoupdate FeatureonPage13)withintheNetwork,otherthanPMP320APs.
TheusercanoperateuponSelectedNetworkElements,orSelectedNetworkBranches.Iftheuser choosesSelectedNetworkBranches,thenallelementsbelowtheselectednetworkbrancheswillbe operateduponevenifthenetworkelementsthemselvesarenotcurrentlyselected.TheSM AutoupdatemodewillremainineffectontheselectedAPsuntileithertheuserdisablesit,ortheAPs arerebooted,whichevercomesfirst. TheAutoUpdateSMChannelBandwidthoptioninstructsthePMP430SeriesHighperformanceAP toreconfigurethechannelbandwidthinitsSMsthatoperateonRelease10.2orlater.Thisoption mustbeusedbeforetheoptiontoswitchthechannelbandwidthoftheHPAPisused.SeeHPAP ChannelBandwidthTabonPage81. NetworkUpdaterisabletochangethestateofanAPtoDisableregardlessofwhetheritisaccessible atthetimethatthisselectionisenforcedbyclickingOK.
UpdateSchedule Network Update

NetworkUpdaterallowstheusertosetuptheirnetworkforafullorpartialupgrade,andthen scheduletheactualupdateoperationstostartatsometimeinthefuture.Thisisusefulwhenyou wanttohavetheactualupdatesperformedatoffhours,sincetherewillbeslightservice interruptionstosubscribersasthevariousnetworkelementsareupdated.
90
Issue 1 August 2012
Theusercaneithermanuallytypeinthedateandtimetheywishtheupdateoperationtocommence, ortheycanclicktheChangebuttonandusetheGUIclockandcalendarwindowtospecificthestart dateandtime.Allreferencetostarttimeisinassociationwiththesystemclockandsettings(suchas timezone)ofthelocalcomputerthatisrunningNetworkUpdater.
Theuserthenselectsfromamongthefollowingoptionsthetypeofupdateoperationtoperform: ViewRefresh/DiscoverEntireNetworkonPage74 ViewRefresh/DiscoverSelectedNetworkElementsonPage74
FinallytheuserindicatesiftheywouldlikeSMAutoupdateenabledatthecompletionoftheupdate operation.TheseoperationswillperformidenticallywhethertheuserdoesthemofftheUpdate menudirectly,ordoesthemthroughascheduledupdateoperation.Whiletheuserisstillselecting thestarttimeforthescheduledupdateoperation,andthetypeofoperationtobeperformed,they maystillinteractwiththeNetworkUpdatermainmenutoselectanddeselectelementsandbranches thatmaybeaffectedbythescheduledupdateoperation. TheuserputsNetworkUpdaterintoaScheduledUpdatemodebyselectingtheOKbuttononthe ScheduleNetworkUpdatewindow.ThisoperationlocksNetworkUpdateruntilthescheduledtimeis reached,atwhichtimeNetworkUpdaterwillcommencewiththespecifiedupdatecommand. Tocancelthescheduledupdate,selectthisoperationfromthemenuandclicktheChangebuttonin theScheduleNetworkUpdateinterface,theninthecalendarinterface,clicktheResetbuttonand thenOK. Whenanupdatebegins,NetworkUpdatershowsitsstatusinaProgresspopupwindow.
91
Issue 1 August 2012
UpdateUpload Certificate to Selected Elements

ThisfeatureallowstheusertoapplyaAAA(RADIUS)authenticationcertificatetoanyoneormore selectedPMPSMsand/orPMP320CPEdevices.ThetargetdevicesdonotrequireIPaddresses,since theAPrelationshipthatunderliesthisfunctionwithitsregistereddevicesistheLUIDassignmentsfor thethemwithintheAPs.However,thisfeaturerequiresthattheLUIDsofthetargetdevicesis current.
important ........... To ensure current LUIDs, refresh the APs before executing this Network Updater command option.
IftheuserselectsthisoptionwhennoPMPslavedevicesareselected,thenNetworkUpdaterreturns thefollowingerror:
WhenatleastonePMPSMorPMP320CPEdeviceisselectedbeforethisutilityisinvoked,Network UpdaterlaunchestheUploadAAACertificatedialog:
Thisutilitysupportsthedeletionofeitherexistingcertificatebeforethenewcertificateuploadbegins fromthesamelaunch.However,whenbothcertificatesalreadyexistandneitheroftheseisselected fordeletion,thedevicetypedetermineswhetheranewuploadattemptcansucceed: InaPMP320CPEdevice,thenewcertificateoverwritestheexistingone. InaPMPSM,NetworkUpdaterabortstheuploadprocessandthrowsanerrorthatsignals theoperatorthatitwasabortedduetothelackofanavailablecertificateslot.
Similarly,thedevicetypedetermineswhetheracertificatebecomeseffectiveuponupload: InaPMP320CPEdevice,itdoes. InaPMPSM,itdoesnotuntilthenextrebootoftheSM.Giventhiscondition,theusercan selecttheRebootDevice(SM)toTakeEffectImmediatelyoptiontoputthenew certificateintoeffectassoonastherebootisfinished leavethisoptionunselectedandbeawarethatitwillbecomeeffectiveonlyaftersome otherrebootevent.
92
Issue 1 August 2012
ForinformationaboutAAAauthentication,thetwocertificatepositions,andtheeffectofapplying certificates,seetheuserguideandreleasenotesthatsupportthetargetdevice(s).SeealsoSet SM/CPESecurityonPage45.
UpdateUpload Certificate to Selected Branches

ThisoperationwillactsimilartoUpdateUploadCertificatetoSelectedElementsonPage92,except thatitwillrunagainstallPMPSMsand/orPMP320CPEdevicesbeneathallselectednetwork branches,evenifthedevicesatthoselevelsarenotcurrentlyselected.
5.3.5
Tools Menu
ToolsAdd External Tool to Menu

ThisoperationallowstheusertoassociateanyscriptorprogramwiththeNetworkUpdater.
ThefirstthingausershoulddowhenaddinganewExternalTooltotheNetworkUpdaterisidentify thecoretoolexecutablefile.ThisisdonebypressingthefilechooserbuttonnexttotheCommand Lineinputbox.BasedontheExternalToolfilechosen,theExternaltoolmayautomaticallyfillinall otherrequiredinformationontheAddExternalTooldialogue.IftheExternalTooldoesnot
93
Issue 1 August 2012
automaticallyfillthisinformationin,thentheuserwillneedtosupplytherestoftherequired informationbeforeaddingtheExternalTooltotheNetworkUpdater. EachscriptisgivenaName,andtheusermustinputeitherthepathandfilenameforthescriptthat istobeexecuted,ortheactualexecutablescripttext.Thescriptwillberunoneormoretimes dependingonwhethertheSendNetworkElementInformationboxischecked. TheCommandLineattributecanincludeanyapplicationthatcanbeexecuted(includingshellscripts, Perlscripts,andbatchfiles).Commandlineparameterscanbepassedaswellbyincludingthem withinthecommandline. IftheSelectedNetworkBranchesoptionischecked,thenthescriptwillbecalledonceforevery elementundertheselectednetworkbranches(evenifthesubelementsarenotcurrentlyselected), includingtherootofthebranchifitisanelement,versusaElementGroup. IfSelectedNetworkElementsoptionischecked,thenthescriptwillbecalledonceforeverynetwork elementselected. OnceascriptisassociatedwiththeNetworkUpdaterthroughtheAddExternalToolstoMenu operation,itwillappearintheToolsmenufortheusertoselectandrun.Iftheuserselectsthetool fromtheToolsmenutorun,theywillhavetheoptionofchangingtheparametersettings(sending parameters,operatingonselectedbranches,oroperatingonselectedelements).Anychangesdone atthattimewillonlyapplytothatinstanceofthescriptoperation. ExternalToolscaneithercomefromCambiumNetworksorbecustombuiltbytheoperatortomeet specificneeds.SeeBuildingCustomExternalToolsonPage103fordetailsonbuildingandlinkingin ExternalToolswiththeNetworkUpdater.
ToolsEdit External Tool Menu

ThisoperationcanbeusedtoedittheconfigurationsettingsforanExternalTool,ortodisassociatea toolfromtheNetworkUpdaterandremovesitfromtheToolsmenu.EditingoftheExternalTool configurationworksinasimilarmannertoaddingnewExternalTools.
ToolsLaunch External Tool

ThisoperationallowstheusertorunascriptonetimewithoutassociatingitwiththeNetwork Updaterforfutureuse.Sincethisisaonetimeonlyoperation,theuserdoesnotneedtoassigna nametothescript.Theusermustinputeitherthepathandfilenameforthescriptthatistobe executed,ortheactualexecutablescripttext.
94
Issue 1 August 2012
Theuserindicatesiftheywantparameterspassedtothescriptandiftheywanttooperateon SelectedNetworkBranchesorSelectedNetworkElementsinthesamefashionasToolsAdd ExternalTooltoMenuonPage93. TheExternalToollauncherwillopenadialoguewindowtocapturealloutputfromtheexternaltool.
TheusermaychoosetosavetheExternalToolsstandardoutputmessagesintoafilebyselectingthe SaveTexttoFilebutton.
Included Network Updater External Tools

SeeExternalToolsIncludedonPage31fordetailsonprepackagedExternalToolsthatare automaticallyinstalledwhenNetworkUpdaterisinstalled.
95
Issue 1 August 2012
5.3.6
Help Menu
HelpContents
BringsuptheNetworkUpdaterhelpfiles
HelpToolsToolName
Thisoperationshowstheuseralistofexternalscriptsthatsupporthelp.Thisoptionappearsinthe Helpmenuonlyiftherearetoolsidentifiedthatsupporthelp.
Byselectinganyofthescripttoolsfromthemenudisplayed,anexternalwindowwillappearandthe scriptwillbeinitiatedusingthehelpoptionsspecifiedforthescriptwhenitwasaddedtothetools menu.Whentheuserisdoneviewingthescripthelp,theymayclosethewindowwithinwhichthe scriptwasrun.
HelpAbout
BringsupversionandCopyrightinformationforthecurrentinstallationoftheNetworkUpdatertool.
5.4
5.4.1
User Convenience Actions

Right click to manipulate selected element
Theusermayperformarightmouseclickontheselectednetworkelementtoaccessstandard actionsthatcanbeperformedonthatsingleelement.Theseactionsincludethefollowing: ModifyNetworkElementAccess(seeEditModifyHighlightedNetworkElementAccess onPage71) AddNetworkElement(seeEditAddElementstoHighlightedElementonPage69) RemoveNetworkElement(seeEditRemoveSelectedElementsonPage71) ChangeNetworkElementType(seeEditChangeNetworkElementTypeonPage73)
96
Issue 1 August 2012
MoveNetworkElement(seeEditMoveSelectedNetworkElementsonPage73) OpenNetworkElementWebPage(seeEditOpenHighlightedNetworkElementWebPage onPage73)
5.4.2
Double click to modify element

Iftheuserdoubleclicksonanetworkelement,theModifyNetworkElementAccesswindowopens fortheselectednetworkelement(seeEditModifyHighlightedNetworkElementAccesson Page71).
5.4.3
Select all Elements of a branch

Theusermaycausealltheelementsbelowanelementgrouptobeselected(ordeselected)by checking(orunchecking)theboxtotheleftoftheElementGrouponthetreedisplay.Whenany elementiscurrentlyselected,anasterisk()appearsinthetitlebarabovethecheckboxcolumn. Thiscanbehelpfultoaidusersinknowingthatsomeelementsmaybecurrentlyselectedevenifthey areoffthecurrentvisibleportionofthewindoworinadifferenttreebranch,suchastheDiscovered SMs.
5.4.4
Sorting Network Elements by Column Values

Theusercanchangethesortorderthatnetworkelementsaredisplayedbyclickingonanyofthe columnheadersinthetool,suchasElement,ESN,LastAccess,etc.Clickingonceonacolumnwill causetheelementstobeassortedinascendingorderbasedonthevaluesinthatcolumn.Clickinga secondtimeonthesamecolumnwillcausetheelementstoberesortedindescendingorderbased onthevaluesinthatcolumn. Networkelementswillbesortedwithintheircurrentgroups.Sortingdoesnotcauseelementsto changelevelswithinthetreeortohavetheirparentrelationshipschanged.
5.4.5
Change Order of Columns Displayed

Theusercanchangetheorderofthecolumnsofinformationdisplayedfortheelementsinthetree bydragginganycolumndesiredtotherightorleftofanyotherdesiredcolumn.
5.4.6
Change Display Size of Column Displayed

Theusermaychangethescreensizeallocatedtoanyspecificcolumnbydraggingtherightedgeof thecolumntitletomakethecolumneitherlargerorsmallerasdesired.
97
Issue 1 August 2012
5.4.7
Last Settings on External Tools Remembered

Networkupdaterwillautomaticallyrememberanychangestothecommandlineexecutionor parameterinputsassociatedwithanexternaltoolwhentheuserclicksonthetoolontheToolsmenu andchoosetorunit.Inthisway,userscanessentiallymodifyhowscriptsarerunintheir environmentforboththecurrentsessionandfuturesessions.
5.4.8
Mouse-Over Display of Tree Contents

Theuserwillseeasmallpopuptipsdisplayofacellscontentswhentheusersmouserollsovera columnstitleoranytabledatainthenetworkelementtree.Thiscanbeusefulwhenthecontents beingdisplayedaretoobigtobecompletelyseenwithinthecurrentcolumnwidthsettings.
98
Issue 1 August 2012
6
6.1
Command Line Operations

Introduction
TheCommandLineInterface(CLI)ofNetworkUpdaterenablesexecutingfirmwareupdatetasksfrom thecommandline,usingthesamepackagesastheGUIinterface.TheCLIsupportsdirectlyupdatinga devicebyipaddress.
6.2
Usage
TheCLIisinstalledat.../NetworkUpdater/cli.Thereare2scriptfilesforinvokingthecli: Linux:updatedevice.sh Windows:updatedevice.bat
ThesyntaxoftheCLIcommandlineisasfollows:
updatedevice -ipaddress:IPAddress[:https] -user:user> -password:password -snmpcommunity:snmpcommunity[:SNMPv3 options] -package:packagepath [-autoupdateip:autoupdateip] [-channelbandwidth:current:target] [-forceswitchbandwidth:true/false]
wherethefollowingrulesapply: Parameter
-ipaddress [:https] -user -password -snmpcommunity
Description TargetIPAddressorHostnameofdevicetoupdate. Add:httpsonlyifyouwantHTTPStobeusedinsteadofHTTP. Telnet/FTP,HTTP,orTFTPloginIDofthedevicetoupdate. Telnet/FTP,HTTP,orTFTPpasswordofthedevicetoupdate. SNMPcommunitystringofthedevicetoupdate. Whereadded,usethefollowingsyntax(withnolinebreak):

:v3[:auth_nopriv|auth_priv:MD5|SHA:authpassphrase :DES|AES:privpassphrase]
Default required optional required required required optional required

Auto
[:SNMPv3 options]
-package -autoupdateip
Pathtothepackagefileforupdating. AutoupdateIPAddresstosetforAccessPoints.Ifnull,thisis automaticallydetected.
99
Issue 1 August 2012 Parameter

-channelbandwidth
1
Description ValidcurrentandtargetbandwidthvaluesfortheHPAPare5.0, 10.0,and20.0. Quitstheswitchbandwidthoperationbydefaultifatleastone SMisregisteredintheHPAP.
Default
10.0 false
-forceswitchbandwidth
NOTES:
1.
Forinformationontheproperuseofthisargument,seeHPAPChannelBandwidthTabonPage81. ImproperuseofthisargumentcanresultintheSMsbeingdroppedandunabletoreconnecttotheir HPAP. Theexitcodesare

0:Success 1:ErrorwithArguments 2:Errorduringupdate
Example:
updatedevice.bat -ipaddress:10.40.11.10 -user:root -password:root -snmpcommunity:Canopy -package:D:/Temp/CANOPY120BUILD9_AES.pkg3 -autoupdateip 10.40.0.254
100
Issue 1 August 2012
Output:
java -cp ../jars/CanopyNetworkUpdater.jar;../jars/CanopyUtility.jar;../jars/NetUtility.jar;.. /jars/authparm sgui.jar;../3rdParty/Java/mibble-2.3/mibble-2.3.jar;../3rdParty/Java/mibble2.3/grammatica-1.4.jar;../3rdParty/Java/apache/commons-httpclient-2.0.2/commonshttpclient-2.0.2.jar;../3rdParty/Java/apache/commons-net-1.2.2/commons-net1.2.2.jar;../3rdParty/Java/westhawk/snmp4_13.jar;../3rdParty/Java/snmp4j/SNMP4J.jar; ../3rdParty/Java/snmp4j/log4j-1.2.9.jar;../3rdParty/Java/apache/commons-logging1.0.4/commons-logging.jar com.mot.canopy.CanopySWUpdater.cli.DirectUpdateDevice ipaddress:10.40.11.10 -user:root -password:root -snmpcommunity:Canopy package:D:/Temp/CANOPY822BUILD_AES.pkg3 -autoupdateip 10.40.0.254 12/18/07 09:44:03 INFO SYSTEM Log Level Changed to : INFO 12/18/07 09:44:03 INFO SYSTEM Loading Packaged:/temp/canopy822build_aes.pkg3 12/18/07 09:44:06 INFO SYSTEM Accessing Device- 10.40.11.10 12/18/07 09:44:14 INFO SYSTEM Device Info- MAC: 0A003E23F9BB; TYPE: APAES; CURRENT: CANOPY 8.2.2 (Build 4) 12/18/07 09:44:30 INFO SYSTEM Host: 10.40.11.10;ESN: 0A003E23F9BB;Message: Transferring Files boot.image to AP 12/18/07 09:44:34 INFO SYSTEM Host: 10.40.11.10;ESN: 0A003E23F9BB;Message: Programming ... 12/18/07 09:46:05 INFO SYSTEM Host: 10.40.11.10;ESN: 0A003E23F9BB;Message: Configuring Autoupdate Server (Update Application) Address to 10.40.0.15 12/18/07 09:46:07 INFO SYSTEM Host: 10.40.11.10;ESN: 0A003E23F9BB;Message: Autoupdate Server (Update Application) Address Configured 12/18/07 09:46:12 INFO SYSTEM Host: 10.40.11.10;ESN: 0A003E23F9BB;Message: Waiting for Reboot ... 12/18/07 09:46:41 INFO SYSTEM Host: 10.40.11.10;ESN: 0A003E23F9BB;Message: Verifying ... 12/18/07 09:46:48 INFO SYSTEM Host: 10.40.11.10;ESN: 0A003E23F9BB;Message: Completed Success
101
Issue 1 August 2012
Building Custom External Tools

OperatorscancreatetheirownExternalToolstobeusedwiththeNetworkUpdatertool.The followinginformationprovidesdetailsaboutparameterspassedtoExternalTools,NetworkUpdater configurationinformationavailabletoExternalTools,andhowexternaltoolscanprovideinformation backtotheNetworkUpdaterforautomatedlinkingintotheExternalToolsinterface.
7.1
Parameters Passed to External Tools

AssumingtheSendNetworkElementInformationboxischeckedintheLaunchExternalTooldialog, thefollowinginformationispassedtothescriptforeachnetworkelementencountered(depending onifSelectedNetworkBranchesorSelectedNetworkElementoptionisspecified).Theseparameters arepassedasasemicolondelimitedlistintheordershownhere.
Host Address
ThisistheelementIPaddressorhostnameinthecaseofalocalhostsfileorDNSlookup.
ESN (Element Serial Number)

Thisisthevalueenteredbytheuserforundiscoveredelements,sothereforeeitherhostnameorIP address. ForautodiscoveredSMs,thisisastringidentifyingtheAPthattheSMisattachedto,andtheLUID theSMiscurrentlyaccessedthroughontheAP.Thisstringwillhavetheformatof:
AP:[Host_Name_or_IP].LUID:[#]
WhereHost_Name_or_IPisthehostnameorIPaddressasspecifiedbytheuserwhentheyentered theAPinformationintoNetworkUpdater,and#istheLUIDnumberassignedtotheSMbytheAP. Thisparametercannotbeblank.
MAC Address
Thisisthe12digithexadecimalstringrepresentingtheMACaddressofthenetworkelement.Thisis passedwithoutanyhyphens.Thisparametercanbeblank.
103
Issue 1 August 2012
Element Type
Thisisacharacterstringrepresentingthetypeofnetworkelementbeingidentified.Validvalues include: Element Type 10MbpsBackhaul 20MbpsBackhaul 30Mbpsor60MbpsHighSpeedBackhaul 150Mbpsor300MbpsHighSpeedBackhaul AccessPoint AccessPointwithAuthenticationSecurityenabled SubscriberModule ClusterManagementModulemicro ClusterManagementModule4 Thisparametercannotbeblank.
BH BH20 HSBH 30/60 HSBH 150/300 AP APAS SM CMM CMM4
String
Encryption Type
Thisisacharacterstringrepresentingthetypeofencryptionbeingusedbythenetworkelement. Validvaluesinclude: Encryption Type DESencryptioniscurrentlyenabled AESencryptioniscurrentlyenabled String
DES AES
Indicatesencryptionispossible,butcurrentlydisabled None UsedforCMMs

null
SNMP Community String

TheSNMPcommunitystringforthespecificelement.Thisvaluecanbeblank,indicatingthe communitystringisnotknownand/ornotspecified.
Device Login ID/Password

Theread/writeaccountparametersforthespecifiedelement.Theseparameterscanbeblank, meaningthereiseithernopasswordorthepasswordisnotknown.Thispasswordshouldbetheone associatedwiththerootaccount.
104
Issue 1 August 2012
Software Version String

Stringwiththesoftwareversioncurrentlyloadedontheelement.Thisparametercanbeblank, indicatingthesoftwareversionisnotknown.
Software Boot String

StringwiththeSoftwareBootversioncurrentlyloadedontheelement.Thisparametercanbeblank, indicatingthesoftwarebootversionisnotknown,ordoesnotapply(asinthecaseofCMMs).
FPGA Version String

StringwiththeFPGAversioncurrentlyloadedontheelement.Thisparametercanbeblank, indicatingtheFPGAversionisnotknown,ordoesnotapply(asinthecaseofCMMs).
Site Name
ThisisthetextstringfromthenetworkelementsSiteNamefield.Thisispassedasaquotedstring.
Site Contact
ThisisthetextstringfromthenetworkelementsSiteContactfield.Thisispassedasaquotedstring
Site Location
ThisisthetextstringfromthenetworkelementsSiteLocationfield.Thisispassedasaquotedstring
Detected Parent
ThisisthecontentoftheDetectedParentcolumnfortheelement.Thiswillbeblankforallelements exceptautodiscoveredSMs.
Detected Parent Password

ThisisthepasswordfortheDetectedParent.ThisispassedincasetheExternalToolneedstoaccess theelementthroughitsparent(proxy),andthereforeneedsparentaccess. Theparametersarepassedintheaboveorder,separatedbyasemicolon.Thefollowingareexample fullstringsofinputparameterstoascript:
169.254.1.4;0A003E000CEA;BH;DES;Canopy;secure;CANOPY4.1.3 Jan 22 2004 10:38:11;CANOPYBOOT 2.3;06240307;Main BH;John Smith,Schaumburg,; 169.254.1.10;0A003EE00026;CMM;;Canopy;secure;CANOPY CMM 2.0.10 Mar 18 2004 15:36:49;;5;Main Cluster;Administrator;Main POP;; AP:[169.254.1.1].LUID:[2];0A003E000B31;SM;DES;Canopy;secure;CANOPY4.1.3 Jan 22 2004 10:38:11;CANOPYBOOT 2.3;06240307;123 Main Street;Jane Customer;Schaumburg;AP:[169.254.1.1].LUID:[2];secure
105
Issue 1 August 2012
7.2
External Tool Help

Optionally,thescriptmayalsosupportahelpcapability.Ifthescriptsupportsthisoption,theuser shouldindicatethisbycheckingtheSupportsHelpcheckboxontheAddExternalTooltoMenu window,andthecallingsequencetoinitiatethehelpforthescriptmustbesupplied(includingthe scriptnameandanyparametersrequired).Thehelpscriptshouldperformnoactualoperationsother thandisplayingthehelpinformation.Usingthistechnique,itispossibleforthescripthelptobe accessedeitherbyaparameteroptionintothecorescript,orbyaccessingaseparatescriptorhelp toolthatcanprovideinformationforthescript.SeeHelpToolsToolNameonPage96for informationontheuseraccessingthehelpcapabilitiesofaspecificexternaltool.
7.3
External Tool Extended Attributes

ItisalsopossibletohavetheExternalToolitselfprovidetheinformationaboutitsappropriatename, commandsforlaunchingthetool,commandsforaccessingitshelp,andidentifyingifitworkswith branchesofelementsorelementsdirectly.ThisissupportedforbothJavabased(filesendingwith .jar)andPerlbased(filesendingwith.pl)ExternalTools.Forjavabasedexternaltoolsthisisdone throughtheExtendedManifestAttributesintheJARfile.ForPerltools,lineswithinthePerlscript itselfbeginningwith#@areusedtoidentifytheseextendedattributesvalues.Iftheseextended attributesareprovidedbytheexternaltool,theNetworkUpdaterwillautomaticallyextractthese fromtheExternalToolandloadthemintotheAddExternalTooldialogueboxwhentheExternalTool mainfileisselected.Thefollowingarethedetailsontheseextendedattributes.
7.3.1
Java Extended Manifest Attributes

Tool-Name
Thisvaluewillautomaticallybeloadedintothenameofthetoolfield
Main-Class
Istheclassfilenametostartthetoolandparametertobepassedtothetool
Help-Class
Istheclassfilenameandparameterstobepassedtothetooltolaunchhelp
Send-Elements-Info
ShouldbeBranchestosendelementinfoonselectedbranches,orElementstosend elementinfoonlyonselectedelements.
note ............. do not include quotes for branches and element values.
ExamplefromtheConfigureAdvantagePlatformSchedulerexternaltoolincludedwithNetwork Updater(seeConfigureAdvantagePlatformScheduleronPage33): Manifest-Version: 1.0 Tool-Name: Advantage Platform Scheduler Configuration Main-Class: src.MainFrame Send-Element-Info: Elements Help-Class: src.MainFrame -help TheResultingCommandLinefromtheaboveMainClassattributewillbe
java -cp jarfile.jar src.MainFrame
106
Issue 1 August 2012
TheResultingHelpCommandfromtheaboveHelpClasslinewillbe java -cp jarfile.jar src.MainFrame -help TheExternalToolwillbydefaultsendnetworkelementInformationforselectedelements.
107
Issue 1 August 2012
Acronyms and Abbreviations

AES AP APAS BAM BH CMM AdvancedEncryptionStandard:Encryptionusedbysomeradios;usesa128bit encryptionkey. AccessPoint:Infrastructureradioforapointtomultipointsystem. AccessPointwithAuthenticationServices:AnAPthatislicensedandenabledto communicatewithaBAMserver. BandwidthandAuthenticationManager:Serversoftwareusedtomanagenetwork elementaccessandbandwidthallocationsinanetwork. Backhaul:PointtoPointradios. ClusterManagementModule:Centralizedpower,synch,switchingfor infrastructuredeployment.CMMacronymalonemaymeanallclassesofCMMs,or itmayrefertotheCMMmicrospecifically.CMM4isusedtorefertoonlythe CMM4unit. NetworkUpdaterTool. CustomerPremiseEquipment:Equipmentdeployedatcustomerlocation. DataEncryptionStandard:Encryptionusedbystandardradios;usesa56bit encryptionkey. ElementSerialNumber:Uniqueidentifiertoaccessanetworkelement.Cantake theformofanIPaddress,MACaddress,orLUIDandAPcombination. FieldProgrammableGateArray:ProgrammablehardwareportionofModule. GraphicalUserInterface. HighspeedBackhaul:OFDMbasedPointtoPointradios. InternetProtocol:AddressingandroutingschemeusedontheInternet. LogicalUnitID:UsedbyAPtoreferenceregisteredSMs. MediaAccessControl:Unique12digithexadecimalvalueassignedtoa networkabledevicebythemanufacturer. MultiDwellingUnit(apartments,condos,etc). OperatingSystem. OutdoorSubscriberUnitSMportionofthe3.5GHzbasedOFDMpointto multipointproduct. PointofPresence. SubscriberModule:CPEmoduleforapointtomultipointsystem. SimpleNetworkManagementProtocol.
CNUT CPE DES ESN FPGA GUI HSBH IP LUID MAC MDU OS OSU POP SM SNMP
109
Issue 1 August 2012 TFTP UDP ULAP
TrivialFileTransferProtocol:ProtocolusedbySMspullingupgradefilesfora networkfileserver. UserDatagramProtocol:Amessagingprotocolusedforsomecommandtraffic withinanetwork. UltraLightAccessPointAPportionofthe3.5GHzbasedOFDMpointto multipointproduct.
110
Issue 1 August 2012
Legal Notices and License Agreement

CAMBIUM NETWORKS, LTD END USER LICENSE AGREEMENT
CAMBIUMNETWORKS,LTD(Cambium)iswillingtolicenseitsCNUTNetworkUpdaterToolsoftwareandthe accompanyingdocumentation(collectively,theSoftware,asfurtherdefinedbelow)toyouonlyonthecondition thatyouacceptallthetermsinthisEndUserLicenseAgreement(thisAgreement). IMPORTANT:READTHEFOLLOWINGTERMSANDCONDITIONSBEFOREUSINGTHESOFTWAREANDANY EQUIPMENTAND/ORPRODUCTSTHATACCOMPANYTHESOFTWARE. BYCLICKINGONTHEACCEPTBUTTONDURINGINSTALLATION,YOUACKNOWLEDGETHATYOUHAVEREAD THISAGREEMENT,UNDERSTANDITANDAGREETOBEBOUNDBYTHETERMSOFTHISAGREEMENT. IFYOUDONOTAGREETOTHETERMSOFTHISAGREEMENT,CAMBIUMISNOTWILLINGTOLICENSETHE SOFTWARETOYOUANDYOUSHOULDCLICKONTHEDONOTACCEPTBUTTONTODISCONTINUETHE INSTALLATIONPROCESS.IFYOUDONOTAGREETOTHESETERMSANDCONDITIONS,YOUMAY,FORAFULL REFUND:(I)RETURNTHESOFTWARETOTHEENTITYFROMWHOMYOUPURCHASEDIT;OR,(II)FOR DOWNLOADEDSOFTWARE,PROVIDETOTHEENTITYFROMWHOMYOUPURCHASEDTHESOFTWAREYOUR WRITTENVERIFICATIONOFDELETIONOFALLCOPIESOFTHESOFTWARE. 1.Definitions.InthisAgreement,thewordSoftwarereferstothesetofinstructionsforcomputingdevices,in executableformandinanymedia(whichmayincludediskette(s),CDROM(s),downloadableInternetfile(s), hardware,firmware,etc.),andincludeswithoutlimitationinterfaces,content,fonts,images,photographs, animations,video,audio,musictext,appletsandincludeddata,aswellastheaccompanyingdocumentation, suchasmanualsandinstructionalaids,whetherinprintedorelectronicform,forthesoftwareproductidentified above. 2.General.TheSoftwareislicensed,andnotsold,toyoubyCambiumforuseonlyunderthetermsofthis Agreement.Cambiumand/orCambiumslicensor(s)retainallright,titleandinterestinandtotheSoftware,and thecopyrightsandotherintellectualpropertyrightsthereinandthereto,andreserveallrightsnotexpressly grantedtoyouinthisAgreement.ThetermsofthisAgreementwillgovernanyupdate(s)and/orupgrade(s)tothe SoftwareprovidedbyCambiumthatreplaceand/orsupplementtheoriginalSoftware,unlesssuchupdate(s) and/orupgrade(s)areaccompaniedbyaseparatelicenseinwhichcasethetermsofthatlicensewillgovern. 3.GrantofLicense.Cambiumgrantsyou(Licenseeoryou)alimited,personal,nonexclusiveandnon transferable(exceptasotherwiseprovidedherein)licensetousetheSoftwaresubjecttotheConditionsofUseset forthinSection4andtheremainingtermsandconditionsofthisAgreement.Anytermsorconditionsappearingon thefaceorreversesideofanypurchaseorder,purchaseorderacknowledgmentorotherorderdocumentthatare differentfrom,orinadditionto,thetermsofthisAgreementwillnotbebindingontheparties,evenifpaymentis accepted. 4.ConditionsofUse;RestrictionsonUse.TheSoftwareisprotectedbyinternationalintellectualpropertylawsand treaties,andotherapplicablelaws.AnyuseoftheSoftwareinviolationofthetermsandconditionssetforthin thisAgreementisstrictlyprohibitedandwillbedeemedabreachofthisAgreement.Inadditiontotheotherterms andconditionsofthisAgreement,youagreetothefollowingspecificconditionsandrestrictions: 4.1.YouwillusetheSoftwareincompliancewithallapplicablelaws,includinglocallawsofthecountryor regioninwhichyouresideorinwhichyouusetheSoftware. 4.2.Onlyyou,youremployeesoragentsmayusetheSoftware.Youwilltakeallnecessarystepstoinsurethat youremployeesandagentsabidebythetermsofthisAgreement. 4.3.YouwillusetheSoftware:(i)onlyforyourinternalbusinesspurposes;(ii)onlyasdescribedinthe Software;and,(iii)instrictaccordancewiththisAgreement. 111
Issue 1 August 2012 4.4.YouwillinstallandusetheSoftwareonasinglecomputingdevice.
4.5.TotheextenttheSoftwareincludesfeaturesinvolvingmaps,youwilltakeallreasonableeffortsnot exceed20,000mappageviewsperyear.Cambiumreservestherighttodisabletheusageoffeatures involvingmapsifyourannualusageofmappageviewsexceeds20,000mappageviews. 4.6.Youwillnot,andyouwillnotenableothersto,copy(exceptforbackuppurposesasexpresslypermitted bythisAgreement),decompile,bootleg,reverseengineer,disassemble,attempttoderivethesourcecodeof, decrypt,modify,translate,orcreatederivativeworksfromtheSoftware,oranypartthereof(exceptas,and onlytotheextent,anyforegoingrestrictionisprohibitedbyapplicablelaw).Anyattempttodosoisa violationoftherightsofCambiumand/oritslicensor(s)intheSoftware. 4.7.YouwillnotattempttodefeatanycopyprotectiondeviceincludedwiththeSoftware. 4.8.IftheSoftwareisprovidedonmultipletypesofmedia,youwilluseonlythemediathatbestmeetsyour specificneeds,andyouwillnotloan,rent,leaseortransfertheothermediacontainedinthepackagewithout Cambiumswrittenconsent. 4.9.Youwillnotremoveanyproprietarynotices,marks,labels,orlogosfromtheSoftware. 4.10.Unlessotherwiseprovidedherein,youwillnotrent,lease,sublicenseortransfertheSoftware,orany partthereof,toanyotherpartywithoutCambiumspriorwrittenconsent. 4.11.YouwillnotusetheSoftwareonanyvirtualcomputingdevice. 4.12.YouwillnotusetheSoftwareforanypurposesprohibitedbyapplicablelaw,includingwithout limitationthedevelopment,design,manufactureorproductionofnuclear,missiles,orchemicalorbiological weapons. USEOFTHESOFTWAREINANYMANNEROTHERTHANASPROVIDEDHEREINISSTRICTLYPROHIBITEDAND MAYINFRINGEONTHEINTELLECTUALPROPERTYRIGHTSOFCAMBIUMAND/ORITSLICENSOR(S), SUBJECTINGYOUTOCIVILANDCRIMINALPENALTIES,INCLUDINGWITHOUTLIMITATIONMONETARY DAMAGESANDIMPRISONMENTFORCOPYRIGHTINFRINGEMENT. 5.BackUps.NotwithstandinganythingtothecontraryinthisAgreement,youmaymakeone(1)copyofthe Softwareinmachinereadableformforbackuppurposesonly.IfthedocumentationfortheSoftwareisinprinted form,itmaynotbecopied.WithregardtoallcopiesoftheSoftwarepermittedherein,youagreetoreproduceon suchcopiesallCambiumcopyrightnotices,andotherproprietarynoticesappearingonandintheoriginal Software. 6.Export.Youmaynotexport,reexportortransfer,directlyorindirectly,theSoftwareexceptasauthorizedby UnitedStateslaworbythelawsofthejurisdiction(s)inwhichtheSoftwarewasobtained.Bywayofexample,but withoutlimitationoftheforegoing,ifyourSoftwarewasobtainedintheUnitedStates,theSoftwaremaynotbe exported,reexportedortransferred:(a)intoanyU.S.embargoedcountries;or,(b)toanyoneontheU.S.Treasury Department'slistofSpeciallyDesignatedNationalsortheU.S.DepartmentofCommerceDeniedPersonsListor EntityList.ByusingtheSoftware,yourepresentandwarrantthatyouarenotlocatedinanysuchcountryoron anysuchlist. 7.Confidentiality.YouacknowledgethattheSoftwarecontainsvaluableproprietaryinformationandtradesecrets andthatunauthorizedorimproperuseoftheSoftwarewillresultinirreparableharmtoCambiumforwhich monetarydamageswouldbeinadequateandforwhichCambiumwillbeentitledtoimmediateinjunctiverelief. Accordingly,youwilllimitaccesstotheSoftwaretothoseofyouremployeesandagentswhoneedtousethe Softwareforyourinternalbusinesspurposes,andyouwilltakeappropriateactionwiththoseemployeesand agentstopreservetheconfidentialityoftheSoftware,usingthesamedegreeofcaretoavoidunauthorizedor improperdisclosureasyouusefortheprotectionofyourownproprietarysoftware,butinnoeventlessthan reasonablecare.Youhavenoobligationtopreservetheconfidentialityofanyinformationthat:(i)wasinthe publicdomainatthetimeofdisclosure;(ii)enteredthepublicdomainthroughnofaultofyours;(iii)wasgivento youfreeofanyobligationtokeepitconfidential;(iv)isindependentlydevelopedbyyou;or,(v)isdisclosedas requiredbylawprovidedthatyounotifyCambiumpriortosuchdisclosureandprovideCambiumwitha reasonableopportunitytorespond.
112
Issue 1 August 2012
8.RighttoUseCambiumsName.ExceptasrequiredinSection5above,youwillnot,duringthetermofthis Agreementorthereafter,useanytrademarkofCambium,oranywordand/orsymbollikelytobeconfusedwith anyCambiumtrademark,eitheraloneorinanycombinationwithotherwordsand/orsymbols. 9.Transfer.InthecaseofSoftwaredesignedtooperateonCambiumequipment,youmaynottransferthe Softwaretoanotherpartyexcept:(i)ifyouareanenduser,whenyouaretransferringtheSoftwaretogetherwith theCambiumequipmentonwhichitoperates;or,(ii)ifyouareaCambiumauthorizeddistributor,whenyouare transferringtheSoftwareeithertogetherwithsuchCambiumequipmentoraretransferringtheSoftwareasa licenseddulypaidforupgrade,update,patch,newrelease,enhancementorreplacementofapriorversionofthe Software.IfyouareaCambiumauthorizeddistributor,whenyouaretransferringtheSoftwareaspermittedinthis Agreement,youagreetotransfertheSoftwarewithalicenseagreementhavingtermsandconditionsnoless restrictivethanthosecontainedinthisAgreement.AlltransfersoftheSoftwareunderthisSection9arestrictly subjecttotheconditionsprecedentthat:(iii)theotherpartyagreestoacceptthetermsandconditionsofthis Agreement;and,(ii)youdestroyanycopyoftheSoftwareyoudonottransfertothatparty.Unlessotherwise providedherein,theSoftwaremaynotbetransferred,andthisAgreementmaynotbeassigned,byyouwithout Cambiumspriorwrittenconsent. 10.UpgradesandUpdates.IftheSoftwareislicensedtoyouasanupgradeorupdatetosoftwarepreviously licensedtoyou,youmustdestroythesoftwarepreviouslylicensedtoyou,includinganycopies,within30daysof yourreceiptoftheSoftware. 11.MaintenanceandSupport.CambiumisnotresponsibleformaintenanceorsupportoftheSoftware,orthe equipmentonwhichtheSoftwareresidesorisused,underthisAgreement.Byacceptingthelicensegrantedunder thisAgreement,youagreethatCambiumwillbeundernoobligationtoprovideanysupport,maintenanceor serviceinconnectionwiththeSoftwareorsuchequipment.MaintenanceandsupportoftheSoftwareand/orsuch equipmentbyCambiummaybeavailableunderthetermsofaseparateagreement. 12.LimitedWarranty.Allphysicalmedia,suchasdiskettesorCDROMS,onwhichtheSoftwareisfurnishedby Cambium(theMedia)arewarrantedtobefreefrommanufacturingandmaterialdefectsforninety(90)days aftertheshipmentdateoftheMediatoyou.Mediathatbecomesdefectiveduringsuchperiodwillberepairedor, atCambiumsoption,replaced.ThislimitedwarrantyiscontingentuponproperuseoftheMediaanddoesnot coverMediathathasbeentamperedwith,modifiedorsubjectedtounusualphysicalorelectricalstress. TamperingwithorremovinganyfactorysealorlabelonanyMediavoidsthiswarrantyandreleasesCambium fromanyandallliability.TheentireliabilityofCambium,andyourexclusiveremedyunderthewarrantyprovided inthisSection12willbe,atCambiumsoption,torepairorreplaceanyMediafoundtobedefectivewithinthe warrantyperiod,ortorefundthepurchasepriceandterminatethisAgreement.Toseeksucharemedy,youmust returntheSoftwaretoCambium,withacopyoftheoriginalpurchasereceipt,withinthewarrantyperiod. 13.Disclaimer.EXCEPTFORTHEABOVEEXPRESSLIMITEDWARRANTYFORTHEMEDIA,ANDTOTHEMAXIMUM EXTENTPERMITTEDBYAPPLICABLELAW,THESOFTWAREISPROVIDED"ASIS"ANDASAVAILABLE,WITHOUT WARRANTYOFANYKIND,ANDCAMBIUMONBEHALFOFITSELFANDITSLICENSOR(S)HEREBYDISCLAIMSALL WARRANTIESANDCONDITIONSWITHRESPECTTOTHESOFTWARE,EXPRESS,IMPLIEDORSTATUTORY,INCLUDING WITHOUTLIMITATIONTHEIMPLIEDWARRANTIESAND/ORCONDITIONSOFMERCHANTABILITY,OFSATISFACTORY QUALITY,OFFITNESSFORAPARTICULARPURPOSE,OFACCURACY,OFQUIETENJOYMENT,ANDOFNON INFRINGEMENTOFTHIRDPARTYRIGHTS.CAMBIUMALSODOESNOTWARRANTTHATTHEFUNCTIONS CONTAINEDIN,PERFORMEDAND/ORPROVIDEDBYTHESOFTWAREWILLMEETYOURREQUIREMENTS,THATTHE OPERATIONOFTHESOFTWAREWILLBEUNINTERRUPTEDORERRORFREE,THATTHESOFTWAREWILLBE COMPATIBLEORWORKWITHANYTHIRDPARTYSOFTWARE,APPLICATIONSORDEVICES,ORTHATDEFECTSINTHE SOFTWAREWILLBECORRECTED.CAMBIUMMAKESNOWARRANTYWITHRESPECTTOTHECORRECTNESS, ACCURACY,ORRELIABILITYOFTHESOFTWARE,ANDYOUEXPRESSLYACKNOWLEDGEANDAGREETHAT,TOTHE EXTENTPERMITTEDBYAPPLICABLELAW,YOURUSEOFTHESOFTWAREISATYOURSOLERISKANDTHATTHE ENTIRERISKASTOSATISFACTORYQUALITY,PERFORMANCE,ACCURACYANDEFFORTISWITHYOU.YOUFURTHER ACKNOWLEDGEANDAGREETHATTHESOFTWAREISNOTINTENDEDORSUITABLEFORUSEINSITUATIONSOR ENVIRONMENTSWHERETHEFAILUREORTIMEDELAYSOF,ORERRORSORINACCURACIESINTHECONTENT,DATA ORINFORMATIONPROVIDEDBYTHESOFTWARECOULDLEADTODEATH,PERSONALINJURY,ORSEVEREPHYSICAL
113
Issue 1 August 2012
ORENVIRONMENTALDAMAGE.NOORALORWRITTENINFORMATIONORADVICEGIVENBYCAMBIUMORAN AUTHORIZEDCAMBIUMREPRESENTATIVESHALLCREATEAWARRANTY. SOMEJURISDICTIONSDONOTALLOWTHEEXCLUSIONOFIMPLIEDWARRANTIESORLIMITATIONSONAPPLICABLE STATUTORYRIGHTSOFACONSUMER,SOTHEABOVEEXCLUSIONANDLIMITATIONSMAYNOTAPPLYTOYOU. 14.LimitationofLiability.THETOTALLIABILITYOFCAMBIUMFORANYDAMAGESUNDERTHISAGREEMENTWILL NOTEXCEEDTHETOTALAMOUNTPAIDBYYOUFORTHESOFTWARELICENSEDUNDERTHISAGREEMENT.TOTHE EXTENTNOTPROHIBITEDBYAPPLICABLELAW,INNOEVENTSHALLCAMBIUMBELIABLEFORPERSONALINJURY, ORANYINCIDENTAL,SPECIAL,INDIRECTORCONSEQUENTIALDAMAGESWHATSOEVER,INCLUDINGWITHOUT LIMITATIONDAMAGESFORLOSSOFPROFITS,LOSSOFDATA,BUSINESSINTERRUPTIONORANYOTHER COMMERCIALDAMAGESORLOSSES,ARISINGOUTOFORRELATEDTOYOURUSEORINABILITYTOUSETHE SOFTWARE,ORANYTHIRDPARTYSOFTWARE,APPLICATIONSAND/ORDEVICESINCONJUNCTIONWITHTHE SOFTWARE,HOWEVERCAUSED,REGARDLESSOFTHETHEORYOFLIABILITY(CONTRACT,TORTOROTHERWISE) ANDEVENIFCAMBIUMHASBEENADVISEDOFTHEPOSSIBILITYOFSUCHDAMAGES.SOMEJURISDICTIONSDO NOTALLOWTHELIMITATIONOFLIABILITYFORPERSONALINJURY,OROFINCIDENTALORCONSEQUENTIAL DAMAGES,SOTHISLIMITATIONMAYNOTAPPLYTOYOU. 15.U.S.GovernmentEndUsers.TheSoftwareisaCommercialItem,asthattermisdefinedat48C.F.R.2.101, consistingofCommercialComputerSoftwareandCommercialComputerSoftwareDocumentation,assuch termsareusedin48C.F.R.12.212or48C.F.R.227.7202,asapplicable.Consistentwith48C.F.R.12.212or48 C.F.R.227.72021through227.72024,asapplicable,theCommercialComputerSoftwareandCommercial ComputerSoftwareDocumentationarebeinglicensedtoU.S.Governmentendusers:(i)onlyasCommercial Items;and,(ii)withonlythoserightsasaregrantedtoallotherenduserspursuanttothetermsandconditions herein,notwithstandinganyotherFARorothercontractualclausetothecontraryinanyagreementintowhichthis AgreementmaybeincorporatedorwhichCambiummayprovidetoGovernmentenduser.UseoftheSoftware constitutesagreementbytheU.S.GovernmentthattheSoftwareisCommercialComputerSoftwareand CommercialComputerSoftwareDocumentation,andconstitutesacceptanceoftherightsandrestrictionsherein. UnpublishedrightsAREreservedunderthecopyrightlawsoftheUnitedStates.Thenameandaddressofthe contractorforUnitedStatesGovernmentendusersis:CambiumNetworks,Ltd,acompanyregisteredinEngland andWalesundercompanynumber07752773,withanaddressat1299E.AlgonquinRoad,Schaumburg,IL60196. 16.TermandTermination.ThisAgreement,andyourrighttousetheSoftware,willbeginwhenyouclickthe ACCEPTbutton,whichconstitutesacceptanceofthetermsandconditionsinthisAgreement,andwillcontinuein perpetuityunlessterminatedasfollows.ThisAgreementwillterminateimmediatelyandautomaticallywithout noticeuponabreachofthisAgreementbyyou.Youmayalsoterminatethisagreementbyceasinguseofthe Software.UpontheterminationofthisAgreementforanyreason,youmustceasealluseoftheSoftwareand destroyallcopiesoftheSoftwareinyourpossessionorcontrol. 17.GoverningLawandSeverability.ThisAgreementisgovernedbythelawsoftheUnitedStatesofAmerica,to theextentthattheyapply,andotherwisebythelawsoftheStateofIllinois,excludingitsconflictsoflaws principles.ThisAgreementshallnotbegovernedbytheUnitedNationsConventiononContractsforthe InternationalSaleofGoods,theapplicationofwhichisexpresslyexcluded.Ifforanyreasonacourtofcompetent jurisdictionfindsanyprovisionofthisAgreement,orportionthereof,tobeunenforceable,theremainderofthis Agreementshallcontinueinfullforceandeffect. 18.Survival.Thepartiesagreethatwherethecontextofanyprovisionindicatesanintentthatitsurvivestheterm ofthisAgreement,thenitwillsurvive. 19.EntireAgreement.ThisAgreementconstitutestheentireagreementbetweenyouandCambiumrelatingto theSoftwarelicensedhereunderandsupersedesallpriororcontemporaneousunderstandingsregardingsuch subjectmatter.NoamendmenttoormodificationofthisAgreementwillbebindingunlessinwritingandsignedby Cambium,exceptthatCambiummaymodifyand/ortranslatethisAgreementasnecessarytocomplywith applicablelaws.IntheeventofadisputebetweentheEnglishversionandanynonEnglishversions,theEnglish versionofthisAgreementshallgovern,totheextentnotprohibitedbythelocallawinyourjurisdiction.
114
Issue 1 August 2012
20.ThirdPartySoftware.TheSoftwaremaycontainoneormoreitemsofthirdpartysoftwaresuppliedbythird partysuppliers(collectively,ThirdPartySoftware).ThetermsofthisAgreementgovernyouruseofanyThird PartySoftwareUNLESSASEPARATETHIRDPARTYSOFTWARELICENSEISINCLUDED,INWHICHCASEYOURUSEOF THETHIRDPARTYSOFTWAREWILLTHENBEGOVERNEDBYTHESEPARATETHIRDPARTYLICENSE.Byusingthe SoftwareyouareagreeingbeboundbythetermsofuseforallThirdPartySoftware. IFTHEFOREGOINGTERMSANDCONDITIONSAREACCEPTABLETOYOU,PLEASEINDICATEYOURAGREEMENT ANDACCEPTANCEBYCLICKINGONTHEBUTTONLABELEDACCEPT.IFTHEFOREGOINGTERMSAND CONDITIONSARENOTACCEPTABLETOYOU,PLEASECLICKONTHEDONOTACCEPTBUTTON. CNUT,CAMBIUM,CAMBIUMNETWORKSandtheCambiumNetworksLogoaretrademarksofCambium Networks,Ltd. Copyright2012CambiumNetworks,LtdAllrightsreserved.
115
Issue 1 August 2012
Troubleshooting
Autoupdate source address is not set on APs
AllAccessPointshaveaparameterontheirwebpagesforsettingtheAutoupdateApplication Address.Ifthisparameterisnotset,NetworkUpdaterwillbeunabletoconfiguretheAccessPointfor performingSMAutoupdate. Bydefault,NetworkUpdaterwillsetthisvaluewhenitupdatesanAccessPoint. AnExternalToolisalsoprovidedforperformingthisoperation.Oncethisoperationis completed,itisnecessarytoreboottheAP.AnExternalToolforrebootingradiosremotelyis alsoprovided.SeeIncludedNetworkUpdaterExternalToolsonPage95formoredetailson thesetools.
An error is thrown when I try to enable SM Autoupdate on an AP

TherearefourreasonsanSMAutoupdateenablecommandmightfail,resultinginanerrormessage onaspecificAP: TheAPbeingenabledisnotcurrentlyonthenetwork(turnedoff) TheAPbeingenabledcannotbeaccessedbytheNetworkUpdatercomputer.Inthis situationyoumayhaveanetworkconfigurationissue.SeeNetworkCommunicationson Page30formoreinformationonrequiredcommunicationprotocolsandports. TheAPbeingenableddoesnothaveitsAutoupdateIPaddresssettotheIPaddressofthe NetworkUpdaterserver.SeeAutoupdatesourceaddressisnotsetonAPsonPage117for informationonaddressingthisproblem. TheAPbeingenableddoesnotsupportSMAutoupdate.ThisisthecaseinPMP320sectors.
Update of network elements works, but SM Autoupdate never activates on APs

NetworkUpdatermakesuseofanUDPcommandtoenableSMAutoupdateontheAPsinthe network.ItisnecessarytoensurethattheappropriateportisopenbetweentheNetworkUpdater computerandtheNetworkElementstoallowtheudpcommandtobepassedtothenetwork elements.SeeNetworkCommunicationsonPage30formoreinformationonrequired communicationprotocolsandports.
Network Updater server IP address changed, and SM Autoupdate no longer works

TheNetworkUpdatertoolwillautomaticallyconfiguretheAPwiththecorrectAutoupdateSource AddresstoensurethatitcanenableanddisableSMAutoupdateontheAPasneeded.This configurationoftheAPisgenerallydoneatthetimewhentheAPisitselfupgraded.Bysettingthis valueinconjunctionwithupgradingtheAP,theNetworkUpdaterpreventshavingtoreboottheAP anextratimejusttosettheAutoupdateSourceAddress. IftheIPaddressoftheNetworkUpdatercomputerchangesaftertheAPshavebeenupgraded,and theuserattemptstodirectlyenableSMAutoupdateonsomeoftheAPsontheirnetwork,itislikely thattheoperationwillfail.ThisisbecausetheAPsstillhavetheoldIPaddressfortheNetwork UpdatercomputerintheirAutoupdateSourceAddress.Tofixthisissuetheusercanusethe ToolsSetAutoupdateAddressonAPtheexternaltoolincludedwiththeNetworkUpdater(seeSet
117
Issue 1 August 2012
AutoupdateAddressonAPsonPage42).AlsoseeAutoupdatesourceaddressisnotsetonAPson Page117foradditionalinformationonthisissue.
SM Autoupdate with external TFTP server is not working

EnsureSMcanpingtheTFTPserver(Routingissue) ChecktheTFTPRootFolder(EnsurePackagesarethere) UsetheTestTFTPServerbutton. CheckforaFirewallsoftware(TFTPPortmaybeprotectedontheserver.Besuretwoway communicationisenabled).SeeNetworkCommunicationsonPage30formoreinformation onrequiredcommunicationprotocolsandports.
AP telnet Interface shows Autoupdate disabled after Network Updater enables it

TheusershouldbeawarethatsinceNetworkUpdaterusestheUDPcommandmethodforenabling anddisablingofSMAutoupdateonAPs,theusermaynotgetanaccuratestatusresponsefromthe APiftheyareusingtheTelnetinterfaceonanAPtoinquireonthestatusofAutoupdateontheAP. ThisisbecausetheTelnetinterfacewillonlyreportonthestatusofAutoupdatebasedonprevious TelnetcommandswithouttakingintoaccountiftheAPreceivedaseparateUDPcommandfor Autoupdate.SeeSMAutoupdateFeatureonPage13formoredetailsonhowNetworkUpdater makesuseoftheSMAutoupdatecapabilitiesontheAP.
Network Updater tries to update an already updated SM when using SM Autoupdate

Itisaknownissuethatsomeradiosmayattempttoperformanupgradeeveniftheyarealreadyup todateontheirsoftwareandFPGAreleases.ThisissueaffectsnewerSMsonly.NewerSMsarethose thatshowtheHW/SWscheduleroptiondirectlyontheconfigurationpage(donotrequireaseparate FPGAtobeloadedtoinitiateHWscheduleroperation).Thisissueisaresultoftheneedforseparate FPGAreleasesbeingdistributedbytheSMAutoupdatecommandtosupporttheolderradiosona network.NewerradiosnolongeruseaseparateFGPAfile,butthereferencetotheOlderFGPAfile causesthenewerradiotoincorrectlybelieveitneedstoperformanupdate.Thismaycauseareboot ofthenewerSMonceormoreduringtheperiodwhenSMAutoupdateisenabledontheAP.Forthis reasonitisnotrecommendedthatoperatorsrepeatedlyenableanddisableSMAutoupdateonthe sameAP.SMAutoupdateshouldbeusedinitiallytoperformthemajorityofanetworkupgrade,and thenturnedoff(disabled).Theusercanthenusedirectupdatecapabilitiestoradiosthatrequire specialattentiontocompletetheirupgradeactions.
Update of radio devices works fine, but updates of CMM micro platforms fail
CMM3basedplatforms,suchastheCMMmicro,usetheTFTPservicetoperformupgrades.Ifbasic communicationtotheCMMisavailable(verifythroughaping)thentheissuemaybeontheTFTP communicationsportsettingsonanyroutersorfirewallsbetweentheNetworkUpdaterandthe CMM3inthenetwork.BesurethattwowaycommunicationsontheTFTPportisenabled.See NetworkCommunicationsonPage30formoreinformationonrequiredcommunicationprotocols andports.
118
Issue 1 August 2012
I am applying an update to an unsupported release

NetworkUpdaterdoesnotexplicitlycheckwhetheranunsupportedReleaseisbeing updated. Symptomsofthisinclude:SMAutoupdatedoesnotfunctioncorrectly(SMsmaynothavea recentenoughsoftwareversionthatsupportsSMAutoupdate). Inmostcases,NetworkUpdaterwillfunctionwithallelementsaboveRelease4.1. Forversionspriortothat,itmaybenecessarytomanuallyupdatetheelements.
Network Updater does not discover or update SMs

MakesureallAPsareloaded. MakesurethatSNMPisaccessiblybytheMachineexecutingNetworkUpdater. TheAPSNMPconfigurationneedstobesettosupportSNMPfromtheMachineexecuting NetworkUpdater. Ascriptisalsoprovidedforperformingthis.(However,itwillbenecessarytorebootthe AccessPointafterthisparameterisset).
An AP goes down during an update

IftheorderofUpdatesisnotspecified,anupdateprocessmaybeinterruptedduetoaloss ofnetworkconnectivitytothespecifiedelement. Typically,reinitiatingtheupdatewillresolvethisproblem.(Sincetheelementthatcaused thelossofconnectivityhasalreadybeenupdated,itwillnotbereupdated). Itisadvisabletoreconfigurethenetworkarchiveatthistimetoavoidtheproblemin future.
If my radio web interface is locking up, will Network Updater still work?
Onsomeversionofsoftware,anHTTPlockuperrorcanoccurwhichpreventsanAPmoduleweb interfacefromresponding.Whenthiserrorhappens,theradiostillcontinuestofunctionandmanage usertraffic.ThewebinterfacewillnotreturnuntiltheAPisrebooted.Ifyouareexperiencingthis problemonyournetwork,itwillNOTaffectNetworkUpdaterperformance.NetworkUpdaterwill reboottheAPmoduleasapartoftheupgradeprocess,actuallyclearingtheHTTPlockupproblemon anyradiosthatcurrentlyareexperiencingit.Inaddition,NetworkUpdaterinstallationpackages containsomespecificcheckstoensurethattheHTTPinterfaceontheradioisworkingcorrectly,and ifnotitwillrestoretheradiotoworkingorderasapartoftheupgradeprocess,whileensuringthe upgradecompletescorrectly.
119
Issue 1 August 2012
I cannot downgrade my R8.x radios to R7.x

Twodifferentissuescouldbeapplicablehere: WhendowngradingfromR8.x,whicharehardwarescheduleronlyreleases,youcanonly downgradetohardwareschedulerversionsof7.x.IfyoudonothaveAdvantageAPs,then theonlyreleaseyoucandowngradetois7.3.6.Onceyouhavedowngradedtoa7.xrelease successfully,itispossibletoswitchovertosoftwareschedulermodeifdesired. DuetothirdpartylicensingrestrictionsradiosthatareshippedfromthefactorywithR8.xor higheronthemcannoteverbedowngradedbelowR8.0.Iftheuserattemptstoinstallapre 8.0releaseonsucharadiothroughtheNetworkUpdatertool,theerrormessage Can not downgrade below 8.0willappearintheHistoryLogfileaswellasintheState columnfortheelement.
An HSBH link dropped during an upgrade, and the far-end HSBH does not respond
IfthenearsideofaHSBHlinkisupgradedfirstthenetworklinkbetweentheradioswillbelost.This willpreventcommunicationswiththefarsideofthelink.Ifthisoccurs,thenearsideofthelinkwill needtobedowngradedback(usingthesameupdateprocedurethroughNetworkUpdater)tothe originalsoftwareloadtorestorecommunicationswiththefarsideofthelink.SeeUpgradingHigh speedBackhaulsonPage17forproperproceduresonupgradingtheseunitswithoutlosing communications.
Network Updater hangs loading packages or performing an update

InordertoinitiateaNetworkUpdate,theNetworkUpdatertoolwilllookatthelistofcurrent selectedpackagesyouhaveintheManagePackageswindow.Foreachpackagethatisselected,the toolwillneedtoloadthispackageintomemorytoinspectit.Itispossiblethatifyouhavealarge numberofpackagesselected,andaverylimitedamountofmemoryonthecomputerrunningthe networkupdatertool,thatthetoolmayrunoutofavailablememoryandstopfunctioning.Inthis instanceyouwillcontinuetohavetheprogressbardisplayed,butnoadditionalHistoryentriesshow upintheHistorywindow.Ifyourunintothissituation,thewaytoaddressitistobesureyouonly selectthepackagesneededforthecurrentupdateactivity.Youcanhaveotherpackagesinthe managePackageslist,aslongastheyarentselected.Ifyoustillhavetheissue,thenyoumayneedto segmentyouupgradeactivitysothatyoucanlimitthenumberofactivepackagesneededto completetheupgrade.
note ............. This situation would likely only occur if the user is using a computer with very limited memory (such as 128MB and restricted or no file paging), and if they were loading a large number of system release packages (10 or more).
120
Issue 1 August 2012
Resources for Support

Network Updater Help
ThishelpdocumentisthemainsupportmediafortheNetworkUpdatertool.Theusershouldsearch thisdocumentforinformationbeforeconsultingothersourcesofinformation.SeeHelpContents onPage96.
Community Forum
ThetechnicalsupportCommunityForumispartofthesupportwebsiteandcanbeusedforasking questionsdirectlytothesupportteam.Questionsandanswersareaccessibletoallsothatany customercanbenefitfromthesamedialogue.Toaccessthisforum,visit http://www.cambiumnetworks.com/forum/.Thefollowingisanexampleofthecontentsofthe forumpage:
Thisforumrequiresauthenticationforposting. 121
Issue 1 August 2012
Technical Support
YoucanobtainsupportforWirelessManagerfromanyorallofthefollowingsources: WirelessManagersetupguide,administrationguide,andreleasenotes. CambiumNetworkssupportwebpage:http://www.cambiumnetworks.com/support. Thispageprovideslinkstoinformationonallproductsandtools,aswellasaccessto customersupportmaterialsandinteractivesupportforums.Someoftheseresourcesare restrictedtoregisteredusersandchannelpartners.
theCommunityForum.Visithttp://www.cambiumnetworks.com/forum/.SeeCommunity ForumonPage121. directcontactwithCambiumNetworksTechnicalSupport.Thiscontactisavailable7days aweek,24hoursaday.Tofindtheappropriatephonenumberbasedonyourcountryor region,visithttp://www.cambiumnetworks.com/support/technical.php. atechnicalsupportcase,whichyoucanopenat http://www.cambiumnetworks.com/support/support_case.php.Thecasecapturesbasic informationaboutanswersyouareseekingortheproblemthatyournetworkis experiencingandprovidesthistothesupportteam,whoareavailable7daysaweek, 24hoursaday,andwillrespond.Theywillalsoprovideacasenumberbywhichyouand theycancontinuetotrackprogressonissuesthatrequiredeeperinvestigation.
122

NetworkUpdater4 1OnLineHelpIssue1

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

NetworkUpdater4 1OnLineHelpIssue1

Uploaded by

Copyright:

Available Formats

Cambium Network Updater On-Line Help

Issue 1 System Release 4.1

August 2012 2012 Cambium Networks. All Rights Reserved.

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

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

AbouttheNetworkUpdaterTool................................................................................... 9 AboutthisHelpDocument ............................................................................................. 9

RelatedDocumentation ........................................................................................................ 10 Feedback ............................................................................................................................... 10

Key Network Updater Concepts ......................................................................13

UninstallingNetworkUpdater...................................................................................... 21 InstallingNetworkUpdateronRedHatLinux .............................................................. 21

Configuration and Settings..............................................................................29

SecurityofToolandData.............................................................................................. 29 ConfigurationFilesandDirectories .............................................................................. 29

NetworkCommunications ............................................................................................ 30 ToolDependencies ....................................................................................................... 30

4.5.4 4.5.5 4.5.6 4.5.7 4.5.8

Network Updater Operations ..........................................................................49

Command Line Operations .............................................................................99

Building Custom External Tools.....................................................................103

ExternalToolHelp....................................................................................................... 106 ExternalToolExtendedAttributes.............................................................................. 106

Resources for Support ........................................................................................121

TechnicalSupport ................................................................................................................... 122

Network Updater On-Line Help

Issue 1 August 2012

About this Help Document

Issue 1 August 2012

Network Updater On-Line Help

Modules vs. Radios

Feedback on Network Updater Tool

Feedback on Help File

Network Updater On-Line Help

Issue 1 August 2012

Recommended Minimum Computer Configuration

Network Updater On-Line Help

Issue 1 August 2012

Key Network Updater Concepts

Issue 1 August 2012

Network Updater On-Line Help

Network Updater On-Line Help

Issue 1 August 2012

Network Updater On-Line Help

Network Element Addressing IP Addresses and Hostnames

Image Package Files

Element Groups (Folders)

Network Updater On-Line Help

Issue 1 August 2012

Radio System Release 4.1through7.3 4.1through7.3 7.x1andlater 7.3.62andlater 8.4andlater

Notallhistoricalreleasemaybeavailableinthenewpackageformat. ConsulttheCambiumNetworkswebsiteforpackageavailability. EarlierpackagesifneededmaybeavailablethroughTechnicalSupport.

Network Layers and Orders of Updating Equipment

Upgrading High-speed Backhauls

Issue 1 August 2012

Network Updater On-Line Help

BecauseofthisslightlydifferentprocessandparadigminvolvedinupgradingHSBHsinthenetwork, theNetworkUpdaterusermayfinditeasiertocreateaseparateNetworkArchivefilejustfor performingupgradesontheirHSBHelementsoftheirnetwork.

Time Duration Estimates to Complete a Network Upgrade

Network Updater On-Line Help

Issue 1 August 2012

Anetworkupgradetypicallyrequiresthefollowingamountsoftime: 30secondstotransferthesoftwareandFPGAfilestoanelement 80secondstoburnintheFPGAloadintoanelement 130secondstoburninthesoftwareloadintoanelement 30secondstorebootanelement

TheAPinSMAutoupdatemodehasthefollowingcapacity: APSupportsupto4simultaneousupdatesofsoftware/FPGAfilestoSMswhen SMAutoupdateisenabledandtheAPisusedasthefileserver. APSupportsupto20simultaneousupdatesofsoftware/FPGAfilestoSMswhen SMAutoupdateisenabledandalocalHTTPorTFTPserverisused.

Layer 3 6APs 6APs 36AP 36AP 2BH +36AP

Layer 4 200SM 200SM 2,000SM 2,000SM 2BH +3,000 SM

Layer 5 N/A N/A N/A N/A

Layer 6 N/A N/A N/A N/A

Elements 208 208 2,148 2,148

Notes 1,3,5 2,4,5 1,3,5 2,4,5

Estimate 59mins 23mins 122mins 41mins

2BHs 2BH +36AP +3,000SM