How to re-enable plugin upload in Jira Data Center

Still need help?

The Atlassian Community is here for you.

Ask the community


Platform Notice: Data Center - This article applies to Atlassian products on the Data Center platform.

Note that this knowledge base article was created for the Data Center version of the product. Data Center knowledge base articles 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

Plugin upload from the Jira UI (upload app link) is disabled by default on Jira versions equal to or higher than 9.4.17, 9.12.4, 9.14.0, or any other Jira version with Universal Plugin Manager 6.1.9 or higher.

Details of this change can be found on:

JRASERVER-77129 - Getting issue details... STATUS

If you need to upload apps (as in environments not connected to Atlassian Marketplace), you can either re-enable this feature or upload the app directly to the nodes. All are shown below.

Environment

  • Jira on versions equal to or higher than 9.4.17, 9.12.4, and 9.14.0;  OR
  • Jira on lower versions but using Universal Plugin Manager version 6.1.9 or higher.

Enable app upload with Java Virtual Machine (JVM) flag

The Jira administrator can enable the app upload by using the JVM flag "-Dupm.plugin.upload.enabled=true" (recommended method) or set the Jira to developer mode (only recommended for developers, as this can cause performance issues).

So, to enable the upload app link with the UPM flag, please perform the following in all nodes:

  • Stop Jira.
  • Add the "-Dupm.plugin.upload.enabled=true" to the Jira settings.

    • For Linux, edit Jira_install_directory/bin/setenv.sh (example below).

      JVM_SUPPORT_RECOMMENDED_ARGS="-Dupm.plugin.upload.enabled=true"
    • For Windows, add the flag as seen here.
    • For Kubernetes/helm charts, edit the values.yaml and add the flag in the additionalJvmArgs.

        # Specifies a list of additional arguments that can be passed to the Jira JVM, e.g.
        # system properties.
        #
        additionalJvmArgs:
          - "-Dupm.plugin.upload.enabled=true"
  • Restart Jira.

Alternative: upload app JAR file manually

If, for security reasons, the Jira admin cannot enable the upload app through UI, the app still can be uploaded directly to the node plugin folder (more details here) as the following:

  1. Stop Jira.
  2. Copy your JAR file into the directory:
  3. Start Jira.
  4. Confirm the installation by going to  Administration  >  Manage Add-ons. The add-on should appear in the list as enabled.




Last modified on Nov 12, 2024

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.