[icinga-checkins] icinga.org: icinga-doc/master: upgrading_icingaweb.xml, first draft

git at icinga.org git at icinga.org
Thu Jan 20 21:54:20 CET 2011


Module: icinga-doc
Branch: master
Commit: 12bb650030aeb0bd3959d9310527f08fbda5b4ee
URL:    https://git.icinga.org/?p=icinga-doc.git;a=commit;h=12bb650030aeb0bd3959d9310527f08fbda5b4ee

Author: Lara Berdelsmann <berdelsmann at arcor.de>
Date:   Thu Jan 20 21:53:52 2011 +0100

upgrading_icingaweb.xml, first draft

---

 de/Icinga.xml              |    1 +
 de/icinga-web-scratch.xml  |    2 +-
 de/upgrading_icingaweb.xml |   98 ++++++++++++++++++++++++++++++++++++++++++++
 en/Icinga.xml              |    1 +
 en/upgrading.xml           |   33 +++++++--------
 en/upgrading_icingaweb.xml |    2 +-
 6 files changed, 118 insertions(+), 19 deletions(-)

diff --git a/de/Icinga.xml b/de/Icinga.xml
index 08ca22a..f28cf83 100644
--- a/de/Icinga.xml
+++ b/de/Icinga.xml
@@ -233,6 +233,7 @@
     <xi:include href="cgis.xml" />
 
     <xi:include href="icinga-web-scratch.xml" />
+<xi:include href="upgrading_icingaweb.xml" />
 
     <xi:include href="icinga-web-intro.xml" />
 
diff --git a/de/icinga-web-scratch.xml b/de/icinga-web-scratch.xml
index 8902e23..9896311 100644
--- a/de/icinga-web-scratch.xml
+++ b/de/icinga-web-scratch.xml
@@ -498,7 +498,7 @@ Alias /icinga-web /usr/local/icinga-web/pub
     </listitem>
 
     <listitem>
-      <para><emphasis role="bold">Test &Fehler?</emphasis></para>
+<para><anchor xml:id="icinga-web-errors" /> <emphasis role="bold">Test &Fehler?</emphasis></para>
 
       <para>Diese Sammlung beinhaltet einige nützliche Informationen, wie Sie Fehler finden und lösen können. Ebenso wird darauf
       hingewiesen, welche Informationen Sie im Fehlerfall angeben sollen, wenn Sie eine Frage auf den Mailinglisten oder auf <link
