6.0

Table Of Contents
Getting Started with vSphere Command-Line Interfaces
94 VMware, Inc.
Using the Reclaim Troubleshooting Command
Theesxcli storage core claiming reclaimtroubleshootingcommandisintendedforPSAplugin
developersoradministratorswhotroubleshootPSAplugins.Thecommandproceedsasfollows.
Attemptstounclaimallpathstoadevice.
Runstheloadedclaimrulesoneachoftheunclaimedpathstoreclaimthosepaths.
Itisnormalforthiscommandtofailifadeviceisinuse.
Unclaiming Paths or Sets of Paths
Theesxcli storage core claiming unclaimcommandunclaimsapathorsetofpaths,disassociating
thosepathsfromaPSAplugin.Thecommandsfailsifthedeviceisinuse.
Youcanunclaimonlyactivepathswithnooutstandingrequests.YoucannotunclaimtheESXiUSBpartition
ordeviceswithVMFSvolumesonthem.It
isthereforenormalforthiscommandtofail,especiallywhenyou
specifyapluginoradaptertounclaim.
Unclaimingdoesnotpersist.Periodicpathclaimingreclaimsunclaimedpathsunlessclaimrulesare
configuredtomaskapath.SeethevSphereStoragedocumentationfordetails.
I
MPORTANTThereclaimcommandunclaimspathsassociatedwithadevice.
YoucannotusethecommandtoreclaimpathscurrentlyassociatedwiththeMASK_PATHpluginbecause
--deviceistheonlyoptionforreclaimandMASK_PATHpathsarenotassociatedwithadevice.
Youcanusethecommandtounclaimpathsforadevice
andhavethosepathsreclaimedbytheMASK_PATH
plugin.
Options Description
--device <device>
-d <device>
Nameofthedeviceonwhichallpathsarereclaimed.
--help Displaysthehelpmessage.
IMPORTANTTheunclaimcommandunclaimspathsassociatedwithadevice.Youcanusethiscommandto
unclaimpathsassociatedwiththeMASK_PATHpluginbutcannotusethe‐‐deviceoptiontounclaimthose
paths.
Options Description
--adapter <adapter>
-A <adapter>
If--typeissettolocation,specifiesthenameoftheHBAforthepathsthatyouwant
tounclaim.Ifyoudonotspecifythisoption,unclaimingrunsonpathsfromall
adapters.
--channel <channel>
-C <channel>
If--typeissettolocation,specifiestheSCSIchannelnumberforthe
pathsthatyou
wanttounclaim.Ifyoudonotspecifythisoption,unclaimingrunsonpathsfromall
channels.
--claimrule-class <cl>
-c <cl>
Claimruleclasstouseinthisoperation.YoucanspecifyMP(Multipathing),Filter,or
VAAI.Multipathingisthedefault.FilterisusedonlyforVAAI.Specifyclaimrulesfor
bothVAAI_FILTERandVAAIplugintouseit.
--device <device>
-d <device>
If--typeissettodevice,attemptstounclaimallpathstothespecifieddevice.Ifthere
areactiveI/Ooperationsonthespecifieddevice,atleastonepathcannotbeunclaimed.
--driver <driver>
-D <driver>
If--typeisdriver,unclaimsallpathsspecified
bythisHBAdriver.
--lun <lun_number>
-L <lun_number>
If--typeislocation,specifiestheSCSILUNforthepathstounclaim.Ifyoudonot
specify--lun,unclaimingrunsonpathswithanyLUNnumber.
--model <model>
-m <model>
If--typeisvendor,attemptstounclaimallpathstodeviceswithspecificmodel
information(for
multipathingplugins)orunclaimthedeviceitself(forfilterplugins).If
thereareactiveI/Ooperationsonthisdevice,atleastonepathfailstounclaim.