sisraidmgr Command

Purpose

Uses and maintains a Peripheral Component Interconnect-X (PCI-X) SCSI Redundant Array of Independent Disks (RAID) controller.

Syntax

sisraidmgr [ -A -l hdisk# [ -z pdisk ] [ -f ] ]

sisraidmgr [ -B -l adptr# -b ioa_opt [ -r raid_level ] ]

sisraidmgr [ -C [ -r raid_level -s stripe_size (in KB) -z pdisk_list ] ]

sisraidmgr [ -D -l adptr# [-d hdisk | -e serial_num ] ]

sisraidmgr [ -F [ -z pdisk_list ] ]

sisraidmgr [ -H [ -z pdisk_list ] ]

sisraidmgr [ -I [ -z pdisk_list ] ]

sisraidmgr [ -L -l adptr# [ -a display_opt [ -v sisarray_opt -p pdisk_opt -j jbod_opt ] ] ]

sisraidmgr [ -L -l hdisk# [ -a display_opt [ -v sisarray_opt -p pdisk_opt ] ] ]

sisraidmgr [ -L -l pdisk# [ -p pdisk_opt ] ]

sisraidmgr [ -M -l adptr# -o cmd_opt ]

sisraidmgr [ -P -z drive_list { pdisks | hdisks } ]

sisraidmgr [ -R -z pdisk_list ]

sisraidmgr [ -S -l adptr# ]

sisraidmgr [ -U -z pdisk_list ]

sisraidmgr [ -W -l adptr# -o cmd_opt ]

sisraidmgr [ -X -l adptr# -o cmd_opt]

sisraidmgr [ -Y -l hdisk# [ -x cmd_opt ]]

Description

The sisraidmgr command is used to create, delete, and maintain RAID arrays on a PCI-X SCSI RAID controller.

Attention: See the PCI-X SCSI RAID Controller Reference Guide for AIX® and become familiar with the storage management concepts before you run the sisraidmgr command.
Attention: The System Management Interface Tool (SMIT) smit pxdam fast path is the preferred method to manage a PCI-X SCSI RAID Controller.
Attention: Service tasks require special training and must not be performed by nonservice personnel.

Flags

Item Description
-A Adds a device to an existing array. The performance is not optimal when you use this option because the included device does not contain parity, and the data is not restriped.
-l lname
The logical name of the array.
-z pdisks
The drives to be included.
-f
The option to force the include operation in the situation where the disks to be included might not be known; that is, they might be 0.
-B Lists information about what the adapter supports.
-l lname
The logical name of the adapter.
-b ioa_support_opt
1
Displays supported RAID levels for the lname option. This is the default option.
2
Displays supported stripe size for the lname and raid_level options.
3
Displays the minimum number of devices for the raid_level option.
4
Displays the maximum number of devices for the raid_level option.
5
Displays the minimum multiple number of devices for the raid_level option.
-r raid_level
Shows supported stripe sizes for this RAID level.
-C Creates a RAID array.
-r raid_level
{ 0, 5, or 10 (RAID 1+0) }
-s stripe_size (in KB)
If not specified, the default (64 KB) is used.
-z pdisk_list
Lists pdisks to include in the new array. For example, 'pdisk2 pdisk3 pdisk4' must be connected to the same adapter.
-D Deletes a RAID array.
-l lname
The logical name of the adapter.
-d hdisk
The name of the array to be deleted.
-e serial_num
The serial number of the array to be deleted. Use this option only if the array name is unknown.
-F Formats the pdisks for recovery. (format 522-byte formatted disks).
-z drive_list
A list of pdisks to format.
-H Adds a hot spare device.
-z pdisk_list
A list of pdisks to be made hot spare devices.
-I Removes a hot spare device.
-z pdisk_list
A list of pdisks to be removed from being hot spare devices.
-L Lists advance function information.
-l lname
The device for which information is displayed. It can be a RAID adapter (sisioa0), a RAID array (hdisk8), or a physical disk (pdisk5).
-a display_opt
0
Displays all configuration information for the lname option. This is the default option.
1
Displays only the logical device information for the lname option.
2
Displays only the physical device information for the lname option.
-v sisarray_opt
0
Displays all arrays. This is the default.
1
Displays only arrays that are candidates for the Delete Array option.
2
Displays only arrays that are candidates for the Rsync Protection option.
3
Displays only arrays that are candidates for including additional devices.
4
Displays only ODM arrays that have no adapter information.
-p pdisk_opt
0
Displays all pdisks. This is the default.
1
Displays only pdisks that are candidates for the Prepare option.
2
Displays only pdisks that are candidates for the Start RAID option.
3
Displays only pdisks that are candidates for the Add Hot Spare option.
4
Displays only pdisks that are candidates for the Remove Hot Spare option.
5
Displays only pdisks that are candidates to be added to an existing array.
6
Displays only pdisks that are candidates for the Rebuild option.
7
Displays only pdisks that are candidates for the Recovery Format option.
8
Displays only ODM pdisks that have no adapter information.
9
Displays only pdisks that are candidates for the Unprepare option (522 - 512).
10
Displays only pdisks that, if prepared, would be candidates to be added to an existing array.
-j jbod_opt
0
Displays no JBOD hdisks. This is the default option.
1
Displays all JBOD hdisks.
2
Displays only JBOD hdisks that are candidates for the Prepare option (512 - 522).
-M Maintains the rechargeable battery.
-l lname
The logical name of the adapter.
-o cmd_option
The command options follow:
0
Displays rechargeable battery information.
1
Forces a rechargeable battery error.
2
Starts caching after concurrent battery replace.
3
Queries candidates for concurrently starting batteries.
-P Prepares devices; that is, creates array candidates physical disks.
-z drive_list
A list of either JBOD hdisks, pdisks, or both to become an array candidate.
-Q Sets or Clears pdisk error suppression attributes.
-z pdisk_list
A list of pdisks for attributes to be applied or cleared.
-o cmd_option
A 1-byte hexadecimal string that specifies which error suppression bits to turn on or off.
-R Rebuilds devices; that is, reconstructs a degraded array.
-z pdisk_list
A list of pdisks to be rebuilt.
-S Displays the adapter link status.
-l lname
The logical name of the adapter.
-U Creates stand-alone physical disks.
-z drive_lists
A list of pdisks to be formatted to stand-alone disks.
-W Reclaims cache storage.
-l lname
The logical name of the adapter.
-o cmd_option
The command options follow:
0
Queries to determine whether a reclaim operation is needed.
1
Queries to determine whether permission for unknown data loss is needed.
2
Performs reclaim cache storage.
3
Performs reclaim cache storage and allows unknown data loss.
-X Changes adapter assignment.
-l lname
The logical name of the adapter.
-o cmd_option
The command options follow:
0
Displays only.
1
Preferred as primary adapter.
2
No preferred operating preferences.
3
Preferred as primary adapter. This value runs the cfgmgr command.
-Y Resynchronizes array protection.
-l lname
The logical name of the array.

Exit Status

This command returns the following exit values:
Item Description
0 The sisraidmgr command completed the operation successfully.
>0 The sisraidmgr command detected an error.

Security

Privilege Control: Only the root user and members of the system group should have execute (x) access to this command.

Examples

  1. Display usage information: 
    # sisraidmgr -h
  2. Views disk array configuration on a PCI-X SCSI RAID controller named sissas0: 
    # sisraidmgr -L -l sissas0 -j3
  3. Prepares 512 byte formatted drives (hdisk3 and hdisk4) for use in a disk array: 
    # sisraidmgr -P -z 'hdisk3 hdisk4'
  4. Creates a RAID 0 array with stripe size of 256K on the prepared disks (pdisk2 and pdisk5): 
    # sisraidmgr -C -r 0 -s 256 -z 'pdisk2 pdisk5'
  5. Deletes the RAID array hdisk3 on controller sissas0: 
    # sisraidmgr -D -l sissas0 -d hdisk3

Files

Item Description
/usr/bin/sisraidmgr Contains the sisraidmgr command.