[icinga-checkins] icinga.org: icinga-doc/next: docs issue #3939: add upgrade/ troubleshooting notes about invisible cronks/modules on upgrade

git at icinga.org git at icinga.org
Wed Apr 10 23:28:21 CEST 2013


Module: icinga-doc
Branch: next
Commit: 0feb9428a23d43b5ea23ff64b24deb53af24a06e
URL:    https://git.icinga.org/?p=icinga-doc.git;a=commit;h=0feb9428a23d43b5ea23ff64b24deb53af24a06e

Author: Wolfgang <wnd at gmx.net>
Date:   Wed Apr 10 23:20:41 2013 +0200

docs issue #3939: add upgrade/troubleshooting notes about invisible cronks/modules on upgrade

---

 de/icinga-web-scratch.xml  |   36 ++++++++++++++++++++++++++++++++----
 de/upgrading_icingaweb.xml |   26 ++++++++++++++++++++++++++
 en/icinga-web-scratch.xml  |   27 +++++++++++++++++++++++++++
 en/upgrading_icingaweb.xml |   26 ++++++++++++++++++++++++++
 4 files changed, 111 insertions(+), 4 deletions(-)

diff --git a/de/icinga-web-scratch.xml b/de/icinga-web-scratch.xml
index c1755fc..ca2e1ea 100644
--- a/de/icinga-web-scratch.xml
+++ b/de/icinga-web-scratch.xml
@@ -710,6 +710,38 @@ Alias /icinga-web /usr/local/icinga-web/pub
         Fehlermeldung: ".htaccess: Invalid command 'RewriteEngine', perhaps misspelled or defined by a module not included in the server
         configuration"</para>
       </listitem>
+
+      <listitem>
+        <para>.htaccess/VHost-Konfiguration => Pfade nicht korrekt? Icinga-Web zeigt keine Daten?</para>
+      </listitem>
+
+      <listitem>
+        <para>"Ich kann meinen neu installierten Cronk nicht sehen" oder "nach einem Update kann ich nicht auf das Reporting-Cronk
+        zugreifen"</para>
+
+        <para>Beginnend mit 1.8.2 gibt es einen neuen Session-Cache, der beim Update von &name-web; bzw. der Installation eines neuen Cronks
+        oder Moduls ggf. zu Irritationen führen kann. Die Lösung ist recht einfach</para>
+
+        <itemizedlist>
+          <listitem>
+            <para>Löschen Sie den xml-Cache</para>
+          </listitem>
+
+          <listitem>
+            <para>Zurücksetzen des Applikationszustands des Benutzers (rechte obere Ecke -> Preferences)</para>
+          </listitem>
+
+          <listitem>
+            <para>Abmelden und neu anmelden (rechte obere Ecke)</para>
+
+            <para><inlinemediaobject>
+                <imageobject>
+                  <imagedata fileref="../images/icinga-web-user-prefs-logout.png" format="PNG"/>
+                </imageobject>
+              </inlinemediaobject></para>
+          </listitem>
+        </itemizedlist>
+      </listitem>
     </itemizedlist>
 
     <para>Icinga Web - Login erfolgt- aber die Seite lädt und lädt...</para>
@@ -721,10 +753,6 @@ Alias /icinga-web /usr/local/icinga-web/pub
       </listitem>
 
       <listitem>
-        <para>.htaccess/VHost-Konfiguration => Pfade nicht korrekt? Icinga-Web zeigt keine Daten?</para>
-      </listitem>
-
-      <listitem>
         <para>Datenbankzugriff verweigert => Überprüfen Sie, ob die Datenbankeinstellungen für &name-web; korrekt sind.</para>
       </listitem>
     </itemizedlist>
diff --git a/de/upgrading_icingaweb.xml b/de/upgrading_icingaweb.xml
index 2893fb7..8dbb921 100644
--- a/de/upgrading_icingaweb.xml
+++ b/de/upgrading_icingaweb.xml
@@ -28,6 +28,32 @@
     </note>
 
     <note>
