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

1. Use an account with Local Administrator privileges.

2. Commit all unsaved work in your translators.

3. Stop the Iguana service.

4. Backup Iguana Working directory (directory where IguanaMainRepo folder is located)

Open

Upgrade Procedure

1. 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: Index of /
   
   

   Open

   

    

2. Extract the zip into a fresh new versioned folder., like: C:\Program Files\iNTERFACEWARE\Iguana6_1_5

3. Replace the iguana_service.hdf file with the following contents:
   
   

    

4. Use the command line console to change directory into the folder you extracted the files into.

5. Then run the command: iguana --run --working_dir "C:\Program Files\Iguana6_0_8\Config"
   
   

    

6. If there are no issues, you will see “Main event loop is now running“
   
   

    

7. Stop the command (ctrl + c) and run the following command to install the service:
   iguana_service --install

8. Login into the Iguana dashboard and verify that the channels are running correctly that should be running.

References

Deployment best practices - iNTERFACEWARE Help Center

Windows Upgrade - iNTERFACEWARE Help Center

Upgrade Procedure - iNTERFACEWARE Help Center

Mac or Linux Upgrade - iNTERFACEWARE Help Center