Wiki style renderer is broken in Jira
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
Users may encounter an issue in Jira Data Center where the Wiki style renderer does not function as expected. Specifically, the buttons for switching between Visual and Text editing modes are not displayed.
Environment
Jira Data Center
Affected versions with residual old version files
Various web browsers
Diagnosis
To diagnose the issue, the following steps were undertaken:
Safe Mode Testing: The issue persisted even when Jira was run in Safe Mode, indicating that third-party plugins were not causing the problem.
Cross-Browser Testing: The problem was tested across different web browsers, but the issue remained unresolved.
Plugin State Verification: The
pluginstate
table was examined to check for any disabled plugins. The UI also confirmed that all necessary plugins were enabled.Test Environment Creation: A test environment was set up, and the issue could not be reproduced, suggesting the problem was specific to the original environment.
Upon further investigation, it was discovered that outdated JAR files were present in the WEB-INF
directory of the Jira installation path, which likely conflicted with the current version.
Cause
The root cause of the issue was the presence of obsolete JAR files in the WEB-INF
directory. These files were remnants from a previous version of Jira and caused conflicts with the current version's wiki renderer functionality.
Solution
To resolve the issue, follow these steps:
Access the Jira Installation Directory:
Navigate to the
WEB-INF
directory within the Jira installation path.- Check next paths:
- <Jira Install path>/WEB-INF/application-installation/jira-software-application
- <Jira Install path>/WEB-INF/application-bundled-plugins
- <Jira Install path>/WEB-INF/lib
- Check next paths:
Remove Obsolete JAR Files:
Identify and remove any JAR files that pertain to older versions of Jira. Be cautious to only delete files that are not required by the current version.
Restart Jira:
After removing the outdated JAR files, restart Jira to apply the changes.
By performing the above steps, the wiki style renderer should function correctly, and the Visual/Text buttons should reappear as expected.
Warning: Backup Important Files
Before proceeding with the deletion of any JAR files, it is crucial to create a backup of all relevant files, directories, and folders. This ensures that you can restore them if needed, preventing potential data loss or system issues.
Clustered Environment Consideration
If your Jira setup includes multiple instances within a cluster, ensure that the changes are consistently applied across each Jira server in the cluster. This step is essential to maintain system integrity and avoid discrepancies among the servers.
By following these precautions, you can safely implement the necessary changes while minimizing risks to your Jira environment.