This documentation relates to an earlier version of Crucible.
View

Unknown macro: {spacejump}

or visit the current documentation home.

On this page:


Running Crucible

(info) This document assumes you have extracted your Crucible zip file into a directory called /FISHEYE_HOME/.

To run Crucible for the first time, simply do the following:

  • Windows の場合
    C:\> cd FISHEYE_HOME\bin
    C:\FISHEYE_HOME\bin> run.bat
    
  • On Unix-based systems:
    $ cd /FISHEYE_HOME/bin
    $ ./run.sh
    

Once started, Crucible will run its own HTTP web server on port 8060. You can access Crucible immediately by going to http://HOSTNAME:8060/ in a browser.

By default, Crucible will listen on port 8060 for HTTP requests. It also listens on 127.0.0.1:8059 as a control port. You can configure both of these in the Administration screens, or by editing /FISHEYE_HOME/config.xml and restarting Crucible.

Supplying Administration Password and License Key

The first time you access the Crucible web server (http://HOSTNAME:8060/) you will see a screen like this, and here you will be asked for two things:

  1. An administrator password. This password controls access to the Administration screens.
  2. A license key. Please note your server ID. You can then get a Crucible evaluation license key here.

Accessing the Administration Pages

Once you have set up an administrator password (as described above), you can access the Administration screens at http://HOSTNAME:8060/admin/.

One of your first steps will be to set up access to a source-control repository, or an alternative form of code storage such as the Local File System or Atlassian Confluence.

The instructions for configuring your repositories are different, depending on your Crucible setup:

The following topics describe how to configure repositories that are not managed by FishEye. These instructions apply to all three setups described above:

Setting Up Users

On initial setup of Crucible, there are no users. Adding user accounts is done via the Administration screens or by configuring Crucible/FishEye to use external authentication.

To add users:

  1. Open the FishEye Administration screens at http://HOSTNAME:8060/admin/.
  2. Click 'Users/Security' under 'Global Settings' in the 'Admin Menu'.

Read more details about the different ways of creating users.

Setting Up SMTP

Crucible can email each review participant on a range of changes. Each user can then set up their own preferences. This is described in the User Profile guide.

First, you must set up the SMTP Server.

Crucible を利用する

You can access Crucible immediately by going to http://HOSTNAME:8060/ in a browser

Or you can go directly into the Crucible homepage at http://HOSTNAME:8060/cru

Stopping Crucible

To stop the Crucible server:

  • Windows の場合
    C:\> cd FISHEYE_HOME\bin
    C:\FISHEYE_HOME\bin> stop.bat
    
  • On Unix-based systems:
    $ cd /FISHEYE_HOME/bin
    $ ./stop.sh
    

Information on FishEye integration

If you want to know more about how Crucible and FishEye interact, refer to our explanation of how Crucible works with FishEye.