Adaptec CDP-00276-01-A, User Manual

Page 1: ... Adaptec RAID Controller Command Line Utility User s Guide CDP 00276 01 A Rev A Issue September 17 2012 ...

Page 2: ... expressly disclaims all representations and warranties of any kind regarding the contents or use of the information including but not limited to express and implied warranties of accuracy completeness merchantability fitness for a particular use or non infringement In no event will PMC Sierra Inc be liable for any direct indirect special incidental or consequential damages including but not limit...

Page 3: ...Issue Date Issue Adaptec Firmware BIOS Drivers Utilities Version 8 0 September 17 2012 1 0 3 Proprietary and Confidential to PMC Sierra Inc Document No CDP 00276 01 A Rev A Issue Adaptec RAID Controller Command Line Utility User s Guide ...

Page 4: ...arcconf failover 21 arcconf getconfig 21 arcconf getlogs 22 arcconf getperform 23 arcconf getsmartstats 23 arcconf getstatus 24 arcconf getversion 24 arcconf identify 25 arcconf imageupdate 25 arcconf key 27 arcconf modify 27 arcconf playconfig 28 arcconf rescan 30 arcconf resetstatisticscounters 30 arcconf romupdate 30 arcconf saveconfig 31 arcconf savesupportarchive 32 arcconf setalarm 32 arccon...

Page 5: ...es Table 1 ARCCONF Batch Environments 15 Table 2 ARCCONF Commands 15 v Proprietary and Confidential to PMC Sierra Inc Document No CDP 00276 01 A Rev A Issue Adaptec RAID Controller Command Line Utility User s Guide ...

Page 6: ...ptec Support Knowledgebase ASK at ask adaptec com for articles troubleshooting tips and frequently asked questions for your product For support via e mail submit your question at ask adaptec com To speak with a Technical Support Specialist call 1 408 934 7274 or 49 89 4366 5544 or 44 845 266 8773 Europe Visit our Web site at www adaptec europe com German Call 49 89 43 66 55 22 For support via e ma...

Page 7: ...the Software or any portion thereof in any form on the Internet You may not use the Software in a computer service business including in time sharing applications The Software contains trade secrets and in order to protect them you may not decompile reverse engineer disassemble or otherwise reduce the Software to a human perceivable form YOU MAY NOT MODIFY ADAPT TRANSLATE RENT LEASE LOAN RESELL FO...

Page 8: ...the Software You agree that you will not export or re export the Software or documentation in any form in violation of applicable United States and foreign law 11 Government Restricted Rights The Software is subject to restricted rights as follows If the Software is acquired under the terms of a GSA contract use reproduction or disclosure is subject to the restrictions set forth in the applicable ...

Page 9: ...Sunnyvale CA 94089 408 239 8000 9 Proprietary and Confidential to PMC Sierra Inc Document No CDP 00276 01 A Rev A Issue Adaptec RAID Controller Command Line Utility User s Guide ...

Page 10: ...axView Storage Manager To install ARCCONF without the GUI navigate to the folder for your operating system on the installation DVD select the ARCCONF executable then copy to your machine On Linux systems you may need to give the ARCCONF file execute privileges Note On FreeBSD systems you must use ARCCONF to perform storage management tasks FreeBSD does not support the maxView Storage Manager GUI F...

Page 11: ...2 Mount the Adaptec Installation DVD mount dev cdrom mnt cdrom 3 Change to the Debian manager directory Description Options cd mnt cdrom maxview debian_x86 manager 32 bit cd mnt cdrom maxview debian_x86_64 manager 64 bit 4 Install the deb package xxxxx build number Description Options dpkg i StorMan_9 00_XXXXX_i386 deb 32 bit dpkg i StorMan_9 00_XXXXX_x86_64 deb 64 bit 5 Enter the following config...

Page 12: ...VD Installing on VMware ESX 4 1 Use the following procedure to install the vib files for VMware ESX 4 1 The installation can be done on an ESX 4 1 console or from a remote system running a Telnet SSH client 1 Insert and mount the Adaptec Installation DVD 2 Copy the following files to your local ESX 4 1 tmp directory vmware esx provider arcconf vib vmware esx provider arcsmis vib The arcconf vib is...

