sissasraidmgr Command

Purpose

Maintains and uses a Serial Attached SCSI (SAS) Redundant Array of Independent Disks (RAID) controller.

Syntax

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

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

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

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

sissasraidmgr -E -l adptr# [-d hdisk -o cmd_opt]

sissasraidmgr -F -z pdisk_list

sissasraidmgr -G -l hdisk# -r raid_level [ -s stripe_size (in KB) -z pdisk_list ]

sissasraidmgr -H [ -z pdisk_list ]

sissasraidmgr -I [ -z pdisk_list ]

sissasraidmgr -J -z drive_list -o cmd_opt

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

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

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

sissasraidmgr -M -l adptr# -o cmd_opt

sissasraidmgr -P -z drive_list ( pdisks | hdisks )

sissasraidmgr -Q -z pdisks } [ -o cmd_opt ]

sissasraidmgr -R -z pdisk_list

sissasraidmgr -S -l adptr# [ -o cmd_opt ]

sissasraidmgr -T -l adptr# [ -o cmd_opt ]

sissasraidmgr -T -l device# [ -o cmd_opt ]

sissasraidmgr -U -z pdisk_list

sissasraidmgr -W -l adptr# -o cmd_opt

sissasraidmgr -X -l adptr# -o cmd_opt

sissasraidmgr -Y -l hdisk#

sissasraidmgr -Z -l adptr# -o cmd_opt

Description

The sissasraidmgr command is used to create, delete, and maintain RAID arrays on a Peripheral Component Interconnect-X (PCI-X) or PCI Express (PCIe) SAS RAID controller.

Attention: See the Power Systems SAS RAID Controllers for AIX® reference guide and become familiar with the storage management concepts before you run the sissasraidmgr command.
Attention: The System Management Interface Tool (SMIT) smit sasdam fast path is the preferred method to manage a SAS RAID controller.
Attention: Service tasks require special training and must not be performed by nonservice personnel.

Flags

Item Description
-A Add a device to an existing array. The performance is not optimal when using 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 option.
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.
6
Displays supported migration RAID levels for the lname option.
7
Displays supported migration stripe size for the lname and raid_level options.
8
Displays the minimum number of migration include devices for the raid_level option.
9
Displays the maximum number of migration include devices for the raid_level option.
10
Displays minimum multiple migration include devices for the raid_level option.
11
Displays the minimum percentage of the total array capacity that is allowed in one tier for the raid_level option.
12
Displays the minimum number of devices per tier 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, 6, 10 (RAID 1+0), 5T2, 6T2, or 10T2}
-s stripe_size (in KB)
Specifies the stripe size. 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.
-E Manages HA access characteristics of a RAID array.
-l lname
The logical name of the adapter.
-d hdisk
The name of the array.
-o cmd-opt
The command options follow:
1
Displays the current and preferred HA access states.
2
Sets the preference to optimized on the lname option.
3
Sets the preference to nonoptimized on the lname option.
4
Clears preferences.
-F Formats the pdisks for recovery (format RAID formatted disks).
-z drive_list
A list of pdisks to format.
-G Migrates the RAID array to a new RAID level.
-l lname
The logical name of the array.
-r raid_level
{ 0, 5, 6, 10 (RAID 1+0), 5T2, 6T2, or 10T2}
-s stripe_size (in KB)
Specifies the stripe size. If not specified, the default (64 KB) is used.
-z pdisk_list
A list of pdisks to be included in the new array, if any.
-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.
-J Optimizes JBOD workload.
-z drive_list
A list of JBOD hdisks to optimize.
-o cmd_opt
The command options:
1
Optimizes for the I/O response time.
2
Optimizes for the I/O operation per second.
-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 logical device information for the lname option.
2
Displays only physical device information for the lname option.
3
Displays only the physical device information for the lname option that is not under an adapter in the secondary mode.
-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.
5
Displays only arrays that are candidates for migration to a new RAID level.
-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.
10
Displays only pdisks that, if prepared, would be candidates to be added to an existing array.
11
Displays only pdisks under their main path (primary or only path).
12
Displays only pdisks that are candidates for including during the migration of an existing array.
-j jbod_opt
0
Displays no JBOD hdisks. This is the default.
1
Displays all JBOD hdisks.
2
Displays only JBOD hdisks that are candidates for the Prepare option.
3
Displays all JBOD devices.
-M Maintains 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 replacement.
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.
-o cmd_opt
Command option for adapter:
0
Displays HA link status. This is the default.
1
Displays HA and AWC link status.
-S Displays the adapter link status.
-l lname
The logical name of the adapter.
-T Displays SAS path information for the adapter.
-l lname
The logical name of the adapter.
-o cmd_opt
The command option for the adapter follow:
0
Displays the summary path window. This is the default.
1
Displays all path information for all attached devices.
2
Graphically displays paths for all attached devices.
16
Displays I/O Adapter SAS addresses.
-T Displays SAS path information for the attached devices.
-l lname
The logical name of the device (pdisk or hdisk).
-o cmd_opt
The command option for the adapter follow:
0
Graphically displays path information for device.
1
Displays path information data for a selected device.
-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 deternmine 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.
4
Displays AWC preferred role information.
10
Sets the dual initiator mode to be the default.
11
Sets the dual initiator mode to the JBOD HA single path.
256
Clears HA access states.
512
Preserves HA Access states.
1024
Enables the default behavior of the IOA cache.
2048
Disables the IOA cache.
Note: The clear, preserve, enable, and disable options can be paired (ORed) with options 1, 2, or 3, or they can be used as stand-alone options.
-Y Resynchronizes array protection.
-l lname
The logical name of the array.
-Z Shows the SAS controller physical resources.
-l lname
The logical name of the adapter.
-o cmd_option
The command options follow:
0
Shows the physical location. This is the default.
1
Shows physical information.
Note: Enter the same options as the -L flag to filter the output.

Exit Status

This command returns the following exit values:
Item Description
0 The sissasraidmgr command completed the operation successfully.
>0 The sissasraidmgr 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. Displays usage information: 
    # sissasraidmgr -h
  2. Views disk array configuration on a SAS RAID controller named sissas0: 
    # sissasraidmgr -L -l sissas0 -j3
  3. Prepares JBOD drives (hdisk3 and hdisk4) for use in a disk array: 
    # sissasraidmgr -P -z 'hdisk3 hdisk4'
  4. Creates a RAID 0 array with a stripe size of 256 KB on the prepared disks (pdisk2 and pdisk5): 
    # sissasraidmgr -C -r 0 -s 256 -z 'pdisk2 pdisk5'
  5. Deletes the RAID array hdisk3 on controller sissas0: 
    # sissasraidmgr -D -l sissas0 -d hdisk3
  6. Optimizes the RAID array hdisk1 on sissas2, which is also the primary controller: 
    # sissasraidmgr -E -l sissas2 -d hdisk1 -o 2
  7. Optimizes hdisk2 on sissas3, which is the secondary controller: 
    # sissasraidmgr -E -l sissas2 -d hdisk2 -o 3
  8. Show SAS physical paths to a drive pdisk3: 
    # sissasraidmgr -T -l pdisk3 -o 1

Files

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