There are different ways to start, stop, and restart Icinga. Depending on your installation, the most common example will be shown... In case of using the init script make sure you have performed
make install-init
or
make fullinstall
![]() |
Tip |
---|---|
Always make sure you're “Verifying Your Configuration” before you (re)start Icinga. |
Starting Icinga
Init Script: The easiest way to start Icinga is by using the init script:
/etc/init.d/icinga start
Manually: You can start Icinga manually with the -d command line option:
/usr/local/icinga/bin/icinga -d /usr/local/icinga/etc/icinga.cfg
Debugging Mode: In the very rare case that Icinga ends silently without any hints in the various log files you can start Icinga by omitting the daemon option:
/usr/local/icinga/bin/icinga /usr/local/icinga/etc/icinga.cfg
This way it is started in the foreground which will lead to a lot of messages scrolling down the screen but it may result in a clue at the very end.
Restarting Icinga
Restarting/reloading is necessary if you modify your configuration files and want those changes to take effect.
Init Script: The easiest way to reload/restart Icinga is by using the init script:
/etc/init.d/icinga reload
or
/etc/init.d/icinga restart
The difference between the two is that the latter will actually end the nagios process and start it again. The first rereads the configuration files which is faster but in some cases may not be sufficient.
Web-Interface: You can restart Icinga using the web interface. Click on the "Process Info" navigation link and select "Restart the Icinga Process"
Manually: You can restart Icinga by sending it a SIGHUP signal:
kill -HUP <icinga_pid>
Stopping Icinga
Init Script: The easiest way to stop Icinga is by using the init script:
/etc/init.d/icinga stop
Web-Interface: You can stop Icinga using the Web-Interface Click on the "Process Info" navigation link and select "Shutdown the Icinga Process"
Manually: You can stop by sending it a SIGTERM signal:
kill <icinga_pid>
© 2009 Icinga Development Team, http://www.icinga.org