charraymember

Edit online

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.

Table 1. charraymember combination options
Option	Description
`-balanced`	Member goals are set to the properties of the existing member or exchange drive. The command fails 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 fails 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. It is only permitted when the array is degraded and the member is empty. It means -immediate is not needed. 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

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