This page last changed on Jul 19, 2009 by edawson.
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.
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 Crucible 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 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 within config.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. (Use run.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.
|