Backing Up and Restoring Managed Repositories

Backing up Managed Repositories

Managed repositories are not backed up by FishEye's built-in backup and restore feature. Instead, you will need to design and implement your own backup procedure.

All managed repositories are stored under a single directory in FishEye, which should be backed up regularly along with a copy of your config.xml.

By default, this directory lives here:

FISHEYE_INST/managed-repos

This location can be configured by modifying your config.xml file (see Setting your Repositories Root for more details on changing this value).

To back up the managed-repos directory, you need to create a snapshot of the managed-repos directory (including all subdirectories), then back up that snapshot. Note that the directory structure under the managed-repos directory must be preserved in the snapshot. Your config.xml file should also be backed up at the same time.

Creating this snapshot is an operating system-specific task, e.g.:

• On Windows, a batch script copying the directory can be written and scheduled periodically (All Programs > Accessories > System Tools > Task Scheduler). There are also various utilities available to simplify this (eg. PicoZip).
• On Linux/Solaris, it is best to write a small shell script, placed in /etc/cron.daily , backing up files to a directory like /var/backup/fisheye-repos . It is best to copy an existing script in /etc/cron.daily to ensure local conventions (file locations, lockfiles, permissions) are adhered to.

Restoring Managed Repositories from Backup

To restore a backed up snapshot:

1. Stop your FishEye instance.
2. Make a backup of the current config.xml file and managed-repositories directory, in case something goes wrong during the restore process.
3. Replace the current config.xml file with the config.xml file from your backup.
4. Replace the contents of your managed-repos directory with the contents of your backup snapshot.
5. Restart your FishEye server.
6. Perform a manual re-index for each managed repository that was restored.

Note, it is possible to perform a manual restore for a single repository at a time by copying a single repository from your backup to your managed-repositories directory and starting a re-index.