This documentation relates to FishEye 2.7.x

If you are using an earlier version, please view the previous versions of the FishEye documentation and select the relevant version.
Skip to end of metadata
Comment: Corrected links that should have been relative instead of absolute.
Go to start of metadata

FishEye 2.0 Beta is a public development release leading up to FishEye 2.0. For all production use and testing of FishEye, please use the latest official release.

Do not use in production.
Beta releases should not be used in production environments.

Please also take note of the following information:

  • Beta releases are not safe — Beta releases are snapshots of the ongoing FishEye development process. As such:
    • While we try to keep these releases stable, they have not undergone the same degree of testing as a full release.
    • Features in development releases may be incomplete, or may change or be removed before the next full release.
    • There will be an upgrade path from the 2.0 Beta to the final release.

This page contains instructions on how to upgrade your FishEye instance to the FishEye 2.0 Beta.

Before you Start

  • Before upgrading you should always read the Release Notes for the version you are upgrading to, as well as any versions you are skipping.
  • We strongly recommend you make a backup of your data before upgrading FishEye. Simply make a copy of your FishEye_install_dir/var/data/ directory.
  • Download the FishEye zip file.

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.
Labels:
None
Edit Labels