Microsoft KB Archive Search

Notice: This website is an unofficial Microsoft Knowledge Base (hereinafter KB) archive and is intended to provide a reliable access to deleted content from Microsoft KB. All KB articles are owned by Microsoft Corporation. Read full disclaimer for more details.

  1. Home
  2. Migrating iSCSI Target 3.3 settings before upgrading Windows Server 2008 R2 to Windows Server 2012

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

View products that this article applies to.

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.

↑ Back to the top

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.

↑ Back to the top

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.

↑ Back to the top

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

↑ Back to the top

Keywords: kb

↑ Back to the top

Article Info
Article ID : 2756772
Revision : 1
Created on : 1/7/2017
Published on : 9/14/2012
Exists online : False
Views : 551