This section shows you how to install Iguana on a Unix, Linux or Mac OS X system for the first time.

	Note that you must be using gcc compiler version 3.4 or above to install Iguana on a Linux machine.

To install Iguana in Unix, Linux or Mac OS X:

• If you are installing Iguana on a Linux-based system, first find the gcc compiler version that your system is currently using, otherwise, skip to the next step. For example:

gcc --version
gcc (GCC) 3.4.6 (Gentoo 3.4.6-r2, ssp-3.4.6-1.0, pie-8.7.10)

The above command will return the version of the gcc compiler you are using, but may not work on all Linux-based systems.

• Visit http://dl.interfaceware.com/iguana/, and download the Iguana version and applicable tar.

• Unpack the tarball on the machine that you want to run it on. The tarball is unpacked into a directory called iNTERFACEWARE-Iguana. For example:

tar -xvzf iguana_linux_4_0_ubuntu804.tar.gz

• Go to the directory that the tarball unpacked into. For example:

cd iNTERFACEWARE-Iguana

• Verify that everything unpacked properly on your system by checking the contents of the applicable directory. For example, typing ls checks the contents of the directory:

ls
License.txt        client_exe         iguana_log_verify  messages.txt
ack_verify.vmd     demo.vmd           iguana_service     python_lib
autoack.vmd        hl7simulator       iguana_service.hdf web_docs
autonack.vmd       iguana             libIGC.dylib

	If you are installing Iguana 3.3 or an older version, the Iguana executable file is named Iguana. If you are installing Iguana 4.0 or later, the Iguana executable file is named iguana.

• If you are installing Iguana 3.3 or an older version, set the CHM_PYTHON_LIB_PATH environment variable to the lib subdirectory of the directory in which Iguana is installed.

• If you are installing Iguana 4.0 or later, set CHM_PYTHON_LIB_PATH to the python_lib subdirectory of the directory in which Iguana is installed.

• Run Iguana as an exe or daemon. To run Iguana as an exe or daemon, type the following, depending on whether you are installing Iguana 3.3 or Iguana 4.0 or later:

Running Iguana 3.3 or an older version as an Executable

./Iguana --run

Running Iguana 4.0 or later as an Executable

./iguana --run

Running Iguana 3.3 as a Daemon

./iguana_service

Running Iguana 4.0 or later as a Daemon

./Iguana_service

	Invalid Chameleon License Error You may receive an error message stating that the host machine does not have a valid Chameleon license after registering Iguana - please ignore the error. There was an issue in Iguana versions 3.2.155 and earlier that caused this error to be displayed before the registration could be loaded. This issue does not affect Iguana versions 3.3 and later. More Information For more information about running Iguana as either a daemon or an executable, see Running Iguana as an Executable or Running Iguana as a Daemon.

After you have successfully installed Iguana, the next step is to register it with the license key provided to you in your member's account. Note that you do not have to register Chameleon separately from Iguana. Once you register Iguana, Chameleon is automatically registered at the same time.

For details, see Registering and Licensing Iguana.