Mac or Linux Upgrade

Mac 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 your home directory, using <home>/Library/iNTERFACEWARE-Iguana/working_dir/ as the Iguana working directory.

  1. Commit all unsaved work in your translators.
  2. Stop Iguana from the toolbar icon.
  3. Download the latest Iguana release for Mac OS X.
  4. Run the downloaded dmg file.
  5. Drag Iguana to the applications directory.
  6. Start Iguana from the toolbar icon.

Tip: The other install methods below also work for Mac OS X.

You will need to use our download site to get the Mac tarball, see Download other Install Files.

Linux Quick Upgrade [top]

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 your home directory.

  1. Commit all unsaved work in your translators.
  2. Stop Iguana.
  3. Download the latest Iguana release for your operating system.
    Note: Use our download site to get the Mac tarball, see Download other Install Files.
  4. Run Terminal.
  5. Browse to the download directory:
    cd <download directory>
  6. 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.

  7. 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.

  8. Optionally you can copy the log files, see how to backup and restore Iguana.
  9. Unpack the tarball into the iNTERFACEWARE-Iguana directory:
    tar -xvzf <downloaded install file name>.tar.gz
  10. Copy the unpacked files into the iNTERFACEWARE-Iguana directory in your home directory.
    • This will overwrite the previous install directory files, choose the option to overwrite all files
  11. Browse to the install directory:
    cd <home>/iNTERFACEWARE-Iguana
  12. Use one of these commands to run the Iguana server:
    • To run as an exe: ./iguana --run
    • To run as a daemon: ./iguana_service
  13. Login to Iguana using the defaults, user = admin and password = password.
  14. If your license is not recognized you can get a seven day temporary license.
  15. If the old version of Iguana is still showing in the browser, then use F5 to refresh the browser cache.

Multiple Instances [top]

Application: Production, Development or Testing 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. Commit all unsaved work in your translators.
  2. Stop Iguana.
  3. Download the latest Iguana release for your operating system.
    Note: Use our download site to get the Mac tarball, see Download other Install Files.
  4. 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.
  5. Identify the install directory of the Iguana Instance that you are going to upgrade.
  6. 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.

  7. 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.

  8. Optionally you can copy the log files, see how to backup and restore Iguana.
  9. Run Terminal.
  10. Browse to the download directory:
    cd <download directory>
  11. Unpack the tarball into the iNTERFACEWARE-Iguana directory:
    tar -xvzf <downloaded install file name>.tar.gz
  12. 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
  13. Browse to the install directory:
    cd <home>/iNTERFACEWARE-Iguana
  14. Use one of these commands to run the Iguana server:
    • To run as an exe: ./iguana --run
    • To run as a daemon: ./iguana_service
  15. Login to Iguana using the defaults, user = admin and password = password.
  16. If your license is not recognized you can get a seven day temporary license.
  17. If the old version of Iguana is still showing in the browser, then use F5 to refresh the browser cache.

More Information [top]

 

Leave A Comment?