The In’s and Out’s of the The In’s and Out’s of the IIS 6.0 Migration ToolIIS 6.0 Migration Tool

Chris AdamsChris Adams

Web Platform Supportability LeadWeb Platform Supportability Lead

Microsoft CorporationMicrosoft Corporation

AgendaAgenda Introduction to “Migration” Scenario’sIntroduction to “Migration” Scenario’s Platform Requirements for IIS 6.0 Migration ToolPlatform Requirements for IIS 6.0 Migration Tool

Where can I install it? Use it?Where can I install it? Use it? Upside of the IIS 6.0 Migration ToolUpside of the IIS 6.0 Migration Tool

Migration of Website and Virtual DirectoryMigration of Website and Virtual Directory Migration of Web ContentMigration of Web Content Auto extending of FPSE-Enabled WebsAuto extending of FPSE-Enabled Webs Demonstration OneDemonstration One

Downside of the IIS 6.0 Migration ToolDownside of the IIS 6.0 Migration Tool Lack’s Server Paths’ intelligenceLack’s Server Paths’ intelligence Requires use of Administrative Shares (Security)Requires use of Administrative Shares (Security) Failure to create any custom or domain accounts used in web environmentsFailure to create any custom or domain accounts used in web environments Demonstration TwoDemonstration Two Demonstration ThreeDemonstration Three

SummarySummary

Introduction to “Migration” Scenario’sIntroduction to “Migration” Scenario’s

The term “Upgrade”The term “Upgrade” Upgrade indicates a in-place upgrade on Upgrade indicates a in-place upgrade on

existing hardwareexisting hardware

The term “Migration”The term “Migration” Migration indicates that greater than 1 Migration indicates that greater than 1

server is being used, such as the case in a server is being used, such as the case in a simple migration – simple migration –

One Source Server | One Target ServerOne Source Server | One Target Server

Introduction to “Migration” Introduction to “Migration” Scenario’sScenario’s

Source Server Target Server

Administrator’s Workstation

Terminal or Remote Desktop Access

Pulls data from Source

Platform Requirements for IIS 6.0 Platform Requirements for IIS 6.0 Migration ToolMigration Tool

InstallationInstallation There is no installation process for the IIS 6.0 Migration There is no installation process for the IIS 6.0 Migration

ToolTool It is a single executable, Iismt.exeIt is a single executable, Iismt.exe

Running Iismt.exeRunning Iismt.exe Copy iismt.exe to Windows 2003 Server (the target server)Copy iismt.exe to Windows 2003 Server (the target server)

