File: upgrading.html

package info (click to toggle)
icinga 1.14.2%2Bds-3
  • links: PTS, VCS
  • area: main
  • in suites: buster
  • size: 49,264 kB
  • sloc: ansic: 108,564; sql: 9,656; sh: 4,945; perl: 3,439; makefile: 1,213; php: 581; xml: 104
file content (483 lines) | stat: -rw-r--r-- 25,404 bytes parent folder | download
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
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>2.10. Upgrading (to) 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="ch02.html" title="Chapter 2. Getting Started">
<link rel="prev" href="howtos.html" title="2.9. Links to other published Howtos">
<link rel="next" href="upgrading_idoutils.html" title="2.11. Upgrading IDOUtils Database">
<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">2.10. Upgrading (to) Icinga</th></tr>
<tr>
<td width="20%" align="left">
<a accesskey="p" href="howtos.html">Prev</a> </td>
<th width="60%" align="center">Chapter 2. Getting Started</th>
<td width="20%" align="right"> <a accesskey="n" href="upgrading_idoutils.html">Next</a>
</td>
</tr>
</table>
<hr>
</div>
<div class="section" title="2.10. Upgrading (to) Icinga">
<div class="titlepage"><div><div><h2 class="title" style="clear: both">
<a name="upgrading"></a>2.10. <a name="upgrading_nagios"></a>Upgrading (to) Icinga</h2></div></div></div>
<div class="toc"><dl>
<dt><span class="section">2.10.1. <a href="upgrading.html#upgradepreviousrelease">Upgrading from previous Icinga Releases</a></span></dt>
<dt><span class="section">2.10.2. <a href="upgrading.html#upgradenagios3x">Upgrading from Nagios 3.x Releases</a></span></dt>
<dt><span class="section">2.10.3. <a href="upgrading.html#upgradenagios2x">Upgrading from Nagios 2.x Releases</a></span></dt>
<dt><span class="section">2.10.4. <a href="upgrading.html#upgradefromrpm">Upgrading from an RPM Installation</a></span></dt>
</dl></div>
  

  <div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Note">
<tr>
<td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.png"></td>
<th align="left">Note</th>
</tr>
<tr><td align="left" valign="top">
    <p>Starting with 1.8, you will find newly added config options in version diffed config files in
    <code class="filename">sample-config/updates/</code> as well as <code class="filename">module/idoutils/config/updates</code>, e.g.
    <code class="filename">cgi.cfg_added_1.7_to_1.8.cfg</code>.</p>

    <p><span class="color"><font color="red">On the core, unknown macros are not left on the output anymore, logging a warning
    instead.</font></span> Either fix your config (i.e. wrong macros, escape dollar signs with another one) or set keep_unknown_macros=1 in
    icinga.cfg to revert to the old behaviour.</p>

    <p>The Classic UI has removed the WAP interface (statuswml.cgi) as well as 3D statusmap (statuswrl.cgi) not being actively developed
    and used anymore. Due to that change, the host configuration attributes "vrml_image" and "3dcoords" have been deprecated on the Core as
    well.</p>

    <p>Please have a look at the section "CHANGES" in the <code class="filename">changelog</code> as well.</p>
  </td></tr>
</table></div>

  <div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Note">
<tr>
<td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.png"></td>
<th align="left">Note</th>
</tr>
<tr><td align="left" valign="top">
    <p>If you are using IDOUtils then you have to update it, too. Please take a look at <a class="link" href="upgrading_idoutils.html" title="2.11. Upgrading IDOUtils Database">
    upgrading_idoutils</a> as well.</p>
  </td></tr>
</table></div>

  <div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Note">
<tr>
<td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.png"></td>
<th align="left">Note</th>
</tr>
<tr><td align="left" valign="top">
    <p>If you are using Icinga Web then you have to update it, too. Please take a look at <a class="link" href="upgrading_icingaweb.html" title="6.6. Upgrading Icinga Web and Icinga Web Database">
    upgrading_icingaweb</a> as well.</p>
  </td></tr>
