Introduction

This page documents how to upgrade an existing Iguana instance (Iguana 6.0.8) to a newer version (Iguana 6.1.5). Before you start, you should note down the current instance’s Iguana ID. You might need to ask iNTERFACEWARE to transfer over the licenses, in case of any issues.

Note: If you are upgrading from Iguana 5.X.X to Iguana 6.X.X you must follow the Upgrade to Iguana 6 instructions instead — as Iguana needs to convert the 5.X.X fossil repository to a git repository. This process is very similar, but has some extra safeguards added to ensure that you can roll-back if there are problems.

Prerequisite

Use an account with Local Administrator privileges.
Commit all unsaved work in your translators.
Stop the Iguana service.
Backup Iguana Working directory (directory where IguanaMainRepo folder is located)

...

Upgrade Procedure

Download a no installer zip file for the new version of Iguana. Make sure you pick the right operating system and 32 vs. 64 build etc. Download links found here: https://dl.interfaceware.com/
Image Added
Extract the zip into a fresh new versioned folder., like: C:\Program Files\iNTERFACEWARE\Iguana6_1_5
Replace the iguana_service.hdf file with the following contents:
Image Added
Use the command line console to change directory into the folder you extracted the files into.
Then run the command: iguana --run --working_dir "C:\Program Files\Iguana6_0_8\Config"
Image Added
If there are no issues, you will see “Main event loop is now running“
Image Added
Stop the command (ctrl + c) and run the following command to install the service:
iguana_service --install
Login into the Iguana dashboard and verify that the channels are running correctly that should be running.