[icinga-checkins] icinga.org: icinga-doc/master: docs issue #890: change instance name

git at icinga.org git at icinga.org
Wed Apr 27 00:24:01 CEST 2011


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

Author: Wolfgang <wnd at gmx.net>
Date:   Tue Apr 26 23:15:41 2011 +0200

docs issue #890: change instance name

---

 de/Icinga.xml     |    2 +
 de/db_changes.xml |   69 +++++++++++++++++++++++++++++++++++++++++++++++++++++
 en/Icinga.xml     |    2 +
 en/db_changes.xml |   68 ++++++++++++++++++++++++++++++++++++++++++++++++++++
 4 files changed, 141 insertions(+), 0 deletions(-)

diff --git a/de/Icinga.xml b/de/Icinga.xml
index 7758d3a..7eeb3c7 100644
--- a/de/Icinga.xml
+++ b/de/Icinga.xml
@@ -368,6 +368,8 @@
     <xi:include href="db_example-configs.xml" />
 
     <xi:include href="db_model.xml" />
+
+    <xi:include href="db_changes.xml" />
   </chapter>
 
   <index></index>
diff --git a/de/db_changes.xml b/de/db_changes.xml
new file mode 100644
index 0000000..d337636
--- /dev/null
+++ b/de/db_changes.xml
@@ -0,0 +1,69 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE section [
+<!ENTITY % all.entities SYSTEM "all-entities.ent">
+%all.entities;
+]>
+<section version="5.0" xml:id="db_changes" 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>Datenbank-Anpassungen/Änderungen</title>
+
+  <para><anchor xml:id="db_changes-instancename" /> <emphasis role="bold">Ändern des Instance-Namens</emphasis></para>
+
+  <para>Möglicherweise möchten Sie den Instance-Namen ändern. Es gibt einige Schritte, die im folgenden Abschnitt beschrieben sind. Danke an
+  <link xlink:href="https://dev.icinga.org/users/210">ralfk</link>, der uns diese Anleitung geliefert hat.</para>
+
+  <itemizedlist>
+    <listitem>
+      <para>Stoppen Sie &name-icinga; und die ido2db-Daemonen (denn anderenfalls wird statt einer Änderung automatisch ein neuer Instanzname
+      zur Datenbank hinzugefügt)<programlisting> #> /etc/init.d/icinga stop
+ #> /etc/init.d/ido2db stop</programlisting></para>
+    </listitem>
+
+    <listitem>
+      <para>Ändern Sie den Instanznamen in der Datei <filename>/usr/local/icinga/etc/idomod.cfg</filename> <programlisting> instance_name=newinstance</programlisting></para>
+    </listitem>
+
+    <listitem>
+      <para>Ändern Sie den Instanznamen in der Datenbanktabelle "icinga_instances" bzw. "instances"</para>
+
+      <para><emphasis role="bold">&name-mysql;/&name-postgres;</emphasis></para>
+
+      <programlisting> SQL> UPDATE icinga_instances SET instance_name='NEWNAME' WHERE instance_name='OLDNAME';</programlisting>
+
+      <para><emphasis role="bold">&name-oracle;</emphasis></para>
+
+      <programlisting> SQL> UPDATE instances SET instance_name='NEWNAME' WHERE instance_name='OLDNAME';</programlisting>
+    </listitem>
+
+    <listitem>
+      <para>Ändern Sie den Instanznamen in der command pipe-Konfiguration in einer der folgenden Dateien (Site-Datei an erster
+      Stelle)</para>
+
+      <itemizedlist>
+        <listitem>
+          <para><filename>/usr/local/icinga-web/app/modules/Web/config/icinga-io.xml</filename></para>
+        </listitem>
+
+        <listitem>
+          <para><filename>/usr/local/icinga-web/app/modules/Web/config/icinga-io.site.xml</filename></para>
+        </listitem>
+      </itemizedlist>
+    </listitem>
+
+    <listitem>
+      <para>Löschen Sie den Web-Cache<programlisting> #> /usr/local/icinga-web/bin/clearcache.sh</programlisting></para>
+    </listitem>
+
+    <listitem>
+      <para>Starten Sie &name-icinga; und die ido2db-Daemonen<programlisting> #> /etc/init.d/ido2db start
+ #> /etc/init.d/icinga start</programlisting></para>
+    </listitem>
+  </itemizedlist>
+
+  <indexterm zone="db_changes-instancename">
+    <primary>&name-idoutils;</primary>
+
+    <secondary>Instanznamen ändern</secondary>
+  </indexterm>
+</section>
diff --git a/en/Icinga.xml b/en/Icinga.xml
index 9aebf25..a9fe2ce 100644
--- a/en/Icinga.xml
+++ b/en/Icinga.xml
@@ -372,6 +372,8 @@
     <xi:include href="db_example-configs.xml" />
 
     <xi:include href="db_model.xml" />
