Prizm-to-WM Migration Guide

Issue 3 February 2012

Prizm-toWireless Manager Migration Guide

Prizm Release 3.3 to WM Release 4.0

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

Accuracy

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

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

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

License Agreements

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

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

About Prizm Migration.................................................................................... 5

1.1 1.2 PrerequisitesforPrizmMigration................................................................................... 5 CaveatsfortheMigration............................................................................................... 5

2 3

Exporting Data From Prizm.............................................................................. 7 Importing Prizm Data into WM .......................................................................11

CommunityForum .................................................................................................................... 13 TechnicalSupport ..................................................................................................................... 14

Resources for Support ..........................................................................................13

List of Figures
Figure1:Step1dialog................................................................................................................................... 8 Figure2:Step2dialog................................................................................................................................... 9

List of Procedures
Procedure1:Togeneratetheexportfiles .................................................................................................... 7 Procedure2:ToimportthedataexportedfromPrizm .............................................................................. 11

Prizm-to-WM Migration Guide

Issue 3 March 2012

About Prizm Migration

ThisguidesupportsoperatorswhomanagetheirnetworkswithPrizm,wanttonowmanagethem withWirelessManager(WM),butwantWMtoreuseasmuchinformationaspossibleabout theelementsandtheirmanagementaccessandhistory. thenamesofusersandhowtheyauthenticateintothemanagementsystem. theconfigurationsthattheBAMsubsystemforcesontheelements. customercontactinformationwithitscorrelationtotheindividualelements.

TechnicalsupportforyourmigrationisavailablethroughthesourcesdescribedunderResourcesfor SupportonPage13.

1.1

Prerequisites for Prizm Migration

Successfulmigrationofthedatalistedaboverequiresthefollowingconditions: CurrentlysuccessfuloperationofPrizmRelease3.2or3.3 PopulatedPrizmdatabaseinoneofthefollowingvendorversions: MySQLServerinVersion4.1.201or5.0inaPrizmsupportedplatformofLinuxor Windows PostgreSQLinVersion8.2inaPrizmsupportedplatformofLinuxorWindows MicrosoftSQLServer2000EnterpriseEditioninaPrizmsupportedplatformofWindows specifictotheOSonthePrizmserverdevice downloadedfromtheMotorolawebpage

Migrationtool

SuccessfullyinstalledinstanceofWMRelease3.0asthetargetforthemigrateddata.

1.2

Caveats for the Migration

NotablynotpartofthemigrateddataarethefollowingitemsfromaPrizmdeployment: licenses tousePrizmand/oritsBAMsubsystem tomanageelements

informationthatPrizmusesandWMrequiresforproperinteractionwiththeBAM subsystem configurationtemplatesthatPrizmpushestoitselements elementaccountstates(activatedorsuspended) elementnames,locations,andtheircontact(staff)information permissionsastheyrelateinPrizmtothetypesofactivitiesthatPrizmallowsperuser howviewshavebeenfiltered logsofoperationsandmanagementerrorconditions.

Prizm-to-WM Migration Guide

Issue 3 March 2012

Exporting Data From Prizm

ThemigrationtoolthatMotorolaprovideslaunchesandproperlyformatsalloftheexportsthatfull migration 1toWMrequires.

Procedure 1: To generate the export files

1. Downloadthemigrationtool(theoneappropriatefortheOSofthedeviceonwhichPrizm operates,eitherPrizmMigrationToolWindows.zipor PrizmMigrationToolLinux.zip)anditsassociatedMD5validationfilefrom http://www.cambiumnetworks.com/support/planning/index.php?cat=1&type=1. RuntheMD5validation(forexample,inthechecksumcalculatorthattheNetworkUpdater toolprovidesinitsRelease4.0orlater)toensurethatthemigrationtoolwasnotcorrupted duringitsdownload. Ifnecessary,makethetoolfileexecutable. WithPrizmrunninginnormaloperation,useitsGUItoensurethat 5. 6. 7. 8. 9. allelementsarediscovered. connectivityissuesforallofthoseelementsareresolved. thedesiredelementsarebroughtintonetworks. theelementsthatyoudonotwantWMtomanagearesenttotheIgnoredElementslist. theBAMsubsystem,ifdeployed,operatesasexpectedandsucceeds. thelogssuggestnomanagementerrorconditions.

2.

3. 4.

OpenthePrizmEMSAdministratorTool. Fromitsmainmenu,selectActionWebServerStop. SelectActionPrizmEMSServerStop. SelectActionLicenseManagerStopLicenseManager. ClosethePrizmEMSAdministratorToolinterface.

10. Executethedownloadedmigrationtool. ThetoolinterfaceopenstoitsStep1interfacescreen.

asdefinedinAboutPrizmMigrationonPage5anditssections.

Issue 3 March 2012

