If you have implemented your own remote agent service wrapper or have problems with the service wrapper used by the remote agent supervisor in Bamboo, you can install the legacy remote agent (pre-Bamboo 2.2) which does not have a service wrapper.
![]() | Before you begin:
|
Step 1. Download and install the Legacy Remote Agent
- Create a directory on the agent machine (e.g.
bamboo-agent-home
), to serve as the "Bamboo agent home" for the remote agent. - On your Bamboo server, click the 'Administration' link in the top navigation bar.
- Click the 'Agents' link in the left navigation column.
- This will display the 'Agents' screen, showing lists of all Local Agents and all Remote Agents that currently exist in your Bamboo system.
- Click the 'Install Remote Agent' button. The 'Install Remote Agent' screen will be displayed.
- Click the 'bamboo-agent-.jar' link in the 'Running the agents without the service wrapper' section and save the JAR file to the directory you created in step 1.1.
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 may wish to configure the remote agent machine to start the Bamboo remote agent automatically when the machine boots. Please consult your operating system documentation for instructions on how to do this. |
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 -Dbamboo.home=RemoteAgentHome where RemoteAgentHome is the path to the Bamboo agent home directory you created in step 1.1. 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 (https) with a self-signed certificate, you will need to carry out one of the following two options:
|
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.