Renaming NAS volume containing iSCSI luns causes data contained on the iSCSI luns to become inaccessible

Asset ID:	1-72-1008016.1
Update Date:	2011-05-11
Keywords:

Solution Type Problem Resolution Sure

Solution 1008016.1 : Renaming NAS volume containing iSCSI luns causes data contained on the iSCSI luns to become inaccessible

Related Items


Sun Storage 5210 NAS Appliance
 Sun Storage 5220 NAS Appliance
 Sun Storage 5310 NAS Appliance
 Sun Storage 5320 NAS Gateway/Cluster System
 Sun Storage 5320 NAS Appliance
 Sun Storage 5310 NAS Gateway System

Related Categories


GCS>Sun Microsystems>Storage - Disk>Network Attached Storage

PreviouslyPublishedAs
211052

Symptoms
When Renaming a volume that contains iSCSI luns, the NAS head fails to update the environment variables associated with any of the iSCSI luns created on the volume.

This causes the iSCSI luns to become inaccessible on any of the clients accessing these luns.

Resolution
The resolution to this problem was to have the NAS head properly update the iSCSI related environment variables upon a volume rename.

This has been reported in CR 6442222 (or 6377759) and fixed in 4.20 B31.

Relief/Workaround
1. Make note of the ORIGINAL and NEW volume names.

New volume name can be seen in the lefthand window pane under "System Manager"
Original volume name will be listed in the "Configure iSCSI LUN for MS-Exchange" screen found under iSCSI Configuration ->Configure iSCSI LUN

2. List the environment variables:

  Telnet to the NAS head, log in as administrator
5210> show iscsi.node*.targetdevice
iscsi.node.0.targetdevice=/TESTVOL/iqn.1986-03.com.sun:01:000e0c317c74.44926AF8.LUN1

       In the above, note that the volume is still TESTVOL

3. Set target device variables that reflect the "OLD" vol name to the new vol name

  5210> set iscsi.node.0.targetdevice /NEWVOL1/iqn.1986-03.com.sun:01:000e0c317c74.44926AF8.LUN1

       Note that the environment variable was changed from TESTVOL to NEWVOL1, also note
that similar changes will have to be made for  all target devices reflecting the
wrong path.

4. Save the updated environment variables

  5210> savevars

5. Load the changed variables so the changes become active
5210> loadvars

6. Return to the NAS GUI,

   Expand "iSCSI Configuration" in the left window pane,
Choose "Configure iSCSI LUN" from the list
In the righthand window pane, select ANY iSCSI lun
that is on the renamed volume and push the 'Edit'
button.
In the resulting pop-up, clic, the 'Apply' button

At this point you should be able to regain access to the iscsi luns at the pc.
You may have to manually re-login the luns using the iSCSI initiator software at the pc but it should be successful.

Product
Sun StorageTek 5310 NAS Gateway System
Sun StorageTek 5310 NAS Appliance
Sun StorageTek 5210 NAS Appliance
Sun StorageTek 5320 NAS Gateway/Cluster System
Sun StorageTek 5320 NAS Appliance
Sun StorageTek 5310 NAS Gateway/Cluster System
Sun StorageTek 5220 NAS Appliance

Internal Comments
This document contains normalized content and is managed by the the Domain Lead(s) of the respective domains. To notify content owners of a knowledge gap contained in this document, and/or prior to updating this document, please contact the domain engineers that are managing this document via the “Document Feedback” alias(es) listed below:

storage-nas-domain@sun.com

The Knowledge Work Queue for this article is KNO-STO-NAS
iSCSI, nas, audi, environment variable, 5320, 5320C, 5310C, 5220, audited
Previously Published As
86056

Change History
Date: 2007-10-03
User Name: 7058
Action: Approved
Comment: Update OK to publish.
Version: 9
Date: 2007-10-02
User Name: 7058
Action: Accept
Comment:
Version: 0
Date: 2007-10-02
User Name: 119902
Action: Approved
Comment: I have reviewed this doc for technical accuracy
Version: 0

Attachments

This solution has no attachment