Prizm-to-WM Migration Guide

Figure 1: Step 1 dialog

11. ForServerLocation,browse()toandselectthepathonthefilesystemtothe ...\Canopy\Prizm folder or .../canopy/prizmdirectory. 12. EntervaluesfortheNBIDetailsblock,consistentwithyourlocalconfiguration. 13. LeavethevaluesoftheDatabaseDetailsblockfieldsintheStep1dialogasthetool automaticallypopulatedthem. 14. ClicktheNextbutton. ThetoolmakesproperconnectiontoPrizmanditsdatabase,andthenopenstheStep2 interfacescreen.

Prizm-to-WM Migration Guide

Issue 3 March 2012

Figure 2: Step 2 dialog

15. BasedonyourexperienceincheckingPrizmoperations(inStep4ofthisprocedure), uncheckanyofthefollowingExportOperationcheckboxestosuppresstheexportofany typeofinformationthatisknowntobeincompleteorincorrectlyconfigured: Useraccountinformation Devicediscoveryinformation PerformanceData CustomerData

16. IfBAMisnotlicensedforyourPrizmdeploymentorifyourexperienceincheckingBAM operations(inStep4ofthisprocedure)indicatedproblemspushingVLANand/orbandwidth values,uncheckasappropriatethefollowingExportOperationcheckboxestosuppressthe attemptedexportofanytypeofthesetemplates: VLANprofiles Bandwidthserviceplans browse()toandspecifyandalternativepathanddirectorytoreceivetheexported files. leavespecifiedthedirectorythattheExportLocationfielddisplaysasthedefault repository.

17. Optionally,either

18. ClicktheNextbutton. Thetoolopensawindowthatdisplaystheresultsoftheexportoperations.

Prizm-to-WM Migration Guide

Issue 3 March 2012

Importing Prizm Data into WM

TheexporteddatahasthefollowingusesforyouroperationsinWM. Format CSV CSV Usefulness for WM Operations ToimportdirectlyintoWMforallsecuritymanagementpurposes. ToimportdirectlyintoWMforuseintheDiscoveryConfigurator. ToimportdirectlyintoWMforuseasconfigurationtemplateswhosevaluesWMcan pushtodevicesviaSNMP.ThisdiffersinbothprotocolandpracticefromhowBAM appliestheseprofiles,whichdoesnotrequiredevicerebootandtakesimmediate effect.Alsobycontrast,whenthetemplatesinsteadofBAMprofilesareapplied,the resultsareavailableinconfigurationreports. Toimportintoarelationaldatabase(spreadsheet)fileandkeepforreferenceand comparisonagainstperformancedatathatWMwillgenerateforthedevices. ToimportdirectlyintoWMforuseinanyofthecustomercontactfeaturesthatWM Release3.0includesandanyfuturereleasewillintroduce.

Export Operation Useraccount information Devicediscovery information VLANprofiles

XML Bandwidthservice plans PerformanceData CustomerData CSV CSV

TobecomegenerallyfamiliarwiththeWMdatafileimportfeature,seetheuserguidesectiontitled "ImportingDataFilesIntoWM."WMprovidesaseparatelyselectableoperationtolaunchtheimport ofeachfiletype,andtheuserguidedescribestheimportofeachexportedfiletypeinaseparate section.ReferencestothesesectionsareincludedinProcedure2below.Toimportallbutthe performance(historical)data,performthefollowingsteps.

Procedure 2: To import the data exported from Prizm

1. FromthePrizmserverdevice,transferthecontentsoftherepositorydirectorytowithin network(filebrowser)reachoftheWMclientapplicationthatwillbeusedfortheimport operations. ToimporttheuserinformationfromPrizm,usetheproceduredescribedintheuserguide sectiontitled"ImportingUserAccountInformation." ToimportthedevicediscoveryinformationfromPrizm,usetheproceduredescribedinthe userguidesectiontitled"ImportingDeviceDiscoveryInformation." ToimporttheVLANprofilesandbandwidthserviceplansfromPrizmasconfiguration templates,usetheproceduredescribedintheuserguidesectiontitled"Importinga ConfigurationTemplate."

2. 3. 4.

note ............. To be able to use the VLAN profiles and bandwidth service plans as BAM profiles, no import action is required, since the BAM subsystem as launched from the WM client already stores these as profiles.

5.

ToimportthecustomerdatafromPrizm,usetheproceduredescribedintheuserguide sectiontitled"ImportingaCustomerContactDatabase."

11

Prizm-to-WM Migration Guide

Issue 3 March 2012

Resources for Support

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

Thisforumrequiresauthenticationforposting.

13

Issue 3 March 2012

Prizm-to-WM Migration Guide

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

theCommunityForum.Visithttp://www.cambiumnetworks.com/forum/.SeeCommunity ForumonPage13. 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.

14