Bamboo Agent Start-Up Error due to Missing License in Java Service Wrapper Configuration
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 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 :
1
2
3
4
5
6
7
8
9
10
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/trialCause
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:
Stop the original agent.
Backup the BAMBOO_AGENT_HOME/conf/wrapper.conf file.
Remove the BAMBOO_AGENT_HOME/conf directory.
Download a new Remote Agent JAR from your Bamboo Server: http://<BAMBOO_URL>/admin/agent/addRemoteAgent.action.
Launch the remote agent.
This will create a new wrapper.conf file. If you want to re-enact your custom configuration in the
wrapper.conffile, you can do it now.
See Bamboo 6.10 Upgrade Notes for more details.
Was this helpful?