When a Linux/Mac OS X system crashes it typically produce a “core” file. For Linux systems these core files are usually saved in the Iguana install directory and are named “core” or “core.<PID>”. For Mac OS X they can be found under /cores off the root of your hard drive. The location can vary depending on the configuration of your machine.

Some systems do not produce core files by default, so It may be necessary to configure your system to produce these core files.

On most Linux this command will enable core dumps:

ulimit -c unlimited

This command needs to be run before Iguana in the same session, for example: A startup script like this will enable core dumps for Iguana:

ulimit -c unlimited && ./iguana_service

Some system administrators will choose to configure ulimit -c unlimited at a global level for the entire machine.

If you experience issues with Iguana crashing when it restarts then it can be helpful to run Iguana at the command line. This will give visible logging output which can help to identify why the crash is occurring.

Use this command to run Iguana at the command line:

./iguana --run

If the crash occurs at startup, you can add the --safe_mode option to prevent automatically starting channels which have start_automatically="true":

./iguana --run --safe_mode

For more information, see How can I start Iguana in Safe Mode?