This topic leads you through the steps to install the Microsoft Web Deployment Tool. Learn what installation options exist, how to install MS Deploy and how to customize the URL for the remote service.
Prerequisites
This topic requires the following prerequisites:
• .NET Framework 2.0 SP1 or greater
• MS Deploy Beta 1
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: If you use the source as the remote server that you’re calling, you only need to install the remote service on that source machine. You’ll be using msdeploy.exe from the destination to request data remotely from the source. The remote service is not required on both machines in this case.
To install MS Deploy using the default remote service URL
1. Download the Microsoft Web Deployment Tool (MS Deploy) from http://www.iis.net.
2. Run the MSI file to install MS Deploy.
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 MS Deploy with a custom remote service URL
1. Download the Microsoft Web Deployment Tool (MS Deploy) from http://www.iis.net.
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 <msi_filename> /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%\Microsoft Web Deploy. This cannot be changed.
Starting the Remote Service after Installation
The remote service will listen on http://+:80/MSDEPLOY/ 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 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 MS Deploy and configured the remote service, if you chose to install it.
Comments