Home | Clover | Clover.NET | FishEye | Crucible | Support | Account | Download | Buy Now

Upgrading FishEye

Before upgrading, you should always read the changelog.

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.

Your upgrade procedure depends on whether you are using a separate FISHEYE_INST directory. (Read more about FISHEYE_INST in the Install documentation.)

Using FISHEYE_INST

Simply extract the new FishEye version to a directory, leave your FISHEYE_INST environment variable set to its existing location, and start FishEye from the new installation.

You will also need to follow any of the version-specific instructions below.

No separate FISHEYE_INST

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/. Delete the /NEW_FISHEYE/var directory.
  2. Shutdown the old FishEye instance if it is running.
  3. Copy /OLD_FISHEYE/config.xml to /NEW_FISHEYE/.
  4. Copy (or move) the /OLD_FISHEYE/var directory to /NEW_FISHEYE/var.
  5. Copy your fisheye.license to /NEW_FISHEYE/.
  6. Follow any of the version-specific instructions below.

Upgrading 0.x to 1.0

There are some important changes that occurred between 0.10 and 1.0RC1 that you should be aware of when upgrading:

  • The FishEye scripts (fisheyectl, start, stop, etc) have been moved from /FISHEYE_HOME/ to /FISHEYE_HOME/bin/
  • You can now split part of your FishEye installation into an "instance" directory FISHEYE_INST. This makes upgrades much easier.