Moving Iguana from one Server to Another

Introduction

The procedure for moving an Iguana installation from one server to another is quite simple: Basically you just need to copy the Iguana installation and working files to the new server.

This process is similar to steps in the Solution section of the  How to move or copy the Iguana working directory FAQ. The only difference is you will also need to create an Iguana instance on the target server that will use the copied working directory.

If you have any questions please contact us at support@interfaceware.com.

Move an Iguana default installation [top]

Steps to Move an Iguana default installation (working directory is the same as the install directory):

  1. Commit changes for all Translator projects, in every channel:

    Any changes that are not committed to the repository will be lost. This is because the Iguana repository is copied (or moved) during the process the and uncommitted changes are not included.

  2. Stop the Iguana service or daemon.
  3. Backup or copy the Iguana install directory:

    This is precautionary to ensure you can recover the original Iguana installation if anything does wrong.

  4. Delete the existing install directory:

    If you are cautious you can initially rename it and then delete it later — but so long as you made a copy/backup in step (3) you can always recover anyway.

    Warning: From this point on do not start the original Iguana instance as it can process messages – which will then be missing from the log files on your new Iguana instance.

    Deleting or renaming the directory will make it impossible to accidentally start the original Iguana instance.

  5. Copy the Iguana install directory to the new machine.
  6. Install Iguana as a Service:
    1. Setup Iguana as a Windows service.
    2. Setup Iguana as a Linux (or Mac) daemon if you need help with this please contact us at support@interfaceware.com.
  7. Change the log directory in the configuration.xml file to match the log directory on the new server.

    When you migrate to another server the log drive may be in a different location than the original server. You will need to edit the Iguana configuration file (configuration.xml) to point to the new log directory. If your log directory is on a new local drive or a new LUN (on a SAN) – then you will also need to copy the log files to that location. If you are pointing to the same disk or LUN (where the log files already exist) then you only need to point to the location.

  8. Start Iguana.

     Note: If your server does not start then it probably means that the log directory in the configuration.xml is pointing to a drive that does not exist – once this is updated (see the previous step) Iguana will start correctly.

  9. You will need to use your members account to activate or transfer a license.

Move an Iguana with a separate working directory [top]

Steps to Move an Iguana Server with a separate working directory:

  1. Create an Iguana instance on the target machine:

    You can install a fresh Iguana instance or copy the original install directory. If you make a new instance it will need to be the same (or newer) version of Iguana as your source server.

  2. Move the Iguana working directory:
    • Follow the first five steps in the Solution steps of the “How to move or copy the Iguana working directory” FAQ.
  3. Update the the iguana_service.hdf file:
    • Update the the iguana_service.hdf file in the install directory of the Iguana instance you created in step one.
    • Follow the instructions in step (6) of the Solution steps to update the iguana_service.hdf file.
  4. Install Iguana as a Service:
    1. Setup Iguana as a Windows service.
    2. Setup Iguana as a Linux (or Mac) daemon if you need help with this please contact us at support@interfaceware.com.
  5. Change the log directory in the configuration.xml file to match the log directory on the new server.

    When you migrate to another server the log drive may be in a different location than the original server. You will need to edit the Iguana configuration file (configuration.xml) to point to the new log directory. If your log directory is on a new local drive or a new LUN (on a SAN) – then you will also need to copy the log files to that location. If you are pointing to the same disk or LUN (where the log files already exist) then you only need to point to the location.

  6. Start Iguana.
  7. You will need to use your members account to activate or transfer a license.
Tagged: