Windows Upgrade

Quick Upgrade

Application: Development or Testing using a single Iguana instance.

This assumes that you are using a single instance of Iguana on your machine. Upgrades a single instance of Iguana in the default install directory.

  1. Use an account with Local Administrator privileges.
  2. Commit all unsaved work in your translators.
  3. Stop the Iguana service.
  4. Download the latest Iguana release.
  5. As a precaution copy the Iguana repository directory:
    <working directory>\IguanaMainRepo

    Tip: The simplest way to copy the repository, iguana_service.hdf, and log files is to copy the complete Iguana install directory.

    If anything goes wrong just delete the original (upgraded) directory and revert to the (non-upgraded) copy.

    If you are copying the old directory to a new upgrade directory, make sure after you copy it to delete the IguanaConfigurationRepo and edit folders in the new location. These are hardcoded to work with the IguanaMainRepo in the old location. Failing to do so will corrupt your upgraded installation. Upon starting the upgraded Iguana service for the first time, they will be re-created.

  6. If you have changed the Iguana Service Name then copy the iguana_service.hdf file:
    <working directory>\iguana_service.hdf 

    Tip: If you you accidentally overwrite iguana_service.hdf you can edit it to change the service name, see How to change the Iguana Service details in the iguana_service.hdf file.

  7. Optionally you can copy the log files, see how to backup and restore Iguana.
  8. Run the installer and accept the defaults.
  9. Run Iguana by using a web browser to connect to http://localhost:6543/ (or the port that you are using).
  10. Login to Iguana using your user and password (default: user = admin and password = password).
  11. If your license is not recognized you can get a seven day temporary license.
  12. If the old version of Iguana is still showing in the browser, then use F5 to refresh the browser cache.

Multiple Instances use a Manual Upgrade [top]

Application: Production, Development or Testing particularly when you need multiple Iguana instances.

This assumes that you are using a multiple instances of Iguana on your machine. Upgrades multiple instances of Iguana in different directories, using different ports.

Note: For production servers we recommend reviewing our Deployment section.

  1. Use an account with Local Administrator privileges.
  2. Commit all unsaved work in your translators.
  3. Stop the Iguana service.
  4. Download the manual install (zip) file for the latest Iguana release.
  5. Check if the Maintenance Expiry Date for the your license has expired, see: How to check if the Maintenance Expiry Date has expired before an upgrade.
    Note: Don’t panic, if you forget to check you can always get a seven day temporary license after the upgrade.
  6. Identify the install directory of the Iguana Instance that you are going to upgrade.
  7. As a precaution copy the Iguana repository directory:
    <working directory>\IguanaMainRepo

    Tip: The simplest way to copy the repository, iguana_service.hdf, and log files is to copy the complete Iguana install directory.

    If anything goes wrong just delete the original (upgraded) directory and revert to the (non-upgraded) copy.

    If you are copying the old directory to a new upgrade directory, make sure after you copy it to delete the IguanaConfigurationRepo and edit folders in the new location. These are hardcoded to work with the IguanaMainRepo in the old location. Failing to do so will corrupt your upgraded installation. Upon starting the upgraded Iguana service for the first time, they will be re-created.

  8. If you have changed the Iguana Service Name then copy the iguana_service.hdf file:
    <working directory>\iguana_service.hdf 

    Tip: If you you accidentally overwrite iguana_service.hdf you can edit it to change the service name, see How to change the Iguana Service details in the iguana_service.hdf file.

  9. Optionally you can copy the log files, see how to backup and restore Iguana.
  10. 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
  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.

Troubleshooting [top]

  • The automatic installer fails with an error like “Iguana installation failed: Could not find <Iguana install directory>install.log”.
    Solution: Create an empty text file named install.log in the Iguana install directory and run the installer again.

More Information [top]

Leave a Reply