+
+    <xi:include href="db_changes.xml" />
   </chapter>
 
   <index></index>
diff --git a/en/db_changes.xml b/en/db_changes.xml
new file mode 100644
index 0000000..efbd110
--- /dev/null
+++ b/en/db_changes.xml
@@ -0,0 +1,68 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE section [
+<!ENTITY % all.entities SYSTEM "all-entities.ent">
+%all.entities;
+]>
+<section version="5.0" xml:id="db_changes" 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>Database changes/alterations</title>
+
+  <para><anchor xml:id="db_changes-instancename" /> <emphasis role="bold">Change the instance name</emphasis></para>
+
+  <para>You may have the need to change the instance name. There are some steps to be done which are described in this section. Thanks to
+  <link xlink:href="https://dev.icinga.org/users/210">ralfk</link> who provided us with these instructions.</para>
+
+  <itemizedlist>
+    <listitem>
+      <para>Stop &name-icinga; and ido2db daemons (since otherwise a new instance would automatically be added to DB instead of renaming
+      it)<programlisting> #> /etc/init.d/icinga stop
+ #> /etc/init.d/ido2db stop</programlisting></para>
+    </listitem>
+
+    <listitem>
+      <para>Change the instance name in <filename>/usr/local/icinga/etc/idomod.cfg</filename> <programlisting> instance_name=newinstance</programlisting></para>
+    </listitem>
+
+    <listitem>
+      <para>Change the instance name in the database table "icinga_instances" or "instances"</para>
+
+      <para><emphasis role="bold">&name-mysql;/&name-postgres;</emphasis></para>
+
+      <programlisting> SQL> UPDATE icinga_instances SET instance_name='NEWNAME' WHERE instance_name='OLDNAME';</programlisting>
+
+      <para><emphasis role="bold">&name-oracle;</emphasis></para>
+
+      <programlisting> SQL> UPDATE instances SET instance_name='NEWNAME' WHERE instance_name='OLDNAME';</programlisting>
+    </listitem>
+
+    <listitem>
+      <para>Change the instance name in the command pipe configuration in one of these files (site file in first place)</para>
+
+      <itemizedlist>
+        <listitem>
+          <para><filename>/usr/local/icinga-web/app/modules/Web/config/icinga-io.xml</filename></para>
+        </listitem>
+
+        <listitem>
+          <para><filename>/usr/local/icinga-web/app/modules/Web/config/icinga-io.site.xml</filename></para>
+        </listitem>
+      </itemizedlist>
+    </listitem>
+
+    <listitem>
+      <para>Clear the Web Cache<programlisting> #> /usr/local/icinga-web/bin/clearcache.sh</programlisting></para>
+    </listitem>
+
+    <listitem>
+      <para>Start &name-icinga; and ido2db Daemons<programlisting> #> /etc/init.d/ido2db start
+ #> /etc/init.d/icinga start</programlisting></para>
+    </listitem>
+  </itemizedlist>
+
+  <indexterm zone="db_changes-instancename">
+    <primary>&name-idoutils;</primary>
+
+    <secondary>Change instance name</secondary>
+  </indexterm>
+</section>





More information about the icinga-checkins mailing list