In the next step of the migration process, the Apache to IIS 6.0 Migration Tool copies the Web site content from the source server to the target server. Then, the tool transfers the Apache Web site settings to the corresponding IIS 6.0 metabase properties.
Figure 7.7: Performing the Migration from Apache to IIS 6.0
Now you are ready to install the Apache to IIS 6.0 Migration Tool based on the method you selected earlier in the "Selecting a Migration Tool Installation Option" section of this chapter. You can install the tool on one of the following:
Source server, which is running Linux
Target server, which is running Windows Server 2003
Intermediate computer, which can be running either Linux or Windows
The installation process is dependent on the operating system. So, for example, you can use the same procedure for installing the Apache to IIS 6.0 Migration Tool on the source server or for an intermediate computer running Linux.
Install the Apache to IIS 6.0 Migration Tool by completing the following steps:
Install the tool on a computer running Linux. Or, install the tool on a computer running Windows.
Configure the target server for migration.
The Apache to IIS 6.0 Migration Tool installation process on the source server and on an intermediate computer running Linux is identical. The versions of Linux supported by the tool are listed in "Overview of Migrating Apache Web Sites" earlier in this chapter.
Install the Apache to IIS 6.0 Migration Tool on the computer running Linux by completing the following steps:
Install the Windows Server 2003 Deployment Kit companion CD or the Internet Information Services (IIS) 6.0 Resource Kit companion CD on a computer other than the target server.
Install Perl on the computer running Linux.
Because the Apache to IIS 6.0 Migration Tool is written in Perl, you must install a Perl interpreter before you can run the tool. Install Perl on the computer running Linux and verify that the Perl interpreter is configured properly before installing the tool. To obtain a free copy of Perl, see the ActivePerl link on the Web Resources page at [http://www.microsoft.com/windows/reskits/webresources].
Create a folder to contain the Apache to IIS 6.0 Migration Tool on the computer running Linux.
Change to the folder created in Step 3 so that the folder is the current working folder.
Copy AIISMT_linux.tar.gz from the systemroot\Program Files\AIISMT folder on the computer in Step 1 to the folder created in Step 3.
At a Linux command line type tar -zxvf AIISMT_linux.tar.gz.
The compressed files are extracted to the folder created in step 3.
The Apache to IIS 6.0 Migration Tool installation process on the target server and on an intermediate computer running Windows is identical. The target server must be running Windows Server 2003. The intermediate computer can be running Microsoft Windows 2000 Professional, Microsoft Windows 2000 Server, Windows 2000 Advanced Server, or Microsoft Windows Server 2003.
Install the Apache to IIS 6.0 Migration Tool on the computer running Windows by completing the following steps:
Install the Windows Server 2003 Deployment Kit companion CD or the Internet Information Services (IIS) 6.0 Resource Kit companion CD on a computer other than the target server.
Install Perl on the computer running Windows.
Because the Apache to IIS 6.0 Migration Tool is written in Perl, you must install a Perl interpreter before you can run the tool. Install Perl on the computer running Windows and verify that the Perl interpreter is configured properly before installing the tool. To obtain a free copy of Perl, see the ActivePerl link on the Web Resources page at [http://www.microsoft.com/windows/reskits/webresources].
Copy the AIISMT_windows.exe from the systemroot\Program Files\AIISMT folder on the computer in step 1 to the desktop of the target server.
Double-click AIISMT_windows.exe.
The WinZip Self-Extractor dialog box appears.
In the Unzip to folder box, type the path of the folder where you want to extract the tool or click Browse to browse to the folder.
Click Unzip.
The WinZip Self-Extractor extracts the Apache to IIS 6.0 Migration Tool into the folder selected in step 5.
You must configure the target server before you can perform the migration process. The configuration process creates virtual directories in the FTP root mapped to the physical drives of the server.
Configure the target server for migration by completing the following steps:
At the command line, type cd \installation_path, where installation_path is the fully qualified path where you installed the Apache to IIS 6.0 Migration Tool, and then press ENTER.
This changes the default folder to the folder where you installed the tool. For more information about how the Apache to IIS 6.0 Migration Tool was installed, see "Installing the Migration Tool on Computers Running Windows" earlier in this chapter.
At the command line, type aiismt_setup, and then press ENTER.
When prompted to create a virtual directory, type y to create a virtual directory on the disk volume you want to use for migration.
You must select at least one disk volume and create a virtual directory.
| Important |
You cannot create a virtual directory on a drive formatted with the FAT file system because access rights to directories on that drive cannot be set. |
The aiismt_setup program creates the virtual directories in the FTP site root and configures FTP to listen on TCP port 21.
The Apache to IIS 6.0 Migration Tool requires only read access to the Web site content and configuration settings on the source server; therefore, the source server can remain online in your production environment. However, you might need to remove the source server from your production network and move it to a private network segment that has direct network connectivity to the target server when:
The amount of files and configuration information being copied across the network can generate a high volume of traffic and slow the production network.
Firewalls that reside between the source and target servers prevent the migration tool from performing the migration. This is most commonly caused because the migration tool uses FTP for communicating with the source and target servers, and the FTP protocol is blocked by the firewalls.
Security-related configuration settings on the source server need to be changed to allow the migration tool to work. This can include enabling FTP on production Web servers that are directly connected to the Internet.
The migration of your Apache Web site involves migrating both the Web site content and its configuration. Based on the installation option you selected, the Apache to IIS 6.0 Migration Tool prompts you for the information required to perform the migration of the Web site content.
To run the tool, do one of the following, depending on the operating system on the computer:
On Linux-based computers From the Linux shell, change the current folder to the folder where you installed the tool, and then type perl aiismt_main.pl.
On Windows-based computers: At the command line, change the current folder to the folder where you installed the tool, and then type aiismt.
After the Apache to IIS 6.0 Migration Tool starts, it prompts you for information. Table 7.4 lists the information that the migration tool requires to migrate the Web site content.
|
Information Required |
Do the Following |
|---|---|
|
Session name |
Type a:
Unique session name to indicate that the tool should begin a new migration process.
Previous session name if you want to resume a previous migration. Supplying a previous session name causes the tool to run in recovery mode.
|
|
Source server IP address |
If you run the tool on the:
Target server or on an intermediate computer, type the IP address of the source server.
Source server, press ENTER to see the default IP address displayed. If the tool cannot detect the source server's IP address, it will prompt you to confirm that the source server is running on a supported operating system.
|
|
Root user password |
If you run the Apache to IIS 6.0 Migration Tool on the:
Target server or on an intermediate computer, type the root user password to gain access to the Linux-based source server's system files and FTP service.
Source server, you do not need to type the root user password.
|
|
Target server IP address |
If you run the Apache to IIS 6.0 Migration Tool on the:
Source server or on an intermediate computer, type the IP address of the source server.
Target server, type the IP address of the target server or press ENTER to use the default (LocalHost) IP address.
|
|
User name and password for the target server |
If you run the Apache to IIS 6.0 Migration Tool on the:
Source server or on an intermediate computer, type a user name that is a member of the local Administrator's group on the target server, and the associated password.
Target server, you do not need to type a user name and password.
|
|
Configuration file path |
Type the complete path to the httpd.conffile, which is a file that contains configuration and settings for Apache on the source server. You can also press ENTER to see the default path (/Etc/Httpd/Conf/Httpd.conf). |
|
Web site directory on target server |
Type the path of the directory on the target server where you want the Web site content to be migrated. You must supply a path for each Web site migrated. When a Web site has SSL certificates associated with it, the Apache to IIS 6.0 Migration Tool prompts you to indicate whether you want the certificates to be migrated as well. |
|
Listening IP address and port number |
When you want to change the listening IP address and port number, type the new values. The new IP address and port numbers are applied to all the sites you selected for migration. |
|
Web site IP address |
When you want to change the IP address at the site level, type the new IP address, or type "to use all unassigned IP addresses. |
| Note |
If you run the Apache to IIS 6.0 Migration Tool on the source server, the target server credentials are authenticated. If you run the tool on the target server, the source server credentials are authenticated. |
For more information about how to migrate Web sites using the Apache to IIS 6.0 Migration Tool, see the "Apache to IIS 6.0 Migration Tool User Guide" on the Windows Server 2003 Deployment Kit companion CD or the Internet Information Services (IIS) 6.0 Resource Kit companion CD.
If the migration tool is interrupted or fails at any point during the process, you can run it in recovery mode. For more information about the recovery process, see "Recovering from an Interruption in the Migration Process" later in this chapter.
After migrating the Web site content, you must migrate the Web site configuration. Before you continue in the migration process, check the Apache to IIS 6.0 Migration Tool status file, Aiismt_Statusl in the session directory, to ensure the migration has completed successfully up to this point.
To start Web site configuration migration on the target server, at the command line, change the current folder to the folder where you installed the Apache to IIS 6.0 Migration Tool, and then type aiismt.
During the migration of the Web site configuration the tool, prompts you to supply the session name. The files with the configuration settings are located in a folder under the FTP root. The folder uses the name of the current migration session, which you specified when you migrated the Web site content in "Migrating Web Site Content" earlier in this chapter.
During the Web site configuration process on the target server, the Apache to IIS 6.0 Migration Tool does the following:
Migrates Apache Web site directives and maps them to corresponding IIS configuration settings, including security settings.
Migrates the FrontPage Server Extensions settings, users, and roles if any of the Apache Web sites are FrontPage extended.
Sets the security settings on the sites by assigning user rights to the directories that contain site-related content.
Verifies that settings have been correctly applied to the Web sites on the target server when the Web site configuration migration is complete.
If you received no error messages while migrating the Web site content and configuration, you can proceed to one of the following sections in this chapter:
"Migrating Apache-Specific Extensions" if any of your Web sites contain dynamic content.
"Configuring IIS 6.0 After Migration" if all of your Web sites contain static content.
If you received an error message while running the Apache to IIS 6.0 Migration Tool, do the following:
Determine the cause of the error and resolve the problem.
Restart the Apache to IIS 6.0 Migration Tool in recovery mode.
In addition to resolving migration errors, you can use the tool in recovery mode to:
Perform another migration if the majority of the settings are the same.
For example, you might run the tool to migrate a specific Web site on a Web server that hosts multiple Web sites. You can migrate subsequent Web sites by running the tool in recovery mode and change only the name of the Web site to be migrated. The remainder of the settings remains unchanged.
Perform the actual migration of Web site content and configuration after a trial migration.
You can perform a trial migration of the Web site and content by supplying all information except the Web sites to migrate. You can use this method to validate the majority of the migration settings. You can subsequently run the tool in recovery mode.
Provide a scripted environment for automating the Apache to IIS 6.0 Migration Tool migration process.
The tool creates an answer file that is used by the recovery process, which you can edit to automate the tool. The answer file has the naming convention of AIISMT_session name_Recovery.txt, where session_name is the session name for the migration.
The Apache to IIS 6.0 Migration Tool automatically creates a status file for each migration session in the session folder, located in the FTP root on the target server. The name of the session folder is identical to the migration tool session name. The status file, Aiismt_Statusl, contains information about every phase of the migration process.
If an interruption occurs while the tool is running:
Refer to the status file to determine the cause of the failure.
Resolve any errors before proceeding with the upgrade process.
If the Apache to IIS 6.0 Migration Tool is interrupted or fails at any point during the process, you can run it again in recovery mode. Recovery mode allows you to pick up the migration process from the point at which the tool was interrupted, rather than starting over from the beginning. Any of the following events can cause a failure or interruption in the migration tool:
System failure.
Network connection terminated.
FTP access denied.
You can restart the migration tool in recovery mode when:
An interruption occurs during data entry.
If the tool terminates as you are entering information about the migration (such as IP addresses or file paths) you can restart it in recovery mode. The migration tool validates your user credentials, and the migration process proceeds from the point where the tool was interrupted. You do not need to retype the information you have already entered.
An interruption occurs during file transfer.
If the migration tool terminates during the process of transferring files from the source server to the target server, you can restart it in recovery mode. The tool resumes migration with the file that was being transferred during the interruption.