Summary

The outlined document addresses an expected behavior occurring after upgrading Bamboo server to version 6.10 and above, where the agent fails to start with the following error: A valid license was not found in the Wrapper configuration file.

As a result of an update to the Tanuki wrapper used for Bamboo remote agent, users are advised to reinstall the wrapper to benefit from all bug fixes.

Environment

Bamboo 6.10 and above.

Diagnosis

The following error can be found in <bamboo-remote-agent-home>/atlassian-bamboo-agent.log :

ERROR | wrapper | License Error:
ERROR | wrapper | A valid license was not found in the Wrapper configuration file.
ERROR | wrapper |
ERROR | wrapper | The Java Service Wrapper requires a License Key to activate the
ERROR | wrapper | software. Licenses can be purchased on the Java Service Wrapper
ERROR | wrapper | web site:
ERROR | wrapper | http://wrapper.tanukisoftware.com/purchase
ERROR | wrapper |
ERROR | wrapper | You can also immediately obtain a one-month Free trial license:
ERROR | wrapper | http://wrapper.tanukisoftware.com/trial

Cause

The cause of the issue is the updated Tanuki wrapper in Bamboo 6.10, which requires reinstallation to benefit from the bug fixes. Without this, the remote agent side may not function as expected.

Solution

To address some knows issues, the Tanuki wrapper used for Bamboo remote agent was updated. Bamboo 6.10 was released with a new version of the wrapper. If you're an upgrading user, we strongly recommend that you reinstall the wrapper to benefit from all bug fixes.

To update the wrapper on a remote agent:

1. Stop the original agent.
2. Backup the BAMBOO_AGENT_HOME/conf/wrapper.conf file.
3. Remove the BAMBOO_AGENT_HOME/conf directory.
4. Download a new Remote Agent JAR from your Bamboo Server: http://<BAMBOO_URL>/admin/agent/addRemoteAgent.action.
5. Launch the remote agent.
6. This will create a new wrapper.conf file. If you want to re-enact your custom configuration in the wrapper.conf  file, you can do it now.