Bamboo upgrade failing with error "Exception starting filter license"
Platform notice: Server and Data Center only. This article only applies to Atlassian products on the Server and Data Center platforms.
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
While upgrading Bamboo, Upgrade fails with error "Exception starting filter - license"
Environment
Issue seen while upgrading from 7.2.4 to 8.2.2
Diagnosis
Following error is seen on the application and catalina logs.
ERROR [localhost-startStop-1] [[/]] Exception starting filter [license]
java.lang.ClassNotFoundException: com.atlassian.bamboo.filter.LicenseFilter
at org.apache.catalina.loader.WebappClassLoaderBase.loadClass(WebappClassLoaderBase.java:1420)
SEVERE [localhost-startStop-1] org.apache.catalina.core.StandardContext.startInternal One or more Filters failed to start. Full details will be found in the appropriate container log file
Cause
The cause of the Issue is wrong filter-class com.atlassian.bamboo.filter.LicenseFilter present in BAMBOO-INSTALL/atlassian-bamboo/WEB_INF/web.xml file.
<filter>
<filter-name>license</filter-name>
<filter-class>com.atlassian.bamboo.filter.LicenseFilter</filter-class>
</filter>
This filter is present in web.xml of 7.2.4 and not for 8.2.2 in the default configurations.
Solution
- The first option is to remove the filter from web.xml file as mentioned under the cause section and restart Bamboo.
- Other option is to download a fresh installation folder and restart the upgrade process, this is to rule out the possibility of the corruption of the installation folder.