[icinga-checkins] icinga.org: icinga-doc/next: docs issue #3750: use_transactions / enable_socket_queue / EXPERIMENTAL

git at icinga.org git at icinga.org
Wed Apr 10 21:09:55 CEST 2013


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

Author: Wolfgang <wnd at gmx.net>
Date:   Mon Mar 11 23:08:09 2013 +0100

docs issue #3750: use_transactions / enable_socket_queue / EXPERIMENTAL

---

 de/configido.xml |  108 ++++++++++++++++++++++++++++++++++++++++++++++++++++++
 en/configido.xml |  106 +++++++++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 214 insertions(+), 0 deletions(-)

diff --git a/de/configido.xml b/de/configido.xml
index 9412d48..07b2b3b 100644
--- a/de/configido.xml
+++ b/de/configido.xml
@@ -1786,6 +1786,102 @@
       <para>Diese Option ist verfügbar ab &name-icinga; 1.6</para>
     </note>
 
+    <para><anchor xml:id="configido-use_transactions"/> <emphasis role="bold">Transaktionen aktivieren</emphasis></para>
+
+    <informaltable frame="none">
+      <tgroup cols="2">
+        <colspec colname="c1" colwidth="20"/>
+
+        <colspec colname="c2" colwidth="*"/>
+
+        <tbody>
+          <row>
+            <entry><para>Format:</para></entry>
+
+            <entry><para><emphasis role="bold">use_transactions=<0|1></emphasis></para></entry>
+          </row>
+
+          <row>
+            <entry><para>Example:</para></entry>
+
+            <entry><para><emphasis condition="red" role="color"><emphasis role="bold">use_transactions=0</emphasis>
+            </emphasis></para></entry>
+          </row>
+        </tbody>
+      </tgroup>
+    </informaltable>
+
+    <para>Diese Einstellung aktiviert SQL-Transaktionen während der Datenverarbeitng. Das ist sinnvoll beim Dump von Konfigurationsobjekten
+    und deren Beziehungen (Kontakte, etc.), beim normalen Betrieb wird es nicht viel ausmachen. Das Ziel ist ganz klar die
+    Reload-/Restart-Zeit zu reduzieren, wenn idomod die Konfigurationsdaten ausgibt, und dabei den Core blockiert..</para>
+
+    <para>Mögliche Werte sind:<itemizedlist>
+        <listitem>
+          <para>0 = disabled (Default)</para>
+        </listitem>
+
+        <listitem>
+          <para>1 = enabled</para>
+        </listitem>
+      </itemizedlist></para>
+
+    <important>
+      <para>Dies benutzt BEGIN / COMMIT für die Transaktionen - stellen Sie sicher, dass Ihr RDBMS das unterstützt<emphasis
+      role="bold">.</emphasis></para>
+    </important>
+
+    <note>
+      <para>Diese Option ist verfügbar ab &name-icinga; 1.9.</para>
+    </note>
+
+    <para><anchor xml:id="configido-enable_socket_queue"/> <emphasis role="bold">Socket-Queue aktivieren</emphasis></para>
+
+    <informaltable frame="none">
+      <tgroup cols="2">
+        <colspec colname="c1" colwidth="20"/>
+
+        <colspec colname="c2" colwidth="*"/>
+
+        <tbody>
+          <row>
+            <entry><para>Format:</para></entry>
+
+            <entry><para><emphasis role="bold">enable_socket_queue=<0|1></emphasis></para></entry>
+          </row>
+
+          <row>
+            <entry><para>Example:</para></entry>
+
+            <entry><para><emphasis condition="red" role="color"><emphasis role="bold">enable_socket_queue=0</emphasis>
+            </emphasis></para></entry>
+          </row>
+        </tbody>
+      </tgroup>
+    </informaltable>
+
+    <para>Diese Option aktiviert eine Socket-Queue, die Daten vom IDO-Socket und den Daten(bank)-Aktionen weiterleitet.</para>
+
+    <para>Mögliche Werte sind:<itemizedlist>
+        <listitem>
+          <para>0 = disabled (Default)</para>
+        </listitem>
+
+        <listitem>
+          <para>1 = enabled</para>
+        </listitem>
+      </itemizedlist></para>
+
+    <important>
+      <para>Diese Einstellung ist hochgradig experimentell und kann zu Datenverlusten führen, wenn sie aktiviert ist. Das ist besonders
+      nachteilig bei der Ausgabe der Konfiguration während des Reload/Restart. Aktivieren Sie auf eigenes Risiko, und - falls Probleme
+      auftreten - geben Sie an, dass Sie diese Einstellung verändert haben. <emphasis role="bold">Wir haben Sie gewarnt</emphasis><emphasis
+      role="bold">.</emphasis></para>
+    </important>
+
+    <note>
+      <para>Diese Option ist verfügbar ab &name-icinga; 1.9.</para>
+    </note>
+
     <indexterm zone="configido">
       <primary>IDOUtils</primary>
 
