This documentation relates to 2.0.x
If you are using an earlier version, please view the previous versions of the Crucible documentation and select the relevant version.

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:
    • これらのリリースは安定させるよう試みていますが、フル リリースほどのテストは行っていません。
    • 開発リリースの機能は不完全であったり、次のフル リリースまでに変更または削除されたりする可能性があります。
    • 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.

(info) Read about how your Crucible installation works with FishEye.

作業を開始する前に

  • 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.

アップグレード手順

Method 1 - Using a FISHEYE_INST Directory

If you have Crucible configured to use a FISHEYE_INST directory, then simply:

  1. Shutdown your existing fisheye server
  2. Make a backup of your FISHEYE_INST directory
  3. Extract the new Crucible version to a directory.
  4. Leave your FISHEYE_INST environment variable set to its existing location.
  5. Start Crucible from the new installation.
  6. Follow any version-specific instructions found in the Release Notes.

(info) 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.

  1. Extract the new Crucible archive into a directory such as /NEW_FISHEYE/.
  2. Delete the /NEW_FISHEYE/var directory.
  3. Shut down the old Crucible instance if it is running.
  4. Copy /OLD_FISHEYE/config.xml to /NEW_FISHEYE/.
  5. Copy (or move) the /OLD_FISHEYE/var directory to /NEW_FISHEYE/var.
  6. 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.)
  7. Follow any version-specific instructions found in the Release Notes.
Method 3 - Without a FISHEYE_INST Directory, but would like to set one up
  1. Shut down the old FishEye instance if it is running.
  2. Set up the FISHEYE_INST environment variable, then create the FISHEYE_INST directory on your filesystem.
  3. Copy the /OLD_FISHEYE/config.xml to /FISHEYE_INST.
  4. Copy the /OLD_FISHEYE/var directory to /FISHEYE_INST.
  5. Download Crucible.
  6. Extract the new Crucible archive into a directory such as /NEW_FISHEYE/.
  7. Start Crucible from the new installation by running NEW_FISHEYE/bin/run.sh. (Use run.bat on Windows).
  8. Follow the initial configuration steps outlined below.
  9. 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.
  • ラベルなし



Log a request with our support team.



Raise an issue for our developers.



See answers from the community.



Blog and update.

Except where otherwise noted, content in this space is licensed under a Creative Commons Attribution 2.5 Australia License.