FishEye Upgrade Guide

The first time you run a new version of FishEye, it will automatically upgrade its data. This may involve a complete re-index of your repository.

Before you start

• Before upgrading you should always read the Release Notes and Changelog for the version you are upgrading to, as well as any versions you are skipping.

FishEye 1.4 Upgrade Notes

• If you were using the old Crowd Authenticator plugin in FishEye 1.3.x, you need to switch to the in-built Crowd Authenticator in FishEye 1.4+. Please see the Crowd documentation for details.
• As of version 1.3, FishEye requires a JVM version 1.5 or later. Previously, 1.4+ was required.
• Upgrading from 1.2.5 (or earlier) or 1.3beta8 (or earlier) will force a complete re-index of CVS repositories.
• Upgrading to this version will force a complete re-index of P4 repositories.
• Upgrading from from 1.1.x (or earlier) or 1.2beta2 (or earlier) will force a complete re-index of SVN repositories.

FishEye 1.3 Upgrade Notes

• As of version 1.3, FishEye requires a JVM version 1.5 or later. Previously, 1.4+ was required.
• Upgrading from 1.2.5 (or earlier) or 1.3beta8 (or earlier) will force a complete re-index of CVS repositories.
• Upgrading to this version will force a complete re-index of P4 repositories.
• Upgrading from from 1.1.x (or earlier) or 1.2beta2 (or earlier) will force a complete re-index of SVN repositories.

Upgrade Procedure

Your upgrade procedure depends on whether you are using a separate FISHEYE_INST directory. Read more about FISHEYE_INST in the Installation Guide.

Method 1: Using a Separate FISHEYE_INST Directory

1. Extract the new FishEye version to a directory, leaving your FISHEYE_INST environment variable set to its existing location.
2. Ensure that the FISHEYE_HOME environment variable, if set, points to your /NEW_FISHEYE/ directory.
3. Start FishEye from the new installation.
4. Follow any version-specific instructions found in the Release Notes.

Method 2: No Separate FISHEYE_INST Directory

You will need to copy some files from your old FishEye installation to your new one.

1. Extract the new FishEye instance into a directory such as /NEW_FISHEYE/.
2. Delete the /NEW_FISHEYE/var directory.
3. Shut down the old FishEye instance if it is running.
4. Copy /OLD_FISHEYE/config.xml to /NEW_FISHEYE/.
5. Copy (or move) the /OLD_FISHEYE/var directory to /NEW_FISHEYE/var.
6. If you have a Cenqua-issued FishEye license, copy your fisheye.license to /NEW_FISHEYE/. (Atlassian-issued licenses are included within config.xml.)
7. Ensure that the FISHEYE_HOME environment variable, if set, points to your /NEW_FISHEYE/ directory.
8. Start FishEye from the new installation.
9. Follow any version-specific instructions found in the Release Notes.