Migrating iSCSI Target 3.3 settings before upgrading Windows Server 2008 R2 to Windows Server 2012

Article ID: 2756772 - View products that this article applies to.
Expand all | Collapse all

Symptoms

Consider the following scenario:
  • You have a computer that is running Windows Server 2008 R2 or Windows Server 2008 R2 Service Pack 1 (SP1)
  • You have configured Microsoft iSCSI Software Target 3.3
  • You start the upgrade of the operating system to Windows Server 2012.
  • When you proceed through the Upgrade wizard, the compatibility report shows the following message: 

    Installing Windows will affect the following features:

    Setup has detected that Microsoft iSCSI Software Target or Microsoft iSCSI VDS/VSS providers are installed on this computer. They will no longer function after the upgrade and configuration settings will be lost You must follow the instructions at <Link> prior to the upgrade to ensure they can continue to work after successful upgrade.
In this scenario, setup gives you a warning that, Microsoft iSCSI Software Target 3.3 or Microsoft iSCSI VDS/VSS providers may not be functional after the upgrade. It is best to uninstall the feature, then enable the feature after upgrade the server to Server 2012.

Cause

In Windows Server 2012, the Microsoft iSCSI Software Target and Microsoft iSCSI VDS/VSS providers are available as a built-in sub feature of the File and Storage Services Role.

Resolution

To resolve this problem, the settings from earlier versions of Microsoft iSCSI Software Target must be manually imported and the Microsoft iSCSI Software Target should be un-installed from down level operating systems before performing the upgrade to Windows Server 2012.

The following steps can be used to export and import the Microsoft iSCSI Software Target 3.3 configuration settings:
  1. Open an elevated Windows PowerShell prompt, and change directory to C:\Program Files\Microsoft iSCSI Software Target
  2. Make sure your ExecutionPolicy can run scripts. You can temporarily set the execution policy to unrestricted for just the current session, using the following command: Set-ExecutionPolicy Unrestricted
  3. Run the following command to export the Microsoft Software Target 3.3 configuration settings:

    .\iSCSITargetSettings.ps1 –Export –Filename C:\temp\iSCSISettings.xml 
  4. Note: For a cluster, run the script on each node in the cluster. You can also run the script remotely from another server where target is installed.
  5. Uninstall Microsoft iSCSI Software Target 3.3 and then upgrade the operating system to Windows Server 2012.
  6. After the upgrade, open an elevated Windows PowerShell prompt and then set the execution policy to unrestricted:

    Set-ExecutionPolicy Unrestricted
  7. Enable the Microsoft iSCSI Software Target feature using the following command:

    Add-WindowsFeature FS-iSCSITarget-Server -IncludeManagementTools
  8. From the PowerShell prompt, change the directory to C:\Windows\System32\WindowsPowerShell\v1.0\Modules\IscsiTarget
  9. Run the following command to import the Microsoft Software Target configuration settings: 

    .\iSCSITargetSettings.ps1 –Import –Filename C:\temp\iSCSISettings.xml
Note that the script does not migrate your VHD files or CHAP secrete, which users should migrate separately.

More information

Introduction of iSCSI Target in Windows Server 2012
http://blogs.technet.com/b/filecab/archive/2012/05/21/introduction-of-iscsi-target-in-windows-server-2012.aspx

Microsoft iSCSI Software Target Migration Guide
http://technet.microsoft.com/en-us/library/gg509007(v=ws.10).aspx

Microsoft iSCSI Software Target 3.3: Known Issues and Updates
http://technet.microsoft.com/en-us/library/gg232597(v=ws.10).aspx
Note This is a "FAST PUBLISH" article created directly from within the Microsoft support organization. The information contained herein is provided as-is in response to emerging issues. As a result of the speed in making it available, the materials may include typographical errors and may be revised at any time without notice. See Terms of Use for other considerations.

Properties

Article ID: 2756772 - Last Review: September 14, 2012 - Revision: 1.0
Applies to
  • Microsoft iSCSI Software Target 3.3
  • Windows Server 2008 R2 Standard
  • Windows Server 2008 R2 Standard without Hyper-V
  • Windows Server 2008 R2 Enterprise
  • Windows Server 2008 R2 Enterprise without Hyper-V
  • Windows Server 2008 R2 Datacenter
  • Windows Server 2008 R2 Datacenter without Hyper-V
  • Windows Server 2008 R2 for Itanium-Based Systems
  • Windows Server 2008 R2 Service Pack 1
  • Windows Server 2012 Standard
  • Windows Server 2012 Datacenter
  • Windows Server 2012 Hyper V
Keywords: 
KB2756772

Give Feedback

 

Contact us for more help

Contact us for more help
Connect with Answer Desk for expert help.
Get more support from smallbusiness.support.microsoft.com