This section shows you how to install Chameleon on a Unix-based system for the first time. Please note that iNTERFACEWARE currently only offers support for running the Chameleon GUI natively on Windows. While you can deploy a run-time application built with Chameleon on Unix, a Windows version is required to develop and modify your VMD file (i.e. your interface project file) and generate stubcode.

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

To install Chameleon in Unix:

• If you are installing Chameleon on a Linux-based system, 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/chameleon/, and download the Chameleon version and applicable tar.

• Unpack the tarball on the server that you want to deploy it on. The tarball unpacks the contents into a directory called chameleon. For example:

tar -xvzf chameleon_linux_4_1_1_gcc-3_4.tar.gz

• Go to the directory that you installed Chameleon on. For example:

cd chameleon

• 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
CHM  admin  bin  java  lib  python_lib

	To learn what's included in each sub-folder, see Old Directory Structure (Prior to 4.0) vs. New Directory Structure (After 4.0).

• Set the following variables. An example is provided below:

export CHM_PYTHON_LIB_PATH=/home/user/chameleon/python_lib

export CHM_PATH=/home/user/chameleon

export CHM_PLATFORM=makefile.linux

• Set the registration key and expiry date corresponding to the key sent to you. For example:

export CHM_REGKEY='[]^]^^^\KEAEM?'

export CHM_EXPIRY_DATE=NOEXPIRY

Note that, in this example, the registration key is enclosed in single quote ' characters when it is set. This ensures that the registration key is assigned to CHM_REGKEY as is. If you do not enclose the registration key in single quotes, your Unix shell may mistakenly detect special characters inside the key.

	For more details on the variables, see Chameleon Unix Environment.