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

Read syntax diagramSkip visual syntax diagram charraymember -member member_id -balanced-newdrivenew_drive_id-immediate-unbalanced mdisk_idmdisk_name

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