1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
|
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>4.2. Starting and Stopping Icinga</title>
<link rel="stylesheet" href="../stylesheets/icinga-docs.css" type="text/css">
<meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
<meta name="keywords" content="Supervision, Icinga, Nagios, Linux">
<link rel="home" href="index.html" title="Icinga Version 1.14 Documentation">
<link rel="up" href="ch04.html" title="Chapter 4. Running Icinga">
<link rel="prev" href="verifyconfig.html" title="4.1. Verifying Your Configuration">
<link rel="next" href="ch05.html" title="Chapter 5. The Basics">
<script src="../js/jquery-min.js" type="text/javascript"></script><script src="../js/icinga-docs.js" type="text/javascript"></script>
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<CENTER><IMG src="../images/logofullsize.png" border="0" alt="Icinga" title="Icinga"></CENTER>
<div class="navheader">
<table width="100%" summary="Navigation header">
<tr><th colspan="3" align="center">4.2. Starting and Stopping Icinga</th></tr>
<tr>
<td width="20%" align="left">
<a accesskey="p" href="verifyconfig.html">Prev</a> </td>
<th width="60%" align="center">Chapter 4. Running Icinga</th>
<td width="20%" align="right"> <a accesskey="n" href="ch05.html">Next</a>
</td>
</tr>
</table>
<hr>
</div>
<div class="section" title="4.2. Starting and Stopping Icinga">
<div class="titlepage"><div><div><h2 class="title" style="clear: both">
<a name="startstop"></a>4.2. <a name="start_stop"></a>Starting and Stopping Icinga</h2></div></div></div>
<p>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 </p>
<pre class="programlisting"> #> make install-init</pre>
<p> or
</p>
<pre class="programlisting"> #> make fullinstall</pre>
<div class="tip" title="Tip" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Tip">
<tr>
<td rowspan="2" align="center" valign="top" width="25"><img alt="[Tip]" src="../images/tip.png"></td>
<th align="left">Tip</th>
</tr>
<tr><td align="left" valign="top">
<p>Always make sure you're <a class="link" href="verifyconfig.html" title="4.1. Verifying Your Configuration">verified your configuration</a> before you (re)start Icinga.</p>
</td></tr>
</table></div>
<p><span class="bold"><strong>Starting Icinga</strong></span></p>
<div class="orderedlist"><ol class="orderedlist" type="1">
<li class="listitem">
<p><span class="bold"><strong>Init Script:</strong></span> The easiest way to start Icinga is by using the init script:
</p>
<pre class="programlisting"> #> /etc/init.d/icinga start</pre>
</li>
<li class="listitem">
<p><span class="bold"><strong>Manually:</strong></span> You can start Icinga manually launching the daemon mode with the <span class="bold"><strong>-d</strong></span> command line option: </p>
<pre class="programlisting"> #> /usr/local/icinga/bin/icinga -d /usr/local/icinga/etc/icinga.cfg</pre>
</li>
<li class="listitem">
<p><span class="bold"><strong>Debugging Mode:</strong></span> 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: </p>
<pre class="programlisting"> #> /usr/local/icinga/bin/icinga /usr/local/icinga/etc/icinga.cfg</pre>
<p>
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.</p>
</li>
</ol></div>
<p><span class="bold"><strong>Restarting Icinga</strong></span></p>
<p>Restarting/reloading is necessary if you modify your configuration files and want those changes to take effect.</p>
<div class="orderedlist"><ol class="orderedlist" type="1">
<li class="listitem">
<p><span class="bold"><strong>Init Script:</strong></span> The easiest way to reload/restart Icinga is by using the init script:
</p>
<pre class="programlisting"> #> /etc/init.d/icinga reload</pre>
<p> or </p>
<pre class="programlisting"> #> /etc/init.d/icinga restart</pre>
<p>
The difference between the two is that the latter will actually end the Icinga process and start it again. The first rereads the
configuration files which is faster but in some cases may not be sufficient.</p>
</li>
<li class="listitem">
<p><span class="bold"><strong>Web-Interface:</strong></span> You can restart Icinga using the web interface. Click on the "Process
Info" navigation link and select "Restart the Icinga Process"</p>
<p><span class="inlinemediaobject"><img src="../images/stoprestart.png"></span></p>
</li>
<li class="listitem">
<p><span class="bold"><strong>Manually:</strong></span> You can restart Icinga by sending it a SIGHUP signal: </p>
<pre class="programlisting"># kill -HUP <icinga_pid></pre>
</li>
</ol></div>
<p><span class="bold"><strong>Stopping Icinga</strong></span></p>
<div class="orderedlist"><ol class="orderedlist" type="1">
<li class="listitem">
<p><span class="bold"><strong>Init Script:</strong></span> The easiest way to stop Icinga is by using the init script:
</p>
<pre class="programlisting"># /etc/init.d/icinga stop</pre>
</li>
<li class="listitem">
<p><span class="bold"><strong>Web-Interface:</strong></span> You can stop Icinga using the Web-Interface Click on the "Process Info"
navigation link and select "Shutdown the Icinga Process"</p>
<p><span class="inlinemediaobject"><img src="../images/stoprestart.png"></span></p>
</li>
<li class="listitem">
<p><span class="bold"><strong>Manually:</strong></span> You can stop by sending it a SIGTERM signal: </p>
<pre class="programlisting"># kill <icinga_pid></pre>
</li>
</ol></div>
<p><span class="bold"><strong>Logging Options in /usr/local/icinga/etc/icinga.cfg</strong></span></p>
<p>Logging options for daemon:</p>
<p>If you want messages to be logged to the daemon log file (usually icinga.log). Default option is 1 (yes), the other valid option is
0 (no) </p>
<pre class="programlisting">use_daemon_log=0/1</pre>
<p>Logging options for syslog:</p>
<p>If you want messages to be logged to the syslog facility, as well as the Icinga log file set this option to 1. If not, set it
to 0.</p>
<pre class="programlisting">use_syslog=0/1</pre>
<p><span class="bold"><strong>Miscellaneous options</strong></span></p>
<p>If you experience long delays between starting Icinga and the first checks you can use several other options which are shown
<a class="link" href="faststartup.html" title="8.4. Fast Startup Options">here</a>. How to have a look at the scheduling queue (-S) is described there as well.</p>
<a class="indexterm" name="idm140381631720288"></a>
<a class="indexterm" name="idm140381631719040"></a>
<a class="indexterm" name="idm140381631717488"></a>
</div>
<div class="navfooter">
<hr>
<table width="100%" summary="Navigation footer">
<tr>
<td width="40%" align="left">
<a accesskey="p" href="verifyconfig.html">Prev</a> </td>
<td width="20%" align="center"><a accesskey="u" href="ch04.html">Up</a></td>
<td width="40%" align="right"> <a accesskey="n" href="ch05.html">Next</a>
</td>
</tr>
<tr>
<td width="40%" align="left" valign="top">4.1. Verifying Your Configuration </td>
<td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td>
<td width="40%" align="right" valign="top"> Chapter 5. The Basics</td>
</tr>
</table>
</div>
<P class="copyright">© 1999-2009 Ethan Galstad, 2009-2017 Icinga Development Team, https://www.icinga.com</P>
</body>
</html>
|
