This is the documentation for FishEye 3.2. View the latest version of

Unknown macro: {spacejump}

or visit the latest FishEye documentation home page.

This page describes the process for migrating FishEye between servers.


If you have defined the FISHEYE_INST Environment Variable, then upgrades and migrations of your FishEye instance will be relatively simpler.

If you have defined FISHEYE_INST

1) Shut down your current FishEye server completely.
2) Copy the FISHEYE_INST directory to your destination server.
3) Copy and set up all of your Environment Variables from your source server to your destination server (remembering to set up your FISHEYE_INST directory to point to the location where you copied the data to in Step 2).
4) Install FishEye on your destination server.
5) Start FishEye. It should pick up your environment variables, and from that access your FISHEYE_INST directory, which contains your configuration.

If you have not defined FISHEYE_INST but would like to set it up

1) Shut down your current FishEye server completely.
2) Copy the following three items into to a new folder on your destination server (for example, fisheye_inst):

    • <FishEye home directory>/config.xml
    • <FishEye home directory>/var
    • <FishEye home directory>/cache

3) Copy and set up all of your Environment Variables from your source server to your destination server. In addition to this, set up the FISHEYE_INST environment variable as follows, replacing the /path/to/fisheye_inst with the fully qualified path to the fisheye_inst folder you set up in Step 2:

export FISHEYE_INST=/path/to/fisheye_inst


4) Install FishEye on your destination server.
5) Start FishEye. It should pick up your environment variables, and from that access your FISHEYE_INST directory, which contains your configuration.

External Databases

Please note that the steps above will only move your FishEye configuration data. If you are using an external database, that configuration will assume that your database is accessible from the new server.

However if you want to make a copy of your server (You may want to create a copy, if you want a development server), then you will need to make a copy of your external database, and edit the FISHEYE_HOME/config.xml (or FISHEYE_INST/config.xml in case you have it set up) and update the database details to point to the copied database. 

If you wish to migrate both FishEye and your external database to a different server, see Backing up and restoring FishEye data for more information.

  • No labels