This page last changed on Nov 08, 2007 by tim@atlassian.com.

If you have been using FishEye and now want to move to Crucible, you can do this without losing your FishEye repositories.

Read about how your Crucible installation works with FishEye.

Before you Start

We strongly recommend you make a backup of your data before following the steps below. Refer to the FishEye documentation on making a backup.

Upgrade Procedure

Follow method 1 below if you have FishEye configured to use a FISHEYE_INST directory. Follow method 2 if you are not using a FISHEYE_INST directory.

Read more about the FISHEYE_INST environment variable.

Method 1 - Using a FISHEYE_INST Directory
  1. Download Crucible and unzip the archive into a folder. This document assumes you have extracted your Crucible zip file into a directory called /NEW_FISHEYE/.
  2. Leave your FISHEYE_INST environment variable set to its existing location.
  3. Start Crucible from the new installation by running NEW_FISHEYE/bin/run.sh. (Use run.bat on Windows).
  4. Follow the initial configuration steps outlined below.
Method 2 - Without a FISHEYE_INST Directory
  1. Download Crucible.
  2. Extract the new Crucible archive into a directory such as /NEW_FISHEYE/.
  3. Delete the /NEW_FISHEYE/var directory.
  4. Shut down the old FishEye instance if it is running.
  5. Copy /OLD_FISHEYE/config.xml to /NEW_FISHEYE/.
  6. Copy (or move) the /OLD_FISHEYE/var directory to /NEW_FISHEYE/var.
  7. If you have a Cenqua-issued FishEye license, copy /OLD_FISHEYE/fisheye.license to /NEW_FISHEYE/. (Atlassian-issued licenses are included within config.xml.)
  8. Follow any version-specific instructions found in the Release Notes.
  9. Follow the initial configuration steps outlined below.

Initial Configuration

  1. You can access Crucible immediately by going to http://HOSTNAME:8080/ in a browser.
  2. The first time you run Crucible, you will be asked for a Crucible license key. You can view your license key here.
  3. If you do not already have user accounts configured, you will need to do this via the Administration screens or by configuring Crucible/FishEye to use external authentication.
    To add users:
  4. Crucible can email each review participant on a range of changes. Each user can then set up their own preferences. This is described in the User Profile guide. First, you must set up the SMTP Server.
Document generated by Confluence on Nov 29, 2007 18:19