</table></div>

  <div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Note">
<tr>
<td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.png"></td>
<th align="left">Note</th>
</tr>
<tr><td align="left" valign="top">
    <p>Starting with 1.9, the directive <code class="literal">event_profiling_enabled</code> in <code class="filename">icinga.cfg</code> is
    deprecated.</p>
  </td></tr>
</table></div>

  <a class="indexterm" name="idm140381637755696"></a>

  <div class="section" title="2.10.1. Upgrading from previous Icinga Releases">
<div class="titlepage"><div><div><h3 class="title">
<a name="upgradepreviousrelease"></a>2.10.1. Upgrading from previous Icinga Releases</h3></div></div></div>
    

    <p>During development there may be cases where the handling of bugfixes might touch the userspace. We try to avoid this as far as
    possible but sometimes it is inevitable.</p>

    <p><span class="bold"><strong>Normal Icinga update Path</strong></span></p>

    <p>If there's a new Icinga version available on <a class="link" href="http://www.icinga.org/" target="_top">https://www.icinga.com/</a> you should
    consider updating. Newer versions contain bugfixes, minor or major, which makes it even more important to get the latest and the
    greatest. If you already installed Icinga using the quickstart guides it's rather easy to install newer versions. It's also
    possible to perform that without root privileges by doing an install from source. It highly depends on your likings.</p>

    <p>Make sure you'll have a safe backup of your Icinga installation and configs. If anything goes wrong you can restore your
    old setup rather easy.</p>

    <p>Regular updates of Icinga are possible just by re-installing Icinga. Please keep in mind that <code class="code">configure</code>
    requires the same parameters as before - look it up in <code class="filename">config.log</code> and store that in a safe location.</p>

    <p>Become the icinga user. Debian/Ubuntu users might use <code class="code">sudo -s icinga</code>. </p>
<pre class="programlisting"> $&gt; su -l icinga</pre>
<p>Get
    the latest Icinga version from <a class="link" href="http://www.icinga.org/" target="_top">https://www.icinga.com/</a> and extract it. Then run configure like you
    did with the old version. </p>
<pre class="programlisting"> #&gt; ./configure --with-command-group=icinga-cmd</pre>
<p> </p>
<div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Note">
<tr>
<td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.png"></td>
<th align="left">Note</th>
</tr>
<tr><td align="left" valign="top">
        <p>Starting with Icinga 1.9 the default has changed so you might have to disable the compilation of IDOUtils
        explicitly.</p>

        <pre class="programlisting"> #&gt; ./configure --with-command-group=icinga-cmd --disable-idoutils</pre>
      </td></tr>
</table></div>
<p> Compile the source. </p>
<pre class="programlisting"> #&gt; make all</pre>
<p> Please make sure that you don't overwrite your configs -
    always make a backup! Don't use <code class="code">make install-config</code> and/or <code class="code">make install-webconf</code> and/or <code class="code">make
    install-webconf-auth</code>if you want to manually diff the config files. </p>
<pre class="programlisting"> #&gt; make install install-base install-cgis install-html install-init \
    install-commandmode install-idoutils</pre>
<p> or decide what you want to upgrade by just typing 'make' which shows all available
    options. Check your config and restart Icinga. </p>
<pre class="programlisting"> #&gt; /etc/init.d/icinga checkconfig
 #&gt; /etc/init.d/icinga restart</pre>
