Use the charraymember command to modify
an array member's attributes, or to swap 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 is 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 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 using
a distributed rebuild to a rebuild area
svctask charraymember -member 24 -newdrive 15 -immediate 0
The
resulting output:
No feedback