Ensure JFS Patch for JIRA Is Installed
These signs indicate that JFS patch for JIRA has not been installed properly:
- Custom field values are hidden from Issue View, but stay visible in Change History;
- Changed values are visible in Activity Streams;
- Hidden values are visible in Issue Print View or in MS Word representation.
If you experience one of these problems, you should download proper JFS patch for JIRA and reinstall it according to JFS Installation&Upgrade Guide. Please pay extra attention to the folder you are unpacking the patch archive.
To check if the patch is applied:
- Navigate to
Administration -> System Info;
Modified Filessection should look like this:
If it looks like the one below - the patch has not been applied properly:
Non-English Symbols Get Corrupted
If you are using non-English language and your default operating system encoding is not UTF8 (usually on Windows system), it is required to set Java default encoding to UTF8 . To do this: set Java property file.encoding to UTF8: -Dfile.encoding=UTF8.
You can find more info on how to set Java property for Tomcat installed as a Windows Service here: http://confluence.atlassian.com/display/JIRA/Setting+Properties+and+Options+on+Startup#SettingPropertiesandOptionsonStartup-TomcatinstalledasaWindowsService%3A
Unable to Install the License Code
Exception stack trace is shown when trying to install JFS license code:
The license code could not be installed.
This is due to interference with JavaMelody plugin.
- Temporarily remove JavaMelody plugin from the system
- Stop JIRA
- Remove JavaMelody JAR from WEB-INF/lib (deactivating JavaMelody via UPM is not enough)
- Start JIRA
- Install JFS license
- Stop JIRA
- Place JavaMelody JAR back to WEB-INF/lib
- Start JIRA
- OR place the code directly to
jfs-settings.xmlfile is located in
- Make a backup copy of the file
- Place the code inside
- Save the file
- Restart JIRA
Both plugins should work fine now, but you still will not be able to update JFS license while JavaMelody is present in the system
Uncontrollable Log File Growth
When a user performs an export of search results to CSV JIRA log files are flooded with stack traces as below which causes an uncontrollable log file growth.
This is due to the interference with a third-party add-on, which does not support the new 'Export to CSV' feature correctly. This feature was introduced in JIRA 7.2.
Upgrade to JFS v1.4.36 or later.
- Set Logging level to ERROR on the JFS Settings page
- Navigate to Logging and Profiling at JIRA Admin and set logging level for
Disabling "Block Unknown URLs" Setting
Before creating a support request try to disable Block Unknown URLs setting at Administration -> Field Security -> JFS Settings.
Preparing Data for Support Request
- Navigate to Administration->Field Security->JFS Settings and:
- Set Logging Level to TRACE;
- If the error is related to SOAP or XML-RPC API: set "Dump Request & Response Data to File" option to ON;
- Click the Save button to submit changes;
- Perform actions that are causing the error;
- Navigate to Administration->Field Security->JFS Settings and disable extended debugging by setting Logging Level to INFO and "Dump Request & Response Data to File" option to OFF; click Save button to submit;
- Attach JIRA log file and application server log file to the support request (see this page for how to find log files; choose your JIRA version);
- If the error is related to SOAP or XML-RPC: navigate to
/jfs/tmpsubfolder in the JIRA home folder of your instance, archive its content with any common archiver (e.g. ZIP) and attach to support request.
Please note that log files and/or dump files may contain some sensible information. We recommend choosing any sample JIRA issues for reproducing erroneous behavior. Furthermore, we hereby confirm that a) we will use any submitted data only for debugging purposes, a) we will not share this data with anyone without written permission of the owner and c) we will permanently delete all submitted data upon completion of the support request or if requested by the owner.