<p>That's it!</p>

    <p><span class="bold"><strong>Icinga 0.8.0 to Icinga 1.14</strong></span></p>

    <p><span class="emphasis"><em>Archived Logfilename</em></span></p>

    <p>There was a small misspelling bug in Icinga 0.8.0 resulting in archived logfile names beginning with a capital <span class="bold"><strong>"I"</strong></span> like in <span class="bold"><strong>'Icinga-$date'</strong></span>". This was fixed in version 0.8.1. and newer.</p>

    <p>If you experience this problem then please use the following script to fix the file names</p>

    <pre class="programlisting"> #&gt; cd /usr/local/icinga/var/archives

 for oldfilename in `find ./ -name "Icinga-*"`
 do
   newfilename=`echo $oldfilename | sed -e 's/Icinga/icinga/g'`
   mv $oldfilename $newfilename
 done</pre>

    <p><span class="bold"><strong>Upgrading to Apache 2.4</strong></span></p>

    <p>Starting with Apache 2.4 the default web configuration folder changed from <code class="filename">/etc/apache2/conf.d</code> to
    <code class="filename">/etc/apache2/conf-available</code>. If you want to migrate then just move the file(s), enable the configuration(s) and
    reload the web server: </p>
<pre class="screen">#&gt; mv /etc/apache2/conf.d/icinga*.conf /etc/apache2/conf-available
#&gt; a2enconf icinga icinga-web
#&gt; service apache2 reload</pre>

    <div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Note">
<tr>
<td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.png"></td>
<th align="left">Note</th>
</tr>
<tr><td align="left" valign="top">
      <p>Following <code class="literal">a2enconf</code> you have to specify the configuration. The example assumes that you have installed both
      Icinga Classic UI and Icinga Web.</p>
    </td></tr>
</table></div>

    <p>You have to enable the CGI module as well</p>

    <pre class="screen">#&gt; a2emod cgi</pre>

    <a class="indexterm" name="idm140381637730576"></a>
  </div>

  <div class="section" title="2.10.2. Upgrading from Nagios 3.x Releases">
<div class="titlepage"><div><div><h3 class="title">
<a name="upgradenagios3x"></a>2.10.2. Upgrading from Nagios 3.x Releases</h3></div></div></div>
    

    <p>We try to be compatible with the configuration files of the current Nagios 3.x versions so there should be very little you
    have to do to "upgrade" from Nagios 3.x to Icinga 1.14. Assuming you've already installed Nagios from
    source code as described in the Nagios quickstart guide, you can install Icinga quite easily.</p>

    <p>If you are upgrading from Nagios 3.0.x you might need to install PHP:</p>

    <p><span class="emphasis"><em>Debian / Ubuntu</em></span> </p>
<pre class="screen"> #&gt; apt-get install php5 libapache2-mod-php5</pre>

    <p><span class="emphasis"><em>Fedora / RedHat</em></span></p>

    <pre class="screen"> #&gt; yum install php mod_php</pre>

    <p><span class="emphasis"><em>openSuSE / SLES</em></span></p>

    <p>Use Yast to install the packages <span class="emphasis"><em>php5</em></span> and <span class="emphasis"><em>apache2-mod_php5</em></span> or use zypper</p>

    <pre class="programlisting"> #&gt; zypper install php5 apache2-mod_php5</pre>

    <p>Make sure you have a good backup of your existing Nagios installation and configuration files. If anything goes wrong or
    doesn't work, this will allow you to rollback to your old version.</p>

    <p>Please install Icinga according to the <a class="link" href="quickstart.html" title="2.3. Quickstart Installation Guides">quickstart guide</a>. Please note that</p>

    <div class="itemizedlist"><ul class="itemizedlist" type="disc">
<li class="listitem">
        <p>the default prefix has changed to "/usr/local/icinga"</p>
      </li>
<li class="listitem">
        <p>the environment macros start with ICINGA_</p>

        <p>PNP4Nagios is aware of that since 0.6rc1 (2009.09.20) but the macros are needed in "sync" mode only.</p>

        <p>check_multi includes support since v0.21 (2010.06.03), but you have to rerun the installation using '<code class="code">configure
        --with-nagios_name=icinga</code>' so that check_multi contains the correct values. You can use the option "-s" instead to set
        certain values.</p>
      </li>
<li class="listitem">
        <p>the configuration file names of the (enhanced) IDOUtils are named <code class="filename">idomod.cfg/ido2db.cfg</code> instead of
        <code class="filename">ndomod.cfg/ndo2db.cfg</code></p>
      </li>
