Install Instructions for Mac OS X and Linux

For Linux and Mac OS X, the installation process is a matter of obtaining a tarball for the right OS then unpacking it and running the Iguana executable.

Installation Instructions

  • Download the most suitable Iguana build
  • Iguana can run from any location (with write permission). The simplest place to install is under your home directory.
    Note: Your administrator may prefer that you install in a different directory.
  • Unpack the tarball.  By default it is unpacked into the directory iNTERFACEWARE-Iguana.
    • tar -xvzf iguana_<matching_your_os>.tar.gz
  • Go to the install directory (where the tarball was unpacked).
    • cd iNTERFACEWARE-Iguana
  • Run iguana as an exe or as a daemon:
    • ./iguana --run
    • ./iguana_service
  • Register Iguana.

Tip: If you are running Iguana as a daemon in a Mac/Linux/Unix environment, we recommend that you configure it to create crash dumps (as best practice).

Installing Chameleon library for working with stubcode, legacy Plugins

Using Chameleon stubcode or legacy Plugins is not recommended – best to use Translator.

These should be used only if you have an existing implementation that you need to keep working.

  • Set CHM_PYTHON_LIB_PATH to the python_lib subdirectory of the install directory.
  • See our downloads page for all OS versions and install instructions.
  • See Installing Chameleon on Unix in the old version 4 manual, the instructions apply to all POSIX systems including OSX.

To edit VMDs on a non Windows machine you need to do a full install of Chameleon in a virtual machine. For example, see Installing Chameleon on Mac OS X using Parallels.

Other topics of interest