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