This documentation relates to an earlier version of FishEye.
View this page in the current documentation or visit the current documentation home.
Skip to end of metadata
Comment: Corrected links that should have been relative instead of absolute.
Go to start of metadata

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.