mkhostcluster

Use the mkhostcluster command to create a host cluster object.

Syntax

Read syntax diagramSkip visual syntax diagram mkhostcluster -namename-seedfromhosthost_id_listhost_name_listhost_uuid_list-ignoreseedvolumevolume_id_listvolume_name_list-partitionpartition_namepartition_idpartition_uuid-draftpartitionpartition_namepartition_idpartition_uuid-ownershipgroupowner_id | owner_name-noownershipgroup-uniformconnectivityyesno

Parameters

-name name
(Optional) Specifies the name of the host cluster object.
-seedfromhost host_id_list | host_name_list| host_uuid_list
(Optional) Adds the specified host to the host cluster. The host cluster mappings to existing volumes then become shared host cluster mappings. If a list of hosts is provided, the hosts are mapped to the same volume that uses the same I/O group and with the same SCSI LUN.
Note: These become shared mappings unless explicitly excluded with -ignoreseedvolume.
-ignoreseedvolume volume_id_list | volume_name_list
(Optional) Specifies volumes that are not part of the shared host cluster mappings. These volumes remain privately mapped to the host or hosts. You must specify -seedfromhost if you specify this parameter.
-ownershipgroup owner_id | owner_name
(Optional) Specifies the name or ID of the ownership group to which the object is being added.
-partition
(Optional) Specifies the name or ID of the partition in which the host cluster is to be created.
-draftpartition
(Optional) Specifies the name or ID of the draft partition in which the host cluster is to be created.
-uniformconnectivity yes | no
(Optional) Specifies if hosts in the host cluster are expected to have connectivity to both locations for a highly available storage partition. If -uniformconnectivity parameter is set to no, the host cluster will report an Online status when each host in that host cluster is only logged in to the system that matches the location set for that host.

Description

This command is used to create a host cluster object.

Note: This command fails if any of the specified seeding hosts has an associated host throttle.
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 creates host cluster myhostcluster and obtains its mappings from host myhost1

mkhostcluster -name myhostcluster -seedfromhost myhost1

The detailed resulting output:

Host cluster, id [2], successfully created.