Skip to end of metadata
Go to start of metadata

JFS 1.4 Installation

  1. Stop your JIRA instance
  2. Download JIRA patch ZIP according to your JIRA version;
  3. Download JFS plugin JAR file according to your JIRA version and place it to JIRA_HOME/plugins/installed-plugins;

Starting from v1.3, we ship different JAR packages according to JIRA version - refer to Downloads page.

For JIRA Standalone:

  1. Make a backup copy of your JIRA installation or make sure you have an original JIRA distribution package;
  2. Unzip JIRA patch ZIP file to atlassian-jira folder of JIRA installation. Please pay extra attention to the folder you are unpacking the patch archive to.

For JIRA WAR/EAR installation:

  1. Unzip JIRA patch ZIP file to edit-webapp subfolder of JIRA build folder;
  2. Build JIRA and redeploy it to your application server.

Finally, start your JIRA and navigate to Administration->Field Security->Update History Entries to update issue change history records (follow the on-screen instructions).

To check if the JFS patch is applied properly:

  • After JIRA has been started, navigate to Administration -> System Info;
  • Modified Files section should look like this:
    • JIRA 4.0.2-4.2.4:

      [Installation Type: Standalone] secure/views/issue/moveissue-confirm.jsp,, secure/views/issue/convertissuetosubtask-confirm.jsp, com/atlassian/jira/issue/history/ChangeLogUtils.class, entitydefs/entitymodel.xml, templates/plugins/issueviews/single-word.vm, com/atlassian/jira/issue/history/ChangeItemBean.class, templates/plugins/jira/issuetabpanels/changehistory.vm, com/atlassian/jira/plugin/, com/atlassian/jira/issue/fields/CustomFieldImpl.class

    • JIRA 4.3.x, 4.4.x:

      [Installation Type: Standalone] secure/views/issue/moveissue-confirm.jsp,, secure/views/issue/convertissuetosubtask-confirm.jsp, com/atlassian/jira/issue/history/ChangeLogUtils.class, entitydefs/entitymodel.xml,, templates/plugins/issueviews/single-word.vm, templates/plugins/jira/issuetabpanels/changehistory.vm, WEB-INF/lib/jira-api-4.3.1.jar, com/atlassian/jira/issue/fields/CustomFieldImpl.class

      If it looks like the one below - the patch has not been applied properly:

      [Installation Type: Standalone], entityengine.xml, secure/admin/user/views/userbrowser.js

Attention International Users


If you are using non-English language and your default operating system encoding is not UTF-8 , it is strongly recommended to set Java default encoding to UTF-8 . 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:

(info) License is needed for the plugin to operate. To get an evaluation license:

  • Navigate to My Account
  • Create a new evaluation license under Licenses tab.
  • Copy&paste generated license data to Administration->Field Security->Licensing page of your JIRA instance.
  • Evaluation license will be valid for 30 days. After that you should purchase a commercial license.

(tick) You have successfully installed the JFS Plugin. Now you can move to JFS Tutorial to see how the plugin can be easily configured in three steps.

Upgrading to latest version

  1. Make a backup copy of JIRA_HOME/jfs folder to save JFS configuration in case smth goes wrong;
  2. Follow JFS Installation procedure
  • No labels