</ul></div>

    <p>Become the icinga user. Debian/Ubuntu users might use <code class="code">sudo -s icinga</code>.</p>

    <pre class="screen"> $ su -l nagios</pre>

    <p>Get the latest Icinga version from <a class="link" href="http://www.icinga.org/download/" target="_top">https://www.icinga.com/</a></p>

    <pre class="screen"> #&gt; wget https://github.com/Icinga/icinga-core/releases/download/v<span class="emphasis"><em>1.14</em></span>/icinga-<span class="emphasis"><em>1.14</em></span>.tar.gz</pre>

    <p>Extract the tarball and change to the directory just created</p>

    <pre class="screen"> #&gt; tar xzf icinga-<span class="emphasis"><em>1.14</em></span>.tar.gz
 #&gt; cd icinga-<span class="emphasis"><em>1.14</em></span> </pre>

    <p>Start the Icinga-configure-script with the options you used the last time with Nagios. You'll find the call in the
    file config.log. Example:</p>

    <pre class="screen"> #&gt; ./configure --with-command-group=nagcmd</pre>

    <p>Compile the Icinga source code.</p>

    <pre class="screen"> #&gt; make all</pre>

    <p>Install the programs, documentation, classic web interface and the init script. Your existing config files will not be
    overwritten.</p>

    <pre class="screen"> #&gt; make cgis 
 #&gt; make install
 #&gt; make install-cgis
 #&gt; make install-init</pre>

    <p>or simply</p>

    <pre class="screen"> #&gt; make fullinstall</pre>

    <div class="important" title="Important" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Important">
<tr>
<td rowspan="2" align="center" valign="top" width="25"><img alt="[Important]" src="../images/important.png"></td>
<th align="left">Important</th>
</tr>
<tr><td align="left" valign="top">
      <p>Not till Icinga 1.5.0 <code class="literal">make install-config</code> is NOT included in <code class="literal">make fullinstall</code>
      anymore to avoid accidental overwriting of your config files.</p>
    </td></tr>
</table></div>

    <p>Instead of using "<code class="code">make install-config</code>" copy your configuration files from
    <code class="filename">&lt;Nagios-path&gt;/etc/</code> to <code class="filename">&lt;Icinga-path&gt;/etc/</code>. Before starting Icinga you have
    to alter some things:</p>

    <div class="itemizedlist"><ul class="itemizedlist" type="disc">
<li class="listitem">
        <p>The filename of the main config file has changed from <code class="filename">nagios.cfg</code> to <code class="filename">icinga.cfg</code>.
        <code class="literal"> #&gt; mv nagios.cfg icinga.cfg</code> should be sufficient to change that</p>
      </li>
<li class="listitem">
        <p>You have to edit the main config file (<code class="filename">icinga.cfg</code>) to change the directives named "nagios_user" and
        "nagios_group" to "icinga_user" and "icinga_group" respectively. Depending on the paths you're using you may have to change them as
        well.</p>

        <pre class="programlisting"> #&gt; sed -i 's/nagios/icinga/g' ./icinga.cfg/</pre>
      </li>
<li class="listitem">
        <p>You have to edit the CGI config file (<code class="filename">cgi.cfg</code>) to change the paths you're using.</p>

        <pre class="programlisting"> #&gt; sed -i 's/nagios/icinga/g' ./cgi.cfg/</pre>
      </li>
</ul></div>

    <p>Copy other relevant files from your Nagios installation to the new location. If you are unsure about the path then please
    have a look at <code class="filename">nagios.cfg</code> and/or <code class="filename">icinga.cfg</code>.</p>

    <div class="itemizedlist"><ul class="itemizedlist" type="disc">
<li class="listitem">
        <p><code class="filename">retention.dat</code> (it contains certain status information, comments and other "sticky" stuff)</p>
      </li>
<li class="listitem">
        <p><code class="filename">nagios.log</code> (rename it to <code class="filename">icinga.log</code>)</p>
      </li>
