mkvolumehostclustermap

Use the mkvolumehostclustermap command to generate a new mapping between a volume and a host cluster on a clustered system. This volume is then accessible for input or output (I/O) operations to the specified host cluster.

Syntax

mkvolumehostclustermap [ -scsi scsi_num_arg ] [ -force ] -hostcluster { hostcluster_id | hostcluster_name } { volume_id | volume_name }

Parameters

-scsiscsi_num_arg
(Optional) Specifies the Small Computer System Interface (SCSI) logical unit number (LUN) ID to assign to a volume on the specified host cluster. The SCSI LUN ID is assigned to the volume on the host cluster for all I/O groups that provide access to the volume.
Note: You must use the next available SCSI LUN ID for each host in the host cluster.

The -scsi parameter is not supported for NVMe hosts. When a volume is mapped to a host that uses the NVMe protocol, the volume namespace ID (NSID) is assigned by the system.

-force
(Optional) Forces a new mapping. Specify this parameter to map a volume to a host cluster and that volume is already mapped to at least one host in a different host cluster.
Important: Using the force parameter might result in a loss of access. Use it only under the direction of IBM support personnel.
-hostclusterhostcluster_id | hostcluster_name
(Required) Specifies the host cluster (by ID or name) to map to the volume. The value for the ID must be a number and the value for the name must be an alphanumeric string.
volume_id | volume_name
(Optional) Specifies the volume by ID or name. The value for the ID must be a number and the value for the name must be an alphanumeric string.

Description

This command generates a new mapping between a volume and a host cluster on a system. This volume is then accessible for input or output (I/O) operations to the specified host cluster. The protocol of the host cluster must be compatible with that of the volume.

An invocation example that maps volume 0 to host cluster 0

 mkvolumehostclustermap -hostcluster 0 0

The detailed resulting output:

No feedback

An invocation example that maps volume myvolume1 to host cluster myhostcluster and specifies SCSI LUN ID 7

mkvolumehostclustermap -hostcluster myhostcluster -scsi 7 myvolume1

The detailed resulting output:

No feedback