Deploying Iguana on Unix, Linux and Mac OS X

If you are running Iguana on Unix, Linux or Mac OS X and you have used the iguana_service daemon to start Iguana, you must be careful when stopping Iguana.

If you want to stop Iguana by killing the process that is running it, you must stop the iguana_service parent process, not the iguana process that is spawned by iguana_service.

When iguana_service is killed, it exits immediately, and can be restarted in the normal way without problems.

Note: If you are running a version of Iguana that is older than version 4.0, iguana_service is named Iguana_service.

If you are stopping the iguana_service daemon, and it is unable to stop during the time period specified in the service_kill_timeout field of the iguana_service.hdf configuration file, Iguana issues a SIGQUIT signal. This signal enables your system to generate a core dump.

If you want Iguana to issue a signal other than SIGQUIT, you can specify the signal that Iguana is to use. To do this, add the unix_kill_signal field to the iguana_service.hdf configuration file. This file is located in the directory in which Iguana is installed.

For example, if Iguana is to issue a SIGKILL signal, add the following:

unix_kill_signal=9