You are on page 1of 6

SYMCLICommandLineExamples

Tochecksymcliversionsymcli
TocheckMicrocodeversionsymcfglist
TochecktheBuildversionofmicrocodesymcfglistv

TochecktheFA'sonthesymmetrixsymcfgsid1234faalllist

TochecktheFAconnectivitystatussymcfgsid1234faalllistport
Note:(X):FibrePortisConnectedtoaFibrePort(HBA,SwitchorRFDirector)
():FibrePortisNotConnected.

TocheckthewwnofanFAport
symcfgsid1234fa5ep0list

TocheckbothwwpnandwwnofanFAport
symcfgsid1234fa5ep0listv
Note:ForaVMAXarraywwnnisthesameforallFAportsandwwpnisunique.,whereasinaDMXarraybothwwpn
andwwnnisthesameforeveryFAport

ToviewPortFlags
Youcandisplaythepossibleportflagsandtheircurrentstatuswiththefollowing
commandsymcfgsid1234fa5ep0listv
Thefollowingisapartialexampleofoutput:

SCSIFlags
{
Negotiate_Reset(N):Disabled
Soft_Reset(S):Disabled
Environ_Set(E):Disabled
HP3000_Mode(B):Disabled
Common_Serial_Number(C):Enabled
Disable_Q_Reset_on_UA(D):Disabled
Sunapee(SCL):Disabled
Siemens(S):Disabled
Sequent(SEQ):Disabled
Avoid_Reset_Broadcast(ARB):Disabled
Server_On_AS400(A4S):Disabled
SCSI_3(SC3):Enabled
SPC2_Protocol_Version(SPC2):Enabled
SCSI_Support1(OS2007):Enabled
WP_Bypass(WPBP):Disabled
}

FibreSpecificFlags
{
Volume_Set_Addressing(V):Disabled
Non_Participating(NP):Disabled

Unique_WWN(UWN):Enabled
Access_Logix(ACLX):Enabled
OpenVMS(OVMS):Disabled
AS400(AS4):Disabled
Auto_Negotiate(EAN):Enabled
VNX_Gateway_Direct_Attach:Disabled
}

Toenable/disableFAflagsusethefollowingsyntax
Example:IfyouwanttoenableSCSI3protocolonFA5e:1Createafileandaddthebelowline
andthenrunsymconfigurepreviewandcommitsetport05E:1SCSI_3=enable

CertainFAflagslikeSPC2,VbitneedtheFAporttobeofflinedfirstbeforeenabling/disabling
theflag
ToofflineanFAportsymcfgsid1234fa5ep0offline
ToenableSPC2protocolsetport05E:1SPC2_Protocol_Version=enable

Tolistusedandunuseddevices(boththinandthickdevices)
symdevsid1234list
Note:The3rdcolumnshowsthestateofthedeviceswhetheritsfreeornot(???:?denotesthatthedeviceisfree,
***:*meansthedeviceismappedtomultipleFAports,6G:1meansthedeviceismappedtoFAport6G:1).00A4is
theVCM(ACLX)devicewhichholdsallthemaskinginformationitiswritedisabled.

Tolistonlythindevicesaddthetdevoption
symdevsid1234listtdev

Tolistfreeandunusedtdevsaddthenoportoption
symdevsid1234listtdevnoport

Tolistfreetdevsnotboundtoanythinpooladdtheunboundoption
symdevsid1234listtdevnoportunbound
Note:NRmeansNotReady(thedeviceisnotboundtoathinpool)

ViewingThinPools
Todisplayallpools,usethesymcfglistcommandwiththeSymmetrixID,asshowninthe
followingexamplecommandandoutput:
symcfgsidxxxxlistthinpooldetailtb

