Adaptec arcconf CLI Commands
Adaptec RAID Controller can be managed from the command line using the arcconf CLI. This article shows which arcconf commands are available and how some important commands can be used.
arcconf commands in general
The following list shows the available commands of arcconf version 3.03:
$ sudo ./arcconf Controllers found: 1 | UCLI | Microsemi Adaptec uniform command line interface | UCLI | Version 3.03.00 (23668) | UCLI | (C) Microsemi Corporation 2003-2019 | UCLI | All Rights Reserved ATAPASSWORD | setting password on a physical drive CONSISTENCYCHECK | toggles the controller background consistency check mode CREATE | creates a logical device DELETE | deletes one or more logical devices EXPANDERLIST | lists the expanders connected to the controller EXPANDERUPGRADE | updates expander firmware GETCONFIG | prints controller information GETLOGS | gets controller log information GETSMARTSTATS | gets the SMART statistics GETSTATUS | displays the status of running tasks GETVERSION | prints version information for all controllers IDENTIFY | blinks LEDS on device(s) connected to a controller IMAGEUPDATE | update physical device firmware KEY | installs a Feature Key onto a controller LIST | lists all controllers connected to the system MODIFY | performs RAID Level Migration or Online Capacity Expansion PHYERRORLOG | displays PHY error logs for controller or device or an expander PHY PLAYCONFIG | apply the configurations on controller(s) from input XML RESCAN | checks for new or removed drives RESETSTATISTICSCOUNTERS | resets the controller statistics counters ROMUPDATE | updates controller firmware SAVECONFIG | saves the controller(s) information XML file SAVESUPPORTARCHIVE | saves the support archive SETARRAYPARAM | sets the parameters of an array SETBOOT | marks a device bootable SETCACHE | adjusts physical or logical device cache mode SETCONFIG | restores the default configuration SETCONNECTORMODE | changes connector mode settings SETCONTROLLERMODE | changes Controller mode settings SETCONTROLLERPARAM | sets the parameters of the controller SETMAXCACHE | adjusts maxCache settings for physical or logical device SETNAME | renames a logical device given its logical device number SETPERFORM | changes adapter settings based on application SETPOWER | power settings for controller or logical device SETPRIORITY | changes specific or global task priority SETSTATE | manually sets the state of a physical or logical device SETSTATSDATACOLLECTION | toggles the controller statistics data collection modes SLOTCONFIG | lists devices attached to each Slot in an Enclosure SMP | sends SMP Commands to Expander SPLITMIRROR | manages splitting and backup of a mirror TASK | performs a task which is applicable on a physical or logical device UNINIT | manually uninitializes the physical devices which are raw or ready
arcconf romupdate
With arcconf romupdate the firmware of a RAID controller can be updated, e.g.:
arcconf romupdate [CONTROLLERNUMMER] [ROMFILE]
arcconf create
With arcconf create you can create for example Logical Drives:
$ sudo ./arcconf CREATE Controllers found: 1 Usage: CREATE <Controller#> LOGICALDRIVE [Options] <Size> <RAID#> <Channel# ID#> [Channel# ID#] ... [noprompt] [nologs] Usage: CREATE <Controller#> LOGICALDRIVE [Options] <Size> <RAID#> ARRAY <Array#>[noprompt] [nologs] Usage: CREATE <Controller#> MAXCACHE [options] DataLD <LogicalDrive#> <Size> <RAID#> <Channel# ID#> [Channel# ID#] ... [noprompt] [nologs] Usage: CREATE <Controller#> MAXCACHE [Options] DataLD <LogicalDrive#> <Size> <RAID#> ARRAY <Array#>[noprompt] [nologs] Usage: CREATE <Controller#> RAIDZEROARRAY <Channel# ID#> [Channel# ID#] ... [noprompt] [nologs] Usage: CREATE <Controller#> RAIDZEROARRAY ALL [noprompt] [nologs] Example: CREATE 1 LOGICALDRIVE stripesize 1024 0 0 0 0 1 Example: CREATE 1 LOGICALDRIVE 1024 1 ARRAY 0 Example: CREATE 1 LOGICALDRIVE stripesize 16 method build MAX 5 0 0 0 1 0 2 Example: CREATE 1 MAXCACHE Wcache WB cachelinesize 64 datald 0 17000 1 0 0 0 1 Example: CREATE 1 MAXCACHE datald 0 17000 0 ARRAY 0 Example: CREATE 1 RAIDZEROARRAY 0 0 0 1 0 2 Example: CREATE 1 RAIDZEROARRAY ALL =================================================================================== Create a new logical device Options: Additional creation specifiers. Stripesize <STRIPE>: Optional parameter for specifying a stripe size. STRIPE is specified in kilobytes. 16, 32, 64, 128*, 256, 512 and 1024 are supported. Legs <LEG>: Optional parameter for specifying number of sub-logical devices. LEG is the number of sub-logical devices for RAID level 50 or 60. Default value is 2. Name <NAME>: Optional parameter for specifying the name of the logical device. Some controllers do not support this parameter. Method <METHOD>: Initialization method for the logical device. Valid options include: BUILD and DEFAULT. Wcache <WCACHE>: Write Cache setting for the logical device. Applicable only with maxCache creation. Valid options are: WT, WB WT: write-through (Disabled) WB: write-back (Enabled) LDcache <LDCACHE>: Cache setting for the logical device. Valid options are: LON and LOFF SSDOverProvisioningOptimization <enable | disable>: Specifies to initialize solid state drives that support rapid parity initialization feature. CacheLineSize <CACHELINESIZE>: Specifies the cache line size(KB) for maxCache. Adjusting cache line size can impact maxCache performance and maximum size supported. Larger cache line size can support larger maxCache size. Default value for this parameter is 64. Valid options can be 64, 128 and 256 based on controller support.. DataLD <LogicalDrive#>: Specifies the existing data logical device number to associate with the newly created cache logical device. Size: Size of the logical device in megabytes. Use MAX to set size to all remaining available space. Use MAXMBR to set the size to 2TB. Raid#: Raid level for the new logical device. 0, 1, 1ADM, 10, 10ADM, 5, 6, 50 and 60 are supported. Channel# ID#: A list of space-delimited channel number and device number pairs for each device to add to the logical device. ARRAY <Array#>: The Array number on which the logical device needs to be created. RAIDZEROARRAY: Create arrays from list of physical device(s) specified. Each array will contain exactly one physical device and one RAID 0 logical device. Default values will be applied for all logical device(s) created. ALL: Create arrays form list of physical device(s) connected to controller. noprompt: Don't prompt for confirmation. * default parameter in MOST circumstances
arcconf getconfig
With arcconf getconfig extensive information about the RAID controller as well as the configured RAID arrays and logical drives can be retrieved:
tk@x11dpi:~$ sudo ./arcconf GETCONFIG 1 Controllers found: 1 ---------------------------------------------------------------------- Controller information ---------------------------------------------------------------------- Controller Status : Optimal Controller Mode : RAID (Hide RAW) Channel description : SCSI Controller Model : Adaptec SmartRAID 3152-8i Controller Serial Number : 8A26F3000CF Controller World Wide Name : 50000D1E001A8110 Physical Slot : 6 Temperature : 40 C/ 104 F (Normal) Host bus type : PCIe 3.0 Host bus speed : 7880 MBps Host bus link width : 8 bit(s)/link(s) PCI Address (Bus:Device:Function) : 0:af:0:0 Number of Ports : 2 Internal Port Count : 2 External Port Count : 0 Defunct disk drive count : 0 NCQ status : Enabled Queue Depth : Automatic Monitor and Performance Delay : 60 minutes Elevator Sort : Enabled Degraded Mode Performance Optimization : Disabled Latency : Disabled Statistics data collection mode : Disabled Post Prompt Timeout : 0 seconds Boot Controller : False Primary Boot Volume : None Secondary Boot Volume : None Driver Name : smartpqi Driver Supports SSD I/O Bypass : Yes Manufacturing Part Number : Not Applicable Manufacturing Spare Part Number : Not Applicable Manufacturing Wellness Log : Not Applicable NVRAM Checksum Status : Passed Sanitize Lock Setting : None -------------------------------------------------------- Power Settings -------------------------------------------------------- Power Consumption : 6460 milliWatts Current Power Mode : Maximum Performance Pending Power Mode : Not Applicable Survival Mode : Enabled -------------------------------------------------------- I2C Settings -------------------------------------------------------- I2C Address : 0xDE I2C Clock Speed : 400 KHZ I2C Clock Stretching : Enabled -------------------------------------------------------- Cache Properties -------------------------------------------------------- Cache Status : Not Configured Cache Serial Number : Not Applicable Cache memory : 1808 MB Read Cache Percentage : 100 percent Write Cache Percentage : 0 percent No-Battery Write Cache : Disabled Wait for Cache Room : Disabled Write Cache Bypass Threshold Size : 1040 KB -------------------------------------------------------- Green Backup Information -------------------------------------------------------- Backup Power Status : Ok Battery/Capacitor Pack Count : 1 Hardware Error : No Error -------------------------------------------------------- Physical Drive Write Cache Policy Information -------------------------------------------------------- Configured Drives : Default Unconfigured Drives : Default HBA Drives : Default -------------------------------------------------------- maxCache Properties -------------------------------------------------------- maxCache Version : 4 maxCache RAID5 WriteBack Enabled : Enabled -------------------------------------------------------- RAID Properties -------------------------------------------------------- Logical devices/Failed/Degraded : 1/0/0 Spare Activation Mode : Disabled Background consistency check : Idle Consistency Check Delay : 3 seconds Parallel Consistency Check Supported : Enabled Parallel Consistency Check Count : 1 Inconsistency Repair Policy : Disabled Consistency Check Inconsistency Notify : Disabled Rebuild Priority : High Expand Priority : Medium -------------------------------------------------------- Controller Version Information -------------------------------------------------------- Firmware : 2.62[0] Driver : Linux 1.2.4-070 Hardware Revision : B -------------------------------------------------------- Temperature Sensors Information -------------------------------------------------------- Sensor ID : 0 Current Value : 30 deg C Max Value Since Powered On : 35 deg C Location : Inlet Ambient Sensor ID : 1 Current Value : 40 deg C Max Value Since Powered On : 41 deg C Location : ASIC Sensor ID : 2 Current Value : 33 deg C Max Value Since Powered On : 38 deg C Location : Top Sensor ID : 3 Current Value : 35 deg C Max Value Since Powered On : 40 deg C Location : Bottom -------------------------------------------------------- Connector information -------------------------------------------------------- Connector #0 Connector Name : CN0 Functional Mode : RAID (Hide RAW) Connector Location : Internal SAS Address : 50000D1E001A8110 Connector #1 Connector Name : CN1 Functional Mode : RAID (Hide RAW) Connector Location : Internal SAS Address : 50000D1E001A8114 ---------------------------------------------------------------------- Array Information ---------------------------------------------------------------------- Array Number 0 Name : A Status : Ok Interface : SATA SSD Total Size : 305276 MB Unused Size : 3 MB Block Size : 512 Bytes Array Utilization : 100.00% Used, 0.00% Unused Type : Data Transformation Status : Not Applicable Spare Rebuild Mode : Dedicated SSD I/O Bypass : Enabled -------------------------------------------------------- Array Logical Device Information -------------------------------------------------------- Logical 0 : Optimal (5, Data, 228858 MB) Logical Drive 1 -------------------------------------------------------- Array Physical Device Information -------------------------------------------------------- Device 0 : Present (76319MB, SATA, SSD, Channel:0, Device:0) BTWL326004NP080KGN Device 1 : Present (76319MB, SATA, SSD, Channel:0, Device:1) CVWL411400W1080KGN Device 2 : Present (76319MB, SATA, SSD, Channel:0, Device:2) CVWL411401LW080KGN Device 3 : Present (76319MB, SATA, SSD, Channel:0, Device:3) BTWL326403PS080KGN ---------------------------------------------------------------------- Logical device information ---------------------------------------------------------------------- Logical Device number 0 Logical Device name : Logical Drive 1 Disk Name : /dev/sda Block Size of member drives : 512 Bytes Array : 0 RAID level : 5 Status of Logical Device : Optimal Parity Initialization Status : Completed Size : 228858 MB Stripe-unit size : 256 KB Full Stripe Size : 768 KB Interface Type : SATA SSD Device Type : Data Boot Type : None Heads : 255 Sectors Per Track : 32 Cylinders : 57439 Caching : Disabled Mount Points : / 228344 MB Partition Number 2 /boot/efi 512 MB Partition Number 1 LD Acceleration Method : SSD IO Bypass Volume Unique Identifier : 600508B1001C2719FE34EA7308BB236E -------------------------------------------------------- Array Physical Device Information -------------------------------------------------------- Device 0 : Present (76319MB, SATA, SSD, Channel:0, Device:0) BTWL326004NP080KGN Device 1 : Present (76319MB, SATA, SSD, Channel:0, Device:1) CVWL411400W1080KGN Device 2 : Present (76319MB, SATA, SSD, Channel:0, Device:2) CVWL411401LW080KGN Device 3 : Present (76319MB, SATA, SSD, Channel:0, Device:3) BTWL326403PS080KGN ---------------------------------------------------------------------- Physical Device information ---------------------------------------------------------------------- Channel #0: Device #0 Device is a Hard drive State : Online Drive has stale RIS data : False Block Size : 512 Bytes Physical Block Size : 512 Bytes Transfer Speed : SATA 6.0 Gb/s Reported Channel,Device(T:L) : 0,0(0:0) Reported Location : Enclosure Direct Attached, Slot 0(Connector 0:CN0) Array : 0 Vendor : ATA Model : INTEL SSDSC2BB08 Firmware : D2010355 Serial number : BTWL326004NP080KGN World-wide name : 30000D1E001A8110 Reserved Size : 32768 KB Used Size : 76287 MB Unused Size : 0 MB Total Size : 76319 MB S.M.A.R.T. : No S.M.A.R.T. warnings : 0 SSD : Yes NCQ supported : Supported NCQ status : Enabled Boot Type : None Current Temperature : 23 deg C Maximum Temperature : 33 deg C Threshold Temperature : 70 deg C PHY Count : 1 Drive Configuration Type : Data Drive Encryption Capability : None Drive Encryption Status : Not Applicable Drive Exposed to OS : False Sanitize Erase Support : True Sanitize Lock Freeze Support : True Sanitize Lock Anti-Freeze Support : False Sanitize Lock Setting : None Usage Remaining : 85 percent Estimated Life Remaining : 477 SSD Smart Trip Wearout : False 56 Day Warning Present : False Drive Unique ID : 65BDF03610F9EA54 Last Failure Reason : No Failure ---------------------------------------------------------------- Device Phy Information ---------------------------------------------------------------- Phy #0 Negotiated Physical Link Rate : 6 Gbps Negotiated Logical Link Rate : 6 Gbps Maximum Link Rate : 6 Gbps ---------------------------------------------------------------- Device Error Counters ---------------------------------------------------------------- Aborted Commands : 0 Bad Target Errors : 0 Ecc Recovered Read Errors : 0 Failed Read Recovers : 0 Failed Write Recovers : 0 Format Errors : 0 Hardware Errors : 0 Hard Read Errors : 0 Hard Write Errors : 0 Hot Plug Count : 0 Media Failures : 0 Not Ready Errors : 0 Other Time Out Errors : 0 Predictive Failures : 0 Retry Recovered Read Errors : 0 Retry Recovered Write Errors : 0 Scsi Bus Faults : 0 Sectors Reads : 146752015 Sectors Written : 19244830 Service Hours : 5 Device #1 Device is a Hard drive State : Online Drive has stale RIS data : False Block Size : 512 Bytes Physical Block Size : 4K Bytes Transfer Speed : SATA 6.0 Gb/s Reported Channel,Device(T:L) : 0,1(1:0) Reported Location : Enclosure Direct Attached, Slot 1(Connector 0:CN0) Array : 0 Vendor : ATA Model : INTEL SSDSC2BB08 Firmware : D2010370 Serial number : CVWL411400W1080KGN World-wide name : 30000D1E001A8112 Reserved Size : 32768 KB Used Size : 76287 MB Unused Size : 0 MB Total Size : 76319 MB S.M.A.R.T. : No S.M.A.R.T. warnings : 0 SSD : Yes NCQ supported : Supported NCQ status : Enabled Boot Type : None Current Temperature : 24 deg C Maximum Temperature : 34 deg C Threshold Temperature : 70 deg C PHY Count : 1 Drive Configuration Type : Data Drive Encryption Capability : None Drive Encryption Status : Not Applicable Drive Exposed to OS : False Sanitize Erase Support : True Sanitize Lock Freeze Support : True Sanitize Lock Anti-Freeze Support : True Sanitize Lock Setting : None Usage Remaining : 83 percent Estimated Life Remaining : 203 SSD Smart Trip Wearout : False 56 Day Warning Present : False Drive Unique ID : B411C900D2949A6B Last Failure Reason : No Failure ---------------------------------------------------------------- Device Phy Information ---------------------------------------------------------------- Phy #0 Negotiated Physical Link Rate : 6 Gbps Negotiated Logical Link Rate : 6 Gbps Maximum Link Rate : 6 Gbps ---------------------------------------------------------------- Device Error Counters ---------------------------------------------------------------- Aborted Commands : 0 Bad Target Errors : 0 Ecc Recovered Read Errors : 0 Failed Read Recovers : 0 Failed Write Recovers : 0 Format Errors : 0 Hardware Errors : 0 Hard Read Errors : 0 Hard Write Errors : 0 Hot Plug Count : 0 Media Failures : 0 Not Ready Errors : 0 Other Time Out Errors : 0 Predictive Failures : 0 Retry Recovered Read Errors : 0 Retry Recovered Write Errors : 0 Scsi Bus Faults : 0 Sectors Reads : 146548145 Sectors Written : 19444197 Service Hours : 5 Device #2 Device is a Hard drive State : Online Drive has stale RIS data : False Block Size : 512 Bytes Physical Block Size : 4K Bytes Transfer Speed : SATA 6.0 Gb/s Reported Channel,Device(T:L) : 0,2(2:0) Reported Location : Enclosure Direct Attached, Slot 2(Connector 0:CN0) Array : 0 Vendor : ATA Model : INTEL SSDSC2BB08 Firmware : D2010370 Serial number : CVWL411401LW080KGN World-wide name : 30000D1E001A8111 Reserved Size : 32768 KB Used Size : 76287 MB Unused Size : 0 MB Total Size : 76319 MB S.M.A.R.T. : No S.M.A.R.T. warnings : 0 SSD : Yes NCQ supported : Supported NCQ status : Enabled Boot Type : None Current Temperature : 23 deg C Maximum Temperature : 34 deg C Threshold Temperature : 70 deg C PHY Count : 1 Drive Configuration Type : Data Drive Encryption Capability : None Drive Encryption Status : Not Applicable Drive Exposed to OS : False Sanitize Erase Support : True Sanitize Lock Freeze Support : True Sanitize Lock Anti-Freeze Support : True Sanitize Lock Setting : None Usage Remaining : 85 percent Estimated Life Remaining : 477 SSD Smart Trip Wearout : False 56 Day Warning Present : False Drive Unique ID : 396B5978CB399100 Last Failure Reason : No Failure ---------------------------------------------------------------- Device Phy Information ---------------------------------------------------------------- Phy #0 Negotiated Physical Link Rate : 6 Gbps Negotiated Logical Link Rate : 6 Gbps Maximum Link Rate : 6 Gbps ---------------------------------------------------------------- Device Error Counters ---------------------------------------------------------------- Aborted Commands : 0 Bad Target Errors : 0 Ecc Recovered Read Errors : 0 Failed Read Recovers : 0 Failed Write Recovers : 0 Format Errors : 0 Hardware Errors : 0 Hard Read Errors : 0 Hard Write Errors : 0 Hot Plug Count : 0 Media Failures : 0 Not Ready Errors : 0 Other Time Out Errors : 0 Predictive Failures : 0 Retry Recovered Read Errors : 0 Retry Recovered Write Errors : 0 Scsi Bus Faults : 0 Sectors Reads : 146268907 Sectors Written : 19719974 Service Hours : 5 Device #3 Device is a Hard drive State : Online Drive has stale RIS data : False Block Size : 512 Bytes Physical Block Size : 512 Bytes Transfer Speed : SATA 6.0 Gb/s Reported Channel,Device(T:L) : 0,3(3:0) Reported Location : Enclosure Direct Attached, Slot 3(Connector 0:CN0) Array : 0 Vendor : ATA Model : INTEL SSDSC2BB08 Firmware : D2010355 Serial number : BTWL326403PS080KGN World-wide name : 30000D1E001A8113 Reserved Size : 32768 KB Used Size : 76287 MB Unused Size : 0 MB Total Size : 76319 MB S.M.A.R.T. : No S.M.A.R.T. warnings : 0 SSD : Yes NCQ supported : Supported NCQ status : Enabled Boot Type : None Current Temperature : 23 deg C Maximum Temperature : 34 deg C Threshold Temperature : 70 deg C PHY Count : 1 Drive Configuration Type : Data Drive Encryption Capability : None Drive Encryption Status : Not Applicable Drive Exposed to OS : False Sanitize Erase Support : True Sanitize Lock Freeze Support : True Sanitize Lock Anti-Freeze Support : False Sanitize Lock Setting : None Usage Remaining : 88 percent Estimated Life Remaining : 608 SSD Smart Trip Wearout : False 56 Day Warning Present : False Drive Unique ID : F49D909CA0355AE4 Last Failure Reason : No Failure ---------------------------------------------------------------- Device Phy Information ---------------------------------------------------------------- Phy #0 Negotiated Physical Link Rate : 6 Gbps Negotiated Logical Link Rate : 6 Gbps Maximum Link Rate : 6 Gbps ---------------------------------------------------------------- Device Error Counters ---------------------------------------------------------------- Aborted Commands : 0 Bad Target Errors : 0 Ecc Recovered Read Errors : 0 Failed Read Recovers : 0 Failed Write Recovers : 0 Format Errors : 0 Hardware Errors : 0 Hard Read Errors : 0 Hard Write Errors : 0 Hot Plug Count : 0 Media Failures : 0 Not Ready Errors : 0 Other Time Out Errors : 0 Predictive Failures : 0 Retry Recovered Read Errors : 0 Retry Recovered Write Errors : 0 Scsi Bus Faults : 0 Sectors Reads : 146343944 Sectors Written : 19673835 Service Hours : 5 Channel #2: Device #1 Device is an Enclosure Services Device Reported Channel,Device(T:L) : 2,1(1:0) Enclosure ID : 0 Enclosure Logical Identifier : 50000D1E001A8118 Type : SES2 Vendor : Adaptec Model : Virtual SGPIO Firmware : 2.62 Status of Enclosure Services Device Speaker status : Not Available ---------------------------------------------------------------------- maxCache information ---------------------------------------------------------------------- No maxCache Array found ---------------------------------------------------------------------- Connector information ---------------------------------------------------------------------- Connector #0 Connector Name : CN0 Functional Mode : RAID (Hide RAW) Connector Location : Internal SAS Address : 50000D1E001A8110 Connector #1 Connector Name : CN1 Functional Mode : RAID (Hide RAW) Connector Location : Internal SAS Address : 50000D1E001A8114 Command completed successfully.
Further information
- Microsemi Smart Storage Controllers User's Guide ARCCONF Command Line Utility (v3.03) (download.adaptec.com, PDF)
Author: Werner Fischer Werner Fischer, working in the Knowledge Transfer team at Thomas-Krenn, completed his studies of Computer and Media Security at FH Hagenberg in Austria. He is a regular speaker at many conferences like LinuxTag, OSMC, OSDC, LinuxCon, and author for various IT magazines. In his spare time he enjoys playing the piano and training for a good result at the annual Linz marathon relay.
|