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.
On this page:
Before you Start
We strongly recommend you make a backup of your data before following the steps below. Refer to the documentation on making a backup.
Upgrade Procedure
- Follow Method 1 if you have a default configuration and are not using a
FISHEYE_INST
directory (that is, your FishEye binaries and data are all stored under the same location, in the defaultFISHEYE_HOME
directory).
- Follow Method 2 below if you have FishEye configured to use a
FISHEYE_INST
directory (that is, your FishEye binaries are stored in theFISHEYE_HOME
directory, separate from your FishEye data in theFISHEYE_INST
directory).
- Follow Method 3 if you are not using a
FISHEYE_INST
directory but would now like to start using one.
Read more about the
FISHEYE_INST
environment variable.
Method 1 - Without a FISHEYE_INST Directory (default)
- Download Crucible.
- Extract the new Crucible archive into a directory such as
/NEW_FISHEYE/
. - Delete the
/NEW_FISHEYE/var
directory. - Shut down the old FishEye instance if it is running.
- Copy
/OLD_FISHEYE/config.xml
to/NEW_FISHEYE/
. - Copy the
/OLD_FISHEYE/var
directory to/NEW_FISHEYE/var
. - If you have a Cenqua-issued FishEye license, copy
/OLD_FISHEYE/fisheye.license
to/NEW_FISHEYE/
. (Atlassian-issued licenses are included withinconfig.xml
.) - Follow any version-specific instructions found in the Release Notes.
- Start Crucible from the new installation by running NEW_FISHEYE/bin/run.sh. (Use run.bat on Windows).
- Follow the initial configuration steps outlined below.
Method 2 - Using a FISHEYE_INST Directory
- Shutdown your existing fisheye server.
- Make a backup of your FISHEYE_INST directory.
- 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/
. - Leave your
FISHEYE_INST
environment variable set to its existing location. - Start Crucible from the new installation by running
NEW_FISHEYE/bin/run.sh
. (Userun.bat
on Windows). - Follow the initial configuration steps outlined below.
Method 3 - Without a FISHEYE_INST Directory, but intending to set one up
- Shut down the old FishEye instance if it is running.
- Set up the
FISHEYE_INST
environment variable, then create the FISHEYE_INST directory on your filesystem. - Copy the
/OLD_FISHEYE/config.xml
to/FISHEYE_INST
. - Copy the
/OLD_FISHEYE/var
directory to/FISHEYE_INST
. - Download Crucible.
- Extract the new Crucible archive into a directory such as
/NEW_FISHEYE/
. - Start Crucible from the new installation by running
NEW_FISHEYE/bin/run.sh
. (Userun.bat
on Windows). - Follow the initial configuration steps outlined below.
- 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.
Initial Crucible Configuration
- You can access FishEye immediately by going to
http://HOSTNAME:8060/
in a browser. - The first time you run FishEye, enter your Crucible license key. To do this, update your Crucible license by opening 'Administration', then 'Sys-Info/Support'. On this screen, you can enter your Crucible license key. You can view your license key here. The Crucible functionality will be instantly unlocked.
- 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:- Open the FishEye Administration screens at
http://HOSTNAME:8060/admin/
. - Click 'Users/Security' under 'Global Settings' in the 'Admin Menu'.
Read more details about the different ways of creating users.
- Open the FishEye Administration screens at
- 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.