Debugging Subversion connection in Bamboo

To debug your SVN connection, it is useful to enable logging. Modify the system property while launching the Java VM with:

$java -Djava.util.logging.config.file=path/to/logging.properties.disabled

To do this:

Local Agents

1) Download the logging.properties.disabled file attached to this document.

The logging.properties.disabled file contains a system property svnkit.level used to control the log level:

• FINE (default) — the level for non-detailed logging
• FINER — the level for more detailed logging
• FINEST ---  the level for full logging

2) Configure Bamboo to start with the -Djava.util.logging.config.file=*path/to/*logging.properties.disabled command, where "path/to/" refers to the absolute path to the logging.properties.disabled file from step (1).

The method of doing this depends on which operating system you are using:

• If you are running Bamboo under Linux:
  Modify the bamboo .sh script to pass in the logging parameter. To do this, find the following section:

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

  Change the RUN_CMD variable to:

  RUN_CMD="java -Xms256m -Xmx512m -XX:MaxPermSize=256m -Djava.awt.headless=true -classpath $CLASSPATH -Dorg.mortbay.xml.XmlParser.NotValidating=true -Djava.util.logging.config.file=*path/to/*logging.properties.disabled -Djetty.port=8085 com.atlassian.bamboo.server.Server 8085 ./webapp /"
  

• If you are running Bamboo under Windows:
  Modify the <Bamboo_install_Home>/conf/wrapper.conf file to add the logging parameter. To do this, find the following section:

  ...........................
  wrapper.java.classpath.1=../lib/*.jar
  wrapper.java.classpath.2=../lib
  wrapper.java.classpath.3=../webapp/WEB-INF/classes
  wrapper.java.classpath.4=../webapp/WEB-INF/lib/*.jar
  wrapper.java.library.path.1=../lib
  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
  ...........................
  

  Add the following line to the end of the section:

  wrapper.java.additional.4=-Djava.util.logging.config.file=*path/to/*logging.properties.disabled
  

3) Increase the log level for bamboo's subversion modules.
Edit your <bamboo-install>/webapps/WEB-INF/classes/log4j.properties file and append

log4j.category.com.atlassian.bamboo.v2.trigger=DEBUG
log4j.category.com.atlassian.bamboo.repository.svn=DEBUG
log4j.category.com.atlassian.bamboo.v2.build=DEBUG

4) Save your changes, and restart Bamboo for your changes to take effect.

5) You will find the SVNKit log file in USER_HOME/svnkit.0.log (where USER_HOME is the home directory of the user running Bamboo or logged in e.g: /home/user/svnkit.0.log).

Remote Agents

1) Download the logging.properties.disabled file attached to this document.

2) To debug the SVNKit component in Remote Agents, you will need to run the Agent without its Supervisor ('Classic' mode). After Downloading the classic Agent, run the following command:

java -jar -Djava.util.logging.config.file=logging.properties.disabled bamboo-agent-2.5.jar http://bamboo_server_hostname:8085/agentServer/

3) Run the build that will use the Remote Agent.

4) You will find the SVNKit log file in USER_HOME/svnkit.0.log (where USER_HOME is the home directory of the user running Bamboo or logged in e.g: /home/user/svnkit.0.log).