Page 13: ...unt the Adaptec Installation DVD 2 Copy the following files to your local ESXi 5 0 tmp directory vmware esx provider arcconf vib vmware esx provider arcsmis vib The arcconf vib is for command line communication The arcsmis vib is for remote management communication 3 Stop operations etc init d sfcbd watchdog stop 4 Check for existing installation of arcconf esxcli software vib list grep arcconf 5 ...

Page 14: ...ollowing commands depending on the operating system Description Options StorMan 9 00 19098 esx86_64 bin Linux setup_asm_esx_x64 exe Windows Starting the Command Line Utility 1 To start ARCCONF enter one of the following commands Description Options install_dir arcconf exe Windows usr install_dir arcconf Linux usr StorMan arcconf Solaris install_dir arcconf FreeBSD usr StorMan arcconf VMware where ...

Page 15: ...MMAND help To view a list of commands at the command line type ARCCONF and press Enter To access the online help for a specific command type ARCCONF command then press Enter ARCCONF Commands The following commands are available in ARCCONF The commands are described on the following pages in alphabetical order Table 2 ARCCONF Commands setpower saveconfig getsmartstats atapassword setpriority savesu...

Page 16: ...les ARCCONF ATAPASSWORD 1 SET uR8ryx 0 1 ARCCONF ATAPASSWORD 1 CLEAR uR8ryx 0 1 arcconf copyback Description Enables or disables the copyback feature which attempts to keep drives in the original slot order after rebuilds Syntax ARCCONF COPYBACK Controller ON OFF Parameters Controller The controller number On enables the copyback feature Off disables the copyback feature Examples ARCCONF COPYBACK ...

Page 17: ...Size RAID CHANNEL DRIVE CHANNEL DRIVE noprompt nologs ARCCONF CREATE Controller LOGICALDRIVE RVOLUME LD LD LD noprompt nologs ARCCONF CREATE Controller JBOD CHANNEL DRIVE CHANNEL DRIVE noprompt nologs Parameters Controller The controller number 17 Proprietary and Confidential to PMC Sierra Inc Document No CDP 00276 01 A Rev A Issue Adaptec RAID Controller Command Line Utility User s Guide ...

Page 18: ...axCache off MaxCacheWriteCache Sets the logical drive SSD write cache mode ION maxCache on IOFF maxCache off MaxCacheWritePolicy Sets the maxCache write cache policy WB write back enabled maxCache will store the data on the SSD and write it back to the hard disks when there is little or no impact on performance This is the default policy INSTWB instant write back enabled In addition to the default...

Page 19: ... the maximum is 365 days slow Setting the period automaically turns background consistency check on Noprompt Optional parameter that suppresses the confirmation prompt Examples ARCCONF DATASCRUB 1 PERIOD 30 ARCCONF DATASCRUB 1 OFF arcconf delete Description Deletes a logical drive JBOD or maxCache logical device All data stored on the logical drive or JBOD will be lost Spanned drives cannot be del...

Page 20: ... 2 3 ARCCONF DELETE 1 JBOD ALL arcconf driverupdate Description Updates Windows device drivers When given a directory name it will attempt to update a driver to the version found in the given directory Note This command is available only on Windows systems Syntax ARCCONF DRIVERUPDATE DirName Parameters Driverupdate DirName Directory path containing the driver that you want to update 20 Proprietary...

Page 21: ...e following Controller type BIOS boot block device driver and firmware versions Logical drive status RAID level and size maxCache status fetch and flush rate policy read write balance SSD information Device type device ID presence of PFA Physical device state Enclosure information fan power supply and temperature status Controller green backup information for AFM 700 flash backup module status fue...

Page 22: ... of defunct devices EVENT A log of special events that may have occurred rebuilds LDMs etc STATS A log of controller usage statistics Syntax ARCCONF GETLOGS Controller Type clear tabular Parameters Controller Controller number Clear clears the specified log Type One of the following DEVICE DEAD EVENT STATS Clear Clears the specified log Note This option is valid only for the DEVICE DEAD and EVENT ...

Page 23: ...ormance mode parameters in a file Filename Name of the file in which to save the parameters If not specified the default filename is PerformanceMode cfg Nologs Suppresses creation of logs for this command Examples ARCCONF GETPERFORM 1 2 arcconf getsmartstats Description Displays SMART statistics for the hard drives and Solid State Drives SSDs on a controller Note For more information about SMART s...

