If you see a crash under Linux/Mac OS X/Unix then these systems typically produce a ‘core’ file. For Linux and Unix systems these core files usually go into the same directory as Iguana, and are named “core” or “core.<PID>”. For Mac OS X they can be found under /cores off the main root of your hard drive.

The location can vary depending on the configuration of your machine.

It may be necessary to configure your system to produce these core files. On most Unix systems including Linux this involves using this command:

ulimit -c unlimited

This will needs to be run in the same session before running Iguana. For instance you could have a startup script for Iguana like this:

ulimit -c unlimited && ./iguana_service

That would configure the system to generate core dumps for Iguana. 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 again when it restarts then a helpful trick is to do:

./iguana --run

At the command line. This will give you visible logging output to see why the crash might be occurring.

If the crash occurs at startup, you can add the --safe_mode option to prevent automatically starting channels which have start_automatically="true" – see Safe Mode for details.

./iguana --run --safe_mode