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
-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. (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.
Table 1 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