Skip to main content

We've Moved!

Product Documentation has moved to docs.hitachivantara.com
Hitachi Vantara Knowledge

Managing clusters

How to expand and shrink a cluster in a homogeneous Content Software for File system configuration.

NoteThe cluster expansion process described here is only applicable to a homogeneous Content Software for File system configuration, which is highly recommended. For non-homogeneous system configurations, contact your Hitachi representative.

Shrinking a cluster using the CLI

The procedures are described that are involved in the shrinking of a cluster and may be required when it is necessary to reallocate cluster hardware.

Options for shrinking a cluster

Cluster shrinking can involve either the removal of some of the assigned SSDs or the removal of hosts from the system. The following operations are available:

  1. Listing all the drives and their states, in order to receive a view of currently-allocated resources and their status.
  2. Deactivating drives as the first step before removing a host.
  3. Removing (a subset of) SSD drives allocated for the cluster.
  4. Deactivating hosts, which can be used after deactivating drives in preparation for the removal of the host.
  5. Removing hosts in order to complete the cluster shrinking.

Listing drives and their states using the CLI

Commandweka cluster drive

Use this command to display a list of all the drives in the cluster and their status.

Deactivating a drive using the CLI

Commandweka cluster drive deactivate

Running this command will redistribute the stored data on the remaining drives and can be performed on multiple drives.

NoteAfter running this command, the deactivated drives will still appear in the list.
NoteIt is not possible to deactivate a drive if it will lead to an unstable state, that is, if the system capacity after drive deactivation is insufficient for the SSD capacity of currently-provisioned filesystems.

Drive deactivation starts an asynchronous process known as phasing out, which is a gradual redistribution of the data between the remaining drives in the system. On completion, the phased-out drive is in an inactive state, that is, not in use by the Content Software for File system, but still appearing in the list of drives.

NoteRunning the weka cluster drive command will display whether the redistribution is still being performed.

To deactivate a drive, run the following command:

weka cluster drive deactivate <uuids>
Parameters
NameTypeValueLimitationsMandatoryDefault
uuidsComma-separated stringsComma-separated drive identifiersYes

Removing a drive using the CLI

Commandweka cluster drive remove

This command is used to completely remove a drive from the cluster. After removal, the drive will not be recoverable. To remove a drive, run the following command:

weka cluster drive remove <uuids>
Parameters
NameTypeValueLimitationsMandatoryDefault
uuidsComma-separated stringsComma-separated stringsYes

Deactivating an entire host using the CLI

Commandweka cluster host deactivate

his command is used as the first step when seeking to shrink a cluster. Running this command will automatically deactivate all the host's drives. To deactivate an entire host, run the following command:

weka cluster host deactivate <host-ids> [--allow-unavailable-host]
Parameters
NameTypeValueLimitationsMandatoryDefault
host-idsSpace-separated integersSpace-separated host identifiersYes
allow-unavailable-hostBooleanAllow deactivation of an unavailable hostIf the host returns, it will join the cluster in an active stateNoNo

Removing a host using the CLI

Commandweka cluster host remove

Running this command will eliminate the host from the cluster, that is, the host will switch to the stem mode after the removal, at which point it can be reallocated either to another cluster or purpose. To remove the host from the cluster, run the following command:

weka cluster host remove <host-id>
Parameters
NameTypeValueLimitationsMandatoryDefault
host-idComma-separated stringsComma-separated host identifiersYes