When installing a remote agent, the agent home value is not properly set and a different path is used

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.

Summary

When a user runs the official command to install a new remote agent, also specifying a home directory, a different home directory is used instead.

Environment

Any supported version of Bamboo.
Any supported environment to install remote agents.

Diagnosis

To describe this example, we will install a remote agent in Linux. The example command is as follows:

java -Dbamboo.home=/var/agent-home -jar atlassian-bamboo-agent-installer-x.x.x.jar <Bamboo Base URL>/agentServer/

The agent is installed and in the logs we then see:

INFO   | jvm 1    | 2022/03/30 11:42:53 | 2022-03-30 11:42:53,904 INFO [WrapperSimpleAppMain] [RemoteAgentHomeLocatorForBootstrap] Using agent home located at [/var/differentDirectory]

Cause

As far as we have observed, there are 2 known causes for this problem:

Cause 1

There is a formatting error in the command, and the java argument is not properly loaded.

Cause 2

The installation process creates the file conf/wrapper.conf, which contains a lot of information, including the absolute path to the home directory. If the file already exists prior to the command execution, then there will be mismatches in the installation.

This is a common scenario when the installation process is automated and there is a pre-existing home directory (for example, in a Docker image).

Solution

Make sure you are installing the agent in a clean empty directory.

Last modified on Jul 15, 2022

Was this helpful?

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