Microsoft KB Archive/326355

= How to deploy an ASP.NET Web application using Xcopy deployment =

Article ID: 326355

Article Last Modified on 2/4/2005

-

APPLIES TO


 * Microsoft ASP.NET 1.1
 * Microsoft ASP.NET 1.0

-



This article was previously published under Q326355



IN THIS TASK
SUMMARY
 * What is Xcopy deployment?
 * The advantages of Xcopy deployment
 * The differences between Xcopy deployment and Copy Project in Visual Studio .NET
 * Set the virtual directory as an Internet Information Services (IIS) application
 * Troubleshooting

REFERENCES



SUMMARY
This article describes how to use the MS-DOS Xcopy command to deploy a Microsoft ASP.NET Web application. Xcopy style deployment is not suited for all situations. For large Web sites and for line-of-business applications, we recommend that the site be temporarily taken offline. You want to do this while the new content and the application assemblies are deployed. You should perform this maintenance at a convenient, scheduled time. To minimize the scheduled downtime, follow these steps:
 * 1) Create a new physical directory for the application that you want to update. Copy all new content to the new physical directory.
 * 2) Reconfigure the virtual directory for the application to point to the new physical directory with the new content.

Note When you deploy new content to an ASP.NET Web application, the application may restart. If you have large applications and complex applications that have significant memory requirements, memory consumption may be increased. When you restart the application, supportability issues may occur. This includes loss of the user session state.

back to the top

What is Xcopy deployment?
Xcopy deployment describes deployment in ASP.NET where you use the drag-and-drop feature in Microsoft Windows Explorer, File Transfer Protocol (FTP), or the DOS Xcopy command to copy files from one location to another. The ASP.NET application requires no modifications to the registry and has no special installation requirements for the host company on hosted sites.

back to the top

The advantages of Xcopy deployment
An Xcopy-style file transfer simplifies the deployment and the maintenance of ASP.NET sites because you make no registry entries and because you register no components. The Microsoft .NET applications are self-describing, typically with no dependencies. With assembly versioning, you can even copy a new copy of a DLL that the application uses without stopping the Web server.

back to the top

The differences between Xcopy deployment and Copy Project in Visual Studio .NET
Xcopy deployment does not require that you install any special software on the development computer or on the Web server. The Visual Studio .NET Copy Project method requires that you install Microsoft FrontPage Server Extensions (FPSE) on the remote server. Xcopy also permits you to replace only the most recently-edited files. You can either select the files manually to replace them, or you can use the /d switch on the Xcopy command to specify the date, as follows:

xcopy source [destination] /D:m-d-y

back to the top

Set the virtual directory as an Internet Information Services (IIS) application
If you have not already set up the destination directory, you must set it up as an application in Microsoft Internet Information Services (IIS) before you transfer the files. To set up the virtual directory, follow these steps:
 * 1) Click Start, point to Programs, point to Administrative Tools, and then click Internet Services Manager.
 * 2) In the left pane, right-click the name of your virtual directory, and then click Properties.
 * 3) Make sure that the Web site name or the name of the virtual directory is listed in the Application Name box under Application Settings. If it is not, click Create.

For additional information, click the following article number to view the article in the Microsoft Knowledge Base:

172138 How to create a virtual directory in Internet Information Services (IIS)

back to the top

Troubleshooting
In some cases you cannot complete the deployment of the ASP.NET Web application through the Xcopy file transfer alone. These cases include the following:
 * Assemblies that require you to install in the Global Assembly Cache (GAC). If you must share any of the assemblies that ASP.NET uses across multiple application domains, you must use the Gacutil.exe utility to register those assemblies into the GAC. You must unregister, replace, and then re-register assemblies each time that you deploy the application.
 * COM Interop. If the ASP.NET application uses any Component Object Model (COM) components through COM interop, you must register those COM components with COM+ Services.
 * Serviced components. Microsoft recommends that you use the Regsvcs.exe utility to register any classes that use COM+ services (those that are derived from the System.EnterpriseServices.ServicedComponent class).

back to the top

