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