charraymember
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
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. 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.
- The -newdrive parameter is not allowed when an array expansion is in progress.
- -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.Remember: You cannot
create an array that contains an NVMe drive and another drive of a different technology type or
transport protocol. If the member is an online compressed drive, then upon completion of the
exchange, it is formatted and then becomes a candidate drive.
This
table 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 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
An invocation example to exchange a new drive in place of a failed member drive of a distributed RAID-1 array and start a rebuild in place process
charraymember -member 0 -newdrive 4 -immediate mdisk0
The resulting output:
No feedback