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
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.

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. Shutdown your existing fisheye server
  2. Make a backup of your FISHEYE_INST directory
  3. Extract the new FishEye version to a directory, leaving your FISHEYE_INST environment variable set to its existing location.
  4. Start FishEye from the new installation.
  5. 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. Start FishEye from the new installation.
  8. Follow any version-specific instructions found in the Release Notes.

Method 3 - Without a FISHEYE_INST Directory, but would like to set one up

  1. Shut down the old FishEye instance if it is running.
  2. Set up the FISHEYE_INST environment variable, then create the FISHEYE_INST directory on your filesystem.
  3. Copy the /OLD_FISHEYE/config.xml to /FISHEYE_INST.
  4. Copy the /OLD_FISHEYE/var directory to /FISHEYE_INST.
  5. Extract the new Fisheye archive into a directory such as /NEW_FISHEYE/.
  6. Start Fisheye from the new installation by running NEW_FISHEYE/bin/run.sh. (Use run.bat on Windows).
  7. If you configuration is not automatically picked up and you cannot see your existing repositories, check your Administration > Sys-Info page, where you will see information about FISHEYE_HOME and FISHEYE_INST. Check your FISHEYE_INST is pointing to the right directory.

FishEye 2.0 Upgrade Notes

  • Please note that upgrading from 1.6.x will require an (automatic) full reindex.
  • Please note that, unless "Store Diff Info" is disabled, FishEye's disk space requirements are much greater than in previous versions. On an existing FishEye instance, this will first become apparent when the instance is reindexed. Please also see the disk space recommendations on the System Requirements page.
  • Supported browsers are: Safari 3+, FireFox 3+ and Internet Explorer 7+ (not IE6).

FishEye 1.6 Upgrade Notes

  • To take advantage of the new diff contents search in Quick Search, you will need to re-index your repository.
  • Crowd 1.3 users will need to upgrade to Crowd 1.4.4 or later due to an incompatibility with this version of FishEye.

FishEye 1.5 Upgrade Notes

  • Per-Author Line Counts require the 'Store Diff' setting to be true, but this will be false for existing repositories. Existing repositories will require this setting to be changed to 'true', then a full re-scan of that repository must be done. This is not essential to continue using your FishEye instance — it is only required for per-author graphs on the FishEye chart page.
  • Upgrading from 1.2.5 (or earlier) or 1.3beta8 (or earlier) will force a complete re-scan of CVS repositories.
  • Upgrading to this version will force a complete re-scan of P4 repositories.
  • Upgrading from from 1.1.x (or earlier) or 1.2beta2 (or earlier) will force a complete re-scan of SVN repositories.

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.