diff --git a/de/upgrading_icingaweb.xml b/de/upgrading_icingaweb.xml
new file mode 100644
index 0000000..8fce6b0
--- /dev/null
+++ b/de/upgrading_icingaweb.xml
@@ -0,0 +1,98 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE chapter [
+<!ENTITY % all.entities SYSTEM "all-entities.ent">
+%all.entities;
+]>
+<section version="5.0" xml:id="upgrading_icingaweb" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"
+         xmlns:xi="http://www.w3.org/2001/XInclude" xmlns:svg="http://www.w3.org/2000/svg" xmlns:m="http://www.w3.org/1998/Math/MathML"
+         xmlns:html="http://www.w3.org/1999/xhtml" xmlns:db="http://docbook.org/ns/docbook">
+  <title>Upgrading &name-web;</title>
+
+  <para><emphasis role="bold">Aktualisieren von &name-web;</emphasis></para>
+
+  <para>Sobald neuere Versionen von &name-web; herauskommen, sollten Sie dringend über eine Aktualisierung nachdenken. Neuere Ausgaben
+  enthalten Behebungen kritischer Fehler, so dass es wichtig ist, aktuell zu sein. Wenn Sie bereits &name-web;, wie in den
+  Schnellstartanleitungen beschrieben, aus dem Quellcode installiert haben, dann können Sie einfach neuere Versionen installieren.</para>
+
+  <para>Stellen Sie sicher, dass Sie eine vollständige Datensicherung Ihrer bestehenden &name-web;-Installation und der Konfigurationsdateien
+  haben (wenn Sie Ihre benutzerdefinierte Konfiguration in *.site.xml- Dateien erstellt haben, so werden diese während der Aktualisierung nicht überschrieben!). Wenn irgendetwas schief geht oder nicht funktioniert, dann können Sie auf diese Weise schnell Ihre alte &name-web;-Version
+  wiederherstellen.</para>
+
+  <para>Bitte denken Sie daran, dass <code>configure</code> mit den gleichen Optionen wie bei der vorherigen Installation aufzurufen ist!
+  Die verwendeten Optionen sehen Sie im <code>config.log</code></para>
+
+  <para>Stellen Sie sicher, dass Sie die passende &name-api; version installiert haben. Dien Installation der &name-api; ist in der 
+  <link linkend="icinga-api">Icinga-API</link> Section beschrieben.</para>
+
+  <para><emphasis role="bold">Die Aktualisierung von &name-web;</emphasis></para>
+
+  <para>Bitte laden Sie das Archiv von <link
+  xlink:href="http://sourceforge.net/projects/icinga/files/">http://sourceforge.net/projects/icinga/files/</link>herunter oder klonen Sie den aktuellsten git- Branch mit :</para>
+
+  <programlisting> #> git clone git://git.icinga.org/icinga-web.git</programlisting>
+
+  <para>Entpacken Sie das Archiv (tarball):</para>
+
+  <programlisting> #> tar xzvf icinga-web-&ver-icingaweb;.tar.gz</programlisting>
+
+  <para>Wechseln Sie in das Verzeichnis</para>
+
+  <programlisting> #> cd icinga-web</programlisting>
+
+  <para>&name-web; bietet diverse Konfigurationsoptionen an:</para>
+
+  <programlisting> #> ./configure 
+                --prefix=/usr/local/icinga-web 
+                --with-web-user=www-data 
+                --with-web-group=www-data 
+                --with-web-path=/icinga-web 
+                --with-web-apache-path=/etc/apache2/conf.d 
+                --with-db-type=mysql 
+                --with-db-host=localhost 
+                --with-db-port=3306 
+                --with-db-name=icinga_web 
+                --with-db-user=icinga_web 
+                --with-db-pass=icinga_web 
+                --with-icinga-api=/usr/local/icinga/share/icinga-api 
+                --with-api-type=APICON API type (default CONNECTION_IDO)
+                --with-api-subtype=TYPE DB driver or network connection
+                --with-api-host=HOST Host to connect (DB or other) (default localhost)
+                --with-api-port=PORT Port for connection (default 3306)
+                --with-api-socket=PATH Path to socket (default none)</programlisting>
+
+  <note>
+    <para>Bitte beachten Sie, dass Sie hier die &name-web;-Datenbank konfigurieren, und nicht die Icinga-IDOUtils-Datenbank! User- und
+        Gruppenname des Web-Prozesses sind abhängig von der verwendeten Distribution.</para>
+  </note>
+
+  <para>Alle configure- Optionen sehen Sie mit:</para>
+
+  <programlisting> #> ./configure --help</programlisting>
+    <note>
+    <para>Wenn Sie configure ohne weitere Optionen ausführen, erwartet der Installer die &name-api; unter /usr/local/share/icinga-api.</para>
+  </note>
+
+  <para>Die Aktualisierung von &name-web; unter /usr/local/icinga-web erfolgt mit:</para>
+
+  <programlisting> #> ./configure
+ #> make upgrade</programlisting>
+
+  <note>
+    <para>Bitte denken Sie daran den Cache zu leeren!</para>
+  </note> 
+
+  <programlisting> #> rm -rf app/cache/config/*.php</programlisting>
+
+  <para>oder</para>
+
+  <programlisting>/icinga-web/bin/clearcache.sh.</programlisting>
+<para>Das war's, Sie können sich nun an Ihrem aktualisierten &name-web; anmelden.</para>
+<para>Bekannte Fehler sind hier beschrieben:<link linkend="icinga-web-scratch-errors">Fehler?</link></para>
+  <indexterm zone="upgrading_icingaweb">
+    <primary>Aktualisierung von &name-web;</primary>
+  </indexterm>
+
+  <indexterm zone="upgrading_icingaweb">
+    <primary>Update von &name-web;</primary>
+  </indexterm>
+</section>
diff --git a/en/Icinga.xml b/en/Icinga.xml
index 3ccc15b..dd3d2f4 100644
--- a/en/Icinga.xml
+++ b/en/Icinga.xml
@@ -238,6 +238,7 @@
 
       <xi:include href="cgis.xml" />
       <xi:include href="icinga-web-scratch.xml" />
