Migrating FishEye Between Servers

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. Read the note about external databases below.

  6. 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 installation directory>/config.xml
    • <FishEye installation directory>/var
    • <FishEye installation 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) Read the note about external databases below.

6) Start FishEye. It should pick up your environment variables, and from that access your FISHEYE_INST directory, which contains your configuration. If you are using JIRA for User Management you might need to update the whitelist of the corresponding application connector in JIRA with the IP address of the new FishEye server to retain user authentication.

External Databases

If you are using an external database it must be accessible from the new server since the steps above only include installing a new application and relocating your configuration data and repository indexes.

If you wish to migrate both the application, data, and your external database to a different server (e.g. to create a development or test server) then you will need to make a copy of your external database and update the config.xml file (depending on the setup, located in either <FishEye/Crucible installation directory>/config.xml or FISHEYE_INST/config.xml) with the new database location prior to starting up the instance. See Backing up and restoring FishEye data for more information.

Was this helpful?

Thanks for your feedback!

Why was this unhelpful?

Have a question about this article?

See questions about this article

Powered by Confluence and Scroll Viewport