Page 24: ...ize and secure erase operations on physical devices 3 GETSTATUS only reports active operations It does not display information if the operation is completed Syntax ARCCONF GETSTATUS Controller Parameters Controller Controller is the controller number Examples ARCCONF GETSTATUS 1 arcconf getversion Description Lists version information for all controllers or a specific controller s software compone...

Page 25: ... to be identified Device Device number for the device to be identified Examples ARCCONF IDENTIFY 1 DEVICE 0 0 ARCCONF IDENTIFY 1 ALL arcconf imageupdate Description Allows new firmware to be flashed to the hard drive or enclosure Syntax Physical Device Usage ARCCONF IMAGEUPDATE Controller DEVICE Channel ID ChunkSize Filename Mode noprompt ARCCONF IMAGEUPDATE Controller DEVICE Channel ID ChunkSize ...

Page 26: ...e Mode Firmware update mode Valid values for physical devices are 3 SATA Download with offsets and save image for immediate and future use 7 SAS Download microcode with offsets save and activate Valid values for enclosures are DEFER Download microcode only requires system reset or power cycle to activate Noprompt Optional parameter that suppresses alert messages 26 Proprietary and Confidential to ...

Page 27: ... raid level to another RAID Level Migration Expands a logical device from original to one with larger capacity Online Capacity Expansion Can be used to make mirrored sets Syntax MODIFY Controller FROM LogicalDrive TO Options Size RAID CHANNEL DRIVE CHANNEL DRIVE noprompt Parameters Controller The controller number From Indicates that the logical drive to be modified will follow LogicalDrive The lo...

Page 28: ...onf playconfig on page 28 Use this command to deploy the same controller configuration on multiple servers in your storage space Note 1 The XML server template file default saveconfig xml is editable For example you may need to change the disk drive capacity logical drive size or RAID level 2 Drives from the same vendor with slightly different capacities 147GB vs 150GB for instance are considered ...

Page 29: ...layconfig log FORCE Forces deployment of the server even if the controller does not support all features or the drive capacity does not match the configuration in the input XML file Use FORCE ALL to force deployment of all features use FORCE LOGICALSIZE to force deployment of just the logical drives 29 Proprietary and Confidential to PMC Sierra Inc Document No CDP 00276 01 A Rev A Issue Adaptec RA...

Page 30: ...sticscounters Description Resets statistics counters for a controller Use this command to clear the counters and create fresh statistics Syntax ARCCONF RESETSTATISTICSCOUNTERS Controller Parameters Controller The controller number Examples ARCCONF RESETSTATISTICSCOUNTERS 1 arcconf romupdate Description Allows new firmware and BIOS to be flashed to the controller A reboot is required for the new fi...

Page 31: ...F ROMUPDATE 1 AS483C newversion 12345 force noprompt arcconf saveconfig Description Saves the controller configuration to a XML server template file including the controller type operational settings physical drive size logical drive size RAID level and more Use this file with the PLAYCONFIG command to deploy the same controller configuration to other servers in your storage space see arcconf play...

Page 32: ...see arcconf getsmartstats on page 23 The log files are saved in the Support folder in the standard logs directory for your operating system var log for Linux the maxView Storage Manager install directory on Windows and so on Note Unlike the Save Support Archive feature in maxView Storage Manager this command does not create a zip archive file It simply saves the support files and logs in the Suppo...

Page 33: ...ber LogicalDrive The number of the logical drive whose cache will be altered Logical mode Logical drive cache mode RON read cache on ROFF read cache off WT write through disabled WB write back enabled WBB write back enabled when protected by battery or flash backup module Channel ID Lists the space delimited channel number and device number pairs for each device to add to the logical drive Physica...

Page 34: ...t Adaptec meta data and without OS partitions are automatically configured as Simple Volumes single drives with Adaptec meta data with these settings Controller read caching is set to Enabled for rotating media Controller write caching is set to Enabled write back when protected by battery ZMM for rotating media maxCache SSD read and write caching is enabled and the write caching policy is set to ...

Page 35: ...xCache SSD caching you must assign at least one SSD to the maxCache pool Syntax Read Caching ARCCONF SETMAXCACHE Controller LOGICALDRIVE LogicalDrive READCACHE ENABLE DISABLE Syntax Write Caching ARCCONF SETMAXCACHE Controller LOGICALDRIVE LogicalDrive WRITECACHE ENABLE DISABLE WRITEPOLICY policy ARCCONF SETMAXCACHE Controller LOGICALDRIVE ALL WRITECACHE DISABLE WRITEPOLICY policy ARCCONF SETMAXCA...

