Configuring system properties

Configuring a Bamboo system property (UNIX)

Before you begin:

• Bamboo must be shut down before modifying any of its system properties. Once you have modified one or more system properties, they will come into effect when Bamboo is restarted.
• If you have any elastic agents running, ensure that they are shut down before you restart the Bamboo server. If you do not shut down your elastic instances before restarting, they will continue to run and become orphaned from your Bamboo server.

To configure a system property via the bamboo.sh file:

1. Open the Bamboo start-up script bamboo.sh in a text editor. (This is usually located at the root of your Bamboo installation directory.)

2. Locate the variable RUN_CMD in bamboo.sh and add the system property as a parameter to the java command string value of RUN_CMD, by adding the '-D' prefix to the system property.
   For example, if you wanted to set the bamboo.agent.heartbeatInterval system property to 10 (seconds), you would add the parameter -Dbamboo.agent.heartbeatInterval=10 to the java command string value of RUN_CMD such that the RUN_CMD variable assignment in bamboo.shmight look like:

   RUN_CMD="java -server -Xms256m -Xmx512m -XX:MaxPermSize=256m -Dbamboo.agent.heartbeatInterval=10 -Djava.awt.headless=true -classpath $CLASSPATH -Dorg.mortbay.xml.XmlParser.NotValidating=true -Djetty.port=8085 com.atlassian.bamboo.server.Server 8085 ./webapp /"
   

3. Save your changes to the bamboo.sh file and start Bamboo.

Configuring a Bamboo system property (Windows)

Before you begin:

• Bamboo must be shut down before modifying any of its system properties. Once you have modified one or more system properties, they will come into effect when Bamboo is restarted.
• If you have any elastic agents running, ensure that they are shut down before you restart the Bamboo server. If you do not shut down your elastic instances before restarting, they will continue to run and become orphaned from your Bamboo server.

To configure a system property via the Java Service Wrapper wrapper.conf configuration file:

1. Open the Bamboo Wrapper configuration file wrapper.conf in a text editor. (This is usually located in the conf subdirectory of your Bamboo installation directory.)
2. Locate the set of variables beginning wrapper.java.additional.X, where X is a series of consecutive numbers starting from '1'. After the final wrapper.java.additional.X variable in this set, add a new variable wrapper.java.additional.Y, where Y is the next consecutive number in this set of variables.

3. Add the entire system property with the Java '-D' prefix and assign it to the value of wrapper.java.additional.Y.
   For example, if you wanted to set the bamboo.agent.heartbeatInterval system property to 10 (seconds), you would add a new variable wrapper.java.additional.4 to wrapper.conf and assign it the value -Dbamboo.agent.heartbeatInterval=10, such that this section of the wrapper.conffile might look like:

   wrapper.java.additional.1=-Dorg.mortbay.xml.XmlParser.NotValidating=true
   wrapper.java.additional.2=-XX:MaxPermSize=256m
   wrapper.java.additional.3=-Djava.awt.headless=true
   # And now for the new variable:
   wrapper.java.additional.4=-Dbamboo.agent.heartbeatInterval=10
   

4. Save your changes to the wrapper.conf file and start Bamboo.