Deploying Iguana on Unix, Linux and Mac OS X

Iguana as a Daemon

Note: The Mac OS X and Linux 64-bit versions of Iguana dynamically link to SSL libraries. If you encounter linking errors when first starting Iguana, then you need to check that:

  • SSL is installed on your machine.
  • The SSL libraries are in the link path.
  • The names of the SSL libraries match the ones that Iguana require. If not, then you can create symbolic links to resolve the naming differences. For example:
cd /usr/lib
ln -s libssl.so libssl.so.0.9.7

To run the application as a daemon, type the following:

/home/user/iNTERFACEWARE-Iguana/iguana_service

When running as a daemon, the process may be killed by issuing a SIGTERM to the process id listed in the

Iguana.pid

file.

An example startup shell script is provided below:

#!/bin/sh

#start Iguana as an application
#/home/user/iNTERFACEWARE-Iguana/iguana --run

#start Iguana as a daemon
#/home/user/iNTERFACEWARE-Iguana/iguana_service

To start the Iguana daemon automatically when the system is rebooted, add the following to your crontab file:

@reboot iNTERFACEWARE-Iguana/iguana_service

This command is executed after every reboot. The crontab file can be modified by running the following command:

crontab -e

For more information on crontab and its options, run the following command to view its manual page:

man 5 crontab