Application startup issue - Disable SSO Plugin
Problem Description
After installing, updating, enabling, or configuring the SAML Single Sign-On plugin (by Resolution) for Atlassian Data Center or Server products such as Jira, Confluence, Bitbucket, Bamboo, or Fisheye/Crucible, the application crashes or fails to start.
When to Use This Guide
The application fails to start after plugin changes.
Access via the standard Plugin Manager UI is not possible.
Solution
Option 1: Temporarily Disable the Plugin at Startup
Jira (Server) and Confluence (Server & Data Center)
Use the following commands based on your operating system:
Jira:
Windows:
- <installation-directory>\bin\start-jira.bat /disableaddons=com.resolution.atlasplugins.samlsso.Jira
Linux:
- <installation-directory>/bin/start-jira.sh --disable-addons=com.resolution.atlasplugins.samlsso.Jira
Confluence:
Windows:
- <installation-directory>\bin\start-confluence.bat /disableaddons=com.resolution.atlasplugins.samlsso.Confluence
Linux:
- <installation-directory>/bin/start-confluence.sh --disable-addons=com.resolution.atlasplugins.samlsso.Confluence
Limitations
This method is not supported for Jira Data Center.
Not applicable if the application cannot initiate at all (severe JVM or memory issues).
Option 2: Manually Remove Plugin Files
Follow these steps if Option 1 isn't feasible:
Stop your application.
Navigate to the plugin directories:
Application | Plugin Directory Path |
---|---|
Bitbucket |
|
Bamboo |
|
Fisheye/Crucible |
|
Delete all files beginning with:
samlsso
samlwrapper
Restart your application.
Limitations
Manual intervention carries a risk of accidental deletion of unrelated files. Exercise caution.
Changes to plugins are permanent and irreversible without backups.
Option 3: Clear Plugin Configuration
If the issue persists after disabling the plugin:
Clear the SAML SSO plugin configuration following this guide.
Important: Clearing the configuration is irreversible. Always backup your configuration by downloading the XML before proceeding.
Additional Resources
Support
If issues persist or further assistance is needed, please contact support via https://jira.resolution.de/servicedesk/customer/portal.