[icinga-checkins] icinga.org: icinga-doc/r1.6: docs issue #2092: changed idoutils timezone behaviour

git at icinga.org git at icinga.org
Wed Nov 23 00:36:59 CET 2011


Module: icinga-doc
Branch: r1.6
Commit: aab11b373b8e3e6718f9c98db195c4d336cdc85f
URL:    https://git.icinga.org/?p=icinga-doc.git;a=commit;h=aab11b373b8e3e6718f9c98db195c4d336cdc85f

Author: Wolfgang <wnd at gmx.net>
Date:   Sat Nov 19 23:01:00 2011 +0100

docs issue #2092: changed idoutils timezone behaviour

---

 de/quickstart-idoutils-freebsd.xml |   20 ++++++++++++++++++++
 de/quickstart-idoutils.xml         |   20 ++++++++++++++++++++
 en/quickstart-idoutils-freebsd.xml |   15 +++++++++++++++
 en/quickstart-idoutils.xml         |   17 +++++++++++++++++
 4 files changed, 72 insertions(+), 0 deletions(-)

diff --git a/de/quickstart-idoutils-freebsd.xml b/de/quickstart-idoutils-freebsd.xml
index eed31bc..4f80769 100644
--- a/de/quickstart-idoutils-freebsd.xml
+++ b/de/quickstart-idoutils-freebsd.xml
@@ -108,6 +108,22 @@
 
   <para>Wenn Sie Oracle als RDBMS einsetzen möchten, dann ist das unter &name-freebsd; leider nicht so ohne weiteres möglich.</para>
 
