Separating Fisheye instance data from application data
By default, Fisheye will install and run self-contained within the <FishEye install directory>
, that is, the directory where you unzip the package. Alternatively, you can create a separate Fisheye "instance" directory, referenced by the FISHEYE_INST
environment variable, outside of the <FishEye install directory>
. This may be necessary for practical or administrative reasons. Here are our recommendations for some of these possible scenarios:
Number of Instances | Installation Type | Upgrade 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 Type | Upgrade Likelihood | Separate Fisheye Instance Directory |
---|---|---|---|
Multiple | Prod. / Dev. | N/A | Mandatory |
See the differences between Fisheye folder layouts depending on which installation you choose.
For production installations, we recommend that the Fisheye instance directory be secured against unauthorized access.
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:
- Shut down the Fisheye/Crucible instance if it is running.
- Create a directory outside of the
<FishEye install directory>
path for the Fisheye instance data and then set up theFISHEYE_INST
environment variable. - Copy the following items to
/
:FISHEYE_INST
<FishEye install directory>/config.xml
var<FishEye install directory>
/
cache<FishEye install directory>
/
(optional – if it exists)
data<FishEye install directory>
/
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
(i.e. the install directory) and FISHEYE_INST
. Check that your FISHEYE_INST
environment variable is pointing to the correct directory.