Symptoms

The Fisheye/Crucible "restore" feature of fisheyectl fails when upgrading from version 1.6.X to 2.X with the following error:

./fisheyectl.sh restore -f backup_20120407121212.zip 
    INFO  - FishEye arguments: [-f, backup_20120407121212.zip]
    INFO  - Cache-sizing: MAX_TOTAL_CACHE_SIZE=343005555
    Not a valid FishEye and Crucible backup archive.

Cause

Built-in "restore" functionality is only found in Fisheye/Crucible version 2.x and up.

Resolution

As described in the Fisheye/Crucible 1.6 documentation, simply unzip the backup in the FISHEYE_INST directory of the new installation:

1. Install – but do not start – the latest version of Fisheye/Crucible 2.X.
2. Define a FISHEYE_INST environment variable and point it to an empty directory.
3. Unzip the 1.6.X backup zip into the FISHEYE_INST directory.
4. Start Fisheye/Crucible.