Knowledge Base

How to use the IIS Migration Wizard to migrate from IIS 4.0 to IIS 5.0

Article ID: 301387

Article Last Modified on 11/21/2006

APPLIES TO

Microsoft Internet Information Server 4.0
Microsoft Internet Information Services 5.0

This article was previously published under Q301387

We strongly recommend that all users upgrade to Microsoft Internet Information Services (IIS) version 6.0 running on Microsoft Windows Server 2003. IIS 6.0 significantly increases Web infrastructure security. For more information about IIS security-related topics, visit the following Microsoft Web site:

http://www.microsoft.com/technet/security/prodtech/IIS.mspx

SUMMARY

This step-by-step article describes how to use the IIS Migration Wizard to migrate from Internet Information Server version 4.0 to Internet Information Services (IIS) version 5.0.

Note The IIS Migration Wizard is not supported under any Microsoft standard support program or service.

The IIS Migration Wizard migrates Web server configuration settings, Multipurpose Internet Mail Extensions (MIME) type information, and content to Microsoft Windows 2000 Server and IIS 5.0 from another Web server. It also provides the option to migrate users and groups.

During a migration, the wizard performs the following basic tasks:

Creates a virtual Web site in the IIS 5.0 snap-in, with a configuration that is matched as closely as possible to the original Web site.
Copies content, including application files, into an appropriate directory structure that it creates in Windows Explorer.
Maps the virtual Web site to the content.
Configures Active Server Pages (ASP) applications, Internet Server Application Programming Interface (ISAPI) extensions, and dynamic link libraries (DLLs), and sets execute permissions on the Common Gateway Interface (CGI) directory. You may have to take additional steps for your applications to run on IIS 5.0.

Requirements

The following conditions must be met for the IIS Migration Wizard to run correctly:

The destination computer must have Web access to the source computer.
The user who is running the wizard must have local computer administrator rights on both the source and the destination computers. This condition is satisfied if the user is a domain administrator.
The destination computer must be running Windows 2000 Server and IIS 5.0. It should also have a default configuration. During a migration, the IIS 5.0 default Web site must be running on the destination computer.
The IIS default Web site must be running on the source computer. If the default Web site has been deleted or renamed, the first Web site that appears under the administration Web site in the IIS snap-in must be running.
The total amount of content involved in a single migration cannot exceed 4 gigabytes (GB). If the content exceeds this limit, you can perform separate migrations for virtual Web sites. If you have only one Web site, you can decrease the content in a single migration by creating virtual Web sites that each see a part of the content. You can then conduct separate migrations for the virtual Web sites.

Important Security Information

We strongly recommended that you uninstall IIS Migration Wizard source and target components after you complete the migration process. Leaving these components installed may pose a security risk. On a Windows-based computer, you can uninstall the components by using the Add/Remove Programs utility in Control Panel.

Download and Extract IIS Migration Wizard Files

The following file is available for download from the Microsoft Download Center:

Iismigrationwizard_setup.exe

To download and extract IIS Migration Wizard files, follow these steps:

Download the IIS Migration Wizard setup file from the Microsoft Download Center.
In the File Download dialog box, select Save this program to disk.
Select a location on your computer and then click Save.
In Windows Explorer, locate the Iismigrationwizard_setup.exe file that you just downloaded, and then double-click the file to start the file extraction process.

Note The Iismigrationwizard_setup.exe file is a self-extracting executable (.exe) file. By running the file, you put installation packages and documentation on your computer. Each of these packages requires additional installation, as described in the tool documentation.

Install the Windows source component

The IIS Migration Wizard consists of two components: the source component, which is run on the computer from which you are migrating, and the target component, which is run on the computer to which you are migrating.

To install the source component, follow these steps:

Log on to the source computer as an administrator.
Browse the location where you extracted the IIS Migration Wizard files and double-click IISv5MigrationUtility_x86.exe. The default location of the IIS Migration Wizard files is %SystemRoot%\Program Files\Resource Kit.
Follow the instructions on the screen to install the component. When you are prompted, select Install the source component. For additional instructions, click Help at the bottom of the dialog box.

Install the Windows target component