Source Servers:Source Servers: Windows NT 4.0 & IIS 4.0Windows NT 4.0 & IIS 4.0 Windows 2000 & IIS 5.0Windows 2000 & IIS 5.0 Windows 2003 & IIS 6.0Windows 2003 & IIS 6.0 Unix | Linux & Apache (requires special version of IIS 6.0 Unix | Linux & Apache (requires special version of IIS 6.0

Migration ToolMigration Tool

IIS 6.0 Migration Tool: How it WorksIIS 6.0 Migration Tool: How it Works

ParameterParameter Required?Required? DescriptionDescription

ServerServer YesYes The source server. You can specify the name or the IP address of The source server. You can specify the name or the IP address of the source server. the source server.

WebsiteWebsite YesYes The site that you want to migrate. You can specify either a site The site that you want to migrate. You can specify either a site description, such as “Default Web Site,” or the metabase key path, description, such as “Default Web Site,” or the metabase key path, such as W3SVC/1.such as W3SVC/1.

/user /user UserNameUserName NoNo The user name you want to use when connecting to the source The user name you want to use when connecting to the source server. You can specify either a server. You can specify either a UserNameUserName or a or a Domain\UserNameDomain\UserName. . If you do not specify a user name, the migration tool uses the If you do not specify a user name, the migration tool uses the current user’s credentials to connect to the source server. current user’s credentials to connect to the source server.

/password /password PasswordPassword NoNo The password for The password for UserNameUserName..

/path /path PathPath NoNo The location for the migrated site’s root directory on the target The location for the migrated site’s root directory on the target server; for example, D:\Inetpub\Wwwroot. The migration tool server; for example, D:\Inetpub\Wwwroot. The migration tool ignores the ignores the /path /path parameterparameter if the if the /configonly /configonly parameterparameter is specified.is specified.

/serverbindings /serverbindings ServerBindings StringServerBindings String

NoNo Allows you to change the IP address, the port, and the host header Allows you to change the IP address, the port, and the host header information for the site that will be migrated. The information for the site that will be migrated. The /serverbindings/serverbindings parameter uses the following syntax: parameter uses the following syntax: IP:Port:HostheadernameIP:Port:Hostheadername; for ; for example: 192.168.1.1:80:www.example.com. The format for the example: 192.168.1.1:80:www.example.com. The format for the ServerBindings StringServerBindings String is the same as it is for the IIS metabase is the same as it is for the IIS metabase property property ServerBindingsServerBindings, and you set it in exactly the same way that , and you set it in exactly the same way that you set the property using utilities such as Active Directory you set the property using utilities such as Active Directory Services Interface (ADSI) or Windows Management Instrumentation Services Interface (ADSI) or Windows Management Instrumentation (WMI). (WMI).

/siteid /siteid [SiteID] [SiteID] || ReplaceReplace NoNo The site ID for the Web site when it is created on the target server. The site ID for the Web site when it is created on the target server. If you want the migrated site to overwrite a site that has that site If you want the migrated site to overwrite a site that has that site ID on the target computer, use the ID on the target computer, use the ReplaceReplace parameter. parameter.

/configonly/configonly NoNo Instructs the migration tool to migrate only the IIS configuration, Instructs the migration tool to migrate only the IIS configuration, not the content files.not the content files.

/fpse/fpse NoNo Re-extends a FrontPage Server-extended site if that site was Re-extends a FrontPage Server-extended site if that site was extended on the source computer. This parameter is ignored if extended on the source computer. This parameter is ignored if the the /configonly /configonly parameter is used. parameter is used.

/verbose/verbose NoNo Displays the metabase path copy and file copy operations on the Displays the metabase path copy and file copy operations on the screen as they occur.screen as they occur.

/overwrite/overwrite NoNo Suppresses a message that prompts the user to confirm overwriting Suppresses a message that prompts the user to confirm overwriting an existing destination file or folder when content is copied from an existing destination file or folder when content is copied from the source to the target server.the source to the target server.

/noninteractive/noninteractive NoNo Suppresses messages that prompt the user for input. When this Suppresses messages that prompt the user for input. When this parameter is used, the migration tool exits when it encounters the parameter is used, the migration tool exits when it encounters the first error condition. This is a useful parameter for invoking the first error condition. This is a useful parameter for invoking the migration tool from a batch file or script program.migration tool from a batch file or script program.

IIS 6.0 Migration Tool: How it WorksIIS 6.0 Migration Tool: How it Works

Fab01

Fab2k3

Read Metabase.bin Copy Config from w3svc/223 to Fab2K3 into current Metabase

For each Path (IIsWebServer, IIsWebVirtualDir),copy content from Fab01 to Fab2K3 to directoryon the Target Server

Extend w3svc/223 foruse of FPSE

Clean Up!

Upside of the IIS 6.0 Migration ToolUpside of the IIS 6.0 Migration Tool

Very easily migrates website and virtual Very easily migrates website and virtual directories configuration informationdirectories configuration information

Uses standard SMB Connections for Uses standard SMB Connections for migrating content, up to and including migrating content, up to and including Dynamic Content such as ISAPI’s, CGI, and Dynamic Content such as ISAPI’s, CGI, and PHP.PHP.

Supports UNC paths for sites and virtual Supports UNC paths for sites and virtual directories as long as permissions are directories as long as permissions are adequate on the remote shareadequate on the remote share

Automatically Extends FrontPage webs Automatically Extends FrontPage webs where the administrator chooses using one where the administrator chooses using one easy switcheasy switch

Demonstration OneDemonstration One

Seeing a failure with Seeing a failure with ISAPI and the IIS 6.0 ISAPI and the IIS 6.0

Migration ToolMigration Tool

The purpose of this demonstration is to show how the The purpose of this demonstration is to show how the migration tool will move dynamic content such as ISAPI migration tool will move dynamic content such as ISAPI

or CGI, but will still not register the ISAPI\CGI hence or CGI, but will still not register the ISAPI\CGI hence still failing and causing clean up.still failing and causing clean up.

Upside of the IIS 6.0 Migration ToolUpside of the IIS 6.0 Migration Tool

The ability to restrict the tool to only The ability to restrict the tool to only copying the configuration using the easy copying the configuration using the easy switch /configswitch /config

Easily creates and tracks usages of the Easily creates and tracks usages of the Migration Tool by creating a file in the Migration Tool by creating a file in the following directory:following directory:systemrootsystemroot\System32\LogFiles\IISMT\Iismt\System32\LogFiles\IISMT\Iismt_datetime_number_datetime_number.log.log

Downside of the IIS 6.0 Migration ToolDownside of the IIS 6.0 Migration Tool

Failure to give detail output of errorsFailure to give detail output of errors Invalid Anonymous Account?Invalid Anonymous Account?

Because we are using custom anonymous accounts and Because we are using custom anonymous accounts and that account doesn’t exist on the target serverthat account doesn’t exist on the target server

Invalid Custom Error Paths?Invalid Custom Error Paths? The path isn’t valid, such as WINNT instead of WindowsThe path isn’t valid, such as WINNT instead of Windows

Failure to migrate FTP\SMTP sitesFailure to migrate FTP\SMTP sites SMTP sites are often relied on by applications on the SMTP sites are often relied on by applications on the

server, but the tool has no method of moving server, but the tool has no method of moving important SMTP sitesimportant SMTP sites

Downside of the IIS 6.0 Migration ToolDownside of the IIS 6.0 Migration Tool

Fails to account for new Web Service Extension Fails to account for new Web Service Extension if ISAPI\CGI is copiedif ISAPI\CGI is copied The existence of ScriptMaps are copied by IIS 6.0 The existence of ScriptMaps are copied by IIS 6.0

Migration Tool but the WebServiceExtensions Migration Tool but the WebServiceExtensions property “WebSvcExtRestrictionList” hence they fail property “WebSvcExtRestrictionList” hence they fail to work without administrator interventionto work without administrator intervention

If servers have extensive FPSE usage, the If servers have extensive FPSE usage, the migration tool fails to copy any built-in or custom migration tool fails to copy any built-in or custom rolesroles Only workaround is to rebuild all the roles which can Only workaround is to rebuild all the roles which can

be time consumingbe time consuming

Downside of the IIS 6.0 Migration ToolDownside of the IIS 6.0 Migration Tool

Fails to move any pertinent database Fails to move any pertinent database connections in the form of ODBCconnections in the form of ODBC Requires these to be moved manuallyRequires these to be moved manually

Requires that Administrative Shares on Source Requires that Administrative Shares on Source Server and Target ServerServer and Target Server For example, on the target server, if the content is For example, on the target server, if the content is

stored on d:\inetpub\wwwroot then the Administrative stored on d:\inetpub\wwwroot then the Administrative Share D$ must existShare D$ must exist

Downside of the IIS 6.0 Migration ToolDownside of the IIS 6.0 Migration Tool

Conclusion:Conclusion:

The IIS 6.0 Migration Tool is very useful in The IIS 6.0 Migration Tool is very useful in scenarios where large installations are scenarios where large installations are migrated to IIS 6.0. However, if the IIS 4/5 migrated to IIS 6.0. However, if the IIS 4/5 installation is a large FPSE environment installation is a large FPSE environment then the Post-Migration work will be large then the Post-Migration work will be large and daunting. In these situations, and daunting. In these situations, investigate doing a in-place upgrade or do investigate doing a in-place upgrade or do a staggered migration.a staggered migration.

SummarySummary

The IIS 6.0 Migration Tool is very useful and offers The IIS 6.0 Migration Tool is very useful and offers administrators a very quick method of copying the IIS administrators a very quick method of copying the IIS configurationconfiguration

The IIS 6.0 Migration Tool is very useful because it moves The IIS 6.0 Migration Tool is very useful because it moves configuration AND contentconfiguration AND content

Allows a migration of many different servers to be Allows a migration of many different servers to be consolidated to one single IIS 6.0 serverconsolidated to one single IIS 6.0 server

Demonstration TwoDemonstration Two

Migrating from IIS 4.0 to Migrating from IIS 4.0 to IIS 6.0 using the IIS 6.0 using the Migration ToolMigration Tool

Let’s just do it…Let’s just do it…

Demonstration ThreeDemonstration Three

Migrating from IIS 5.0 to Migrating from IIS 5.0 to IIS 6.0 using the IIS 6.0 using the Migration ToolMigration Tool

Let’s just do it…Let’s just do it…

References and ResourcesReferences and Resources

IIS 6.0 Migration Tool DocumentationIIS 6.0 Migration Tool Documentation http://www.microsoft.com/downloads/details.ahttp://www.microsoft.com/downloads/details.a

spx?FamilyID=56fc92ee-a71a-4c73-b628-ade62spx?FamilyID=56fc92ee-a71a-4c73-b628-ade629c89499&DisplayLang=en9c89499&DisplayLang=en

Resource Guide Information for IIS 6.0 Resource Guide Information for IIS 6.0 Migration ToolMigration Tool http://download.microsoft.com/download/7/4/f/http://download.microsoft.com/download/7/4/f/

74fe970d-4a7d-4034-9f5d-02572567e7f7/09_CH74fe970d-4a7d-4034-9f5d-02572567e7f7/09_CHAPTER_6_Migrating_IIS_Web_Sites_to_IIS_6.0APTER_6_Migrating_IIS_Web_Sites_to_IIS_6.0.doc.doc

Q & AQ & A