1、NetAppx1.2DataONTAP-vAdministrationToolCommandReferenceoo)c 7co* olo Oc”传 01温 0010 10NetApp, Inc.495 East Java Drive Sunnyvale, CA 94089 U.S.Part number: 215-08017_A0May 2013Telephone:+1(408)822-60Fax:+1(408)822-4501Supporttelephone:+1(888)463-8277Web:Feedback:doccommenisTableofContents3ContentsUsin
2、gtheDataONTAP-vadministrationtool5Availablecommandsandcommandcategories5Command-lineinterfaceusage7Viewingcommandhistory7Usingthecommand-lineeditor7Gettinghelponcommands8Accessingcommandhierarchylevels9Executingmultiplecommandsfromafile11Command-lineerrorfunctionality12DataONTAP-vadministrationtoolc
3、ommands14exit14help15history16host16hostshow17networkshow19pdiskshow20poolcreate21pooldestroy22poolshow23source24sshsetup25sshstatus26status27supportshow28up29vmconfigbackup30vmconfigremove31vmconfigrestore32vmconfigshow33vmconsoleconnect34vmconsoledisconnect36vmconsolelogclear37vmconsolelogshow38vm
4、coredump39vmcreate40vmdestroy43vmdiskcreate44vmdiskdestroy45vmdiskshow46vmheadswap48vmlogsave49vmlogshow50vmmonitorlogclear51vmmonitorlogshow52vmmonitorshow54vmmonitorstart55vmmonitorstop56vmnetworkconnect57vmnetworkshow58vmpropset/unset59vmpropshow63vmrestart64vmsavecore66vmserialshow67vmsetup68vms
5、how69vmstart71vmstateshow72vmstop73vmuuidshow75DataONTAP-vadministrationtoolerrorreturncodes76Errorcodelist76Copyrightinformation80Trademarkinformation81Howtosendyourcomments82Index83USingtheDataONTAPvadministrationtoolTheDataONTAP-vadministrationtool(dvadmin)providescommandsforinstallingandmanaging
6、DataONTAP-v-basedstoragesystems,suchastheDataONTAPEdgefamilyofstoragesolutions.Thismanualprovidesadetaileddescriptionofallthedvadmincommands.Secthefollowingmanualsforinformationaboutproductinstallationandusageinstoragesystemenvironments:DataONTAP-vAdministrationToolInstallationGuide-Describeshowtoin
7、stalltheDataONTAP-vInstallervirtualmachine.Thisvirtualmachinecontainsthedvadminsoftwareinaneasy-to-installpackagedvirtualmachine.DataONTAPEdgeInstallationandAdministrationGuide-DescribeshowtoinstallandmanageDataONTAPEdgestoragesystemsusingdvadmin.AvailablecommandsandcommandcategoriesTheCLIcommandsar
8、eusedtoperformanactiononaDataONTAPEdgesystemoronthehostserver.SeeDataONTAP-vadministrationtoolcommandsonpage14forcompletedetailsonthesecommands.Thistableliststheavailablecommandcategoriesandprovidesabriefdescriptionoftheirfunctionalities:CommandDescriptionexitExitthedvadminsessionhelpShowpossiblecom
9、mandsandusagedetailshistoryShowcommandhistoryhostConnectdvadmintoaspecificESXhostnetworkDisplaynetworksavailabletotheserverpdiskDisplayphysicaldisksavailabletotheserverpoolCreate,destroy,andshowse,erstoragepoolssourceExecutedvadmincommandsfromafilesshDisplay,orenable,SSHconnectivitytotheESXhostforco
10、refilecreationstatusDisplaydvadminstatusinformationCommandDescriptionsupportDisplaydetailedinformationaboutthehostservernetworks,disks,andvirtualmachinesUPGouponelevelwheninacommandshellvmconfigCreateabackupofDataONTAPEdgeconfigurationinformation,restoreabackup,showavailablebackups,andremoveoldbacku
11、psvmconsoleConnecttotheDataONTPsystemconsole,disconnect,andshowtheconsolelogvmcoredumpForcesacoredumpfortheDataONTAPEdgestoragesystemvmcreateCreateorinstalltheDataONTAPEdgesystemvmdestroyDeletetheDataONTAPEdgesystemvmdiskCreate,destroy,andshowDataONTAPEdgevirtualdatadisksvmheadswapReassigndatadisksf
12、romoneDataONTAP-vvirtualmachinetoanotherforaheadswapprocedure.vmlogShowandsavetheDataONTAP-vvirtualmachinesystemlogvmmonitorStartandstoptheDataONTAP-vvirtualmachinemonitor,showthemonitorstatus,andshowthemonitorlogvmnetworkDisplayDataONTAP-vvirtualmachinenetworks,andconnectaDataONTAPEdgenetworkadapte
13、rtoanetworkvmpropSet,change,andshowDataONTAPEdgeconfigurationpropertiesvmrestartRestartarunningDataONTAPEdgesystemvmsavecoreExtractthecontentsofanunsavedcoredumpandsaveittoacoredumpfilevmserialDisplayDataONTAP-vvirtualmachineserialportsvmsetupStarttheVMsetupwizardtocreateaDataONTAPEdgestoragesystemv
14、mshowDisplayDataONTAPEdgeconfigurationdetailsvmstartStartastoppedDataONTAPEdgesystemvmstateDisplaytheDataONTAPEdgeconfigurationstatevmstopStoparunningDataONTAPEdgesystemvmuuidDisplaytheDataONTAP-vvirtualmachineUUIDCommand-lineinterfaceusageTheDataONTAP-vadministrationtoolprovidesseveralfeaturestoass
15、istyouwhenenteringcommandsonthecommandline.Whenenteringcommands,beawareofthefollowinggeneralrules:Ifyouareenteringacommandwithanelementthatincludesaspace,youmustquotethatelement.Forexample,poolcreatemainpool1disk_abc Specialcharactersandnon-Englishcharactersarenotsupported. Donotusea#characterinthec
16、ommandstring.The#charactermeansthattherestofthelineiscommentedout,sodvadminwillignoreanyinformationfollowingthe#. Usetheexitcommandtoexitthedvadmininterfaceanddisconnectfromthehostserver.(NotethatthisdoesnotaffecttheoperationalstateoftheDataONTAP-vvirtualmachine.)ViewingcommandhistoryThehistoryfeatu
17、reenablesyoutoviewrecentlyenteredcommands.Step .Dooneofthefollowing:Then.Press the Up arrow key or press Ctrl-P.Press the Down arrow key or press Ctrl-N.Enter the history command.Ifyouwantto.ScrollbackwardthroughcommandsScrollforwardthroughCOtnmands1.istthecompletehistoryofenteredcommandsUsingthecom
18、mand-lineeditorThecommand-lineeditorenablesyoutopositionthecursoranywhereinapartiallytypedcommandandinsertcharactersatthecursorposition.Step1.Usetheapplicablekeycombinationtomovethecursorwithinthesamelineandeditthecommand:Ifyouwantto.Thenpress.MovethecursorrightonepositionCtrl-fortheRightarrowkeyIfy
19、ouwantto.Thenpress.MovethecursorleftonepositionCtrl-bortheLeftarrowkeyMovethecursortotheendofthelineCtrl-eMovethecursortothebeginningofthelineCtrl-aDeleteallcharactersfromthecursortotheendofthelineCtrl-kDeletethecharactertotheleftofthecursorandmovethecursorleftoneCtrl-hpositionDeletethelineCtrl-uDel
20、eteawordCtrl-wReprintthelineCtrl-rAbortthecurrentcommandCtrl-cGettinghelponcommandsYoucanusethehelpcommandtodisplaythelistofavailablecommands,orthecommandsyntaxforaparticularcommand.AboutthistaskThefontsandsymbolsusedinthehelpsyntaxareasfollows:,keywordspecifiesthenameofacommandoranoptionthatmustbee
21、nteredasshown. (lessthan,greaterthansymbols)specifythatyoumustreplacethevariableidentifiedinsidethesymbolswithavalue. I(pipe)indicatesyoumustchooseoneoftheelementsoneithersideofthepipe. (brackets)indicatethattheelementinsidethebracketsisoptional. (braces)indicatethattheelementinsidethebracesisrequir
22、ed.Step1. Forcommandhelp,enterhelpcommandcommandisthenameofacommandonwhichyouwanthelp.Ifyoudonotspecifyacommand,helpdisplaysalistofallDataONTAP-vadministrationtoolcommandsavailablefromthecurrentlocation.ExamplehelpcommandoutputThefollowingexampleshowsthecommandsyntaxandabriefdescriptionforthepoolcre
23、atecommand. helppoolcreatepoolcreateCreateaVMFSstoragepoolThefollowingexampleshowsthecommandsyntaxforthevmdiskcreatecommand. helpvmdiskcreatevmdiskcreatesizeCreatevirtualmachinediskAccessingcommandhierarchylevelsdvadminprovidestheabilitytoenterlevels(orshells)withinthecommandhierarchytoassistwhenent
24、eringcommandsonthecommandline.AboutthistaskThisisusefulwhenyouintendtoentermanycommandsataparticularlevel.Forexample,ifyouplanonissuingmanycommandsforaparticularDataONTAPEdgesystem,youcanenterthe,vm,commandlevelsothatyoudonotneedtoentertheDataONTAPEdgesystemnameforeachcommand.Steps1. Toenterthecomma
25、ndhierarchylevelforaparticularDataONTAPEdgesystem,entervmvm_nameThepromptchangestothenameofthespecifiedDataONTAP-vvirtualmachine.2. Toexitthecommandhierarchyandreturntothelevelthatisonelevelabovethat,entertheupcommand.ExamplesofusinghierarchylevelsThefollowingexampleshowshowtoenterthehostcommandhier
26、archylevel.dvadminThefollowingexampleshowshowtoenterthevmcommandhierarchylevelfortheDataONTAPEdgesystemnamedndotv,.config backup remove restore showconsoleconnect disconnectsession logclear showcoredump create destroy diskcreate destroy showexit headswap help history logsave showmonitor logclear sho
27、wshow start stop network connect showprop set show unset restartdvadminvmdotvldvadminvmdotvlAfterthispoint,everycommandyouissueisaddressedtothespecificDataONTAPEdgesystem.Forexample,ifyouwanttoshowallthevirtualdisksonthisstoragesystem,enterdiskshow.Ifyouwereatthemainpromptyouwouldneedtoentervdisksho
28、wdotvl.ThefollowingexampleshowstheoutputofthehelpcommandonlywhenattheDataONTAP-vlevel.dvadminvmdotvlhelpManipulateaVM,sDataONTAPconfigurationBackuptheVM,sDataONTAPconfigurationRemovethenamedbackupconfigurationRestoretheVM,sDataONTAPconfigurationDisplaybackedupDataONTAPconfigurationsInteractwiththeDa
29、taONTAP-vsystemconsoleConnecttotheDataONTAP-vsystemconsoleDisconnectanotherDataONTAP-vconsoleManipulateDataONTAP-vconsolelogfile(s)ClearcurrentconsolelogandrotateoldlogsPrinttheDataONTAP-vsystemconsolelogCausethevirtualmachinetodumpcoreCreateDataONTAP-vvirtualmachine.DeletevirtualmachineManipulatevi
30、rtualmachinedisksCreatevirtualmachinediskDestroyvirtualmachinediskDisplayvirtualmachinedisksExitinterpreterReassignconfigurationfromoneVMtoanotherShowpossiblecommandsandusagedetailsShowcommandhistoryAccessDataONTAP-vsystemlogfileSavetheDataONTAP-vsystemlogtoafilePrinttheDataONTAP-vsystemlogControlvi
31、rtualmachinemonitormonitorsManipulateVMmonitorlogsClearcurrentmonitorlogandrotateoldlogsDisplaythelogforaVMmonitorShowinformationaboutVMmonitor(s)StartaVMmonitorStopaVMmonitorVirtualmachinenetworkcommand(s)ConnectvirtualmachinenetworkinterfaceDisplayvirtualmachinenetworkinterfacesManipulatevirtualma
32、chinepropertiesSetvirtualmachineproperties.DisplayvirtualmachinepropertiesUnsetvirtualmachinepropertiesRestartarunningvirtualmachinesavecore serialshow setup show source start stateshow status stop UP UUidshowSavethevirtualmachinecorefileManipulatevirtualmachineserialportsDisplayvirtualmachineserial
33、portsStarttheVMsetupwizardDisplayvirtualmachinedetailsExecutecommandsfromafileStartrunningavirtualmachineVirtualmachinestatecommand(s)DisplayvirtualmachinestateDisplaydvadminstatusinfoStoparunningvirtualmachineGouponelevelManageVMUUIDDisplayVMUUIDExecutingmultiplecommandsfromafileYoucanexecutemultip
34、ledvadmincommandsfromafileusingthesourcecommand.Thisenablesyoutoperformbatch-typeoperationsformulti-stepfunctionsthatyourunfrequently.AboutthistaskThesourcecommandwillreadandexecutecommands(oneperline)fromthespecifiedfileandthenreturntothecommandprompt.Ifanerroroccursduringexecutionofanyofthecommand
35、s,dvadminwillexitatthatpointandreturnaspecificerror.Notethatdvadminignoreslinesthatstartwithandthatyouneedtoputquotationmarksaroundanypropertiesthatincludespaces.Youcanusethe-kor-keep-goingoptiontocontinueexecutingallcommandswithinafileevenifanerrorisencountered.Inthiscase,thecommandreturnstheCmdFai
36、lederrorcode(15)toinformyouthatoneormoreerrorswereencounteredduringthecommandexecution.Youcanredirecttheoutputofthiscommandtoafiletocapturetheindividualerrorsthatoccurredduringexecution.Steps1. Createafilethatcontainsthecommandsyouwanttoexecute.Forexample,thefilestartsystem.txtcontainsthefollowingco
37、mmands:#thisscriptwillsetONTAPpropertiesandstarttheDataONTAP-vVM年addsomeDataONTAPpropertiesvm prop set vm prop set vm prop set vm prop set vm prop setdotvltmz=America/New_Yorkdotvldns_domainname=dotvldns_ipaddr=10.97.0.llz10.97.0.15#start the VM monitordotvlnis_domainname=dotvlnis2ipaddr=17.19.4.20,
38、17.19.3.11vmmonitorstartdotvlfstarttheDataONTAP-vVMvmstartdotvl2. Atthedvadminprompt,enterthefollowingcommand:sourceStartsystern.txtThecommandsareexecutedinthespecifiedordertocreateandstarttheDataONTAPEdgesystem.ExampleoutputfromrunningthesourcecommandThefollowingcommandconfiguresandstartsvirtualmac
39、hinedotv,:sourcestartsystem.txtSettmz=America/New_YorkSetdns-domainname=Setdns二ipaddr=10.97.0.11,10.97.0.15Setnis_domainname=Setnis_ipaddr=17.19.4.20,17.19.3.11VmmonitorfordotvlisrunningstartVMdotvlCommand-lineerrorfunctionalityAlldvadmincommandsreturnoneormoregenericerrorsifconditionswarrant.Additi
40、onally,somecommandscanalsoreturncommand-specificerrorinformation.dvadmin,orthecommanditselfreturnsoneofthegenericerrorcodesspecifiedbelow:InternaIErr-ifthecommandencounteredaninternaldvadminerror.InternalerrorsshouldbereportedtoNetApp.CmdNotFound-ifthespecifiedcommandwasnotfoundCmdFaiIed-ifanerroris
41、encounteredwhenattemptingtoexecutethecommandUsageErr-ifrequiredcommandargument(s)werenotspecified,oriftoomanyargumentswerespecifiedInvaIidArg-ifaspecifiedargumentwasinvalid,TaskInProgressErr-iftheESXserveriscurrentlybusywithanothertaskAlongwiththeerrorcode,itdisplaysamessagethatprovidesmoredetailoft
42、heactualcauseforfailure.SeeDataONTAP-vadministrationtoolerrorcodesonpage76forthefulllistofgenericandspecificerrorsthatcanbereturned.ErrorcodeexampleIfyouenterthenameoftheDataONTAPEdgesystemincorrectly,youwillreceivethestandardInvaIidArgerrorplusadditionalinformationaboutwhichargumentisinvalid,asshow
43、nbelow:vmdiskshowdotv13InvalidArg:invalid-noVMnamed,dotv,usage:vmdiskshow_DisplayvirtualmachinedisksDataONTAP-vadministrationtoolcommandsTheavailabledvadmincommandsarclistedalphabeticallyinthischapter.Errorsthatcanbereturnedfromeachcommandarelistedwiththecommand.SeeDataONTAP-vadministrationtoolerror
44、returncodesonpage76formoredetails.exitTheexitcommandterminatesthedvadminsessionanddisconnectsfromthehostserver.SyntaxexitDescriptionTheexitcommandexitsthedvadmininterfaceanddisconnectsfromthehostserver.TerminatingdvadmindoesnotaffecttheoperationalstateoftheDataONTAP-vvirtualmachine,nordoesitaffectru
45、nningdvadminmonitors.ParametersNoneReturnederrorsNoneExample:ExitingtheDataONTAP-vadministrationsessionThefollowingexampleexitsdvadminandreturnstothehostserverprompt:dvadminexit1.oggingoutAdministratorQDoyouwanttousesavedlogininformation(AdministratorSerV)?yes:YoucanpressEntertologbackintothesameDat
46、aONTAP-vstoragesystem,orpressCtrl-toendthesession.helpThehelpcommanddisplaysthelistofavailablecommands,orthecommandsyntaxforaparticularcommand.SyntaxhelpcommandDescriptionThehelpcommanddisplaysthelistofcommandsavailablefromthecurrentlocation.Itcanalsobeusedtodisplaytheavailableoptions,orsyntax,foraspecificcommand.ParameterscounandThenameofacommandforwhich