@@ -2349,5 +2445,17 @@
 
       <secondary>ido2db.cfg</secondary>
     </indexterm>
+
+    <indexterm zone="configido-use_transactions">
+      <primary>use_transactions=</primary>
+
+      <secondary>ido2db.cfg</secondary>
+    </indexterm>
+
+    <indexterm zone="configido-enable_socket_queue">
+      <primary>enable_socket_queue=</primary>
+
+      <secondary>ido2db.cfg</secondary>
+    </indexterm>
   </section>
 </section>
diff --git a/en/configido.xml b/en/configido.xml
index be21d23..520b1e1 100644
--- a/en/configido.xml
+++ b/en/configido.xml
@@ -1760,6 +1760,100 @@
       <para>This option is available starting with &name-icinga; 1.6.</para>
     </note>
 
+    <para><anchor xml:id="configido-use_transactions"/> <emphasis role="bold">Enable transactions</emphasis></para>
+
+    <informaltable frame="none">
+      <tgroup cols="2">
+        <colspec colname="c1" colwidth="20"/>
+
+        <colspec colname="c2" colwidth="*"/>
+
+        <tbody>
+          <row>
+            <entry><para>Format:</para></entry>
+
+            <entry><para><emphasis role="bold">use_transactions=<0|1></emphasis></para></entry>
+          </row>
+
+          <row>
+            <entry><para>Example:</para></entry>
+
+            <entry><para><emphasis condition="red" role="color"><emphasis role="bold">use_transactions=0</emphasis>
+            </emphasis></para></entry>
+          </row>
+        </tbody>
+      </tgroup>
+    </informaltable>
+
+    <para>This setting enables SQL transactions during data processing. It will be useful when dumping config objects and their relations
+    (contacts, etc), during normal operations it won't help that much. The intention is clearly to reduce the reload/restart time when
+    idomod dumps the config data, blocking the core.</para>
+
+    <para>Possible values are:<itemizedlist>
+        <listitem>
+          <para>0 = disabled (default)</para>
+        </listitem>
+
+        <listitem>
+          <para>1 = enabled</para>
+        </listitem>
+      </itemizedlist></para>
+
+    <important>
+      <para>This uses BEGIN / COMMIT for the transactions - make sure this works with your DBMS<emphasis role="bold">.</emphasis></para>
+    </important>
+
+    <note>
+      <para>This option is available starting with &name-icinga; 1.9.</para>
+    </note>
+
+    <para><anchor xml:id="configido-enable_socket_queue"/> <emphasis role="bold">Enable socket queue</emphasis></para>
+
+    <informaltable frame="none">
+      <tgroup cols="2">
+        <colspec colname="c1" colwidth="20"/>
+
+        <colspec colname="c2" colwidth="*"/>
+
+        <tbody>
+          <row>
+            <entry><para>Format:</para></entry>
+
+            <entry><para><emphasis role="bold">enable_socket_queue=<0|1></emphasis></para></entry>
+          </row>
+
+          <row>
+            <entry><para>Example:</para></entry>
+
+            <entry><para><emphasis condition="red" role="color"><emphasis role="bold">enable_socket_queue=0</emphasis>
+            </emphasis></para></entry>
+          </row>
+        </tbody>
+      </tgroup>
+    </informaltable>
+
+    <para>This setting enables a socket queue which will proxy the data received from ido socket and the data(base) actions.</para>
+
+    <para>Possible values are:<itemizedlist>
+        <listitem>
+          <para>0 = disabled (default)</para>
+        </listitem>
+
+        <listitem>
+          <para>1 = enabled</para>
+        </listitem>
+      </itemizedlist></para>
+
+    <important>
+      <para>This setting is highly experimental and may cause data loss on your system if enabled. This is especially harmful when dumping
+      the config during core reload/restart. If problems occur, explicitely tell that you are using this feature. <emphasis
+      role="bold">You've been warned</emphasis><emphasis role="bold">.</emphasis></para>
+    </important>
+
+    <note>
+      <para>This option is available starting with &name-icinga; 1.9.</para>
+    </note>
+
     <indexterm zone="configido">
       <primary>IDOUtils</primary>
 
@@ -2323,5 +2417,17 @@
 
       <secondary>ido2db.cfg</secondary>
     </indexterm>
+
+    <indexterm zone="configido-use_transactions">
+      <primary>use_transactions=</primary>
+
+      <secondary>ido2db.cfg</secondary>
+    </indexterm>
+
+    <indexterm zone="configido-enable_socket_queue">
+      <primary>enable_socket_queue=</primary>
+
+      <secondary>ido2db.cfg</secondary>
+    </indexterm>
   </section>
 </section>





More information about the icinga-checkins mailing list