How to deploy an ASP.NET Web application using Xcopy deployment
IN THIS TASK
- Create a new physical directory for the application that you want to update. Copy all new content to the new physical directory.
- 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.
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 deploymentAn 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 .NETXcopy 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:
Set the virtual directory as an Internet Information Services (IIS) applicationIf 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:
- Click Start, point to Programs, point to Administrative Tools, and then click Internet Services Manager.
- In the left pane, right-click the name of your virtual directory, and then click Properties.
- 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.
TroubleshootingIn 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).
Article ID: 326355 - Last Review: 06/18/2012 07:42:00 - Revision: 4.0
- kbdeployment kbhowtomaster KB326355