rmpartition

Use the rmpartition command to remove a partition.

Syntax

Parameters

-name partition_name | partition_id

(Required) Specifies the name of the partition to be removed.

-deletenonpreferredmanagementobjects

(Optional) Specified to remove the objects associated with the partition on the non-preferred management system. If the partition has a replication policy and associated objects, then the rmpartition command requires the -deletenonpreferredmanagementobjects or -deletepreferredmanagementobjectsone flag to succeed. Otherwise, the command will fail.

If the -deletenonpreferredmanagementobjects flag is specified, the command is only allowed on the active management system, and requires that the active management system is the same as the preferred management system. Objects associated with the partition on the non-preferred management system will be removed. The associated objects will remain on the preferred management system but will no longer be associated with the partition or the replication policy that was assigned to the partition.

The command fails if the -deletenonpreferredmanagementobjects parameter is specified for a partition that cannot be managed at the preferred management system, or if the partition has no replication policy.

Note: This parameter is mutually exclusive with -deletepreferredmanagementobjects parameter.

-deletepreferredmanagementobject

(Optional) Specified to remove the objects associated with the partition on the preferred management system.

If the partition has a replication policy and associated objects, then the rmpartition command requires -deletenonpreferredmanagementobjects or -deletepreferredmanagementobjectsone flag to succeed otherwise the command will fail.

If the partition cannot be managed at the preferred management system then use -deletepreferredmanagementobjects parameter to remove the partition and unassign the replication policy. This will remove the partition and associated objects at the preferred management system.

The command will fail if -deletepreferredmanagementobjects is specified for a partition that cannot be managed at the non-preferred management system, or if the partition has no replication policy.

Note: This parameter is mutually exclusive with -deletenonpreferredmanagementobjects parameter.

Description

Removing a partition does not delete the objects in the partition. If a replication policy is assigned then there will be a copy of the objects in each of the locations associated with the policy, and one of the optional flags -deletenonpreferredmanagementobjects or -deletepreferredmanagementobjects are required. The optional flag -deletenonpreferredmanagementobjects or -deletepreferredmanagementobjects is required to track the location to remove the associated objects from both the locations. These flags are not permitted if the partition does not have a replication policy.

Note: You cannot use this command to remove a partition that contains a vCenter. Use the rmvcenter command to remove both the vCenter and the partition.

Note:

A storage partition cannot be removed if it contains DR replicated volume groups.

A storage partition can be removed if it contains a DR replication policy. When a storage partition is removed any DR replication policy in the storage partition will also be removed.

If an IP address is assigned to the partition, the IP address and associated management portset will be removed from the system when the partition is removed.

Note: This command is available during the upgrade process.

An invocation example

The following example removes a partition with no replication policy:

rmpartition mypartition1

The resulting output:

No Feedback