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
|
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Upgrading (to) Icinga</title>
<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.0.2 Documentation">
<link rel="up" href="ch02.html" title="Chapter 2. Getting Started">
<link rel="prev" href="quickstart-idoutils.html" title="Icinga with IDOUtils Quickstart">
<link rel="next" href="upgrading_idoutils.html" title="Upgrading IDOUtils Database">
</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">Upgrading (to) Icinga</th></tr>
<tr>
<td width="20%" align="left">
<a accesskey="p" href="quickstart-idoutils.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="Upgrading (to) Icinga">
<div class="titlepage"><div><div><h2 class="title" style="clear: both">
<a name="upgrading"></a><a name="upgrading_nagios"></a>Upgrading (to) Icinga</h2></div></div></div>
<p><span class="bold"><strong>Contents</strong></span></p>
<p><a class="link" href="upgrading.html#upgrading-icinga">Upgrading from previous Icinga releases</a></p>
<p><a class="link" href="upgrading.html#upgrading-nagios3x">Upgrading from Nagios 3.x releases</a></p>
<p><a class="link" href="upgrading.html#upgrading-nagios2x">Upgrading from Nagios 2.x releases</a></p>
<p><a class="link" href="upgrading.html#upgrading-rpm">Upgrading from an RPM installation</a></p>
<p><span class="bold"><strong><a name="upgrading-icinga"></a> Upgrading from previous Icinga Releases</strong></span></p>
<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>Icinga 0.8.0 to Icinga 1.0.2</strong></span></p>
<p>Archived Logfilename</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"> #> 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>Normal Icinga update Path</strong></span></p>
<p>If there's a new Icinga version available on http://www.icinga.org/ 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 by 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="code">config.log</code> and save that in a safe
location.</p>
<p>Become icinga user. Debian/Ubuntu users might use <code class="code">sudo -s icinga</code>. </p>
<pre class="programlisting"> $> su -l icinga</pre>
<p> Get
the latest Icinga version from http://www.icinga.org/ and extract it. Then run configure like you did with the old version. </p>
<pre class="programlisting"> #> ./configure --with-command-group=icinga-cmd --enable-idoutils</pre>
<p>
Compile the source. </p>
<pre class="programlisting"> #> 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> if you want to manually diff the config
files. </p>
<pre class="programlisting"> #> 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"> #> /etc/init.d/icinga checkconfig
#> /etc/init.d/icinga restart</pre>
<p> That's it!</p>
<p><span class="bold"><strong><a name="upgrading-nagios3x"></a> Upgrading from Nagios 3.x Releases</strong></span></p>
<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.0.2. Assuming you've already installed Nagios from source
code as described in the Nagios quickstart guide, you can install Icinga quite easily.</p>
<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" target="_top">quickstart guide</a>. Instead of using "make
install-config" copy your configuration files from <span class="emphasis"><em><Nagios-path>/etc/</em></span> to
<span class="emphasis"><em><Icinga-path>/etc/</em></span>. 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 <span class="emphasis"><em>nagios.cfg</em></span> to <span class="emphasis"><em>icinga.cfg</em></span>.
<code class="literal"> #> 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 (icinga.cfg) 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"> #> sed -i 's/nagios/icinga/g' ./icinga.cfg/</pre>
</li>
<li class="listitem">
<p>You have to edit the CGI config file (cgi.cfg) to change the paths you're using.</p>
<pre class="programlisting"> #> sed -i 's/nagios/icinga/g' ./cgi.cfg/</pre>
</li>
</ul></div>
<p>Verify your configuration files and restart Icinga.</p>
<pre class="screen"> #> /usr/local/icinga/bin/icinga -v /usr/local/icinga/etc/icinga.cfg
#> /etc/init.d/icinga restart</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/</p>
</li>
<li class="listitem">
<p>the name of the admin user has changed to icingaadmin</p>
</li>
</ul></div>
<p><span class="bold"><strong><a name="upgrading-nagios2x"></a> Upgrading from Nagios 2.x Releases</strong></span></p>
<p>It shouldn't be too difficult to upgrade from Nagios 2.x to Icinga 1.0.2. 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.0.2:</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="What's New in Icinga Core 1.0.2 and Icinga Web 1.0.1">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>
<p><span class="bold"><strong><a name="upgrading-rpm"></a> Upgrading From an RPM Installation</strong></span></p>
<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 <span class="emphasis"><em>nagios.cfg</em></span>)</p>
</li>
<li class="listitem">
<p>Resource config file (usually <span class="emphasis"><em>resource.cfg</em></span>)</p>
</li>
<li class="listitem">
<p>CGI config file (usually <span class="emphasis"><em>cgi.cfg</em></span>)</p>
</li>
<li class="listitem">
<p>All your object definition files</p>
</li>
</ul></div>
</li>
<li class="listitem">
<p>Retention file (usually <span class="emphasis"><em>retention.dat</em></span>)</p>
</li>
<li class="listitem">
<p>Current Nagios log file (usually <span class="emphasis"><em>nagios.log</em></span>)</p>
</li>
<li class="listitem">
<p>Archived Nagios log files</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="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="Verifying Your Configuration">Verify</a> your configuration and <a class="link" href="startstop.html" title="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="id1920694"></a>
<a class="indexterm" name="id1920724"></a>
<a class="indexterm" name="id1920739"></a>
<a class="indexterm" name="id1920749"></a>
</div>
<div class="navfooter">
<hr>
<table width="100%" summary="Navigation footer">
<tr>
<td width="40%" align="left">
<a accesskey="p" href="quickstart-idoutils.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">Icinga with IDOUtils Quickstart </td>
<td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td>
<td width="40%" align="right" valign="top"> Upgrading IDOUtils Database</td>
</tr>
</table>
</div>
<P class="copyright">© 2009-2010 Icinga Development Team, http://www.icinga.org</P>
</body>
</html>
|