+  <para><anchor xml:id="quickstart-idoutils_timezone-support" /><emphasis role="bold">Zeitzonenunterstützung</emphasis></para>
+  <para>Ab &name-icinga; 1.6 werden alle Zeit-/Datumsinformationen als lokale Zeitstempel in der Datenbank gespeichert. Vorher gab es für
+  jedes Datenbanksystem unterschiedliche Vorgehensweisen beim Speichern und Abrufen der Daten, was schwierig für Frontend-Applikationen war.
+  Deshalb wurden die Datentypen geändert: für &name-mysql; von DATETIME in TIMESTAMP und für &name-oracle; von DATE in LOCAL TIMESTAMP (0).
+  &name-postgres; benutzt bereits TIMESTAMP. IDO2DB wird die Sitzungszeitzone auf UTC setzen und alle Unix-Timestamps (die per Definition
+  UTC sind) als UTC-Werte speichern. Bitte stellen Sie sicher, dass Ihr System Unix-Timestamps als UTC-basierte Werte ausgibt (wie "date -u
+  '+%s'").</para>
+  <note><para>Stellen Sie sicher, dass Ihre Datenbanksitzung in der gleichen Zeitzone läuft, in der die existierenden
+  Zeit-/Datumsinformationen gespeichert wurden (überprüfen Sie Ihre lokale Zeitzone, z.B. &name-oracle;: "select sessiontimezone from
+  dual;"), wenn Sie das Upgrade-Script laufen lassen.
+  Zusätzlich für Ihre Bequemlichkeit sollten Sie in &name-oracle; das Format der Sitzungszeitstempel auf den Wert zu setzen, den Sie
+  wünschen, z.B. "alter session set nls_timestamp_format='YYYY-MM-DD HH24:MI:SS'; oder etwas ähnliches.
+  Nun können Sie Einträge von verschiedenen &name-icinga;-Installationen in unterschiedlichen Zeitzonen ansehen, die in der gleichen
+  Datenbank gespeichert wurden, und unabhängig davon, von woher Sie darauf zugreifen, werden sie in Ihrer lokalen Zeitzone angezeigt.
+  </para></note>
+
   <para><emphasis role="bold">Installation der Pakete</emphasis></para>
 
   <para>Sie können diese Pakete aus den ports installieren oder Sie nehmen fertige und evtl. ältere packages (siehe
@@ -459,4 +475,8 @@
 
     <secondary>&name-icinga; und &name-idoutils; auf &name-freebsd;</secondary>
   </indexterm>
+
+  <indexterm zone="quickstart-idoutils_timezone-support">
+    <primary>&name-idoutils; / Zeitzonen-Unterstützung</primary>
+  </indexterm>
 </section>
diff --git a/de/quickstart-idoutils.xml b/de/quickstart-idoutils.xml
index 84fe197..62b6959 100644
--- a/de/quickstart-idoutils.xml
+++ b/de/quickstart-idoutils.xml
@@ -159,6 +159,22 @@
   und (mindestens) mit den gleichen Rechten definiert sind und dass die korrekten Einstellungen in <filename>icinga_defines.sql</filename>
   vorhanden sind.</para>
 
+  <para><anchor xml:id="quickstart-idoutils_timezone-support" /><emphasis role="bold">Zeitzonenunterstützung</emphasis></para>
+  <para>Ab &name-icinga; 1.6 werden alle Zeit-/Datumsinformationen als lokale Zeitstempel in der Datenbank gespeichert. Vorher gab es für
+  jedes Datenbanksystem unterschiedliche Vorgehensweisen beim Speichern und Abrufen der Daten, was schwierig für Frontend-Applikationen war.
+  Deshalb wurden die Datentypen geändert: für &name-mysql; von DATETIME in TIMESTAMP und für &name-oracle; von DATE in LOCAL TIMESTAMP (0).
+  &name-postgres; benutzt bereits TIMESTAMP. IDO2DB wird die Sitzungszeitzone auf UTC setzen und alle Unix-Timestamps (die per Definition
+  UTC sind) als UTC-Werte speichern. Bitte stellen Sie sicher, dass Ihr System Unix-Timestamps als UTC-basierte Werte ausgibt (wie "date -u
+  '+%s'").</para>
+  <note><para>Stellen Sie sicher, dass Ihre Datenbanksitzung in der gleichen Zeitzone läuft, in der die existierenden
+  Zeit-/Datumsinformationen gespeichert wurden (überprüfen Sie Ihre lokale Zeitzone, z.B. &name-oracle;: "select sessiontimezone from
+  dual;"), wenn Sie das Upgrade-Script laufen lassen.
+  Zusätzlich für Ihre Bequemlichkeit sollten Sie in &name-oracle; das Format der Sitzungszeitstempel auf den Wert zu setzen, den Sie
+  wünschen, z.B. "alter session set nls_timestamp_format='YYYY-MM-DD HH24:MI:SS'; oder etwas ähnliches. 
+  Nun können Sie Einträge von verschiedenen &name-icinga;-Installationen in unterschiedlichen Zeitzonen ansehen, die in der gleichen
+  Datenbank gespeichert wurden, und unabhängig davon, von woher Sie darauf zugreifen, werden sie in Ihrer lokalen Zeitzone angezeigt.
+  </para></note>
+
   <para><emphasis role="bold">Installation der Pakete</emphasis></para>
 
   <para>Sie können diese Pakete mit Hilfe der folgenden Befehle installieren (als root oder mit sudo):</para>
@@ -758,4 +774,8 @@
 
     <secondary>&name-icinga; mit &name-idoutils;</secondary>
   </indexterm>
+
+  <indexterm zone="quickstart-idoutils_timezone-support">
+    <primary>&name-idoutils; / Zeitzonen-Unterstützung</primary>
+  </indexterm>
 </section>
diff --git a/en/quickstart-idoutils-freebsd.xml b/en/quickstart-idoutils-freebsd.xml
index 0b3009f..eaa69a1 100644
--- a/en/quickstart-idoutils-freebsd.xml
+++ b/en/quickstart-idoutils-freebsd.xml
@@ -105,6 +105,17 @@
 
   <para>If you want to use Oracle as an RDBMS then we are sorry. Unfortunately it isn't that easy with &name-freebsd;.</para>
 
+  <para><anchor xml:id="quickstart_idof-timezone_support" /><emphasis role="bold">Timezone support</emphasis></para>
+  <para>Starting with &name-icinga; 1.6 all dates are stored as local timestamps in the database. Before that there was a different 
+  behaviour storing and retrieving dates for each database system which was difficult to handle for frontend apps. Therefore datatypes have   been changed for &name-mysql; from DATETIME to TIMESTAMP and for &name-oracle; from DATE to LOCAL TIMESTAMP (0). &name-postgres; is 
+  already using TIMESTAMP. IDO2DB will set session timezone to UTC and store all unix timestamps (which are UTC per definition) to UTC
+  values. Please make sure your system returns unix timestamps as real UTC based values (like "date -u '+%s'").</para>
+  <note><para>Make sure your database session runs in the same timezone in which the existing dates have been stored (check your local
+  timezone e.g. &name-oracle;:"select sessiontimezone from dual;") if you are running the upgrade script.
+  Additionally for your convenience in &name-oracle; you should set your session timestamp format to the value you want, e.g "alter session   set nls_timestamp_format='YYYY-MM-DD HH24:MI:SS';" or similar.
+  Now you can view entries from different &name-icinga; installations in different time zones which are stored in the same database and 
+  regardless from where you accessing it, all entries are returned in your local time zone.</para></note>
+
   <para><emphasis role="bold">Install the packages</emphasis></para>
 
   <para>You can install the packages from the ports or you take older packages (have a look at the <link
@@ -461,4 +472,8 @@
 
     <secondary>&name-icinga; and &name-idoutils; on &name-freebsd;</secondary>
   </indexterm>
+
+  <indexterm zone="quickstart_idof-timezone_support">
+    <primary>&name-idoutils; / timezone support</primary>
+  </indexterm>
 </section>
diff --git a/en/quickstart-idoutils.xml b/en/quickstart-idoutils.xml
index acecbb7..e4058e4 100644
--- a/en/quickstart-idoutils.xml
+++ b/en/quickstart-idoutils.xml
@@ -152,6 +152,19 @@
   and are defined with the same (or more) rights and that the correct settings have been applied to
   <filename>icinga_defines.sql</filename>.</para>
 
+  <para><anchor xml:id="quickstart-idoutils_timezone-support" /><emphasis role="bold">Timezone support</emphasis></para>
+  <para>Starting with &name-icinga; 1.6 all dates are stored as local timestamps in the database. Before that there was a different
+  behaviour storing and retrieving dates for each database system which was difficult to handle for frontend apps. Therefore datatypes have
+  been changed for &name-mysql; from DATETIME to TIMESTAMP and for &name-oracle; from DATE to LOCAL TIMESTAMP (0). &name-postgres; is
+  already using TIMESTAMP. IDO2DB will set session timezone to UTC and store all unix timestamps (which are UTC per definition) to UTC
+  values. Please make sure your system returns unix timestamps as real UTC based values (like "date -u '+%s'").</para>
+  <note><para>Make sure your database session runs in the same timezone in which the existing dates have been stored (check your local
+  timezone e.g. &name-oracle;:"select sessiontimezone from dual;") if you are running the upgrade script.
+  Additionally for your convenience in &name-oracle; you should set your session timestamp format to the value you want, e.g "alter session
+  set nls_timestamp_format='YYYY-MM-DD HH24:MI:SS';" or similar.
+  Now you can view entries from different &name-icinga; installations in different time zones which are stored in the same database and
+  regardless from where you accessing it, all entries are returned in your local time zone.</para></note>
+
   <para><emphasis role="bold">Install Packages</emphasis></para>
 
   <para>You can install your packages by running the following commands (as root or sudo):</para>
@@ -690,4 +703,8 @@
 
     <secondary>&name-icinga; with &name-idoutils;</secondary>
   </indexterm>
+
+  <indexterm zone="quickstart-idoutils_timezone-support">
+    <primary>&name-idoutils; / timezone support</primary>
+  </indexterm>
 </section>





More information about the icinga-checkins mailing list