charraymember
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 ---------------+-- --+- mdisk_id ---+---------->< +- -newdrive --new_drive_id-+ '- mdisk_name -' +- -immediate --------------+ '- -unbalanced -------------'
Parameters
- -member member_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. - -newdrive new_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.Table 1 shows the command combination
options.
Option | Description |
---|---|
-balanced |
|
-newdrive drive_id |
|
-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 |
|
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