Log on to the destination computer as an administrator.
browse the directory of the extracted IIS Migration Wizard files and double-click Iisv5migrationutility-targetonly_x86.exe.
Follow the instructions on the screen to install the component.

Run the IIS Migration Wizard

After you have installed the IIS Migration Wizard source and target components, you are ready to run the wizard and conduct a migration. To run the IIS Migration Wizard, follow these steps:

Log on to the destination computer as an administrator.
Click Start, point to Programs, and then click IIS Migration Wizard.
When you are prompted, select the server content, settings, and MIME information to migrate for each virtual server.

Note By default, the IIS administration Web site is not migrated, but you can select the option to migrate it. For help when you are using the wizard, click Help at the bottom of the dialog box.

Click Next to start the wizard. This starts the migration, which can take from several minutes to over an hour.
To save the activity log or the migration archive file, which contains migrated content and settings, click the appropriate link at the bottom of the wizard screen.
To close the wizard, click Finish.

Important: We strongly recommend that you uninstall both the source and target components after you complete the migration process. Leaving these components installed may pose a security risk.

Complete the migration of content

The IIS Migration Wizard copies all source Web site content to the destination computer. It also performs much of the required configuration for IIS 5.0 to serve the content. However, for certain types of content, you may have to take additional steps to complete the migration. This topic describes the directory structure that the wizard creates for content and the additional steps that you may have to take to complete the migration.

The IIS Migration Wizard puts content in the Inetpub\source\drive\directory structure directory structure that it creates in Windows Explorer on the destination computer, where source is the computer name or IP address of the source computer, drive is the drive on which the content was stored on the source computer, and directory structure is the directory structure as it exists on the source computer.

The wizard configures IIS 5.0 properties for migrated content, with the following results:

Web pages are configured to be served correctly. You may have to change UNIX-style file names to reflect Windows conventions.
CGI applications are put in a directory with run permissions enabled. You may have to take additional steps in order for your CGI applications (particularly UNIX CGI applications) to run on IIS 5.0. For more information, see "Migrating a Web Server to IIS 5.0" in the Microsoft Windows 2000 Resource Kit Internet Information Services Resource Guide.
ASP application that have relative paths are configured to run correctly. However, you may have to correct absolute paths in .asp files to reflect the new directory hierarchy.
ISAPI extensions are configured to run correctly.
Netscape Application Programming Interface (NSAPI) extensions are migrated, but are not converted to a format that runs on IIS 5.0.
DLLs that are stored in Web content directories on the source computer are configured to run correctly. DLLs that are stored outside Web content directories are not migrated.
COM objects that are stored in Web content directories on the source computer are copied to the appropriate directory. However, to complete the migration of COM objects, you must manually run Regsvr32.exe. COM objects that are stored outside Web content directories are not migrated.
ODBC sources are not migrated. You must reconfigure them in a Windows 2000 environment.
Because security certificates are not migrated, you must remove any security certificates that you are using on the IIS 4.0 computer before you migrate, and then obtain new certificates for the migrated Web sites under IIS 5.0.

Restore migrated settings and content

For each migration, the IIS Migration Wizard provides the option to save a .cab file that archives migrated settings and content. If you want to undo changes that you have made to a migrated Web site, or if your data becomes corrupted, you can restore the original settings and content. To do this, run the wizard again and reference the .cab archive file instead of a source Web server. You can also use this method to replicate migrated settings and content to another computer that is running Windows 2000 Server and IIS 5.0.

The wizard restores or replicates migrated settings and content as follows:

If, in the IIS 5.0 snap-in, the wizard encounters a Web site that has the same name as the Web site for which the archive .cab file was created, it restores the Web site settings to the state that is recorded in the .cab file. The wizard also overwrites any content that is contained in Inetpub\Web site name\ folder together with corresponding content from the archive .cab file. Web site name is a folder that has the same name as the migrated Web site. If the wizard does not find a folder that has this name, it creates a folder that has this name and copies the content into it.
If, in the IIS 5.0 snap-in, the wizard does not experience a Web site with a name that corresponds to the name of the archived Web site, it creates and new Web site that has this name. It also copies all the archived content to Inetpub\Web site name\, where Web site name is a folder that the wizard creates that has the same name as the migrated Web site.

