ARCCONF Reference for Legacy PMC/Adaptec Controllers: Queries, Arrays and State Changes

I. Download and Installation of Tools

Log in to the Microsemi website to download the ARCCONF tool, including:

ClickDownload link Obtain the ARCCONF tool. Select the corresponding tool based on the system.

Click.

Download the ARCCONF tool according to the prompts.

After extraction, obtain the toolkit suitable for different operating systems.

The ARCCONF tool for the VMware system is located in the cim directory.

Tool Installation

The installation method for the ARCCONF tool varies across different operating systems. This guide uses Windows, Linux, and VMware as examples; for other operating systems, please search the Microsemi website for the ARCCONF tool user guide.

II. Installing the ARCCONF Tool on Windows Systems

Upload the toolkit applicable to Windows to any directory in the server operating system (e.g., C:\tmp).

In the Windows Run dialog box, enter cmd and press Enter to open the command-line tool.

Enter cd [directory containing the toolkit] in the command line, such as cd C:\tmp.

The ARCCONF tool on Windows does not require installation; RAID controller commands can be executed at this time.

Installing the ARCCONF Tool on Linux Systems

Use a file transfer tool (e.g., WinSCP) to upload the toolkit applicable to Linux to any directory in the server operating system, using /tmp as an example.

Execute the rpm -ivh /tmp/Arcconf-xxx.rpm command in the Linux command line to install the ARCCONF tool.

The installation path of the ARCCONF tool is /usr/Arcconf. You must enter this directory before executing RAID controller-related commands.

After installation, you can execute RAID controller commands.

Installing the ARCCONF Tool on VMware Systems

Use a file transfer tool (e.g., PuTTY) to upload the toolkit applicable to VMware to any directory in the server operating system, using /tmp as an example.

The source’s legacy VMware installation uses esxcli software vib install -v=/tmp/vmware-esx-provider-arcconf.vib with the actual full package path. It also includes a no-sig-check bypass option; do not treat bypassing package verification as a normal installation requirement. Use the vendor-supported signed package and ESXi procedure.

The installation path of ARCCONF is /opt/pmc. You must enter this directory before executing RAID controller-related commands.

II. Query Basic Information of RAID Controller

Command Function

Query basic information of the RAID controller.

Command Format

arcconf list controller_id

Parameter Description

Usage Guide

None

Usage Example

# Query attributes for controller ID 1.

[root@localhost ~]# arcconf list 1

Controllers found: 1

----------------------------------------------------------------------

Controller information

----------------------------------------------------------------------

 Controller ID : Status, Slot, Mode, Name, SerialNumber, WWN

----------------------------------------------------------------------

 Controller 1: : Optimal, Slot 1, Mixed, MSCC Adaptec SmartRAID 3152-8i, 7A45F30016A, 50000D1E00189F30

----------------------------------------------------------------------

Array Information

----------------------------------------------------------------------

 Array ID : Status (Interface, TotalSize MB, FreeSpace MB)

----------------------------------------------------------------------

 Array 0 : Ok (SATA SSD, 305152 MB, 0 MB)

----------------------------------------------------------------------

Logical device information

----------------------------------------------------------------------

 Logical ID : Status (RAID, Interface, Size MB) Name

----------------------------------------------------------------------

 Logical 0 : Optimal (0, Data, 305190 MB) LogicalDrv 0

----------------------------------------------------------------------

maxCache information

----------------------------------------------------------------------

----------------------------------------------------------------------

Physical Device information

----------------------------------------------------------------------

 Physical ID : State (Interface, BlockSize, SizeMB, Vendor, Model, Type) WWN, [Location]

