Use the charraymember command to modify an array member's
attributes, or to swap (exchange) a member of a RAID array with that of another drive.
Syntax
charraymember -membermember_id { -balanced | -newdrivenew_drive_id | [ -immediate ] | [ -unbalanced ] } { mdisk_id | mdisk_name }
Parameters
- -membermember_id
- Identifies the array member index.
- -balanced
- (Optional) Forces the array member spare goals to be set to the:
- Present array member goals
- Existing exchange goals
- The newDrive goals
Note: If -balanced is specified and the goal of the associated array
MDisk changes, the tier of the array MDisk is updated to match the new goal.
- -newdrivenew_drive_id
- (Optional) Identifies the drive to add to the array.
For distributed arrays:
- If the -newdrive parameter is specified with the
-immediate parameter, and the member is not associated with a rebuild
area, the command begins a distributed rebuild to a rebuild area in such a way that a
copyback begins immediately when the rebuild finishes.
- If the -newdrive parameter is specified and the member is already
associated with a rebuild area, the array configures itself to use the new member, and
might begin a copyback. It occurs whether the -immediate parameter is
specified or not.
- If the -immediate parameter is not set and the
-newdrive parameter is set (but the array member is not allocated to
a rebuild area), the command fails. If the -balanced parameter is set,
the command fails.
- -immediate
- (Optional) Specifies that the old disk is to be immediately removed from the array, and the
new disk rebuilt. If you do not choose this option, exchange is used; it preserves redundancy
during the rebuild.
- -unbalanced
- (Optional) Forces the array member to change if the newDrive does not meet array member
goals.
- mdisk_id
- (Either the ID or the name is required) Identifies which ID array the MDisk command applies
to.
- mdisk_name
- (Either the ID or the name is required) Identifies which name array the MDisk command
applies to.
Description
This command modifies an array
member's attributes, or swaps a member of a RAID array with a member of another drive.
Specify
-balanced and the system
examines the mirrored pair that contains the member (including the new member drive's
properties). If the array is mirror-based and the new drive is:
- On the same chain as the other member of this pair, it removes the chain-balancing goal
from the array.
- Not on the same chain as the other member of this pair (and there is only one mirrored
pair) the array becomes chain-balanced.
Because
charraymember is member focused, this command operates locally
to the member being operated on in terms of interacting with the new chain balanced
goal.
This table shows the command combination options.
Table 1. charraymember combination options| Option |
Description |
|---|
| -balanced |
- Member goals are set to the properties of the existing member or exchange drive.
- The command fails if the member is not populated with a drive.
- Member goals are set to the properties of the current member drives being exchanged
into the array count as members.
- If no exchange exists, the existing member drive goals are used.
|
| -newdrive drive_id |
- The command processes the exchange, and does NOT update the member goals.
- You must specify a new drive that is an exact match for the member goals.
- The command fails if the drive is not an exact match.
|
| -newdrive drive_id -balanced |
The command processes the exchange and updates the member goals to the
properties of the new drive. |
| -newdrive drive_id -unbalanced |
- The command processes the exchange and does NOT update the member goals.
- It is only permitted when the array is degraded and the member is empty.
- It means -immediate is not needed. The exchange is always
immediate.
- Later, if drives are a sufficient member goal match, the array rebalance selects those
drives.
- A balancing exchange restarts the member goals.
|
An invocation example to swap a spare or candidate drive for a member
0 drive by using
exchange
charraymember -member 0 -newdrive 4 mdisk2
The
resulting output:
No feedback
An invocation example to swap a
spare or candidate drive for a member 1 drive and start component rebuild for
the new
member
charraymember -member 1 -newdrive 3 -immediate mdisk3
The
resulting output:
No feedback
An invocation example to swap in a spare or candidate drive for member index
2
If there is a drive present, the exchange occurs:
charraymember -member 2 -newdrive 4 mdisk4
The resulting
output:
No feedback
An invocation example to force
member 4 to change its spare goals to its associated
drive
charraymember -member 4 -balanced mdisk6
The resulting
output:
No feedback
An invocation example to force an
exchange and make the array change its goals to the new
drive
charraymember -member 3 -newdrive 9 -balanced mdisk5
The
resulting output:
No feedback
An invocation example to force an
unbalancing exchange when drive 8 does not match the
goals
charraymember -member 2 -newdrive 8 -unbalanced mdisk5
The
resulting output:
No feedback
An invocation example to force an
immediate exchange and make the array change its goals to the new
drive
charraymember -member 3 -newdrive 9 -balanced -immediate mdisk5
The
resulting output:
No feedback
An invocation example to change
member 24 for new drive 15 by using a distributed rebuild to a
rebuild
area
charraymember -member 24 -newdrive 15 -immediate 0
The
resulting output:
No feedback