Installing the Web Deployment Tool

What can be installed

  • Web Deployment Tool – Managed code framework that includes the public APIs and underlying engine. (This is the top-level node and cannot be removed.)
    • IIS Manager UI Module – UI module that allows users to perform a subset of deployment tasks, mainly packaging or deploying a Web site or app. Requires IIS 7.0 or IIS Remote Manager to be installed.
    • Remote Agent Service – An administrator-only service based on HTTP/HTTPS that allows server admins to connect and perform remote operations.
    • IIS 7.0 Deployment Handler – A handler that integrates with WMSVC and allows non-administrators or administrators to perform remote operations. Requires IIS 7.0 with WMSVC installed.

Choosing installation options

Before you install, decide whether you want to use the remote service to perform live operations between two servers, or if you prefer the offline mode. The remote service is not started by default and is set to Manual startup. It is only required to have it running during an operation and it can be stopped when not in use.
Offline mode is simply installation of the tool without the service. It requires you to create a local copy of a site or server, then manually copy this “snapshot” or archive to the destination.
Important note about installing the remote service: You only need the remote service installed on either the source or the destination of a sync. For example, to “push” all content from GoldenServer1 to Client1, Client2, etc., you would install the remote service on all client machines so that the content can be pushed from the source. Alternatively, you could have each client “pull” from the GoldenServer1, and only install the remote service on the source.

To install the tool using the default remote service URL

1. Download the Web Deployment Tool (x86 / x64).
2. Run the MSI file to install the tool.
3. Select a Custom installation to choose what to install.
4. Click on the remote service node to install the remote service.
5. Complete the installation.
6. Manually start the service by running the following command:

net start msdepsvc

7. Ensure that port 80 is open in the firewall.

To install the tool with a custom remote service URL

1. Download the Web Deployment Tool (x86 / x64).
2. Open an administrative command prompt on Windows Server 2008, or a command prompt on Windows 2003.
3. Change directory to the location of the setup file.
4. Run the following command (where the port and URL are specified, please customize):
msiexec /i  /passive ADDLOCAL=ALL LISTENURL=http://+:8080/MSDEPLOY2/
5. Manually start the service by running the following command:

net start msdepsvc

6. Ensure that the port you’ve chosen is open in the firewall.
The tool will be installed to %programfiles%IISMicrosoft Web Deploy. This cannot be changed.

Starting the Remote Service after Installation

The remote service will listen on http://+/MSDEPLOYAGENTSERVICE/ by default, or at whatever URL that you specified if you performed a custom installation.
You should now start the remote service. You can do this by going to Start > Run and typing services.msc. The service is listed as the Microsoft Web Deployment Agent Service.
The service startup is Manual by default, you can set the startup to Automatic in services.msc. You can also use the command-line tool, sc.exe, to set the startup to Automatic. Sc.exe is described in more detail in the following KB article, http://support.microsoft.com/kb/251192.

Example:

sc config msdepsvc start=auto

Summary

You have now installed the tool and configured the remote service, if you chose to install it. For more information, see Microsoft’s MS Deploy Installation guidance.

Leave a Reply

Your email address will not be published. Required fields are marked *