<li class="listitem">
        <p><code class="filename">archives/nagios-&lt;date&gt;.log</code> files (Icinga is able to process both nagios-&lt;date&gt;.log and
        icinga-&lt;date&gt;.log files so you don't have to rename the files)</p>
      </li>
<li class="listitem">
        <p>You don't have to copy <code class="filename">status.dat</code> and/or <code class="filename">objects.cache</code> because these files are
        recreated during startup. Please recreate <code class="filename">objects.precache</code> before startup <a class="link" href="configmain.html#configmain-precached_object_file">if applicable</a> instead of copying it</p>
      </li>
</ul></div>

    <p>Verify your configuration files, correct errors (if any) and start Icinga.</p>

    <pre class="screen"> #&gt; /usr/local/icinga/bin/icinga -v /usr/local/icinga/etc/icinga.cfg
 #&gt; /etc/init.d/icinga start</pre>

    <p>That's it - you're done!</p>

    <p>Please keep in mind that</p>

    <div class="itemizedlist"><ul class="itemizedlist" type="disc">
<li class="listitem">
        <p>the URL has changed to http://localhost/icinga/ (for the classic UI)</p>
      </li>
<li class="listitem">
        <p>the name of the admin user has changed to icingaadmin</p>
      </li>
</ul></div>

    <a class="indexterm" name="idm140381637680576"></a>

    <a class="indexterm" name="idm140381637678912"></a>

    <a class="indexterm" name="idm140381637677152"></a>
  </div>

  <div class="section" title="2.10.3. Upgrading from Nagios 2.x Releases">
<div class="titlepage"><div><div><h3 class="title">
<a name="upgradenagios2x"></a>2.10.3. Upgrading from Nagios 2.x Releases</h3></div></div></div>
    

    <p>It shouldn't be too difficult to upgrade from Nagios 2.x to Icinga 1.14. The upgrade is essentially the same
    as what is described above for upgrading from Nagios 3.x releases. You will, however, have to change your configuration files a
    bit so they work with Icinga 1.14:</p>

    <div class="itemizedlist"><ul class="itemizedlist" type="disc">
<li class="listitem">
        <p>The old <span class="emphasis"><em>service_reaper_frequency</em></span> variable in the main config file has been renamed to <a class="link" href="configmain.html#configmain-check_result_reaper_frequency">check_result_reaper_frequency</a>.</p>
      </li>
<li class="listitem">
        <p>The old <span class="emphasis"><em>$NOTIFICATIONNUMBER$</em></span> macro has been deprecated in favour of new <a class="link" href="macrolist.html#macrolist-hostnotificationnumber">$HOSTNOTIFICATIONNUMBER$</a> and <a class="link" href="macrolist.html#macrolist-servicenotificationnumber">$SERVICENOTIFICATIONNUMBER$</a> macros.</p>
      </li>
<li class="listitem">
        <p>The old <span class="emphasis"><em>parallelize</em></span> directive in service definitions is now deprecated and no longer used, as all service
        checks are run in parallel.</p>
      </li>
<li class="listitem">
        <p>The old <span class="emphasis"><em>aggregate_status_updates</em></span> option has been removed. All status file updates are now aggregated at a
        minimum interval of 1 second.</p>
      </li>
<li class="listitem">
        <p>Extended host and extended service definitions have been deprecated. They are still read and processed by Icinga, but
        it is recommended that you move the directives found in these definitions to your host and service definitions, respectively.</p>
      </li>
<li class="listitem">
        <p>The old <span class="emphasis"><em>downtime_file</em></span> file variable in the main config file is no longer supported, as scheduled downtime
        entries are now saved in the <a class="link" href="configmain.html#configmain-state_retention_file">retention file</a>. To preserve existing downtime
        entries, stop Nagios 2.x and append the contents of your old downtime file to the retention file.</p>
      </li>
<li class="listitem">
        <p>The old <span class="emphasis"><em>comment_file</em></span> file variable in the main config file is no longer supported, as comments are now
        saved in the <a class="link" href="configmain.html#configmain-state_retention_file">retention file</a>. To preserve existing comments, stop
        Nagios 2.x and append the contents of your old comment file to the retention file.</p>
      </li>
</ul></div>

    <p>Also make sure to read the "<a class="link" href="whatsnew.html" title="1.2. What's New in Icinga 1.14">What's New</a>" section of the documentation. It describes all the changes
    that were made to the Icinga code since the latest stable release of Nagios 3.0.6. Quite a bit has changed, so make sure
    you read it over.</p>
  </div>

  <div class="section" title="2.10.4. Upgrading from an RPM Installation">
<div class="titlepage"><div><div><h3 class="title">
<a name="upgradefromrpm"></a>2.10.4. Upgrading from an RPM Installation</h3></div></div></div>
    

    <p>If you currently have an RPM- or Debian/Ubuntu APT package-based installation of Nagios and you would like to transition to
    installing Icinga from the official source code distribution, here's the basic process you should follow:</p>

    <div class="orderedlist"><ol class="orderedlist" type="1">
<li class="listitem">
        <p>Backup your existing Nagios installation</p>

        <div class="itemizedlist"><ul class="itemizedlist" type="disc">
<li class="listitem">
            <p>Configuration files</p>

            <div class="itemizedlist"><ul class="itemizedlist" type="circle">
<li class="listitem">
                  <p>Main config file (usually <code class="filename">nagios.cfg</code>)</p>
                </li>
<li class="listitem">
                  <p>Resource config file (usually <code class="filename">resource.cfg</code>)</p>
                </li>
<li class="listitem">
                  <p>CGI config file (usually <code class="filename">cgi.cfg</code>)</p>
                </li>
<li class="listitem">
                  <p>All your object definition files</p>
                </li>
</ul></div>
          </li>
<li class="listitem">
            <p>Retention file (usually <code class="filename">retention.dat</code>)</p>
          </li>
<li class="listitem">
            <p>Current Nagios log file (usually <code class="filename">nagios.log</code>)</p>
          </li>
<li class="listitem">
            <p>Archived Nagios log files (usually <code class="filename">nagios-&lt;date&gt;.log</code>)</p>
          </li>
</ul></div>
      </li>
<li class="listitem">
        <p>Uninstall the original RPM or APT package</p>
      </li>
<li class="listitem">
        <p>Install Icinga from source by following the <a class="link" href="quickstart.html" title="2.3. Quickstart Installation Guides">quickstart guide</a></p>
      </li>
<li class="listitem">
        <p>Restore your original Nagios configuration files, retention file, and log files</p>
      </li>
<li class="listitem">
        <p><a class="link" href="verifyconfig.html" title="4.1. Verifying Your Configuration">Verify</a> your configuration and <a class="link" href="startstop.html" title="4.2. Starting and Stopping Icinga">start</a> Icinga</p>
      </li>
</ol></div>

    <p>Note that different RPMs or APT packages may install Icinga in different ways and in different locations. Make sure you've
    backed up all your critical Nagios files before removing the original RPM or APT package, so you can revert back if you encounter
    problems.</p>

    <a class="indexterm" name="idm140381637637648"></a>

    <a class="indexterm" name="idm140381637635888"></a>
  </div>
</div>
<div class="navfooter">
<hr>
<table width="100%" summary="Navigation footer">
<tr>
<td width="40%" align="left">
<a accesskey="p" href="howtos.html">Prev</a> </td>
<td width="20%" align="center"><a accesskey="u" href="ch02.html">Up</a></td>
<td width="40%" align="right"> <a accesskey="n" href="upgrading_idoutils.html">Next</a>
</td>
</tr>
<tr>
<td width="40%" align="left" valign="top">2.9. Links to other published Howtos </td>
<td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td>
<td width="40%" align="right" valign="top"> 2.11. Upgrading IDOUtils Database</td>
</tr>
</table>
</div>
<P class="copyright">© 1999-2009 Ethan Galstad, 2009-2017 Icinga Development Team, https://www.icinga.com</P>
</body>
</html>