SAS3IRCU Reference for SAS3008: Inventory, IR Volumes, Spares and Boot Devices
This is a stored command reference, not a script to execute in order. The source title mentions 3008IR/IT, but the RAID-volume operations require an IR-capable controller/firmware; an IT-mode HBA does not gain RAID creation capability merely by running SAS3IRCU. Use the matching vendor package, OS and firmware guide. All controller/volume/enclosure/slot numbers are examples. Creation, deletion, activation, consistency checks and boot changes require verification of the real target; noprompt suppresses confirmation.
I. Tool Download and Usage
1. Download Tools
Open the RAID controller page on the BROADCOM website (https://www.broadcom.com/support/download-search?pg=Legacy%2BProducts&pf=Legacy%2BProducts&pn=SAS%2B9311-8i%2BHost%2BBus%2BAdapter&pa=All&po=&dk=&pl=&l=false).
Click "Management Software and Tools".
Open the management software and tools list.
Download the SAS3IRCU version supported by the actual controller, firmware and operating system; do not select a newer incompatible package merely because it is listed first.
After extraction, obtain the toolkits for different operating systems.
2. Install Tools
The installation method for the SAS3IRCU tool varies under different operating systems. This section explains only Windows, Linux, and VMware. For other operating systems, refer to the "Readme" file in the software package.
Install the SAS3IRCU tool under the Windows system.
Upload the toolkit applicable to Windows to any directory in the server operating system (e.g., C:\tmp).
Enter cmd in the Windows Run dialog box and press Enter to open the command-line tool.
Enter cd <directory where the toolkit is located> in the command line, e.g., cd C:\tmp.
The SAS3IRCU tool under Windows does not require installation; at this point, you can execute RAID controller commands.
Install the SAS3IRCU tool under the Linux system.
Transfer the matching Linux utility using an appropriate file-transfer client (e.g., PuTTY-family PSCP/PSFTP); then follow its Readme and executable-permission requirements.
Enter the directory where the SAS3IRCU tool is located in the Shell interface.
The SAS3IRCU tool under Linux does not require installation; at this point, you can execute RAID controller commands.
Install the SAS3IRCU tool under the VMware system.
Transfer the supported VMware utility package with a suitable file-transfer client; /tmp is the source’s example staging directory.
Execute the esxcli software vib install -v=/tmp/vmware-xxx-sas3ircu.vib command in the VMware command line to install the sas3ircu tool, where /tmp/vmware-xxx-sas3ircu.vib must be the full path of the sas3ircu tool file.
The installation path for sas3ircu is /opt/lsi/bin. You need to enter this directory to execute RAID controller-related commands.
II. View All Controllers
Command Function
View all controllers.
Command Format
sas3ircu list
Parameter Description
None
Usage Example
# View all controllers
domino:~# ./sas3ircu list
Avago Technologies SAS3 IR Configuration Utility.
Version 13.00.00.00 (2016.03.08)
Copyright (c) 2009-2016 Avago Technologies. All rights reserved.
Adapter Vendor Device SubSys SubSys
Index Type ID ID Pci Address Ven ID Dev ID
—– ———— —— —— —————– —— ——
0 SAS3008 1000h 97h 00h:01h:00h:00h 1000h 3090h
SAS3IRCU: Utility Completed Successfully.
III. View All Information
Command Function
View detailed information about RAID, virtual disks, and physical hard drives.
Command Format
sas3ircu controller_id display
Parameter Description
Parameter | Parameter Description | Value |
| controller_id | ID of the RAID controller | – |
Usage Example
# View detailed information about RAID, virtual disks, and physical hard drives.
When two hard drives are set as the first and second boot items respectively, the display command can retrieve relevant information, for example:
domino:~# ./sas3ircu 0 display
When a hard drive and a RAID group are set as the first and second boot items respectively, the display command can retrieve relevant information, for example:
domino:~# ./sas3ircu 0 display
IV. Create and Delete RAID
Command Function
Create and delete RAID groups.
The DELETE command shown here deletes all IR volumes on the selected controller. DELETEVOLUME in the next section instead targets one verified volume; neither is a routine prerequisite to reading status.
Command Format
sas3ircu controller_id create RAIDlevel capacity enclosure_id:slot_id name noprompt
sas3ircu controller_id delete noprompt
Parameter Description
Parameter | Parameter Description | Value |
| controller_id | ID of the RAID controller card | – |
| level | RAID group level to be configured | – |
| capacity | RAID group capacity to be configured | Can be MAX, indicating maximum RAID group capacity. |
| enclosure_id | ID of the Enclosure where the hard drive is located | – |
| slot_id | Physical hard drive slot number | – |
| name | Name of the RAID group | User-defined |
Usage Example
# Create RAID group
domino:~# ./sas3ircu 0 create RAID1 MAX 1:0 1:1 Test01 noprompt
Avago Technologies SAS3 IR Configuration Utility.
Version 13.00.00.00 (2016.03.08)
Copyright (c) 2009-2016 Avago Technologies. All rights reserved.
Please wait, may take up to a minute…
SAS3IRCU: Volume created successfully.
SAS3IRCU: Command CREATE Completed Successfully.
SAS3IRCU: Utility Completed Successfully.
# Create RAID group
domino:~# ./sas3ircu 0 create RAID1 MAX 1:2 1:3 Test01 noprompt
Avago Technologies SAS3 IR Configuration Utility.
Version 13.00.00.00 (2016.03.08)
Copyright (c) 2009-2016 Avago Technologies. All rights reserved.
Please wait, may take up to a minute…
SAS3IRCU: Volume created successfully.
SAS3IRCU: Command CREATE Completed Successfully.
SAS3IRCU: Utility Completed Successfully.
# Delete RAID group
domino:~# ./sas3ircu 0 delete noprompt
Avago Technologies SAS3 IR Configuration Utility.
Version 13.00.00.00 (2016.03.08)
Copyright (c) 2009-2016 Avago Technologies. All rights reserved.
Please wait, may take up to a minute…
SAS3IRCU: Volume deleted successfully.
SAS3IRCU: Command DELETE Completed Successfully.
SAS3IRCU: Utility Completed Successfully.
V. Delete a specified RAID group
Command Function
Delete a specified RAID group.
Command Format
sas3ircu controller_id deletevolume volume_id noprompt
Parameter Description
Parameter | Parameter Description | Value |
| controller_id | ID of the RAID controller card | – |
| volume_id | RAID group ID | – |
Usage Example
# Delete RAID group with ID 322
domino:~# ./sas3ircu 0 deletevolume 322 noprompt
Avago Technologies SAS3 IR Configuration Utility.
Version 13.00.00.00 (2016.03.08)
Copyright (c) 2009-2016 Avago Technologies. All rights reserved.
Please wait, may take up to a minute…
SAS3IRCU: Volume deleted successfully.
SAS3IRCU: Command DELETEVOLUME Completed Successfully.
SAS3IRCU: Utility Completed Successfully.
VI. Create and Delete Hot Spare Drives
Command Function
Create and delete hot spare drives.
Command Syntax
sas3ircu controller_id hotspare enclosure_id:slot_id
sas3ircu controller_id hotspare delete enclosure_id:slot_id
Parameter Description
Parameter | Parameter Description | Value |
| controller_id | ID of the RAID controller | – |
| enclosure_id | ID of the Enclosure containing the hard drive | – |
| slot_id | Physical hard drive slot number | – |
Usage Example
# Create a hot spare.
domino:~# ./sas3ircu 0 hotspare 1:2
Avago Technologies SAS3 IR Configuration Utility.
Version 13.00.00.00 (2016.03.08)
Copyright (c) 2009-2016 Avago Technologies. All rights reserved.
WARNING: Proceeding with this operation may cause data loss or data
corruption. Are you sure you want to proceed (YES/NO)?yes
WARNING: This is your last chance to abort this operation. Do you wish
to abort (YES/NO)?no
Please wait,may take up to a minute…
SAS3IRCU: Hot Spare disk created successfully.
SAS3IRCU: Command HOTSPARE Completed Successfully.
SAS3IRCU: Utility Completed Successfully.
# Delete a hot spare.
domino:~# ./sas3ircu 0 hotspare delete 1:2
Avago Technologies SAS3 IR Configuration Utility.
Version 13.00.00.00 (2016.03.08)
Copyright (c) 2009-2016 Avago Technologies. All rights reserved.
WARNING: Proceeding with this operation may cause data loss or data
corruption. Are you sure you want to proceed (YES/NO)?yes
WARNING: This is your last chance to abort this operation. Do you wish
to abort (YES/NO)?no
Please wait,may take up to a minute…
SAS3IRCU: Hot Spare disk deleted successfully.
SAS3IRCU: Command HOTSPARE Completed Successfully.
SAS3IRCU: Utility Completed Successfully.
VII. View Virtual Disk Status
Command Function
View virtual disk status.
Command Syntax
sas3ircu controller_id status
Parameter Description
Parameter | Parameter Description | Value |
| controller_id | ID of the RAID controller | – |
To view the RAID controller ID, see View All Controllers.
Usage Example
# View virtual disk status.
domino:~# ./sas3ircu 0 status
Avago Technologies SAS3 IR Configuration Utility.
Version 13.00.00.00 (2016.03.08)
Copyright (c) 2009-2016 Avago Technologies. All rights reserved.
Background command progress status for controller 0…
IR volume 1
Volume ID : 323
Current operation : Background Init
volume Status : Enabled
Volume state : Optimal
Volume wwid : 0307b565aa18c1fb
Physical disk I/Os : Not quiesced
Volume size (in sectors) : 1560545280
Number of remaining sectors : 1558128640
Percentage complete : 0.15%
IR volume 2
Volume ID : 323
Current operation : none
volume Status : Enabled
Volume state : Optimal
Volume wwid : 09fb6da3d1048925
Physical disk I/Os : Not quiesced
SAS3IRCU: Command STATUS Completed Successfully.
SAS3IRCU: Utility Completed Successfully.
VIII. Consistency Check
Command Function
Perform consistency check on specified groups.
Command Syntax
sas3ircu controller_id constchk volume_id noprompt
Parameter Description
Parameter | Parameter Description | Value |
| controller_id | ID of the RAID controller | – |
| volume_id | ID of the RAID group | – |
Usage Example
# Consistency check
domino:~# ./sas3ircu 0 constchk 322 noprompt
Avago Technologies SAS3 IR Configuration Utility.
Version 13.00.00.00 (2016.03.08)
Copyright (c) 2009-2016 Avago Technologies. All rights reserved.
SAS3IRCU: Consistency Check Operation started on IR Volume.
SAS3IRCU: Command CONSTCHK Completed Successfully.
SAS3IRCU: Utility Completed Successfully.
IX. Activate RAID Group
Command Function
The ACTIVATE example activates a supported inactive IR volume after its members/configuration have been verified. The source calls this an external configuration, but ACTIVATE is not a generic substitute for a MegaRAID foreign-configuration import or a guarantee of data recovery.
Command Syntax
sas3ircu controller_id activate volume_id
Parameter Description
Parameters | Parameter Description | Value |
| controller_id | RAID Controller ID | – |
| volume_id | ID of the RAID Group to be Activated | – |
Usage Example
# Activate the RAID group with ID 322.
domino:~# ./sas3ircu 0 activate 322
Avago Technologies SAS3 IR Configuration Utility.
Version 13.00.00.00 (2016.03.08)
Copyright (c) 2009-2016 Avago Technologies. All rights reserved.
SAS3IRCU: ACTIVATE Volume 322 Passed!
SAS3IRCU: Command ACTIVATE Completed Successfully.
SAS3IRCU: Utility Completed Successfully.
X. Turn On Hard Drive Indicator Lights
Command Function
Turn on the indicator light for a specified hard drive.
Command Format
sas3ircu controller_id locate enclosure_id:slot_id on
Parameter Description
Parameter | Parameter Description | Value |
| controller_id | RAID Controller ID | – |
| enclosure_id | ID of the Enclosure containing the Hard Drive | – |
| slot_id | Physical Hard Drive Slot Number | – |
Usage Example
# Turn on the indicator light for a specified hard drive.
domino:~# ./sas3ircu 0 locate 1:0 on
Avago Technologies SAS3 IR Configuration Utility.
Version 13.00.00.00 (2016.03.08)
Copyright (c) 2009-2016 Avago Technologies. All rights reserved.
SAS3IRCU: LOCATE command completed successfully.
SAS3IRCU: Command LOCATE Completed Successfully.
SAS3IRCU: Utility Completed Successfully.
XI. Collect and Clear RAID Group Event Logs
Export and retain required event evidence before using LOGIR clear. The bootir/bootencl commands below set the primary volume or enclosure/slot, while altbootir/altbootencl set the alternate device. These selections do not by themselves configure every BIOS/UEFI boot-order layer.
Command Function
Collect and clear RAID group event logs.
Command Format
sas3ircu controller_id logir upload name
sas3ircu controller_id logir clear
Parameter Description
Parameter | Parameter Description | Value |
| controller_id | RAID Controller ID | – |
| name | Log File Name | User-defined |
Usage Example
# Collect RAID group event logs and save to local file FW.log.
domino:~# ./sas3ircu 0 logir upload FW.log
Avago Technologies SAS3 IR Configuration Utility.
Version 13.00.00.00 (2016.03.08)
Copyright (c) 2009-2016 Avago Technologies. All rights reserved.
SAS3IRCU: LogIR command successful.
SAS3IRCU: Command LOGIR Completed Successfully.
SAS3IRCU: Utility Completed Successfully.
# Clear RAID group event logs.
domino:~# ./sas3ircu 0 logir clear
Avago Technologies SAS3 IR Configuration Utility.
Version 13.00.00.00 (2016.03.08)
Copyright (c) 2009-2016 Avago Technologies. All rights reserved.
WARNING: proceeding with this operation will erase all log information
stored in th controller. Are you sure you want to proceed (YES/NO)? yes
SAS3IRCU: LogIR command successful.
SAS3IRCU: Command LOGIR Completed Successfully.
SAS3IRCU: Utility Completed Successfully.
XII. Set Specified RAID Group as First Boot Device
Command Function
Set the specified RAID group as the first boot device
Command Format
sas3ircu controller_id bootir volume_id
Parameter Description
Parameter | Parameter Description | Value |
| controller_id | RAID Controller ID | – |
| volume_id | RAID Group ID to be set as the first boot device | – |
Usage Example
# Set the RAID group with ID 322 as the first boot device.
domino:~# ./sas3ircu 0 bootir 322
Avago Technologies SAS3 IR Configuration Utility.
Version 13.00.00.00 (2016.03.08)
Copyright (c) 2009-2016 Avago Technologies. All rights reserved.
SAS3IRCU: Command BOOTIR Completed Successfully.
SAS3IRCU: Utility Completed Successfully.
XIII. Set a specific single disk as the first boot device
Command Function
Set a specific single disk as the first boot device.
Command Format
sas3ircu controller_id bootencl enclosure_id:slot_id
Parameter Description
Parameter | Parameter Description | Value |
| controller_id | RAID Controller ID | – |
| enclosure_id | Enclosure ID where the hard disk is located | – |
| slot_id | Physical Hard Disk Slot Number | – |
Usage Example
# Set a specific single disk as the first boot device
domino:~# ./sas3ircu 0 bootencl 1:4
Avago Technologies SAS3 IR Configuration Utility.
Version 13.00.00.00 (2016.03.08)
Copyright (c) 2009-2016 Avago Technologies. All rights reserved.
SAS3IRCU: Command BOOTENCL Completed Successfully.
SAS3IRCU: Utility Completed Successfully.
XIV. Set a specific RAID group as the second boot device
Command Function
Set a specific RAID group as the second boot device.
Command Format
sas3ircu controller_id altbootir volume_id
Parameter Description
Parameter | Parameter Description | Value |
| controller_id | RAID Controller ID | – |
| volume_id | RAID Group ID to be set as the second boot device | – |
Usage Example
# Set the specified RAID group as the second boot device.
domino:~# ./sas3ircu 0 altbootir 322
Avago Technologies SAS3 IR Configuration Utility.
Version 13.00.00.00 (2016.03.08)
Copyright (c) 2009-2016 Avago Technologies. All rights reserved.
SAS3IRCU: Command ALTBOOTIR Completed Successfully.
SAS3IRCU: Utility Completed Successfully.
XV. Set a specific single disk as the second boot device
Command Function
Set a specific single disk as the second boot device.
Command Format
sas3ircu controller_id altbootencl enclosure_id:slot_id
Parameter Description
Parameter | Parameter Description | Value |
| controller_id | RAID Controller ID | – |
| enclosure_id | ID of the Enclosure where the hard drive is located | – |
| slot_id | Physical hard drive slot number | – |
Usage example
# Set a specified single drive as the second boot option.
domino:~# ./sas3ircu 0 altbootencl 1:4
Avago Technologies SAS3 IR Configuration Utility.
Version 13.00.00.00 (2016.03.08)
Copyright (c) 2009-2016 Avago Technologies. All rights reserved.
SAS3IRCU: Command BOOTENCL Completed Successfully.
SAS3IRCU: Utility Completed Successfully.