Bamboo does not start after License key updated in bamboo.cfg.xml
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
Problem
After updating your Bamboo license key in the <bamboo-home>/bamboo.cfg.xml file, the following error shows in the UI and atlassian-bamboo.log:
1
Bamboo bootstrap failed: Failed to parse config file: Error on line XX of document : Element type "part-of-key-here" must be followed by either attribute specifications, ">" or "/>".Cause
Some license keys now contain the < symbol, which is a special character in XML.
Resolution
To resolve this issue, please replace the < symbol in your new license key with its encoded equivalent, <.
For example, for the following randomly-generated string:
1
r6SP4kIvsXT4ETL3rzPLPKmQKspQfpGs83IgNy4EQtStM4M4R9EoYoj7AUq3CBJP<FNzqmgfhaL8SfcCxX9jbyM92fxyWL3nbMsdosC<z02PhuWSvjuY4hgWloOhmbEsIt would need to be replaced with:
1
r6SP4kIvsXT4ETL3rzPLPKmQKspQfpGs83IgNy4EQtStM4M4R9EoYoj7AUq3CBJP<FNzqmgfhaL8SfcCxX9jbyM92fxyWL3nbMsdosC<z02PhuWSvjuY4hgWloOhmbEsIf you add the license key through the Bamboo UI, for example before stopping Bamboo for an upgrade, this encoding will be done for you.
Was this helpful?