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:
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:
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"
If there are no issues, you will see “Main event loop is now running“
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.
References
https://help.interfaceware.com/v6/deployment-best-practices-new#upgrade
https://help.interfaceware.com/v6/windows-upgrade#multi
https://help.interfaceware.com/v6/upgrade-procedure
https://help.interfaceware.com/v6/mac-or-linux-upgrade