Adding classes to OSGi boot class loader (BootDelegation)
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
This problem is related to a third party plugin, and therefore not supported by Atlassian. See Atlassian Supported Plugins for more information.
Purpose
Some third-party apps or external tools require its classes or dependencies to be loaded by the OSGi framework, and most documented procedures involve modifying the default parameter:
-Datlassian.org.osgi.framework.bootdelegationHowever, this is unsupported and it could cause unintended effects on Jira's startup process or of its installed apps. This is one of the reasons we introduced a new flag to the Atlassian Plugin Framework, our implementation of OSGi:
-Datlassian.org.osgi.framework.bootdelegation.extraThis new flag will append classes to our default configuration of boot delegation, minimizing the risk of negatively impacting the application's behavior.
Solution
To introduce this flag in your installation you may follow the same steps as instructed by the vendor requiring this change to setup their tool or app, but append the '.extra' to the end of the parameter and input only the classes linked to the app or tool. Here is an example:
-Datlassian.org.osgi.framework.bootdelegation.extra=com.mycompany.myapp.*,com.mycompany.myotherapp.*