docs issue #3939: add upgrade/troubleshooting notes about invisible c…

…ronks/modules on upgrade

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 =&gt; 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 -&gt; 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>
@@ -720,10 +752,6 @@ Alias /icinga-web /usr/local/icinga-web/pub
         enabled ?</para>
       </listitem>
 
-      <listitem>
-        <para>.htaccess/VHost-Konfiguration =&gt; Pfade nicht korrekt? Icinga-Web zeigt keine Daten?</para>
-      </listitem>
-
       <listitem>
         <para>Datenbankzugriff verweigert =&gt; Überprüfen Sie, ob die Datenbankeinstellungen für &name-web; korrekt sind.</para>
       </listitem>

de/upgrading_icingaweb.xml

@@ -27,6 +27,32 @@
       <para>Seit 1.9 ist der Tackle-Cronk in &name-web; veraltet.</para>
     </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 -&gt; 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>

en/icinga-web-scratch.xml

@@ -711,6 +711,33 @@ Alias /icinga-web /usr/local/icinga-web/pub
       <listitem>
         <para>.htaccess/vhost config =&gt; 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 -&gt; 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>

en/upgrading_icingaweb.xml

@@ -26,6 +26,32 @@
       <para>Starting with 1.9, the tackle cronk in &name-web; is deprecated.</para>
     </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 -&gt; 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>