TheVirtualProvisioningpooloutputhasthefollowingadditionalinformationinitthatisparticularly
relevantforthindevicesandthindevicepools:
TotalMBsIndicatesthetotalcapacityofthepool.ThisincludesthesumoftheenabledanddisabledDATAdevices
inthepool.
EnabledMBsShowsthetotalcapacityoftheenabledDATAdevicesinthepool.
AllocMBsShowstheamountofspacethathasbeenallocatedtothindevicesboundtothispool.
Alloc%Showsthepercentageofspacethathasbeenallocatedinthepool.
Subs%Standsforsubscribedpercentage.Thisindicatestheratioofthecapacityofthethindevicesthatarebound
tothispoolwithrespecttothetotalenabledcapacityofthispool.Theratioisexpressedasapercentage.

Thiscommandgivesyoudetailedinformation.aboutthindevicesanddatadevices.Displays
Enableddatadevs,howmuchspacehasbeenallocatedaswellasthindevicesineachpool.Also
displaysthinpoolmetricslikePoolReservedcapacity(PRC,Subscriptionratio,Raidlevel,
Rebalancevarianceetc.

Displaylocksonthesymmetrixsymcfgsid1234listlocknall

Toreleasethelocksymcfgsid1234releaselockn15force

Tolistallthindevicesandalsotheirassociatedthinpools(QuiteUsefulCommand)symcfgsid
xxxxlisttdevgbdetail

Thesymcfglisttdevcommandcanbeusedtomonitortheprogressofspacereclamation.The
followingisanexampleoutputshowingthindevicesthatareintheprocessofbeingreclaimedto
freeupunwrittenallocatedspaceasaresultofusingthesymconfigurefreecommand.Thedevice
statusofReclaimingindicatesthatthethindevicesareintheprocessofbeingreclaimed.The
allocatedtracksandwrittentracksadjustaccordinglyasthespaceisreclaimed.

symcfgsid2466listtdevpoolTIER1thin|more

SymmetrixID:000192602466

EnabledCapacity(Tracks):1209575088
BoundCapacity(Tracks):1188481020

SYMMETRIXTHINDEVICES

PoolPoolPool
DevTotalSubsAllocatedWritten
SymPoolNameEmulTracks(%)Tracks(%)Tracks(%)Status

0274TIER1FBA552120055213201190170Bound
0275TIER1FBA55212005521320476140Bound
0276TIER1FBA55212005521320606690Bound

Total
Tracks118848102098114276871294737635466

AllocatedTracksThenumberoftracksthathavebeenallocated(andhencethesemanytrackshavebeenusedfrom
thedatapooltowhichthisthindevicebelongs).
WrittenTracksThenumberoftracksonwhichdatahasactuallybeenwritten.Whenauserattemptstowritedatato
athindevice,tracksareallocatedinchunks.However,alltheallocatedtracksmaynothavedatawrittenonthem.This
columnindicatesthenumberoftracksonwhichdatahasbeenwritten.

Monitoringadevicepool
Tomonitoradevicepoolsusage,thesymcfgmonitorcommandhasbeenadded,asfollows
symcfgsidxxxxmonitorthinpoolVP_TIER_SATA

DataDeviceexamples:
ThefollowingexamplereturnsalistofDATAdevicesforaspecificSymmetrixarray:
symcfgsid1234listdatadev

SymmetrixID:000192601234

SYMMETRIXDATADEVICES

DevDevPoolTotalUsedFull
SymEmulConfigTypePoolNameStateTracksTracks(%)

00D7FBARAID5(7+1)THTIER1Ena39399843939984100
00D8FBARAID5(7+1)THTIER1Ena39399843939984100
00D9FBARAID5(7+1)THTIER1Ena39399843939984100
00DAFBARAID5(7+1)THTIER1Ena39399843939984100
09F3FBARAID5(7+1)Dis393998400
09F4FBARAID5(7+1)Dis393998400
09F5FBARAID5(7+1)Dis393998400
09F6FBARAID5(7+1)Dis393998400
09F7FBARAID5(7+1)Dis393998400
09F8FBARAID5(7+1)Dis393998400
09F9FBARAID5(7+1)Dis393998400

Total
Tracks1871877136173169189671

ThedisplayedoutputcanbefilteredfurtherusingthenonpooledoptiontoshowonlytheDATAorSAVEdevicesthatarenot
associatedwithapool,andtheRANGEoptiontodisplayonlyarangeofdevices.

symcfgsid1234listdatadevnonpooled

SymmetrixID:000192601234

SYMMETRIXDATADEVICES

DevDevPoolTotalUsedFull
SymEmulConfigTypePoolNameStateTracksTracks(%)

0998FBARAID5(7+1)Dis393998400
0999FBARAID5(7+1)Dis393998400

Creatingthinpools
ThinpoolscanbecreatedatthesametimeascreatingtheDATAdevices.InmostcasesData
devswillbecreatedbyEMCengineers.Youcanaddthedatadevstotheappropriatethinpools.

Tocreateathinpool,usethefollowingform:
createpoolPoolName,type=thin
[,max_subs_percent=<n>]
[,rebalance_variance=n],

[,pool_resv_cap=n]
[,vp_compression=<ENABLE>]

Where:
typeSpecifiesthetypeofdevicepool.SnappoolsareforTimeFinder/Snapoperations,SRDF/ADSEpoolsareforSRDF/A
operations,thinpoolsareforVirtualProvisioningoperationswiththindevices.
PoolNameSpecifiesthenameofthedevicepool.Itcanbefrom1to12alphanumericcharacterslongandincludehyphens(
),andunderscore(_)characters.
max_subs_percentSpecifiesthemaximumtotalcapacitythatcanbeboundtothepool.Thiscanhaveavaluebetween0and
65534.Avalueof100indicatesthatthetotalcapacityofthethindevicesboundtoapoolcannotexceed100percentof
theactualcapacityofthepool.Avalueof200indicatesthatthetotalcapacityofthethindevicesboundtoapoolcannotexceed
twicetheamountoftheactualcapacityofthepool.
Avalueof1willallowonlyamaximumthincapacitythattotals1/100ththeactualphysicalcapacityofthepool.Thelargest
number65534indicatesthatthetotalcapacityofthethindevicesboundtoapoolcanbe65534percentofthetotal
physicalcapacityofthepool.
rebalance_varianceSpecifiesthevalue(in%)forthepoolRebalanceVariance.Itcanbesetintherangeof1to50.The
defaultvalueis1.
max_dev_per_rebalance_scanSpecifiesthemaximumlimit(in%)forthepoolrebalancescandevicerange.Itcanbesetin
therangeof2to1024.Itsdefaultvalueis256.
pool_resv_cap(FASTuseonly)Thepoolreservedcapacity(PRC)isapercentageofthecapacityofthevirtualpoolthatwill
bereservedfornonFASTactivities.Ifthe
freespaceinthispool(asapercentageofpoolenabledcapacity)fallsbelowthePRC,theFASTcontrollerdoesnotmoveany
morechunksintothepool.ValidPRCvalues
rangefrom1to80percent.

Note:PRCvaluessetatthepoolleveloverrideanygloballysetPRCvalues

Thinpoolrestrictions
Thefollowingrestrictionsapplytothinpools:
ThelastDATAdevicecannotberemovedfromapoolifthepoolisenabledforcompression.
DATAdevicepoolsmusthavethesamedisktype(EFD,FC,SATA).

DATAdevicescreatedfromexternalprovisioningcanonlybeaddedtopoolsofdevicescreatedfromexternal
provisioning.
AthinpoolcanonlycontainDATAdeviceswithoneemulationtype.Thepoolitselfisnotdefinedtobeapoolforan
emulationtype.Instead,thefirstDATAdeviceaddedtothethinpooldefinesitsemulationtype.
AllDATAdevicesinathinpoolmusthavethesameprotection.Forexample,ifathinpoolhasthefirstDATAdevice
definedasa2WayMir,allsubsequentaddedDATAdevicesmustbe2WayMirdevices.
ADATAdeviceofaspecificprotectionandemulationcanbeputonlyintoanemptythinpool,orintoapoolthatonly
containsDATAdevicesthathavethesameprotectionandemulationtype.
ADATAdevicecanonlyberemovedfromathinpoolifitisdisabledandhasnousedtracksonit.
DATAdevicescannotbedisabledandmovedfromathinpoolinthesamesession.

Ifthetotalpoolcapacityneededtostoreexistingthindevicedatawillbeinsufficientasaresultofadisabledev
SymDevStart:SymDevEndcommand,noneofthedevicesintherequestedrangewillbedisabled.

CreatingThindevicesandBindingtothinPools.
Thindevicesaredevicesthatmayormaynothavestorageallocatedtothemwhentheyarecreated.Toahostoperatingsystem,
theylooklikeregulardeviceswiththeirconfiguredcapacity.Thehosttreatsthemasregulardevicesandwritesandreads
fromthesedeviceslikeregulardevices.Useacommandfile(symconfigure)tocreatethindevices.SolutionsEnablerV7.3
andhighersupportsallocatingpersistenttracksduringthecreationofathindevice,bindingathindevicetoapool,andduring
theallocationofathindevice.Inaddition,reclaimingallocatedpersistenttracksisalsosupported.

Thesyntaxrelatedtocreatingthindevicesisshownbelow:
createdevcount=n,
size=n[MB|GB|CYL],
emulation=EmulationType,
config=DeviceConfig
[,remote_config=DeviceConfig,
[,bindingtopool=PoolName
[preallocatesize=<ALL|n[MB|GB|CYL>]
[allocate_type=persistent]]
[remote_pool=PoolName]]
Where:
createdevcountSpecifiesthenumberofthindevicesyouarecreating.
size=n[MB|GB|CYL]Specifiesthesizeofeachthindevice.IfMBorGBisnotspecified,thesizedefaultstocylinders.
emulationIndicatesFBA,CKD3390,orAS/400D910_099devices.
Note:ThinCKDdevicesrequireEnginuityV5876orhigher.
configSpecifiesTDEV(localthindevice),RDF1+TDEV(localSRDFthindevice),RDF2+TDEV(remoteSRDFthindevice),or
BCV+TDEV.
remote_configSpecifiesRDF2.Theremote_configoptionisonlyusedwhencreatingbothlocalandremoteSRDFthin
devices.
bindingtopoolSpecifiesthenameofthelocalthinpool.
preallocatesizeSpecifiestheamountofspacepreallocatedtothedevices.
Theamountofspacemustbelessthanorequaltotheavailablespaceinthepoolandlessthanorequaltotheallocatedsizeof
thethindevice.
Note:IfyouarerunningSolutionsEnablerV7.3,orhigher,usethepreallocateALLoption,whichistheentiredevice.
allocate_typeAnoptionalparameterthatcanbespecifiedalongwiththepreallocate_sizeoption.Withthisoption,the
allocationsareunaffectedbyanyreclaimoperations,aswellasclone,snap,orSRDFcopyoperations.Ifitisnotsupplied,
symconfigurewillpreallocatenonpersistenttrackswhichcanbereclaimedwithoutanyadditionalreclaimflags.

Note:Toremovethepersistentallocation,unbindthethindeviceorexecuteasymconfigurestartreclaimondevcommandwith
apersistenttypequalifier.
remote_poolSpecifiesthenameoftheremotethinpool.
Restrictionswhenpreallocatingthesize
IftheALLoptionisused,thedevicesizemustbelessthanorequaltotheavailablespaceinthepool.
Ifaspecificpreallocatesizeismentioned,thespacemustbelessthanorequaltotheavailablespaceinthepoolandless
thanorequaltothespecifiedsizeofthethin
device.IfMBorGBisnotspecified,cylindersareusedbydefault.
Thepreallocatesizecanonlybespecifiedwhenthenewlycreateddeviceisalsobeing
boundtoapool.