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.
STEP 1: Create an IguanaX instance on the target machine
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.
STEP 2: Copy the existing IguanaX instance Working Directory to the new IguanaX on the target machine
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.
STEP 3: Install iguana as a service, start it and access IguanaX from your web browser
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
STEP 4: Login to your Members Account to activate or transfer the IguanaX license.
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.