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 -member member_id { -balanced | -newdrive new_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. (This occurs
whether or not the -immediate parameter is specified.)
- 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; this 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 to swap a member of a RAID array with
that of another drive.
Specify
-balanced and the system examines the mirrored pair containing 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-focussed this command only operates locally
to the member being operated on in terms of interacting with the new chain balanced
goal.
charraymember combination options 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 will fail 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 will fail 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.
- This is only permitted when the array is degraded and the member is empty.
- This means -immediate is mute, 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