How to use the IIS Migration Wizard to migrate from IIS 4.0 to IIS 5.0 (301387)
The information in this article 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: 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 InformationWe 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 FilesThe following file is available for download from the Microsoft Download Center:
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
Modification Type: | Major | Last Reviewed: | 10/7/2005 |
---|
Keywords: | kbdownload kbhowto kbHOWTOmaster KB301387 |
---|
|