How to migrate an existing Remote Agent to a new Bamboo instance
Platform Notice: Data Center Only - This article only applies to Atlassian products on the Data Center platform.
Note that this KB was created for the Data Center version of the product. Data Center KBs for non-Data-Center-specific features may also work for Server versions of the product, however they have not been tested. Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.
*Except Fisheye and Crucible
Summary
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:
Stop the remote agent you wish to connect to the new Bamboo instance - How to Run, Install, Start, and Stop Remote Agents.
Open the remote agent wrapper file under the path
<bamboo-agent-home>/conf/wrapper.conf.Rename the
wrapper.app.parameterline where the<bamboo-server-URL>is set, for the new Bamboo URL being used.1 2 3 4Application 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.
1
2
3
4
5
6
7
8
9
10
11
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.
Was this helpful?