Documentation for FishEye 3.0.x. Documentation for other versions is available too.

By default, FishEye will install and run self-contained within the /<FISHEYE_HOME> directory (a.k.a. /<FishEye install directory>) – the directory where you unzip the package. Alternatively, you can create another "FishEye Instance" directory outside of the /<FISHEYE_HOME> directory and reference it with an environment variable, FISHEYE_INST.  This may be necessary for practical or administrative reasons.  Here are our recommendations for some of these possible scenarios:

 

Number of Instances

Installation TypeUpgrade Likelihood Separate FishEye Instance Directory
Single
Production
Highly Recommended
Single
Development
Likely
Highly Recommended
Single
Development
Not Likely
 Unnecessary

 

In order to run multiple instances of FishEye on the same server, it is mandatory to establish a separate FISHEYE_INST  directory.

Number of Instances

Installation TypeUpgrade Likelihood Separate FishEye Instance Directory
Multiple
Prod. / Dev.
N/A
Mandatory

 

See the differences between FishEye folder layouts depending on which installation you choose.

(info) As outlined in Method 3 of our FishEye upgrade guide, you can separate your FishEye instance data (to make future upgrades easier) even if initially you chose not to do so:

  1. Shut down the FishEye/Crucible instance if it is running.
  2. Create a directory outside of the /<FISHEYE_HOME> path for the FishEye instance data and then set up the FISHEYE_INST environment variable.
  3. Copy the following items to /FISHEYE_INST:
  • /<FishEye install directory>/config.xml
  • /<FishEye install directory>/var
  • /<FishEye install directory>/cache
  • /<FishEye install directory>/data      (optional – if it exists)

4.  Start the FishEye/Crucible instance.

Can't See Your Repositories?

If your 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.

 

 

  • No labels

1 Comment

  1. Malik Mangier

    Dec 04, 2012

    "In order to run multiple instances of FishEye on the same server, it is mandatory to establish a separate FISHEYE_INST  directory."

    FISHEYE_INST is an environment variable. So in order to establish separate FISHEYE_INST, separate FishEye users also need to be established. Each FishEye instance will need to run with a dedicated username. And each of these usernames will have a separate FISHEYE_INST defined.

 

 

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