The rmmdisk command deletes a managed disk (MDisk) from a managed disk group.
Syntax
>>- svctask -- -- rmmdisk -- -----------------------------------> >-- -mdisk --+- mdisk_id_list ---+-- --+----------+-- ----------> '- mdisk_name_list -' '- -force -' >--+- mdisk_group_id ---+-------------------------------------->< '- mdisk_group_name -'
Parameters
- -mdisk mdisk_id_list | mdisk_name_list
- (Required) Specifies one or more managed disk IDs or names to delete from the group.
- -force
- (Optional) Migrates data on the specified disks to other disks in the group. The command completes asynchronously if -force is specified.
- mdisk_group_id | mdisk_group_name
- (Required) Specifies the ID or name of the managed disk group to delete the disks from. The warning threshold for an MDisk group is automatically scaled when MDisks are deleted.
Description
This command attempts to remove the managed disk or disks from the group.
Deleting a managed disk from a group can only be done if the managed disk does not contain any extents in use by a virtual disk. If there are extents in use and you do not supply the force flag, the command fails.
If the disk has been deliberately removed, the only method of removing the MDisk is to remove the entire group itself.
Ensure that you do not destroy any controller LUNs until you have deleted them from the MDisk group that they belong to.
The rmmdisk command fails if there are insufficient free extents on other disks in the mdisk group for the duration of the command. To avoid this problem, do not issue new commands that use extents until rmmdisk processing is completed.
If you do specify the force flag, an attempt will be made to migrate the extents that are in use onto other free extents within the group. If there are not enough free extents in the group, the command will fail even if the force flag is specified.
- You can delete the virtual disk that is using the extents specified on the managed disk.
- You can add more managed disks to the group, rerun the command and specify the -force parameter.
When data is being migrated from the managed disk, it might take some time for the command to complete. The command itself will return with a success code, notifying you that migration is in progress. An event is logged when the migration is complete and the disk is deleted from the group at this time. You can also check the progress of any active migrations by running the svcinfo lsmigrate command.
If the -force parameter is used, the rmmdisk command fails if the target or source VDisk is offline, or if there is insufficient quorum-disk space to store the metadata. Correct the offline or quorum disk condition and try reissuing the command.
An invocation example
svctask rmmdisk -mdisk mdisk12 -force Group3
The resulting output
No feedback