addhostclustermember
Use the addhostclustermember command to add a host object to a host cluster.
Syntax
Parameters
- -host host_id_list | host_name_list
- (Required) Specifies the host (by ID or name) to add to the host cluster.
- hostcluster_id | hostcluster_name| hostcluster_uuid
- (Required) Specifies (by ID or name or by UUID) 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
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 adds host 0 to host cluster
4
addhostclustermember -host 0 4The resulting output:
No feedback