profileswww.avtt3.com

SunMicrosystems,Inc.
www.
sun.
comSubmitcommentsaboutthisdocumentat:http://www.
sun.
com/hwdocs/feedbackSunStorageTekCommonArrayManagerCLIGuideRelease6.
2.
0PartNo.
820-5748-10October2008RevisionACopyright2008SunMicrosystems,Inc.
,4150NetworkCircle,SantaClara,California95054,U.
S.
A.
Allrightsreserved.
SunMicrosystems,Inc.
hasintellectualpropertyrightsrelatingtotechnologythatisdescribedinthisdocument.
Inparticular,andwithoutlimitation,theseintellectualpropertyrightsmayincludeoneormoreoftheU.
S.
patentslistedathttp://www.
sun.
com/patentsandoneormoreadditionalpatentsorpendingpatentapplicationsintheU.
S.
andinothercountries.
Thisdocumentandtheproducttowhichitpertainsaredistributedunderlicensesrestrictingtheiruse,copying,distribution,anddecompilation.
NopartoftheproductorofthisdocumentmaybereproducedinanyformbyanymeanswithoutpriorwrittenauthorizationofSunanditslicensors,ifany.
Third-partysoftware,includingfonttechnology,iscopyrightedandlicensedfromSunsuppliers.
PartsoftheproductmaybederivedfromBerkeleyBSDsystems,licensedfromtheUniversityofCalifornia.
UNIXisaregisteredtrademarkintheU.
S.
andinothercountries,exclusivelylicensedthroughX/OpenCompany,Ltd.
Sun,SunMicrosystems,theSunlogo,Java,AnswerBook2,docs.
sun.
com,StorageTek,SunFire,andSolarisaretrademarksorregisteredtrademarksofSunMicrosystems,Inc.
,oritssubsidiaries,intheU.
S.
andinothercountries.
AllSPARCtrademarksareusedunderlicenseandaretrademarksorregisteredtrademarksofSPARCInternational,Inc.
intheU.
S.
andinothercountries.
ProductsbearingSPARCtrademarksarebaseduponanarchitecturedevelopedbySunMicrosystems,Inc.
TheOPENLOOKandSunGraphicalUserInterfacewasdevelopedbySunMicrosystems,Inc.
foritsusersandlicensees.
SunacknowledgesthepioneeringeffortsofXeroxinresearchinganddevelopingtheconceptofvisualorgraphicaluserinterfacesforthecomputerindustry.
Sunholdsanon-exclusivelicensefromXeroxtotheXeroxGraphicalUserInterface,whichlicensealsocoversSun'slicenseeswhoimplementOPENLOOKGUIsandotherwisecomplywithSun'swrittenlicenseagreements.
U.
S.
GovernmentRights—Commercialuse.
GovernmentusersaresubjecttotheSunMicrosystems,Inc.
standardlicenseagreementandapplicableprovisionsoftheFARanditssupplements.
DOCUMENTATIONISPROVIDED"ASIS"ANDALLEXPRESSORIMPLIEDCONDITIONS,REPRESENTATIONSANDWARRANTIES,INCLUDINGANYIMPLIEDWARRANTYOFMERCHANTABILITY,FITNESSFORAPARTICULARPURPOSEORNON-INFRINGEMENT,AREDISCLAIMED,EXCEPTTOTHEEXTENTTHATSUCHDISCLAIMERSAREHELDTOBELEGALLYINVALID.
Copyright2008SunMicrosystems,Inc.
,4150NetworkCircle,SantaClara,Californie95054,Etats-Unis.
Tousdroitsréservés.
SunMicrosystems,Inc.
possèdelesdroitsdepropriétéintellectuelsrelatifsàlatechnologiedécritedanscedocument.
Enparticulier,etsanslimitation,cesdroitsdepropriétéintellectuelspeuventinclureunouplusieursdesbrevetsaméricainslistéssurlesitehttp://www.
sun.
com/patents,unoulesplusieursbrevetssupplémentairesainsiquelesdemandesdebrevetenattenteauxlestats-Unisetdansd'autrespays.
Cedocumentetleproduitauquelilserapportesontprotégésparuncopyrightetdistribuéssouslicences,celles-cienrestreignentl'utilisation,lacopie,ladistribution,etladécompilation.
Aucunepartiedeceproduitoudocumentnepeutêtrereproduitesousaucuneforme,parquelquemoyenquecesoit,sansl'autorisationpréalableetécritedeSunetdesesbailleursdelicence,s'ilyena.
Toutlogicieltiers,satechnologierelativeauxpolicesdecaractères,comprise,estprotégéparuncopyrightetlicenciépardesfournisseursdeSun.
DespartiesdeceproduitpeuventdériverdessystèmesBerkeleyBSDlicenciésparl'UniversitédeCalifornie.
UNIXestunemarquedéposéeauxtats-Unisetdansd'autrespays,licenciéeexclusivementparX/OpenCompany,Ltd.
Sun,SunMicrosystems,lelogoSun,Java,AnswerBook2,docs.
sun.
com,StorageTek,SunFire,etSolarissontdesmarquesdefabriqueoudesmarquesdéposéesdeSunMicrosystems,Inc.
,ousesliales,auxtats-Unisetdansd'autrespays.
TouteslesmarquesSPARCsontutiliséessouslicenceetsontdesmarquesdefabriqueoudesmarquesdéposéesdeSPARCInternational,Inc.
auxtats-Unisetdansd'autrespays.
LesproduitsportantlesmarquesSPARCsontbaséssurunearchitecturedéveloppéeparSunMicrosystems,Inc.
L'interfaceutilisateurgraphiqueOPENLOOKetSunaétédéveloppéeparSunMicrosystems,Inc.
poursesutilisateursetlicenciés.
SunreconnatleseffortsdepionniersdeXeroxdanslarechercheetledéveloppementduconceptdesinterfacesutilisateurvisuellesougraphiquespourl'industrieinformatique.
SundétientunelicensenonexclusivedeXeroxsurl'interfaceutilisateurgraphiqueXerox,cettelicencecouvrantégalementleslicenciésdeSunimplémentantlesinterfacesutilisateurgraphiquesOPENLOOKetseconformentenoutreauxlicencesécritesdeSun.
LADOCUMENTATIONESTFOURNIE"ENL'TAT"ETTOUTESAUTRESCONDITIONS,DCLARATIONSETGARANTIESEXPRESSESOUTACITESSONTFORMELLEMENTEXCLUESDANSLALIMITEDELALOIAPPLICABLE,YCOMPRISNOTAMMENTTOUTEGARANTIEIMPLICITERELATIVELAQUALITMARCHANDE,L'APTITUDEUNEUTILISATIONPARTICULIREOUL'ABSENCEDECONTREFAON.
iiiContentsPrefacexi1.
Overview1OverviewofthesscsCommand1UnderstandingCommandSyntax2LoggingIntothesscsEnvironment4ExitStatusCodes4CommandQuickReference5MonitoringandGeneralAdministrationCommands5ArrayConfigurationCommands72.
CommonTasks13DiscoveringArrays13CommandSequence14CreatingaVolume15SampleData15CommandSequence15CreatingaSnapshot18CommandsUsed19SampleData19ivSunStorageTekCommonArrrayManagerCLIGuideOctober2008CommandSequence193.
MonitoringandAdministrationCommandsforAllArrays25addnotification25addregisteredarray27adduserrole28listalarm29listarray31listdate33listdevice33listdevices35listdisk36listevent37listfirmware39listfru40listjobs41listlog42listmgmt-sw43listnotification44listregisteredarray45listsite46liststorage-system47listuserrole48login49logout51modifyagent51modifyarray52modifyfirmware53modifymgmt-sw54Contentsvmodifyregisteredarray55modifysite56modifystorage-system56modifyuserrole57registerstorage-system58registersun-connect59removealarm60removenotification61removeregisteredarray63removeuserrole63service64unregisterstorage-system65unregistersun-connection66version664.
ConfigurationCommandsforArrayswithRAIDControllers69addhostgroup69addlicense70createhost71createhostgroup72createinitiator73createiscsiinitiator74createpool75createprofile76createrepset78createsnapshot80createvdisk83createvolume84createvolume-copy86viSunStorageTekCommonArrrayManagerCLIGuideOctober2008deletehost87deletehostgroup88deleteinitiator88deleteiscsi-session89deletepool90deleteprofile91deleterepset91deletesnapshot92deletevdisk93deletevolume93deletevolume-copy94disablesnapshot95exportarray96exportprofile96faildisk97importarray98importprofile99initializedisk101listcontroller102listfcport103listhost104listhostgroup105listinitiator106listiperformance108listiscsi-port110listiscsi-session111listiscsi-target113listlicense115Contentsviilistmapping117listos-type118listperformance119listpool121listprofile122listrepset124listsasport125listsnapshot128listtray130listvdisk131listvolume133listvolume-copy135maphost137maphostgroup138mapinitiator139mapsnapshot140mapvolume141modifyarray142modifycontroller144modifydate146modifydisk148modifyfcport148modifyhost149modifyhostgroup150modifyinitiator151modifyiperformance152modifyiscsi-port153modifyiscsi-target154viiiSunStorageTekCommonArrrayManagerCLIGuideOctober2008modifyjobs156modifylicense157modifynotification159modifyperformance161modifypool161modifyprofile163modifyrepset164modifysnapshot167modifytray169modifyvdisk170modifyvolume171modifyvolume-copy173offlinevdisk174onlinevdisk175reconstructdisk176removehostgroup176removelicense177removenotification178resetarray179resetcontroller180resnapsnapshot180revivedisk181revivevdisk182servicefail183servicelocate183serviceredistribute184servicerevive185snapshootvolume186Contentsixunmaphost188unmaphostgroup188unmapinitiator189unmapsnapshot190unmapvolume191unregisterstorage-system192unregistersun-connection192version193Index195xSunStorageTekCommonArrrayManagerCLIGuideOctober2008xiPrefaceTheSunStorageTekCommonArrayManagerCLIGuidedescribesthecommandsinthesscsCLI.
Consultthehardwareinstallationguideforyourarrayforinformationabouttheinitialphysicalinstallationofanarray.
RelatedDocumentationInaddition,theSunStorageTekCommonArrayManagerincludesthefollowingonlinedocumentation:SunStorageTekCommonArrayManageronlinehelpContainssystemoverviewandconfigurationinformation.
ServiceAdvisorProvidesguided,FRU-replacementprocedureswithsystemfeedbackforallarrays.
YoucanaccessServiceAdvisorfromtheSunStorageTekCommonArrayManagersoftware.
sscsmanpagecommandsProvideshelponmanpagecommandsavailableonamanagementhostoronaremoteCLIclient.
ApplicationTitlePartNumberSoftwareinstallationinformationSunStorageTekCommonArrayManagerSoftwareInstallationGuide820-5747-xxLate-breakinginformationnotincludedintheinformationsetSunStorageTekCommonArrayManagerSoftwareReleaseNotes820-5749-xxReleaseNotesforyourarrayhardwareVariousxiiSunStorageTekCommonArrayManagerCLIGuideOctober2008DocumentationforothersupportedarraysAllotherarrayssupportedbythesoftwareshareacommondocumentationset.
Documentation,SupportandTrainingYoucanview,print,orpurchaseabroadselectionofotherSundocumentation,includinglocalizedversions,at:http://www.
sun.
com/documentationSupportinformationforthisproductcanbefoundat:http://www.
sun.
com/supportTraininginformationforthisproductcanbefoundat:http://www.
sun.
com/training/Ifyouhavetechnicalquestionsaboutthisproductthatarenotansweredinthisdocument,goto:http://www.
sun.
com/service/contactingSunWelcomesYourCommentsSunisinterestedinimprovingitsdocumentationandwelcomesyourcommentsandsuggestions.
Youcansubmityourcommentsbygoingto:http://www.
sun.
com/hwdocs/feedbackPleaseincludethetitleandpartnumberofyourdocumentwithyourfeedback:SunStorageTekCommonArrayManagerCLIGuide,Version6.
2.
0,partnumber820-5748-10.
1CHAPTER1OverviewThischapterprovidesanoverviewofthesscsadministrationcommandforSunStorageTekandSunStoragearrays.
Itcontainsthefollowingsections:"OverviewofthesscsCommand"onpage1"UnderstandingCommandSyntax"onpage2"LoggingIntothesscsEnvironment"onpage4"ExitStatusCodes"onpage4"CommandQuickReference"onpage5OverviewofthesscsCommandThesscscommandlineinterface(CLI)enablesyoutomanageandmonitordiskarrays.
TheCLIcanbeinstalledonalocaldatahostoraremotemanagementhost.
LocalCLIdirectorylocation:Solaris:/opt/SUNWstkcam/bin/sscsLinux:/opt/sun/cam/bin/sscsWindows:ProgramFiles>Sun>CommonArrayManager>binfolderRemoteCLIdirectorylocation:Solaris:/opt/SUNWsesscs/cli/bin/sscsLinux:/opt/sun/cam/se6x20/cli/bin/sscsWindows:ProgramFiles>Sun>CommonArrayManager>binfolder2SunStorageTekCommonArrayManagerCLIGuideOctober2008UnderstandingCommandSyntaxTypethesscscommandwithitsoptionsfromaterminalcommandline.
Youcanuseonlytheindicatedoptionoroptionsforthatsubcommand.
Foralistingofcommandsandtheiroptions,referto>TABLE1-1describestheconventionsthatapplytothesubcommandsandvariables:Note–Anycharactersthatyouenclosewithinquotationmarksareacceptablefornames.
GettingHelpwithCommandsandTheirSyntaxUsethe--helpcommandtoviewallavailablecommands,subcommandsandtheirsyntax.
TABLE1-1SyntaxConventionsforsscsCommandsConventionDescriptionBoldTextinboldshouldbetypedexactlyasshown.
ItalicTextinitalicsisvariableandshouldbereplacedwiththenameorvalueusedatyoursite.
Multiplevariablescanbeseparatedbyacommaand,optionally,aspace.
Note:Youcannotuseaspacealone.
Thefollowingexamplesshowthecorrectuseofcommasandspacesinlists:sscslistvolumeTestVOL,fvm13311sscslistvolumeTestVol,fvm13311[](squarebrackets)Textinsquarebracketsisoptional.
|(verticalbar)Textseparatedbyaverticalbarisexclusive.
Specifyonlyoneoftheoptions.
{}(braces)TextinsidebracesisarequiredargumentShortandlongnamesThesscscommandacceptsshortorlongnamesforeachoption.
Shortnameoptionsrequireasinglehyphen(-).
Longnameoptionsrequireadoublehyphen(--).
SpecialcharactersinnamesDonotusespaces,commas,colons(:),oranyofthefollowingspecialcharacters:Chapter1Overview3TABLE1-2describeshowtousethe--helpcommand:TABLE1-2TaskCommandSyntaxGethelpwithcommandsyntaxsscs--helpDisplayacommandlistspecifictoaspecificarraytypesscs--help-aCommandexample:sscs--help-a2510addcreatedeleteexportfail.
.
.
reviveservicesnapshootunmapunregisterDisplaythesubcommandsavailableforacommandforaspecificarraytypesscs--help-aCommandexample:sscslist--help-aj4200SampleCommandOutput:alarmarraydate.
.
.
sitestorage-systemuserroleDisplayadetailedoptionlistforacommand/subcommandpairforaspecificarraytypesscs--help-aCommandexample:sscslist--help-aj4200alarmSampleCommandOutput:list[-s|--severity][-f|--faultdevtype][-a|--advisor][-S|--Summary]alarm[string[,string.
.
.
]]4SunStorageTekCommonArrayManagerCLIGuideOctober2008LoggingIntothesscsEnvironmentIfyouareusingthelocalCLI,nologinisrequired;however,youmusthaverootaccessinSolarisandLinuxoradministratorprivilegesinWindows.
AloginisrequiredifusingtheremoteCLI.
TologintotheremoteCLI,followthesesteps:1.
Fromaterminalwindow,logintothemanagementhostwheresscsresides.
2.
Enterthefollowingcommands:#cdCLI_directory(Referto"OverviewofthesscsCommand"onpage1fordirectoryinformation.
#.
/sscslogin-hlocalhost-u3.
Enterthepasswordforyoursscsuseraccount.
ForathoroughdescriptionaboutloggingintothesscsusingtheremoteCLI,seethelogincommandandallofitsoptions,goto"login"onpage49ExitStatusCodesUponcommandcompletion,thesscsCLIreportsthefollowingexitstatuscodes:TABLE1-3ExitStatusCodesExitStatusCodeDescription0Successfulcompletion15Objectnotfounderror25Commandparsingfailure30Commandvalidationerror50Applicationerror75Systemerror100NonspecificerrorChapter1Overview5CommandQuickReferenceTherearetwocategoriesofCLIcommands:MonitoringandGeneralAdministrationCommandsThesecommandsaresupportedonallarrayssupportedbyCAM,withonlyafewnotedexceptions.
ArrayConfigurationCommandsThesecommandsaresupportedononlythosearraysthathaveoneormoreRAIDcontrollers.
ForacompletelistingofarrayssupportedbyCAM,refertothereleasenotes.
MonitoringandGeneralAdministrationCommandsThefollowingtableliststhecommandsusedtomonitorthearrayandperformgeneraladministrationtasks.
Thistableidentifiesthecommandnameandprovidesbasicsyntax,ageneralcommanddescription,andidentifiesthepagewhereyoucanfindadetailedcommanddescription.
TABLE1-4MonitoringandGeneralAdministrationCommandsCommandDescriptionaddnotificationSetupemailorSNMPtrapnotification.
addregisteredarrayDiscoversanarrayorallarraysonthesamesubnetasthemanagementhostandregistersthem.
adduserroleAddsausernametotheuseraccesslistanddefinestheuserprivileges.
listalarmProvidesdetailedinformationonaspecifiedalarmorsummaryinformationonallalarmslistarrayListsdetailedinformationaboutspecifiedarraysorallarraynames.
listdateListsthecurrentdateandtimeforthearrayinhours,minutes,andseconds.
(Notsupportedbyj450andB6000JBODs.
)listdeviceListthedetailsofadeviceorthedevicesbeingmonitored.
listdevicesListanoverviewofadeviceorthedevicesbeingmonitored.
6SunStorageTekCommonArrayManagerCLIGuideOctober2008listdiskListthediskinformationonanarray.
listeventListstheFaultManagementService(FMS)eventloginformation.
listfirmwareListsthefirmwareversionsofthefield-replaceableunits(FRU)inthisdevicelistfruListsthefield-replaceableunits(FRUs)inthisdevice.
listjobsListsjobIDsandstatusassociatedwiththespecifiedarrayandoptionallyspecifiedjobIDlistlogListstheuser-initiatedactionsperformedforallregisteredarrays.
listmgmt-swListsthemanagementsoftwareapplicationthatyouareloggedinto.
listnotificationListstheremotenotificationprovideranditsstatus.
listregisteredarrayListsregisteredarrayinformationliststorage-systemListsdetailedinformationaboutoneormorearrays.
listsiteListspertinentinformationonthesite.
listuserroleListstheusernameandroledefiningtheuser'sarrayprivileges.
loginLogintothesscscommand-lineinterface(CLI).
logoutLogsoutoftheremotesscscommand-lineinterfacesession.
modifyagentModifythefaultmanagementagentparameters.
modifyarrayModifiesthenameassignedtothearray.
modifyfirmwareModifiesthefirmwareversionsofthespecifiedfield-replaceableunits(FRUs)ofthespecifiedarraymodifymgmt-swStoresthespecifiedstoragesystemnameforthesession.
Thiscommandisusefulforrepeatedoperationswithanarray.
modifyregisteredarrayChangethelocallystoredpasswordforaregisteredarray.
modifysiteModifiesthesitepropertiesforthisinstanceofCAM.
modifystorage-systemModifiesthearrayinformationmodifyuserroleChangetheuserroleortheIPaddressfromwhichtheusercanlogin.
registerstorage-systemRegistersastoragesystemwiththehostregistersun-connectRegistersCAMsoftwareandallmonitoredarrayswithAutoServiceRequest(ASR).
TABLE1-4MonitoringandGeneralAdministrationCommandsCommandDescriptionChapter1Overview7ArrayConfigurationCommandsThissectionidentifiesthecommandsusedtoconfigureanarray.
Thistableidentifiesthecommandnameandprovidesbasicsyntax,ageneralcommanddescription,andidentifiesthepagewhereyoucanfindadetailedcommanddescription.
removealarmRemovesthecurrentalarms.
removenotificationRemovesalocalorremotenotification.
removeregisteredarrayRemovesoneormorearraysfromthelistofregisteredarrays.
removeuserroleRemovesauserroleassignedtoausername.
servicePerformservice-relatedcommands.
TABLE1-5ArrayConfigurationCommandsCommandDescriptionaddhostgroupAddshoststoahostgroup.
addlicenseAddsalicensetothespecifiedarray.
createhostCreatesastoragehost.
createhostgroupCreatesastoragehostgroup.
createinitiatorCreatesaninitiator.
createiscsiinitiatorCreatesaniSCSIinitiatoronahost.
createpoolCreatesanemptystoragepoolonthearraycreateprofileCreatesastorageprofileonthearray.
createrepsetCreatesastoragereplicationsetusingapeerWorldWideNameorremotearrayname(notapplicableto2500Series).
createsnapshotCreatesasnapshotforthespecifiedvolume.
createvdiskCreatesavirtualdisk.
createvolumeCreatesavolumewithinaspecifiedpool.
createvolume-copyCreatesacopyofthevolume(notapplicableto2500Series).
deletehostDeletesoneormorehosts.
deletehostgroupDeletesoneormorehostgroups.
deleteinitiatorDeletesoneormoreinitiators.
TABLE1-4MonitoringandGeneralAdministrationCommandsCommandDescription8SunStorageTekCommonArrayManagerCLIGuideOctober2008deleteiscsi-sessionDeletesaniscsi-sessiondeletepoolDeletesoneormorepools.
deleteprofileDeletesoneormoreprofiles.
deleterepsetDeletesoneormorereplicationsets(notapplicableto2500Series).
deletesnapshotDeletesoneormoresnapshots.
deletevdiskDeletesoneormorenamedvirtualdisks.
deletevolumeDeletesoneormorenamedvolumes.
deletevolume-copyDeletesavolume-copy(notapplicableto2500Series).
disablesnapshotDisablesoneormoresnapshots.
exportarrayRendersanextensiblemarkuplanguage(XML)representationofthearrayexportprofileExportsoneormoreprofilesintoanXMLrepresentation.
faildiskSetsadisktothefailedstate.
importarrayAppliesanarrayconfigurationfiletothespecifiedarray.
importprofileImportsoneormoreprofilesfromaspecifiedXMLfile.
initializediskInitializesadisk.
listcontrollerListsconfigurationinformationforthespecifiedcontrollerlistfcportListsFibreChannelportinformationforthecontrollerofthespecifiedarray.
listhostListsthehostnamesanddetailsforanindividualhost.
listhostgroupListshostgroupnameandhostsforanindividualhostgroup.
listinitiatorListstheinitiatorsandprovidesadescriptionofeach.
listiperformanceDisplaysiSCSIperformancestatisticsforthe2510arrayandenablesyoutodefinethetypeofiSCSIperformancestatisticstomonitor.
listiscsi-portListsiSCSIports.
listiscsi-sessionListsiSCSIsessionslistiscsi-targetListsiSCSItargetnameconfiguredforthespecifiedarray.
listlicenseShowsalllicensesthatareassociatedwiththearray,alongwithrelatedlicensingdetails(serialnumber,controllerserialnumber,andfurtherdetails)TABLE1-5ArrayConfigurationCommandsCommandDescriptionChapter1Overview9listmappingListsmappingsforthearray.
Youcanfiltertheoutputbyspecifyingthenameofastoragedomain,ahost,orahostgroup.
listos-typeShowsalloftheoperatingsystemsthataresupportedbythearray.
Thevaluesreturnedcanbeusedinsubsequentrequeststocreateormodifyinitiators,ortomodifythedefaulthosttypeofthearray.
listperformanceShowsdetailedperformancestatistics.
Youcanusethefollowingoptionsonlyifasinglearrayisspecified.
listpoolListsstoragepoolinformation.
listprofileListsthenamedstorageprofileslistrepsetListsreplicationsetinformation(notapplicableto2500Series).
listsasportListsSASportinformation.
listsnapshotListsthespecifiedsnapshotorsnapshotsassociatedwiththisarray.
listtrayListsinformationaboutoneormorestoragetraysinthearray.
listvdiskListsvirtualdisk(vdisk)orvirtualdisksinformationassociatedwiththisarray.
listvolumeListsvolumeinformation.
listvolume-copyListsvolumecopyinformation.
Ifneitherthesourcevolumenorthetargetvolumeisspecified,asummaryofallvolumecopiesislisted.
Ifthesourcevolumeorthetargetvolumeisspecified,adetailedlistingofeachisgenerated.
maphostMapsoneormorevolumesandsnapshotstoahost.
Anypreviousmappingsforthegivenvolumesandsnapshotsareremoved.
maphostgroupMapsoneormorevolumesandsnapshotstoahostgroup.
Anypreviousmappingsforthegivenvolumesorsnapshotsareremoved.
mapinitiatorMapsaninitiatortoavolumeorsnapshot.
Anypreviousmappingsforthegivenvolumesorsnapshotsareremoved.
mapsnapshotMapsoneormoresnapshotstoahostorhostgroup.
Ifnohostorhostgroupisspecified,thesnapshotorsnapshotsaremappedintotheDefaultpartition.
mapvolumeMapsoneormorevolumestoahostorhostgroup.
Anypreviousmappingsforthegivenvolumeorvolumesareremoved.
modifyarrayModifiestheconfigurationofthespecifiedarraymodifycontrollerModifiesthecontrollersettings.
modifydateModifiesthedateonthearray,allowingyoutosetthetimeonthearray,ortosynchronizethetimewiththemanagementhost(thatis,settingthearray'stimetothemanagementhost'stime.
)TABLE1-5ArrayConfigurationCommandsCommandDescription10SunStorageTekCommonArrayManagerCLIGuideOctober2008modifydiskSpecifiesthediskrole.
modifyfcportModifiestheFibreChannelportsettingsonthespecifiedarray.
modifyhostModifiesthehostname.
modifyhostgroupModifiesthehostgroupname.
modifyinitiatorModifiesaninitiator.
modifyiperformanceModifiesthesettingsforiSCSIperformancedata.
modifyiscsi-portModifiesaniSCSIport.
modifyiscsi-targetModifiesaniSCSItarget.
modifyjobsCancelsorprioritizesarunningoroutstandingjob.
modifylicenseActivatesreplicationsetlicenses(applicableto2500Seriesonlywhenrunningfirmwareversion07.
35.
nn.
nnorhigher).
modifynotificationModifiesnotificationoptions.
modifyperformanceModifiessettingsforperformancemonitoringmodifypoolModifiesthenameordescriptionofthestoragepoolortheprofilewithwhichthispoolisassociated.
modifyprofileModifiesastorageprofileonthearray.
modifyrepsetModifiesthemode,consistencygroup,orreplicationpriorityofthespecifiedreplicationset(notapplicableto2500Series).
modifysnapshotModifiesthespecifiedsnapshotmodifytrayModifiesinformationaboutoneormorestoragetraysinthearray.
modifyvdiskSpecifiesmodificationstoavirtualdisk.
modifyvolumeModifiesanyofavolume'sattributesmodifyvolume-copyModifiesavolumecopy(notapplicableto2500Series).
offlinevdiskSetsavirtualdiskoffline.
onlinevdiskSetsavirtualdiskonline.
reconstructdiskInitiatesadiskreconstruction.
removehostgroupRemovesoneormorehostsfromahostgroup.
removelicenseRemovesthereplicationsetfeaturelicensefromthespecifiedarray(notapplicableto2500Series).
removenotificationRemovesalocalorremotenotificationprovider.
resetarrayResetsthespecifiedarray.
rresetcontrollerResetsthespecifiedcontroller.
TABLE1-5ArrayConfigurationCommandsCommandDescriptionChapter1Overview11resnapsnapshotResnapsoneormoreexistingsnapshots.
revivediskAttemptstobringadisktotheoptimalstate.
revivevdiskRevivesavirtualdiskservicefailPlacesafield-replaceableunitofanarrayintoafailedstate.
servicelocateTurnsonthedrive,tray,orarraylocatorLED.
serviceredistributeRedistributesvolumesbacktotheirpreferredowners.
servicereviveAttemptstoplacethearraycontrollerordiskdriveintotheoptimalstate.
Thiscancreatecomplications.
DonotinitiatethiscommandwithoutfirstconsultingSunCustomerServicepersonnel.
snapshootvolumeCreatesandmanagessnapshots.
unmaphostUnmapsoneormoresnapshotsorvolumesfromahost.
unmaphostgroupUnmapsoneormoresnapshotsorvolumesfromahostgroup.
runmapinitiatorRemovesthemappingfromoneormoreinitiatorstoavolumeorsnapshot.
unmapsnapshotRemovesthemappingfromoneormoresnapshotstoahostorhostgroup.
unmapvolumeUnmapsoneormorevolumesfromahostorhostgroup.
unregisterstorage-systemUnregistersanarray.
unregistersun-connectionUnregistersCAMsoftwareandallmonitoredarraysfromAutoServiceRequest(ASR).
versionShowstheversionsofsoftwarethatyouarerunningonthisarrayandtheclient.
TABLE1-5ArrayConfigurationCommandsCommandDescription12SunStorageTekCommonArrayManagerCLIGuideOctober200813CHAPTER2CommonTasksThischapterprovidesexamplesofhowtoperformabasictaskusingaseriesofCLIcommands.
Thischaptercontainsthefollowingsections:"DiscoveringArrays"onpage13"CreatingaVolume"onpage15"CreatingaSnapshot"onpage18DiscoveringArraysTABLE2-1identifiesthesequenceofCLIcommandsusedwhenregisteringarrayswithCAM.
TABLE2-1CLICommandsUsedWhenDiscoveringArraysCLICommandDescriptionsscsliststorage-systemListsthearraysthatarealreadyregisteredwithCAM.
sscsregister-dstorage-systemDirectsCAMtodiscoverallavailablearrays.
sscsliststorage-systemListsallarraysregistered,includingthenewlydiscoveredarrays.
sscsunregisterstorage-systemUnregistersselectarrays.
14SunStorageTekCommonArrayManagerCLIGuideOctober2008CommandSequence1.
IdentifythenamesofthearrayscurrentlyregisteredwithCAM:sscsliststorage-systemArray:Snoopy1Array:Snoopy2Array:Linus12.
Discoverallarrays:sscsregister-dstorage-systemNameTypeNetworkAddressSerialNumberSnoopy16140xx.
xx.
xx.
103SUN.
xxxxx-00.
xxxxxxxxxxunlabeled6140xx.
xx.
xx.
112SUN.
xxxxx-00.
xxxxxxxxxxOnyx2540xx.
xx.
xx.
9SUN.
xxxxx-00.
xxxxxxxxxxHal6140xx.
xx.
xx.
72SUN.
xxxxx-00.
xxxxxxxxxxLinus16140xx.
xx.
xx.
16SUN.
xxxxx-00.
xxxxxxxxxxSnoopy26140xx.
xx.
xx.
106SUN.
xxxxx-00.
xxxxxxxxxxJohnny56140xx.
xx.
xx.
67SUN.
xxxxx.
Pedro12540xx.
xx.
xx.
6SUN.
xxxxx-00.
xxxxxxxxxx3.
UnregisterthearrayOnyx:sscsunregisterstorage-systemOnyx4.
VerifythelistofregisteredarraystoensurethatOnyxisnolongerregistered:sscsliststorage-systemArray:Snoopy1Array:ulabeledArray:HalArray:Linus1Array:Snoopy2Array:Johnny5Array:Pedro1Chapter2CommonTasks15CreatingaVolumeTABLE2-2identifiesthesequenceofCLIcommandsusedwhencreatingavolume.
SampleDataInthisexample,thefollowingsampledataareusedintheexecutionofthecommands:CommandSequence1.
Identifythenamesofthevolumesthatalreadyexistonthearrayden-toi-6130:sscslist-aden-toi-6130volumeVolume:ACCType:StandardPool:DefaultProfile:DefaultVolume:RCVStandardPool:DefaultProfile:Default.
TABLE2-2CLICommandsUsedWhenCreatingaVolumeSnapshotCLICommandDescriptionsscslistvolumeListvolumesthatalreadyexistonaspecifiedarray.
sscscreatevolumeCreateanewvolumeonanarray.
sscslistjobsVerifythatthevolumecreationjobisinprogress.
sscslistvolumesVerifythevolumecharacteristics.
sscslistvdiskVerifythecharacteristicsofthevirtualdiskusedbythenewlycreatedvolume.
sscslisthostIdentifythehostsavailableformappingtothevolume.
sscsmapvolumeMapthevolumetoahost.
TABLE2-3SampleDataArrayName:den-toi-6130PoolName:den-pool-64k-r5VolumeName:vol0-64k-r5ProfileName:den-profile-64k-r5DiskNames:t1d01,t1d02,t1d03,t1d0416SunStorageTekCommonArrayManagerCLIGuideOctober20082.
Identifythenamesofthestoragepoolsthatalreadyexistonthearrayden-toi-6130:sscslist-aden-toi-6130poolPool:newNFSmirroringPoolProfile:NFS_MirroringConfiguredCapacity:0.
000MBPool:RAID1-32KB-NoReadAheadProfile:RAID1-32KB-NoReadAheadConfiguredCapacity:0.
000MBPool:RAID5-512KB-NoReadAheadProfile:RAID5-512KB-NoReadAheadConfiguredCapacity:0.
000MBPool:poolFortest6731502Raid5threeDiskProfile:test6731502Raid5threeDiskConfiguredCapacity:0.
000MBPool:den-pool-64k-rProfile:RAID0-564KB-ReadAheadConfiguredCapacity:0.
000MB3.
Verifythecharacteristicsofthestoragepoolden-pool-64k-r5:sscslist-aden-toi-6130poolden-pool-64k-rDescription:nullProfile:RAID5-64KB-ReadAheadTotalCapacity:0.
000MBConfiguredCapacity:0.
000MBAvailableCapacity:1.
197TB4.
Createanewvolumeonarrayden-toi-6130.
Thenewvolumeisnamedvol0-64k-r5,usesthestoragepoolnamedden-pool-64k-r5,andhas5GBofstoragecapacity:sscscreate-aden-toi-6130-pden-pool-64k-r5-s5GBvolumevol0-64k-r55.
Verifythatthevolumecreationjobisinprogress:sscslist-aden-toi-6130jobsJobID:VOL:0B70418253F6Status:Inprogress6.
Verifythecharacteristicsofthevolumenamedvol0-64k-r5:sscslist-aden-toi-6130volumevol0-64k-r5Volume:vol0-64k-r5Type:StandardWWN:60:0A:0B:80:00:13:B9:8B:00:00:0B:70:41:82:53:F6Pool:den-pool-64k-r5Profile:den-profile-64k-r5VirtualDisk:1Chapter2CommonTasks17Size:5.
000GBStatus:OnlineAction:ReadyCondition:OptimalReadOnly:NoController:APreferredController:AModificationPriority:HighWriteCache:EnabledWriteCachewithMirroring:EnabledWriteCachewithoutBatteries:DisabledFlushCacheAfter:10SecDiskScrubbing:EnabledDiskScrubbingwithRedundancy:Disabled7.
Listthevirtualdisksavailableonden-toi-6130:sscslist-aden-toi-6130vdiskVirtualDisk:18.
Verifythecharacteristicsofthevirtualdisknamed1:sscslist-aden-toi-6130vdisk1VirtualDisk:1Status:OnlineNumberofDisks:4MaximumVolumeSize:198.
599GBRAIDLevel:5TotalCapacity:203.
599GBConfiguredCapacity:5.
000GBAvailableCapacity:198.
599GBDiskType:FCDisk:t1d04Disk:t1d03Disk:t1d02Disk:t1d01Volume:vol0-64k-r59.
Identifythehostsavailableofthearrayden-toi-6130:sscslist-aden-toi-6130hostHost:450e10.
Mapthevolumevol0-64k-r5tothehost450e:sscsmap-aden-toi-6130-h450e-l1volumevol0-64k-r518SunStorageTekCommonArrayManagerCLIGuideOctober200811.
Ensurethatthemappingwassuccessfulbyverifyingthecharacteristicsofthevolumenamedvol0-64k-r5:sscslist-aden-toi-6130volumevol0-64k-r5Volume:vol0-64k-r5Type:StandardWWN:60:0A:0B:80:00:13:B9:8B:00:00:0B:70:41:82:53:F6Pool:den-pool-64k-r5Profile:den-profile-64k-r5VirtualDisk:1Size:5.
000GBStatus:OnlineAction:ReadyCondition:OptimalReadOnly:NoController:APreferredController:AModificationPriority:HighWriteCache:EnabledWriteCachewithMirroring:EnabledWriteCachewithoutBatteries:DisabledFlushCacheAfter:10SecDiskScrubbing:EnabledDiskScrubbingwithRedundancy:DisabledAssociations:Host:450eLUN:1Initiator:450e-qlc5WWN:21:00:00:E0:8B:06:02:E9Host:450eLUN:1Initiator:450e-qlc6WWN:21:00:00:E0:8B:06:FC:E8CreatingaSnapshotThefollowingsectionwilldemonstratethecommandsusedwhencreatingasnapshotofavolume.
Chapter2CommonTasks19CommandsUsedTABLE2-4identifiesthesequenceofCLIcommandsusedwhencreatingavolumesnapshot.
SampleDataInthisexample,thesampledatalistedinTABLE2-5areusedintheexecutionofthecommands:CommandSequence1.
Verifytheexistenceandcharacteristicsofthevolumevol0-64k-r5:sscslist-aden-toi-6130volumevol0-64k-r5Volume:vol0-64k-r5Type:StandardTABLE2-4CLICommandsUsedWhenCreatingaVolumeSnapshotCLICommandDescriptionsscslistvolumeVerifytheexistenceandcharacteristicsofavolume.
sscscreatesnapshotCreateasnapshotofavolumesscslistsnapshotVerifytheexistenceandcharacteristicsofthesnapshotsscslisthostIdentifythehostsavailableformappingtothesnapshot.
sscsmapsnapshotMapthesnapshottoahost.
sscsunmapsnapshotUnmapthesnapshotfromahost.
sscsdeletesnapshotRemovethesnapshot.
TABLE2-5SampleDataArrayName:den-toi-6130PoolName:den-pool-64k-r5VolumeName:vol0-64k-r5ProfileName:den-profile-64k-r5SnapshotName:snapshot-vol0ReserveVolumeName:reserve-vol0HostName:450e20SunStorageTekCommonArrayManagerCLIGuideOctober2008WWN:60:0A:0B:80:00:13:B9:8B:00:00:0B:70:41:82:53:F6Pool:den-pool-64k-r5Profile:den-profile-64k-r5VirtualDisk:1Size:15.
000GBStatus:OnlineAction:ReadyCondition:OptimalReadOnly:NoController:APreferredController:AModificationPriority:HighestWriteCache:EnabledWriteCachewithMirroring:EnabledWriteCachewithoutBatteries:DisabledFlushCacheAfter:10SecDiskScrubbing:EnabledDiskScrubbingwithRedundancy:DisabledAssociations:Host:450eLUN:1Initiator:450e-qlc5WWN:21:00:00:E0:8B:06:02:E9Host:450eLUN:1Initiator:450e-qlc6WWN:21:00:00:E0:8B:06:FC:E82.
Createthesnapshotvolumenamessnapshot-vol0.
sscscreate-aden-toi-6130-Vvol0-64k-r5-Lfull-ffailsnapshot-mreserve-vol0-w100snapshotsnapshot-vol03.
Verifythatthespecifiedvolume,vol0-64k-r5,nowhasasnapshotnamedsnapshot-vol0associatedwithit.
sscslist-aden-toi-6130volumevol0-64k-r5Volume:vol0-64k-r5Type:StandardWWN:60:0A:0B:80:00:13:B9:8B:00:00:0B:70:41:82:53:F6Pool:den-pool-64k-r5Profile:den-profile-64k-r5VirtualDisk:1Size:15.
000GBStatus:OnlineAction:ReadyCondition:OptimalReadOnly:NoController:AChapter2CommonTasks21PreferredController:AModificationPriority:HighestWriteCache:EnabledWriteCachewithMirroring:EnabledWriteCachewithoutBatteries:DisabledFlushCacheAfter:10SecDiskScrubbing:EnabledDiskScrubbingwithRedundancy:DisabledSnapshots:SnapshotVolume:vol0-snap1CreationDate:SatOct2507:40:0036797ReserveVolume:res-vol0SnapshotVolume:snapshot-vol0CreationDate:MonApr2511:40:0036805ReserveVolume:reserve-vol0Associations:Host:450eLUN:1Initiator:450e-qlc5WWN:21:00:00:E0:8B:06:02:E9Host:450eLUN:1Initiator:450e-qlc6WWN:21:00:00:E0:8B:06:FC:E84.
Verifythecharacteristicsassignedtothesnapshotvolume,snapshot-vol0.
sscslist-aden-toi-6130snapshotsnapshot-vol0Volume:snapshot-vol0Type:SnapshotWWN:60:0A:0B:80:00:13:B9:8B:00:00:0B:7A:41:86:0B:02VirtualDisk:1Size:14.
999GBStatus:ActiveAction:ReadyCondition:OptimalController:APreferredController:AModificationPriority:HighWriteCache:EnabledWriteCachewithMirroring:EnabledWriteCachewithoutBatteries:DisabledFlushCacheAfter:10SecDiskScrubbing:EnabledDiskScrubbingwithRedundancy:DisabledPercentFull:0FailurePolicy:failsnapshotWarningThreshold:100CreationDate:MonApr2511:40:0036805BaseVolume:vol0-64k-r5ReserveVolume:reserve-vol0ReserveStatus:Online22SunStorageTekCommonArrayManagerCLIGuideOctober2008ReserveSize:14.
999GB5.
Identifythehostsavailableobthearrayden-toi-6130:sscslist-aden-toi-6130hostHost:450e6.
Mapasnapshottothehost450e:sscsmap-aden-toi-6130-h450esnapshotsnapshot-vol07.
Verifythecharacteristicsassignedtothesnapshotvolume,snapshot-vol0.
sscslist-aden-toi-6130snapshotsnapshot-vol0Volume:snapshot-vol0Type:SnapshotWWN:60:0A:0B:80:00:13:B9:8B:00:00:0B:7A:41:86:0B:02VirtualDisk:1Size:14.
999GBStatus:ActiveAction:ReadyCondition:OptimalController:APreferredController:AModificationPriority:HighWriteCache:EnabledWriteCachewithMirroring:EnabledWriteCachewithoutBatteries:DisabledFlushCacheAfter:10SecDiskScrubbing:EnabledDiskScrubbingwithRedundancy:DisabledPercentFull:0FailurePolicy:failsnapshotWarningThreshold:100CreationDate:MonApr2511:40:0036805BaseVolume:vol0-64k-r5ReserveVolume:reserve-vol0ReserveStatus:OnlineReserveSize:14.
999GBAssociations:Host:450eLUN:2Initiator:450e-qlc5WWN:21:00:00:E0:8B:06:02:E9Host:450eLUN:2Initiator:450e-qlc6WWN:21:00:00:E0:8B:06:FC:E88.
Unmapthesnapshotnamessnapshot-vol0.
Chapter2CommonTasks23sscsunmap-aden-toi-6130-h450esnapshotsnapshot-vol09.
Verifythatsnapshot-vol0wassuccessfullyunmapped.
sscslist-aden-toi-6130snapshotsnapshot-vol0Volume:snapshot-vol0Type:SnapshotWWN:60:0A:0B:80:00:13:B9:8B:00:00:0B:7A:41:86:0B:02VirtualDisk:1Size:14.
999GBStatus:ActiveAction:ReadyCondition:OptimalController:APreferredController:AModificationPriority:HighWriteCache:EnabledWriteCachewithMirroring:EnabledWriteCachewithoutBatteries:DisabledFlushCacheAfter:10SecDiskScrubbing:EnabledDiskScrubbingwithRedundancy:DisabledPercentFull:0FailurePolicy:failsnapshotWarningThreshold:100CreationDate:MonApr2511:40:0036805BaseVolume:vol0-64k-r5ReserveVolume:reserve-vol0ReserveStatus:OnlineReserveSize:14.
999GB10.
Deletethesnapshotnamessnapshot-vol0:sscsdelete-aden-toi-6130snapshotsnapshot-vol024SunStorageTekCommonArrayManagerCLIGuideOctober200825CHAPTER3MonitoringandAdministrationCommandsforAllArraysThischapterdescribesthesscscommandsandtheiroptionsformonitoringandadministratingallSunarrays,includingSunStorageJ4200,J4400,andJ4500arrays,SunStorEdgeTM6130array,SunStorageTekTM6140and6540arrays,SunStorage6580and6780arrays,SunStorageTek2500Seriesarrays,andFlexLineTM240,280,and380Systems.
Fortheconfigurationandothercommandsthatapplyonlytoarrayswithraidcontrollers,seeChapter4.
addnotificationSetsupemailorSNMPtrapnotification.
SynopsisAddemailnotification:add[-e][-rpager|email][-mdown|critical|major|minor][-f][-s][-d][-g]notificationlocal_emailAddanSNMPtrapnotification:add-i][-t1|2|3|4|5][-lwarning|error|down][-m|][-c][-g]notificationtrapAddanemailfilter:add-n-sinfo|nonenotificationemail-filterTurnontheSNMPtrapnotifier:26SunStorageTekCommonArrayManagerCLIGuideOctober2008addnotificationtrapDescriptionSetsupemailandSNMPtrapnotification.
Youcanaddoneormoreemailaddressesfornotifications.
Options-e,--emailSpecifiesthatallnotificationsaresenttothegivenemailaddresses.
-i,--ipSpecifiestheIPaddressofthehostthatwillreceivetheSNMPtrapdata.
-l,--traplevelwarning|error|downSpecifiesthetraplevelassociatedwiththisnotification.
-o,--portSpecifiestheportIDusedtotransfernotifications.
-c,--componentsSpecifiesthearraymodelnumber.
Forexample,j4200orj4400.
-r,--formatpager|emailSpecifiestheformatofthemessage:emailorpager.
Ifnovalueisspecified,thecommanddefaultstoemail.
-m,--alarm-leveldown|critical|major|minorSpecifiestheminimumprioritylevelofalertstobesentout.
Bydefault,allalertswillbesentout.
-f,--filtertrue|falseEnablesordisablesemailfilters.
Thedefaultisfalse.
-s,--skip-aggregatedtrue|falseSkipscomponentsofaggregatedeventsifsettotrue.
-d,--advisortrue|falseAddsServiceAdvisorinformationtotheemailifsettotrue.
Thedefaultisfalse.
-g,--config-changetrue|falseSendsconfigurationeventemailsaswellasalerte-mails.
Thedefaultisfalse.
-n,--event-numberChapter3MonitoringandAdministrationCommandsforAllArrays27Specifiestheeventcodetofilter.
-s,--severityinfo|noneSpecifiestheseverityofeventstoreport.
-t,--trapnumber1|2|3|4|5Specifiesthetrapnumberassociatedwiththisnotification.
notificationlocal_email|email-filter|trapSpecifiesthatallnotificationsofthespecifiedtypearesenttothegivenaddresses.
local-email-Specifiesthatyouwanttoreceivethenotificationatyourlocalemailaddress.
email-filter-Specifiesthatyouwanttofilterthenotification.
trap-SpecifiesthatyouwanttoreceivenotificationusingtheSNMPtrapnotification.
Examplessscsadd-t2-i10.
10.
10.
1notificationtrapaddregisteredarrayDiscoversanarrayorallarraysonthesamesubnetasthemanagementhostandregistersthem.
Synopsisadd-dregisteredarrayadd-i[-q]registeredarrayDescriptionDiscoversanarraybyspecifyingitsIPaddressorallarraysonthesamesubnetasthemanagementhostandregistersthem.
Alsoqueriesregisteredarraysfortheremoteproxypassword.
Options-i,--ipaddressSpecifiestheIPaddressofthedevice.
28SunStorageTekCommonArrayManagerCLIGuideOctober2008-d,--discoverAutomaticallydiscoversallarraysonthesamesubnetasthemanagementhostandregistersthem.
Ifdiscoverisspecified,allotheroptionsareignoredandarraysareautomaticallydiscovered.
-q,--query-for-passwordQueriesforthecurrentpasswordforremoteproxyfortheregisteredarray.
Examplessscsadd-i10.
10.
10.
1registeredarrayadduserroleAddsausernametotheuseraccesslistanddefinestheuserprivileges.
Synopsisadd-uuserrolestorage|guestDescriptionAddsausernametotheuseraccesslistanddefinestheuserroleashavingstorageorguestprivileges.
Options-u,--usernameSpecifiesausername.
Themustalreadybedefinedonthecomputerintheoperatingsystem.
userrolestorage|guestSpecifiesthenewuser'srole.
storage-Providesfullstorageconfigurationandmonitoringaccess.
guest-Allowsusertoviewbutnotchangestorageconfigurations.
Chapter3MonitoringandAdministrationCommandsforAllArrays29listalarmProvidesdetailedinformationonaspecifiedalarmorsummaryinformationonallalarms.
Synopsislist[-s][-f][-a][-S]alarm[]DescriptionProvidesdetailedinformationonaspecifiedalarms.
WhenalarmIDsarenotspecified,itprovidessummaryinformationonallalarms.
Options-a,--advisorservice-advisor-IDListstheServiceAdvisorID.
-s,--severitySpecifiesaseveritylevelatwhichtofilteralarmssothatonlythealarmsofthatseveritylevelarelisted.
SeverityLevels:0–minor1–major2–critical3-failure-f,--faultdevtypeSpecifiesthetypeofdevicetolist.
-S,--SummarySpecifiesthatthesystemreturnasummaryofalarminformation.
alarm[]Specifiesthealarmoralarmstodisplay.
Ifnoalarmisspecified,summaryinformationonallalarmsisdisplayed.
30SunStorageTekCommonArrayManagerCLIGuideOctober2008Examplessscslist-fj4200alarmsscslist-s2alarmsscslist-s1-aalarmResponseFormat(whennoadvisoroptionisspecified)AlarmID:IDSeverity:severityType:typeTopic:topicEventCode:event-codeDate:dateDevice:device-idDescrip.
:DescriptionResponseFormat(whentheadvisoroptionisspecified)AlarmID:IDSeverity:severityType:typeTopic:topicSERVICEADVISOREventCode:event-codeEventType:event-typeSeverity:severity-levelSampleDescription:event-DescriptionInformation:event-informationProbableCause:probable-causeChapter3MonitoringandAdministrationCommandsforAllArrays31RecommendedAction:recommended-actionDate:dateDevice:device-IDDescrip.
:DescriptionlistarrayListsdetailedinformationaboutspecifiedarraysorallarraynames.
Synopsislistarray[]DescriptionListsdetailedinformationaboutoneormorearrays.
Ifyoudonotspecifyanarrayname,thenallarraynamesarelisted.
ExamplesSummaryofarrayswhennovalueisspecified:sscslistarrayResponseFormatArray:array-name.
.
.
Array:array-nameDetailofarraywhenthevalueisspecified(showsarraywithraidcontroller):sscslistarrayarray0032SunStorageTekCommonArrayManagerCLIGuideOctober2008ResponseFormatArray:array-nameArrayType:array-typeSerialNumber:serial-numberFirmwareVersion:firmware-versionArrayWWN:array-WWNHealthStatus:OK|DegradedHot-SparePoolDisks:number-of-hot-spare-drives(FC,SATA,andSAS)NodeWWN:node-WWNDefaultHostType:host-typeDefaultCacheBlockSize:4K|16KDefaultCacheStart%:DefaultCacheStop%:DiskScrubbing:Disabled|EnabledFailoverAlertDelay:1.
.
300minutesHealth:OK|LostContact|.
.
.
TrayID:tray-IDHost:host-name.
.
.
Host:host-nameHostGroup:host-group.
.
.
HostGroup:host-groupPool:pool-name.
.
.
Pool:pool-nameChapter3MonitoringandAdministrationCommandsforAllArrays33listdateListsthecurrentdateandtimeforthearrayinhours,minutes,andseconds.
(Notsupportedbyj450andB6000JBODs.
)Synopsislist-adateDescriptionListsthecurrentdateandtimeforthearrayinhours,minutes,andseconds.
Thetimezoneofthemanagementsystemisassumedtobethetimezoneofthearray.
Options-a,--arraySpecifiesthearrayforwhichyouwanttoseethedate.
Examplessscslist-aarray00dateResponseFormatDate:weekdaymonthdayHH:MM:SSYYYYExampleTueDec2016:09:362004listdeviceProvidesdetailedinformationonaspecifieddeviceorsummaryinformationonalldevices.
Synopsislist[-n][-i]device[device-ID[,device-ID.
.
.
]]34SunStorageTekCommonArrayManagerCLIGuideOctober2008listdevicesDescriptionListthedetailsofadeviceorthedevicesbeingmonitored.
Options-n,--nameSpecifiesthedevicenameforwhichyouwanttoseethedetails.
Ifnodeviceisspecified,summaryinformationforalldevicesisdisplayed.
-i,--ipSpecifiestheIPaddressoftheconnectedhostwhenusingremoteproxy.
device-IDSpecifiesoneormoredeviceIDs.
Examplessscslist-n2540_array1deviceDeviceName:2540_array1Type:2540IPAddress:10.
nn.
nn.
nMonitoredOn:sp-72Key:SUN.
14617-00.
0617053335Active:YWWN:200400a0b82458a0AlternateIP:10.
nn.
nn.
nAltIPNumber:10.
nn.
nn.
nManagementLevel:DSaid:600A0B80002458810000000045A7B14ETimeAdded:2008-10-0311:44:11PortWWNs:200400a0b82458a1,200400a0b82458a2,200500a0b82458a1,200500a0b82458a2sscslist-i10.
1.
1.
1devicesscslistdeviceChapter3MonitoringandAdministrationCommandsforAllArrays35ResponseFormatDeviceName:device-IDType:typeIPAddress:IP-addressMonitoredOn:interfaceKey:device-keyActive:IsthedeviceactiveY|NWWN:WorldWideNameMgmtLevel:management-levelSaid:Storage-Automated-Diagnostic-Environment-IdentifierTimeAdded:timeaddedlistdevicesProvidessummaryinformationonalldevices.
SynopsislistdevicesDescriptionListasummaryofthedevicesbeingmonitored.
Options--Exampleslistdevices36SunStorageTekCommonArrayManagerCLIGuideOctober2008MonitoredOnDeviceTypeIPAddressWWNActiveASRsp-722540_array1254010.
nn.
nn.
n200400a0bnnnnnnnYNsp-726140_array2614010.
nn.
nn.
n200400a0bnnnnnnnYNsp-726140_array3614010.
nn.
nn.
n200400a0bnnnnnnnYNResponseFormatMonitoredOn:interfaceDeviceArray/systembeingmonitoredTypeArray/systemmodelIPAddressIP-addressWWNWorldWideNameActiveIsthedeviceactiveY|NASRIsAutoServiceRequestonY|NlistdiskListthediskinformationonanarray.
Synopsislist-adisk[]DescriptionListsdiskinformation.
Options-a,--arraySpecifiesthenameofthearraywherethediskresides.
diskChapter3MonitoringandAdministrationCommandsforAllArrays37Thisoptionprovidesdetailedinformationonthespecifieddisks.
Whendisksarenotspecified,thisoptionprovidesdetailedinformationonallthedisksinthetray.
Examplessscslist-aarray00-t1diskResponseFormatTray:tray-IDDisk:disk-nameCapacity:disk-capacityType:SAS|SATASpeed(RPM):speed-in-revolutions-per-minuteStatus:Optimal|In-use|Available|FailedState:Enabled|DisabledRole:DataFirmware:firmware-version-numberSerialnumber:serial-numberWWN:WWN-numberlisteventListstheFaultManagementService(FMS)eventloginformation.
Synopsislist[-s][-d][-t][-a][-f][-l]event[]DescriptionListstheFMSeventloginformation.
Youcanfilterbydevicetypeandseveritylevel.
Options-s,--severity38SunStorageTekCommonArrayManagerCLIGuideOctober2008Specifiesaseveritylevelatwhichtofiltereventssothatonlytheeventsofthatseveritylevelarelisted.
SeverityLevels:0–warning1–error2–critical3-failure-d,--deviceListonlyeventsforthegivendevice.
-t,--typeListonlyeventsofthegiveneventtype.
-a,--aggregatedSpecifiesthatalleventsarelistedandaggregatedsothatrelatedeventsaregroupedtogether.
-f,--filterFilteroutputontheeventDescriptionbyusingthegivenkeywordparameter.
-l,--lastLimitthenumberofeventsprintedbythegivennumber.
eventSpecifiestheeventID.
Examplessscslist-s3eventResponseFormatSeverity:MinorDate:FriMar1010:39:57MST2006Device:diag-lsi1(J4200)Component:Sim.
0Type:ProblemChapter3MonitoringandAdministrationCommandsforAllArrays39EventCode:Aggregated:NoDescription:NewproblemREC_NON_FRU_BATTERY_NEAR_EXPIRATIONt0ctrl2:39discoveredondiag-lsi1"t0ctrl2".
listfirmwareListsthefirmwareversionsofthefield-replaceableunits(FRU)inthisdevice.
Synopsislist[-a][-t][-x]firmwareDescriptionListsthefirmwareversionsofthefield-replaceableunitsinthisdevice.
YoucandefinetheFRUstoincludeorexclude.
Options-a,--arrayShowsthefirmwarerevisionlevelofthefield-replaceableunitsforthespecifiedarrayonly.
-tShowsthefirmwarerevisionlevelforthespecifiedcomponenttype.
-x,--excludeExcludesthespecifiedcomponenttypefromthelistoffirmwarerevisionlevels.
ExamplesListthecomponentfirmwarerevisionsforallarrays.
sscslistfirmwareListthecomponentfirmwarerevisionsforaspecifiedarray.
40SunStorageTekCommonArrayManagerCLIGuideOctober2008sscslist-ajbod1firmwarelistfruListsthefield-replaceableunits(FRUs)inthisdevice.
Synopsislist-d[-t][-s]fru[string,.
.
.
]DescriptionListsthefield-replaceableunitsinthisarray.
Youcanfilterbycomponenttype.
Options-d,--deviceThearraynameorarrayID.
-t,--typeSpecifiesthetypeoffield-replaceableunitsinstalledinthisdevicetolist.
Usethe-soptiontoseewhichFRUtypeswouldbevalidforthechosendevice.
Forexample,fortheJBODarraysvalidtypesare:disk|fans|powersupplies|sim|all-s,--summaryListsasummaryofthisfield-replaceableunit.
fru[string,.
.
.
]Liststhefield-replaceableunitorunitsinthisdevice.
Examplessscslist-djbod1fruOutputincludesthecomponentname,FRUtype,alarmstate,status,revision,anduniqueID.
sscslist-dnenc-447-tall-sfruTypeDescriptionAlarmInstalledSlotCountChapter3MonitoringandAdministrationCommandsforAllArrays41batterybatteryMajor22ctrlctrlCritical22diskdisk-1032iccicc-11iomiom-44midplanemidplane-33pcupcuCritical66sfpsfpCritical824listjobsListsjobIDsandstatusassociatedwiththespecifiedarrayandoptionallyspecifiedjobID.
Synopsislist-aarray-namejobs[job-id[,job-id.
.
.
]]DescriptionListsjobIDsandstatusassociatedwiththespecifiedarrayandoptionallyspecifiedjobID.
Options-a,--arraySpecifiesthenameofthearray.
job-idSpecifiesthejobID.
Examplessscslist-ajbod1jobs42SunStorageTekCommonArrayManagerCLIGuideOctober2008JobID:Install:task27Status:DoneJobID:Install:task36Status:DoneJobID:Install:task32Status:DoneJobID:Install:task35Status:DoneJobID:Install:task25Status:DoneJobID:Install:task24Status:DoneJobID:Install:task45Status:DoneJobID:Install:task30Status:DoneJobID:Install:task33Status:DoneJobID:Install:task34Status:Donesscslist-ajbod1jobsInstall:task27JobID:Install:task27Type:FirmwareUpgradeStatus:Done%Complete:100TimetoCompletion:00:00:00Priority:UnknownlistlogListstheuser-initiatedactionsperformedforallregisteredarrays.
Synopsislist[-s{[mmdd]HHMM|mmddHHMM[cc]yy}[.
SS]][-f{[mmdd]HHMM|mmddHHMM[cc]yy}[.
SS]][-t]logDescriptionListstheuser-initiatedactionsperformedforallregisteredarrays.
Youcanfilterthelistingsbydateandtimeormostrecententries.
Ifyoudonotspecifyanyoptions,alllogmessagesaredisplayed.
Options-s,--start{[mmdd]HHMM|mmddHHMM[cc]yy}[.
SS]Chapter3MonitoringandAdministrationCommandsforAllArrays43Listsalllogmessagesstartingatthedatespecifiedbythedateoptions.
Usewiththe-f,--finishsubcommandtospecifyadaterange.
-f,--finish{[mmdd]HHMM|mmddHHMM[cc]yy}[.
SS]Listsalllogmessagesendingatthedatespecifiedbythedateoptions.
Usewiththe-s,--startsubcommandtospecifyadaterange.
mmddSpecifiesthemonthandday.
Forexample,0331forMarch31.
HHMMSpecifiesthehourandminute.
Thehourisbasedona24-hourclock.
Forexample,1:30p.
m.
is1330.
ccSpecifiesthecenturypartoftheyear.
yySpecifiesthetwo-digityear.
.
SSSpecifiesthesecondsofthehour.
-t,--tailListsthemostrecentlogmessagesasspecifiedbynumber.
Examplessscslist-t100logListsthelast100messages.
ResponseFormatTimestamp:messagelistmgmt-swSynopsis44SunStorageTekCommonArrayManagerCLIGuideOctober2008listmgmt-swDescriptionListsthemanagementsoftwareapplicationthatyouareloggedinto.
Examplessscslistmgmt-swResponseFormatApplicationName:"SunStorageTek(TM)CommonArrayManager"User:storageCurrentLogins:2Server:10.
8.
88.
173ServerOS:SunOSServerOSVersion:5.
10ProductVersion:4.
2.
0.
0BuildDate:2005/12/03InstallInfo:4.
2.
0.
0Build61CriticalAlarms:13DownAlarms:0MajorAlarms:24MinorAlarms:0listnotificationSynopsislistnotificationDescriptionChapter3MonitoringandAdministrationCommandsforAllArrays45Liststheremotenotificationprovideranditsstatus.
ExamplessscslistnotificationResponseFormatEntryEmail/EventsTypeDevicePriorityEventsenter-noemail-addressnotification-typedevice-typepriorityeventsProviderActiveHeartbeat(hrs)IPprovideractive-flagfrequencyIPAddressTrap#IPName/AddressPortMinAlertLeveltrap-noIPAddressPortTraplevellistregisteredarrayListsregisteredarrayinformation.
Synopsislist-a[]registeredarrayDescriptionListsregisteredarrayinformationorthenamesofallarrays.
Options-a,--arraySpecifiestheregisteredarrayorarraystolist.
Ifnoarraysarespecified,alistofallarraynamesisprovided(optional).
46SunStorageTekCommonArrayManagerCLIGuideOctober2008Examplessscslist-aarray01registeredarrayResponseFormat(summaryifnovaluesarespecified)ArrayName:array-name.
.
.
ArrayName:array-nameResponseFormat(detailifvaluesarespecified)ArrayName:array-nameIPAddress:IP-address.
.
.
IPAddress:IP-addresslistsiteSynopsislistsiteDescriptionListspertinentinformationonthesite.
Examplesscslistsite*CompanyName:SunMicrosystems*SiteName:InteropLabChapter3MonitoringandAdministrationCommandsforAllArrays47Address:Address2:MailStop:*City:BroomfieldState:*Country:USA*ContactFirstName:Fred*ContactLastName:JonesTelephoneNumber:Extension:*ContactEmail:Fred.
Jones@sun.
comliststorage-systemListsdetailedinformationaboutoneormorearrays.
Synopsisliststorage-system[]DescriptionListsdetailedinformationaboutoneormorearrays.
Ifyoudonotspecifyanarrayname,thenallarraynamesarelisted.
Examplessscsliststorage-systemResponseFormat(Summaryofarrayswhennovalueisspecified)Array:array-name.
.
.
48SunStorageTekCommonArrayManagerCLIGuideOctober2008Array:array-nameDetailofarraywhenthevalueisspecified).
/sscsliststorage-systemFlx380-1Name:Flx380-1ID:Flx380-1Type:6140Version:06.
19.
25.
26Vendor:SUNMicrosystemsModel:SunStorEdge6140SystemCapacity:367039329280AvailableCapacity:110674668544listuserroleListstheusernameandroledefiningtheuser'sarrayprivileges.
Synopsislistuserrole[storage|guest]DescriptionListstheusernameandroledefiningthearrayprivileges.
Optionsuserrolestorage|guestListtheuserswiththespecifiedrole.
Thestorageroleallowswriteaccesssothattheusercanconfigurethearray.
Theguestrolecanonlymonitorthearray.
ExamplesscslistuserrolestorageChapter3MonitoringandAdministrationCommandsforAllArrays49ResponseFormatUserName:user-nameUserRole:user-role.
.
.
UserName:user-nameUserRole:user-roleloginLogintothesscscommand-lineinterface(CLI).
Synopsislogin-h[-sCAM|Legacy][-t][-f]-uDescriptionLogintothesscscommand-lineinterface(CLI)onthemanagementsystemspecifiedbythe-h.
ThiscommandstartsaCLIsessiononthemanagementhost.
TherearetwoformsoftheCLI:LocalRemoteTheonlydifferenceisthatthelocalCLIrequiresauserhastorunthecommandasadministratorfromashellonthemanagementhostandbecauseofthislimitationtheloginandlogoutcommandsaren'tsupported.
BothCLIscanmanageanyarraythathasbeenregisteredandaddedtotheCommonArrayManagerinventoryinthesamewaythatthebrowserinterfacecanmanageanyarrayintheinventory.
Thearraytypeandarraymanagementpath(in-band,out-of-band,proxyagents)hasnolimitationswithlocalorremoteCLIusage.
BothCLIsmanagethesamearrayswiththesamecommandset.
LoggingInandOutUsingtheCLIThefollowingexplainshowtologintoandoutofathemanagementhostusingtheCLI.
TheoptionsforaccessingtheCLIarepresentedinthenextsection.
TherearedifferentCLIdirectoriesfortheremoteandlocalCLIs.
1.
TelnetorsshtotheCAMworkstation.
50SunStorageTekCommonArrayManagerCLIGuideOctober2008sshroot@cam_workstation12.
ChangetotheCLIdirectory(variesbyoperatingsystem).
a.
AccesstheremoteCLIdirectory:Solaris-/opt/SUNWsesscs/cli/binLinux-/opt/sun/cam/se6x20/cli/bin/sscsWindows-:\ProgramFiles\Sun\CommonArrayManager\Component\sscs\bin3.
LogintotheremoteCLIbytypingthefollowingcommand:%sscslogin-h-uNote–TheLocalCLIonadatahostdoesnotrequirethelogincommand.
Youwillneedtheterminalwindowlogintothehost.
b.
AccessthelocalCLIdirectory:Solaris-/opt/SUNWstkcam/binLinux-/opt/sun/cam/binWindows-:\ProgramFiles\Sun\CommonArrayManager\binNOTE:sscshasaninactivitytimer.
Thesessionterminatesifyoudonotenteranysscscommandsfor30minutes.
Youmustloginagainbeforeyoucanenteracommandafterthetimeout.
Options-h,--hostnameRequired.
Specifiesthemanagementhostname.
-s,--system-typeCAM|LegacyOptional.
ThisoptionspecifieswhetheryouareloggingintoanyofthecurrentarrayssupportedbytheCommonArrayManagerorthenowlegacy6920array.
Insomecases,usingthe-sCAMoptionmaylogyouinfasterasitskipsastepoflisteningforaresponsefromthelegacyarray.
Younolongerhavetospecifythearray-typetologin.
-t,--httpChapter3MonitoringandAdministrationCommandsforAllArrays51EnablesyoutousetheHTTPprotocoltoconnecttotheCAMserver,insteadofHTTPS.
AnHTTPconnectorisconfiguredinTomcat,theservletcontainerinJava,fortheJavaWebConsoleatport6789.
IfSSLisnotfunctioningbetweentheclientandtheserver,thismightberequired.
-f,--forceExistsforbackwardcompatibilitywithlegacymanagementapplicationsthatonlyallowoneloginperuser.
Thisoptionforcesalogintothemanagementhost.
Ifanotheruserwiththesameusernameisalreadyloggedon,theduplicateuseristhenloggedoff.
-u,--usernameSpecifiestheusernamethattologin.
Example.
/sscslogin-hlocalhost-urootlogoutSynopsislogoutDescriptionLogsoutoftheremotesscscommand-lineinterfacesession.
modifyagentModifythefaultmanagementagentparameters.
Synopsismodify[-a][-d][-r][-i]agent[]Description52SunStorageTekCommonArrayManagerCLIGuideOctober2008Modifythefaultmanagementagentparameters.
FaultManagementService(FMS)periodicallyscansdevicesfornewmessagesandupdatedhealthstatus.
Thiscommandallowschangingthescanintervalaswellasenablingordisablingthescan.
Ifnooptionsaregiventhecurrentagentsettingsareprintedout.
Internalagentpropertiescanbesetbyusingname=valueforthestringsontheagent.
Themostcommonpropertytobesetisdebug=0,1,2,3toturnonagentdebugging.
sscsmodifyagentdebug=3Allotherpropertiesareforserviceonly.
Options-a,--activateSpecifiesthatthesystemactivatethemonitoringagent.
-d,--deactivateSpecifiesthatthesystemdeactivateorturnoffthemonitoringagent.
-r,--runSpecifiesthatthesystemscheduletheagenttoruneitherimmediatelyorassoonasthecurrentlyscheduledrunhasfinished.
-i,--intervalSpecifiestheinterval,inminutes,beforetheagentscanruns.
agent[]Specifiestheagentthatyouwanttomodify.
ThenameoftheagentmonitoringthedevicecanberetrievedusingthelistdevicecommandExamplessscsmodify-i5agentmodifyarraySynopsismodify[-N]arrayChapter3MonitoringandAdministrationCommandsforAllArrays53DescriptionModifiesthenameassignedtothearray.
Note–RefertothemodifyarraycommandinChapter4fortheextensiveconfigurationoptionsthatapplytoarrayswithraidcontroller.
Options-N,--new-array-nameSpecifiesthenewnameofthearray.
arraySpecifiesthenameofthearraytobemodified.
Examplessscsmodify-narray2arrayjbod1modifyfirmwareModifiesthefirmwareversionsofthespecifiedfield-replaceableunits(FRUs)ofthespecifiedarray.
Synopsismodify-a[-f]-o[-tsim|disk][-xsim|disk][-p][-c][-w]firmwareDescriptionModifiesthefirmwareversionsofthespecifiedfield-replaceableunitsofthespecifiedarray.
Options-a,--arrayModifiesthefirmwarerevisionlevelofthespecifiedfield-replaceableunitsforthespecifiedarrayonly.
54SunStorageTekCommonArrayManagerCLIGuideOctober2008-c,--componentModifiesthefirmwarefortheselectedcomponents.
Togetthevalidvalues,executethesscslist-afirmwarecommand.
UseeithertheNameorModelfieldvalues.
-f,--forceModifiesthefirmwarerevisionleveloftheallfield-replaceableunitsevenifthefirmwarerevisionlevelisalreadyatthebaselinelevel.
-o,--offlinePerformsanofflineupgradeofthespecifiedcomponent(s).
-p,--pathSpecifiesthepathofthefirmwareimagefile.
Loadsfirmwarefromafiledirectlyontothearray.
Cautionshouldbeexercisedwhenusingthiscommandbecauseunsupportedfirmwarecanbeloadedontoafield-replaceableunit.
If-poptionisprovided,the-coptionisrequired.
-t,--typeModifiesthefirmwarerevisionlevelofthefield-replaceableunitsofthespecifiedtypeonly.
-w,--no-warnModifiesthefirmwarewithoutdisplayingthestandardwarning.
-x,--excludesim|diskExcludesthespecifiedcomponentfrombeingupgraded.
Examplesmodify-aMyArray-ffirmwaremodifymgmt-swSynopsismodify-Xmgmt-swDescriptionChapter3MonitoringandAdministrationCommandsforAllArrays55Storesthespecifiedstoragesystemnameforthesession.
Thiscommandisusefulforrepeatedoperationswithanarray.
Afterthiscommandisexecuted,the-aoptionforsubsequentsscscommandsisnotnecessary.
Options-X,--storage-systemSpecifiesthenameofthestoragesystem.
Examplemodify-XMyArraymgmt-swmodifyregisteredarrayChangethelocallystoredpasswordforaregisteredarray.
Synopsismodify-a-qregisteredarrayDescriptionModifiesthelocallystoredpasswordforaregisteredarrayorqueriesforthecurrentpassword.
Options-a,--arraySpecifiesthenameofthearraytobemodified.
-q,--query-for-passwordQueriesforthecurrentpasswordfortheregisteredarray.
Examplessscsmodify-aarray00-qregisteredarrayNewPassword:myregisteredarray56SunStorageTekCommonArrayManagerCLIGuideOctober2008Re-enterNewPassword:myregisteredarraymodifysiteModifiesthesitepropertiesforthisinstanceofCAM.
Synopsismodify[-r,.
.
.
]site[,.
.
.
]DescriptionModifiesthesitepropertiesforthisinstanceofCAM.
Thesitepropertiescontaininformationaboutthesiteandprovidesinformationneededforthenotificationproviders.
Options-r,--removeRemovesthespecifiedsiteinformation.
siteModifiesexistingsitesettingsoraddsnewsiteinformation.
Possiblevaluesforsite_infoare:customer,contract,name,address,address2,mailStop,city,state,country,contact,phone,email.
Possiblevaluesforvalueconsistofanalphanumericstring.
Ifthestringincludesspaces,enclosethevaluesinquotes.
Examplessscsmodifysitename="DevelopmentLab"sscsmodify-rnamesitemodifystorage-systemModifiesthearrayinformation.
SynopsisChapter3MonitoringandAdministrationCommandsforAllArrays57modify[-N][-d][-u][-q][-U][-Q]storage-systemDescriptionModifiesarrayinformationsuchasarrayname,description,andusername.
Options-d,--DescriptionProvidesatextualdescriptionofthearray.
-N,--new-nameChangesthearrayname.
-q,--query-for-passwordChangesthearraypassword.
-u,--user-nameChangesausernameonthearray.
storage-systemSpecifiesthearraywherethechangeswilltakeeffect.
Examplesscsmodify-qstorage-systemMyArrayEnterthearraypassword:Confirmpassword:modifyuserroleChangetheuserroleortheIPaddressfromwhichtheusercanlogin.
Synopsissscsmodify-u-p-iANY|userrole[storage|guest]58SunStorageTekCommonArrayManagerCLIGuideOctober2008DescriptionModifiesauserroleortheIPaddressfromwhichtheusercanlogin.
Thestoragerolecanperformconfigurationchangeswhiletheguestrolecanjustmonitoranarray.
Options-u,--usernameSpecifiestheusernamethathasanassignedrole(storageorguest).
-p,--password-requiredtrue|falseSpecifieswhethertorequireuserloginwithapassword.
-i,--ip-addressANY|SpecifiestheIPaddressesfromwhichtheusercanlogin.
YoucanlettheuserloginfromanywhereorrestrictaccesstospecifiedIPaddresses.
userrolestorage|guestSpecifiestheroleassignedtotheuser.
Examplessscsmodify-ubsmith-ptrue-iANYuserroleguestregisterstorage-systemSynopsisregister-i[-p][-u][-q][-U][-Q]storage-systemregister-dstorage-systemDescriptionRegistersastoragesystemwiththehost.
Options-d,--discoverChapter3MonitoringandAdministrationCommandsforAllArrays59Specifiesthatthehostwilldiscoveraregisteredarray.
-i,--ipaddressSpecifiestheIPaddressofthestoragesystemthatyouwanttoregister.
-p,--portSpecifiestheportIDofthestoragesystemthatyouwanttoregister.
-u,--userstorage|root|guestSpecifiestheusernamethathasanassignedrole.
-q,--query-for-passwordSpecifieswhethertoqueryforapasswordforthisregisteredstoragesystem.
-U,--device-specific-userSpecifiesaspecificnameforthisdevice.
-Q,--query-for-device-specific-passwordSpecifieswhethertoqueryforaspecificpasswordforthisregistereddevice.
registersun-connectRegistersCAMsoftwareandallmonitoredarrayswithAutoServiceRequest.
Synopsisregister[-u][-H][-P][-U][-eall|telemetry][-d]sun-connectDescriptionRegistersCAMsoftwareandallmonitoredarrayswithAutoServiceRequest.
AutoServiceRequestmonitorsthearraysystemhealthandperformanceandautomaticallynotifiestheSunTechnicalSupportCenterwhencriticaleventsoccur.
CriticalalarmsgenerateanAutoServiceRequestcase.
ThenotificationsenableSunServicetorespondfasterandmoreaccuratelytocriticalon-siteissues.
Allnewlydiscoveredarrayswillalsoberegisteredwiththesavedregistrationoptions.
Options-d,--disableall|telemetry60SunStorageTekCommonArrayManagerCLIGuideOctober2008Disablesalltelemetrymechanisms.
-e,--enableall|telemetryEnablesalltelemetrymechanisms.
-H,--proxyHostSpecifiestheproxyhostname.
-P,--proxyPortSpecifiestheproxyportnumber.
-U,--proxyUserAproxyhostauthenticatedusername.
-u,--userSpecifiesavalidSunonlineaccountusername.
Togetonegoto:https://portal.
sun.
com/portal/dt/sun-connectSpecifiesthatyouareregisteringtheCAMsoftwareandallmonitoredarrayswithAutoServiceRequest.
Examplessscsregister-HProxy1-P8080-uMySunAcctId-etelemetrysun-connectremovealarmSynopsisremove[-f][-s0|1|2|3][-A]alarm[]DescriptionRemovesthecurrentalarms.
Options-f,--faultdevtypeChapter3MonitoringandAdministrationCommandsforAllArrays61Removesalarmsbythedevicetypeusingadevicekeyfilter.
-s,--severitystringSpecifiestheseveritylevelforwhichyouwanttoremovealarms.
SeverityLevels:0–minor1–major2–critical3-failure-A,--AllRemovesallofthealarms.
alarmSpecifiesthealarmIDoralarmIDsyouwanttoremove.
Examplessscsremove-f6140alarmsscsremove-s2alarmsscsremove-AalarmremovenotificationRemovesalocalorremotenotification.
Synopsisremove[-e]notificationlocal_email|email-filter|trapremove[-i][-o][-t1|2|3|4|5]notificationlocal_email|email-filter|trapremove-dnotificationlocal_email|email-filter|trapremove[-c][-e][-a]notification62SunStorageTekCommonArrayManagerCLIGuideOctober2008DescriptionRemovesalocalorremotenotification.
Options-a,--allSpecifiesthatallnotificationsshouldberemoved.
-c,--categoryRemovesthespecifiedcategoryIDnotification.
-d,--idRemovesthespecifieddeviceIDnotification.
-e,--emailStopsnotificationstothespecifiedrecipient.
-e,--eventStopsemailnotificationswiththespecifiedeventID.
-i,--ipStopssendingSNMPtrapdatatotheIPaddressofthespecifiedhost.
-t,--trapnumber1|2|3|4|5Stopnotificationsforthespecifiedtrapnumber.
-o,--portSpecifiestheportIDusedtotransfernotifications.
local-emailRemovesthenotificationfromyourlocalemailaddress.
email-filterRemovestheemailfilterfromthenotification.
trapRemovestheSNMPtrapnotification.
Examplessscsremove-ejohn.
doe@address.
comnotificationlocal_emailChapter3MonitoringandAdministrationCommandsforAllArrays63sscsremovenotificationnscc_emailsscsremove-t2notificationtrapremoveregisteredarrayRemovesoneormorearraysfromthelistofregisteredarrays.
Synopsisremove-aregisteredarrayDescriptionRemovesoneormorearraysfromthelistofregisteredarrays.
Options-a,--arraySpecifiestheregisteredarraystoremove.
Examplesscsremove-aarray00registeredarrayremoveuserroleRemovesauserroleassignedtoausername.
Synopsisremove-uuserrolestorage|guestDescriptionRemovestheprivileges(storageorguestrole)assignedtoausername.
Options64SunStorageTekCommonArrayManagerCLIGuideOctober2008-u,--usernameSpecifiestheusername.
userrolestorage|guestSpecifiestheuser'sroletoremove.
Examplessscsremove-ujf39992userroleguestservicePerformservice-relatedcommands.
Synopsisservice-a[contact|locate[-o]|print[-t]enable|disable|setname=|syncTime]DescriptionUsethiscommandtoperforminbandcommunicationtests,locateanarraybyturningitsLEDonoroff,printthecontentsofthearrayprofileorlogfile,changethenameofthearray,andsynchronizethetimeofaJBODarraywiththeattacheddatahost.
Options-a,--arraySpecifiesthearraytoperformaservice.
-t,--targetarrayprofile|logSpecifiesthetargetfiletoprint.
-o,--offTurnsoffthelocatorLED.
contactTestsconnectivitytothearray(inbandcommunicationtest).
Chapter3MonitoringandAdministrationCommandsforAllArrays65disableDisablesthespecifiedtargetdrive.
enableEnablesthespecifiedtargetdrive.
locateLocatesthearraybyturningLEDon.
name=Changesthenameofthearraytothespecifiedname.
printPrintsallphysicalinformationavailableforthespecifiedarray.
syncTimeSynchronizethetimeoftheJBODarraywiththeattachedhost.
ExamplesTurnoffallLEDlocateindicatorsonthespecifiedarrays.
sscsservice-d"JBOD(2029QTF0802QCK00E)"-tofflocateSettheJBODnametoJ4200_box1sscsservice-d"JBOD(2029QTF0802QCK00E)"name=J4200_box1setDisabledrive00onthearraynamedJ4400_box3.
sscsservice-aj4400_box3-tdrive00disableunregisterstorage-systemSynopsisunregisterstorage-systemDescriptionUnregistersanarrayfromthelistofregisteredstoragesystems.
66SunStorageTekCommonArrayManagerCLIGuideOctober2008Optionsstorage-systemSpecifiesthestoragesystemorstoragesystemsthatyouwanttounregisterfromthelistofregisteredstorage-systems.
Examplesscsunregisterstorage-systemarray19unregistersun-connectionStopnotificationsofsystemhealthandperformancetoSunusingtheAutoServiceRequest(ASR)feature.
Synopsisunregistersun-connectionDescriptionStopssendingsystemhealthandperformanceinformationonmonitoredarraysbacktoSun.
NewlydiscoveredarrayswillnotbeactivatedwithASR.
Examplessscsunregistersun-connectversionShowstheversionsofsoftwarethatyouarerunningonthemanagementhostandtheSSCSclient.
Synopsis-V,--versionDescriptionChapter3MonitoringandAdministrationCommandsforAllArrays67Showstheversionsofsoftwarethatyouarerunningonthisarrayandtheclient.
Examplessscs-VSunStorageTek(TM)CommonArrayManagerv6.
1.
1.
0sscsclientv1.
1.
468SunStorageTekCommonArrayManagerCLIGuideOctober200869CHAPTER4ConfigurationCommandsforArrayswithRAIDControllersThischapterdescribesthesscscommandsandtheiroptionsforarrayswithraidcontrollers,includingtheSunStorEdgeTM6130array,SunStorageTekTM6140and6540arrays,SunStorage6580and6780arrays,SunStorageTek2500Seriesarrays,andFlexLineTM240,280,and380Systems.
.
addhostgroupSynopsisAddshoststoahostgroup.
add-a-hhostgroupDescriptionAddshoststoahostgroup.
Options-a,--arraySpecifiesthearrayassociatedwiththishost.
70SunStorageTekCommonArrayManagerCLIGuideOctober2008-h,--hostSpecifiesthehostorhoststhatyouwanttoaddtothehostgroup.
hostgroupSpecifiesahostgroupnameofupto16alphanumericcharacters,underscores,dashes,andspaces.
Examplessscsadd-aarray00-hhost01,host02hostgrouphg01addlicenseAddsalicensetothespecifiedarray.
Synopsisadd-a[-l|-v-c-d]licenseDescriptionAddsalicensetothespecifiedarray.
Specifyeitherthe-loptionalone,orthe-v,-c,and-doptionstogether.
Options-a,--arraySpecifiesthearraytoassociatewiththislicense.
-c,--capabilitySpecifiesthetypeoflicensetobeadded:Snapshots,StorageDomains,ReplicationSets(notapplicableto2500Seriesrunningfirmwareversion07.
35.
04.
10),andVolumeCopyPairs(notapplicableto2500Series).
-d,--digestSpecifiesthesecuritydigestkeyforaccesstothislicense.
-l,--licenseChapter4ConfigurationCommandsforArrayswithRAIDControllers71Specifiesthelicensetoassociatewiththisarray.
Thelicenselocationshouldspecifythelocationofthe6140arraylicensefile.
ThiscanbeintheformofaURL(http://.
.
.
orfile:orafilename.
-v,--versionSpecifiesthenumberofthelicenseversion.
Examplessscsadd-acorporate-lhttp://server/6140/snapshot-licenselicenseAddsalicensetothecorporatearrayfromthespecifiedURL.
sscsadd-acorporate-v1-cReplicationSet-d7A906509CBB33911C06F83BD2BCA1B3375789AB7licenseAddsreplicationsetfeaturelicensestothesamplecorporatearrayforversion1usingthelicensedigeststringprovidedbySunMicrosystems.
createhostCreatesastoragehost.
Synopsiscreate-a[-g]hostcreate-a[-g][-w]hostDescriptionCreatesastoragehostwheredataisinitiated.
Youcancreateupto256hostsperarrayonthe6130/6140arraysand32hostsonthe6540array.
Options-a,--arraySpecifiesthenameofthearrayonwhichyouwanttocreateahost.
Forcross-platformcompatibility,youcansubstitute-X,--storage-deviceinplaceofthe-a,--arrayoption.
-w,--wwn72SunStorageTekCommonArrayManagerCLIGuideOctober2008SpecifiestheinitiatorWorldWideName(WWN).
-d,--descriptionSpecifiesthehostdescription.
-g,--hostgroupSpecifiesahostgroupwithwhichyouassociatethisnewhost.
hostSpecifiesthenameofthehostthatyouwanttocreate,usingupto16alphanumericcharacters,underscores,dashes,andspaces.
Examplessscscreate-aarray00hosthost1createhostgroupCreatesastoragehostgroup.
Synopsiscreate-ahostgroupDescriptionCreatesagroupofhoststosharestorage.
Youcancreateupto256hostgroupsperarray.
Youcancreateupto256hostgroupsperarrayonthe6130/6140arraysand32hostgroupsonthe6540array.
Options-a,--arraySpecifiesthearrayonwhichyouwanttocreateahostgroup.
hostgroupSpecifiesthenameofthehostgroupthatyouwanttocreate,usingupto16alphanumericcharacters,underscores,dashes,andspaces.
Chapter4ConfigurationCommandsforArrayswithRAIDControllers73Examplessscscreate-aarray00hostgrouphg1createinitiatorCreatesaninitiator.
Synopsiscreate-a-w[-h][-osolaris_dmp|solaris|sun_storedge|sun_storedge_nas_gateway|aix|hpux|linux|lnxavt|irix|ptx|netware_failover|netware_non_failover|win2k_clustered|win2k_non_clustered|winnt|winnt_non_clustered|win2k_non_clustered_dmp|win2k_clustered_dmp|dsp|aixavt|winnt_clustered]initiatorDescriptionCreatesaFCinitiatoronahost.
Options-a,--arraySpecifiesthearray.
Forcross-platformcompatibility,youcansubstitute-X,--storage-deviceinplaceofthe-a,--arrayoption.
-w,--wwnSpecifiestheinitiatorWorldWideName(WWN).
Forexample:210000e08b047212.
-h,--hostSpecifiesthedatastoragehostname.
-o,--os-typeUsethecommandsscslist-aarray-nameos-typetoviewalloftheoperatingsystemsthataresupportedbythearray.
initiatorSpecifiesaninitiatornameofupto16alphanumericcharacters,underscores,dashes,andspaces.
74SunStorageTekCommonArrayManagerCLIGuideOctober2008Examplessscscreate-aarray00-w210000e08b047212-hhost01-oaixinitiatormyInitiator-01createiscsiinitiatorCreatesaniSCSIinitiatoronahost.
Synopsiscreate-a[-h][-o][-i][-u][-c]initiatorDescriptionCreatesaniSCSIinitiatoronahost.
Options-a,--arraySpecifiesthearray.
Forcross-platformcompatibility,youcansubstitute-X,--storage-deviceinplaceofthe-a,--arrayoption.
-h,--hostSpecifiesthedatastoragehostname.
-o,--os-typeUsethecommandsscslist-aarray-nameos-typetoviewalloftheoperatingsystemsthataresupportedbythearray.
-i,--IQNSpecifiestheiSCSIqualifiedname(IQN)fortheinitiator.
-u,--authenticationChapter4ConfigurationCommandsforArrayswithRAIDControllers75SpecifiestousetheChallengeHandshakeAuthenticationProtocol(CHAP)authenticationmethodforaccessingthetarget.
ValuesareCHAPornone.
-c,--chap-secretSpecifiestheCHAPsecretID(upto256alphanumericcharacters)usedtoauthenticatethetarget.
initiatorSpecifiesaninitiatornameofupto16alphanumericcharacters,underscores,dashes,andspaces.
Examplessscscreate-aIEC_iSCSI_LCA-hMyhost_19852-osolaris-iiqn.
2001-06.
com.
sun:fvt3init21.
sys1-uCHAP-c123123123123123123initiatorinitiSCSIcreatepoolCreatesanemptystoragepoolonthearray.
Synopsiscreate-a-p[-d]poolDescriptionCreatesanemptystoragepoolonthearrayandassignsaprofiletoit.
Options-a,--arraySpecifiesthearray.
Forcross-platformcompatibility,youcansubstitute-X,--storage-deviceinplaceofthe-a,--arrayoption.
-d,--descriptionSpecifiesadescriptionofthepool.
Thedescriptioncanbeupto256alphanumericcharacters,whichcanincludeunderscores,dashes,colons,commas,parentheses,curlybrackets,squarebrackets,ticks,tildes,bars,periods,orspaces.
76SunStorageTekCommonArrayManagerCLIGuideOctober2008-p,--profileSpecifiesaprofiletoassociatewiththepool.
poolSpecifiesapoolnameofupto16alphanumericcharacters,underscores,dashes,andspaces.
Examplessscscreate-aarray00-pDatabasepoolSP048763createprofileCreatesastorageprofileonthearray.
Synopsiscreate-a-r-s-h-n[-k][-H][-d]profilecreate-a-r-s-h-n[-k][-H][-d]profileDescriptionProfilesforthemostcommonconfigurationscomewiththesoftware.
Thiscommandcreatesacustomstorageprofileandassignsittoanarray.
Options-a,--arraySpecifiesthearrayname.
--d,--descriptionSpecifiesaprofiledescriptionofupto256alphanumericcharacters,whichcanincludeunderscores,dashes,colons,commas,parentheses,curlybrackets,squarebrackets,ticks,tildes,bars,periods,orspaces.
-k,--disk-typeANY|FC|SAS|SATAChapter4ConfigurationCommandsforArrayswithRAIDControllers77Specifiesthedisktype:ANY-Anytypeofdisk,includingFC,SATA,orSASFC-FibreChannelSATA-SerialAdvancedTechnologyAttachmentSAS-SerialAttachedSCSI-h,--readaheadon|offSpecifieswhetherthereadaheadoptionisonoroff.
-H,--hot-spareyes|noSpecifieswhetheryouwantthisdisktobeadesignatedhot-spare.
-n,--number-of-disksvariable|Specifiesthenumberofdisksfrom1to224,incombinationwithraidlevels0or1.
Variableindicatesthatthenumberofdisksisnotfixedandcanchange.
-n,--number-of-disksvariable|Specifiesthenumberofdisksfrom1to30,incombinationwithraidlevels3,5,and6.
Variableindicatesthatthenumberofdisksisnotfixedandcanchange.
-r,--raid-level0|1SpecifiesRAIDlevel0or1,incombinationwithnumber-of-disks1to224.
-r,--raid-level3|5|6SpecifiesRAIDlevel3,5,or6,incombinationwithnumber-of-disks1to30.
-s,--segment-size16K|32K|64K|128K|256K|512KSpecifiesthesegmentsize.
profileSpecifiesaprofilenameofupto32alphanumericcharacters,underscores,dashes,andspaces.
Examplessscscreate-aarray00-r1–s64K–hon–nvariable–DFC–dCustom-Database-ProfileprofileDatabaseProfile78SunStorageTekCommonArrayManagerCLIGuideOctober2008createrepsetCreatesastoragereplicationsetusingapeerWorldWideNameorremotearrayname(notapplicableto2500Series).
Synopsiscreate-a-l-w-o-msync|async[-Gyes|no][-Rlowest|low|medium|high|highest][-senable|disable]repsetcreate-a-l-A-o-msync|async[-Gyes|no][-Rlowest|low|medium|high|highest][-senable|disable]repsetDescriptionCreatesastoragereplicationsetlinkingthelocalvolumewiththeremotevolumeviaapeerWorldWideNameorremotearrayname(notapplicableto2500Series).
Options-a,--arraySpecifiesthearray.
Forcross-platformcompatibility,youcansubstitute-X,--storage-deviceinplaceofthe-a,--arrayoption.
-A,--remote-arraySpecifiestheremotearray.
Options-Aand-waremutuallyexclusive.
-G,--consistency-groupyes|noSpecifieswhetherornotyouwanttoaddthisreplicationsettothearrayconsistencygroup.
Notethatthedefaultvalue(no)isonlyallowedwiththeasynchronousmodeoption.
-l,--local-volumeSpecifiesthelocalvolumename.
-m,--modesync|asyncSpecifieswhetherthemodeissynchronousorasynchronous.
-o,--remote-volumeChapter4ConfigurationCommandsforArrayswithRAIDControllers79Specifiestheremotevolumename.
-R,--replication-prioritylowest|low|medium|high|highestSpecifiesthepriorityofthisreplicationset.
Ifnopriorityisspecified,thedefaultismedium.
-s,--auto-syncenable|disableSpecifieswhethertheautosynchronizationpolicyisenabled.
Ifitisnotspecified,thedefaultisdisabled.
-w,--peer-wwnSpecifiesthepeerWorldWideName.
Examplessscscreate-aeurope-leuro_sales-w17:76:18:12:18:49:18:62:19:14:19:39:19:47:19:61-oeuro_sales-masync-Gno-Rmedium-senablerepsetCreatesareplicationsetoftheeuro_salesvolumethatexistsonthearraynamedeurope.
Intheprocess,itusestheeuro_salesvolumeonthearraywhoseWWNis17:76:18:12:18:49:18:62:19:14:19:39:19:47:19:61andsetsittosynchronizeasynchronouslywithamediumprioritywiththewriteordernotpreservedandresynchronizationperformedautomatically.
Thisrepsetiscalledeuro_sales/1.
sscscreate-acorp_west-lcrm-sales-w17:76:18:12:18:49:18:62:19:14:19:39:19:47:19:61-ocrm-sales-masync-Gno-Rmedium-senablerepsetCreatesareplicationsetofthecrm-salesvolumethatexistsonthearraynamedcorp_west.
Insodoing,itusesthecrm-salesvolumeonthearraywhoseWWNis17:76:18:12:18:49:18:62:19:14:19:39:19:47:19:61andsetsittosynchronizeasynchronouslywiththehighestprioritywiththewriteorderpreservedandresynchronizationperformedautomatically.
Thisrepsetiscalledcrm-sales/1.
sscscreate-aeurope-leuro_sales-Acorporate-oeuro_sales-masync-Gno-Rmedium-senablerepsetCreatesareplicationsetoftheeuro_salesvolumethatexistsonthearraynamedeurope.
Intheprocess,itusestheeuro_salesvolumeonthecorporatearrayandsetsittosynchronizeasynchronouslywithamediumprioritywiththewriteordernotpreservedandresynchronizationperformedautomatically.
Thisrepsetiscalledeuro_sales/1.
sscscreate-acorp_west-lcrm-sales-Acorporate-ocrm-sales-masync-Gyes-Rhighest-senablerepset80SunStorageTekCommonArrayManagerCLIGuideOctober2008Createsareplicationsetofthecrm-salesvolumethatexistsonthearraynamedcorp_west.
Insodoing,itusesthecrm-salesvolumeonthecorporatearrayandsetsittosynchronizeasynchronouslywiththehighestprioritywiththewriteorderpreservedandresynchronizationperformedautomatically.
Thisrepsetiscalledcrm-sales/1.
createsnapshotCreatesasnapshotforthespecifiedvolume.
Synopsiscreate-a-V[-f][-v][-m][-w][-n][-d][-k][-Z>][-C][-L][-l][-P][-D]snapshotcreate-a-V[-f][-v][-m][-w][-n][-d][-k][-Z>][-C][-L][-l][-P][-D]snapshotDescriptionCreatesasnapshotforthespecifiedvolume.
Oncethesnapshotvolumeiscreated,itcanbetreatedasanyothervolume,withtheexceptionthatitcannotbeusedtocreateanothersnapshot.
Options-a,--arraySpecifiesthearrayassociatedwiththissnapshot.
Forcross-platformcompatibility,youcansubstitute-X,--storage-deviceinplaceofthe-a,--arrayoption.
-C,--snapshot-countSpecifiesthenumberofintendedsnapshotsforthevolume.
-D,--descriptionChapter4ConfigurationCommandsforArrayswithRAIDControllers81Specifiesadescriptionofthesnapshot.
-d,--diskSpecifiesthenameofthediskordisksthatwillbeusedtocreatethesnapshotvolume.
Thearguments-dand-ncannotbeusedatthesametime,andspecificationofeitheroneresultsinanewvirtualdiskbeingcreated.
-f,--full-policyfailbasewrite|failsnapshotThefullpolicyspecifieswhattodoifandwhenthesnapshotfillsup:failbasewrite-Stopallowingwritestothebasevolume.
failsnapshot-Stopallowingwritestothesnapshot.
Thisisthedefault.
-k,--disk-typeSpecifiesthedisktype:ANY-Anytypeofdisk,includingFC,SATA,orSASFC-FibreChannelSATA-SerialAdvancedTechnologyAttachmentSAS-SerialAttachedSCSI-L,--snapshot-levellow|verylittle|little|average|high|fullThesnapshotlevelshouldbesettothepercentageofthebasevolumethatisexpectedtobeoverwrittenduringthesnapshot'slifetime.
Thisdeterminestheamountofstorageallocatedtothesnapshot(thatis,thesizeofitsreservevolume).
Tomaintainthesnapshotofthebasevolume'sstate,datainthebasevolumethatisabouttobeoverwritteniscopiedintothesnapshotreservespace.
Thesnapshotlevelsequatetothefollowingpercentages:10%-low25%-verylittle40%-little50%-average75%-high100%-full-l,--snapshot-percentage82SunStorageTekCommonArrayManagerCLIGuideOctober2008Specifieswhatpercentageofthevolumeistobeusedforsnapshotcreation.
-m,--reserve-nameSpecifiesthenameofthereservevolume.
Ifnonameisspecified,anameiscreatedandassignedautomatically.
-n,--number-of-disksSpecifiesthenumberofdisksinthesnapshotvolume,1to224,incombinationwithRAIDlevels0and1.
-n,--number-of-disksSpecifiesthenumberofdisksinthesnapshotvolume,1to30,incombinationwithRAIDlevels3,5,and6.
-P,--snapshot-poolSpecifiesthenameofthesnapshot.
-r,--raid-level0|1SpecifiesRAIDlevel0or1,incombinationwithnumber-of-disks1to224.
-r,--raid-level3|5|6SpecifiesRAIDlevel3,5,or6,incombinationwithnumber-of-disks1to30.
-v,--reserve-vdiskThisoptionismutuallyexclusivefromthe-d,-k,-n,and-roptions.
Ifareservevirtualdiskisnotspecified:-Anexistingvirtualdiskisusedifpossible.
-Ifnoexistingvirtualdiskisfound,anewvirtualdiskiscreated,ifthatpossibilityexists;otherwise,anerrormessageisreported.
Ifareservevirtualdiskisspecified:-Ifitisincompatiblewiththereservevolume,itresultsinafailure.
-Ifthereisnotenoughfreespace,itresultsinanerror.
-V,--volumeSpecifiesthesourcevolumefromwhichtotakeasnapshot.
-w,--warning-thresholdSpecifieswhentoinformyouthatthesnapshotreservevolumeisnearcapacity.
Ifawarningthresholdisnotspecified,50%isused.
-Z,--snapshot-reserve-sizeChapter4ConfigurationCommandsforArrayswithRAIDControllers83Specifiestheamountofspaceyouwanttoreserveforcapacityofthesnapshotreservevolume.
Specifythissnapshotreservevolumecapacityasapercentageofthebasevolume.
YoucanincreaseordecreasethepercentageuntiltheSnapshotReserveVolumeCapacityvaluematchestheestimatedcapacitythatyoucalculated.
Someroundingupmayberequired.
snapshotSpecifiesthesnapshotnameofupto16alphanumericusingcharacters,underscores,dashes,andspaces.
Examplessscscreate-aarray00-Vvol0snapshotvol01_snapcreatevdiskCreatesavirtualdisk.
Synopsiscreate-a-p[-dcreate-a-p-n]vdiskDescriptionCreatesavirtualdisk.
Options-a,--arraySpecifiesthearrayassociatedwiththisvirtualdisk.
-d,--diskSpecifiesparticulardiskstobeaddedtothevirtualdisk.
-n,--number-of-disksSpecifiesthenumberofdiskstobeaddedtothevirtualdisk.
-p,--pool84SunStorageTekCommonArrayManagerCLIGuideOctober2008Specifiesthestoragepoolassociatedwiththisvirtualdisk.
vdiskSpecifiesthevirtualdiskthatyouwanttomodify.
Examplessscscreate-aarray00vdiskvdisk1createvolumeCreatesavolumewithinaspecifiedpool.
Synopsiscreate-a-p-s>[-v][-n][-d]volumecreate-a-p-s>-C-L[-v][-n][-d][-w][-P][-V][-c]volumecreate-a-p-s>-Z>[-v][-n][-d][-w][-P][-V][-c]volumecreate-a-p-s>-C-l[-v][-n][-d][-w][-P][-V][-c]volumeDescriptionCreatesavolumewithinaspecifiedpool.
Youcanhaveupto2048volumesperarray.
Chapter4ConfigurationCommandsforArrayswithRAIDControllers85Options-a,--arraySpecifiesthearray.
Forcross-platformcompatibility,youcansubstitute-X,--storage-deviceinplaceofthe-a,--arrayoption.
-C,--snapshot-countSpecifiesthenumberofintendedsnapshotsforthevolume.
-c,--controllerA|BSpecifiesthecontroller.
-d,--diskSpecifiesthenameofthedisk.
Youcanusethisoptionwitheitherthe-noptionorthe-voption,butnotwithboth-nand-vatthesametime.
-f,--favorvolume|snapshotFavorsthevolumeorsnapshot.
-L,--snapshot-levelSpecifiesthelevelofsnapshotactivityaseitherlow,verylittle,little,average,high,orfull.
Thesnapshotlevelsequatetothefollowingpercentages:low-10%verylittle-25%little-40%average-50%high-75%full-100%-l,--snapshot-percentageSpecifieswhatpercentageofthevolumeistobeusedforsnapshotcreation.
-n,--number-of-disksorSpecifiesthenumberofdisksinthevolume.
Youcanusethisoptionwitheitherthe-doptionorthe-voption,butnotwithboth-dand-vatthesametime.
Number-of-disksisusedincombinationwithaRAIDlevelsetat3,5,and6.
Number-of-disksisusedincombinationwithaRAIDlevelsetat0or1.
-P,--snapshot-pool86SunStorageTekCommonArrayManagerCLIGuideOctober2008Specifiesthenameofthesnapshot.
-p,--poolSpecifiesthenameofthesnapshotpool.
-s,--sizetb|gb|mb|kb|bytes|blk|bvSpecifiesthevolumesize.
Sizescanbeinterabytes,gigabytes,megabytes,kilobytes,bytes,blocks,orbasevolume-V,--reserve-vdiskSpecifiesareservevirtualdisk.
-v,--vdiskSpecifiesthenameofthevirtualdisk.
Youcanusethisoptionwitheitherthe-doptionorthe-noption,butnotwithboth-dand-natthesametime.
-w,--warning-thresholdSpecifieswhentoinformyouthatthesnapshotreservevolumeisnearcapacity.
Ifawarning-thresholdisnotspecified,50%isthedefault.
Z,--snapshot-reserve-sizeSpecifiesthevolumenameofupto16alphanumericcharacters.
Examplessscscreate-aarray01-ppool1-s20GBvolumeORACLE-1createvolume-copyCreatesacopyofthevolume(notapplicableto2500Series).
Synopsiscreate-a-s-t[-plowest|low|medium|high|highest]volume-copyChapter4ConfigurationCommandsforArrayswithRAIDControllers87DescriptionCreatesacopyofthevolume.
-a,--arraySpecifiesthearrayassociatedwiththisvolume.
-p,--prioritylowest|low|medium|high|highestSpecifiesthepriorityofthisvolumecopy.
Ifnopriorityisspecified,thedefaultismedium.
-s,--source-volumeSpecifiesthesourcevolumenameassociatedwiththisvolumecopy.
-t,--target-volumeSpecifiesthetargetvolumenameassociatedwiththisvolumecopy.
Examplessscscreate-aarray00-svol01-tvol02volume-copydeletehostDeletesoneormorehosts.
Synopsisdelete-ahostDescriptionDeletesoneormorehosts.
Options-a,--arraySpecifiesthearrayassociatedwiththishost.
Forcross-platformcompatibility,youcansubstitute-X,--storage-deviceinplaceofthe-a,--arrayoption.
hostSpecifiesthehostorhoststodelete.
88SunStorageTekCommonArrayManagerCLIGuideOctober2008Examplessscsdelete-aarray00hosthost01deletehostgroupDeletesoneormorehostgroups.
Synopsisdelete-ahostgroupDescriptionDeletesoneormorehostgroups.
Options-a,--arraySpecifiesthearrayassociatedwiththishostgroup.
hostgroupSpecifiesthehostgrouporhostgroupstodelete.
Examplessscsdelete-aarray00hostgrouphg01deleteinitiatorDeletesoneormoreinitiators.
Synopsisdelete-a[-T]initiatorChapter4ConfigurationCommandsforArrayswithRAIDControllers89DescriptionDeletesoneormoreinitiators.
Theinitiatororinitiatorsmustbeunmappedorthecommandwillfail.
Options-a,--arraySpecifiesthearrayassociatedwiththisinitiatororinitiators.
Forcross-platformcompatibility,youcansubstitute-X,--storage-deviceinplaceofthe-a,--arrayoption.
-T,--name-typeSpecifiestheinitiatortype,eitheraniSCSIinitiatororFCinitiator.
ForiSCSI,specifytheiSCSIqualifiedname(IQN)ornameoftheinitiator.
ForFC,specifytheWorldWideNameornameoftheinitiator.
initiatorSpecifiestheinitiatoridentifier.
Examplessscsdelete-aarray00initiatormyInitiator-01,myInitiator-02deleteiscsi-sessionDeletesaniscsi-session.
Synopsisdelete-aiscsi-sessionDescriptionDeletesiSCSIsessionsassociatedwithaspecifiedarray.
Options-a,--arraySpecifiesthenameofthearray.
90SunStorageTekCommonArrayManagerCLIGuideOctober2008iscsi-sessionSpecifiesoneormoreiSCSIsessionstodelete.
Examplessscsdelete--arrayiSCSILCA2iscsi-session40:00:01:37:00:05:8DeletesiSCSIsession40:00:01:37:00:05:8forarrayiSCSILCA2.
deletepoolDeletesoneormorepools.
Synopsisdelete-apoolDescriptionDeletesoneormorestoragepools.
Thisoperationremovesallassociatedvirtualdisksandvolumesduringthedeletionofthestoragepool.
Youcanperformthisactiononlywhenallvolumesinthepoolareunmapped.
Options-a,--arraySpecifiesthearrayassociatedwiththispool.
Forcross-platformcompatibility,youcansubstitute-X,--storage-deviceinplaceofthe-a,--arrayoption.
poolSpecifiesthestoragepoolorlistofpoolstodelete.
Examplessscsdelete-aarray00poolSP048763Chapter4ConfigurationCommandsforArrayswithRAIDControllers91deleteprofileDeletesoneormoreprofiles.
Synopsisdelete-aprofileDescriptionDeletesoneormorestorageprofiles.
Youcanonlyperformthisfunctiononastorageprofilethathasnostoragepoolsassociatedwithit.
Options-a,--arraySpecifiesthearrayassociatedwiththisprofile.
profileSpecifiestheprofileorprofilestodelete.
Examplessscsdelete-aarray00profileMyProfiledeleterepsetDeletesoneormorereplicationsets(notapplicableto2500Series).
Synopsisdelete-arepsetDescriptionDeletesoneormorereplicationsets.
92SunStorageTekCommonArrayManagerCLIGuideOctober2008Options-a,--arraySpecifiesthearrayfromwhichyouwanttodeletethereplicationset.
Forcross-platformcompatibility,youcansubstitute-X,--storage-deviceinplaceofthe-a,--arrayoption.
repsetSpecifiesthereplicationsetorsetstodelete.
Examplessscsdelete-acorporaterepsetfinance/1Deletesthereplicationofthefinancevolumeonthearraynamedcorporate.
sscsdelete-acorp_westrepsetcrm-sales/1Deletesthereplicationofthecrm-salesvolumeonthearraynamedcorp_west.
deletesnapshotDeletesoneormoresnapshots.
Synopsisdelete-asnapshotDescriptionDeletesthespecifiedsnapshot.
Options-a,--arraySpecifiesthearrayassociatedwiththissnapshot.
Forcross-platformcompatibility,youcansubstitute-X,--storage-deviceinplaceofthe-a,--arrayoption.
snapshotSpecifiesthesnapshotorsnapshotstodelete.
Chapter4ConfigurationCommandsforArrayswithRAIDControllers93Examplessscsdelete-aarray00snapshotsnap1deletevdiskDeletesoneormorenamedvirtualdisks.
Synopsisdelete-avdiskDescriptionDeletesoneormorespecifiedvirtualdisks.
Options-a,--arraySpecifiesthearrayassociatedwiththisvirtualdisk.
Forcross-platformcompatibility,youcansubstitute-X,--storage-deviceinplaceofthe-a,--arrayoption.
vdiskSpecifiesthevdiskorvdiskstodelete.
Examplessscsdelete-aarray00vdiskvdisk1deletevolumeDeletesoneormorenamedvolumes.
Synopsisdelete-avolume94SunStorageTekCommonArrayManagerCLIGuideOctober2008DescriptionDeletesoneormorenamedvolumes.
Thevolumemustbeunmappedorthedeletionfails.
Options-a,--arraySpecifiesthearrayassociatedwiththisvolumes.
Forcross-platformcompatibility,youcansubstitute-X,--storage-deviceinplaceofthe-a,--arrayoption.
volumesSpecifiesthevolumesorvolumestodelete.
Examplessscsdelete-aarray00volumeORACLE-1deletevolume-copyDeletesavolume-copy(notapplicableto2500Series).
Synopsisdelete-a[]-s[]-t[]volume-copyDescriptionDeletesavolumecopy.
Thisoperationbreaksthecopyrelationshipbetweenthetwovolumes,butitdoesnotdeletethevolumesthemselves.
Italsoremovestheread-onlypermissiononthetargetvolume.
Options-a,--arraySpecifiesthearrayassociatedwiththisvolumecopy.
-s,--source-volumeSpecifiesthesourcevolumeassociatedwiththisvolumecopy.
Chapter4ConfigurationCommandsforArrayswithRAIDControllers95-t,--target-volumeSpecifiesthetargetvolumeassociatedwiththisvolumecopy.
Examplessscsdelete-aarray00-svol01-tvol02volume-copydisablesnapshotDisablesoneormoresnapshots.
Synopsisdisable-asnapshotDescriptionDisablesoneormoresnapshots.
Disablingavolumesnapshotdoesnotremoveeitherthevolumesnapshotoritsassociatedreservevolume.
Whenyoudisableavolumesnapshot,onlythespecifiedsnapshotsaredisabled.
Allothersnapshotsremainfunctional.
Options-a,--arraySpecifiesthearrayassociatedwiththissnapshot.
snapshotSpecifiesthenamesofthesnapshotsthatyouwanttoresnap.
Examplessscsdisable-aarray00snapshotsnapshot1,snapshot2Disablessnapshot1andsnapshot2onarray00.
96SunStorageTekCommonArrayManagerCLIGuideOctober2008exportarrayRendersanextensiblemarkuplanguage(XML)representationofthearray.
SynopsisexportarrayDescriptionTheexportarraycommandrendersanextensiblemarkuplanguage(XML)representation.
Thisoutputstostandardoutput,andthenyouredirectittoafileoranothermechanism.
arraySpecifiesthearraythatyouwanttoexport.
Examplessscsexportarrayarray00>/tmp/array00_backup.
xmlexportprofileExportsoneormoreprofilesintoanXMLrepresentation.
Synopsisexport-aprofile>[]DescriptionExportsoneormoreprofilesintoanXMLrepresentation.
Thisoutputstostandardoutput,andthenyouredirectittoafileoranothermechanism.
Options-a,--arrayChapter4ConfigurationCommandsforArrayswithRAIDControllers97Specifiesthearrayfromwhichyouwanttoexporttheprofile.
profileSpecifiestheprofileorprofilestoexport.
Ifnoprofilesarespecified,allprofilesareexported.
Examplessscsexport-aarray00profile>/tmp/all_profiles.
xmlfaildiskSetsadisktothefailedstate.
Synopsisfail-a[-t]diskDescriptionSetsadisktothefailedstate.
Thiscancreatecomplications.
DonotinitiatethiscommandwithoutfirstconsultingSunCustomerServicepersonnel.
Options-a,--arraySpecifiesthearrayonwhichyouwanttofailthedisk.
-t,--trayIdentifiesthetraywherethediskresides.
diskSpecifiesthenameofthedisk.
Examplessscsfail-aArray01-tTray20diskt20d16sscsfail-aArray01diskt20d1698SunStorageTekCommonArrayManagerCLIGuideOctober2008importarrayAppliesanarrayconfigurationfiletothespecifiedarray.
Synopsisimport-x[-L][-n]arrayDescriptionAppliesanarrayconfigurationfiletothespecifiedarray.
Thisenablesyoutoimporttheconfigurationfilefromonearraytooverwritetheconfigurationforthisarray.
Usethe-noptiontopreservethecurrentarrayconfiguration,includingthemappingbetweentheaccessLUN(LUN31)andthemanagementhost.
Thismappingisrequiredforin-bandmanagementofthearray.
Options-x,--xmlSpecifiesthelocationoftheXMLfiletobeimported.
TheXMLlocationcanbeintheformofaurl(http://.
.
.
orfile:orafilename.
-L,--listSpecifiesthatnoimporttakeplace.
Instead,thearrayischeckedagainsttheXMLfiletoensurethatitiscompatible.
-n,--noclearSpecifiesthatthecurrentarrayconfigurationwillnotbecleared.
arraySpecifiesthearraytowhichtheconfigurationfileisapplied.
Examplessscsimport-xfile:///tmp/array00_configuration.
xmlarrayarray00Chapter4ConfigurationCommandsforArrayswithRAIDControllers99ResponseFormat(whenthelistoptionisused)Arrayarray-nameis[not]compatiblewithXMLfileXML-location.
importprofileImportsoneormoreprofilesfromaspecifiedXMLfile.
Synopsisimport-a-x[-f]profile[]import-a-x-Lprofile[]DescriptionImportsoneormoreprofilesfromaspecifiedXMLfile.
Thisallowsyoutoimporttheconfigurationprofilefromonearraytooverwritetheconfigurationprofileforthisarray.
OptionsarraySpecifiesthearraytowhichyouwanttoimporttheprofile.
-x,--xmlSpecifiesthelocationofanXMLfilecontainingtheprofilestobeimported.
TheXMLlocationcanbeintheformofaURL(http://.
.
.
orfile:orafilename.
-f,--forceSpecifiesthefollowingactionswhenconflictsoccurwiththeprofiles:Exists–Profilesarenotimported.
DuplicateSettings–Profilesareimported,creatinganewprofile.
Conflicting–Profilesareimported,replacingthecurrentprofileofthesamename.
InUse–Profilesarenotimported.
100SunStorageTekCommonArrayManagerCLIGuideOctober2008New–Profilesareimported.
Iftheforceoptionisnotspecified,thefollowingoccurs:Exists–Profilesarenotimported.
DuplicateSettings–Profilesarenotimported.
Conflicting–Profilesarenotimported.
InUse–Profilesarenotimported.
New–Profilesareimported.
Inallcases,bothsuccessfulandfailedimportsarereported.
-L,--listListsallprofiles.
Ifthelistoptionisspecified,noimporttakesplace.
AllprofilesintheXMLfile(orallthosespecifiedbywayofthe)arelisted,andeachisidentifiedasfollows:Exists–Theprofilealreadyexistswithallofthesameparametervalues.
DuplicateSettings–Aprofilewithexactlythesameparameters(thedescriptionandversioncanbedifferent),butadifferentnameexists,andnoprofilewiththegivennameisinusebythesystem.
Conflicting–Aprofilewiththesamenameexists,hasdifferentparameters,andisnotcurrentlyinusebythesystem.
InUse–Aprofilewiththesamenameexists,hasdifferentparameters,andiscurrentlyinusebythesystem.
New–Noneoftheabovelabelsapply.
profileSpecifiestheprofileorprofilestoimport.
Ifnoprofilenamesarespecified,allprofilesinthegivenXMLlocationareused.
Examplessscsimport-aarray00-f-xfile:///tmp/all_profiles.
xmlprofileResponseFormat(when--listoptionisused)profile_name:ExistsChapter4ConfigurationCommandsforArrayswithRAIDControllers101profile_name:DuplicateSettingsprofile_name:Newprofile_name:ConflictinginitializediskInitializesadisk.
Synopsisinitialize-a[-t]disk[]DescriptionInitializesadisk.
Ifadiskfromanotherarrayisinserted,andyouwanttouseitinadifferentarray,youmightneedtoinitializeittoremoveanylatentvirtualdiskinformation.
Alldataonthediskwillbelost.
Thiscancreatecomplications.
DonotinitiatethiscommandwithoutfirstconsultingSunCustomerServicepersonnel.
Options-a,--arraySpecifiesthearrayonwhichyouwanttoinitializethedisk.
-t,--trayIdentifiesthetraywherethediskresides.
diskSpecifiesthenameofthedisk.
Examplessscsinitialize-aArray01-tTray2diskDisk6102SunStorageTekCommonArrayManagerCLIGuideOctober2008listcontrollerListsconfigurationinformationforthespecifiedcontroller.
Synopsislist-acontroller[A|B]DescriptionListsconfigurationinformationforthespecifiedcontroller.
Options-a,--arraySpecifiesthearrayforwhichyouwanttoviewcontrollerinformation.
controllerA|BSpecifiesthecontrollerforwhichyouwanttoviewinformation.
Ifnocontrollerisspecified,summaryinformationforbothcontrollersisdisplayed.
Examplessscslist-aarray01controllerResponseFormatController:A|BMode:Active|InactiveQuiesced:True|FalseStatus:Removed|Optimal|RPAParError|Failed|ServiceModeDriveInterface:FibreChannel|SATA|SASCacheMemorySize:nMBManufacturer:manufacturerSerialNumber:serial-numberEthernetPort:1Chapter4ConfigurationCommandsforArrayswithRAIDControllers103UseDHCP/BOOTP:On|OffIPAddress:IP-addressGateway:IP-addressNetMask:net-masklistfcportListsFibreChannelportinformationforthecontrollerofthespecifiedarray.
Synopsislist-a[-cA|B]fcport[]DescriptionListsFibreChannel(FC)portinformationforthecontrollerofthespecifiedarray.
Options-a,--arraySpecifiesthenameofthearraywherethecontrollerresides.
-c,--controllerA|BSpecifiesthecontrollerforwhichyouwantFibreChannelportinformation.
fcportSpecifiestheFibreChannelportorportsforwhichyouwantinformation.
PortsarespecifiedasA/1toA/4andB/1toB/4.
IfnoFCportisspecified,detailsforallportsaredisplayed.
Examplessscslist-aarray00fcportA/1104SunStorageTekCommonArrayManagerCLIGuideOctober2008ResponseFormatArray:array-nameController:A|BFCPort:fcport-IDPortWWN:port-WWNNodeWWN:node-WWNTopology:ARBLoop|Fabric|PTP|FABLoop|UnknownSpeed:current-speedGb/s(Gigabitspersecond)MaximumSpeed:maximum-speedGb/sLoopID:0.
.
127|N/A|AnyPreferredLoopID:0.
.
127|N/A|AnyChannelNumber:channel-numberChannelJoinedWithAnother:True|FalseLinkStatus:Up|DownlisthostListsthehostnamesanddetailsforanindividualhost.
Synopsislist-ahost[]DescriptionListsthehostnamesanddetailsforanindividualhost.
Options-a,--arraySpecifiesthearrayassociatedwiththishost.
Forcross-platformcompatibility,youcansubstitute-X,--storage-deviceinplaceofthe-a,--arrayoption.
hostSpecifiesthehostorhoststhatyouwanttoviewindetail.
Whennohostisspecified,thenamesofallthehostsinthearrayarelisted.
Chapter4ConfigurationCommandsforArrayswithRAIDControllers105Examplessscslist-aarray00hostResponseFormat(whennovalueisspecified)Host:host-name.
.
.
Host:host-nameResponseFormat(hostdetailwhenvalueisspecified)Host:host-nameHostGroup:hostgroup-nameInitiator:initiator-name.
.
.
Initiator:initiator-nameVolume:volume-nameLUN:LUN-ID.
.
.
Volume:volume-nameLUN:LUN-IDlisthostgroupListshostgroupnameandhostsforanindividualhostgroup.
Synopsislist-ahostgroup[]DescriptionListshostgroupnameandhostsforanindividualhostgroup.
106SunStorageTekCommonArrayManagerCLIGuideOctober2008Options-a,--arraySpecifiesthearrayassociatedwiththishostgroup.
hostgroupSpecifiesthehostgroupthatyouwanttoview.
Whennohostgroupisspecified,thenamesofallthehostgroupsinthearrayarelisted.
Examplessscslist-aarray00hostgroupResponseFormat(whennovalueisspecified)HostGroup:host-group-name.
.
.
HostGroup:host-group-nameResponseFormat(hostdetailwhenthevalueisspecified)HostGroup:host-group-nameHost:host-name.
.
.
Host:host-nameVolume:volume-nameLUN:LUN-ID.
.
.
Volume:volume-nameLUN:LUN-IDlistinitiatorListstheinitiatorsandprovidesadescriptionofeach.
Chapter4ConfigurationCommandsforArrayswithRAIDControllers107Synopsislist-a[-T]initiator[]DescriptionListstheinitiatorsandprovidesadescriptionofeach.
Options-a,--arraySpecifiesthearrayassociatedwiththisinitiator.
Forcross-platformcompatibility,youcansubstitute-X,--storage-deviceinplaceofthe-a,--arrayoption.
-T,--name-typeSpecifiestheinitiatoridentifier;aWorldWideName,iSCSIqualifiedname(IQN),oranamedinitiator.
initiatorSpecifiestheinitiatoridentifier.
Examplessscslist-aarray01-Tinitiator_nameinitiatormyInitiator-01sscslist-aarray01initiatormyInitiator-01sscslist-aiSCSILCA_2-TiqninitiatorResponseFormat(listofinitiatorswhennovalueisspecified)Initiator:initiator-ID.
.
.
Initiator:initiator-IDResponseFormat(detailabouttheinitiatorwhenanvalueisspecified)Initiator:initiator-ID108SunStorageTekCommonArrayManagerCLIGuideOctober2008WWN:initiator-WWNHost:host-nameOSType:host-typelistiperformanceDisplaysiSCSIperformancestatisticsforthe2510arrayandenablesyoutodefinethetypeofiSCSIperformancestatisticstomonitor.
SynopsisTodisplaytheperformancestatistics:list-a-T[-b]iperformanceTodefinethetypeofiSCSIperformancestatisticstomonitorandthesortorderoftheoutput:list-a-t[-c][-h][-b]iperformanceDescriptionDisplaysiSCSIperformancestatisticsforthe2510arrayandenablesyoutodefinethetypeofiSCSIperformancestatisticstomonitorandthesortorderoftheoutput.
Onlyvalidfor2510arraysrunningfirmwareversion07.
35.
nn.
nnorhigher.
Options-a,--arraySpecifiesthenameofthearrayassociatedwiththisiSCSIperformancerequest.
-b,--baselineChapter4ConfigurationCommandsforArrayswithRAIDControllers109SetsthebaselinetimefortheiSCSIarray.
Iftrue,thecurrentarraytimeisusedasthebaselinetime.
-t,--typeSpecifiesthetypeofstatisticstolist:array,controller,orvolume.
-c,--controllerSpecifiescontrollerAorcontrollerB.
-h,--host]Specifiesthehostnameofoneormorehosts.
-g,--hostgroupSpecifiesthenameofoneormorehostgroups.
-v,--volumeSpecifiesoneormorevolumes.
-s,--sort]Specifiesthevalueforsortingtheperformanceoutput.
ExamplesDisplayStatistics:sscslist-aiSCSILCA_2-TiperformanceResponseFormatArray:iSCSILCA_2State:OffPollingInterval:1minuteDataRetentionPeriod:1hourBASELINESTATISTICSControllerABaselineTime:dateattimeControllerBBaselineTime:dateattimeMACTransmitStatistics110SunStorageTekCommonArrayManagerCLIGuideOctober2008MACReceiveStatisticsTCPStatisticsIPv4StatisticsIPv6StatisticsTarget(Protocol)StatisticsDefinestatisticstodisplay:sscslist--arrayiSCSILCA_2--typearray_stats--sorttotal_iopsiperformanceListarraystatisticsforiSCSILCA_2andsortbytotalI/Ooperationspersecond.
listiscsi-portListsiSCSIports.
Synopsislist-a[-c]iscsi-port[iscsiport-id[,iscsiport-id.
.
.
]]DescriptionListsinformationforoneormoreiSCSIportsconfiguredforaspecifiedarray.
Options-a,--arraySpecifiesthenameofthearray.
-c,--controllerSpecifiescontrollerAorBforwhichyouwantinformation.
[iscsiport-id[,iscsiport-id.
.
.
]]SpecifiesoneormoreiSCSIportIDs.
Foradetailedlisting,specifycontroller/port.
Chapter4ConfigurationCommandsforArrayswithRAIDControllers111Examplessscslist--arrayiSCSILCA_2iscsi-portB/1ListsdetailforiSCSIport1oncontrollerBforarrayiSCSILCA_2.
ResponseFormatArray:iSCSILCA_2Controller:AiSCSIPort:B/1PortMAC:00:A0:B8:20:34:69Speed:100MbpsMaximumSpeed:1GbpsLinkStatus:UpListeningPort:3260MTU:1500ICMPPingResponses:EnabledIPv4:EnabledDHCP:OffIPAddress:10.
8.
88.
167Gateway:10.
8.
88.
1Netmask:255.
255.
255.
0VLAN:DisabledVLANID:0EthernetPriority:DisabledPriority:3listiscsi-sessionListsiSCSIsessions.
112SunStorageTekCommonArrayManagerCLIGuideOctober2008Synopsislist-aiscsi-session[session-identifier[,session-identifier.
.
.
]]DescriptionListsiSCSIsessionsassociatedwithaspecifiedarray.
TolistdetailsofaspecificiSCSIsession,includetheiSCSIsessionID.
Options-a,--arraySpecifiesthenameofthearray.
iscsi-session[session-identifier[,session-identifier.
.
.
]]SpecifiestheiSCSIsessionID.
Examplessscslist-aiSCSILCA_2iscsi-session40:00:01:37:00:00:8003ResponseFormatiSCSISessioniSCSITarget:iqn.
1992-01.
com.
lsi:1535.
600a0b80003487c10000000046cc4a1diSCSISessionIdentifier(SSID):40:00:01:37:00:00:8003InitiatorSessionIdentifier(ISID):40:00:01:37:00:00TargetPortalGroupTag:2InitiatoriSCSIName:iqn.
1991-05.
com.
microsoft:funk.
sun.
comInitiatoriSCSILabel:i1193868006InitiatoriSCSIAlias:fi1193868006Host:fh1193262432iSCSISessionConnectionID(s)ConnectionID(CID):0x1EthernetPort:ControllerB,Port2InitiatorIPAddress:10.
8.
88.
103Chapter4ConfigurationCommandsforArrayswithRAIDControllers113NegotiatedLoginParametersAuthenticationMethod:NoneHeaderDigestMethod:NoneDataDigestMethod:NoneMaximumConnections:4TargetAlias:iSCSI_LCA2InitiatorAlias:fi1193868006TargetIPAddress:10.
8.
88.
175TargetPortalGroupTag:2InitialR2T:YesMaximumBurstLength:262144BytesFirstBurstLength:8192BytesDefaultTimetoWait:0SecondsDefaultTimetoRetain:60SecondsMaximumOutstandingR2T:16ErrorRecoveryLevel:0MaximumReceiveDataSegmentLength:65536Byteslistiscsi-targetListsiSCSItargets.
Synopsislist-aiscsi-targettarget-nameDescriptionListsiSCSItargetnameconfiguredforthespecifiedarray.
Tolistdetails,specifytheiSCSItargetname.
TargetnameistheiSCSIqualifiedname(IQN),forexample:iqn.
199201.
com.
sun:1535.
600a0b80002f9da000000000461255f9.
114SunStorageTekCommonArrayManagerCLIGuideOctober2008Options-a,--arraySpecifiesthenameofthearray.
iscsi-targettarget-nameSpecifiestheiSCSIqualifiednameoftheiSCSItarget.
Examplessscslist--arrayiSCSILCA_2iscsi-targetResponseFormatiSCSITargetName:iqn.
1992-01.
com.
sun:1535.
600a0b80003487c10000000046cc4a1dsscslist--arrayiSCSILCA_2iscsi-targetiqn.
1992-01.
com.
sun:1535.
600a0b80003487c10000000046cc4a1dResponseFormatiSCSITargetName:iqn.
1992-01.
com.
lsi:1535.
600a0b80003487c10000000046cc4a1dAlias:iSCSI_LCA2Authentication:NONECHAPSecret:*****UnnamedDiscovery:EnabledSessions:1iSNS:EnabledIPv4:10.
8.
88.
56DHCP:OffPort:3205Initiatorsserver1:iqn.
1991-05.
com.
microsoft:sun-pojdhrbx7ttserver2:iqn.
1991-05.
com.
sun.
microsoft.
jczChapter4ConfigurationCommandsforArrayswithRAIDControllers115server3:iqn.
1991-05.
com.
microsoft:sun-pojdhrbx7rrserver4:iqn.
1986-03.
com.
sun:01:0003ba3145ed.
47032ecfserver5:iqn.
1986-03.
com.
sun:01:00144f010116.
46fa5d9aserver6:iqn.
1986-03.
com.
sun:01:0003ba0442dd.
47062a0fserver7:iqn.
1991-05.
com.
microsoft:sun-pojdhrbx7qqserver8:iqn.
2001-04.
com.
example.
storage.
tape:sys1.
xyzserver9:iqn.
1991-05.
com.
microsoft:funk.
sun.
comserver10:iqn.
1991-05.
com.
microsoft:jim.
bur.
sun.
comserver11:iqn.
1991-05.
com.
microsoft:parash.
india.
sun.
comserver12:iqn.
1991-05.
com.
microsoft:pookawinxpserver13:iqn.
1991-05.
com.
microsoft:nms-lab8listlicenseShowsalllicensesthatareassociatedwiththearray,andrelatedlicensingdetails.
Synopsislist-alicense[]DescriptionShowsalllicensesthatareassociatedwiththearray,alongwithrelatedlicensingdetails(serialnumber,controllerserialnumber,andfurtherdetails).
-a,--arraySpecifiesthearrayassociatedwiththislicense.
licenseSpecifiesthenameofalicenseorlicenses.
Ifyoulistspecificlicenses,thenonlythedetailsofthoselicensesareshown.
Examplessscslist-acorporatelicense116SunStorageTekCommonArrayManagerCLIGuideOctober2008Listsallofthelicensesonthecorporatearray.
sscslist-acorp_westlicenseReplicationSetListsthedetailsofthereplicationsetlicenseonthecorp_westarray.
ResponseFormat(whennovaluesarespecified)Array:array-nameWWN:World-Wide-nameSerialNumber:serial-numberFeaturedEnableIdentifier:identifierLicense:license-nameDescription:descriptionStatus:Enabled|DisabledQuantityLicensed:quantityQuantityUsed:quantityResponseFormat(whenvaluesarespecified)Array:array-nameWWN:World-Wide-nameSerialNumber:serial-numberFeaturedEnableIdentifier:identifierLicense:license-nameDescription:descriptionStatus:enabled|disabledQuantityLicensed:quantityQuantityUsed:quantityReplicationLicenseStatus:Activated|DeactivatedChapter4ConfigurationCommandsforArrayswithRAIDControllers117RepositoryVolume:replication-repository-nameSize:number-of-megabytesVdisk:virtual-disk-identifierLicensedItemsSampleFormats:Snapshot:LicensedItems:BaseVolume:vol_b13SnapshotVolume:new-snapBaseVolume:dk_rep3SnapshotVolume:dk_snap1StorageDomain:LicensedItems:HostGroup:t_hostgroup_2Host:MIG-1VolumeCopyLicensedItems:SourceVolume:dk_rep1TargetVolume:dk_rep2SourceVolume:dk_vol3TargetVolume:dk_rep4listmappingListsthemappingforeachhost,hostgroup,andstoragedomain.
Synopsislist-amapping[DefaultStorageDomain|Host|HostGroup[,DefaultStorageDomain|Host|HostGroup.
.
.
]]DescriptionListsmappingsforthearray.
Youcanfiltertheoutputbyspecifyingthenameofastoragedomain,ahost,orahostgroup.
Options-a,--array118SunStorageTekCommonArrayManagerCLIGuideOctober2008Listsallmappingsforthespecifiedarray.
Filterstheoutputbasedonthenameofastoragedomain,host,orhostgroupsupplied.
mapping[DefaultStorageDomain|Host|HostGroup[,DefaultStorageDomain|Host|HostGroup.
.
.
]]Listsmappingforthespecifiedstoragedomain.
Examplessscslist-sarray1mappinghosthost1Listsallofthemappingsonarray1forhost1.
ResponseFormatVolume:JKTestLUN:0MappedTo:diag-e4500aTargetType:HostPermission:Read/Writelistos-typeShowstheoperatingsystemtypesonthisarray.
Synopsislist-aos-typeDescriptionShowsalloftheoperatingsystemsthataresupportedbythearray.
Thevaluesreturnedcanbeusedinsubsequentrequeststocreateormodifyinitiators,ortomodifythedefaulthosttypeofthearray.
Options-a,--arrayShowsthearrayname.
os-typeShowsalloftheoperatingsystemsthataresupportedbythearray.
Chapter4ConfigurationCommandsforArrayswithRAIDControllers119ResponseFormatWNTNCLSP5-WindowsNTnonclustered(SP5orhigher)W2KNETNCL-Windows2000/Server2003nonclusteredSOL-Solaris(withTrafficManager)HPX-HP-UXAIX-AIXIRX-IrixLNX-LinuxWNTCLSP5-WindowsNTclustered(SP5orhigher)W2KNETCL-Windows2000/Server2003clusteredAIXAVT-AIX(withVeritasDMP)W2KNETCLDMP-Windows2000clusteredDMPNWRFO-NetwarefailoverIRX_FOAIX_FOSOLAVT-Solaris(withVeritasDMPorother)W2KNETNCLDMP-Windows2000nonclusteredDMPlistperformanceShowsdetailedperformancestatistics.
Synopsislist-a-Tperformancelist-a-tarray_stats|controller_stats|volume_stats[-cA|B][-h120SunStorageTekCommonArrayManagerCLIGuideOctober2008Specifiesthearrayorarraysassociatedwiththisperformancerequest.
-T,--settingsShowsthecurrentsettingsforthearray,includingstate,pollinginterval,anddataretentionperiod.
Ifthisoptionisspecified,allotheroptions(exceptarray)areignored.
-t,--typearray_stats|controller_stats|volume_statsSpecifiesthetypeofstatisticstolist:array,controller,orvolume.
-c,--controllerA|BSpecifiesthecontrollername.
-v,--volumeSpecifiesthevolumenameorvolumenamesassociatedwiththisperformancerequest.
-h,--hostSpecifiesthehostnameorhostnamesassociatedwiththisvolume.
-g,--hostgroupSpecifiesthehostgrouporhostgroupsassociatedwiththisvolume.
-s,--sortname|total_iops|read_percent|write_percent|total_data|avg_read_size|avg_read_rate|peak_read_rate|avg_write_size|avg_write_rate|peak_write_rate|cache_hit_percentSpecifiesthesortingmechanism.
performanceSpecifiestheperformancesubcommand.
ResponseFormat(ifsettingsarespecified)Array:array-nameState:on|offPollingInterval:1minute|5minutes|15minutesDataRetentionPeriod:forever|1hour|2hours|4hours|1dayChapter4ConfigurationCommandsforArrayswithRAIDControllers121ResponseFormatNAMETOTIOPSREAD%WRITE%TOTDATAAVGRSIZEAVGR/sPEAKR/s.
.
.
.
vol10.
00.
000.
000.
00.
00.
00.
0.
.
.
vol23.
67.
3234.
771030.
332.
74.
510.
4listpoolListsstoragepoolinformation.
Synopsislist-apool[]DescriptionListsstoragepoolinformation.
Options-a,--arraySpecifiesthearrayassociatedwiththispool.
Forcross-platformcompatibility,youcansubstitute-X,--storage-deviceinplaceofthe-a,--arrayoption.
poolSpecifiesthepoolorpoolsforwhichyouwantdetailedinformation.
Ifnopoolsarespecified,thissubcommandlistssummaryinformationforallpools.
Examplessscslist-aarray01poolSP048763ResponseFormat(summaryofallpoolswhennovalueisspecified)122SunStorageTekCommonArrayManagerCLIGuideOctober2008Pool:pool-nameProfile:profile-nameConfiguredCapacity:capacity.
.
.
.
Pool:pool-nameProfile:profile-nameConfiguredCapacity:capacityResponseFormat(detailofapoolwhenavalueisspecified)Pool:pool-nameDescription:descriptionProfile:profile-nameTotalCapacity:capacityMB|GB|TBConfiguredCapacity:capacityMB|GB|TBAvailableCapacity:capacityMB|GB|TBVolume:volume-name1Volume:volume-name2listprofileListsthenamedstorageprofiles.
Synopsislist-aprofile[]DescriptionListsthenamedstorageprofiles.
Options-a,--arraySpecifiesthearrayassociatedwiththisprofile.
profileChapter4ConfigurationCommandsforArrayswithRAIDControllers123Specifiestheprofileorprofilesforwhichyouwantdetailedinformation.
Ifnoprofilesarespecified,thissubcommandlistssummaryinformationforallprofiles.
Examplessscslist-aarray00profileMyProfileResponseFormat(summaryofallprofileswhennovalueisspecified)Profile:profile-name.
.
.
Profile:profile-nameResponseFormat(detailofaprofilewhenavalueisspecified)Profile:profile-nameProfileinUse:yes|noFactoryProfile:yes|noDescription:profile-descriptionRAIDLevel:0|1|3|5|6SegmentSize:8KB|16KB|32KB|64KB|256KBReadAhead:on|offOptimalNumberofDrives:variable|2.
.
30DiskType:ANY|FC|SATA|SASPool:pool-name.
.
.
.
Pool:pool-name124SunStorageTekCommonArrayManagerCLIGuideOctober2008listrepsetListsreplicationsetinformation(notapplicableto2500Series).
Synopsislist-arepset[]DescriptionListsreplicationsetinformation.
Options-a,--arraySpecifiesthearrayfromwhichyouwanttoobtainreplicationsetinformation.
Forcross-platformcompatibility,youcansubstitute-X,--storage-deviceinplaceofthe-a,--arrayoption.
repsetSpecifiesthereplicationsetorsets.
Ifyoudonotspecifyareplicationset,thenasummaryofallthereplicationsetsonthearrayislisted.
Examplessscslist-acorporaterepsetListsalloftherepsetsonthearraynamedcorporate.
sscslist-acorporaterepsetmail/1Liststhedetailsofthereplicationsetmail/1onthearraynamedcorporate.
ResponseFormat(summaryofallreplicationsetswhennoreplicationsetnameisspecified)Replicationset:local-volume-name/1ConsistencyGroup:yes|noRemotevolume:remote-volReplicationPeer:replication-peer-name.
.
.
Replicationset:local-volume-name/1ConsistencyGroup:yes|noRemotevolume:remote-volReplicationPeer:replication-peer-nameChapter4ConfigurationCommandsforArrayswithRAIDControllers125ResponseFormat(detailswhenareplicationsetnameisspecified)Replicationset:repset-nameLocalvolume:volume-nameSynchronizationprogress:Replicating|Unsynchronized|Synchronizationinprogress|Suspended|Failed|NotReady|FailedSuspendedRole:Primary|SecondarySize:size-in-megabytesReplicationpeer:remote-array-nameReplicationpeerWWN:remote-array-WWNRemotevolume:remote-volume-nameRemotevolumeWWN:remote-volume-WWNMode:Synchronous|AsynchronousConsistencygroup:yes|noReplicationpriority:lowest|low|medium|high|highestAutosynchronize:Enabled|DisabledlistsasportListsSASportinformation.
Synopsislist-a[-cA|B]sasport[sasport-id,.
.
]DescriptionListspertinentSASportinformation.
126SunStorageTekCommonArrayManagerCLIGuideOctober2008Options-a,--arraySpecifiesthearrayforwhichyouwanttoobtainSASportinformation.
-c,--controllerA|BSpecifiesthecontrollerforwhichyouwanttoviewSASportinformation.
Ifnocontrollerisspecified,summaryinformationforbothcontrollersisdisplayed.
sasportSpecifiestheSASportorportsforwhichyouwantinformation.
PortsarespecifiedasA/1toA/4andB/1toB/4.
IfnoSASportisspecified,detailsforallportsaredisplayed.
Examplessscslist-aQuartzsasportArray:QuartzController:BSASPort:B/1PortWWN:50:0A:0B:81:D2:BA:60:04Speed:1Gb/sMaximumSpeed:7Gb/sChannelNumber:1LinkStatus:UpArray:QuartzController:BSASPort:B/2PortWWN:50:0A:0B:81:D2:BA:60:0CSpeed:1Gb/sMaximumSpeed:7Gb/sChannelNumber:2LinkStatus:UpChapter4ConfigurationCommandsforArrayswithRAIDControllers127Array:QuartzController:BSASPort:B/3PortWWN:50:0A:0B:81:D2:BA:60:08Speed:1Gb/sMaximumSpeed:7Gb/sChannelNumber:3LinkStatus:UpArray:QuartzController:ASASPort:A/1PortWWN:50:0A:0B:81:D2:BB:10:04Speed:1Gb/sMaximumSpeed:7Gb/sChannelNumber:1LinkStatus:UpArray:QuartzController:ASASPort:A/2PortWWN:50:0A:0B:81:D2:BB:10:0CSpeed:1Gb/sMaximumSpeed:7Gb/sChannelNumber:2LinkStatus:Up128SunStorageTekCommonArrayManagerCLIGuideOctober2008Array:QuartzController:ASASPort:A/3PortWWN:50:0A:0B:81:D2:BB:10:08Speed:1Gb/sMaximumSpeed:7Gb/sChannelNumber:3LinkStatus:UplistsnapshotListsthespecifiedsnapshotorsnapshotsassociatedwiththisarray.
Synopsislist-asnapshot[]DescriptionListsthespecifiedsnapshotorsnapshotsassociatedwiththisarray.
Options-a,--arraySpecifiesthearrayassociatedwiththissnapshot.
snapshotSpecifiesthesnapshotorsnapshotsyouwanttoview.
Ifyoudonotspecifyasnapshot,thenamesofallthesnapshotsinthearrayarelisted.
Examplessscslist-aarray00snapshotsnap1Chapter4ConfigurationCommandsforArrayswithRAIDControllers129ResponseFormat(whennovalueisspecified)Snapshot:snapshot-name.
.
.
Snapshot:snapshot-nameResponseFormat(detailedoutputifoneormorevaluesarespecified)Volume:snapshot-volume-nameType:snapshotWWN:WWNVirtualDisk:virtual-disk-name-of-parent-volumeSize:size-of-parentMBState:stateStatus:statusAction:actionCondition:Optimal|Degraded|Failed|ImpairedController:A|BPreferredController:A|BModificationPriority:lowest|low|medium|high|highestWriteCache:Enabled|DisabledWriteCacheWithReplication:Enabled|DisabledWriteCacheWithoutBatteries:Enabled|DisabledFlushCacheAfter:timeDiskScrubbing:Enabled|DisabledDiskScrubbingWithRedundancy:Enabled|DisabledPercentFull:0.
.
100%FailurePolicy:failbasewrite|failsnapshot130SunStorageTekCommonArrayManagerCLIGuideOctober2008WarningThreshold:0.
.
100CreationDate:dateBaseVolume:base-volume-nameReserveVolume:reserve-volume-nameReserveStatus:online|offlineReserveSize:nResponseFormatNotes:Poolsandprofilesmaybeempty,andrepresentedbythesymbol'-'(dash).
Forastandardvolume,thisindicatesthatthecurrentconfigurationforthevolumedoesnotfallintoanypool'sdefinedparameters.
Forsnapshotvolumesthesevalueswillalwaysbeempty.
listtrayListsinformationaboutoneormorestoragetraysinthearray.
Synopsislist-atray[]DescriptionListsinformationaboutoneormorestoragetraysinthearray.
Options-a,--arraySpecifiesthearrayassociatedwiththistray.
traySpecifiesthetrayIDortrayIDsyouwanttodisplay.
IfnotrayIDisspecified,thenthenamesofallthetraysinthearrayarelisted.
Examplessscslist-aarray01tray1Chapter4ConfigurationCommandsforArrayswithRAIDControllers131ResponseFormat(summaryofalltrayswhennovalueisspecified)Tray:tray-ID.
.
.
.
Tray:tray-IDResponseFormat(detailofatraywhenavalueisspecified)Tray:tray-IDArrayType:6140Role:DriveModule|ControllerModule|UnknownState:Enabled|DisabledStatus:OK|IDmismatch|IDconflict|ESMfirmwaremismatchESMmiswire|minihubspeedmismatch|unsupportedDiskType:FibreChannel|SATA|SASNumberofDisks:nlistvdiskListsvirtualdisk(vdisk)orvirtualdisksinformationassociatedwiththisarray.
Synopsislist-avdisk[]DescriptionListsvirtualdisk(vdisk)orvirtualdisksinformationassociatedwiththisarray.
Options-a,--arraySpecifiesthearrayorarraysassociatedwiththisvirtualdisk.
132SunStorageTekCommonArrayManagerCLIGuideOctober2008vdiskSpecifiesthevirtualdiskordisksyouwanttoshow.
Ifnovirtualdisknamesarespecified,allvirtualdisknamesarelisted.
Examplessscslist-aarray01vdiskdisk1,2,3,4ResponseFormat(summaryofallvdiskswhennovalueisspecified)VDisk:virtual-disk-name.
.
.
.
VDisk:virtual-disk-nameResponseFormat(detailofavdiskwhenavalueisspecified)VirtualDisk:virtual-disk-nameStatus:Optimal|Degraded|Failed|ImpairedState:State(Ready,Degraded,etc.
)NumberofDisks:number-of-disksRAIDLevel:0|1|3|5|6TotalCapacity:capacityConfiguredCapacity:capacityAvailableCapacity:capacityArrayName:array-nameArrayType:array-typeDiskType:FC|SATA|SASMaximumVolumeSize:sizeAssociatedDisks:Disk:disk-nameChapter4ConfigurationCommandsforArrayswithRAIDControllers133.
.
.
.
Disk:disk-nameAssociatedVolumes:Volume:volume-name.
.
.
.
Volume:volume-namelistvolumeListsvolumeinformation.
Synopsislist-a[-p][-v]volume[]DescriptionListsvolumeinformation.
Options-a,--arraySpecifiesthearrayassociatedwiththisvolume.
Forcross-platformcompatibility,youcansubstitute-X,--storage-deviceinplaceofthe-a,--arrayoption.
-p,--poolSpecifiesthepoolnameassociatedwiththisvolume.
Ifapoolisspecified,allvolumesinthatpoolarelisted.
-v,--vdiskSpecifiesthevirtual-diskassociatedwiththisvolume.
volumeSpecifiesthevolumenameornamesassociatedwiththisarray.
Ifnovolumesarespecified,asummaryofallvolumesislisted.
Usepoolandvirtual-disktodisplaylistedvolumes.
134SunStorageTekCommonArrayManagerCLIGuideOctober2008Examplessscslist-aarray01-ppool1volumeORACLE-1ResponseFormat(summaryofallvolumeswhennovalueisspecified)Volume:volume-nameType:typePool:pool-nameProfileprofile-name.
.
.
.
Volume:volume-nameType:typePool:pool-nameProfileprofile-nameResponseFormat(detailedoutputifspecifiedvolumeisastandard,source,ortargetvolume)Volume:volume-nameType:Standard|Source|Target|ReplicatedWWN:WWNPool:pool-nameProfile:profile-nameVirtualDisk:virtual-disk-nameSize:sizeState:Free|MappedStatus:Online|OfflineAction:current-actionCondition:Optimal|Degraded|Failed|ImpairedReadOnly:Yes|NoController:A|BPreferredController:A|BModificationPriority:Lowest|Low|Medium|High|HighestWriteCache:Enabled|DisabledWriteCacheWithReplication:Enabled|DisabledChapter4ConfigurationCommandsforArrayswithRAIDControllers135WriteCacheWithoutBatteries:Enabled|DisabledFlushCacheAfter:timeDiskScrubbing:Enabled|DisabledDiskScrubbingWithRedundancy:Enabled|DisabledVolumeCopyTargets:TargetVolume:volume-name.
.
.
TargetVolume:volume-nameSnapshot:snapshot-nameCreationTime:timeReserve:reserve.
.
.
Snapshot:snapshot-nameCreationTime:timeReserve:reserveAssociations:Host:host-nameLUN:LUN-IDInitiator:initiatorWWN:WWNorHostGroup:hostgroup-nameLUN:LUN-IDInitiator:initiatorWWN:WWNResponseFormatNotes:Poolsandprofilescanbeempty,inwhichcasetheyarerepresentedbythesymbol'-'(dash).
Forastandardvolume,thisindicatesthatthecurrentconfigurationforthevolumedoesnotfallintoanypool'sdefinedparameters.
listvolume-copyListsvolume-copyinformation(notapplicableto2500Series).
Synopsislist-a[-s]volume-copy136SunStorageTekCommonArrayManagerCLIGuideOctober2008DescriptionListsvolumecopyinformation.
Ifneitherthesourcevolumenorthetargetvolumeisspecified,asummaryofallvolumecopiesislisted.
Ifthesourcevolumeorthetargetvolumeisspecified,adetailedlistingofeachisgenerated.
Options-a,--arraySpecifiesthearrayassociatedwiththevolumesthatyouwanttolist.
-s,--source-volumeSpecifiesthesourcevolumeorvolumesthatyouwanttolist.
-t,--target-volumeSpecifiesthetargetvolumeorvolumesthatyouwanttolist.
Examplessscslist-aarray00-svol1,vol3volume-copyResponseFormat(summaryofallvolumecopieswhennovolumecopynameisspecified)SourceVolume:source-volume-nameTargetVolume:target-volume-name.
.
.
SourceVolume:source-volume-nameTargetVolume:target-volume-nameResponseFormat(detailedoutputifavalueisspecified)VolumeCopy:SourceVolume:source-volume-nameTargetVolume:target-volume-nameTargetReadOnly:Enabled|DisabledStatus:InProgress|Completed|StoppedPercentComplete:0.
.
.
100Chapter4ConfigurationCommandsforArrayswithRAIDControllers137Priority:lowest|low|medium|high|highestCopyStartTimestamp:timestampCopyCompletionTimestamp:timestampmaphostMapsoneormorevolumestoahost.
Synopsismap-a[-Preadwrite|readonly][-v]hostDescriptionMapsoneormorevolumesandsnapshotstoahost.
Anypreviousmappingsforthegivenvolumesandsnapshotsareremoved.
Options-a,--arraySpecifiesthearrayassociatedwiththishost.
Forcross-platformcompatibility,youcansubstitute-X,--storage-deviceinplaceofthe-a,--arrayoption.
-l,--lun-idSpecifiesalogicalunitnumber(LUN).
ALUNcanbespecifiedonlywhenmappingasinglevolume.
IfnoLUNisspecified,asmanysuccessiveunusedLUNsasneededareused,startingwiththefirstavailableLUN.
Youcanhaveupto256or32LUNsperhostorhostgroup.
The6540andFLX380arraysallow32LUNIDsonly.
-P,--permissionreadwrite|readonlySpecifiesthatthepermissionforaccessingthissnapshotisread-writeorread-only.
-s,--snapshotSpecifiesthesnapshotvolumenameornamesassociatedwiththishost.
-v,--volume138SunStorageTekCommonArrayManagerCLIGuideOctober2008Specifiesthevolumeassociatedwiththishost.
hostSpecifiesthehostthatyouwanttomaptothevolume.
Examplessscsmap-aarray00-vvol01,vol02hosthost01maphostgroupMapsoneormorevolumestoahostgroup.
Synopsismap-a[-s]hostgroupDescriptionMapsoneormorevolumesandsnapshotstoahostgroup.
Anypreviousmappingsforthegivenvolumesorsnapshotsareremoved.
Options-a,--arraySpecifiesthearrayassociatedwiththishostgroup.
-v,--volumeSpecifiesthevolumestobemappedtothishostgroup.
-s,--snapshotSpecifiesthesnapshotvolumestobemappedtothishostgroup.
-l,--lun-idSpecifiestheLUNIDoftheinitiatorthatyouwanttomaptothishostgroup.
ALUNcanbespecifiedonlywhenmappingasinglevolume.
IfnoLUNisspecified,asmanysuccessiveunusedLUNsasnecessaryareused,startingwiththefirstavailableunusedLUN.
Chapter4ConfigurationCommandsforArrayswithRAIDControllers139Youcanhaveupto256or32LUNsperhostorhostgroup.
The6540allows32LUNIDsonly.
hostgroupSpecifiesthehostgroupname.
Examplessscsmap-aarray00-vvol01,vol02hostgrouphg01mapinitiatorMapsoneormoreinitiatorstoavolumeorsnapshot.
Synopsismap-a[-Preadwrite|readonly][-v]initiatorDescriptionMapsaninitiatortoavolumeorsnapshot.
Anypreviousmappingsforthegivenvolumesorsnapshotsareremoved.
Options-a,--arraySpecifiesthearrayassociatedwiththeinitiator.
Forcross-platformcompatibility,youcansubstitute-X,--storage-deviceinplaceofthe-a,--arrayoption.
-l,--lun-idSpecifiesthelogicalunitnumberofthisinitiator.
ALUNcanbespecifiedonlywhenmappingasingleinitiator.
IfnoLUNisspecified,thefirstavailableLUNisused.
Youcanhaveupto256or32LUNsperhostorhostgroup.
The6540allows32LUNIDsonly.
-P,--permissionreadwrite|readonlySpecifiesthatthepermissionforaccessingthisvolumeisread-writeorread-only.
-s,--snapshot140SunStorageTekCommonArrayManagerCLIGuideOctober2008Specifiesthesnapshotvolumestobemappedtothisinitiator.
-v,--volumeSpecifiesthevolumestobemappedtothisinitiator.
initiatorSpecifiestheinitiatornametowhichthearrayisbeingmapped.
Ifnovolumeorsnapshotisspecified,theinitiatorismappedintothedefaultpartition.
Examplessscsmap-aarray00-vv01initiatorinit01mapsnapshotMapsoneormoresnapshotstoahostorhostgroup.
Synopsismap-a[-Preadwrite|readonly][-i][-h|-g][-l]snapshotDescriptionMapsoneormoresnapshotstoahostorhostgroup.
Ifnohostorhostgroupisspecified,thesnapshotorsnapshotsaremappedintotheDefaultpartition.
Options-a,--arraySpecifiesthearrayassociatedwiththissnapshot.
Forcross-platformcompatibility,youcansubstitute-X,--storage-deviceinplaceofthe-a,--arrayoption.
-g,--hostgroupSpecifiesthehostgroupthatyouwanttomaptothesnapshots.
-h,--hostnameSpecifiesthehostthatyouwanttomaptothesnapshot.
Chapter4ConfigurationCommandsforArrayswithRAIDControllers141-i,--initiatorSpecifiestheinitiatorthatyouwanttomaptothesnapshot.
-l,--lun-idSpecifiesthelogicalunitnumberofthisinitiator.
ALUNcanbespecifiedonlywhenmappingasinglevolume.
IfnoLUNisspecified,thefirstavailableLUNisused.
Youcanhaveupto256or32LUNsperhostorhostgroup.
The6540allows32LUNIDsonly.
-P,--permissionreadwrite|readonlySpecifiesthatthepermissionforaccessingthissnapshotisread-writeorread-only.
snapshotSpecifiesthenameornamesofthesnapshotyouwanttomap.
Anypreviousmappingsforthesnapshotswillberemoved.
Examplessscsmap-aarray00-ghg01snapshotsnap1,snap2mapvolumeMapsoneormorevolumestoahostorhostgroup.
Synopsismap-a[-Preadwrite|readonly][-i][-h][-g][-l]volumeDescriptionMapsoneormorevolumestoahostorhostgroup.
Anypreviousmappingsforthegivenvolumeorvolumesareremoved.
Options-a,--array142SunStorageTekCommonArrayManagerCLIGuideOctober2008Specifiesthearrayassociatedwiththisvolume.
Forcross-platformcompatibility,youcansubstitute-X,--storage-deviceinplaceofthe-a,--arrayoption.
-g,--hostgroupSpecifiesthehostgroupnameassociatedwiththisvolume.
-h,--hostnameSpecifiesthehostthatyouwanttomaptothevolume.
-i,--initiatorSpecifiestheinitiatorthatyouwanttomaptothevolume.
-l,--lun-idSpecifiesthelogicalunitnumberofthisinitiator.
ALUNcanbespecifiedonlywhenmappingasinglevolume.
IfnoLUNisspecified,thefirstavailableLUNisused.
Youcanhaveupto256or32LUNsperhostorhostgroup.
The6540allows32LUNIDsonly.
-P,--permissionreadwrite|readonlySpecifiesthatthepermissionforaccessingthisvolumeisread-writeorread-only.
volumeSpecifiesthevolumenametowhichthearrayisbeingmapped.
Ifnohostorhostgroupisspecified,thevolumeorvolumesaremappedintothedefaultpartition.
Examplessscsmap-aarray00-ghg01volumevol01,vol02modifyarrayModifiestheconfigurationofthespecifiedarray.
Chapter4ConfigurationCommandsforArrayswithRAIDControllers143Synopsismodify[-osolaris_dmp|solaris|sun_storedge|sun_storedge_nas_gateway|aix|hpux|linux|irix|ptx|netware_failover|netware_non_failover|win2k_clustered|win2k_non_clustered|winnt|winnt_non_clustered|win2k_non_clustered_dmp|win2k_clustered_dmp|dsp|aixavt|winnt_clustered][-s][-S][-kdisable|][-f][-h][-b][-T][-N][-p]arrayDescriptionModifiestheconfigurationofthespecifiedarray.
Options-o,--os-typeSpecifiestheoperatingsystemtype.
Usethecommandsscslist-aarray-nameos-typetoviewalloftheoperatingsystemsthataresupportedbythearray.
-b,--cache-block-sizeSpecifiesthecacheblocksize.
-f,--failover-alertSpecifiestheLUNfailoveralerttimeframe,inseconds.
Thesystemalertsyoutoanarrayfailoverattheallottedtime.
-h,--hot-spareSpecifiesthehot-sparecountforthearray.
Whenahot-sparedrivecountisspecied,analgorithmdistributeshot-sparedrivesacrossthetraysofthearray.
Tospecifyadrive,usethesubcommandmodifydisk.
Thehot-sparecountlimitisdependentonthearray:15for6130runningfirmwareversion07.
10.
nn.
nnorlower15for6140and6540runningfirmwareversion07.
10.
nn.
nnorlower,ORfirmwareversion07.
15.
nn.
nnorhigher.
15for2500seriesarraysrunningfirmwareversion07.
10.
nn.
nnorlower,ORfirmwareversion07.
35.
nn.
nnorhigher.
Unlimitedfor6580and6780arrays.
-k,--disk-scrubbingdisable|Specifiestheinterimafterwhichthesystemscrubsthedisk.
144SunStorageTekCommonArrayManagerCLIGuideOctober2008-N,--new-nameSpecifiesthenewnameofthearray.
-p,--passwordSpecifiesthearraypassword.
-s,--cache-startSpecifiesthearraycachestart.
-S,--cache-stopSpecifiesthearraycachestop.
-T,--name-typeSpecifiesthearraynamingtype.
arraySpecifiesthenameofthearraytobemodified.
Examplessscsmodify-f30-Tarray-namearrayARRAY1modifycontrollerModifiesthecontrollersettings.
Synopsismodify-a[-e][-d][-i][-g][-m]controllerModifiestheEthernetportofacontrollerusingthespecifiedIPparameters.
modify-a[-e1|2]-dcontrollerModifiestheIPparametersofacontroller'sEthernetportusingtheDynamicHostControlProtocol(DHCP).
modify-a-EcontrollerVerifiesthenetworkconnectivitybetweenthearraycontrollerandthemanagementsoftware.
Chapter4ConfigurationCommandsforArrayswithRAIDControllers145modify-a-e[-v][-d][-i][-g][-m]controllerModifiescontrollerIPparameters,includingoptiontoenableordisableIPv4.
NOTE:Onlysupportedon6580and6780.
modify-a-e[-V][-d][-I][-r][-m][-d][-s]controllerModifiescontrollerEthernetportandIPparameters,includingIPv6optionsandportspeed.
NOTE:IPv6onlysupportedon6140and6540arrayswithfirmwareversion07.
15.
nn.
nnorhigher,2500seriesarrayswithfirmwareversion07.
35.
nn.
nnorhigher,and6580and6780arrays.
Portspeedoptiononlysupportedon6580and6780arrays.
Options-a,--arraySpecifiesthearrayassociatedwiththiscontroller.
-d,--dhcpon|offSpecifieswhetherthedynamichostcontrolprotocol(DHCP)isactive.
-d,--duplexSpecifiesportcapability,fullorhalfduplex.
-e,--ethernet-port1|2SpecifiestheEthernetportnumber.
-E,--test-communicationVerifiesthenetworkconnectivitybetweenthearraycontrollerandthemanagementsoftware.
-g,--gatewaySpecifiesthegatewayIPaddress.
IPaddressescanbeeitherDomainNameSystem(DNS)namesordotteddecimaladdresses.
-i,--ipaddressSpecifiesthecontroller'sIPaddress.
IPaddressescanbeeitherDomainNameSystem(DNS)namesordotteddecimaladdresses.
146SunStorageTekCommonArrayManagerCLIGuideOctober2008-I,--v6-addressSpecifiesIPv6IPaddress.
-m,--netmaskSpecifiesthecontroller'snetworkmask.
-m,--modeEnablesordisablesportmode.
-r,--routerSpecifiesrouterIPaddress.
-s,--speedSpecifiestheportspeed.
Portspeedoptiononlysupportedon6580and6780arrays.
-V,--ip-v6EnablesordisablesIPv6.
IPv6onlysupportedon6140and6540arrayswithfirmwareversion07.
15.
nn.
nnorhigher,2500seriesarrayswithfirmwareversion07.
35.
nn.
nnorhigher,and6580and6780arrays.
-v,--ip-v4EnablesordisablesIPv4.
controllerA|BSpecifiesthecontrollertomodify.
Examplessscsmodify-aarray00-g10.
0.
5.
2controllerAsscsmodify-aarray00-e2-doncontrollerAsscsmodify-aarray00-EcontrollerBmodifydateModifiesthedateonthearray.
Chapter4ConfigurationCommandsforArrayswithRAIDControllers147Synopsismodify-a[-G][-s]dateDescriptionModifiesthedateonthearray,allowingyoutosetthetimeonthearray,ortosynchronizethetimewiththemanagementhost(thatis,settingthearray'stimetothemanagementhost'stime.
)Options-a,--arraySpecifiesthearrayforwhichyouwanttospecifydateinformation.
-G,--GMTtrue|falseSpecifieswhethertosetGreenwichMeanTime(GMT)totrueorfalse.
IfGMTissettotrue,thedateisGMTtime.
IfGMTissettofalse,thelocaltimezoneonthehostsystemisassumed.
-s,--synchronizeSpecifieswhethertosynchronizethedatewiththedateontheelementmanagerhost.
Ifthisoptionisalreadyset,youwillnotbeabletospecifyadate.
dateSpecifiesthedate.
mmddSpecifiesthemonthandday.
Forexample,0331isMarch31.
HHMMSpecifiesthehourandminute.
Thehourisbasedona24-hourclock.
Forexample,1:30p.
m.
is1330.
ccSpecifiesthecenturypartoftheyear.
yySpecifiesthetwo-digityear.
.
SS148SunStorageTekCommonArrayManagerCLIGuideOctober2008Specifiesthesecondsofthehour.
Examplessscsmodify-Gfalsedate010112002003.
00modifydiskSpecifiesthediskrole.
Synopsismodify-a-htrue|falsediskDescriptionSpecifiesthediskrole.
Options-a,--arraySpecifiesthearrayassociatedwiththisdisk.
-h,--hot-sparetrue|falseSpecifieswhetheryouwantthisdisktobeadesignatedhot-spare.
diskSpecifiesthediskthatyouwanttomodify.
Examplessscsmodify-aarray00-htruediskt0d01modifyfcportModifiestheFibreChannelportsettingsonthespecifiedarray.
Chapter4ConfigurationCommandsforArrayswithRAIDControllers149Synopsismodify-a-cA|B-l|N/A|AnyfcportDescriptionModifiestheFibreChannelportsettingsonthespecifiedarray.
Options-a,--arraySpecifiesthearrayassociatedwiththiscontroller.
-c,--controllerA|BSpecifiesthecontroller.
-l,--loop-id|N/A|AnySpecifiesthepreferredloopID.
fcportSpecifiestheFibreChannelportnumberthatyouwanttomodify.
PortsarespecifiedasA/1toA/4andB/1toB/4.
IfnoFCportisspecified,detailsforallportsaredisplayed.
Examplessscsmodify-aarray00-cB-l125fcport1modifyhostModifiesthehostname.
Synopsismodify-a[-N][-g]hostDescriptionModifiesthehostname.
Youcanhaveupto256hostsperarrayonthe6130/6140arrays.
The6540allows32hostsonly.
150SunStorageTekCommonArrayManagerCLIGuideOctober2008Options-a,--arraySpecifiesthearrayassociatedwiththishost.
Forcross-platformcompatibility,youcansubstitute-X,--storage-deviceinplaceofthe-a,--arrayoption.
-N,--new-nameSpecifiesthenewnameforthehost.
-g,--hostgroupSpecifiesthehostgroupintowhichtoincludethishost.
hostSpecifiesthecurrenthostname.
Examplessscsmodify-aarray00-Nhost02hosthost01modifyhostgroupModifiesthehostgroupname.
Synopsismodify-a-NhostgroupModifiesthehostgroupname.
Youcanhaveupto256hostgroupsperarrayonthe6130/6140arrays.
The6540allows32hostgroupsonly.
Options-a,--arraySpecifiesthearrayassociatedwiththishostgroup.
-N,--new-nameSpecifiesthenewnameforthehostgroup.
hostgroupSpecifiesthecurrentnameofthehostgroupthatyouwanttorename.
Chapter4ConfigurationCommandsforArrayswithRAIDControllers151Examplessscsmodify-aarray00-Nhg02hostgrouphg01modifyinitiatorModifiesaninitiator.
Synopsismodify-a[-h][-N][-Twwn|initiator_name][-osolaris_dmp|solaris|sun_storedge|sun_storedge_nas_gateway|aix|hpux|linux|lnxavt|irix|ptx|netware_failover|netware_non_failover|win2k_clustered|win2k_non_clustered|winnt|winnt_non_clustered|win2k_non_clustered_dmp|win2k_clustered_dmp|dsp|aixavt|winnt_clustered]initiatorDescriptionModifiestheinitiator.
Options-a,--array-nameSpecifiesthearrayforwhichyouwanttomodifytheinitiator.
Forcross-platformcompatibility,youcansubstitute-X,--storage-deviceinplaceofthe-a,--arrayoption.
-h,--hostnameSpecifiesthenewhosttobeassociatedwiththisinitiator.
-N,--new-nameSpecifiesthenewinitiatorname.
-T,--name-typewwn|initiator_nameSpecifiestheWorldWideNameortheinitiatorname.
Ifname-typeisnotspecified,theinitiator-IDisassumedtobeaninitiatorname.
YoucanmodifytheWWNiftheinitiatorisofflineonly.
-o,--os-type152SunStorageTekCommonArrayManagerCLIGuideOctober2008Specifiestheoperatingsystemtype.
Usethecommandsscslist-aarray-nameos-typetoviewalloftheoperatingsystemsthataresupportedbythearray.
initiatorSpecifiestheinitiatoridentifier.
Examplessscsmodify-aarray00-NLexington_01initiatormyInitiator_01modifyiperformanceModifiesthesettingsforiSCSIperformancedata.
Synopsismodify-a[-S][-p][-r][-b]iperformanceDescriptionModifiesthesettingsforiSCSIperformancedata.
Options-a,--arraySpecifiesthenameofthearrayforwhichyouwanttomodify.
-S,--statusEnablesordisablesiSCSIperformancemonitoring.
-p,--pollSpecifiesthepollintervalfrequencyas1,5,or15minutes.
-r,--retentionSpecifiestheperiodoftimeyouwanttoretaintheperformancedataincache.
-b,--baselineSetsthebaselinetimefortheiSCSIarray.
Iftrue,thecurrentarraytimeisusedasthebaselinetime.
Chapter4ConfigurationCommandsforArrayswithRAIDControllers153Examplessscsmodify-aiSCSILCA_2-Son-p5iperformancemodifyiscsi-portModifiesaniSCSIport.
Synopsismodify-a[-c][-p][-m][-P][-d][-i][-g][-n][-v][-V][-e][-E]iscsi-portDescriptionModifiesaniSCSIportconfiguredforaspecifiedarray.
Optionsa,--arraySpecifiesthearrayforwhichyouwanttomodifytheiSCSIport.
-c,--controllerSpecifiesthecontroller.
-d,--dhcpTurnsDHCPonoroff.
-E,--ethernet-priority-valueSpecifiestheethernetpriorityvalue.
-e,--ethernet-priorityEnablesordisablestheethernetpriority.
-g,--gatewaySpecifiestheIPaddressgateway.
-i,--ipaddress154SunStorageTekCommonArrayManagerCLIGuideOctober2008SpecifiestheIPaddress.
-m,--max-trans-unitSpecifiesthemax-trans-unit.
-n|,-netmaskSpecifiesthenetMask.
-P,--icmp-pingEnablesordisablestheICMPpingfeature.
-p,--portSpecifiesthedefaultportnumber,3260,oraportnumberfrom49152to65535.
-v,--VLANEnablesordisablestheVLANfeature.
-V,--VLAN-idSpecifiestheVLANID.
iscsi-portSpecifiestheiSCSIportID.
modifyiscsi-targetModifiesaniSCSItarget.
Synopsismodify-a[-A]iscsi-targetmodify-a-piscsi-targetmodify-a-uiscsi-targetmodify-a-niscsi-targetmodify-a-p-i-d-qiscsi-targetChapter4ConfigurationCommandsforArrayswithRAIDControllers155modify-a-i-s[-h][-p]iscsi-targetmodify-a-i-d[-q][-p]iscsi-targetDescriptionModifiesaniSCSItargetconfiguredforaspecifiedarray.
Options-a,--arraySpecifiesthearrayforwhichyouwanttomodifytheiSCSItarget.
-A,--aliasAnaliasdefinedforthearray.
-p,--portSpecifiesthedefaultportnumber,3205,oraportnumberfrom49152to65535.
-u,--authenticationSpecifiesauthenticationasnone,CHAP,orboth.
-n,--unnamed-discoverySpecifiestoenableordisableunnameddiscovery.
-s,--statelessSpecifiestoenableordisablestateless.
-h,--ip-v6-addressSpecifiestheIPv6address.
-i,--isnsSpecifiestoenableordisableiSNS.
-d,--dhcpSpecifiestosetDHCPtoonoroff.
-q,--ip-addressSpecifiestosettheIPaddresstoIPv4.
iscsi-target156SunStorageTekCommonArrayManagerCLIGuideOctober2008SpecifiestheiSCSIqualifiedtargetname.
Forexample:iqn.
1992-01.
com.
sun:1535.
600a0b80002f9da000000000461255f9Examplessscsmodify--aliasfrediscsi-targetiqn.
199201.
com.
sun:1535.
600a0b80002f9da000000000461255f9modifyjobsCancelsorprioritizesarunningoroutstandingjob.
Synopsismodify-a[-k][-plowest|low|medium|high|highest]jobs[]DescriptionCancelsorprioritizesarunningoroutstandingjobusingthejobidentificationnumber.
Options-a,--arraySpecifiesthearrayforwhichyouwanttomodifythejoborjobs.
-k,--killCancelsarunningoroutstandingjoborjobs.
-p,--prioritylowest|low|medium|high|highest]Specifiesanorderofpriorityfromwhichtodeterminetheactionofthemodification.
jobsSpecifiesthejobtobecancelledorprioritized.
Examplessscsmodify-plowjobsVOL:00C1408F84C2Chapter4ConfigurationCommandsforArrayswithRAIDControllers157modifylicenseActivatesreplicationsetlicenses(applicableto2500Seriesonlywhenrunningfirmwareversion07.
35.
nn.
nnorhigher).
Synopsismodify-a-A[-v]licenseReplicationSetActivatesreplicationsetlicensesonthespecifiedarrayusingthedesignatedvirtualdiskforreplicationsetrepositoryvolumes.
Ifthevirtualdiskisomitted,themanagerchoosesanappropriatevirtualdisktocreatetherepositoryvolumes.
modify-a-A-r1-n[-kANY|FC|SAS|SATA]licenseReplicationSetActivatesreplicationsetlicensesonthespecifiedarray,creatinganewvirtualdiskwiththedesignatedRAIDlevelanddisktypeforthereplicationsetrepositoryvolumes.
RAIDlevel1isusedincombinationwithnumber-of-disks1to224.
modify-a-A-r3|5|6|-n[-kANY|FC|SAS|SATA]licenseReplicationSetActivatesreplicationsetlicensesonthespecifiedarray,creatinganewvirtualdiskwiththedesignatedRAIDlevelanddisktypeforthereplicationsetrepositoryvolumes.
RAIDlevels3,5,or6areusedincombinationwithnumber-of-disks1to30.
modify-a-A-r1|3|5|6-dlicenseReplicationSetActivatesreplicationsetlicensesonthespecifiedarray,creatinganewvirtualdiskwiththedesignatedRAIDlevelandnamesofdiskstobeusedforthereplicationsetrepositoryvolumes.
modify-a-IlicenseReplicationSetDeactivatesreplicationsetlicensesonthespecifiedarrayanddeletesthereplicationsetrepositoryvolumes.
Options-a,--arraySpecifiesthearrayforwhichyouwanttoactivateordeactivateareplicationsetlicense.
Forcross-platformcompatibility,youcansubstitute-X,--storage-deviceinplaceofthe-a,--arrayoption.
158SunStorageTekCommonArrayManagerCLIGuideOctober2008-A,--activateActivatesareplicationsetlicense.
-I(thatis,uppercaseletter"i"),--deactivateDeactivatesareplicationsetlicense.
-v,--virtual-diskSpecifiesthevirtualdiskthatyouwanttoselect.
-r,--raid-level1SpecifiestheRAIDlevel1,incombinationwithnumber-of-disks1to224.
-r,--raid-level3|5|6SpecifiesRAIDlevel3,5,or6,incombinationwithnumber-of-disks1to30.
-n,--number-of-disksSpecifiesthenumberofdisks,1to224,incombinationwithRAIDlevel1.
-n,--number-of-disksSpecifiesthenumberofdisks,1to30,incombinationwithRAIDlevels3,5,or6.
-k,--disk-typeANY|FC|SATA|SASSpecifiesthedisktype:ANY-Anytypeofdisk,includingFC,SATA,orSAS.
FC-FibreChannelSATA-SerialAdvancedTechnologyAttachmentSAS-SerialAttachedSCSI-d,--diskSpecifiesthenameddisk.
licenseSpecifiesthatyouwanttomodifyalicense.
ReplicationSetSpecifiesthelicensethatyouwanttomodify.
Examplessscsmodify-aeurope-A-v3licenseReplicationSetChapter4ConfigurationCommandsforArrayswithRAIDControllers159Activatesreplicationsetlicensesonthearraynamedeuropeusingexistingvirtualdisk3forthereplicationsetrepositoryvolumes.
sscsmodify-acorporate-A-r3-n3-DFClicenseReplicationSetActivatesreplicationsetlicensesonthearraynamedcorporate,creatinganewvirtualdiskofRAIDlevel3with3FibreChanneldisksforthereplicationsetrepositoryvolumes.
sscsmodify-acorporate-A-r1-dt1d01,t2d02licenseReplicationSetActivatesreplicationsetlicensesonthecorporatearray,creatinganewvirtualdiskofRAIDlevel1with2specificdisksforthereplicationsetrepositoryvolumes.
sscsmodify-aeurope-IlicenseReplicationSetDeactivatesreplicationsetlicensesontheeuropearray.
Thereplicationsetrepositoryvolumeswillbedeleted.
modifynotificationModifiesnotificationoptions.
Synopsismodify-dnotificationmodify-enotificationmodify-p][-i][-k][-f][-f][-u][-q][-z][-o]notificationmodify-m-rnotificationDescriptionModifiesnotificationoptions.
Options-d,--disableDisablesnotification.
160SunStorageTekCommonArrayManagerCLIGuideOctober2008-e,--enableEnablesnotification.
-f,--fromSpecifiestheoriginofthenotificationmessage.
-i,--ipSpecifiestheIPaddressofthedevice.
-k,--secureSpecifieswhethersecurityisused.
-m,--test-messageSpecifiestosendtestmessage.
-o,--portSpecifiestheport.
-p,--pathSpecifiesthepath.
-q,--query-for-passwordQueriesforthecurrentpasswordfortheregisteredarray.
-r,--test-addressSpecifiesaddresswheretestmessagewillbesent.
-u,--userSpecifiestheuserforwhichnotificationwillbemodified.
-z,--max-sizeSpecifiesthemaximumsizeofthenotificationmessage.
notificationlocal-emailSpecifiesyourlocalemailaddressatwhichyouwanttomodifythenotification.
trapSpecifiestheSNMPtrapnotificationmethodtousetoreceivethenotification.
Chapter4ConfigurationCommandsforArrayswithRAIDControllers161modifyperformanceModifiessettingsforperformancemonitoring.
Synopsismodify-a[-Son|off][-p1|5|15][-rforever|1HR|2HR|4HR|1DAY]performanceDescriptionModifiessettingsforperformancemonitoring.
Toresetperformancesettings,togglethestatustooffandbackonagain.
Options-a,--arraySpecifiesthearrayforwhichyouwanttomodifytheperformance.
-S,--statuson|offEnablesordisablesperformancemonitoring.
-p,--poll1|5|15Specifiesthepollintervalfrequencyinminutes.
Thedefaultis15.
-r,--retentionforever|1HR|2HR|4HR|1DAYSpecifiestheamountoftimetoretaindataincache.
Thedefaultdataretentionperiodis1hour.
Examplessscsmodify–aarray00-Son-p5performancemodifypoolModifiesthenameordescriptionofthestoragepoolortheprofilewithwhichthispoolisassociated.
162SunStorageTekCommonArrayManagerCLIGuideOctober2008Synopsismodify-a[-N][-d][-p]poolDescriptionModifiesthenameordescriptionofthestoragepoolortheprofilewithwhichthispoolisassociated.
Youcanchangethesegmentsizeofavolumebyafactorof2only.
Forexample,avolumewithsegmentsizeof32Kcanonlybechangedtoasegmentsizeof64Kor16K.
Tochangethesegmentsizeto256K,thevolumewouldfirstneedtobechangedto64K,then128K,then256K.
Anychangesmadetotheprofileofapoolmustmaintainthissegmentsizerestrictionforallaffectedvolumes.
Options-a,--arraySpecifiesthenameofthearraytoassociatewiththispool.
Forcross-platformcompatibility,youcansubstitute-X,--storage-deviceinplaceofthe-a,--arrayoption.
-N,--new-nameSpecifiesanewnameforthispool.
-d,--descriptionSpecifiesadescriptionofthepool.
Thedescriptioncanbeupto256alphanumericcharacters,whichcanincludeunderscores,dashes,colons,commas,parentheses,curlybrackets,squarebrackets,ticks,tildes,bars,periods,orspaces.
-p,--profileSpecifiesthenameoftheprofiletoassociatewiththispool.
poolSpecifiesthepoolthatyouwanttomodify.
Examplessscsmodify–aarray00-dLexington_01poolSP048763Chapter4ConfigurationCommandsforArrayswithRAIDControllers163modifyprofileModifiesastorageprofileonthearray.
Synopsismodify-a[-r0|1][-s8K|16K|32K|64K|128K|256K|512K][-N][-d][-hon|off][-nvariable|][-Hyes|no][-kANY|FC|SAS|SATA]profilemodify-a[-r3|5|6][-s8K|16K|32K|64K|128K|256K|512K][-N][-d][-hon|off][-nvariable|][-Hyes|no][-kANY|FC|SAS|SATA]profileDescriptionModifiesastorageprofileonthearray.
Youcannotmodifyaprofilethatisinuseandisassociatedwithastoragepool.
Options-a,--arraySpecifiesthenameofthearraytoassociatewiththisprofile.
-r,--raid-level0|1SpecifiestheRAIDlevel:0or1,incombinationwithnumber-of-disks1to224.
-r,--raid-level3|5|6SpecifiestheRAIDlevel:3,5,or6,incombinationwithnumber-of-disks1to30.
-s,--segsize8K|16K|32K|64K|128K|256K|512KSpecifiesthesegmentsize.
-N,--new-nameSpecifiesanewnamefortheprofile.
-d,--description164SunStorageTekCommonArrayManagerCLIGuideOctober2008Specifiesaprofiledescription.
Thedescriptioncanbeupto256alphanumericcharacters,whichcanincludeunderscores,dashes,colons,commas,parentheses,curlybrackets,squarebrackets,ticks,tildes,bars,periods,orspaces.
Enclosingthedescriptioninquotationmarksretainsitexactlyasyouwantit.
-h,--readaheadon|offSpecifiesifthereadaheadsettingisonoroff.
-n,--number-of-disksvariable|Specifiesthenumberofdisks,1to30,incombinationwithRAIDlevel3,5,or6.
-n,--number-of-disksvariable|Specifiesthenumberofdisks,1to224,incombinationwithRAIDlevels0or1.
-H,--hot-spareyes|noSpecifieswhetheryouwantthisdisktobeadesignatedhot-spare.
-k,--disk-typeANY|FC|SATA|SASSpecifiesthedisktype:ANY-Anytypeofdisk,includingFCorSATA.
FC-FibreChannelSATA-SerialAdvancedTechnologyAttachmentSAS-SerialAttachedSCSIprofileSpecifiesthenameoftheprofiletobemodified.
Theprofile-namecanbeupto12alphanumericcharacters.
Examplessscsmodify-d"myprofiledescription"profilerandom_5modifyrepsetModifiesthemode,consistencygroup,orreplicationpriorityofthespecifiedreplicationset(notapplicableto2500Series).
Chapter4ConfigurationCommandsforArrayswithRAIDControllers165Synopsismodify-a[-msync|async][-Gyes|no][-Rlowest|low|medium|high|highest][-senable|disable]repsetModifiestherole,mode,consistencygroup,orreplicationpriorityofthespecifiedreplicationset.
modify-a[-rprimary|secondary][-f]repsetChangestheroleofthelocalvolumeonthespecifiedarray.
modify-a-crepsetSuspendsreplicationonthespecifiedarray.
modify-a-zrepsetResumesreplicationonthespecifiedarray.
modify-a-ErepsetTeststodetermineiftheprimaryvolumeonthespecifiedarrayiscommunicatingcorrectlywithitsreplica(primaryorsecondary).
Options-a,--arraySpecifiesthearrayforwhichyouwanttoactivateordeactivateareplicationsetlicense.
Forcross-platformcompatibility,youcansubstitute-X,--storage-deviceinplaceofthe-a,--arrayoption.
-m,--modesync|asyncSpecifieswhetherthemodeissynchronousorasynchronous.
-G,--consistency-groupyes|noSpecifieswhetherornotthereplicationsetispartofaconsistencygroup.
-R,--replication-prioritylowest|low|medium|high|highestSpecifiestheprioritylevelforthisreplicationset.
-s,--auto-syncenable|disableSpecifieswhetherornottheautosynchronizationpolicyisenabled.
Ifitisnotspecified,thedefaultisdisable.
-r,--roleprimary|secondary166SunStorageTekCommonArrayManagerCLIGuideOctober2008Specifieswhethertheroleisprimaryorsecondary.
-f,--forceIfspecified,itworkswiththe-roptiontoreverseroles.
Ifcommunicationwiththereplicationpeerisnotfunctioning,therolechangeisstillforcedonthelocalvolume.
-c,--suspendSuspendstemporarilythereplicationactivity.
Ifthereplicationsetispartofareplicationconsistencygroup,thenallofthereplicationsetsinthatgrouparesuspended.
-z,--resumeResumesreplicatingareplicationsetthathasbeensuspended,orstartsreplicatingareplicationset.
Ifthereplicationsetispartofareplicationconsistencygroup,thenitsetsallofthereplicationsetsinthatgrouptosynchronize.
-E,--test-communicationTestscommunicationstoareplicationset.
Examplessscsmodify-acorporate-rsecondaryrepsetoracle/1Changestheroleofthelocalvolumeontheoracle/1repsettosecondaryonthearraynamedcorporate.
sscsmodify-acorp_west-rprimary-frepsetmail/1Forcestheroleofthelocalvolumeonthemail/1repsettoprimaryonthesamplecorp_westarray,evenifcommunicationscannotbeestablishedwiththecurrentprimary.
sscsmodify-acorporate-crepsetsap_central/1Suspendsreplicationonthesap_central/1repsetonthecorporatearray.
sscsmodify-acorporate-zrepsetsap_central/1Resumesreplicationonthesap_central/1repsetonthecorporatearray.
sscsmodify-acorporate-Erepsetfinance/1Teststodetermineiftheprimaryvolumefinanceonthecorporatearrayiscommunicatingcorrectlywithitsreplica(primaryorsecondary).
Chapter4ConfigurationCommandsforArrayswithRAIDControllers167modifysnapshotModifiesthespecifiedsnapshot.
Synopsismodify-a[-N][-f][-w][-D]snapshotModifiespropertiesofthesnapshot.
modify-a-esnapshotExtendsthesnapshotreservevolumesizebyaspecifiedamount.
Thisoptionismutuallyexclusiveandcannotbeusedwithanyotheroption.
modify-a-SsnapshotDisablesthesnapshot.
Thisoptionismutuallyexclusiveandcannotbeusedwithanyotheroption.
modify-a-RsnapshotResnapsthesnapshot.
Thisoptionismutuallyexclusiveandcannotbeusedwithanyotheroption.
modify-a[-m][-cA|B][-Wenable|disable][-Menable|disable][-benable|disable][-kenable|disable][-renable|disable]snapshotModifiesthevolumepropertiesofthesnapshotreservevolume.
modify-a[-m][-c][-W][-M][-b][-k][-r][-d]snapshotModifiesthevolumepropertiesofthesnapshotreservevolume,withsnapshotdescription.
DescriptionModifiesthespecifiedsnapshot.
Theargumentsresnapandextendaremutuallyexclusive.
168SunStorageTekCommonArrayManagerCLIGuideOctober2008Options-a,--arraySpecifiesthearrayassociatedwiththissnapshot.
Forcross-platformcompatibility,youcansubstitute-X,--storage-deviceinplaceofthe-a,--arrayoption.
-b,--write-cache-without-batteriesenable|disableSpecifieswhetherwrite-cache-without-batteriesisenabled.
-c,--controllerA|BSpecifiesthecontroller.
-D,--descriptionSpecifiesasnapshotdescription.
Thedescriptioncanbeupto256alphanumericcharacters,whichcanincludeunderscores,dashes,colons,commas,parentheses,curlybrackets,squarebrackets,ticks,tildes,bars,periods,orspaces.
Enclosingthedescriptioninquotationmarksretainsitexactlyasyouwantit.
-d,--descriptionSpecifiessnapshotdescription.
-e,--extendExtendsthesnapshotreservevolumesizebyaspecifiedamount.
-f,--full-policyfailbasewrite|failsnapshotThefull-policyspecifieswhattodoifandwhenthesnapshotfillsup:Failbasewrite-Stopallowingwritestothebasevolume.
Failsnapshot-Stopallowingwritestothesnapshot.
Thisisthedefault.
-k,--disk-scrubbingenable|disableSpecifieswhetherdiskscrubbingisenabled.
-m,--reserve-nameSpecifiesthenameofthereservevolume.
-M,--write-cache-with-mirroringenable|disableSpecifieswhetherwrite-cache-with-mirroringisenabled.
-N,--new-nameSpecifiesanewnameforthesnapshot.
-r,--disk-scrubbing-with-redundancyenable|disableChapter4ConfigurationCommandsforArrayswithRAIDControllers169Specifieswhetherdiskscrubbing-with-redundancyisenabled.
-R,--resnapResnapsthesnapshot.
-S,--disableDisablesthesnapshot.
-w,--warning-thresholdSpecifieswhentoinformyouthatthesnapshotreservevolumeisnearcapacity.
Ifawarning-thresholdisnotspecified,50%isthedefault.
-W,--write-cacheenable|disableSpecifieswhetherthewritecacheisenabled.
snapshotsnapshot-nameSpecifiesthenameofthesnapshottomodify.
Examplessscsmodify-aarray00-Vvol0snapshotvol01_snapmodifytrayModifiesinformationaboutoneormorestoragetraysinthearray.
Synopsismodify-a[-N]tray[]DescriptionModifiesinformationaboutoneormorestoragetraysinthearray.
Options-a,--arraySpecifiesthearrayassociatedwiththistray.
-N,--new-name170SunStorageTekCommonArrayManagerCLIGuideOctober2008Specifiesthenewtrayname.
traySpecifiesthetrayIDortrayIDsyouwanttomodify.
IfnotrayIDisspecified,thenthenamesofallthetraysinthearrayarelisted.
Examplessscsmodify-aarray00-n99tray0modifyvdiskSpecifiesmodificationstoavirtualdisk.
Synopsismodify-a[-N][-dmodify-a[-dDescriptionSpecifiesmodificationstoavirtualdisk.
Optionsa,--arraySpecifiesthearraythatisassociatedwiththevirtualdiskchanges.
-d,--diskSpecifiesparticulardiskstobeaddedtothevirtualdisk.
-f,--defragmentSpecifieswhethertodefragmentthevirtualdiskorvirtualdisks.
-N,--new-nameSpecifiesnewvirtualdiskname.
vdiskChapter4ConfigurationCommandsforArrayswithRAIDControllers171Specifiesthevirtualdiskthatyouwanttomodify.
Examplessscsmodify-aarray00-dt0d01,t0d02vdiskvdisk01modifyvolumeModifiesanyofavolume'sattributes.
Synopsismodify-a[-p][-e][-N][-c][-m][-W][-M][-b][-k][-r][-Z>][-C][-L][-l][-f][-w][-P][-V][-D]volumeDescriptionModifiesavolume'sattributeswithoneormoreofthefollowingarguments.
Youcanchangethesegmentsizeofavolumebyafactoroftwoonly.
Forexample,avolumewithsegmentsizeof32Kcanonlybechangedtoasegmentsizeof64Kor16K.
Tochangethesegmentsizeto256K,thevolumewouldfirstneedtobechangedto64K,then128K,then256K.
Anychangesmadetotheprofileofapoolmustmaintainthissegmentsizerestrictionforallaffectedvolumes.
Optionsa,--arraySpecifiesthearraywhosevolumeyouwanttomodify.
Forcross-platformcompatibility,youcansubstitute-X,--storage-deviceinplaceofthe-a,--arrayoption.
-b,--write-cache-without-batteriesenable|disableSpecifieswhetherwrite-cache-without-batteriesisenabled.
-C,--snapshot-countSpecifiesthenumberofintendedsnapshotsforthevolume.
172SunStorageTekCommonArrayManagerCLIGuideOctober2008-c,--controllerA|BSpecifiesthecontrollerassociatedwiththisarray.
-D,--descriptionSpecifiesadescriptionofthesnapshot.
-e,--extendExtendsthevolumesizebyaspecifiedamount.
-f,--favorvolume|snapshotFavorsthevolumeorsnapshot.
-k,--disk-scrubbingenable|disableSpecifieswhetherdiskscrubbingisenabled.
-L,--snapshot-levellow|verylittle|little|average|high|fullSpecifiesthelevelofsnapshotactivityaseitherlow,verylittle,little,average,high,orfull.
Thesnapshotlevelsequatetothefollowingpercentages:low-10%verylittle-25%little-40%average-50%high-75%full-100%-l,--snapshot-percentageSpecifieswhatpercentageofthevolumeistobeusedforsnapshotcreation.
-mlowest|low|medium|high|highestSpecifiesthepriorityofthismodification.
-M,--write-cache-with-mirroringenable|disableSpecifieswhetherwrite-cache-with-mirroringisenabled.
-N,--new-nameSpecifiesanewnameforthevolumethatisbeingmodified.
-P,--snapshot-poolSpecifiesthenameofthesnapshot.
Chapter4ConfigurationCommandsforArrayswithRAIDControllers173-p,--poolSpecifiesthepoolinwhichthevolumeresides.
CODEEXAMPLE4-1-r,--disk-scrubbing-with-redundancyenable|disableSpecifieswhetherdiskscrubbing-with-redundancyisenabled.
-V,--reserve-vdiskSpecifiesareservevirtualdisk.
volumeSpecifiesthevolumename.
-w,--warning-thresholdSpecifieswhentoinformyouthatthesnapshotreservevolumeisnearcapacity.
Ifawarning-thresholdisnotspecified,50%isthedefault.
-W,--write-cacheenable|disableSpecifieswhetherthewritecacheisenabled.
-Z,--snapshot-reserve-size-s[]-t[][-plowest|low|medium|high|highest][-renable|disable][-R][-S]volume-copymodify-a-s-t[-p][-r]volume-copymodify-a-s-t-Rvolume-copy174SunStorageTekCommonArrayManagerCLIGuideOctober2008modify-a-s-t-Svolume-copyDescriptionModifiesavolumecopy.
Options-a,--arraySpecifiesthearrayassociatedwiththisvolumecopy.
-s,--source-volumeSpecifiesthesourcevolumenameassociatedwiththisvolumecopy.
-t,--target-volumeSpecifiesthetargetvolumenameassociatedwiththisvolumecopy.
-p,--prioritylowest|low|medium|high|highestSpecifiestheprioritylevelforthisvolumecopy.
-r,--readonlyenable|disableSpecifieswhetherthisvolumecopyisreadonlyormodifiable.
-R,--recopySpecifiesthatyouwanttorecopythisvolumecopy.
-S,--stopSpecifiesthatyouwanttostopthisvolumecopywhileinprogress.
volume-copySpecifiesthenameofthevolumecopythatyouwanttomodify.
Examplessscsmodify-aarray00-svol1-tvol2-Svolume-copyofflinevdiskSetsavirtualdiskoffline.
Chapter4ConfigurationCommandsforArrayswithRAIDControllers175Synopsisoffline-avdisk[]DescriptionSetsavirtualdiskoffline.
Thiscancreatecomplications.
DonotinitiatethiscommandwithoutfirstconsultingSunCustomerServicepersonnel.
Options-a,--arraySpecifiesthearrayonwhichyouwanttosetthevirtualdiskoffline.
vdiskSpecifiesthenameofthevirtualdisk.
Examplessscsoffline-aArray01vdiskVirtualDisk33onlinevdiskSetsavirtualdiskonline.
Synopsisonline-avdisk[]DescriptionSetsavirtualdiskonline.
Thiscancreatecomplications.
DonotinitiatethiscommandwithoutfirstconsultingSunCustomerServicepersonnel.
Options-a,--arraySpecifiesthearrayonwhichyouwanttosetthevdiskonline.
vdiskSpecifiesthenameofthevirtualdisk.
176SunStorageTekCommonArrayManagerCLIGuideOctober2008Examplessscsonline-aArray01vdiskreconstructdiskInitiatesadiskreconstruction.
Synopsisreconstruct-a[-t]disk[]DescriptionReconstructsadisk.
Thiscancreatecomplications.
DonotinitiatethiscommandwithoutfirstconsultingSunCustomerServicepersonnel.
Options-a,--arraySpecifiesthearrayonwhichyouwanttoreconstructthedisk.
-t,--trayIdentifiesthetraywherethephysicaldiskresides.
diskSpecifiesthenameofthedisk.
Examplessscsreconstruct-aArray01-tTray2removehostgroupRemovesoneormorehostsfromahostgroup.
Chapter4ConfigurationCommandsforArrayswithRAIDControllers177Synopsisremove-a-hhostgroupDescriptionRemovesoneormorehostsfromahostgroup.
Options-a,--arraySpecifiesthearrayassociatedwiththishostgroup.
-h,--hostSpecifiesthehostorhoststhatyouwanttoremovefromthishostgroup.
hostgroupSpecifiesthehostgroupfromwhichyouwanttoremovehosts.
Examplessscsremove-aarray00-hhost01,host02hostgrouphg01removelicenseRemovesthereplicationsetfeaturelicensefromthespecifiedarray(notapplicableto2500Series).
Synopsisremove-alicenseDescriptionRemovesthespecifiedfeaturelicensefromthearray.
Options-a,--arraySpecifiesthearrayassociatedwiththislicense.
178SunStorageTekCommonArrayManagerCLIGuideOctober2008licenseSpecifiesthelicensethatyouwanttoremovefromthearray.
Thelicensenameisoneofthewell-knownlicensenames.
Usethecommandsscslistlicensetoseethesenames.
Examplessscsremove-acorp_westlicenseReplicationSetRemovesareplicationsetfeaturelicensefromthearraynamedcorp_west.
removenotificationRemovesalocalorremotenotificationprovider.
Synopsisremove[-e]notificationremove[-i][-o][-t]notificationremove-dnotificationDescriptionRemovesalocalorremotenotificationprovider.
Options-d,--idSpecifiesthenotificationIDbeingremoved.
-e,--emailSpecifiestheemailaddressfornotificationremoval.
-i,--ipSpecifiestheIPaddressfornotificationremoval.
-o,--portChapter4ConfigurationCommandsforArrayswithRAIDControllers179Specifiestheportfornotificationremoval.
-t,--trapnumberSpecifiesthetrapnumberassociatedwithnotificationremoval.
notificationlocal_email|email-filter|trapSpecifiesthatallnotificationsofthespecifiedtypeareremovedfromthegivenaddresses.
local-emailSpecifiesyourlocalemailaddressatwhichyouwanttoremovethenotification.
email-filterSpecifiesthatyouwanttheemailfilterused.
trapSpecifiestheSNMPtrapnotificationmethodtousetoremovethenotification.
Examplessscsremove-ejohn.
doe@address.
comnotificationlocal_emailsscsremove-t2notificationtrapresetarrayResetsthespecifiedarray.
Synopsisreset-a-larrayDescriptionResetsthespecifiedarray.
Caution:Resettingthearraydestroysalluserdata,includingvolumes,hosts,initiators,andsoforth.
Options-a,--array180SunStorageTekCommonArrayManagerCLIGuideOctober2008Specifiesthearrayyouwanttoreset.
-l,--levelSpecifieseitherarrayorvolumetoreset.
Ifvolumeoptionisused,onlyvolumeinformationiserased,whilearrayconfigurationisretained.
resetcontrollerResetsthespecifiedcontroller.
Synopsisreset-acontrollerA|Breset-acontrollerDescriptionResetsthespecifiedcontroller.
Options-a,--arraySpecifiesthearraywhosecontrolleryouwanttoreset.
controllerA|BSpecifiesthenameofthecontrollertoreset,AorB.
controllerSpecifiesthenameofthecontrollertoreset.
Examplessscsreset-aarray00controllerAresnapsnapshotResnapsoneormoreexistingsnapshots.
Chapter4ConfigurationCommandsforArrayswithRAIDControllers181Synopsisresnap-asnapshotDescriptionResnapsoneormoreexistingsnapshots.
Whenyouresnapagroupofsnapshots,anarrayjobiscreated.
Whenresnappingagroupofsnapshots,iftheresnapoperationfailsforonesnapshot,thentheentireresnapoperationiscancelled.
Options-a,--arraySpecifiesthearrayassociatedwiththissnapshot.
snapshotSpecifiesthenamesofthesnapshotsthatyouwanttoresnap.
Examplessscsresnap-aarray00snapshotsnapshot1,snapshot2Resnapssnapshot1andsnapshot2onarray00.
revivediskAttemptstobringadisktotheoptimalstate.
Synopsisrevive-a[-t]disk[]DescriptionAttemptstobringadisktotheoptimalstate.
Thiscancreatecomplications.
DonotinitiatethiscommandwithoutfirstconsultingSunCustomerServicepersonnel.
Options-a,--array182SunStorageTekCommonArrayManagerCLIGuideOctober2008Specifiesthearrayonwhichyouwanttorevivethedisk.
-t,--trayIdentifiesthetraywherethediskresides.
diskSpecifiesthenameofthedisk.
Examplessscsrevive-aArray01-tTray1diskDisk7revivevdiskRevivesavirtualdisk.
Synopsisrevive-avdisk[]DescriptionRevivesavirtualdisk.
Thiscancreatecomplications.
DonotinitiatethiscommandwithoutfirstconsultingSunCustomerServicepersonnel.
Options-a,--arraySpecifiesthearrayonwhichyouwanttorevivethevirtualdisk.
vdiskSpecifiesthenameofthevirtualdisk.
Examplessscsrevive-aArray01vdiskVirtualDisk33Chapter4ConfigurationCommandsforArrayswithRAIDControllers183servicefailPlacesafield-replaceableunitofanarrayintoafailedstate.
Synopsisservice-a-tfailDescriptionPlacesthespecifiedfield-replaceableunitofthearrayintoafailedstate.
Thiscancreatecomplications.
DonotinitiatethiscommandwithoutfirstconsultingSunCustomerServicepersonnel.
Options-a,--arraySpecifiesthearraytobeplacedintoafailedstate.
-t,--targetSpecifiesthenameofthefield-replaceableunittobeplacedintoafailedstate.
ThisparameterneedstobesettoeithertheFRUnameortheFRUID.
ForalistofFRUnames,usethesscsfrulistcommand.
ForalistofFRUIDs,usethesscslistcommand.
Examplesservice-amyarray-tt0drive12failservicelocateTurnsonthedrive,tray,orarraylocatorLED.
Synopsisservice-a[-t][-o]locate184SunStorageTekCommonArrayManagerCLIGuideOctober2008DescriptionIdentifiesthearraywhoselocatorLEDwillbeturnedon.
Options-a,--arraySpecifiesthearraytobeplacedintoafailedstate.
-t,--targetSpecifiesthenameofthefield-replaceableunitwhoselocatorLEDwillbeturnedon.
ThisparameterneedstobesettoeithertheFRUnameortheFRUID.
ForalistofFRUnames,usethesscsfrulistcommand.
ForalistofFRUIDs,usethesscslistcommand.
-o,--offSpecifiestoturnoffthelocateLED.
Examplesservice-a-tlocateserviceredistributeRedistributesvolumesbacktotheirpreferredowners.
Synopsisservice-aredistributeDescriptionRedistributesvolumesbacktotheirpreferredowners.
Options-a,--arraySpecifiesthearraytobetoberedistributed.
Chapter4ConfigurationCommandsforArrayswithRAIDControllers185Examplesservice-aMyarrayredistributeservicereviveAttemptstoplacethearraycontrollerordiskdriveintotheoptimalstate.
Thiscancreatecomplications.
DonotinitiatethiscommandwithoutfirstconsultingSunCustomerServicepersonnel.
Synopsisservice-a-t[-w]reviveDescriptionAttemptstoplacethecontrollerordiskdriveofthespecifiedarrayintotheoptimalstate.
Options-a,--arraySpecifiesthearraytobeplacedintoaoptimalstate.
-t,--targetSpecifiesthenameofthefield-replaceableunittobeplacedintoafailedstate.
ThisparameterneedstobesettoeithertheFRUnameortheFRUID.
ForalistofFRUnames,usethesscsfrulistcommand.
ForalistofFRUIDs,usethesscslistcommand.
-w,--nowarnSkipsthewarningprompt.
Examplessscsservice-amyarray-tt0drive12-nrevive186SunStorageTekCommonArrayManagerCLIGuideOctober2008snapshootvolumeCreatesandmanagessnapshots.
Note:Thiscommandprovidescross-compatibilitywithscriptsthatarewrittenfortheSunStorageTek6920System.
ThepreferredsnapshotcommandsareCreateSnapshotandModifySnapshot.
Synopsissnapshoot-a-v[-C][-L][-l][-Z>][-f][-w][-P][-V]volumeCreatesasnapshotforavolume.
snapshoot-a-RvolumeResnapsavolume.
snapshoot-a-rvolumeRemovesasnapshotpool.
Options-a,--arraySpecifiesthearraytobeplacedintoafailedstate.
-v,--volumeSpecifiesthevolumeforwhichtotakeasnapshot.
-C,--snapshot-countSpecifiesthenumberofintendedsnapshotsforthevolume.
-l,--snapshot-percentageSpecifieswhatpercentageofthevolumeistobeusedforsnapshotcreation.
-L,--snapshot-levellow|verylittle|little|average|high|fullSpecifiesthelevelofsnapshotactivityaseitherlow,verylittle,little,average,high,orfull.
Thesnapshotlevelsequatetothefollowingpercentages:low-10%Chapter4ConfigurationCommandsforArrayswithRAIDControllers187verylittle-25%little-40%average-50%high-75%full-100%-Z,--snapshot_reserve_sizeTB|GB|MB|KB|Bytes|BLK|BV-f,--favorvolume|snapshotFavorsthevolumeorsnapshot.
-w,--warning_thresholdSpecifiesthethreshold,asapercentage,atwhichthemanagementsoftwarewillgeneratemessagestoindicatethelevelofspaceleftinthereservevolume.
Bydefault,thesoftwaregeneratesawarningnotificationwhendatainthereservevolumereaches50percentoftheavailablecapacity.
Possiblevaluesforthewarningthresholdare1to100percent.
-P,--snapshot_poolSpecifiesthenametogivetothereservevolume.
-V,--reserve_nameSpecifiesthenametogivetothereservevirtualdisk.
-R,--resnapResnapsavolume.
-r,--remove_poolRemovesasnapshotfromastoragepool.
volume|Specifiesthevolumeorvolumesforthesnapshotargument.
Oncethesnapshotvolumeiscreated,youcantreatitthesameasanyothervolume,exceptthatitcannotbeusedtocreateanothersnapshot.
ExamplesTocreateasnapshotnamedvolumevol01fromthesourcevolumevol0,type:sscssnapshoot-vvol0volumevol01ToresnapthesnapshotvolumeMySnapshotinthestoragedeviceMyDevice,type:188SunStorageTekCommonArrayManagerCLIGuideOctober2008sscssnapshoot-SMyDevice-RvolumeMySnapshotunmaphostUnmapsoneormoresnapshotsorvolumesfromahost.
Synopsisunmap-a[-s]hostDescriptionUnmapsoneormoresnapshotsorvolumesfromahost.
Options-a,--arraySpecifiesthearrayonwhichthisvolumeresides.
Forcross-platformcompatibility,youcansubstitute-X,--storage-deviceinplaceofthe-a,--arrayoption.
-s,--snapshotSpecifiesthesnapshotorsnapshotstounmapfromthehost.
-v,--volumeSpecifiesthevolumeorvolumestounmapfromthehost.
hostSpecifiesthehostthatyouwanttounmapfromthesnapshotorvolume.
Examplessscsunmap-aarray00-vvol01,vol02hosthost01unmaphostgroupUnmapsoneormoresnapshotsorvolumesfromahostgroup.
Chapter4ConfigurationCommandsforArrayswithRAIDControllers189Synopsisunmap-a[-shostgroupDescriptionUnmapsoneormoresnapshotsorvolumesfromahostgroup.
Options-a,--arraySpecifiesthearraycontainingthevolumethatyouwanttounmapfromthehostgroup.
-s,--snapshotSpecifiesthesnapshotorsnapshotstounmapfromthehostgroup.
-v,--volumeSpecifiesthevolumeorvolumesthatyouwanttounmapfromthehostgroup.
hostgroupSpecifiesthehostgroupthatyouwanttounmapfromthesnapshotorvolume.
Examplessscsunmap-aarray00-vvol01,vol02hostgrouphg01unmapinitiatorRemovesthemappingfromoneormoreinitiatorstoavolumeorsnapshot.
Synopsisunmap-a[-s]initiatorDescriptionRemovesthemappingfromaninitiatortoasnapshotorvolume.
190SunStorageTekCommonArrayManagerCLIGuideOctober2008Options-a,--arraySpecifiesthearrayassociatedwiththevolumeorsnapshottobeunmapped.
Forcross-platformcompatibility,youcansubstitute-X,--storage-deviceinplaceofthe-a,--arrayoption.
-s,--snapshotSpecifiesthesnapshotvolumestobeunmappedfromthisinitiator.
-v,--volumeSpecifiesthevolumestobeunmappedfromthisinitiator.
initiatorSpecifiestheinitiatornametobeunmapped.
Examplessscsunmap-aarray00-vvol01initiatorinit1unmapsnapshotRemovesthemappingfromoneormoresnapshotstoahostorhostgroup.
Synopsisunmap-a[-i][-h][-g]snapshotDescriptionRemovesthemappingfromoneormoresnapshotstoahostorhostgroup.
Options-a,--arraySpecifiesthearray.
-i,--initiatorSpecifiestheinitiatorthatyouwanttounmapfromthesnapshot.
Chapter4ConfigurationCommandsforArrayswithRAIDControllers191-h,--hostSpecifiesthehostthatyouwanttounmapfromthesnapshot.
-g,--hostgroupSpecifiesthehostgroupthatyouwanttounmapfromthesnapshot.
snapshotSpecifiesthesnapshotorsnapshotstobeunmapped.
unmapvolumeUnmapsoneormorevolumesfromahostorhostgroup.
Synopsisunmap-a[-h|-g]volumeunmap-a[-i][-h][-g]volumeDescriptionUnmapsoneormorevolumesfromahostorhostgroup.
Options-a,--arraySpecifiesthearraycontainingthevolumethatyouwanttounmapfromthehostorhostgroup.
Forcross-platformcompatibility,youcansubstitute-X,--storage-deviceinplaceofthe-a,--arrayoption.
-i,--initiatorSpecifiestheinitiatorthatyouwanttounmapfromthevolume.
-h,--hostSpecifiesthehostthatyouwanttounmapfromthevolume.
-g,--hostgroupSpecifiesthehostgroupthatyouwanttounmapfromthevolume.
192SunStorageTekCommonArrayManagerCLIGuideOctober2008volumeSpecifiesthevolumeorvolumestounmapfromthehost.
Examplessscsunmap-aarray00-ghg01volumevol01,vol02unregisterstorage-systemUnregistersanarray.
Synopsisunregisterstorage-systemDescriptionUnregistersanarrayfromthelistofregisteredstorage-systems.
Optionsstorage-systemSpecifiesthestoragesystemorstoragesystemsthatyouwanttounregisterfromthelistofregisteredstorage-systems.
Examplessscsunregisterstorage-systemarray19unregistersun-connectionUnregistersCAMsoftwareandallmonitoredarraysfromAutoServiceRequest(ASR).
Synopsisunregistersun-connectionChapter4ConfigurationCommandsforArrayswithRAIDControllers193DescriptionUnregistersCAMsoftwareandallmonitoredarraysfromAutoServiceRequest(ASR)whichmonitorsthearraysystemhealthandperformanceandautomaticallynotifiestheSunTechnicalSupportCenterwhencriticaleventsoccur.
Newlydiscoveredarrayswillnotberegisteredwiththesavedregistrationoptions.
Examplessscsunregistersun-connectversionShowstheversionsofsoftwarethatyouarerunningonthisarrayandtheclient.
Synopsis-V,--versionDescriptionShowstheversionsofsoftwarethatyouarerunningonthisarrayandtheclient.
Examplessscs-VSunStorageTek[TM]ConfigurationServicev5.
1.
0.
9sscsclientv2.
1.
4EXITSTATUS0Successfulcompletion15Objectnotfounderror25Commandparsingfailure30Commandvalidationerror50Applicationerror75Systemerror100Nonspecificerror194SunStorageTekCommonArrayManagerCLIGuideOctober2008195IndexBbookorganization,xirelateddocumentation,xisubmittingcommentstoSun,xiiCcommand-lineinterfacelogginginandout,49commentssubmittingtoSun,xiiDdirectories,CLI,1documentationaccessingfromSun,xiirelated,xiFFRU-replacementprocedures,xiLlogginginandoutusingtheCLI,49MmanagementsoftwarelogginginandoutusingtheCLI,49Oorganizationofbook,xiOverview,1Rrelateddocumentation,xiSServiceAdvisor,xisoftwarelogginginandoutusingtheCLI,49sscsmanpagecommands,xi,xii196SunStorageTekCommonArrayManagerCLIGuideOctober2008