Creating a Remote Agent

To install the Bamboo Remote Agent manually,

Step 1. Download and Install the Remote Agent

1. Create a directory on the agent machine (e.g. bamboo-agent-home), to serve as the "Bamboo agent home" for the remote agent.
2. On your Bamboo server, click the  'Administration' link in the top navigation bar.
   
3. Click the 'Agents' link in the left navigation column.
   
4. This will display the 'Agents' screen, showing lists of all Local Agents and all Remote Agents that currently exist in your Bamboo system.
5. Click the 'Install Remote Agent' button.
6. The following screen will be displayed:
   
7. Click the 'DOWNLOAD Remote Agent JAR' button and save the JAR file to the directory you created in step 1.1.
8. Note the command under the heading 'Running a Remote Agent' for use in step 2 below.

Step 2. Launch the Remote Agent

Once installed, you can run the remote agent by executing the command line obtained in the previous step. This command will look something like the following:

java -jar bamboo-agent-2.0-SNAPSHOT.jar http://bamboo-host-server:8085/agentServer/

You can also choose to run the remote agent with different command line parameters, to change where the remote agent stores its data or suppress the self-signed certificate of the server.

• Changing where the remote agent stores its data
  By default, the remote agent will store its data in a directory called bamboo-agent-home. If you wish to specify a different directory, add the following command line parameter:

  -Dbamboo.home=RemoteAgentHome

  where RemoteAgentHome is the path to the Bamboo agent home directory you created in step 1.1.
  Your command line will look something like this:

  java -Dbamboo.home=RemoteAgentHome -jar bamboo-agent-2.0-SNAPSHOT.jar http://bamboo-host-server:8085/agentServer/
  

• Suppressing the self-signed certificate of the server
  If your Bamboo server uses SSL, the following instructions will also appear in the 'Running a Remote Agent' section:
  
  You will need to carry out either one of the two options listed above.
  The first option of suppressing the self-signed certificate is simple to execute, but will reduce the security of your configuration (as described in the instructions). To suppress the self-signed certificate, add the following command line parameter:

  -Dbamboo.agent.ignoreServerCertName=true

  Your command line will look something like this:

  java -Dbamboo.agent.ignoreServerCertName=true -jar bamboo-agent-2.0-SNAPSHOT.jar http://bamboo-host-server:8085/agentServer/
  

  The second option of adding the self-signed certificate to the trusted certificates in your keystore is the more secure option, but is complex to set up. For detailed instructions of how to do this, please refer to the relevant Sun documentation.

Step 3. Configure the Remote Agent's Capabilities

Please see Configuring Capabilities.

Step 4. (Optional) Rename the Remote Agent

Your new remote agent has been automatically given a default name (e.g. 'Remote Agent on mymachine'). If you wish to rename your new remote agent, please see Editing an Agent's Details.