Expanding an MDisk in a distributed array

For systems that support distributed arrays, you can use the management GUI or the expandarray command to increase the number of drives in an array by including new drives into the array.

You can expand distributed arrays to increase the available capacity of the array or add usable capacity. As part of the expansion, the system automatically migrates data for optimal performance for the new expanded configuration. Expansion of distributed arrays support incremental growth of available capacity for arrays and are compatible with other functions, such as IBM® Easy Tier® and data migrations.

Note: Array expansion can affect host performance and latency. Do not expand an array when the array has over 50% load. If you do not reduce host I/O load, the amount of time that is needed to complete the expansion increases greatly.

Note: When you expand a thin-provisioned NVMe array, the physical capacity is not immediately available, and the availability of new physical capacity does not track with logical expansion progress.

Using the management GUI

To expand a distributed array, complete these steps:

In the management GUI, select Pools > MDisks by Pools.
Expand the pool and right-click an MDisk within a distributed array and select Expand....
Select the drive class that is compatible with the drives in the original MDisk and enter the number of drives to expand the array. During a single expand operation, you can add up to 12 drives. The total number of SAS drives within a single array cannot exceed 128 drives. For NVMe-attached drives, the maximum number of drives in a single array cannot exceed 24 drives.
Expand Advanced Settings to view the number of additional spare drives that is recommended for the new configuration.
Click Expand. After starting the expand operation, you can monitor the progress of the expansion by selecting Monitoring > Background Tasks.
Note: The Progress Remaining value represents the expected time of completion for the data migrations that are required during the expansion of the array. The Progress Remaining value can be empty during processing when data migrations are not required or have not started. In these cases, use the percentage value in the Progress column or the value displayed in the Additional Capacity Remaining field to estimate completion of the expansion.

Using the command-line interface

To expand a distributed array, complete these steps:

To expand a distributed array, enter the following command:
```
svctask expandarray -totaldrivecount <total_drive_count> -driveclass <drive_class_id> -totalrebuildareas <mdisk_id_or_name>
       
```
The <total_drive_count> value is the resulting total number of drives after expansion is completed, including any drives that are added as rebuild areas. During a single expand operation, you can add up to 12 drives. The total number of SAS-attached drives within a single array cannot exceed 128. For NVMe-attached drives, the maximum number of drives in a single array cannot exceed 24 drives. Include <drive_class_id> to identify the compatible drive class for the array and the name or identifier of the MDisk that you are expanding
To monitor progress of the array expansion, enter the following command:
```
svcinfo lsarrayexpansionprogress <mdisk_id_or_name>
```
Where <mdisk_id_or_name> is either the name or identifier of the MDisk. In the results that display, the value in the estimated_completion_time parameter represents the expected time of completion for the data migrations that are required during the expansion of the array. The estimated_completion_time parameter can be empty during processing when data migrations are not required or have not started. In these cases, use the percentage value in the progress parameter or the value displayed in the additional_capacity_remaining parameter to estimate completion of the expansion.