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:
  • Case 1: If the -newdrive parameter is specified with the -immediate parameter, and the member is not associated with a rebuild area, the command checks if the rebuild area is sufficient.
    • Scenario 1: If the rebuild area is sufficient, the command begins a distributed rebuild to a rebuild area in such a way that a copyback begins immediately when the rebuild finishes.
    • Scenario 2: If the rebuild area is insufficient, the command initiates a rebuild on the replaced drive instead of performing a distributed rebuild.
  • Case 2: If the -newdrive parameter is specified and the member is already associated with a rebuild area, while a distributed rebuild is in progress, the command checks whether the rebuild area is sufficient.
    • Scenario 1: If rebuild area is sufficient, the array configures itself to use the new member, and might begin a copyback. It occurs whether the -immediate parameter is specified or not.
    • Scenario 2: If the rebuild area is insufficient, the command aborts the ongoing distributed rebuild and starts cleansing the rebuild area. At the same time, the command initiates a rebuild in place on the replaced drive instead of waiting for the distributed rebuild to complete and then starting copyback.
  • 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