----------------------------------------------------------------------

 Physical 0,0 : Online (SATA, 512 Bytes, 152627MB, ATA , INTEL SSDSA2BW16, Solid State Drive) 30000D1E00189F30, [Enclosure Direct Attached, Slot 0(Connector 0:CN0)]

 Physical 0,1 : Online (SATA, 512 Bytes, 1526185MB, ATA , SSDSC2BB016T7H , Solid State Drive) 30000D1E00189F32, [Enclosure Direct Attached, Slot 1(Connector 0:CN0)]

 Physical 0,4 : Ready (SAS, 512 Bytes, 1716957MB, TOSHIBA , AL14SEB18EQ , Hard Drive) 500003969812C842, [Enclosure Direct Attached, Slot 4(Connector 1:CN1)]

 Physical 0,5 : Ready (SAS, 512 Bytes, 858483MB, HGST , HUC101890CSS200 , Hard Drive) 5000CCA0361C09C1, [Enclosure Direct Attached, Slot 5(Connector 1:CN1)]

 Physical 0,6 : Ready (SATA, 512 Bytes, 457862MB, ATA , MTFDDAK480TDC-1A, Solid State Drive) 30000D1E00189F39, [Enclosure Direct Attached, Slot 6(Connector 1:CN1)]

 Physical 0,7 : Ready (SATA, 512 Bytes, 915715MB, ATA , MTFDDAK960TDC-1A, Solid State Drive) 30000D1E00189F3B, [Enclosure Direct Attached, Slot 7(Connector 1:CN1)]

 Physical 2,2 : Ready (SES2, Not Applicable, Not Applicable, MSCC , Virtual SGPIO, Enclosure Services Device) 50000D1E00189F30, [Not Applicable]

Command completed successfully.

III. Query Physical Hard Disk, Array, LD, maxCache, and Other Related Information

Command Function

Query basic information of the RAID controller card.

Command Format

Parameter Description

Usage Guide

None

Usage Example

# Query information for all Arrays.

[root@localhost ~]# ./arcconf getconfig 1 ar

Controllers found: 1

----------------------------------------------------------------------

Array Information

----------------------------------------------------------------------

Array Number 0

 Name : A

 Status : Ok

 Interface : SATA SSD

 Total Size : 305152 MB

 Unused Size : 204800 MB

 Block Size : 512 Bytes

 Array Utilization : 32.77% Used, 67.23% Unused

 Type : Data

 Transformation Status : Not Applicable

 Spare Rebuild Mode : Dedicated

 SSD I/O Bypass : Disabled

 --------------------------------------------------------

 Array Logical Device Information

 --------------------------------------------------------

 Logical 0 : Optimal (1, Data, 49999 MB) LogicalDrv 0

 --------------------------------------------------------

 Array Physical Device Information

 --------------------------------------------------------

 Device 0 : Present (915715MB, SATA, SSD, Channel:0, Device:0) 18031A983BCA

 Device 1 : Present (152627MB, SATA, SSD, Channel:0, Device:1) CVPR1461036N160DGN

 --------------------------------------------------------

 Array Hotspare Information

 --------------------------------------------------------

 Device 3 : Dedicated Hot-Spare (457862MB, SATA, SSD, Channel:0, Device:3) 2029E247

Command completed successfully.

[root@localhost ~]#

# Query basic information for all Logical Drives (LDs).

[root@localhost ~]# ./arcconf getconfig 1 ld

Controllers found: 1

----------------------------------------------------------------------

Logical device information

----------------------------------------------------------------------

Logical Device number 0

 Logical Device name : LogicalDrv 0

 Disk Name : /dev/sdd

 Block Size of member drives : 512 Bytes

 Array : 0

 RAID level : 1

 Status of Logical Device : Optimal

 Size : 49999 MB

 Stripe-unit size : 256 KB

 Full Stripe Size : 256 KB

 Interface Type : SATA SSD

 Device Type : Data

 Boot Type : None

 Heads : 255

 Sectors Per Track : 32

 Cylinders : 12549

 Caching : Enabled

 Mount Points : Not Applicable

 LD Acceleration Method : Controller Cache

 Volume Unique Identifier : 600508B1001C329D07A9BDA053FF081B

 --------------------------------------------------------

 Array Physical Device Information

 --------------------------------------------------------

 Device 0 : Present (915715MB, SATA, SSD, Channel:0, Device:0) 18031A983BCA

 Device 1 : Present (152627MB, SATA, SSD, Channel:0, Device:1) CVPR1461036N160DGN

 --------------------------------------------------------

 Array Hotspare Information

 --------------------------------------------------------

 Device 3 : Dedicated Hot-Spare (457862MB, SATA, SSD, Channel:0, Device:3) 2029E247

Command completed successfully.

[root@localhost ~]#

IV. Query Firmware and Driver Versions of the RAID Controller Card

Command Function

Query firmware and driver version information of the RAID controller card.

Command Format

arcconf getversion

Usage Example

