Doc downloads (PDF, HTML & XML)
[FishEye Knowledge Base]
If you have defined the FISHEYE_INST
environment variable, then upgrades and migrations of your FishEye instance will be relatively simpler.
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.
FISHEYE_INST
but would like to set it up1) 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. 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_HOME/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.