rmhostcluster

Use the rmhostcluster command to remove a host cluster.

Syntax

Read syntax diagramSkip visual syntax diagram rmhostcluster -removeallhosts-force-removemappings-keepmappings hostcluster_idhostcluster_name

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
(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.

An invocation example that removes host cluster hostcluster0 and any related hosts

rmhostcluster -removeallhosts hostcluster0

The detailed resulting output:

No feedback