Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Table of Contents
maxLevel2

Some or all functionality not working

...

In rare cases, Jira may have difficulty enabling JSU. Usually, this can be solved by uninstalling/re-installing, reset, or reload.

...

  • Manage add-ons: is the JSU app enabled, and all modules enabled?

  • Check your log files, serious problems usually leave a stacktrace. Do you see a reference to a class com.googlecode.jsu.* (to determine which module cannot be loaded)?

  • Re-install the app

...

Reinstall JSU 

Have you tried to remove the JSU app and reinstall it in the Jira administration? (Without restarting Jira)
See also Atlassian's guidance on uninstalling add-ons.

...

  • Uninstall JSU

  • Stop Jira

  • Perform a backup of your Jira installation and database

  • If you could not uninstall JSU before, delete the file $JIRA_HOME/plugins/installed-plugins/*jira-suite-utilities*.jar

  • Delete the following two directories: $JIRA_HOME/plugins/.bundled-plugins and $JIRA_HOME/plugins/.osgi-plugins (they will be recreated)

  • Start Jira

  • Install JSU

Info

...

No configurations (for example workflow or customer field related) will be removed

...

when reinstalling, however, it's always a good idea to perform a backup.

Install an older version

...

JSU

Follow the steps to re- reinstall the app, but install an older version.

Be aware that you
Warning
Note

You might lose some functionality or potentially re-introduce some bugs that have been fixed in a newer version. Generally, it is not a good idea to downgrade JSU.

Furthermore, if If you have saved any configuration with a newer version of JSU (in particular in the area of workflows), the configuration saved might not be compatible with an older version of JSU. (We provide only compatibility for updates of JSU).

...

This was because of a conflict with another add-on. We resolved this issue in JSU version 2.5.2. We recommend updating to the latest version of JSU.

...

Debug the JSU app

To enable JSU debug messages:

...

  1. Log in as a Jira administrator and go to System > Troubleshooting and Support > Logging & Profiling.

  2. Locate and select Configure logging level for another package.

  3. Enter:

Code Block
com.googlecode.jsu

as Package name and select DEBUG as Logging Level


Do the same Repeat for

Code Block
ch.beecom.jira.jsu

...

Code Block
log4j.category.com.googlecode.jsu = DEBUG, filelog
log4j.additivity.com.googlecode.jsu = false

log4j.category.ch.beecom.jira.jsu = DEBUG, filelog
log4j.additivity.ch.beecom.jira.jsu = false
Warningnote

Debug log messages are very detailed. Your log file will grow very quickly, and the performance of the whole system can be affected.

We recommend enabling the logging only for a very short time on debug log level.

...