This page last changed on Jun 01, 2010 by mgchong.
Read about how your Crucible installation works with FishEye.
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.
- Check the Supported Platforms to ensure that your system meets the requirements for the new version.
- We strongly recommend you make a backup of your data before upgrading Crucible. Refer to the documentation on making a backup.
- Download the Crucible zip file.
Crucible 2.0 Upgrade Notes
- Supported browsers are: Safari 3+, FireFox 3+ and Internet Explorer 7+ (not IE6).
Crucible 1.6 Upgrade Notes
Upgrade Procedure
Method 1 - Using a FISHEYE_INST Directory
If you have Crucible configured to use a FISHEYE_INST directory, then simply:
- Shutdown your existing FishEye server.
- Make a backup of your FISHEYE_INST directory
- Extract the new Crucible version to a directory.
- Leave your FISHEYE_INST environment variable set to its existing location.
- Start Crucible from the new installation.
- Follow any version-specific instructions found in the Release Notes.
Read more about the FISHEYE_INST environment variable.
Method 2 - Without a FISHEYE_INST Directory
If you are using the FISHEYE_HOME directory, you will need to copy some files from your old Crucible installation to your new one.
- Extract the new Crucible archive into a directory such as /NEW_FISHEYE/.
- Delete the /NEW_FISHEYE/var directory.
- Shut down the old Crucible instance if it is running.
- Copy /OLD_FISHEYE/config.xml to /NEW_FISHEYE/.
- Copy (or move) the /OLD_FISHEYE/var directory to /NEW_FISHEYE/var.
- Copy your database drivers to your new lib directory under NEW_FISHEYE/lib.
- Follow any version-specific instructions found in the Release Notes.
Method 3 - Without a FISHEYE_INST Directory, but would like 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. (Use run.bat on Windows).
- Follow the initial configuration steps outlined below.
- If your 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.
|