FishEye for JIRA Installation Guide

On this page:

Firstly, download the plugin from the table below.

Download and Requirements Table

FishEye Config Your FishEye instance must have its remote API running — see the Server Settings documentation.

Installing the FishEye plugin

As of Version 2.0, the JIRA FishEye Plugin is distributed with an atlassian-p4package JAR file. Make sure this is also placed in your WEB-INF/lib directory.

Version 2.0+

1. As you should before any upgrade - create a backup of your JIRA instance.
2. Copy jira-fisheye-plugin-2.0.jar and atlassian-p4package-2007.12.14.jar into the WEB-INF/lib directory of the JIRA webapp.
3. Remove any previous JIRA FishEye Plugin jar files from the WEB-INF/lib directory, e.g jira-fisheye-plugin-1.x.jar
4. If you previously had the JIRA Perforce plugin installed:
   1. Remove any previous JIRA Perforce Plugin jar files from the WEB-INF/lib directory, e.g. atlassian-jira-perforce-plugin-x.x.x.jar
   2. Remove any previous atlassian-p4package jar files from the WEB-INF/lib directory, e.g. atlassian-p4package-2006.12.5.jar
5. Restart JIRA

   If you're upgrading from an older version of the FishEye plugin, make sure you remove the old plugin JAR file.

Version 1.x

1. As you should before any upgrade - create a backup of your JIRA instance.
2. Remove any older version of jira-fisheye-plugin-x.x.jar from the WEB_INF/lib directory of your JIRA instance.
3. Download fisheye-jira-plugin-x.x.zip.
4. Place the fisheye-jira-plugin-x.x.jar contained in the ZIP into the WEB_INF/lib directory of your JIRA instance.
5. Restart JIRA and navigate to Administration -> FishEye Configuration to configure access to your FishEye instance.

As of version 1.0, you no longer have to restart JIRA after configuration changes to this plugin.

Older Versions

Prior to Version 1.0, configuration of the plugin was accomplished via a fisheye-jira-plugin.properties file:

1. Download fisheye-jira-plugin-x.x.zip and expand it to a temporary folder.
2. Using a text editor, edit fisheye-jira-plugin.properties and configure to your environment.
3. Copy fisheye-jira-plugin.properties to the WEB-INF/classes directory of your JIRA instance.
4. Copy fisheye-jira-plugin-x.x.jar to the WEB-INF/lib directory of your JIRA instance.
5. Restart JIRA.

Note that you will have to restart JIRA if you wish to update your FishEye configuration whilst using pre-1.0 versions of the plugin.

Other Plugins Once the plugin is installed and running you might like to uninstall the Subversion Plugin and/or disassociate CVS modules from your projects so as to disable JIRA's periodic CVS indexing.

JIRA Compatibility Table

Plugin Version	3.6.x	3.7.x	3.8	3.8.1	3.10.2	3.11	3.12.1	3.12.2	3.13.x
2.3
2.0
1.5
1.4
1.3
1.1.2
1.0
0.8

Bugs, Feature Requests & Improvements? If you've found a bug in the JIRA FishEye plugin or would like to request a new feature or improvement - please raise an issue in the JIRA FishEye Plugin project.