Page 36: ...t Once the percentage of dirty pages crosses the threshold the data are flushed to disk WBCVALID ENABLE DISABLE Enables and disables write caching in non redundant maxCache Applies to all logical drives Policy maxCache write cache policy WB write back enabled maxCache will store the data on the SSD and write it back to the hard disks when there is little or no impact on performance This is the def...

Page 37: ...CE 4 1 ARCCONF SETMAXCACHE 1 FLUSHANDFETCHRATE 200 ARCCONF SETMAXCACHE 1 CLEAR arcconf setname Description Renames a logical drive Syntax ARCCONF SETNAME Controller LOGICALDRIVE LogicalDrive New Name Parameters Controller Controller number LogicalDrive The number of the logical drive to be renamed New Name The new name of the logical drive 37 Proprietary and Confidential to PMC Sierra Inc Document...

Page 38: ...ller Performance Mode nologs Parameters Controller The controller number Performance Mode Behavior Setting Performance criteria adjusts automatically based on controller usage RAID level and disk drive type 1 DYNAMIC Default Performance criteria is optimized for transaction oriented applications such as data entry and retrieval 2 OLTP Database DRAM write cache is bypassed based on IO write size pe...

Page 39: ...roller the maximum number of drives that the controller may spin up at one time internal The maximum number of internal drives that the controller may spin up at one time from 0 20 external The maximum number of external drives such as the drives in a JBOD that the controller may spin up at one time from 0 20 LogicalDrive The logical drive number Slowdown st Sets the disk drive slow down timer in ...

Page 40: ... task to be changed Use arcconf getstatus to obtain the task ID Omit this parameter to set the controller s global background task priority that is the execution priority for all tasks on the controller New Priority LOW MEDIUM or HIGH Current keyword Applies a global task priority change to running tasks By default a global priority change does not apply to running tasks Examples ARCCONF SETPRIORI...

Page 41: ...ing a consistency check Noprompt No prompt for confirmation Examples ARCCONF SETSTATE 1 DEVICE 0 0 HSP LOGICALDRIVE 1 2 3 ARCCONF SETSTATE 1 DEVICE 0 0 RDY LOGICALDRIVE 2 ARCCONF SETSTATE 1 LOGICALDRIVE 1 OPTIMAL ADVANCED nocheck arcconf setstatsdatacollection Description Enables or disables statistics collection for a controller To display the statistics seearcconf getlogs on page 22 Syntax ARCCO...

Page 42: ...k on a logical drive physical drive or maxCache logical device Syntax General Usage ARCCONF TASK TASK START Controller LOGICALDRIVE LogicalDrive options noprompt TASK STOP Controller LOGICALDRIVE LogicalDrive TASK START Controller DEVICE Channel ID options noprompt TASK STOP Controller DEVICE Channel ID Syntax maxCache Usage ARCCONF TASK TASK START Controller MAXCACHE COHERENCYCHECK ONCE ALWAYS TA...

Page 43: ...he Container redundancy and repairs the logical drive if bad data is found verify verifies the maxCache Container redundancy without repairing bad data Examples ARCCONF TASK START 1 LOGICALDRIVE 1 VERIFY ARCCONF TASK START 1 DEVICE 0 0 INITIALIZE ARCCONF TASK START MAXCACHE COHERENCYCHECK ONCE arcconf uninit Description Uninitializes one or more physical drives so that they can be used in HBA mode...

Page 44: ... Ready state nologs Suppresses log output for the command Examples ARCCONF UNINIT 1 0 12 0 13 ARCCONF 1 ALL 44 Proprietary and Confidential to PMC Sierra Inc Document No CDP 00276 01 A Rev A Issue Adaptec RAID Controller Command Line Utility User s Guide ...

Page 45: ...a Inc 1380 Bordeaux Drive Sunnyvale CA 94089 USA Copyright PMC Sierra Inc 2012 All rights reserved Adaptec and the Adaptec by PMC logo are trademarks of PMC Sierra Inc Part Number CDP 00276 01 A Rev A JPB 03 11 ...