configuration tool and utilities v3.21 operation manual · cli summary cli command explanations...
TRANSCRIPT
Configuration Tool and Utilities v3.21Operation Manual for Fusion RAID Storage Systems
1.0 ATTO Configuration Tool Overview............................................................................................. 1
AbouttheConfigurationTool
ConfigurationToolLaunch
ATTOConfigurationToolNavigation
1.1 NVRAM Settings........................................................................................................................ 7 SASAddress
BootDriver
Heartbeat
DeviceWaitTime
DeviceWaitCount
SpinupDelay
1.2 RAID Settings........................................................................................................................... 9
PreliminaryConfigurationSteps
DVRAIDRAIDGroupSetup
CustomRAIDGroupSetup
MacOSDriveFormatting
WindowsDriveFormatting
HotSparesUsage
RAIDGroupManagementOverview
RAIDGroupCapacityExpansion
RAIDLevelMigration
RAIDGroupDeletion
RAIDGroupRebuilding
1.3 Drive and RAID Group Monitoring............................................................................................ 17
BasicDriveInformation
DetailedDriveInformation
RAIDGroupInformation
IndividualDriveIdentification
S.M.A.R.T.DataMonitoring
S.M.A.R.T.MonitoringEnablingandDisabling
S.M.A.R.T.StatusChecking
S.M.A.R.T.AttributeFiltering
S.M.A.R.T.Notifications
Contents
Contents
1.4 Notifications......................................................................................................... 21
BasicAlerts
Logging
E-MailAlert
1.5 Diagnose and Replace a Faulted Drive................................................................................ 23
FaultedDriveIdentification
FaultedDriveReplacement
1.6 Configuration Tool Troubleshooting.......................................................................................... 25
MessagesfromNVRAMTabActions
AnerroroccurredloadingNVRAMdata.
Warning:NVRAMcouldnotberead,defaultsreturned.
AnerroroccurredupdatingtheNVRAM.
Featureboundschecking
MessagesfromFlashTabActions
Thisisnotaflashfile,oritiscorrupt.
ThisHBAisnotcompatiblewiththeselectedflashfile.
Avalidfilewasnotselected.
Anerroroccurredreadingfromtheflashfile,thefilemaybecorrupt.
Anerroroccurredupdatingtheflash.
Thecardhasbeenpreparedforfirmwareupdating…
2.0 Windows Only - ATTO Disk Benchmark..................................................................................... 27
BenchmarkFields
RadioButtonGroup
MultipleBenchmarkTesting
2.1 ATTO Disk Benchmark Troubleshooting..................................................................................... 29
Appendix A - CLI ASCII-Based Interface........................................................................................... i
CLIErrorMessages
CLISummary
CLICommandExplanations
Appendix B - Quick Format Instructions........................................................................................ xii
MacOSUsers’Instructions
WindowsUsers’Instructions
1
About the Configuration ToolThe ATTO Configuration Tool is a utility program that displays information about installed controllers, drivers and drives, and provides a mechanism to configure installed controllers.
This program executes under:
•MacOSX10.4orlater•WindowsVista/XP/Server2003/2000•Linux2.6kernel,x86andx64
Note:Java version 1.5 or later must be installed.
The ATTO Configuration Tool displays:
•ThenameoftheSonnetRAIDcontroller(listed as an ExpressSAS Rxxx adapter)
•InformationaboutthedriverscontrollingtheSonnetRAIDcontroller,includingversioninformationforboththecurrentlyexecutingdriverandtheflashimage
•InformationaboutdrivesattachedtotheSonnetRAIDcontroller
You may use the Configuration Tool to:
•ManageRAIDgroups•ConfigureRAIDEventnotifications•ModifytheRAIDcontroller’sNVRAMsettings•Reverttodefaultfactorysettings•UpdatetheRAIDcontroller’sflashimage•Updatefirmwareonhugediskarrays
ThefactorysettingsonyourSonnetRAIDcontrollershouldprovideexcellentperformanceforawiderangeofapplications.However,someapplicationsmaybenefitfrommodificationofthecontroller’sNVRAMsettingsthattunethecontrollerforaspecificperformancerange.
Configuration Tool Launch 1. Locatetheapplicationiconinthefoldercreatedduring
installation.
2.Double-clicktheATTOConfigurationicontostarttheapplication.
Note:The Sonnet RAID controller is designed to operate properly using factory settings. Entering invalid or incorrect NVRAM settings may cause your Sonnet RAID controller to function incorrectly.
Themainscreenhasthreepanes:DeviceListing,ConfigurationOptionsandStatus.SeeFigure 1onpage3.
ATTO Configuration Tool NavigationTheDeviceListingpaneattheleftofthewindowlistsalldevices(controllersanddrives)currentlyconnectedtothesystem.
Expandthedevice treetorevealadditionaldetailonconnecteddevices.
TheConfigurationOptionspaneprovidesinformationandoptionsforadevicehighlightedinthedevicelisting.
IfyouhighlightadeviceintheDevice Listing pane,tabsandpanesaredisplayedforthatdevice.
Thefollowingchartspecifiesthetabsthataredisplayedfortheindicateddevicetype.
Tree Node Tab(s) Displayed
Controller BasicInfo,Flash,RAID,RAIDCLI,Advanced
Channel NVRAM,PCIInfo
RAIDGroups BasicInfo,Flash
LocalHost BasicInfo,Notifications
ThefollowingtabsaredisplayedintheConfigurationOptionspanewhenyouselectaspecificcontrollerintheDeviceListingpane.
•TheBasic InfotabprovidesinformationabouttheSonnetRAIDcontrollerwhenitishighlightedintheDeviceListingpane,orthecomputeriflocalhostishighlighted.Youcannotmakechangesfromthesescreens.SeeFigure 2onpage3andFigure 3onpage4.
•TheFlashtabprovidesinformationaboutthecurrentflashversionprogrammedonthehighlightedcontroller.SeeFigure 4onpage4.ClicktheBrowsebuttonatthebottomofthetabtosearchfornewflashfilesonyoursystemsuchasFlashBundle_2007_02_27.R380.Onceyou’veselectedtheflashfile,clicktheUpdatebuttontoautomaticallyupdateyourSonnetRAIDcontroller.
•TheRAIDtabprovidesinformationaboutattacheddrives,theirRAIDgroupandhotspareassociations,andtheiroperatingstatus.SeeFigure 5onpage5.
•TheRAIDCLItabprovidesaccesstothecommandlineinterface,which,asanalternativetoapplicationmenu-basedcommands,enablestheuseofASCII-basedcommandstocontrolconfigurationanddiagnostictasks.SeeFigure 6onpage5.
1.0 ATTO Configuration Tool Overview
WARNING: Back up system data when installing or changing hardware configurations.
Support Note: In the Device Listing pane of the ATTO Configuration Tool window, the Sonnet RAID controller is
identified as an ExpressSAS Rxxx.
2
1.0 ATTO Configuration Tool Overview
ATTO Configuration Tool Navigation (continued) •TheAdvancedtabdoesnotfunctionwiththeSonnetRAID
controller;clickingthistabmerelydisplaysamessage.
•WhenyouselectaspecificchannelundertheSonnetRAIDcontrollerintheDeviceListingpane,theNVRAMtabdisplaystheNVRAMparametersapplicabletotheSonnetRAIDcontrollerandchannelselected.RefertoNVRAMSettingsonpage7,andConfigurationToolTroubleshootingonpage25forinformationaboutNVRAMsettings.
•TheSonnetRAIDcontroller’sinformationisdisplayedinthePCI Infotab.SeeFigure 7onpage6.
•ThecurrentstatusoftheConfiguration ToolisrepresentedintheStatuspaneatthebottomofthewindow.
Aboutwindow TheAboutwindow,displayedwhenAboutisselectedfromtheHelpmenu,liststheATTOConfigurationTool’sversionnumber.SeeFigure 8onpage6.
3
Figure 1
Figure 2
1.0 ATTO Configuration Tool Overview
Opening Screen
Basic Info tab when Local Host chosen in the Device Listing pane
4
Figure 3
Figure 4
1.0 ATTO Configuration Tool Overview
Basic Info tab when the Sonnet RAID controller is chosen in the Device Listing pane
Flash tab when the Sonnet RAID controller is chosen in the Device Listing pane
5
Figure 6
1.0 ATTO Configuration Tool Overview
RAID CLI tab when the Sonnet RAID controller is chosen in the Device Listing pane
Figure 5
RAID tab when the Sonnet RAID controller is chosen in the Device Listing pane
6
Figure 7
PCI Info tab
1.0 ATTO Configuration Tool Overview
Figure 8
About Configuration Tool window
7
1.1 NVRAM Settings
The settings in the NVRAM tab vary depending upon the operating system.
TheSonnetRAIDcontrollerisdesignedtooperateproperlyusingfactorysettings.EnteringinvalidorincorrectsettingswhenusinganNVRAMconfigurationutilitysuchastheATTOConfigurationToolmaycauseyourcontrollertofunctionincorrectly.SeeFigure 9onpage8.
UsecautionwhenmakingchangestoNVRAMsettingsandonlymakechangestothosewithwhichyouarefamiliar.Onceyouhavemadethedesiredchanges,clickCommittosavethechanges.ClickSavetonameandsaveanNVRAMconfiguration.ClickLoadtoloadasavedNVRAMconfiguration.Changes do not take effect until you reboot the system.
Ifyoudonotwanttomakeanychanges,youmaychooseoneofthefollowing
•Defaults:restoresthecontrollertofactorydefaultsettings.TheCommitbuttonmustbeclickedtosaveanychanges.
•Restore:revertstotheNVRAMsettingssavedthelasttimetheCommitbuttonwasused.ClickingCommitisnotnecessary.
SAS AddressReadonly
DisplaystheSASaddressassignedtothecontroller.Thevaluecannotbemodified.
Boot Driver (Windows only)Choices:enabled,scanonly,disabledDefault:disabled
Ifenabledanddiskdrivesaredetectedduringthebusscan,theBIOSdriverremainsresident.Ifdisabled,theBIOSstarts,resetsthecontrollerchipandunloadsthedriver.
IfScan Onlyisselected,theBIOSdriverscansthebusanddisplaysthedevicesattached,thenunloadsitselfafterabriefdelay.
Heartbeat Choices:enabled,disabledDefault:enabled
Whenenabled,theSonnetRAIDcontroller‘sfirmwareisrequiredtorespondtoperiodicactivity.Ifthefirmwaredoesnotrespond,thesystemdriverresetsthefirmwareonthecontroller.
WARNING: Back up system data when installing or changing hardware configurations.
Device WaitTimeChoices:1–255secondsDefault:3
Specifiesthenumberofsecondsthatthedriverwaitsfordevicestoappear.
Device Wait CountChoices:1–255devicesDefault:1
SpecifiesthenumberofdevicesthatmustappearinordertocanceltheDeviceWaitTimeperiod.
Spinup Delay Choices:0-20secondsDefault:0
SpecifiesthenumberofsecondseachSASportwaitsfordiskdrivestospinup.
Support Note: The SAS address is a globally-unique identifier assigned to devices such as the Sonnet RAID
controller, and is similar to an Ethernet adapter’s MAC address.
�
Figure 9
1.1 NVRAM Settings
NVRAM settings tab
9
1.2 RAID Settings
The ATTO Configuration Tool provides the capability to configure disk storage into RAID groups or Hot Spare drives.
Note: Even an individual JBOD disk is considered to be a RAID group.
UsetheATTOConfigurationTooltosetupRAIDgroupsonyourSonnetRAIDcontrollerinoneofthefollowingRAIDlevels:
•JBOD•RAIDLevel0•RAIDLevel1•RAIDLevel4•RAIDLevel5•RAIDLevel6•RAIDLevel10•DVRAID
DVRAIDRAIDgroupsmaybesetupautomaticallybytheATTOConfigurationTool.AllotherRAIDconfigurationsrequirecustomizedinput.
EachRAIDgroupmaybedividedintooneormorepartitions;eachpartitionappearstothehostoperatingsystemasavirtualdisk.
YoumayusethecommandlineinterfacepanefromtheRAID CLItabintheATTOConfigurationTooltosetupormodifyvariousparameters(RefertoAppendixA).However, the menu-based procedures listed in this chapter are the preferred procedures for setting up RAID configurations for the Sonnet RAID controller.
Preliminary Configuration Steps 1.LaunchtheATTOConfigurationToolapplication.
2.TheConfigurationToolmainscreenappears.SeeFigure 10onpage12foranoverviewofthescreen.IntheDevice Listingpaneontheleftsideofthewindow,clickExpressSASRxxxunder localhost.
3.ClicktheRAIDtab;attacheddrivesaredisplayedinthetoppane,whileRAIDgroupsandHotSparesaredisplayedinthebottompane.
DVRAID RAID Group SetupTheDVRAIDwizardautomaticallysetsupaDVRAIDRAIDgroupusingallavailabledrivesattachedtotheSonnetRAIDcontroller.IfyoudonotwantallavailabledrivessetupinaDVRAIDRAIDgroup,eitherremovethedrivesfromthedriveenclosure,orselectCustomRAIDsetup.
1.AftercompletingPreliminaryConfigurationStepsonthispage,selectRAIDManagement>CreateGroup>DVRAIDSetupfromtheapplicationmenu.
2.Adialogwindowwillpopup,askingwhetheryouwanttoperformanExpressSetupOperationofDVRAID;clickYes.TheATTOConfigurationToolautomaticallyusesallunassigneddrivestocreateaDVRAIDRAIDgroup.WhiletheRAIDgroupisbeingcreated,amessageboxdisplaysandthepanesdisplaytheRAIDgroups.
3. The RAID group must still be formatted by your computer’s operating system software before it becomes available for use.ForMacusers,useDiskUtility;forWindowsusers,useDiskManagement.Formoreinformationondriveformatting,seeMacOSDriveFormattingorWindowsDriveFormattingonpage11.
4.Afterformatting,RAIDgroupsmaybeusedduringthesetupoperation,butperformanceislimiteduntilsetupiscomplete.
Support Note: In the Device Listing pane of the ATTO Configuration Tool window, the Sonnet RAID controller is
identified as an ExpressSAS Rxxx.
WARNING: After selecting the DVRAID, RAID 4, RAID 5, or RAID 6 option, configuration of a set of eight 1TB
drives can take up to 4 hours (or up to 2 hours with 500GB drives).
Windows Support Note: In order to create RAID volumes larger than 2TB under Windows, you must do one
of the following: Select the 4KB sector size when creating a custom RAID group (not DVRAID). -OR- Use the software configuration tools included with the Fusion storage to create volumes up to 2TB, concatenate (link together in a virtual chain) the volumes, and then format as NTFS. -OR- Use GPT formatting. Note that drives and volumes with GPT formatting are not visible to any version of Windows XP Professional, nor to the 32-bit version of Windows Server 2003 SP1.
Support Note: DVRAID is a customized, protected RAID 4 configuration. It is optimized for increased digital
video playback performance when compared to that obtained from a RAID 5 configuration. DVRAID’s write performance is decreased in order to accomplish this optimization.
Support Note: In Fusion RAID systems shipped from Sonnet with hard drives installed, the drives are formatted
Mac OS Extended (Journaled), and configured as a single RAID 5 RAID group. If you need to change the configuration, use the ATTO Configuration Tool and the operating system software tools to reformat and reconfigure the drives. See page xii for Quick Format instructions for Mac OS and Windows users.
10
1.2 RAID Settings
Custom RAID Group Setup 1.AftercompletingPreliminaryConfigurationStepsonpage9,
selectRAIDManagement>CreateGroup>Customizedfromtheapplicationmenu.
2.SelectthefirstsetofoptionstoconfigurethenewRAIDgroup.SeeFigure 11onpage12.
•Name:nametheRAIDgrouporusetheoneassignedbytheConfigurationTool.Thenamemustbeuniqueandnomorethan14characters.
•Level:selectaRAIDgrouplevelfromthedrop-downbox.
•Interleave:selectaninterleavevalue.Thedefaultvalueis64KB.
•Mirror Count:selectthenumberofmirrorgroupswhenRAID1orRAID10RAIDgroupsarecreated.
•Initialize:selectAdvancedorExpress.
3.ClickNext.Selectthedrivesinthetoppaneanddragthemintothedeviceareainthebottompane.SeeFigure 12onpage13.
4.ClickNext.SelectthenextsetofoptionstoconfigurethenewRAIDgroup.SeeFigure 13onpage13.
•Sector Size:selectasectorsizefromthedropdownbox.Thedefaultis512bytes.
•Speed Read:selectAlways,Adaptive,orNever.ThedefaultisAdaptive.
•Rebuild Priority:selectHigh,Same,orLow.ThedefaultisLow.
•Auto Rebuild:onoroff.
5.IfyouwanttheRAIDgrouptobepresentedasonevirtualdisk(partition),clickFinish.Ifyouwantmorethanonevirtualdisk(partition),clickNext (seeFigure 14onpage14),andthenselectoneofthefollowingoptions:
•leaveasonepartition•partitionbycount•partitionbysizeIfyouchoosetosplittheRAIDgroupbycountorcapacity,youmustenteradditionalinformation.
6.Ifyouhavenotalreadydoneso,clickFinish.
7.Aconfirmationdialogboxasksyoutoapprovetheconfigurationyouhavechosen.ClickYes.SeeFigure 15onpage14.
8. Every RAID group must be formatted by your computer’s operating system software before it becomes available for use;MacuserswilluseDiskUtility,whileWindowsuserswilluseDiskManagement.Formoreinformationondriveformatting,seeMacOSDriveFormattingorWindowsDriveFormattingonpage11.
Support Note: The interleave value of 128KB offers the best performance for most SATA drives.
Support Note: When the Advanced Initialize option is selected, parity blocks are calculated and the RAID group
is thoroughly scanned and subjected to a complete Write/Verify operation to map out any bad blocks on the drives before the RAID group is made available for use. When the Express Initialize option is chosen, drives are not scanned and subjected to the Write/Verify operation, but parity blocks are calculated and the RAID group may be used during the initialization.
Windows Support Note: Choosing the 4K sector size enables the creation and use of RAID volumes larger than
2TB on systems running Windows XP 32-bit.
Support Note: For the Speed Read option, select Always if you expect to work with large sequential files (video, for
example), Never if you expect most of the files are smaller in size (general storage, database, etc.), or Adaptive if you expect mixed use or don't know.
Support Note: Descriptions of basic RAID levels can be found on the Wikipedia.org Web site at the following
address: http://en.wikipedia.org/wiki/RAID#Standard_levels
11
Mac OS Drive Formatting 1.Dependingonhowyouconfigureyoursetup,aDisk Insertion
windowstatingthatthereisanunreadablevolumewillappearatsomepointduringtheRAIDgroupcreationprocess;clickInitialize,andthenDiskUtilitywillopen.
2.IntheDisk Utilitywindow,eachRAIDgroupyoucreatedusingtheATTOConfigurationToolwillappearasasinglevolume.Selectthevolume,andthenclicktheErasetabatthetopofthewindow.
3.ClicktheErasebutton;awindowwillappearaskingyoutoapproveyourchoice;clickErase.
4.Repeatsteps2and3foreachremainingunformattedRAIDgroup,andthencloseDiskUtility.
5.DependingonhowyouconfiguredtheRAIDgroups,thevolumesmayalreadybemountedandpresentonthedesktop.IfyoucreatedaDVRAID,RAID4,RAID5,orRAID6RAIDgroup,configurationwilltakemuchlonger.Youmaycheckontheprocessbydouble-clickingthevolumenameinthelowerpaneoftheATTO Configuration Toolwindow.
Windows Drive Formatting 1.SelectComputerManagementFromtheWindowsStart
menu.IfComputerManagementisnotavailableintheStartMenu,selectStart>ControlPanel>AdministrativeTools.IntheAdministrative Toolswindow,double-clickComputerManagement.
2.IntheComputer Managementwindow,clickStorageontheleft,andthendouble-clickDiskManagement.
3.WhentheInitialize Diskwindowappears,clickOK.
4.IntheDisk Managementwindow,eachRAIDgroupyoucreatedwillappear(listedas“unallocated”)asasinglevolume.Right-clickwheretheword“unallocated”appears,andthenselectNewSimpleVolume.
5.WhentheWelcometotheNew Simple Volume Wizard windowappears,clicknexttostarttheprocess.
6.Followtheremainingstepstocompletetheprocess.
Note: If you do not select the quick format option, formatting will take much longer to complete.
7.Repeatsteps4–6foreachremaining“unallocated”disk.
1.2 RAID Settings
8.DependingonhowyouconfiguredtheRAIDgroups,thevolumesmayalreadybeavailabletothesystem.IfyoucreatedaDVRAID,RAID4,RAID5,orRAID6RAIDgroup,configurationwilltakemuchlonger.Youmaycheckontheprocessbydouble-clickingthevolumenameinthelowerpaneoftheATTO Configuration Toolwindow.
9.OncealltheRAIDgroupshavebeenformatted,theyarereadytouse.
12
Figure 10
Figure 11
1.2 RAID Settings
Configuration Tool main screen with the RAID tab selected
Select the options to create new, custom RAID groups
13
Figure 12
Figure 13
1.2 RAID Settings
RAID group drives selected
Select more options to create new, custom RAID groups
14
Figure 14
Figure 15
1.2 RAID Settings
Select the number of partitions for the new RAID group
Confirm the custom RAID group options
15
1.2 RAID Settings
Hot Spares UsageIfadriveinaRAIDgroupbecomesdegradedorfaulted,yourRAIDgroupwilllosesomeredundancyuntilanewmember(drive)isrebuiltintoit.YoucanautomatethisprocedurebydesignatingoneormoredrivesasHotSpares.YoumaysetupapoolofHotSparedrivesofdifferentsizesappropriateforyourRAIDgroups.
IftheSonnetRAIDcontrollerdetectsafaulteddriveinaRAIDgroupwithadesignatedHotSpare:
•ThecontrollersearchestheHotSparepoolforthesmallestdriveofsufficientcapacitytosubstituteforthefaulteddrive.
•ThefaulteddriveisreplacedwiththedrivefromtheHotSparepool.
•TheSonnetRAIDcontrollerbeginsanautomaticrebuildoftheRAIDgroups.
SelectRAIDManagement>NewHotSpare(orDeleteHotSpare)fromtheapplicationmenu,andthenfollowtheinstructionsonthescreen.
RAID Group Management OverviewTheATTOConfigurationToolinterfacemaybeusedtoreplaceafaileddrive,addcapacitytoaRAIDgroup,orchangeaRAIDgroup’scurrentRAIDlevelconfigurationtoanewone.
TheATTOConfigurationToolinterfaceguidesyoustepbystepthroughmanyprocedureswhichallowyoutomodifyyourstorageandRAIDconfigurations.Readallnotesandcautionscarefullyasyougotoensurethebestperformanceanduseofyourstorage.ManyoftheseproceduresareonlyavailablewithdrivesthatarenotcurrentlypartofaRAIDgroup,arenotdesignatedasaHotSpare,orwereofflinewhenyouinitiallysetupRAIDconfigurations.
RAID Group Capacity Expansion SelectRAIDManagement>ExpandCapacityfromtheapplicationmenu,andthenfollowtheinstructionsonthescreen.DependingontheRAIDconfiguration,youmayneedtoaddmorethanonedriveatatime.
RAID Level MigrationChangingaRAIDgroupfromoneRAIDleveltoanotheriscalledmigration.Thefollowingmigrationlevelsaresupported:
•JBODtoRAIDLevel0•JBODtoRAIDLevel1•RAIDLevel0toRAIDLevel10•RAIDLevel1toRAID10•N-waymirroring:addadditionalredundancytoRAIDLevel1
SelectRAIDManagement>MigrateRAIDLevelfromtheapplicationmenu,andthenfollowtheinstructionsonthescreen.
RAID Group DeletionYoumaydeleteagroupusingtheATTOConfigurationTool.SelectRAIDManagement>DeleteGroupfromtheapplicationmenu,andthenfollowtheinstructionsonthescreen.
RAID Group RebuildingIfaRAIDgroupbecomescompromised,youmustrebuildit.SelectRAIDManagement>RebuildGroupfromtheapplicationmenu,andthenfollowtheinstructionsonthescreen.
YoumaypausetheRAIDgrouprebuildprocessbyselectingtheRAIDgroupinthelowerpane,andthenselectingRAIDManagement>PauseRebuildfromtheapplicationmenu.Torestarttherebuild,selecttheRAIDgroupinthebottompane,andthenselectRAIDManagement>ResumeRebuildfromtheapplicationmenu.
Support Note: Hard drives in the Hot Spare pool should be of appropriate capacity to the RAID group so
that smaller drives are not replaced by much larger Hot Spare drives.
WARNING: Data can be compromised or lost when deleting storage or rearranging storage configurations.
Support Note: An unallocated drive or unallocated storage is storage which is not part of a RAID group, not
designated as a Hot Spare or was offline when you initially set up a RAID configuration using the ATTO Configuration Tool interface.
WARNING: Data can be compromised or lost when deleting storage or rearranging storage configurations.
Support Note: A RAID group rebuild may take up to eight hours to complete, depending on the operating
system, drive capacities, and RAID configuration.
WARNING: Adding drives to an existing RAID group may adversely impact performance. You cannot reverse this
operation unless you delete the RAID group.
16
17
1.3 Drive and RAID Group Monitoring
The ATTO Configuration Tool provides information on individual drives and RAID groups.
UsetheATTOConfigurationTooltogatherbasicordetailedinformationaboutthedrivesconnectedtotheSonnetRAIDcontroller,andoperationalstatusontheRAIDgroupscreatedwiththem.
Basic Drive Information OpentheATTOConfigurationToolandexpandthedevicetreeintheDeviceListingpaneuntilExpressSASRxxxappears,andthenclicktohighlightit.IntheAttachedDrivespane,informationforallthedrivesisdisplayed.SeeFigure 16onpage19.
•LED icon:Indicatesoperationalstatusofthedrives.Green=online,red=faulted
•Name:Displaysthedrive’smodelnumber
•Vendor:Notused
•Address:DisplaystheSASaddressgeneratedbytheSonnetRAIDcontroller
•Usage:Identifieshowthedriveisbeingused.IfitispartofaRAIDgroup,thegroupnameandmembernumberaredisplayed.IfitisaHotSpare,itislistedasaHotSpare.
•Capacity:Displaysthedrive’sformattedcapacity.
Detailed Drive Information IntheAttachedDrivespane,double-clickadrivenamefordetailedinformation.SeeFigure 17onpage19.
•Status:Displaysthedrive’soperatingstatus.OKisdisplayedifitisfunctioningnormally.Ifthereisaproblem,FaultedorErrorisdisplayed.
•Type:Displaysthetypeofmedia(disk,tape,etc.)
•Name:Displaysthedrive’smodelnumber
•Vendor:Notused;alwaysdisplaysNotAvailable
•Serial:Displaysthedrive’sserialnumber
•Address:DisplaystheSASaddressgeneratedbytheSonnetRAIDcontroller
•Speed:Displaysthedrive’sinterfacespeed(1.5or3Gb/s)
•Revision:Displaysthedrive’sfirmwarerevision
•LUN:Displaysthelogicalunitnumber,whichisthenumberassignedtodrive’sRAIDgroup
•Index:DisplaystheRAIDgroupindexnumber
•Capacity:Displaysthedrive’sformattedcapacity
•Usage:Identifieshowthedriveisbeingused.IfitispartofaRAIDgroup,thegroupnameandmembernumberaredisplayed.IfitisaHotSpare,itislistedasaHotSpare.
•Sector Size:Displaysthedrive’ssectorsize
RAID Group Information Inthebottompane,clicktheGroupstabtodisplayRAIDgroups.SeeFigure 16onpage19.
•Name:DisplaysthenameoftheRAIDgroup
•Level:IndicatestheRAIDlevelformattingfortheRAIDgroup
•Capacity:Indicatestheformatted,configuredcapacityoftheRAIDgroup
•Members:IdentifiesthenumberofdrivescomprisingtheRAIDgroup
•Status:DisplaystheoperatingstatusfortheRAIDgroup.ONLINEindicatesthattherearenofaulteddrivesandthegroupisfullyoperational;DEGRADEDindicatesthatonedriveinthegrouphasfailedanditshouldbereplacedassoonaspossible;OFFLINEindicatesmorethanonedriveinthegrouphasfailedorismissingandtheRAIDgroupisnon-operational;REBUILDindicatesthatadriveinthegroupisrebuilding,andthegroupisstilloperational,butrunningindegradedmode.
•Rebuild:SpecifiesthegeneralconditionoftheRAIDgroup.Noneindicatesnorebuildistakingplace,norisitnecessary;RebuildingindicatesthattheRAIDgroupisdegraded,andisintheprocessofrebuilding;Pausedindicatesthatarebuildwasinterruptedandneedstoberestartedtofinish.
Individual Drive IdentificationYoumayidentifyindividualdrivesintheFusiondriveenclosureusingtheATTOConfigurationTooltoturnonLEDsintheenclosure.
1.LaunchtheATTOConfigurationToolapplication.
2.ExpandthedevicetreetoshowtheExpressSASRxxx,andthenclicktheRAIDtab.DrivestatusforalldrivesconnectedtotheSonnetRAIDcontrollerwillbedisplayed.
3.ClickonthespecificdriveyouwanttoidentifyintheAttachedDriveslist.
1�
Individual Drive Identification (continued) 4.SelectRAIDManagement>Locate>Drivefromthe
applicationmenu.Ifthedrivedoesnotsupportthismethodofidentification,amessagewillappearinthebottompane;gotothenextstep.Otherwise,lookattheFusionenclosure;thedriveactivityLEDforthespecificdrivewillbelit.Afteroneminute,theLEDwillturnoff.
5.Double-clickadriveinthetoppanetodisplaydetailedinformation,andnotetheindexnumberforthedrive.Closethedetaileddriveinformationwindow.
6.ClicktheRAIDCLItab,andthentype“Blockdevidentifyx”,wherexistheindexnumber.LookattheFusionenclosure;thedriveactivityLEDforthespecificdrivewillbelit.
Note:Type “Blockdevidstop” to turn off the LED.
S.M.A.R.T. Data MonitoringSelf-Monitoring,AnalysisandReportingTechnology,orS.M.A.R.T.,isamonitoringsystemforSATAdrivestodetectandreportonvariousindicatorsofdrivehealth.TheS.M.A.R.T.(Self-Monitoring,AnalysisandReportingTechnology)monitoringfeaturemonitorsandreportsthestatusofSATAdrivehealthusingcertainparametersrecordedbythedrives.Notificationissentwhenthevaluesexceedcertainpre-determinedvalues.
UsetheATTOConfigurationTooltoviewthefilesthatrecordchangestoanindividualdrive’sS.M.A.R.T.parameters.Thefilesarepermanentandcanbeviewedindependentlywhetheryouhaveenabledmonitoringornot.
S.M.A.R.T. Monitoring Enabling and DisablingYoumayenableordisablethemonitoringfeatureatanytime.Monitoringisdisabledbydefault;ifyouwanttousethefeature,youmustenableit.
1.LaunchtheATTOConfigurationToolapplication.
2.ExpandthedevicetreetoshowtheExpressSASRxxx,andthenclicktheRAIDtab.
3.SelectRAIDManagement>MonitorS.M.A.R.T.fromtheapplicationmenutoenable(indicatedwithacheckmark)ordisablemonitoring.
S.M.A.R.T. Status CheckingTheATTOConfigurationToolinterfacedisplaysthelatestS.M.A.R.T.statusrecordforaselecteddrive.Allattributesreportedbythedrivearelistedwitheachattribute’sThreshold,Worst,CurrentandRawvalue;thethresholdvalueisthevalueatwhichnotificationofaproblemisgeneratedbythesoftware.
IftherehasbeenachangefromapreviousS.M.A.R.T.statusrecord,anarrowindicatesthechangedirection,eitherhigherorlower.SeeFigure 18onpage20.
1.3 Drive and RAID Group Monitoring
TheS.M.A.R.T.statusdisplayalsocontainsinformationsuchasthedateandtimetheS.M.A.R.T.statuswasrecorded,thetotalnumberofrecordsforthisdrive,andthecurrentmonitoringstatus(enabledordisabled).
Youmaymovetopreviousorsubsequentrecords,querythedriveorrefreshtheviewusingcontrolsontheinterface.Control-click(orright-click)asingledriveintheAttachedDrivespanel,andselectS.M.A.R.T.Statusfromthesub-menutoviewtherecord.
•UsetheleftarroworrightarrowcontroltomovebetweenS.M.A.R.T.statusrecords.
•UsetheRefreshbuttontoquerythedriveforthelatestvalues.Ifanyvaluesaredifferentfromthemostrecentrecord,anewrecordiscreatedanddisplayed.
S.M.A.R.T. Attribute FilteringEachoftheS.M.A.R.T.statusattributesisassignedoneormoreclassificationtypes:
•performance•errorrate•eventcount•critical
TheS.M.A.R.T.Statusdialogboxcanbefilteredtodisplayanycombinationofthesetypes.Thedefaultviewistodisplayalltypes.
1. OpentheS.M.A.R.T.Statusbox,andthencontrol-click(orright-click)inthetableareawheretheattributevaluesaredisplayed.
2. Eachclassificationtypethatisvisiblehasacheckmark.Selectanyclassificationtypetochangethecheckmark.
S.M.A.R.T. NotificationsWhenS.M.A.R.T.monitoringisenabled,statusiscollectedfromeachSATAdriveat60minuteintervals.Ifthedataisdifferentthanthepreviousstatus,aS.M.A.R.T.statusrecordisaddedtotheS.M.A.R.T.statusfileforthatdrive.AnotificationoftheS.M.A.R.T.statusdifferenceisgeneratedbaseduponthecurrentsettingsintheNotificationspanel.RefertoNotificationsonpage21.
ThenotificationlevelofS.M.A.R.T.statusisdeterminedasfollows:
•INFO:Noneofthestatusvalueswasbelowthethresholdvalue.
•WARNING:Oneormoreofthestatusvalueswasbelowathresholdvaluebutnonewasclassifiedascritical.
•CRITICAL:Oneormoreofthestatusvalueswasbelowathresholdvalueandonewasclassifiedcritical.
19
Figure 16
Figure 17
1.3 Drive and RAID Group Monitoring
Drive information displayed with RAID tab selected
Detailed drive information
20
Figure 18
1.3 Drive and RAID Group Monitoring
S.M.A.R.T. status displayed for a specific drive
21
1.4 Notifications
The ATTO Configuration Tool provides a way to issue notifications via audible or visual alerts when a RAID event occurs.
RAIDeventsaredividedintothreecategories:
• Critical events areonesinwhichaseriousproblemhasoccurredandtheadministratoroftheRAIDgroupshouldperformcorrectiveaction.
• Warning eventsarelessseriousbutstillwarrantrecordingandnotificationatsomelevel.
• Information alertsprovidesupportiveinformationaboutwarningsorcriticalevents.
Drop-downboxesontheNotificationspaneallowyoutochoosethetypeofeventwhichpromptsanalert.SeeFigure 19onpage22.
• Critical:onlyCriticaleventsarereported
• Warning:allWarningsandCriticaleventsarereported
• All:allCritical,WarningandInformationeventsarereported
• None:noeventisreported.TheNonelevelisusefulinE-mailnotificationbecauseyoucansetupE-mailaddressestowhichalertsmightbesentatsomefuturetime.
YoumaychooseanycombinationofnotificationsontheNotificationpaneasneeded.ThenotificationsarespecifiedatthehostsystemlevelandapplytoallSonnetRAIDcontrollersinstalledinthehostsystem.
Basic Alerts Youcanselectanaudiblealert,avisualalert,orbothforaparticularcategoryofevents.Selectanotificationlevelusingthedrop-downboxnexttotheAudibleandVisuallabelsontheNotificationsscreen.
Audible alertusesthecomputer’sspeakertosoundanalarmfor5seconds.
Visual alertusesasystemmodalpop-uptodisplayamessage.Youmustclosethepop-upusingthepop-up’sbutton.
Logging Loggingnotificationrecordsthetypeofeventastextinalogfileyouspecify.Selectthelocation,nameandsizeofthefile.
•Anintegervalueisaddedtothelogname.Whenthelogfilereachesitssizelimitation,anewfileisgeneratedwithasequentialintegervalueaddedtothelogname.Whenthesecondlogfilereachesitssizelimitation,loggingoverwritesthefirstlogfile.Thetwologfilesareautomaticallyrotated.
E-Mail AlertE-mailnotificationsendsamessagetothedesignatedE-mailaddresseswhentheeventlevelfromthedropdownboxisreached.
•YoumayspecifyseveralnotificationaddressesoneachlineintheE-mailsectionoftheNotificationspane,eachseparatedbycommas,foranyeventlevel.
•YoumustcompletetheIPaddressornameoftheserverandsender.
•Youmayspecifyausernameandpasswordforthemailserverifoneisrequired.
•AcriticaleventE-mailnotificationissentaftera10-seconddelaytoallowseveralrelatedeventstobereportedinthesamemessage.AllothernotificationE-mailsaresentat15-minuteintervals.
Support Note: The visual alert option is not available on systems running Linux, nor on systems running Mac OS X
and using version 3.1.0 software.
22
Figure 19
1.4 Notifications
Configuration Tool Notifications screen
23
A drive error may occur that will cause a RAID group to become degraded. This section will help you to identify and replace the bad drive.
Whenanerroroccursthatrequiresadrivetobereplaced,theATTOConfigurationToolwillissuevisual,audible,andE-mailnotifications(onlywhenconfiguredtodoso).
Faulted Drive IdentificationAfteradrivefailurenotificationhasappeared,
1.LaunchtheATTOConfigurationToolapplication.
2.ExpandthedevicetreetoshowtheExpressSASRxxx,andthenclicktheRAIDtab.DrivestatusforalldrivesconnectedtotheSonnetRAIDcontrollerwillbedisplayed.ThefaultedordegradeddrivewillhavearedLEDiconnexttoit.
3.ClickonthefaultedordegradeddriveyouwanttoidentifyintheAttachedDriveslist.
4.SelectRAIDManagement>Locate>Drivefromtheapplicationmenu.Ifthedrivedoesnotsupportthismethodofidentification,amessagewillappearinthebottompane;gotothenextstep.Otherwise,lookattheFusionenclosure;thedriveactivityLEDforthespecificdrivewillbelit.Afteroneminute,theLEDwillturnoff.
5.Double-clickthefaultedordegradeddriveinthetoppanetodisplaydetailedinformation,andnotetheindexnumberforthedrive.Closethedetaileddriveinformationwindow.
6.ClicktheRAIDCLItab,andthentype“Blockdevidentifyx”,wherexistheindexnumber.LookattheFusionenclosure;thedriveactivityLEDforthespecificdrivewillbelit.
Note:Type “Blockdevidstop” to turn off the LED.
Faulted Drive ReplacementOnceyouhaveidentifiedthefaulteddrive,youmustreplaceitandrebuildtheaffectedRAIDgroup.
1.Swapoutthefaulteddrive.
2.LaunchtheATTOConfigurationToolapplication.
3.ExpandthedevicetreetoshowtheExpressSASRxxx,andthenclicktohighlightthedegradedRAIDgroup.
4.SelectRAIDManagement>Rebuildfromtheapplicationmenu;atabfortheRAIDgroupwillopen,andyouwillbepromptedtodragafreedriveontopoftheonebeingreplaced.SeeFigure 19onpage24.
5.Afterstartingtherebuild,youmayusetheRAIDgroup,butitsperformancewillbereduceduntiltherebuildiscomplete.
1.5 Diagnose and Replace a Faulted Drive
Support Note: The Sonnet RAID controller is unable to automatically turn on fault lights in the drive enclosure,
so the ATTO Configuration Tool must be used to activate the LED for the faulted drive.
Support Note: If you have configured your setup to include a Hot Spare drive, the ATTO Configuration Tool
will automatically start rebuilding the RAID group using the Hot Spare drive.
Support Note: A RAID group rebuild may take up to eight hours to complete, depending on the operating
system, drive capacities, and RAID configuration.
24
1.5 Diagnosing and Replacing a Faulted Drive
Figure 20
RAID group rebuild
25
1.6 Configuration Tool Troubleshooting
You may see an error message informing you about an unexpected event or incorrect information discovered by the application. Using the help text presented with the error message, correct the issue before proceeding.
WarningsanderrormessagesaredisplayedintheStatuspane.
Messages from NVRAM Tab Actions•An error occurred loading NVRAM data.
Thefirsttimeachannelishighlighted,theConfigurationToolattemptstoreadNVRAMfromthecard.ThismessageusuallyindicatesthattheConfigurationToolcouldnotcommunicatewiththedriver,probablybecausetheapplicationdoesnotsupportthedriverversioninuse.
•Warning: NVRAM could not be read, defaults returned.NVRAMiscorruptandthedriverreturnstothedefaultconfiguration.Thedefaultsarepresentedviathegraphicaluserinterface.Thesedefaultsmaybemodifiedbutthedefaultsormodificationsmustbecommitted(saved)inordertocorrectNVRAM.
•An error occurred updating the NVRAM.Thedrivercannotloadthenewsettingsonthecard;nochangesaremadetothecard.
•Feature bounds checking. WhentheCommitbuttonisclicked,eachNVRAMfeatureisvalidatedbeforebeingsenttothecard.Ifanyoneofthesefeaturesisdeemedinappropriatebasedontheimplementedchecks,furtherNVRAMfeaturevalidationchecksarestoppedandthemessageisdisplayed,forexample:Execution Throttle is greater than the maximum allowable value of 255. No NVRAM configuration changes have been made to your card.Theexactmessagevariesbasedonthefirstfieldwithanout-of-rangevalue.
Messages from Flash Tab Actions•This is not a flash file, or it is corrupt.
TheATTO-createdflashfileiscorruptortheConfigurationTool doesnotrecognizethefileasaflashfile.OnlyATTO-createdflashfilesmaybeselectedusingtheflashfiledialogbox.
•This HBA is not compatible with the selected flash file.ATTOflashfilesarecreatedbasedonthetypeofcardflashed.OnlycertainATTOflashfilesarecompatiblewiththeSonnetRAIDcontroller.Whenaflashfileisselected,itisinspectedforcompatibility.
•A valid file was not selected.YouclickedtheCancelbuttonontheflashfileselectiondialog.
•An error occurred reading from the flash file, the file may be corrupt.Youselectedacompatibleflashfilebutthecontentsarecorrupt.
•An error occurred updating the flash.Youtriedtoflashacardwhenthefirmwarewasnotabletoacceptaflash.
•The card has been prepared for firmware updating, but the machine must be rebooted for the changes to take effect. You need to repeat this process after rebooting to actually update the firmware.Somefirmwareupgradesneedtopreparetheexistingfirmwareinordertosuccessfullyupdatethecontroller.Rebootingallowsthechangesmadeduringthepreparationprocesstotakeeffect,andthesamefileshouldbeflashedagain.
26
27
2.0 Windows Only - ATTO Disk Benchmark
The ATTO Utilities for Windows are installed from the CD that was included with your Sonnet RAID controller. Only one utility, Disk Benchmark, may be used with your Sonnet RAID storage system.
DiskBenchmarkmeasurespeakandsustainedthroughputfordiskreadsandwrites.SeeFigure 21onpage28.YoumaylocatetheDiskBenchmarkapplicationintheATTOHBAUtilitiesfolderwithinyoursystem’sApplicationsfolder.
1.Launchtheapplication.
2.Selectthedriveletterforthedisktobenchmark.
3.Selectthetransfersizestotest.
4.SelecttheI/Ooption.
5.ClicktheStartbutton.
6.Waitforbenchmarktorunthroughthedesiredtransfersizes.
7.TheTestResultsDisplayatthebottomofthewindowisupdatedasthetestprogresses.They-axisofthegraphrepresentsthetransfersizesintheselectedrange.Thex-axisrepresentsthetransferspeedsinMB/sec.I/OspeedsinKB/sec.foreachtransfersizearedisplayedtextuallytotherightofthegraph.
8.ClicktheStopbuttontostopthetest.Whenthetestcompletes,theresultscanbesavedorprinted.
Iferrorsweredetected,adialogboxdisplaystheerrorsinatablewiththefollowingfourcolumnsandabutton:
•Benchmark Transfer Size:transfersizeatwhichtheerroroccurred
•Buffer Index:indexintothedatablockatwhichtheerroroccurred
•Actual Value:thevaluereadfromthefile
•Expected Value:thevaluewrittentothefile
•Log to File:Logstheerrortabletoa*.logfileandclosesthedialog.Thefileisgiventhesamenameasthetestfileandsavedinthesamedirectory.Ifthetestwasnotpreviouslysaved,errorsareloggedtothegenericfileBench32Error.logintherootofthetestdrive.Ifthelogfilealreadyexists,thenewerrorsareappendedtothepreviouslyrecordederrors.Thisistheonlywaytosavedetectederrors.Theyarenotsavedinthetestdocumentfile.
IftheI/Ocomparisonoptionwasselectedanderrorswerenotdetected,themessage“Noerrorsdetected”isdisplayed.
Benchmark Fields Thebenchmarkfieldsinclude:
•Drive:Selectthelogicaldrivetobenchmark.Atestcanbeperformedonanysystemdrive.
•Transfer Size:Selecttherangeoftransfersizesusedforreadingandwritingdatatothetestdrive.Transferspeedsaredisplayedforeachsizeintherange.Ifthefirstsizeisgreaterthanthesecondsize,thetestisnotperformedforanytransfersize.
•Total Length:Selectthetotalsizeofthedatafiletobecreatedonthetestdrive.Thisfileisdeletedwhentestingcompletes.
•Direct I/O:Ifthisoptionischecked,fileI/Oonthetestdriveisperformedwithnosystembufferingorcaching.CombinethisoptionwithOverlapped I/Oformaximumasynchronousperformance
Radio Button Group •Overlapped I/OperformsqueuedI/O.Uponselection,the
Queue Depthoptiondisplaystoselectthemaximumnumberofreadorwritecommandsthatmaybeexecutedsimultaneously.
•I/O Comparisoncomparesthedatareadfromthetestfiletothedatawrittenonaperblockbasis.YoucanselectthedatapatternforcomparisonfromtheTest Patterndrop-downbox.
•Run Continuouslyrunsthetestcontinuouslyforaspecifiednumberofminutes.Theteststopsbeforethespecifiedtimeifanyerrorsaredetected.
•Neither:SelectifyoudonotwanttoperformoverlappedI/OorI/Ocomparisons.
Thefollowingfieldsdonotaffectthebenchmarkbutareinformational,providingdocumentationofthetestenvironment.
•Stripe Group:Ifthetestdriveisastripegroup,selectitsnamefromthelistbox.ThenamesandquantitiesofdrivesinthestripegroupareprintedtotheDescriptionbox.SelectCleartoclearthecontentsoftheDescriptionbox.
•Controlled bydisplaysallSonnetRAIDcontrollersinthesystem.
•Description:Enteradditionalinformationaboutthetestthatcanbesavedorprinted.BesuretoenteradditionalinformationaftermakingaselectionfromtheStripeGroupdropdownbox,asthiserasesthecurrentdescription.
Support Note: Additional information on using Disk Benchmark is available by accessing the Help menu in the
application.
2�
2.0 Windows Only - ATTO Disk Benchmark
Multiple Benchmark TestingDiskBenchmarksupportsfourcommandlineparametersforuninterruptedtesting:
• testfileopensandexecutesthetestnamedtestfilewiththeextension.bmk.
•textfileopensthetextfilenamedtextfile.Thisfilecontainsalistoftestfilenamesthathaveanextensionof.bmk.Eachtestinthislistisopenedandexecutedinorder.Stoppingonetestinthelistpreventsfurthertestsfrombeingexecuted.Errorloggingisthesameasthecommandlineparametertestfile,butallerrorsgeneratedfromalltestsinthelistareloggedtoonefile:textfile.log.
• /p testfile:Sameastestfile,onlythetestisprintedtothedefaultsystemprinterinsteadofbeingexecuted.
•/p textfile:Sameastextfile,onlythetestsinthelistareprintedtothedefaultsystemprinterinsteadofbeingexecuted.
Figure 21
Disk Benchmark screens before and after a test has been run
29
2.1 ATTO Disk Benchmark Troubleshooting
The following suggestions may help if you encounter problems with Disk Benchmark.
•UseWindowsDeviceManagertocheckandverifythatalldrivesarevisibletotheoperatingsystem.
•Ifdrivesarenotlisted,checktheconnectionsbetweenthedriveenclosureandtheRAIDcontrollercard,andverifythatalldrivesarefullyseatedintheirbays.
•Makesurethattheenclosureispoweredupandhascompleteditsselfcheckbeforebootingyourcomputer.
•RebootyoursystemanytimeyoumakechangestoaRAIDgroup(aftertheRAIDgrouphasbeenrebuilt).
•Asalastresort,youmayusetheATTOBootConfigurationUtilitytolowlevelformatatroublesomedevice.However,thiserasesallinformationonthedisk.
•Haveyoupartitionedyourdrive,andthenactivatedthatpartition?
•Didyouformatthedrivesforusewithyouroperatingsystem?
Ifproblemspersist,contactSonnetcustomerservice.
30
i
Appendix A - CLI ASCII-Based Interface
The command line interface (CLI) uses ASCII commands typed in the CLI window.
Thecommandlineinterface(CLI)usesasetofASCII-basedcommandstocontrolconfigurationanddiagnostictasks.SeeFigure 6onpage5.
•CLIcommandsarecontextsensitiveandgenerallyfollowastandardformatGet|Set] Command [Parameter1|Parameter2]followedbythereturnorenterkey
•CLIcommandsarecaseinsensitive:youmaytypeallupperoralllowercase,oramixture.Upperandlowercaseinthismanualandthehelpscreenareforclarificationonly.
•Commandsgenerallyhavethreetypesofoperation:get,setandimmediate.
•Thegetformreturnsthevalueofaparameterorsettingandisaninformationalcommand.
•ResponsestogetcommandsarefollowedbyReady.
•Thesetformisanactionthatchangesthevalueofaparameterorconfigurationsetting.ItmayrequireaSaveConfigurationcommandandarestartofthesystembeforeitisimplemented.TherestartcanbeaccomplishedusingaseparateFirmwareRestartcommand.AnumberofsetcommandsmaybeissuedbeforetheSaveConfigurationcommand.
•ResponsestosetcommandsareeitheranerrormessageorReady. *.TheasteriskindicatesyoumustuseaSaveConfigurationcommandtofinalizethesetcommand.
•SetcommandswhichdonotrequireaSaveConfigurationcommand,definedasimmediatecommands,areimmediatelyexecuted.
WARNING: Do not use CLI unless you are directed to by a Sonnet technician, as changing parameters may cause
loss of data and/or disruption to performance and reliability of the Sonnet RAID controller. The ATTO Configuration Tool interface is the preferred method to operate and manage the Sonnet RAID controller.
Support Note: Using certain CLI commands during normal operation can cause a performance drop. Once
command actions are complete, performance should return to normal levels.
Figure A-1 Symbols, typefaces, and abbreviations used to indicate functions and elements of the command line interface used in this manual.
Symbol Indicates
[] Requiredentry
<> Optionalentry
| pickoneof
- arange(6–9=6,7,8,9)
BlockDevID indexdesignationofablockdevicenotassignedtoanyotherRAIDgroup;theindexofablockdeviceprovidedbytheBlockDevScanCLIcommand.0<=n<=63
DevIndex indexdesignationoftheRAIDmember
GroupName thenameoftheRAIDgrouptowhichtheblockdeviceisassigned,orblankifthedriveisavailable
MemberIndex indexdesignationofaRAIDgroupmember
PartID indexdesignationofapartitionasfoundinthePartitionDisplaycommand
tid TargetID0<=n<=255
ii
Appendix A - CLI ASCII-Based Interface
CLI Error Messages ThefollowingerrormessagesmaybereturnedbytheCommandlineInterface
ERROR Invalid Command. Type 'Help' for command list.
ERROR Command Not Processed
ERROR Wrong/Missing Parameters
ERROR Invalid Hot Spare Serial Number
ERROR Invalid RAID GroupName
ERROR Invalid RAID Group State
ERROR Insufficient number of RAID Group members
ERROR RAID Group does not exist
ERROR No RAID Groups found
ERROR Invalid RAID Type
ERROR RAID Group is already unmapped
ERROR Invalid Block Device Index
ERROR Invalid RAID MemberIndex
ERROR Invalid RAID Member State
ERROR Missing RAID Member
ERROR Invalid RAID Member Capacity
ERROR Invalid Partition Index
ERROR Maximum number of RAID Groups exceeded
ERROR Maximum number of Partitions exceeded
ERROR Invalid number of Partitions
ERROR Maximum number of RAID Members exceeded
ERROR Maximum stripe width
ERROR Invalid number of Partitions specified
ERROR Invalid Span Depth specified
ERROR Cannot perform operation on mapped Partition
ERROR Cannot perform operation. RAID Group has mapped Partitions
ERROR Cannot perform operation. RAID Group has Outstanding Commands
ERROR Block Device at specified index no longer available
ERROR Insufficient RAID Group members for RAID type
ERROR Incorrect number of RAID Group members for QuickVideo configuration
ERROR Invalid Virtual Drive ID
ERROR Specified capacity is invalid
ERROR Too many Indices specified.
ERROR Only one add storage operation is permitted at any given time.
ERROR No free block devices
ERROR Cannot benchmark a drive that is being initialized
ERROR Specified drive is not being monitored
iii
CLI Summary ThefollowingchartsummarizestheCommandLineInterfacecommands,theirdefaults,andanexampleofhowtoenterthecommands.Pleasenotethatcommandswhichhavenodefaultvalueshaveablankentryinthatcolumnofthetable.
WARNING: Do not use the CLI unless you are directed to by a Sonnet technician, as changing parameters may
cause loss of data and/or disruption to performance and reliability of the Fusion storage system.
Command Default Example
AutoMap automap
AutoMapOnBoot disabled setautomaponbootenabled
AutoResume rebuild,initialize=allenabled;erase=alldisabled
setautoresumeerasedisabledG1
BlockDevClean blockdevclean30
BlockDevIdentify blockdevidentify30
BlockDevIDStop blockdevidstop
BlockDevScan blockdevscan
BootDelay 0 setbootdelay125
ClearEventLog cleareventlog
Date setdate03/03/2009
DefaultInterleave 128 setdefaultinterleave64
DriveHealth disabled setdrivehealthenabled
DriveHealthDisplay drivehealthdisplayall
DriveHealthStatus drivehealthstatus
DeleteAllMaps deleteallmaps
DriveTest drivetestbegin
DriveTestClearList drivetestclearlistall
DriveTestConfig notinitiated setdrivetestconfigread
DriveTestList getdrivetestlistall
DriveTestStatus getdriveteststatus
DumpConfiguration dumpconfiguration
DumpEventLog dumpeventlog
EventLog enabled seteventlogdisabled
EventLogFilter allallall seteventlogfiltergeninfoall
Help helpeventlog
HSAdd hsadd3
HSDisplay hsdisplay
HSRemove hsremove3
Appendix A - CLI ASCII-Based Interface
iv
Appendix A - CLI ASCII-Based Interface
Command Default Example
Info info
IsReserved isreserved
Metrics metricsdisplayall
Partition partitionalpha164GB
PartitionDisplay partitiondisplayalpha1
PartitionMerge partitionmergeall
PartitionSplit partitionsplitalpha1222
PartitionWriteCache setpartitionwritecacheenabled
RAIDRebuildPriority same setraidrebuildprioritylow
RAIDSpeedWriteLimit 8 setraidspeedwritelimit15
Reserve reserve
RestoreConfiguration restoreconfigurationdefault
RGAddStorage rgaddstorageg1spancommit
RGAutoRebuild disabled setrgautorebuildallenabled
RGCancelAddStorage rgcanceladdstorageg1
RGCommit rgcommitall
RGCreate rgcreateg1raid0
RGDelete rgdeleteall
RGDiskWriteCache setrgdiskwritecacherg1enabled
RGDisplay rgdisplayall
RGErase rgeraseg1
RGHaltConversion rghaltconversiong1
RGHaltErase rghalteraseg1
RGHaltInitialization rghaltinitializationg1
RGHaltRebuild rghaltrebuildg1
RGHDParameter 0 setrghdparameterrg16
RGMemberAdd rgmemberaddg122
RGMemberRemove rgmemberremoveg122
RGRebuild rgrebuildg1
RGResumeConversion rgresumeconversiong1
RGResumeErase rgresumeeraseg1
RGResumeInitialization rgresumeinitializationg1
RGResumeRebuild rgresumerebuildg1
RGSectorSize 512 setrgsectorsizeg18192
RGSpanDepth 1 setrgspandepthg122
RGSpeedRead alldisabled setrgspeedreadg1enabled
v
Appendix A - CLI ASCII-Based Interface
Command Default Example
RGUnmap rgunmapg1
RGWaitTimeout 5 rgwaittimeout30
RMState setrmstateg1online
RMStatus rmstatusg1
Route routehost1raidalpha16
RouteDisplay routedisplay03124
SASTargets sastargets
SaveConfiguration saveconfiguration
SerialNumber getserialnumber
Time settime03:32:30
TimeZone EST settimezonepst
VerboseMode enabled setverbosemodedisabled
VirtualDriveInfo virtualdriveinfo
WrapEventLog enabled setwrapeventlogdisabled
vi
Appendix A - CLI ASCII-Based Interface
CLI Command Explanations Commandlineinterfacecommandsarelistedalphabeticallywithexplanationsofwhattheyareusedfor,theirdefaultsandsyntax.
• AutoMap MapsRAIDgroupscreatedwiththeConfigurationTooltotheoperatingsystem,wheretheyarethendiscoveredassinglestoragedevices.ItispossibletocreateaRAIDgroupthatremainshiddenfromtheoperatingsystem,andthusnotseenbyDiskUtility,theFinder,orothersystemdiscoverytools.AutoMap
•AutoMapOnBootRegulatestheautomaticdetectionandmappingofRAIDgroupsatstartup.Default:disabledset AutoMapOnBoot [enabled | disabled]get AutoMapOnBoot
•AutoResumeRegulatestheautomaticcontinuefeatureforinterruptedrebuildanderaseoperationsatstartup.IfAutoResumeisenabled,allinterruptedrebuildanderaseoperationsarecontinuedatstartup.IfnoGroupNameisspecified,allexistingRAIDgroupsareaffected.Default:alldisabledset AutoResume [Rebuild | Erase | Write Pattern | all] [enabled | disabled] <GroupName>
•BlockDevCleanRemovesanyRAIDconfigurationdatafromtheblockdevicewiththespecifiedBlockDevID.
BlockDevClean [BlockDevID]
•BlockDevIdentifyTurnsonadriveactivityLEDontheFusiondriveenclosureforoneminuteifitisaccessible.
BlockDevIdentify <Groupname> [BlockDevID | MemberIndex]
•BlockDevIDStopTurnsoffthedriveactivityLEDontheFusiondriveenclosurethatwasactivatedwiththeBlockDevIdentifycommand.BlockDevIDStop
•BlockDevScanListsallcurrentlyconnectedphysicaldrivesalongwithanypotentialRAIDgroupassociation.EachblockdevicelistedisassignedauniqueindexatthetimeofthescantoidentifydrivesforotherCLIoperations.BlockDevScan
•BootDelayRegulatesthedelayinsecondswhichtheunitwaitsafterstartupbeforeallowinghoststodetectdiscoveredtargets.Thevalue0constitutesnodelay.Default:0set BootDelay [0 - 255]get BootDelay
•ClearEventLogClearsthecontentsoftheeventlog.NonewentriesarerecordeduntilClearEventLoghascompleted.ClearEventLog
•DateRegulatesthecurrentdateforthisunit.Thedaterangeis01/01/2000to12/31/2099.set Date [MM]/[DD]/[YYYY]get Date
WARNING: The BlockDevIdentify command is intended for diagnostic purposes only. Executing this command may
adversely impact the performance and throughput of the Fusion storage system for the time that the LED is illuminated.
WARNING: Using CLI without contacting a Sonnet technician is not recommended because changing
parameters may cause loss of data and/or disruption to performance and reliability of the Fusion storage system.
WARNING: All RAID group setup information is lost when the BlockDevClean command is performed,
therefore all data is lost. Back up your files before performing this command.
vii
Appendix A - CLI ASCII-Based Interface
•DefaultInterleaveAssignsorretrievesthesystem-defaultinterleavesizefornewRAIDgroups,wheretheinterleavesizeisexpressedasthenumberof512-byteblocks.IfaninterleavesizeisnotexplicitlyspecifiedwhenaRAIDgroupiscreated,thentheDefaultInterleavevalueisused.Note:Although changing the default interleave size may improve performance, it may degrade performance.Default:128set DefaultInterleave [8KB | 16KB | 32KB | 64KB | 128KB | 256KB | 512KB | 1024KB | 2048KB ] get DefaultInterleave
•DeleteAllMapsRemovesallmappeddevicesfromthemaptable.DeleteAllMaps(requiresaSaveConfigurationcommand)
•DriveHealthChangesthesystem’sabilitytoacquiredrivehealthdatafromconnecteddrives.IssuingthiscommandduringI/Ooperationsmayadverselyaffectperformance.Default:disabledset DriveHealth [enabled | disabled] get DriveHealth
•DriveHealthDisplayRetrievesanddisplaysS.M.A.R.T.(Self-Monitoring,AnalysisandReportingTechnology)datafromSATAdrives.IssuingthiscommandduringI/Ooperationsmayadverselyaffectperformance.DriveHealthDisplay [BlockDevID | all]
•DriveHealthStatusDisplaysthestatusofthecurrentlyrunningdrivetestbutdoesnotdisplayperformancemetrics.IfablockdeviceIDisnotrunningorcannotbefound,itsstatewillbeidleandpercentcompletewillbe0.getDriveHealthStatus <drive [BlockDevID]>
•DriveTestRegulatesadrivetestwiththepreviouslyspecifiedconfiguration(refertoDriveTestConfig)anddrivelist(refertoDriveTestList).DrivesbeingtestedarenotavailableforRAIDconfigurationorRAIDoperations.Onlyonetestcanberunatatime.DriveTest [Begin | Cancel]
•DriveTestClearListSpecifiesthedrivetoberemovedfromthedrivetestlist.thedriveBlockDevIDparameterremovesthespecifieddrivefromthelist.Theallparameterremovesalldrivesfromthelist.DriveTestClearList [BlockDevId | all]
•DriveTestConfigConfiguresthenextdrivetesttoperformoneofthefollowingoperations:ThetestisnotstarteduntiltheDriveTestBegincommandisgiven.init:initialize,destructive,write-onlyread:non-destructive,read-onlyverify:destructiveverifyinit-verify:destructivewrite-read-verifyset DriveTestConfig [init | read | verify | init-verify] get DriveTestConfig
•DriveTestListSpecifiesdrivestoberuninthenextdrivetestincludingdriveswhicharenotpartofaRAIDgroupandnotHotSpares.Theallparameterautomaticallychooseseligibledrives.ThetestisnotstarteduntiltheDriveTestBegincommandisgiven.set DriveTestList [drive [BlockDevID] | all] get DriveTestList
•DriveTestStatusDisplaysthestatusofthecurrentlyrunningdrivetestbutdoesnotdisplayperformancemetrics.IfablockdeviceIDisnotrunningorcannotbefound,itsstateisidleandpercentcompleteis0.get DriveTestStatus <drive [BlockDevID]>
•DumpConfigurationDisplaysaunit’sconfigurationtothemanagementinterface.DumpConfiguration
•DumpEventLogDumpsthecontentsoftheentireeventlogtothemanagementinterface.Noeventsarerecordeduntilthecommandhasbeencompleted.DumpEventLog
•EventLogRegulateseventlogging.Whenenabled,recordsvarioussystemerrorstotheeventlog.Default:enabledset EventLog [enabled | disabled] get EventLog
viii
Appendix A - CLI ASCII-Based Interface
•EventLogFilterFiltersdatafromspecificunitsubsystemsandlevelswheneventloggingisenabled.Thespecificentriessupportedareplatform-dependent.Forsetcommands,thefinalparameterindicateswhetherornoteventsfromthespecifiedsubsystemandlevelaredisplayed.Default:allallallset EventLogFilter [subsys | all] [event level | all] [all |none] get EventLogFilter [subsystem] [level]
•HelpDisplaysalistofavailablecommands.Ifcommandnameisspecified,displaysdetailedcommand-specificinformationHelp <command name>
•HSAddAssignsaBlockDevicetotheHotSparepool.HSAdd [BlockDevID]
•HSDisplayListsalldevicesintheHotSparepool.HSDisplay
•HSRemoveRemovesaBlockDevicefromtheHotSparepoolHSRemove [BlockDevID]
•InfoDisplaysversionnumbersandotherproductioninformationforkeycomponents.Info
•IsReservedDisplaysthereservationstatusofthecurrentservicessessionorinterface.IsReserved
•MetricsControlsthecollectionofstandarddatametricswithinaproductbasedonthecommandparameters.Metrics [Start | Stop | Display] [drive [BlockDevID] | all | running]
•PartitionCreatesaspecifiedpartitiontothespecifiedcapacityinGigabytes(GB),Megabytes(MB),orblocks.Thespecifiedcapacitymustbesmallerthanthespecifiedpartition’scurrentcapacity.Anewpartitioniscreatedtoacquiretheremainderoftheoriginalpartition’sspace.VirtualDriveInfodisplayscharacteristicsandstatisticsforalltheavailablevirtualdrivesoranyavailablevirtualdriveidentifiedbyitsvirtualdriveID.Partition [GroupName] [PartIndex] [capacity] [GB | MB | blocks]
•PartitionDisplayListsallthepartitionsavailableinthespecifiedRAIDgroup.Thepartitionsarelistedcontiguously(asopposedtoindexorder).PartitionDisplay [GroupName]
•PartitionMergeCombinesthespecifiedcontiguouspartitionsintoonepartition.PartIdxistheindexofapartitionasfoundinPartitionDisplay.AllindicatesthatallpartitionsintheRAIDgrouparemergedintoasingleVirtualDisk.TheRAIDgroupmustnotbeinaNEWstate.Noneofthepartitionstomergemaybemapped.PartitionMerge [GroupName] [[[PartIdx] [2-128]] | All]
•PartitionSplitDividesthespecifiedpartitionintooneormorepartitionswhosecapacitiesareevenlydistributedamongthecapacityoftheoriginalpartition.ThepartitiontosplitcannotbemappedandtheRAIDgroupmustnotbeinaNEWstate.PartitionSplit [GroupName] [PartIdx] [1-128]
•PartitionWriteCacheIfenabled,allowshigherwriteperformancewithasmallriskofdatalossafterasystemfailure.Ifdisabled,providesahigherlevelofdataintegritywithlowerwriteperformance.set PartitionWriteCache [GroupName] [PartIndex] [enabled | disabled] get PartitionWriteCache [GroupName] [PartIndex]
•RAIDSpeedWriteLimitRegulatesthelimitonthecoalescingfactor.Averylowlimitisrecommendedformultipleinitiators;ahighlimitisrecommendedformultiplestreamsofsequentialwriteI/O.Default:8set RAIDSpeedWriteLimit [0 - 256] get RAIDSpeedWriteLimit
ix
Appendix A - CLI ASCII-Based Interface
•RAIDRebuildPriority SetsordisplaystheRAIDrebuildpriority.ARAIDrebuildprioritysettohighgiveshigherprioritytoRAIDrebuildsandlowerprioritytotheprocessingofsimultaneousI/Otransactions.ARAIDrebuildprioritysettolowgiveslowerprioritytotherebuildandahigherprioritytoI/Otransactions.Setsame,theRAIDrebuildandprocessingofI/Otransactionsisthesame.Default:sameset RAIDRebuildPriority [high | low | same] get RAIDRebuildPriority
•ReserveReportsthestateofCLIreservationforthecurrentCLIsession.IfthecommandreportsthatReservationsareenabled,thenanotherCLIsessionhascontrolofparametermodificationontheunit.Reserve
•RestoreConfigurationIssuedwiththedefaultoption,forcestheunitNVRAMsettingstotheiroriginaldefaults.Thesavedoptionundoesanychangesmadetothissessionsincethelastsave.RestoreConfiguration [Default | Saved]
•RGAddStorageAddsadditionalstoragetoanexistingRAIDgroup.Mirror, Stripe, or Spanspecifiesthemethodusedtoexpandthestorage.OptionalparameterlistBlockDeviceIDspecifiesupto10availableblockdevices,providedbytheBlockDevScancommand,tobeaddedtotheRAIDgroup.Ifthislistisomitted,thecommandRGMemberAddmustbeused.OptionalparametercommitrunstheRGCommitcommandautomaticallyandalluserdataiserasedfromeachnewmemberdrive.Iftheparameterisomitted,thecommandRGCommitmustbeentered.RGCancelAddStoragecanbeusedatanytimebeforethecommitcommandisusedtocanceltheprocess.specifiesthattheRGCommitcommandisrunautomatically.Note:Mirrors cannot be added to a RAID 4, RAID 5, RAID 6, or DVRAID RAID group.RGAddStorage [GroupName] [Mirror | Stripe | Span] <BlockDeviceID… <commit>
•RGAutoRebuildRegulateswhetheraRAIDgroupautomaticallyrebuilds.Default:disabledset RGAutoRebuild [GroupName | all] [enabled | disabled] get set RGAutoRebuild [GroupName | all]
•RGCancelAddStorageCancelstheRGAddStoragecommand.RGCancelAddStorage [GroupName]
•RGCommitStampsaNEWRAIDgroup’sconfigurationtoitsmemberdrives.Afterthiscommand,aRAIDgroupcanbeconsideredoperationalandtransitionsfromtheNEWstatetotheOnline,Degraded,orOfflinestatedependingonthehealthoftheselectedmemberdrives.RGCommitalsostampsanexistingRAIDgroup’sconfigurationtoitsmemberdrivesasstorageisbeingadded.Iftheinitoptionisspecified,previoususerconfigurationinformationiserasedfromeachmemberdrive.RGCommit [GroupName | all] [init]
•RGCreateCreatesanewemptyRAIDgroup.TheoptionalvalueaftertheRAIDgrouptypeparameterrepresentsthedesiredinterleavefortheRAIDgroup,wheretheinterleavesizeisexpressedasthenumberof512-byteblocks.Ifthisvalueisnotprovidedthenthesystem-defaultinterleavesizeisused(refertoDefaultInterleave).RGCreate [GroupName] [RAID [ 0 | 1 | 10 | 4 | 5 | 6 ] | JBOD] <8KB | 16KB | 32KB | 64KB | 128KB | 256KB | 512KB | 1024KB | 2048KB>
•RGDeleteDeletesallRAIDgroupsorthespecifiedRAIDgroup.RGDelete [GroupName | all]
• RGDiskWriteCache Ifenabled,produceshigherwriteperformancewithasmallriskofdatalossafterasystemfailure.Ifdisabled,drivesareupdatedattheexpenseofsomewriteperformance.set RGDiskWriteCache [GroupName | all] [enabled | disabled] get RGDiskWriteCache [GroupName | all]
•RGDisplayDisplaysstatusinformationforasingleRAIDgroup,orifAllisused,allavailableRAIDgroups.RGDisplay [GroupName | all ]
•RGEraseErasesthedatafromthespecifiedexistingRAIDgroup.Note:All data is lost if you use the RGErase command.RGErase [GroupName]
x
Appendix A - CLI ASCII-Based Interface
•RGHaltConversionStopstheconversiononthespecifiedexistingRAIDgroup.RGHaltConversion [GroupName]
•RGHaltEraseStopstheeraseonthespecifiedexistingRAIDgroup.RGHaltErase [GroupName]
•RGHaltInitializationStopstheinitializationprocessonthespecifiedexistingRAIDgroup.RGHaltErase [GroupName]
•RGHaltRebuildStopstherebuild(s)onthespecifiedexistingRAIDgroup.MemberIndexspecifiestheRAIDmemberwhoserebuildisstopped.IfnoMemberIndexisspecified,allrebuildsonthatRAIDgrouparestopped.RGHaltRebuild [GroupName] <MemberIndex>
•RGHDParameterShowsorsetstheHDvalueforallRAIDgroups.set RGHDParameter [GroupName | all] [0–6]get RGHDParameter [GroupName | all]
•RGMemberAddAddsupto10availableblockdevicestoanewRAIDgroup(theRAIDgroupcannothavebeensavedusingtheRGCommitcommand).Ifallisspecified,thenallunusedblockswillbeaddedtotheRAIDgroupuntilthemaximumnumberofRAIDgroupmembershasbeenmet.ThecommandresetsthenumberofRAIDgrouppartitionsto1RGMemberAdd [GroupName| all] [BlockDevID]
•RGMemberRemoveRemovesaRAIDmemberfromanewRAIDgroup(theRAIDgroupcannothavebeensavedusingtheRGCommitcommand).Resetsthenumberofpartitionsto1.RGMemberRemove [GroupName] [BlockDevID]
•RGRebuildRebuildsthespecifiedexistingRAIDgroup.Ifnomemberisspecified,alldegradedmembersarerebuilt.OptionalparameterBlockDevIDallowsanavailableblockdevicetobesubstitutedfortheRAIDMembercurrentlyassignedtothememberindex.IfaRAIDgrouphasbeenconfiguredasRAID6,twoRAIDgroupmemberscanberebuiltatonceRGRebuild [GroupName] <<MemberIndex> <BlockDevID> <and MemberIndex2 <BlockDevID2>>>>
•RGResumeConversionContinuesthestoppedconversiononthespecifiedexistingRAIDgroup.RGResumeConversion [GroupName]
•RGResumeEraseContinuestheeraseonthespecifiedexistingRAIDgroup.RGResumeErase[GroupName]
•RGResumeInitializationContinuestheinitializationonthespecifiedexistingRAIDgroup.RGResumeInitialization[GroupName]
•RGResumeRebuildContinuestherebuild(s)onthespecifiedexistingRAIDgroup.IfnoMemberIndexisspecified,allstoppedrebuildsonthatRAIDgrouparecontinued.ForRAID6groups,ifaMemberIndexisspecified,allhaltedRAIDmembersonthespanwiththatMemberIndexresumeaswell.RGResumeRebuild [GroupName] <MemberIndex>
•RGSpanDepthRegulatesthespandepthonthespecifiedexistingRAIDgroup.TheRAIDgroupmustbeRAIDLevel0,RAIDLevel1,RAIDLevel5,orRAIDLevel10.Default:1set RGSpanDepth [GroupName] [SpanDepth [1-32]] get RGSpanDepth [GroupName]
•RGSpeedReadPerformslook-aheadduringreadsfromRAIDgroupmemberdisksforallorthespecifiedRAIDgroup.Default:disabledset RGSpeedRead [GroupName | all] [enabled | disabled] get RGSpeedRead [GroupName | all]
•RGUnmapRemovesallmappedpartitionsforaRAIDgroupfromtheroutingtable.Thepartitionsthemselvesareunaffectedbuttheyareinaccessibletoinitiators.RGUnmap [GroupName | all]
xi
•RGWaitTimeoutRegulatesthemaximumtimeinsecondsthatthesystemwaitstodiscoverpreviouslyconfiguredRAIDgroupsattachedtothecontroller.Default:5set RGWaitTimeout [1-300] get RGWaitTimeout
•RMStateRegulatesthestateofthespecifiedexistingRAIDgroupmember(s).TheRAIDgroupmaynotbeinthenewstate.IfnoMemberIndexisspecified,thestatusofallmembersofthespecifiedRAIDgroupisset.Note:Members undergoing rebuild are not changed. Rebuilds on these members must first be stopped.set RMState [GroupName] <MemberIndex> [Online | Degraded | Unavailable | Faulted]
•RMStatusDisplaysthestatusofallRAIDgroupmemberswithinthespecifiedRAIDgrouporaspecificRAIDmemberwithinthespecifiedRAIDgroup.RMStatus [GroupName] <MemberIndex>
•RouteAssignsaRAIDpartitiontoatargetIDonthehostsystem.IfamapwiththespecifiedtargetIDalreadyexists,themapisoverwritten.UsedeletewithatargetIDtoremovethemap.Route [host] [TID] [RAID] [GroupName] [PartIndex]] | SAS {SASIndex]] | Delete]
•RouteDisplayDisplaysalistofhostprotocoladdresstotargetdestinationdevicemappings.RouteDisplay [host] <tid>
•SASTargetsListsthephysicaldevicesthatareconnectedtoallSASports.SASTargets
•SaveConfigurationIssuedwiththerestartoption,cyclesunitpoweraftersavingconfigurationchanges.Thenorestartoptionsaveschangeswithoutrestarting.Note:Certain modifications require a system restart.SaveConfiguration
•SerialNumberReportstheuniqueserialnumberfortheSonnetRAIDcontrollerusinga13-characterfield.Thefirstsevenalphanumericcharactersrepresenttheproductname;thelastsixdigitsaretheunit’suniquenumber.get SerialNumber
•TimeControlsordisplaysthecurrenttimeasclockedbytheunitin24hourformat.set Time [HH: MM: SS] get Time
•TimeZoneControlsordisplaysthetimezoneoranoffsetfromGMTfortheunit.Default:ESTset TimeZone [[EST | CST | MST | PST] | [+/-HH:MM]] get TimeZone
•VerboseModeControlsthelevelofdetailinCLIHelpoutputandcommandresponseoutput.Default:enabledset VerboseMode [enabled | disabled] get VerboseMode
•VirtualDriveInfoDisplayscharacteristicsandstatisticsforalltheavailablevirtualdrivesoranyavailablevirtualdriveidentifiedbyitsvirtualdriveID.VirtualDriveInfo <Virtual Drive ID>
•WrapEventLogWhenenabled,theunitlogsupto2,048evententriesbeforewrapping(overwritingthefirstentries).Ifdisabled,theunitstopsloggingevententrieswhenthebufferisfull.Default:enabledset WrapEventLog [enabled | disabled] get WrapEventLog
Appendix A - CLI ASCII-Based Interface
xii
Appendix B - Quick Drive Format Instructions
If your Sonnet Fusion RAID storage system shipped with pre-installed hard disk drives, the following information will assist you to reformat the drives per your needs.
InFusionRAIDsystemsshippedfromSonnetwithharddiskdrivesinstalled,thedrivesareformattedMacOSExtended(Journaled),andconfiguredasasingleRAID5RAIDgroup.Ifyouneedtochangetheconfiguration,usetheATTOConfigurationToolandtheoperatingsystemsoftwaretoolstoreformatandreconfigurethedrives.
Mac OS Users’ Instructions 1.Followallthestepsintheincludeddocumentationtoinstall
thesoftwareandtheSonnetRAIDcontroller,andtosetupandconnecttheFusionRAIDdriveenclosure.
2.Startyourcomputer,andthenturnontheFusiondriveenclosure;theRAIDvolumeshouldappearonthedesktop.
3.Dragthevolumetothetrash(changestoanejecticon)toejectit.
4.LaunchtheATTOConfigurationTool.
5.SelectRAIDManagement>DeleteGroupfromtheapplicationmenu.
6.WhentheDelete Confirmationwindowappears,clickYes.
7.SetupnewRAIDgroupsfollowingtheinstructionsonpages9and10ofthismanual.
8.Dependingonhowyouconfigureyoursetup,aDisk Insertionwindowwillappearatsomepointstatingthatthereisanunreadablevolume;clickInitialize,andthenDiskUtilitywillopen.
9.IntheDisk Utilitywindow,eachRAIDgroupyoucreatedusingtheATTOConfigurationToolwillappearasasinglevolume.Selectthevolume,andthenclicktheErasetabatthetopofthewindow.
10.ClickErase;awindowwillappearaskingyoutoapproveyourchoice.
11.ClickErase.
12.Repeatsteps7–11foreachremainingunformattedRAIDgroup.
13.CloseDiskUtility.
14.DependingonhowyouconfiguredtheRAIDgroups,thevolumesmayalreadybemountedandpresentonthedesktop.IfyoucreatedaDVRAID,RAIDLevel4,orRAIDLevel5group,configurationwilltakemuchlonger.Youmaycheckontheprocessbydouble-clickingtheRAIDgroupnameinthelowerpaneoftheATTO Configuration Toolwindow.
Windows Users’ Instructions 1.Followallthestepsintheincludeddocumentationtoinstall
thesoftwareandtheSonnetRAIDcontroller,andtosetupandconnecttheFusionRAIDenclosure.
2.Startyourcomputer,andthenturnontheFusiondriveenclosure.
3.LaunchtheATTOConfigurationTool.
4.ExpandthedevicetreeintheDeviceListingsectionontheleftsideofthewindowuntilExpressSASRxxxisdisplayed,andthenclickExpressSASRxxx.
5.ClicktheRAIDtab.
6.IntheGroupspane,youwillseetheRAIDgroupthatSonnetcreated(notusableinaWindowssystem);clickthegroup.
7.SelectRAIDManagement>DeleteGroupfromtheapplicationmenu.
8.WhentheDelete Confirmationwindowappears,clickYes.
9.SetupnewRAIDgroupsfollowingtheinstructionsonpages9and10.
10.SelectComputerManagementFromtheWindowsStartmenu.IfComputerManagementisnotavailableintheStartMenu,selectStart>ControlPanel>AdministrativeTools.IntheAdministrative Toolswindow,double-clickComputerManagement.
11.IntheComputer Managementwindow,clickStorageontheleft,andthendouble-clickDiskManagement.
12.WhentheInitialize Diskwindowappears,clickOK.
13.IntheDisk Managementwindow,eachRAIDgroupyoucreatedwillappear(listedas“unallocated”)asasinglevolume.Right-clickwheretheword“unallocated”appears,andthenselectNewSimpleVolume.
WARNING: After selecting the DVRAID, RAID Level 4, or RAID Level 5 option, configuration of a set of eight 1TB
drives can take up to 4 hours (or up to 2 hours with 500GB drives).
WARNING: After selecting the DVRAID, RAID Level 4, or RAID Level 5 option, configuration of a set of eight 1TB
drives can take up to 4 hours (or up to 2 hours with 500GB drives).
xiii
Appendix B - Quick Drive Format Instructions
Windows Users’ Instructions (continued) 14.WhentheWelcometotheNew Simple Volume Wizard window
appears,clicknexttostarttheprocess.
15.Followtheremainingstepstocompletetheprocess.
Note: If you do not select the quick format option, this process will take much longer to complete.
16.Repeatsteps13–15foreachremaining“unallocated”disk.
17.DependingonhowyouconfiguredtheRAIDgroups,thevolumesmayalreadybeavailabletouse.IfyoucreatedaDVRAID,RAIDLevel4,orRAIDLevel5group,configurationwilltakemuchlonger.Youmaycheckontheprocessbydouble-clickingtheRAIDgroupnameinthelowerpaneoftheATTOConfigurationToolwindow.
18.OncealltheRAIDgroupshavebeenformatted,theyarereadytouse.
Remember to register your product online at http://registration.sonnettech.com to be informed of future upgrades and product releases.Software updates and links are available from the Sonnet web site at www.sonnettech.com. • Online support form available at http://supportform.sonnettech.com.Sonnet Technologies Customer Service hours are Mon.-Fri., 7 a.m.–4 p.m. Pacific Time • Customer Service Phone: 1-949-472-2772 • E-mail: [email protected] Technologies, Inc., California USA • Tel: 1-949-587-3500 Fax: 1-949-457-6350
©2009 Sonnet Technologies, Inc. All rights reserved. Sonnet, the Sonnet logotype, Simply Fast, the Simply Fast logotype, and Fusion are trademarks of Sonnet Technologies, Inc. Macintosh and Mac are trademarks of Apple Inc., registered in the United States and other countries. Other product names are trademarks of their respective owners. Product specifications subject to change without notice. Printed in the USA. MNL-RAID-SW-E-D-021709