rmhostcluster
Use the rmhostcluster command to remove a host cluster.
Syntax
Parameters
- -removeallhosts
- (Optional) Specifies the deletion of all hosts in the host cluster and the associated host cluster object. If any volume mappings exist to the hosts that will be deleted, the command fails unless you specify the -force parameter.
- -force
- (Optional) Specifies that hosts should be deleted even if mappings still exist to volumes.
Any mappings are deleted when the hosts are deleted.
If volume protection is enabled and the time period is not expired, the command fails even if the -force parameter is used.
- -removemappings
- (Optional) Specifies that all shared volume mappings in the host cluster are removed when the host cluster is removed. The mappings are deleted before the host cluster is deleted.
- -keepmappings
- (Optional) Specifies that hosts retain the host cluster shared volume mappings (which become private mappings) when the host cluster is removed.
- hostcluster_id | hostcluster_name| hostcluster_uuid
- (Required) Specifies the host cluster to be removed. The value for the ID must be a number and the value for the name must be an alphanumeric string.
Description
This command removes a host cluster.
Note: This command deletes the associated host cluster throttle if that host
cluster is removed.
The -removeallhosts, -keepmappings, and -removemappings parameters are mutually exclusive.
Note: This command is available during the upgrade
process.
When using the partition IP address to run this command,
consider the following:
- The user must identify objects using the name or UUID. Short IDs cannot be specified when using the partition IP address.
- Only objects belonging to the partition can be created or acted upon. When creating new objects, the -partition parameter will be auto-populated for the partition. You cannot move items out of a partition when using the partition IP address.
An invocation example that removes host cluster hostcluster0 and any
related hosts
rmhostcluster -removeallhosts hostcluster0
The detailed resulting output:
No feedback
