Veritas NetBackup™ Appliance Troubleshooting Guide Release 3.0 NetBackup 52xx and 5330 Veritas NetBackup™ Appliance Troubleshooting Guide Documentversion:3.0 Legal Notice Copyright©2017VeritasTechnologiesLLC.Allrightsreserved. Veritas,theVeritasLogo,andNetBackuparetrademarksorregisteredtrademarksofVeritas TechnologiesLLCoritsaffiliatesintheU.S.andothercountries.Othernamesmaybe trademarksoftheirrespectiveowners. ThisproductmaycontainthirdpartysoftwareforwhichVeritasisrequiredtoprovideattribution tothethirdparty(“ThirdPartyPrograms”).SomeoftheThirdPartyProgramsareavailable underopensourceorfreesoftwarelicenses.TheLicenseAgreementaccompanyingthe Softwaredoesnotalteranyrightsorobligationsyoumayhaveunderthoseopensourceor freesoftwarelicenses.Refertothethirdpartylegalnoticesdocumentaccompanyingthis Veritasproductoravailableat: https://www.veritas.com/about/legal/license-agreements Theproductdescribedinthisdocumentisdistributedunderlicensesrestrictingitsuse,copying, distribution,anddecompilation/reverseengineering.Nopartofthisdocumentmaybe reproducedinanyformbyanymeanswithoutpriorwrittenauthorizationofVeritasTechnologies LLCanditslicensors,ifany. THEDOCUMENTATIONISPROVIDED"ASIS"ANDALLEXPRESSORIMPLIED CONDITIONS,REPRESENTATIONSANDWARRANTIES,INCLUDINGANYIMPLIED WARRANTYOFMERCHANTABILITY,FITNESSFORAPARTICULARPURPOSEOR NON-INFRINGEMENT,AREDISCLAIMED,EXCEPTTOTHEEXTENTTHATSUCH DISCLAIMERSAREHELDTOBELEGALLYINVALID.VERITASTECHNOLOGIESLLC SHALLNOTBELIABLEFORINCIDENTALORCONSEQUENTIALDAMAGESIN CONNECTIONWITHTHEFURNISHING,PERFORMANCE,ORUSEOFTHIS DOCUMENTATION.THEINFORMATIONCONTAINEDINTHISDOCUMENTATIONIS SUBJECTTOCHANGEWITHOUTNOTICE. TheLicensedSoftwareandDocumentationaredeemedtobecommercialcomputersoftware asdefinedinFAR12.212andsubjecttorestrictedrightsasdefinedinFARSection52.227-19 "CommercialComputerSoftware-RestrictedRights"andDFARS227.7202,etseq. "CommercialComputerSoftwareandCommercialComputerSoftwareDocumentation,"as applicable,andanysuccessorregulations,whetherdeliveredbyVeritasasonpremisesor hostedservices.Anyuse,modification,reproductionrelease,performance,displayordisclosure oftheLicensedSoftwareandDocumentationbytheU.S.Governmentshallbesolelyin accordancewiththetermsofthisAgreement. VeritasTechnologiesLLC 500EMiddlefieldRoad MountainView,CA94043 http://www.veritas.com . Technical Support TechnicalSupportmaintainssupportcentersglobally.Allsupportserviceswillbedelivered inaccordancewithyoursupportagreementandthethen-currententerprisetechnicalsupport policies.ForinformationaboutoursupportofferingsandhowtocontactTechnicalSupport, visitourwebsite: https://www.veritas.com/support YoucanmanageyourVeritasaccountinformationatthefollowingURL: https://my.veritas.com Ifyouhavequestionsregardinganexistingsupportagreement,pleaseemailthesupport agreementadministrationteamforyourregionasfollows: Worldwide(exceptJapan) [email protected] Japan [email protected] Documentation ThelatestdocumentationisavailableontheVeritaswebsite: https://sort.veritas.com/documents Documentation feedback Yourfeedbackisimportanttous.Suggestimprovementsorreporterrorsoromissionstothe documentation.Includethedocumenttitle,documentversion,chaptertitle,andsectiontitle ofthetextonwhichyouarereporting.Sendfeedbackto: [email protected] YoucanalsoseedocumentationinformationoraskaquestionontheVeritascommunitysite: http://www.veritas.com/community/ Veritas Services and Operations Readiness Tools (SORT) VeritasServicesandOperationsReadinessTools(SORT)isawebsitethatprovidesinformation andtoolstoautomateandsimplifycertaintime-consumingadministrativetasks.Depending ontheproduct,SORThelpsyouprepareforinstallationsandupgrades,identifyrisksinyour datacenters,andimproveoperationalefficiency.ToseewhatservicesandtoolsSORTprovides foryourproduct,seethedatasheet: https://sort.veritas.com/data/support/SORT_Data_Sheet.pdf Contents Chapter 1 About using the Troubleshooting Guide ....................... 6 Aboutthisguide............................................................................. 6 Abouttheintendedaudience............................................................ 7 AboutcontactingTechnicalSupport................................................... 7 AbouttroubleshootingtheNetBackupAppliance...................................8 Chapter 2 Best practices ..................................................................... 11 About best practices ..................................................................... 11 DeterminingtheNetBackupApplianceserialnumber........................... 13 AboutFibreChannelHBAcardconfigurationverification...................... 17 AboutNotificationsettings.............................................................. 19 AboutIPMIconfiguration................................................................ 19 Aboutpasswordmanagementandrecovery...................................... 21 AboutIPv4-IPv6-basednetworksupport............................................22 AboutenablingBMRoptions...........................................................23 Aboutdeletingusers..................................................................... 24 Chapter 3 About troubleshooting tools ............................................ 25 ToolsfortroubleshootingtheNetBackupAppliance............................. 25 Abouthardwaremonitoring.............................................................26 TroubleshootingandtuningappliancefromtheApplianceDiagnostics Center..................................................................................27 AboutNetBackupsupportutilities.................................................... 30 NetBackupDomainNetworkAnalyzer(NBDNA)........................... 30 NetBackupSupportUtility(NBSU)............................................. 32 Chapter 4 Working with log files ........................................................ 33 AboutNetBackupAppliancelogfiles................................................ 33 AbouttheCollectLogfileswizard.................................................... 35 ViewinglogfilesusingtheSupportcommand..................................... 36 WheretofindNetBackupAppliancelogfilesusingtheBrowse command ............................................................................. 37 GatheringdevicelogswiththeDataCollectcommand.......................... 39 AboutgatheringinformationforNetBackup-Javaapplications................ 40 Contents 5 EnablinganddisablingVxMSlogging............................................... 41 Chapter 5 Disaster recovery .............................................................. 43 Aboutdisasterrecovery................................................................. 43 Disasterrecoverybestpractices...................................................... 44 Disasterrecoveryscenarios............................................................44 Appliancesustainedpowerinterruption....................................... 45 Appliancehardwarefailure....................................................... 47 Completelossofappliancewithrecoverableoperatingsystem drivesandattachedstoragedisks........................................ 54 Completelossofappliancewithrecoverableattachedstorage disks.............................................................................. 56 Completelossofapplianceandattachedstoragedisks.................. 83 NetBackupAppliancesoftwarecorruption....................................85 NetBackup Appliance database corruption .................................. 85 NetBackupAppliancecatalogcorruption..................................... 90 NetBackupApplianceoperatingsystemcorruption........................ 96 Chapter 6 NetBackup Appliance error messages ....................... 97 AboutNetBackupApplianceerrormessages......................................97 Errormessagesdisplayedduringinitialconfiguration........................... 98 ErrormessagesdisplayedontheNetBackupApplianceWebConsole .......................................................................................... 100 ErrormessagesdisplayedontheNetBackupApplianceShellMenu .......................................................................................... 118 NetBackupstatuscodesapplicableforNetBackupAppliance.............. 127 1 Chapter About using the Troubleshooting Guide Thischapterincludesthefollowingtopics: ■ Aboutthisguide ■ Abouttheintendedaudience ■ AboutcontactingTechnicalSupport ■ AbouttroubleshootingtheNetBackupAppliance About this guide ThisguideprovidestheinformationtotroubleshoottheVeritasNetBackup Applianceswiththeappliancesoftwareversion3.0.Thisguideprovidesstepsto troubleshoottheNetBackupApplianceusingtheNetBackupApplianceWebConsole andtheNetBackupApplianceShellMenu.Italsoprovidesdetailedinstructionson howtotroubleshootthe52xxand5330appliancehardware.Thisguidehelpsyou performthefollowingtasks: ■ Diagnoseanissuebyusingtheavailabletoolstodiagnoseaproblem. ■ Locatetherelevantinformationtoidentifythecoreproblembyreferencingto therelevantlogs. ■ Resolveissuesfacedbyimplementingthebesttroubleshootingpractices. ■ Safelyremoveandreplacethehardwarecomponentsthatarefaultyandcause theissuetoreoccur. AboutusingtheTroubleshootingGuide 7 Abouttheintendedaudience Note:Weensurethatourdocumentsareup-to-datewiththelatestinformation abouttheNetBackupAppliancehardwareandsoftware.Youcanrefertothe NetBackupApplianceDocumentationwebpageforthemostupdatedversionsof theNetBackupAppliancedocumentation. About the intended audience ThisguideisintendedfortheendusersthatincludesystemadministratorsandIT technicianswhoaretaskedwithmaintainingtheNetBackupAppliance. About contacting Technical Support TheTechnicalSupportwebsitehasawealthofinformationthatcanhelpyousolve NetBackupApplianceproblems.YoucanaccessTechnicalSupportatthefollowing URL: www.veritas.com/support WhenyoureportanissuetoSupport,keepthefollowinginformationathand: ■ Locateandnotetheserialnumberofyourappliance,storagedevices,and switchesasapplicable. See“DeterminingtheNetBackupApplianceserialnumber”onpage13. ■ Refertotheapplianceerrormessagedocumentationandconfirmthe recommendedaction. See“Errormessagesdisplayedduringinitialconfiguration”onpage98. See“ErrormessagesdisplayedontheNetBackupApplianceWebConsole” onpage100. See“ErrormessagesdisplayedontheNetBackupApplianceShellMenu” onpage118. See“NetBackupstatuscodesapplicableforNetBackupAppliance”onpage127. ■ GatherdevicelogsusingtheDatacollectcommand. See“GatheringdevicelogswiththeDataCollectcommand”onpage39. ■ EnsurethatCallHomeisenabledandtheproxysettingsprovidedarecorrect. YoucanusetheSettings>Notification>AlertConfigurationfromthe NetBackupApplianceWebConsoletoapplytheCallHomesettings.See“About Notificationsettings”onpage19. See“Aboutbestpractices”onpage11. AboutusingtheTroubleshootingGuide 8 AbouttroubleshootingtheNetBackupAppliance About troubleshooting the NetBackup Appliance Ifyouexperiencetroublewithyourapplianceandcannotresolvetheproblemon yourown,itisimportantthatyoucandefinetheproblemandcollectanysupporting information.Whenyoureachthispoint,youshouldcontactTechnicalSupport.A technicalsupportrepresentativeworkswithyoutodiagnosetheproblemand produceasatisfactoryresolution. Thefollowingstepsoffergeneralguidelinestohelpyouresolveanyproblemsyou mayencounterwhileyouuseNetBackupAppliance.Thestepsprovidelinksto morespecifictroubleshootinginformation. Table1-1 StepsfortroubleshootingNetBackupApplianceproblems Step Action Description Step1 Notetheerrormessage Tonotewhathasgonewrongwiththeapplianceyoucanusethefollowing options: ■ Errormessagesareusuallythevehiclefortellingyousomethingwent wrong. Refertotheapplianceerrormessagedocumentationandconfirmthe recommendedaction. See“Errormessagesdisplayedduringinitialconfiguration”onpage98. See“ErrormessagesdisplayedontheNetBackupApplianceWeb Console”onpage100. See“ErrormessagesdisplayedontheNetBackupApplianceShellMenu” onpage118. ■ Ifyoudon’tseeanerrormessageinaninterface,butstillsuspecta problem,youcan: ■ UsetheMonitor>HardwaretabfromtheNetBackupApplianceWeb Consoletomonitorthehardware,thestoragedevices,andallthe componentsthatareassociatedwiththem. ■ Executeahardwareself-testfromtheNetBackupApplianceShell MenuusingtheSupport > Testcommand.Oncompletionofthe hardwareselftest,adetailedhardwaremonitoringreportisdisplayed ontheNetBackupApplianceShellMenuthatcanhelpyouidentify theexactissuewithyourappliance. ■ ChecktheNetBackupAppliancereportsandlogs.Thelogsshowyou whatwentwrongandtheoperationthatwasongoingwhenthe problemoccurred. See“AboutNetBackupAppliancelogfiles”onpage33. ■ Ifyoucaneasilyaccesstheappliancehardware,youcanidentifythe issuesusingLEDs.FormoreinformationaboutLEDlocationsand interpretingthem,refertotheNetBackupApplianceHardwareInstallation Guides AboutusingtheTroubleshootingGuide 9 AbouttroubleshootingtheNetBackupAppliance Table1-1 StepsfortroubleshootingNetBackupApplianceproblems (continued) Step Action Description Step2 Identifywhatyouweredoing Askthefollowingquestions: whentheproblemoccurred ■ Whatoperationwastried? ■ Whatmethoddidyouuse? Forexample,morethanonewayexiststoinstallsoftwareonaclient. Alsomorethanonepossibleinterfaceexiststouseformanyoperations. Someoperationscanbeperformedwithascript. ■ Whattypeofserverplatformandoperatingsystemwasinvolved? ■ Ifyoursiteusesboththemasterserverandthemediaserver,wasita masterserveroramediaserver? ■ Ifaclientwasinvolved,whattypeofclientwasit? ■ Haveyouperformedtheoperationsuccessfullyinthepast?Ifso,what isdifferentnow? ■ Whatisthesoftwareversionlevel? ■ Doyouuseoperatingsystemsoftwarewiththelatestfixessupplied? ■ Isyourdevicefirmwareatalevel,orhigherthanthelevel,atwhichithas beentestedaccordingtotheposteddevicecompatibilitylists? Step3 Recordallinformation Capturepotentiallyvaluableinformation: ■ Progresslogs ■ Reports ■ UtilityReports ■ Debuglogs ■ CheckforerrororstatusmessagesinthesystemlogandEventViewer applicationincaseofaWindowscomputer. Note:TostarttheEventViewer,fromtheStartmenu,clickAllPrograms >AdministrativeTools>EventViewer. ■ Errororstatusmessagesindialogboxes See“AboutNetBackupAppliancelogfiles”onpage33. AboutusingtheTroubleshootingGuide 10 AbouttroubleshootingtheNetBackupAppliance Table1-1 StepsfortroubleshootingNetBackupApplianceproblems (continued) Step Action Description Step4 Correcttheproblem IfyoudefinetheissueasaNetBackupApplianceissue,youcanfind additionaltroubleshootinginformationfromtheNetBackupAppliancepage ontheTechnicalSupportwebsite. IfyoudefinetheissueasaNetBackupissue,youcanusethefollowing informationtocorrectit: ■ Takethecorrectiveactionasrecommendedbythestatuscodeor message. See“NetBackupstatuscodesapplicableforNetBackupAppliance” onpage127. Formoreinformation,refertotheNetBackupStatusCodeReference Guide. ■ Ifnostatuscodeormessageexists,ortheactionsforthestatuscode donotsolvetheproblem,useadditionaltroubleshootingproceduresto isolatecommonproblems. See“AboutNetBackupsupportutilities”onpage30. SeetheNetBackupTroubleshootingGuideforadditionalinformation specifictoNetBackup. Step5 Completeaproblemreport Ifyoucanidentifythelogsthatcanhelpresolvetheissue,collectthe forTechnicalSupport appropriatelogs.Ifyoucannotidentifytherequiredlogsforresolvingthe problem,contactTechnicalSupporttogetadviceonwhichlogstocollect. Ifyourtroubleshootingisunsuccessful,preparetocontactTechnicalSupport byfillingoutaproblemreport. See“AboutcontactingTechnicalSupport”onpage7. See“AboutNetBackupAppliancelogfiles”onpage33. Step6 ContactTechnicalSupport TheVeritasTechnicalSupportwebsitehasawealthofinformationthatcan helpyousolveNetBackupApplianceproblems. AccessTechnicalSupportatthefollowingURL: www.veritas.com/support See“AboutcontactingTechnicalSupport”onpage7. See“EnablinganddisablingVxMSlogging”onpage41.
Description: