How to configure temporary directory on a FreeBSD OS Bamboo remote agent

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

The information on this page relates to customizations in Bamboo. Consequently, Atlassian Support cannot guarantee to provide any support for the steps described on this page as customizations are not covered under Atlassian Support Offerings. Please be aware that this material is provided for your information only and that you use it at your own risk.

Also, please be aware that customizations done by directly modifying files are not included in the upgrade process. These modifications will need to be reapplied manually on the upgraded instance.

This document covers how to change a temporary directory on remote agents running on the FreeBSD OS server. We have seen some scenarios where remote agents running on the FreeBSD OS server don't generate a <remote-agent-install>/conf/wrapper.conf file and will not be possible to change the temporary directory directly through the wrapper.conf file as explained in the document how-to-configure-temporary-directory-in-bamboo-remote-agent. If you are running remote agents on the FreeBSD OS server and you see a wrapper.conf file under <remote-agent-install>/conf directory, you can change the temporary directory by following the steps mentioned in the document how-to-configure-temporary-directory-in-bamboo-remote-agent. And in case there is no <remote-agent-install>/conf/wrapper.conf file created on your remote agent, you can follow the below steps mentioned in this document under the solution section.

Environment

Applicable to remote agents running on FreeBSD 11 OS server on all supported versions of Bamboo.

Solution

Please follow the below steps to change the temporary directory for a Bamboo remote agent running on the FreeBSD OS server:

  1. Stop the remote agent.

  2. Start the remote agent now with below command:

    1 $Java_Home_Path -Dbamboo.home=<Bamboo-agent-home> -Dwrapper.java.additional.X="Djava.io.tmpdir=<Temp_directory_path>" -jar <Bamboo-agent-home>/lib/bamboo-agent-bootstrap.jar <Bamboo-Base_URL>/agentServer/

    ℹ️ Replace <Temp_directory_path> with the temporary directory path you want set on remote agent

    ℹ️ Replace <Bamboo-Base_URL> with your Bamboo base url

    ℹ️ Replace $Java_home_path with Java home path which remote agent server is installed

    ℹ️ Replace "X" value in the "-Dwrapper.java.additional.X" parameter with the next number following the sequence

    ℹ️ Replace <Bamboo-agent-home> with the Bamboo agent home path

    For example:

    1 /usr/local/openjdk8/jre/bin/java -Dbamboo.home=/var/atlassian/application-data/bamboo-agent/ -Dwrapper.java.additional.4="Djava.io.tmpdir=/var/atlassian/application-data/bamboo-agent/tmp" -jar /var/atlassian/application-data/bamboo-agent1/lib/bamboo-agent-bootstrap.jar https://linux-37467.prod.atl-cd.net/bamboo/agentServer/
  3. It would set the temporary path successfully on the remote agent. You can double-check if the parameter has been picked up by Bamboo by going to Bamboo Overview >Agents > Click on the particular agent > System Properties and looking for it in the Bamboo Paths section:

(Auto-migrated image: description temporarily unavailable)
Updated on April 2, 2025

Still need help?

The Atlassian Community is here for you.