3. Check your version of Java
In a terminal, run this:
java -version
The version of Java should be 1.8.x.
4. Check that the system can find Java
In a terminal, run this:
echo $JAVA_HOME
You should see a path something like:
OSX | /System/Library/Frameworks/JavaVM.framework/Versions/CurrentJDK/Home/ |
Linux | /usr/lib/jvm/default-java |
5. Now it's time to get Crucible
- Download Crucible from the Atlassian download site.
- Please check your unzip program before extracting the downloaded zip file. Some archive-extract programs cause errors when unzipping the Crucible zip file:
- Extract the downloaded file to an install location:
- Folder names in the path to your Crucible executable should not have spaces in them. The path to the extracted directory is referred to as the
<Crucible home directory>
- If you expect to have a large number of users for this Crucible installation, and Crucible will be connected to an external database, consider installing Crucible on a different server from the one running the external database, for improved performance.
- Folder names in the path to your Crucible executable should not have spaces in them. The path to the extracted directory is referred to as the
6. Tell Crucible where to store your data
The Crucible instance directory is where your Crucible data is stored.
- Create your Crucible instance directory.
Tell Crucible where you created the instance directory by adding a FISHEYE_INST environment variable as follows:
Linux
Open the
/etc/environment
file in a text editor and insert :FISHEYE_INST="path/to/<Crucible instance directory>"
Mac
Open the
~/.profile
file for the current user in a text editor and insert:FISHEYE_INST="path/to/<Crucible instance directory>" export FISHEYE_INST
- Now copy the newly extracted
<Crucible home directory>
config.xml
file to the root of your new Crucible instance directory.
You should not locate your Crucible instance directory inside the
— they should be entirely separate locations. If you do put the instance directory in the <Crucible home directory>
it will be overwritten, and lost, when Crucible gets upgraded. And by the way, you'll need separate Crucible instance directories if you want to run multiple copies of Crucible.<Crucible home directory>
If you have a large number of repositories, we recommend you increase the default number of files that Fisheye is allowed to open. See the following knowledge base article for more info: Subversion Indexer Paused with "Too many open files" Error.
7. Start Crucible!
In a terminal, change directory to <Crucible home directory>
and run this:
bin/start.sh
After a few moments, in a web browser on the same machine, go to http://localhost:8060/
(or, from another machine, type http://hostname:8060/
, where hostname
is the name of the machine where you extracted Crucible).
Enter your license, then an admin password, to finish the setup.
You can postpone setting up Jira integration until later if you wish; see Configuring Jira integration in the Setup Wizard.
8. Connect to an external database (recommended)
If you intend to use this Crucible installation in a production environment, it is highly recommended that you use one of the supported external databases. See Migrating to an external database.
If you are evaluating Crucible, or don't wish to do this now, Crucible will happily use its embedded database, and you can easily migrate later.
9. Set up your mail server
Configure the Crucible email server so that users can get notifications from Crucible. See Configuring SMTP.
10. Add users and repositories
Now is the time to set up your users in Crucible, and to tell Crucible about any existing repositories you have. Please read Starting to use Crucible for the details.
Crucible will perform an initial index of your repositories, during which it accesses, indexes and organizes a view of your repositories (including all historical items) back to the earliest commits. If you are evaluating Crucible, we suggest that you index a single project, so you can use Crucible as soon as possible. If you choose to index your entire repository, be aware that this can take a long time (possibly days) for massive or complex repositories and can be more complex to set up (especially for Subversion). The basic process is slightly different for each SCM type.
11. Stop Crucible (optional)
In a terminal, change directory to <Crucible home directory>
and run this:
bin/stop.sh