NetApp OneCollect安装维护手册

OneCollect1.0.1InstallationandAdministrationGuideMay2017|215-12001_C0doccomments@netapp.comContentsOverviewofOneCollect...............................................................................4InstallingandsettingupOneCollect..........................................................6SystemrequirementsforOneCollect..........................................................................6Supporteddevicetypesandprotocolsfordatacollection...........................................6InstallingOneCollectonWindows.............................................................................8InstallingOneCollectonMacOSX...........................................................................9InstallingOneCollectonLinux.................................................................................10Editingdatacollectionpreferences...........................................................................11UpgradingOneCollect...............................................................................12CollectinganduploadingdatafromdevicesusingOneCollect..............13CollectingdatausingOneCollect..............................................................................13Collectingdatausingthedevice-basedcollectionmethod...........................14Collectingdatausingthesolution-basedcollectionmethod.........................14CollectingdatausingSerialport...................................................................15CollectingdatausingAutoSupportmethod..................................................15Discoveringdevicesautomaticallyandcollectingdata.................................16Schedulingadatacollectionjob................................................................................17Editingasavedjob....................................................................................................18Viewingcollecteddata..............................................................................................19CollectinganduploadingdatatoAutoSupport.........................................................19UninstallingOneCollectandplug-ins.......................................................21Troubleshooting..........................................................................................22ResolvingOneCollectlaunchingerror......................................................................22Backingupthedatabase............................................................................................23Changingthedefaulttimeoutforcommandexecution.............................................23RestartingtheOneCollectserver...............................................................................23Sendingthefeedback................................................................................................24Searchingfortheresultandlogfiles.........................................................................24Copyrightinformation...............................................................................26Trademarkinformation.............................................................................27Howtosendcommentsaboutdocumentationandreceiveupdatenotifications............................................................................................28Index.............................................................................................................29TableofContents|3OverviewofOneCollectOneCollectisadatacollectiontool.Thistoolenablesyoutocollectdatafromstorageareanetwork(SAN),networkattachedstorage(NAS)environments.Inaddition,diagnosticcontentrelatedtoyourenvironmentcanbeeithersenttoNetAppforfurtheranalysisoranalyzedonpremises.YoucanuseOneCollecttocollectdatafromstoragesystems,hosts,andswitches.YoucanalsoextendtheprofilesavailableintheOneCollecttooltocollectdatafromnewtypesofsystems.YoucansendthecollecteddatabacktoNetAppforbettersupportandassessmentofoperations,suchasnondisruptiveupgradesanddatamigration.OneCollectsupportsdatacollectionthroughmultipledatacollectionprotocols.OneCollectpoststhedatathatiscollectedtoAutoSupport.YoucanextendthebehaviorofOneCollectbyusingthefollowingbuilt-inplug-ins.•ONTAP•E-Series•FlexPod•MetroCluster•ONTAP7-ModeFormoreinformationaboutSolution-basedandDevice-basedcollectiontypes,seeSupporteddevicetypesandprotocolsfordatacollection.onpage6Solution-basedcollectionprofileanddevice-basedcollectionprofilearetwotypesofdatacollectionprofiles.Solution-basedcollectionprofileisapredefinedenvironment.Device-basedcollectionprofileallowstheusertocreatetheirownenvironment.OneCollectcompilesdataaboutallthehostoperatingsystems,switches,storagearraysandotherdevices,whichcomprisemostsystemsfoundinatypicalenterpriseecosystem.TypicalsystemsincludeWindows,Linux,VMware,FreeBSD,Solaris,AIX,HP-UX,CiscoIOS/NXOS/SANOS/UCS,Brocade,NetAppDataONTAP,E-Series,andothers.Youcanviewtherawdatafromeachcollection.OneCollectusesTelnet,SSH,andHTTPSprotocolsforcommunicatingwithsystemsanddevices.Toperformdatacollectionagainstremotehosts,itisnecessarythatyouprovideadministrativecredentials.Ifyoudecidetostorecredentials,OneCollectprovidespassword-protectedencryption(passphrase)tokeepyourcredentialsconfidential.ThecredentialsarestoredinadatabaseandencryptedusingAdvancedEncryptionStandard(AES).AsyoustartusingOneCollect,itisimportantthatyouunderstandsomeofthebasictermsthatyoucanexpecttoseethroughouttheOneCollectuserinterface.PersonaDescriptionGeneralCollectsbasiccommandsforthetargetdeviceDiagnosticCollectsadditionaldiagnosticcommandsandlogsfromthedeviceotherthantheonesthatruninGeneralmodeSnapDriveCollectsSnapDrivespecificdiagnosticlogsSnapManagerCollectsSnapManagerspecificlogsSnapManagerforOracle(SMO)CollectsSnapManagerforOraclespecificlogsSnapManagerforSAP(SMSAP)CollectsSnapManagerforSAPspecificlogs4OrchestratorRunscommandsorcollectslogsrelatedtoVMwareorchestratorNote:ForgeneratingreportorparsingintheUnifiedParser,NetApprecommendsusingDiagnosticpersonainOneCollecttocollectalltherequiredcommandsandlogs.OverviewofOneCollect|5InstallingandsettingupOneCollectBeforeyoucanstartcollectingdatausingOneCollect,youmustdownloadandinstallOneCollect.Afterinstalling,youcanaddaplug-intoextendthedatacollectioncapabilitiesofthetool.SystemrequirementsforOneCollectYoumustensurethatyouhavetherequiredhostsystemconfiguration,operatingsystem,andbrowsertoruntheOneCollecttool.OneCollectcanrunonthefollowingoperatingsystems:•Windows7(64-bit)•Windows8(64-bit)•Windows10(64-bit)•Windows2008R2Server(64-bit)•Windows2012R2Server(64-bit)•MacOSX10.10andlater(64-bit)•RedHatEnterpriseLinux(RHEL)6.3andlater(64-bit)•UBUNTU7.0andlater(64-bit)OneCollectsupportsthefollowingbrowsers:•MozillaFireFox35andlater•GoogleChrome43andlater•AppleSafari9.1andlater•MicrosoftInternetExplorer10and11(64-bit)SupporteddevicetypesandprotocolsfordatacollectionOneCollectprovidestwoprofilesthathelpyouincollectingdatafromdevicesandsolutions.Youshouldlearnmoreabouttheseprofilestohelpyoudecidewhichonetouse.Eachprofilecontainsthecredentialsforthedatabaseassociatedwiththeprofile.ThecredentialsenableOneCollecttoconnecttoandworkwiththedatabase.Thestoredcredentialsincludetheusernameandpasswordforaccessingthehost,therepository,thedatabase,andtherequiredinformation.Device-basedcollectiontypesTypeSub-typeSupportedpersonaSupportedprotocolHybridswitchCisconexus5000/6000/9000switchDiagnosticandGeneralSSHHybridswitchCisconexus7000switchDiagnosticandGeneralSSH6EthernetswitchCiscoswitchDiagnosticandGeneralSSHEthernetswitchNetAppswitchDiagnosticandGeneralShellSSHFC(FibreChannel)switchCiscoswitchDiagnosticandGeneralSSHFCswitchBrocadeswitchDiagnosticSSHFCswitchQLogicswitchDiagnosticSSHFCswitchMcDataswitchDiagnosticSSHFCswitchMcDatai10kswitchDiagnosticSSHHostCiscoUCSGeneralUCSMXMLAPIHostAIXDiagnosticandGeneralSSHHostLinux(RedHatEnterprise,SuSe)General,Diagnostic,SnapDrive,SMO,SMSAP,OrchestratorSSHHostSolarisDiagnosticandGeneralSSHHostHPUXDiagnosticandGeneralSSHHostPowerVMIos,BaseSSHHostESXiGeneralSSHHostWindowsDiagnostic,DMR,SnapManagerWMIStorageControllerDataONTAP7-ModeGeneral,DiagnosticOntapi,HTTP(s),SSHStorageControllerONTAPGeneral,Dblade,DiagnosticOntapi,HTTP(s),SSHStorageControllerSolidFireGeneralSolidFireElementOSAPIStorageControllerE-Series-SMCliGeneralSMCliStorageControllerE-Series-WebServicesProxyGeneralE-SeriesWebServicesAPISolution-basedcollectiontypesProfileSub-profileCorrespondingdeviceSupportedprotocolONTAPNetwork•ClusterNode•ClusterSwitch•ManagementSwitch•HTTPS,SSH•SSH•ShellSSHInstallingandsettingupOneCollect|7FlexPodFlexPod-clusteredDataONTAP•CiscoUCSCluster•ClusterNode•ClusterSwitch•NexusSwitch•vCenterServer(vCenter)•UCSMXMLAPI•HTTPS,SSH•SSH•SSH•HTTPAPIFlexPodFlexPod-7-Mode•CiscoUCSCluster•StorageController•NexusSwitch•UCSMXMLAPI•HTTPS,SSH•SSHFlexPodFlexPod-SolidFire•CiscoUCSCluster•SolidFireCluster•Nexusswitch•UCSMXMLAPI•SolidFireElementOSAPI•SSHONTAP7ModeNetworkStorageController•HTTPS•SSHMetroClusterTwo-nodeconfiguration•ClusterNode/SimulationNode•Fabricswitch•Attobridges•SSH,HTTP(s),Telnet•TelnetMetroClusterFour-nodeconfiguration•ClusterNode/SimulationNode•Fabricswitch•SSH,HTTP(s),Telnet•SSH,TelnetMetroClusterAllMetroClusterconfigurations•ClusterNode/SimulationNode•Fabricswitch•Attobridges•SSH,HTTP(s),Telnet•SSH•TelnetInstallingOneCollectonWindowsYoucaninstallOneCollecteitheronyoursystemoryoucanhostitinacentralserverthatcanbeaccessedbymultipleusers.Beforeyoubegin•Youmustensurethatyouhavetherequiredhostsystemconfiguration,operatingsystem,andbrowsertoruntheOneCollecttool.SystemrequirementsforOneCollectonpage68|•YoumusthavedownloadedtheOneCollectexecutablebinaryforyourplatform.http://mysupport.netapp.com/tools/info/ECMLP2671381I.html?productID=62128Steps1.Installthetoolbycompletingthestepsintheinstallationwizard.ThedefaultinstallationfolderforOneCollectonWindowsoperatingsystemisasfollows:OperatingsystemDefaultinstallationfolderWindows64-bitC:\ProgramFiles(x86)\NetApp\OneCollectYoucanchangethedefaultinstallationpathtoeitherafolderordriveofyourchoice.2.LaunchOneCollectfromtheURL:http://localhost:8044/OC/#/Note:Toconfiguretheapplicationtorunonadifferentport,modifyPORTvalueintheCONFIGfilelocatedinthe<user_home_directory>\Netapp\OneCollect\Configandrestarttheapplication(forexample,PORT=8040).TohosttheOneCollectservercentrallytobeaccessedfromremotehosts,youcanedittheconfigfileandappendtheIPaddresstobindtoasprefixtoport(forexample:PORT=0.0.0.0:8044willmakeitopentoallhostsonallIPs.Alternatively,PORT=<dedicated_IP>:8044willmakeitavailableonthespecificIPconfiguredonhost).AfteryoufinishIfyouwanttorunOneCollectautomaticallyduringsystemstartup,performthefollowingsteps:1.Navigateto<Install_directory>\NetApp\OneCollect\>,right-click‘onecollect.exe’andselectcopy.2.FindtheStartupfolderinAllProgramsandright-clickit.3.ClickOpen,anditopensupintheWindowsExplorer.4.Right-clickanywhereinsidethatwindowandclicktheshortcut.OneCollectshortcutshouldpopupinthefolder,andthenexttimeyoulogintoWindows,OneCollectautomaticallystartsup.InstallingOneCollectonMacOSXYoucaninstallOneCollectonyourMacOSXsystem.BeforeyoubeginYoumustberunningeitherMacOSX10.10.xorMacOSX10.11.xonyoursystem.Steps1.Browsetothedirectoryinwhichyouhavedownloadedthetar.gzinstaller.2.Extractitbyrunningtartar-xzfonecollect1.0_mac64.tar.gz.Note:IfyouaredownloadingOneCollectusingtheChromebrowser,itautomaticallyextractsintoa.tarfile.Inthiscase,runtar-xfonecollect1.0_mac64.tar.gz.3.Changedirectory(cd)totheextractedfolder.4.Type./onecollect,ifyouhaveadminprivilegesorsudo./onecollect.Ifyoudonothaveadminprivileges,thenpressEnter.InstallingandsettingupOneCollect|9Use‘nohup./onecollect&’torunprocessinthebackground.OneCollectwillstartrunningonport8044.EnsurethattheportisfreebeforerunningOneCollect.DatabasewillbesavedinyourhomedirectoryunderNetApp/onecollect/Dbfolder.Note:Toconfiguretheapplicationtorunonadifferentport,modifyPORTvalueintheCONFIGfilelocatedinthe<user_home_directory>/Netapp/OneCollect/Configandrestarttheapplication(forexample,PORT=8040).TohosttheOneCollectservercentrallytobeaccessedfromremotehosts,youcanedittheconfigfileandappendtheIPaddresstobindtoasprefixtoport(forexample:PORT=0.0.0.0:8044willmakeitopentoallhostsonallIPs.Alternatively,PORT=<dedicated_IP>:8044willmakeitavailableonthespecificIPconfiguredonhost).AfteryoufinishIfyouwanttorunOneCollectautomaticallyduringsystemstartup,performthefollowingsteps:1.ChooseApplemenu>SystemPreferences,andclickUsers&Groups.2.SelecttheuserandclickLoginItems.3.ClicktheAddbutton‘+’underthelistontheright,select‘onecollect’from<install_dir>/onecollect.4.ClickAdd.InstallingOneCollectonLinuxYoucaninstallOneCollectonyourLinuxsystemthroughthecommand-lineinterface.YoumustperformthistaskifyouareinstallingOneCollectforthefirsttime.Beforeyoubegin•YourLinuxhostsystemmustberunningthesupportedsoftwareversions:laterthanRHEL(laterthan6.4),andUbuntu(laterthan12.0).•YoumusthavedownloadedtheOneCollectexecutablebinaryforyourplatform.•Youmusthavethenecessaryprivilegestoinstalltheapplication.Steps1.Browsetothedirectorywhereyouhavedownloadedthetar.gzinstaller.2.Extractitusingtarcommand:tar-xzfonecollect1.0_linux64.tar.gz.Note:IfyouaredownloadingOneCollectusingtheChromebrowser,itautomaticallyextractsintoa.tarfile.Inthiscase,runtar-xfonecollect1.0_linux64.tar.gz.3.Changedirectory(cd)totheextractedfolder.4.Type./onecollectifyouhaveadminprivilegesorsudo./onecollectifyoudonothaveadminprivileges,thenpressEnter.Use‘nohup./onecollect&’torunprocessinthebackground.OneCollectwillstartrunningonport8044.EnsurethattheportisfreebeforerunningOneCollect.DatabasewillbesavedinyourhomedirectoryunderNetApp/onecollect/Dbfolder.Note:Toconfiguretheapplicationtorunonadifferentport,seeInstallingOneCollectonMacOSXonpage9.10|Ifyouarenotinstallingtheapplicationasroot,usesudowhilerunningthecommandsmentionedintheprecedingsteps.AfteryoufinishIfyouwanttorunOneCollectautomaticallyduringsystemstartup,performthefollowingsteps:1.Edittherc.localfile(vi/etc/rc.local).2.AddalineattheendoffiletostarttheOneCollectprocess(nohup/path_to_onecollect/onecollect&).3.Modifythepermissionforrc.local(chmod+x/etc/rc/local)TheOneCollectprocesswillstartupautomaticallyinthenextreboot.EditingdatacollectionpreferencesYoucaneditusersettings—suchastheAutoSupport,collection,encryption,andEmailnotification.AboutthistaskWhenyoumodifythesettings,thechangesareappliedimmediately.Steps1.ClickSettingsontheupper-rightcorner.2.IntheBasicSettingsdialogbox,modifytheappropriatesettings.Ifyouwantto...Then...ModifyAutoSupportsettings—AutoSupportSettingsYoucaneitherenableordisableAutoSupport.ConfigureproxytoaccesstheInternet(forAutoSupportposting).EnableordisableTelnet—CollectionSettingsYoucaneitherenableordisableTelnetacrossalldatacollection(toavoidflags/alertsinasecureenvironment).Setupencryptionoption—EncryptionSettingsYoucansetone-timepassphrasetoencryptsavedcredentialsforthedevice.Setupemailnotification—EmailNotificationYoucanconfigureSMTPtoenableemailnotificationforcompletedjobs.Optionally,youcanenableemailnotificationforscheduledjobs.Theemailwillcontaindetailsaboutthedevicesthatarepartofjob,jobstatus,andparametersthatcouldbeusedtosearchandviewtheOneCollectAutoSupport(ifposted)inSmartSolve.3.ClickSave.InstallingandsettingupOneCollect|11UpgradingOneCollectYoucanupgradetoadifferentversionofOneCollectorreinstallthesameversiononWindows,Mac,orLinuxsystem.YoucanuseoneofthetwooptionsforupgradingOneCollect.AboutthistaskWhenyouupgradeOneCollectandinstallitonyoursystem,youwillgettwooptions:Steps1.SelectoneoftheoptionstoupgradeOneCollectonyourWindowssystem.Ifyouwantto...Then...PerformacleaninstallClickYesforcleaninstallation.Theinstallerwilldeletethedatabaseandperformacleaninstallation.PerformanupgradeClickNotoupgrade.Theinstallerwillretainthedatabasefiles,whichinturnretainstheuserpreferences.2.SelectoneoftheoptionstoupgradeOneCollectonMacorLinuxsystem.Ifyouwantto...Then...Performacleaninstalla.YoumustdeletedatabaseandConfigfilebyrunningrm-rf~\NetApp\OneCollect.b.Deletetheolderinstalldirectory.c.Installthenewversionbyrunning./onecollectfromtheextractedinstallerpackageunder<downloadpath>\NetApp\OneCollect>.Performanupgradea.Deletetheolderinstalldirectory.b.Installthenewversionbyrunning./onecollectfromtheextractedinstallerpackageunder<downloadpath>\NetApp\OneCollect>.12CollectinganduploadingdatafromdevicesusingOneCollectTheOneCollecttoolenablesyoutocollectdiagnostic,SAN,NAS,andperformancedatafromhosts,switches,andstoragesystems.OneCollectprovidesadditionalcontent,whichcanbesentbacktoNetApporanalyzedonpremisestounderstandcustomers'environment.Youcanusethreedifferentprofilestocollectdata.Inaddition,youcanscheduleadatacollectionjob,editthesavedjob,viewthecollecteddata,anduploadthecollecteddatatoAutoSupport.CollectingdatausingOneCollectOneCollectenablesyoutocollectdatafromdifferenttypesofdevicesandsolutions.AboutthistaskUsingOneCollect,youcancollectdatabyconfiguringanewcollectionprofile:•DeviceorComponentBasedprofile:Thishelpsyoucollectdatafromsingleormultiplehomogenous/heterogeneoussetofdevicesthatcouldbestoragecontrollers,switches,orhosts.Youneedtoenterthecredentialsofthedeviceorcomponentforcollectingdata.•DiscoverorImportprofile:Thishelpsyoutoimportafileofthecollecteddatathateitheryousavedonyoursystemoryoureceiveditfromanotheruser.•SolutionBasedprofile:Thishelpsyoucollectdatafromasetofpreconfiguredsolutionstacks.13Collectingdatausingthedevice-basedcollectionmethodYoucancollectdatafromstoragecontrollers,hypervisors,hosts,andswitches(FCandEthernetswitches).Youcanalsocollectdataeitherfromonedeviceormultiplehomogeneousandheterogeneousdevices.Steps1.ClickNewDataCollection.Ifyouwantto...Then...ManuallyenterdevicedetailsAddthecomponentsandchoosethedevicetypeandsubtypeanditsrelevantcredentials.AutomaticallyloaddevicecredentialsfromafileLoaddevicesandbrowseafilethathasdevicedetailsinapredefinedformat(Import_Credentials.csv).ThecsvtemplatecanbefoundintheOneCollectinstalldirectory.Foroptimalperformance,NetApprecommendsaddingamaximumof25devices.2.ClickNexttovalidatetheproject.3.OntheValidatepage,verifywhetherthecredentialsarevalidanddevicesareavailablefordatacollection.4.ClickNexttoviewthesummaryofdevicesfromwhichthedatawillbecollected.YoucanalsoclickViewicontocheckallthecommandsthatwouldberunonthesystemandexcludeanycommandfromthelistbyclearingthecheckboxes.5.ClickSave&CollectifyouwanttosavetheprojectforfuturereferenceorclickCollecttoproceedwithdatacollection.Collectingdatausingthesolution-basedcollectionmethodSolution-basedprofileisapredefinedprofile.Byusingthisprofile,youcanconfiguredatacollectionforsolutions,suchasE-Series,FlexPod,ONTAP7-Mode,andothersolutions.AboutthistaskToperformaminimaldatacollection,youshouldenterthecredentialsforswitch,node,cluster,andserver.Steps1.ClickNewDataCollection.2.ChooseSolutionBasedoption.3.FromtheProfiledrop-downlist,selecttherequiredprofile,forexample,ONTAP.4.FromthePersonadrop-downlist,selectGeneral.FormoreinformationaboutPersonas,seeOverviewofOneCollectonpage4.5.FromtheSubprofiledrop-downlist,selectNetwork.6.Entercredentialsforthesystems.7.Tovalidate,clickNext.14|8.ClickNexttoviewthesummaryofdevicesfromwhichthedatawillbecollected.YoucanalsoclickViewicontocheckallthecommandsthatwouldberunonthesystemandexcludeanycommandfromthelistbyclearingthecheckboxes.9.ClickSave&CollectifyouwanttosavetheprojectforfuturereferenceorclickCollecttoproceedwithdatacollection.CollectingdatausingSerialportYoucanusetheSerialportifyoudonothaveaccesstothecustomer’snetwork.Directaccesstothecontrollerfirmwareisgainedthroughtheserialport.ItappearsintheSolution-basedprofile.Steps1.ConnectSerialportsfromONTAPsystem(optionallyswitches)tothelaptop