+<xi:include href="upgrading_icingaweb.xml" />
 <xi:include href="icinga-web-config.xml" />
       <xi:include href="icinga-web-intro.xml" />
       <xi:include href="icinga-web-pnp.xml" />
diff --git a/en/upgrading.xml b/en/upgrading.xml
index 5780faf..22e0d5b 100644
--- a/en/upgrading.xml
+++ b/en/upgrading.xml
@@ -23,23 +23,6 @@
   <para>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.</para>
 
-  <para><emphasis role="bold">&name-icinga; 0.8.0 to &name-icinga; &ver-icinga;</emphasis></para>
-
-  <para>Archived Logfilename</para>
-
-  <para>There was a small misspelling bug in &name-icinga; 0.8.0 resulting in archived logfile names beginning with a capital <emphasis
-  role="bold">"I"</emphasis> like in <emphasis role="bold">'Icinga-$date'</emphasis>". This was fixed in version 0.8.1. and newer.</para>
-
-  <para>If you experience this problem then please use the following script to fix the file names</para>
-
-  <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</programlisting>
-
   <para><emphasis role="bold">Normal &name-icinga; update Path</emphasis></para>
 
   <para>If there's a new &name-icinga; version available on &url-icinga; you should consider updating. Newer versions contain bugfixes,
@@ -62,6 +45,22 @@
   or decide what you want to upgrade by just typing 'make' which shows all available options. Check your config and restart Icinga.
   <programlisting> #> /etc/init.d/icinga checkconfig
  #> /etc/init.d/icinga restart</programlisting> That's it!</para>
+<para><emphasis role="bold">&name-icinga; 0.8.0 to &name-icinga; &ver-icinga;</emphasis></para>
+
+  <para>Archived Logfilename</para>
+
+  <para>There was a small misspelling bug in &name-icinga; 0.8.0 resulting in archived logfile names beginning with a capital <emphasis
+  role="bold">"I"</emphasis> like in <emphasis role="bold">'Icinga-$date'</emphasis>". This was fixed in version 0.8.1. and newer.</para>
+
+  <para>If you experience this problem then please use the following script to fix the file names</para>
+
+  <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</programlisting>
 
   <para><emphasis role="bold"><anchor xml:id="upgrading-nagios3x" /> Upgrading from &name-nagios; 3.x Releases</emphasis></para>
 
diff --git a/en/upgrading_icingaweb.xml b/en/upgrading_icingaweb.xml
index 9d42524..03e2ea2 100644
--- a/en/upgrading_icingaweb.xml
+++ b/en/upgrading_icingaweb.xml
@@ -73,7 +73,7 @@
   <para>to see all configure options.</para>
 
   <note>
-    <para>Using no options the installer expects the icinga-API to be found at /usr/local/share/icinga-api.</para>
+    <para>Using no options the installer expects the &name-api; to be found at /usr/local/share/icinga-api.</para>
   </note>
 
   <para>Per default the &name-web; will be updated to /usr/local/icinga-web using:</para>





More information about the icinga-checkins mailing list