Crucible 2.0 Beta is a public development release leading up to Crucible 2.0. For all production use and testing of Crucible, please use the latest official release.
![]() | Do not use in production. |
![]() | Please also take note of the following information:
|
This page contains instructions on how to upgrade your Crucible instance to the Crucible 2.0 Beta.
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.
- We strongly recommend you make a backup of your data before upgrading Crucible. Simply make a copy of your
crucible_install_dir/var/data/
directory. - Download the Crucible zip file.
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 not using FISHEYE_INST
, 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
. - If you have a Cenqua-issued Crucible license, copy all
/OLD_FISHEYE/*.license
files to/NEW_FISHEYE/
. (Atlassian-issued licenses are included withinconfig.xml
.) - 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
. (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.