To restore or replicate migrated settings and content, follow these steps:

Log on to the destination computer (the one onto which you want to replicate or restore settings and content) as an administrator.
If it is required, install the target component, as described in the "Install the Windows Target Component" section.
Click Start, click Programs, and then click IIS Migration Wizard to start the wizard.
On the Welcome page, click Next.
In Step 2: connect to the source server, select the Archive file option, and then type the path and file name of the archive .cab file in the text box. Click Next.
Click Next on each subsequent screen until the migration starts. After the process has started, the process takes from several minutes to over an hour, depending on the amount of content that is restored or replicated. When the migration is complete, the wizard displays a list of warnings, and also the additional steps that are required.

Troubleshooting

==== "Page Cannot Be Displayed" Error Message When You Start the Wizard from a Web Page ====
When you try to start the wizard from a Web page by connecting to http://source/iismu/welcome.htm, you may receive an error message that states that the page cannot be displayed. If you do, the source Web server is not running.

To correct the problem, stop the wizard, start the source Web server, and then start the wizard again. If the source Web server is IIS, you must start the default Web site. If you have renamed or deleted the default Web site, start the Web site that appears first under the administration Web site in the IIS snap-in of the Microsoft Management Console (MMC).
==== "Page Cannot be Displayed" Error Message After Step 2 ====
After you complete the second step of the wizard (Step 2: connect to the source server), you may receive an error message that states that the page cannot be displayed. If you do, either the target component is not installed, or the target Web server is not running. If the target component has not been installed, go back to Step 1 of the wizard, install the target component, and then continue with the wizard. If the target component has been installed, the error indicates that the target Web server is not running. In this case, stop the wizard. In the IIS snap-in, start the default Web site, and then start the wizard again.

If you continue to receive an error message that states that the page cannot be displayed, the most likely cause is that the destination computer does not have a default installation of Windows 2000 and IIS 5.0. The IIS Migration Wizard does not support target operating systems without a default installation. To correct the problem, verify that the IIS default Web site responds to requests that are made to the "localhost" address, which the wizard uses when it moves from step 2 to step 3. To do this, follow these steps:
1. In the IIS snap-in on the destination computer, make sure that the IP address of the default Web site is set to ALL UNASSIGNED.
2. On the destination computer, make sure that the IIS default Web site is running on port 80.
3. On the destination computer, make sure that the IIS default Web site is the only Web site that is running on port 80.
==== Response.isClientConnected Error Message ====
When you run the wizard, you may receive the following error message:

Microsoft VBScript runtime error '800a01b6' Object does not support this property or method: 'Response.isClientConnected'

The cause of this error message may be an additional, outdated ASP DLL on the source computer. To see whether this is the case, open the \WINNT\System32\Inetsrv folder on the source computer and look for a folder named ASP and a file named Asp.dll. If the Inetsrv folder contains an ASP folder and an Asp.dll file, follow these steps:
1. In the Services program in Control Panel, stop the IIS Admin Service. This also stops the File Transfer Protocol (FTP), Hypertext Transfer Protocol (HTTP), and Simple Mail Transfer Protocol (SMTP) services.
2. Back up the ASP folder and its contents to another location on your hard disk. If the new Asp.dll does not work correctly, you can then restore the ASP folder to its original location.
3. In the Inetsrv folder, delete the ASP folder.
4. In the Services program in Control Panel, restart the IIS Admin Service.
5. Verify that script mappings are correct at each level on which you have defined an application. To do this, in the IIS snap-in, open the property sheets for each application root folder, and click the Home Directory tab. Under Application Settings, click Configuration, and verify that the script mappings reference \inetsrv\asp.dll.
6. In the Services program in Control Panel, restart the FTP, HTTP, and SMTP services.
==== Stalling on Netscape Source Servers ====
The IIS Migration Wizard may stall when it creates the migration archive on Netscape source servers. This occurs when the connection time-out value on the Netscape source server is too short. To correct this problem, use the Netscape Server Administrator to increase the value of HTTP Persistent Connection time-out under Server Preferences/Performance Tuning.

Keywords: kbhowto kbhowtomaster kbdownload KB301387

Microsoft KB Archive/301387

Contents