+      <para>Beginnend mit 1.8.2 gibt es einen neuen Session-Cache, der beim Update von &name-web; bzw. der Installation eines neuen Cronks
+      oder Moduls ggf. zu Irritationen führen kann. Wenn Sie ein Verhalten feststellen wie "Ich kann meinen neu installierten Cronk nicht
+      sehen" oder "nach einem Update kann ich nicht auf das Reporting-Cronk zugreifen", dann ist die Lösung recht einfach</para>
+
+      <itemizedlist>
+        <listitem>
+          <para>Löschen Sie den xml-Cache</para>
+        </listitem>
+
+        <listitem>
+          <para>Zurücksetzen des Applikationszustands des Benutzers (rechte obere Ecke -> Preferences)</para>
+        </listitem>
+
+        <listitem>
+          <para>Abmelden und neu anmelden (rechte obere Ecke)</para>
+
+          <para><inlinemediaobject>
+              <imageobject>
+                <imagedata fileref="../images/icinga-web-user-prefs-logout.png" format="PNG"/>
+              </imageobject>
+            </inlinemediaobject></para>
+        </listitem>
+      </itemizedlist>
+    </note>
+
+    <note>
       <para>Bitte beachten Sie, dass es einige wesentliche Änderungen mit Icinga 1.5 gab, die ggf. zusätzliche Aktionen erfordern
       könnten:</para>
 
diff --git a/en/icinga-web-scratch.xml b/en/icinga-web-scratch.xml
index 91fbed7..30bb702 100644
--- a/en/icinga-web-scratch.xml
+++ b/en/icinga-web-scratch.xml
@@ -711,6 +711,33 @@ Alias /icinga-web /usr/local/icinga-web/pub
       <listitem>
         <para>.htaccess/vhost config => paths not correct?</para>
       </listitem>
+
+      <listitem>
+        <para>"I cannot see my newly installed cronk?" or "after upgrade, I cannot access the reporting cronk"</para>
+
+        <para>Starting with 1.8.2, a new session cache was added which may cause irritations when upgrading icinga web / installing a new
+        cronk or module. The resolution is rather simple</para>
+
+        <itemizedlist>
+          <listitem>
+            <para>clear the xml cache</para>
+          </listitem>
+
+          <listitem>
+            <para>reset the users application state (top right corner -> preferences)</para>
+          </listitem>
+
+          <listitem>
+            <para>logout and re-login (top right corner)</para>
+
+            <para><inlinemediaobject>
+                <imageobject>
+                  <imagedata fileref="../images/icinga-web-user-prefs-logout.png" format="PNG"/>
+                </imageobject>
+              </inlinemediaobject></para>
+          </listitem>
+        </itemizedlist>
+      </listitem>
     </itemizedlist>
 
     <para>Icinga Web does not show any data?</para>
diff --git a/en/upgrading_icingaweb.xml b/en/upgrading_icingaweb.xml
index 2ff21fa..fd2bcf9 100644
--- a/en/upgrading_icingaweb.xml
+++ b/en/upgrading_icingaweb.xml
@@ -27,6 +27,32 @@
     </note>
 
     <note>
+      <para>Starting with 1.8.2, a new session cache was added which may cause irritations when upgrading icinga web / installing a new
+      cronk or module. If you experience a behaviour like "I cannot see my newly installed cronk?" or "after upgrade, I cannot access the
+      reporting cronk" the resolution is rather simple</para>
+
+      <itemizedlist>
+        <listitem>
+          <para>clear the xml cache</para>
+        </listitem>
+
+        <listitem>
+          <para>reset the users application state (top right corner -> preferences)</para>
+        </listitem>
+
+        <listitem>
+          <para>logout and re-login (top right corner)</para>
+
+          <para><inlinemediaobject>
+              <imageobject>
+                <imagedata fileref="../images/icinga-web-user-prefs-logout.png" format="PNG"/>
+              </imageobject>
+            </inlinemediaobject></para>
+        </listitem>
+      </itemizedlist>
+    </note>
+
+    <note>
       <para>Please note that there were some major changes starting with Icinga 1.5 that may require some additional actions:</para>
 
       <itemizedlist>





More information about the icinga-checkins mailing list