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