Table of ContentsView in Frames

Enabling IP-based target portal group management

If you want to perform online migrations of vFiler unit, you must enable IP-based target portal groups on your vFiler units.

About this task

When you enable IP-based target portal groups, the existing interface-based target portal groups are automatically converted to IP-based target portal groups. However, note that the interface-based target portal groups remain intact for the default vFiler unit.

Step

  1. Enter the following command:
    vfiler run vFiler_unit options iscsi.ip_based_tpgroup on

    The existing interface-based target portal groups are converted to IP-based target portal groups with no disruption in service to the host.

Example

Before enabling IP-based target portal groups, the target port group information for vFiler unit 2 (vf2) looks like this:
system1>vfiler run vf2 iscsi tpgroup show
TPGTag  Name              Member Interfaces
 32     user_defined32      (none)
 1000   e0_default          e0
 1002   e11b_default        e11b
 1003   e11c_default        e11c
 1004   e11d_default        e11d
 1005   e9a_default         e9a
 1006   e9b_default         e9b
 1007   e10a_default        e10a
 1008   e10b_default        e10b
 2000   vif_e0-1_default    vif_e0-1
 2001   vif_e0-2_default    vif_e0-2
 2002   vif_e0-3_default    vif_e0-3
 2003   vif_e11a-1_default  vif_e11a-1
 2004   vif_e11a-2_default  vif_e11a-2
 2005   vif_e11a-3_default  vif_e11a-3
 

Each interface is associated with various IP addresses, and some of those are assigned to vFiler unit vf2. For example:

system1> vfiler run vf2 iscsi portal show
Network portals:
IP address        TCP Port  TPGroup  Interface
10.60.155.104        3260    1000    e0
192.168.11.100       3260    2003    vif_e11a-1
192.168.11.101       3260    2003    vif_e11a-1
192.168.13.100       3260    2005    vif_e11a-3
192.168.13.101       3260    2005    vif_e11a-3

After enabling IP-based target portal groups for vf2, the relevant interface-based target portal groups for vf2 are nondisruptively converted to IP-based target portal groups.

system1> vfiler run vf2 options iscsi.ip_based_tpgroup on

system1> vfiler run -q vf2 iscsi ip_tpgroup show
TPGTag  Name                        Member IP Addresses
 1000   e0_default                  10.60.155.104
 2003   vif_e11a-1_default          192.168.11.100, 192.168.11.101
 2005   vif_e11a-3_default          192.168.13.100, 192.168.13.101

system1> vfiler run -q vf2 iscsi portal show
Network portals:
IP address        TCP Port  TPGroup  Interface
10.60.155.104        3260    1000    e0
192.168.11.100       3260    2003    vif_e11a-1
192.168.11.101       3260    2003    vif_e11a-1
192.168.13.100       3260    2005    vif_e11a-3
192.168.13.101       3260    2005    vif_e11a-3

If you configure another IP address for vf2, then a new default IP-based target portal group (4000) is automatically created. For example:

system1> vfiler add vf2 -i 192.168.13.102

system1> ifconfig vif_e11a-3 alias 192.168.13.102

system1> vfiler run vf2 iscsi ip_tpgroup show
TPGTag  Name                        Member IP Addresses
 1000   e0_default                  10.60.155.104
 2003   vif_e11a-1_default          192.168.11.100, 192.168.11.101
 2005   vif_e11a-3_default          192.168.13.100, 192.168.13.101
 4000   192.168.13.102_default      192.168.13.102

system1> vfiler run vf2 iscsi portal show
Network portals:
IP address        TCP Port  TPGroup  Interface
10.60.155.104        3260    1000    e0
192.168.11.100       3260    2003    vif_e11a-1
192.168.11.101       3260    2003    vif_e11a-1
192.168.13.100       3260    2005    vif_e11a-3
192.168.13.101       3260    2005    vif_e11a-3
192.168.13.102       3260    4000    vif_e11a-3

After you finish

After you enable IP-based target portal group management, it is recommended to leave it enabled. However, if you must disable IP-based target portal groups for some reason, enter the following command:
options iscsi.ip_based_tpgroup off

As a result, any IP-based target portal group information is discarded, and the interface-based target portal group information is reenabled. Note that this process might disrupt the iSCSI service to the hosts.

Also note that if an IP address is unassigned from a vFiler unit or unconfigured from the network interface, that IP address is no longer a valid iSCSI portal. However, the IP-based target portal group to which that IP address belonged remains intact so that if you add the IP address back later, it is automatically assigned back to the original target portal group.