Installing the Agent service - Deployment Manager

You need to install the Deployment Agent service on any machine that you want to deploy software to using Deployment Manager.

Requirements

Target machines require:

• Windows Server 2003 or later

  Note: Windows Server 2003 servers require Windows Management Framework

• .NET Framework 4.0 (download the installer from Microsoft)
• Windows PowerShell 2.0 or later

  This is automatically installed on 2008 R2, but for 2008 pre-R2 you need to install it (x86 download, x64 download)

Installation

To install the Agent service on a machine:

1. On the computer you want to deploy to, download the Agent MSI.
2. Install the MSI, following the instructions.

   An administration application is launched when the installation is complete:

   

3. On the Deployment tab, specify a TCP port number for the machine to listen on.

   Machines listen on TCP port 10301 by default.

   Note: You need to configure a firewall rule to allow access to the port you choose. For more information, see: Linking Deployment Manager to Agents.

4. On the Service tab, click Install or Restart, and wait until the service is running.

Linking a target machine to Deployment Manager

Once you have installed the Agent service on your target machine, you need to add it to the Deployment Manager web interface:

1. In the Deployment Agent administration application, on the Security tab, copy the Agent key:

   

2. In a web browser, navigate to the Deployment Manager web interface, and click the Environments tab:

   

3. To create an environment to add the Agent to, in the Deployment Manager menu bar, click Add environment:

   

4. Specify a name for the environment, and click Create.

   In the example below, we have created a Staging environment:

   

5. On the environment menu bar, click Add machine:

   

   The Add machine dialog box is displayed:

   

6. On the Add machine dialog box, specify a name and the URL for the target machine.
7. In the Agent Key box, paste the Agent key you copied from the Deployment Agent administration application.
8. At the bottom of the dialog box, copy the Deployment Manager server key:

   

9. Click Create.

   The machine is added to the web interface.

10. In the Deployment Agent administration tool, on the Security tab, under Server Keys, click Add:

    

11. In the Add Trusted Deployment Manager dialog box, paste the server key you copied from the web interface, and click Save.
12. On the Service tab, click Restart to restart the Agent service.

    A trust relationship between the target machine and the Deployment Manager server is now set up.