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

charraymember -membermember_id { -balanced | -newdrivenew_drive_id | [ -immediate ] | [ -unbalanced ] } { mdisk_id | mdisk_name }

Parameters

-membermember_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.
-newdrivenew_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.
-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.
Specify -balanced and the system examines the mirrored pair that contains the member (including the new member drive's properties). If the array is mirror-based and the new drive is:
  • On the same chain as the other member of this pair, it removes the chain-balancing goal from the array.
  • Not on the same chain as the other member of this pair (and there is only one mirrored pair) the array becomes chain-balanced.
Because charraymember is member focused, this command operates locally to the member being operated on in terms of interacting with the new chain balanced goal.
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