# Query firmware and driver version information of the RAID controller card.

[root@localhost ~]# ./arcconf getversion

Controllers found: 1

Controller #1

==============

Firmware : 1.43[0] (0)

Driver : 0.9.14-100 (0)

Command completed successfully.

[root@localhost ~]#

V. Set RAID Controller Card Operating Mode

Command Function

Set the operating mode of the RAID controller card.

The source example uses Mixed mode. Verify the current mode and the exact controller’s supported values; Mixed is not asserted as a universal factory default.

Command Format

arcconf setcontrollermode controller_id mode

Parameter Description

Usage Guide

None

Usage Example

# Set the RAID controller card operating mode to "Mixed".

[root@localhost ~]# ./arcconf setcontrollermode 1 5

Controllers found: 1

Command completed successfully.

# Query the RAID controller card operating mode.

[root@localhost ~]# arcconf getconfig 1

Controllers found: 1

----------------------------------------------------------------------

Controller information

----------------------------------------------------------------------

Controller Status : Optimal

Controller Mode : Mixed

Channel description : SCSI

Controller Model : MSCC Adaptec SmartRAID 3152-8i

Controller Serial Number : 7A45F30016A

Controller World Wide Name : 50000D1E00189F30

Physical Slot : 1

Temperature : 48 C/ 118 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:3b: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 : ADDD8BE3B85736315B553DAF0D36B31E

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

......

The "Controller Mode" in the returned information is the operating mode of the RAID controller card.

VI. Set Hot Spare Mode

Command Function

Sets the hot spare disk mode.

Command Format

arcconf setarrayparam controller_id array_id sparetype mode

Parameter Description

Usage Example

# Set the hot spare disk mode for the Array to: Dedicated.

[root@localhost ~]# arcconf setarrayparam 1 0 sparetype 1

Controllers found: 1

Command completed successfully.

[root@localhost ~]#

VII. Set Hard Disk Locator Indicator

Command Function

Turns on or off the hard disk locator indicator light of the controller card.

Command Format

Table 15-62

Parameter Description

Usage Example

# Identify the physical device at channel0,device0; stop the interactive locator as indicated by the tool. The source caption incorrectly calls this a stop command.

[root@localhost ~]# ./arcconf identify 1 device 0 0

Controllers found: 1

Only devices managed by an enclosure processor may be identified

The specified device(s) is/are blinking.

Press any key to stop the blinking.

# Turn on the indicator lights for all drives for 60 seconds.

[root@localhost ~]# ./arcconf identify 1 all time 60

Controllers found: 1

Only devices managed by an enclosure processor may be identified

Command completed successfully.

# Turn off the indicator lights for all hard drives.

[root@localhost ~]# ./arcconf identify 1 all stop

Controllers found: 1

Command completed successfully.

VIII. Configure Hot Spare for LD

Command Function

Configure hot spare for LD.

Command Format

arcconf setstate controller_id device physical_id hsp array array_id sparetype type

Parameter Description

Usage Example

# Configure an Autoreplace hot spare for LD.

[root@localhost ~]# arcconf setstate 1 device 0 3 hsp array 0 sparetype 2

Controllers found: 1

Any existing hot-spare drives of a different sparetype will be removed.

The physical drive used for this operation is connected to Mixed Mode(Smart HBA) connector. Using it will not allow operating system to use the drive contents.

Are you sure you want to continue?

Press y, then ENTER to continue or press ENTER to abort: y

Command completed successfully.

IX. Create and Delete RAID

Command Function

Create or delete RAID.

Command Format

arcconf create controller_id logicaldrive option size level physical_id physical_id……

arcconf delete controller_id logicaldrive ld_id noprompt

Parameter Description

Table 15-63 option

Usage Guide

None

Usage Examples

# Create a RAID 50.

[root@localhost ~]# arcconf create 1 logicaldrive stripesize 256 legs 2 name vd1 method default ldcache lon MAX 50 0 0 0 1 0 2 0 3 0 4 0 5

Controllers found: 1

Space will be wasted as devices specified are of different sizes.

Do you want to add a logical device to the configuration?

Press y, then ENTER to continue or press ENTER to abort: y

Creating logical device: vd1

Command completed successfully.

# Delete the virtual disk with ID 0.

[root@localhost ~]# arcconf delete 1 logicaldrive 0 noprompt

