Upgrade to Iguana 6

Upgrading from Iguana 5 to Iguana 6 is much like any other upgrade, with one exception. When Iguana starts for the first time it needs to convert the repository from Fossil to Git.

This means that when Iguana starts for the first time it will take longer. For most servers it will just be a few seconds, and you probably won’t even notice. The upgrade time Is proportional to the size of the fossil repository, for example upgrading a 30 MB Fossil repository can take up to 5 minutes, depending on hardware. This will mostly affect busy development servers because they have lots of channels and lots of milestones, and therefore large fossil repositories.

To get feedback when upgrading you can run Iguana as a program (not as a service or daemon), using iguana -- run in a command prompt or terminal window.

If you have any questions please contact us at support@interfaceware.com.

Windows Upgrade Procedure [top]

  1. Use an account with Local Administrator privileges.
  2. Download the manual install (zip) file for the latest Iguana release.
  3. Identify the install directory of the Iguana 5 Instance that you are going to upgrade.
  4. Make a complete copy of the install directory for the Iguana 5 Instance.
    • This makes it easy to revert to the original, just delete the upgraded directory and rename the copy.
    • Useful for upgrade problems, and testing upgrade procedures.
  5. Backup the Iguana 5 installation (Iguana 5 documentation)
    Note: This step is optional for non-critical servers.
  6. Unpack the zip file into the install directory:
    Note: You can unpack the zip file elsewhere and then copy the files into the install directory.

    • When asked if you want to overwrite existing files choose the option to overwrite all files.
  7. Run Iguana for the first time using iguana --run in a command prompt or terminal window, (not as a service or daemon).
    Note: This step is optional for non-critical servers.

    • Recommended for production servers, and servers with large fossil repositories
    • This will give feedback on the progress of converting the repository from Fossil to Git
  8. Login to Iguana using your user and password (default: user = admin and password = password).
  9. If your license is not recognized you can get a seven day temporary license.
  10. If the old version of Iguana is still showing in the browser, then use F5 to refresh the browser cache.

Mac or Linux Upgrade Procedure [top]

  1. Download the latest Iguana release for your operating system.
  2. Identify the install directory of the Iguana 5 Instance that you are going to upgrade.
  3. Make a complete copy of the install directory for the Iguana 5 Instance.
    • This makes it easy to revert to the original, just delete the upgraded directory and rename the copy.
    • Useful for upgrade problems, and testing upgrade procedures.
  4. Backup the Iguana 5 installation (Iguana 5 documentation)
    Note: This step is optional for non-critical servers.
  5. Run Terminal.
  6. Browse to the download directory:
    cd <download directory>
  7. Unpack the tarball into the iNTERFACEWARE-Iguana directory:
    tar -xvzf <downloaded install file name>.tar.gz
  8. Copy the unpacked files into the directory matching your chosen Iguana instance (from step 3).
    • This will overwrite the previous install directory files, choose the option to overwrite all files
  9. Browse to the install directory:
    cd <home>/iNTERFACEWARE-Iguana
  10. Run Iguana for the first time using ./iguana --run in the terminal window, (not as a service or daemon).
    Note: This step is optional for non-critical servers.

    • Recommended for production servers, and servers with large fossil repositories
    • This will give feedback on the progress of converting the repository from Fossil to Git
  11. Login to Iguana using your user and password (default: user = admin and password = password).
  12. If your license is not recognized you can get a seven day temporary license.
  13. If the old version of Iguana is still showing in the browser, then use F5 to refresh the browser cache.

iguana --run feedback [top]

This shows the feedback from upgrading an Iguana 5 server on a Mac, the results will be very similar on other operating systems. In this case the upgrade only took two seconds, but it can take considerably longer for servers with large fossil repositories.

Leave A Comment?