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
Parameters
- -scsi scsi_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. This parameter is mutually exclusive with -allowmismatchedscsiids. This parameter cannot be used with the -scsi parameter and is not supported for NVMe hosts.
- -allowmismatchedscsiids
- (Optional) When you create a new host cluster mapping, this parameter allows the system to allocate non-identical SCSI LUN IDs in the access I/O groups for the volume. This parameter is mutually exclusive with -scsi.
- -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.
- -hostcluster hostcluster_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.
If you do not specify a SCSI LUN ID, the system attempts to assign the lowest common SCSI LUN ID in all access I/O groups. The returned ID is the same for all I/O groups to which the volume is mapped. If an identical SCSI LUN ID is not available in all of the access I/O groups, the command fails.
Use the -allowmismatchedscsiids parameter to allow the system to allocate non-identical SCSI LUN IDs in the access I/O groups. The lowest value available in each access I/O group is used. It might not be the same in all access I/O groups. Make sure that the host supports this configuration. This parameter cannot be used with the -scsi parameter and is not supported for NVMe hosts. If a volume is mapped to a host that uses the NVMe protocol, the volume namespace ID (NSID) is assigned by the system.
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