JFS 1.4 Installation
Please acknowledge the following before installing JFS:
- JFS patch should be properly applied to your JIRA instance; patching is mandatory; patches are distributed as separate ZIP files at the Downloads
- You must restart your JIRA immediately in case of any change made to JFS state via UPM (aka 'Manage Add-ons'). This includes installing, enabling, disabling, upgrading, uninstalling etc. of JFS add-on.
- You also must restart JIRA immediately if you update UPM add-on. Updating UPM causes reloading (i.e. disabling then enabling) of all user-installed plugins, including JFS, which in turn requires JIRA restart.
- Stop your JIRA instance
- Download JIRA patch ZIP according to your JIRA version - patch version should match your JIRA version exactly
- Download JFS plugin JAR file according to your JIRA version and place it to
Starting from v1.3, we ship different JAR packages according to JIRA version - refer to Downloads page.
For JIRA Standalone:
- Make a backup copy of your JIRA installation or make sure you have an original JIRA distribution package;
- Unzip JIRA patch ZIP file to
atlassian-jirafolder of JIRA installation. Please pay extra attention to the folder you are unpacking the patch archive to.
For JIRA WAR/EAR installation:
- Unzip JIRA patch ZIP file to
edit-webappsubfolder of JIRA build folder;
- 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 Filessection should look like this:
JIRA 4.3-6.4 (JFS patch v1.2):
JIRA 7.0 and later (JFS patch v1.3.0):
If it looks like the one below - the patch has not been applied properly:
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:
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
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.
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
- Make a backup copy of
JIRA_HOME/jfsfolder to save JFS configuration in case smth goes wrong;
- Follow JFS Installation procedure