Controllers found: 1

WARNING: Deleting this logical device will automatically delete array 0 because it is the only logical device present on that array.

All data in logical device 0 will be lost.

Deleting: logical device 0 ("Logical Drive 1")

arr

Command completed successfully.

X. Set the Read/Write Ratio for the RAID Controller

Command Function

Sets the read/write ratio for the RAID controller.

Command Format

arcconf setcache controller_id cacheratio read write

Parameter Description

The sum of the Read Cache Ratio and Write Cache Ratio must be 100.

Usage Example

# Set the Read Cache Ratio and Write Cache Ratio to 50% each.

[root@localhost ~]# arcconf setcache 1 cacheratio 50 50

Controllers found: 1

Command completed successfully.

[root@localhost ~]#

Command completed successfully.

[root@localhost ~]#

XI. Set Hard Drive and LD Status

Command Function

Sets the status of hard drives, Logical Drives (LD), and MaxCache.

Command Syntax

Parameter Description

Usage Guide

The source recommends forcing an LD to Optimal before replacement, but that is not a normal disk-replacement prerequisite. Forcing Optimal overrides failure state and may expose stale/inconsistent member data, as the original command output warns. Diagnose and follow the supported recovery/replacement procedure; do not force a degraded/failed LD healthy merely to proceed.

Usage Example

# Set the hard drive to offline.

[root@localhost ~]# arcconf setstate 1 device 0 11 ddd

Controllers found: 1

Changing state from Ready to Failed may delete any data partitions present on the drive.

Are you sure you want to continue?

Press y, then ENTER to continue or press ENTER to abort: y

Command completed successfully.

# Set the LD status to optimal.

[root@localhost ~]# arcconf setstate 1 logicaldrive 0 optimal

Controllers found: 1

Attention: Using advanced options to force a logical device online is a dangerous operation and

requires substantial knowledge of the RAID level and the nature of the logical device failure.

Even if this operation can force the logical device online,

all data on this logical device may be lost if one or more disks contain outdated data.

All available disk segments that constitute this logical device will be forced online;

the data they contain will be used as valid data.

If you are not sure, abort and contact your service representative.

Are you sure you want to continue?

Press y, then ENTER to continue or press ENTER to abort: y

Command completed successfully.

# Set the MaxCache status to optimal.

[root@localhost ~]# arcconf setstate 1 maxcache 1 optimal

Controllers found: 1

Attention: Using advanced options to force a maxCache logical device online is a dangerous operation and

requires substantial knowledge of the RAID level and the nature of the maxCache logical device failure.

Even if this operation can force the maxCache logical device online,

all data on this maxCache logical device may be lost if one or more disks contain outdated data.

All available disk segments that constitute this maxCache logical device will be forced online;

the data they contain will be used as valid data.

If you are not sure, abort and contact your service representative.

Are you sure you want to continue?

Press y, then ENTER to continue or press ENTER to abort: y

Command completed successfully.

XII. Set SSD I/O Bypass Status

Command Function

Sets the SSD I/O Bypass status.

Command Syntax

arcconf setarrayparam controller_id array_id ssdiobypass state

Parameter Description

Usage Guide

None

Usage Example

# Disable SSD I/O Bypass.

[root@localhost ~]# arcconf setarrayparam 1 2 ssdiobypass disable

Controllers found: 1

Disabling SSD I/O bypass will impact the performance of all the logical device(s) in the array. You can enable the controller caching on logical device(s) to improve performance.

Command completed successfully.

XIII. Cache Operation Without Backup Power

The source’s no-battery write-cache option removes backup-power protection; retain its original loss-on-power-failure warning. A forced status label or successful command return does not prove that data is consistent or that cache contents are protected.

Command Function

This command allows the use of the controller card cache without capacitors.

When using the controller card cache without capacitors, power loss will result in data loss. Use this command with caution.

Command Format

arcconf setcache controller_id nobatterywritecache enable

Parameter Description

Usage Example

# Set to use cache without capacitors.

[root@localhost ~]# arcconf setcache 1 nobatterywritecache enable

Controllers found: 1

WARNING : Enabling write caching on a cache module without a fully charged battery or capacitor could cause data loss in the event of a power failure.

Are you sure you want to continue?

Press y, then ENTER to continue or press ENTER to abort: y