Upgrading iSCSI hosts
About target portal group tags in Data ONTAP 7.1
In Data ONTAP 7.1, the iSCSI target portal group tags changed from the values used in previous releases. These tags are used by iSCSI hosts to identify the iSCSI target provided by the storage system.
The Linux and HP-UX iSCSI software initiators create a persistent association between the target portal group tag value and the target. If the target portal group tag changes, the LUNs from the target become unavailable because the initiators recognize the LUNs as new devices.
Affected systems
All NetApp storage systems that provide iSCSI LUNs to hosts running any version of a Linux software initiator are affected. The following procedures are required when upgrading from any previous version of Data ONTAP to 7.1 or later.
Procedure overview
To upgrade Data ONTAP with iSCSI hosts running Linux or HP-UX, record the target portal group tags used by the storage system before the upgrade and then configure the interfaces to use the old tag values after the upgrade.
Attention
You must complete the first steps of this procedure before installing the new version of Data ONTAP software.
You must complete the following procedures in the order shown:
- Record existing portal group tags.
- Install the new Data ONTAP version but do not reboot the storage system.
- Stop the iSCSI service on the storage system.
- Reboot the storage system.
- Change the new portal group tags to the previous values.
- Start the iSCSI service on the storage system.
Recording existing portal group tags
Before upgrading, collect and record the portal group tags for each Ethernet interface on the storage system.
Collecting tags using the command line
To collect the existing portal group tag values using the command line, complete the following steps.
Step
|
Action
|
|---|
|
1
|
On the storage system console, enter the following command:
iscsi show adapter
Result
The current target portal groups are displayed.
Example
filer2> iscsi show adapter
Adapter: iswta
Slot: N/A
Description: NetApp Software Implementation
Status: Online
Target Portal Groups:
portal group 1: inet 10.60.128.101 port 3260
portal group 2: inet 10.60.128.102 port 3260
portal group 3: inet 10.60.131.102 port 3260
|
|
2
|
Note the value associated with each IP address.
|
|
3
|
Enter the following command:
ifconfig -a
Result
Networking parameters, including the IP address, are displayed for each interface.
Example
filer2> ifconfig -a
e0: flags=848043<UP,BROADCAST,RUNNING,MULTICAST> mtu 1500
inet 10.60.128.101 netmask 0xffffff00 broadcast
10.60.128.255
ether 00:a0:98:01:25:0f (100tx-fd-up)
e9a:
flags=148043<UP,BROADCAST,RUNNING,MULTICAST,TCPCKSUM>
mtu 1500
inet 10.60.128.102 netmask 0xffffff00 broadcast
10.60.128.255
ether 00:07:e9:0d:8a:ce (1000fx-up) flowcontrol full
e9b:
flags=948043<UP,BROADCAST,RUNNING,MULTICAST,TCPCKSUM>
mtu 1500
inet 10.60.131.102 netmask 0xffffff00 broadcast
10.60.131.255
ether 00:07:e9:0d:8a:cf (1000fx-up) flowcontrol full
|
|
4
|
Note the interface identifier, such as e9a, associated with the IP addresses you collected in step 1, and then map to the portal group tags.
Example
Interface e0 = portal group 1
Interface e9a = portal group 2
Interface e9b = portal group 3
|
Collecting tags using FilerView
To collect the existing portal group tag values using FilerView, complete the following steps:
Step
|
Action
|
|---|
|
1
|
Click LUNs > iSCSI > Report.
Result
The reports page is displayed, including the iSCSI Adapters section at the bottom of the page.
Example
Adapter: iswta
Slot: N/A
Description: NetApp Software Implementation
Status: Online
Target Portal Groups:
portal group 1: inet 10.60.128.101 port 3260
portal group 2: inet 10.60.128.102 port 3260
portal group 3: inet 10.60.131.102 port 3260
|
|
2
|
Note the value associated with each IP address.
|
|
3
|
Click Network > Manage Interfaces
Result
The interfaces and their IP addresses are displayed.
|
|
4
|
Note the interface identifier, such as e9a, associated with the IP addresses you collected in step 1, and then map to the portal group tags.
Example
Interface e0 = portal group 1
Interface e9a = portal group 2
Interface e9b = portal group 3
|
Installing Data ONTAP
Follow the procedures in this guide to install the new version of Data ONTAP. Do not reboot the storage system yet.
Stopping the iSCSI service
Stop the iSCSI service on the storage system. This prevents the iSCSI hosts from seeing the new target portal group tags that are assigned by default when the Data ONTAP upgrade is complete.
Note
All iSCSI LUNs will be unavailable when you stop the iSCSI service.
Stopping the iSCSI service using the command line
To stop the iSCSI service on the storage system using the command line, complete the following step:
Step
|
Action
|
|---|
|
1
|
On the storage system console, enter the following command:
iscsi stop
|
Stopping the iSCSI service using FilerView
To stop the iSCSI service on the storage system using FilerView, complete the following steps:
Step
|
Action
|
|---|
|
1
|
Click LUNs > Enable/Disable.
|
|
2
|
Clear the Enable check box for iSCSI.
|
|
3
|
Click Apply.
|
Rebooting the storage system
Once you have stopped the iSCSI service, you are now ready to reboot the storage system. The storage system reboots with the new version of Data ONTAP, but the iSCSI service is not enabled.
Changing the target portal group tags
The upgrade to the new version of Data ONTAP changed the target portal group tag values. You need to change the new values back to the values you recorded before the upgrade.
Data ONTAP 7.1 supports user-created target portal groups with user-defined tag values. You need to create a new target portal group for each interface and assign a new tag value to the group.
Changing target portal group tags using the command line
To change the target portal groups to their original values, complete the following steps:
Step
|
Action
|
|---|
|
1
|
View the new target portal groups and their tag values by entering the following command on the storage system console:
iscsi tpgroup show
Example
filer2> iscsi tpgroup show
TPGTag Name Member Interfaces
1000 e0_default e0
1001 e9a_default e9a
1002 e9b_default e9b
|
|
2
|
Create a new target portal group for the first interface in the list by entering the following command:
iscsi tpgroup create -t tag name interface
-t tag is the target portal group tag your recorded for the interface before upgrading Data ONTAP.
name is the name of the new target portal group.
interface is the identifier of the interface for this group.
Example
iscsi tpgroup create -t 1 e0_old e0
|
|
3
|
Repeat the previous step for each interface in the list.
|
|
4
|
Verify the new values match the old values you recorded by entering the following command again:
iscsi tpgroup show
Example
filer2> iscsi tpgroup show
TPGTag Name Member Interfaces
1 e0_old e0
2 e9a_old e9a
3 e9b_old e9b
1000 e0_default (none)
1001 e9a_default (none)
1002 e9b_default (none)
|
Changing target portal group tags using FilerView
To change the target portal groups to their original values, complete the following steps:
Step
|
Action
|
|---|
|
1
|
Click LUNs > iSCSI > Manage Portal Groups.
Result
A list of target portal groups is displayed.
|
|
2
|
Click Add Portal Group.
Result
The Add iSCSI Portal Group page is displayed.
|
|
3
|
For the first target portal group in the list you recorded before the upgrade, enter a name for the new portal group, enter the tag value from the list, and select the interface.
Example
|
|
4
|
Click Add, and then click OK.
|
|
5
|
Repeat for each target portal group in the list.
|
|
6
|
Verify the new values match the old values you recorded by clicking LUNs > iSCSI > Manage Portal Groups again.
Example
|
Starting the iSCSI service
Once all of the original target portal group tags have been configured, you can restart the iSCSI service on the storage system.
Starting the iSCSI service using the command line
To start the iSCSI service on the storage system using the command line, complete the following step:
Step
|
Action
|
|---|
|
1
|
On the storage system console, enter the following command:
iscsi start
|
Starting the iSCSI service using FilerView
To start the iSCSI service on the storage system using FilerView, complete the following steps:
Step
|
Action
|
|---|
|
1
|
Click LUNs > Enable/Disable.
|
|
2
|
Select the Enable check box for iSCSI.
|
|
3
|
Click Apply.
|
For more information
For more information, see the Block Access Management Guide.
Copyright © 1994-2005, Network Appliance, Inc. All rights
reserved.
Part No. 210-01083_B0
File: 2upgra13.htm
Last updated: 16-Dec-2005 18:19:09