Migrating IguanaX to a New Server

Moving an existing IguanaX implementation is quite simple if you understand how IguanaX stores it’s application and working files.

Copy the original iguana.exe file from the existing Application Directory to your new target machine.

Considerations:

  • If you have an iguana.ini configuration file in your existing Application Directory, this will need to be copied to the Application Directory on the target machine along with the iguana.exe file.

Copy over all of the files within the working directory.

Considerations:

  • If you have specified your working directory in an iguana.ini file, make sure you are placing the new working directory in the same location, or updating your iguana.ini file to reflect the new working directory.

  • If the Log Directory was custom configured in a directory outside of the working directory, ensure the directory exists on the new server. You can find the log.json file with the location of your log directory in your log configuration files.

Install and start the Iguana service and access the new IguanaX in your web browser.

Windows:

  • Open a Windows command prompt window

  • Browse to the Iguana install directory cd <application directory>

  • Run iguana --service install

  • Run iguana --service start

Linux:

  • Open a command prompt in your Linux terminal

  • Browse to the Iguana install directory cd <application directory>

  • Run sudo ./iguana --service install

  • Run sudo ./iguana --service start

Or Installing as systemd daemon.

Navigate to Settings > License, you’ll need to activate the new Iguana or transfer an existing Iguana license from the old Iguana to the new IguanaX before you’re able to run and test your migrated Iguana and integrations.

 

Related pages