How to migrate an existing Remote Agent to a new Bamboo instance

Still need help?

The Atlassian Community is here for you.

Ask the community

Platform Notice: Server and Data Center Only. This article only applies to Atlassian products on the server and data center platforms.

Purpose

This article shows how to migrate existing remote agents to a new Bamboo instance.

Solution

If the Bamboo instance is hosted at that same URL as the current Bamboo instance, no changes are needed. 

If it is a new URL for the new Bamboo instance, please follow the steps below:

  1. Stop the remote agent you wish to connect to the new Bamboo instance - How to Run, Install, Start, and Stop Remote Agents.
  2. Open the remote agent wrapper file under the path <bamboo-agent-home>/conf/wrapper.conf.
  3. Rename the wrapper.app.parameter line where the <bamboo-server-URL>  is set, for the new Bamboo URL being used.

    Application parameters. Add parameters as needed starting from 1
    wrapper.app.parameter.1=com.atlassian.bamboo.agent.bootstrap.AgentBootstrap
    wrapper.app.parameter.2=<bamboo-server-URL>/agentServer/
    wrapper.app.parameter.3=

       4. Start the remote agent.

On the remote agent logs, we should see HTTP connecting being created and waiting for approval on the Bamboo side. Agent logs can be found under the path <bamboo-agent-home>/logs.

INFO | jvm 1 | 2022/01/20 11:40:13 | 2022-01-20 11:40:13,813 INFO [WrapperSimpleAppMain] [RemoteAgentHttpClientFactory] Creating a new HTTP client...
INFO | jvm 1 | 2022/01/20 11:40:14 | 2022-01-20 11:40:14,782 INFO [WrapperSimpleAppMain] [AgentContext] Authenticating against Bamboo server at http://<bamboo-server-URL>/agentServer/
INFO | jvm 1 | 2022/01/20 11:40:15 | 2022-01-20 11:40:14,938 WARN [WrapperSimpleAppMain] [AgentContext]
INFO | jvm 1 | 2022/01/20 11:40:15 |
INFO | jvm 1 | 2022/01/20 11:40:15 | ********************************************************************************
INFO | jvm 1 | 2022/01/20 11:40:15 | *
INFO | jvm 1 | 2022/01/20 11:40:15 | * This agent requires manual approval.
INFO | jvm 1 | 2022/01/20 11:40:15 | * UUID: 8cvda656-gcb7-4fb3-af6d-637f8vbcvba1
INFO | jvm 1 | 2022/01/20 11:40:15 | * Message from the server is:
INFO | jvm 1 | 2022/01/20 11:40:15 | * Approve this agent at 'http://<bamboo-server-URL>/admin/agent/viewAgents.action?focusUuid=8cvda656-gcb7-4fb3-af6d-637f8vbcvba1&selectedTab=Agent+authentication'. Check that the IP is correct.
INFO | jvm 1 | 2022/01/20 11:40:15 | * Next authentication attempt in 60 seconds...

          5. On the new Bamboo instance under Cog > Agents > on the Agent authetication tab > Operations > Approve access .

          


Please note that the same remote agent can not connect simultaneously to more than one Bamboo instance.



Last modified on May 24, 2022

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.