addhostclustermember

Use the addhostclustermember command to add a host object to a host cluster.

Syntax

addhostclustermember -host { host_id_list | host_name_list } { hostcluster_id | hostcluster_name }

Parameters

-hosthost_id_list | host_name_list
(Optional) Specifies the host (by ID or name) to add to the host cluster.
hostcluster_id | hostcluster_name
(Required) Specifies (by ID or name) the host cluster that the host object is added to. The value for the ID must be a number and the value for the name must be an alphanumeric string.

Description

This command adds a host object to a host cluster.

When you add a host object to a host cluster, shared mappings are created. For example, if any host mappings match a host cluster mapping that is part of the same volume on the same Small Computer System Interface (SCSI) logical unit number (LUN) - with the same I/O groups - the host cluster assumes control of the mapping (which makes it a shared mapping).
Note: A host cannot be added to a host cluster if both have their individual throttling specifications defined. However, if either the host or host cluster throttling specification is present, the command succeeds.
Any mappings that do not match the shared host cluster mappings are managed by the host as private mappings.
Note: New mappings must not conflict with a shared mapping on a host system. The command fails when there are shared mappings that conflict with the host's private mappings. This includes either:
  • A volume that is being mapped - but with different SCSI LUNs
  • The host that has a different volume mapped but with the same SCSI LUN as a shared mapping of the host cluster

An invocation example that adds host 0 to host cluster 4

addhostclustermember -host 0 4

The resulting output:

No feedback

An invocation example that adds hosts 0, 1, and 4 to host cluster 4

addhostclustermember -host 0:1:4 4

The resulting output:

No feedback