addvdiskaccess

Use the addvdiskaccess command to add an I/O group (or groups) to the set of I/O groups in which a volume can be made accessible to hosts.

Syntax

addvdiskaccess -iogrp { iogrp_id_list | iogrp_name_list } { vdisk_id | vdisk_name }

Parameters

-iogrpiogrp_id_list | iogrp_name_list
(Required) Specifies a list of I/O groups to add to the I/O group volume access set.
vdisk_id | vdisk_name
(Required) Specifies the volume to which to add access through the specified I/O groups.

Description

If an I/O group is already a member of the access set, no error is generated and no action is taken for that I/O group. All host mappings for the volume are added to the I/O groups in the list. The -force option is not required to extend additional mappings to other I/O groups.

When an I/O group is added to the access set, it creates access to the volume from the hosts that are mapped to the volume from the nodes in the I/O group. If the volume is mapped twice, it is also mapped twice through all additional I/O groups.

You can add I/O groups to the volume access list if they are mapped to iSCSI hosts. This means that iSCSI hosts can access volumes that are accessible through multiple I/O groups (as well as a single I/O group).

Remember: The -addvdiskaccess command fails if:
  • Any host (for which the volume has a host mapping) is not associated with an I/O group in the list.
  • The host volume mapping limit is exceeded.
  • The number of extra mappings added exceeds the clustered system limit for host volume mappings.
Two mappings are created if a host is mapped to a volume with two I/O groups. Hosts are limited to 512 host-to-volume mappings, which means a host can be mapped to:
  • 512 volumes in a single I/O group
  • 256 volumes across two I/O groups
  • 64 volumes across four I/O groups

The command fails if any host mapped to the volume is detected as a host system that does not support volumes mapped from multiple I/O groups.

An invocation example

This example adds I/O group 2 to the volume access set for DB_Volume:

addvdiskaccess -iogrp 2 DB_Volume

The resulting output:

No feedback

An invocation example

This example adds I/O groups 2 and 3 to the volume access set for volume ID 3:

addvdiskaccess -iogrp 2:3 3

The resulting output:

 No feedback