This documentation relates to an earlier version of FishEye.
View

Unknown macro: {spacejump}

or visit the current documentation home.

This guide describes the advanced FishEye installation options.

Evaluating FishEye for the first time? See the FishEye 101 page.

  1. Download the FishEye zip file and extract it. This document assumes you have extracted FishEye to /FISHEYE_HOME/.
  2. Ensure you have installed an appropriate Java runtime - see Supported Platforms.
  3. Ensure that java is in the PATH, or that the JAVA_HOME environment variable is set.
  4. If you intend to use FishEye with Subversion, please ensure you read the Supported Platforms, Subversion client setup, and granting permission to FishEye to scan your repository.
  5. If you intend to use FishEye with Perforce, please ensure you read the Perforce client setup.

Read-only access for FishEye

We recommend you run FishEye as a user that has only read access to your repository.

FishEye Folder Layout

FISHEYE_HOME (Default)

By default, FishEye will run self-contained within the /FISHEYE_HOME/ directory. The FishEye directory layout looks like this:

/FISHEYE_HOME/config.xml

Configuration file.

/FISHEYE_HOME/var/

Directory under which FishEye stores its data.

/FISHEYE_HOME/var/data/

Persistent information.

/FISHEYE_HOME/var/cache/

Caches and indexes.

/FISHEYE_HOME/var/log/

Log files.

/FISHEYE_HOME/var/tmp/

Temporary files.

/FISHEYE_HOME/bin/

Scripts for controling FishEye.

/FISHEYE_HOME/lib/

FishEye's dependent libraries.

/FISHEYE_HOME/ ...

Remainder omitted for brevity.

However, this self-contained layout results in tedious copying of files each time you upgrade FishEye. Also, if you want to run multiple instances of FishEye, you need multiple /FISHEYE_HOME/ installations. These two issues can be avoided by setting a FISHEYE_INST ('FishEye Instance') location.

FISHEYE_INST (Optional)

FISHEYE_INST is a location where your repository data is stored, separate from the installation location of the FishEye application. This may be necessary for practical or administrative reasons.

(info) A separate FISHEYE_INST location is recommended for production installations of FishEye.
Once you have have declared your FISHEYE_INST, you will need to copy your FISHEYE_HOME/config.xml file to your FISHEYE_INST/ directory.

When the FISHEYE_INST environment variable is set, FishEye's directory layout becomes:

$FISHEYE_INST/config.xml


$FISHEYE_INST/var/

All permanent and temporary data is found under $FISHEYE_INST/var/

$FISHEYE_INST/lib/

Site-specific Java libraries (.jars) that FishEye should load on startup. (Do not copy the dependent /FISHEYE_HOME/lib/ files into here.)

$FISHEYE_INST/syntax/

Site-specific syntax highlighting definitions.

$FISHEYE_INST/system.properties

Used for setting system properties within the FishEye JVM, which may sometimes be useful for support purposes.(Note: the other way to set properties is via FISHEYE_OPTS, e.g.: export FISHEYE_OPTS=-Dpropname=value )

/FISHEYE_HOME/lib/

FishEye's dependent libraries.

/FISHEYE_HOME/syntax/

FishEye bundled highlighting definitions.

/FISHEYE_HOME/bin/


/FISHEYE_HOME/ ...

Remaining files are found under /FISHEYE_HOME/.

The rest of this Installation Guide refers to $FISHEYE_INST/, but if you have not set FISHEYE_INST then it defaults to /FISHEYE_HOME/ (the directory where you extracted FishEye).

Next Step - Initial Configuration

See the guidelines on configuring FishEye.



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.