[icinga-checkins] icinga.org: icinga-doc/master: quickstart guide: w/o idoutils, add idoutils for FreeBSD
git at icinga.org
git at icinga.org
Fri Apr 8 22:26:20 CEST 2011
Module: icinga-doc
Branch: master
Commit: ab4c4f835563c2d61c1fc6dda22a1649f86f26e3
URL: https://git.icinga.org/?p=icinga-doc.git;a=commit;h=ab4c4f835563c2d61c1fc6dda22a1649f86f26e3
Author: Wolfgang <wnd at gmx.net>
Date: Fri Apr 8 22:22:56 2011 +0200
quickstart guide: w/o idoutils, add idoutils for FreeBSD
---
de/quickstart.xml | 37 ++++++++++++++++++++++++++++++++-----
en/quickstart.xml | 30 +++++++++++++++++++++++++++---
ent/names.ent | 18 +++++++++---------
3 files changed, 68 insertions(+), 17 deletions(-)
diff --git a/de/quickstart.xml b/de/quickstart.xml
index db6a449..620d34a 100644
--- a/de/quickstart.xml
+++ b/de/quickstart.xml
@@ -10,10 +10,12 @@
<para><emphasis role="bold">Einführung</emphasis></para>
- <para>Diese Schnellstartanleitungen sind dazu gedacht, Ihnen einfache Anweisungen zu liefern, wie Sie &name-icinga; innerhalb von 20
- Minuten aus dem Quellcode installieren und Ihren lokalen Rechner damit überwachen. Hier werden keine fortgeschrittenen
+ <para>Diese Schnellstartanleitungen sind dazu gedacht, Ihnen einfache Anweisungen zu liefern, wie Sie &name-icinga; innerhalb von 20 bis
+ 30 Minuten aus dem Quellcode installieren und Ihren lokalen Rechner damit überwachen. Hier werden keine fortgeschrittenen
Installationsoptionen vorgestellt - lediglich die Grundlagen, die für 95% aller Benutzer funktionieren, die anfangen wollen.</para>
+
<para>Verweise zu Konfigurations-Tools und anderen Addons finden Sie <link linkend="addons">hier</link>.</para>
+
<para>Außerdem gibt es eine neue Schnellstartanleitung für die Installation von &name-icinga; zusammen mit den &name-idoutils; für die
Anbindung einer &name-mysql;-, &name-oracle;- oder &name-postgres;-Datenbank.</para>
@@ -23,6 +25,27 @@
&name-opensuse;. Einige Distributionen sind ähnlich, so dass Sie diese Anleitungen voraussichtlich auch für &name-redhat;, &name-debian;
und &name-sles; verwenden können. Von Marcel Hecko stammt eine Anleitung für &name-icinga; auf &name-freebsd;</para>
+ <note>
+ <para>Bitte beachten Sie, dass sich teilweise die Namen der Pakete zwischen verschiedenen Versionen des gleichen Betriebssystems
+ verändern. Wenn Sie also die genannten Pakete nicht finden, dann sollten Sie Ihre bevorzugte Suchmaschine nutzen, um den korrekten Namen
+ zu ermitteln.</para>
+ </note>
+
+ <para>Die <link linkend="quickstart-icinga">Schnellstartanleitung für &name-linux;</link> und die <link
+ linkend="quickstart-icinga-freebsd">Schnellstartanleitung für &name-freebsd;</link> geben Ihnen Anweisungen für die Installation von
+ &name-icinga;, grundlegenden Plugins, um verschiedene Dinge zu prüfen, und der klassischen GUI, auf die sie mit Ihrem Web-Browser
+ zugreifen können. Das äußere Erscheinungsbild ist &name-nagios;-ähnlich, obwohl die GUI verschiedene Verbesserungen bietet (z.B.
+ erweiterter CSV-Export, Befehle gleichzeitig für mehrere Objekte, usw.). Es gibt keine Datenbank und alle Informationen werden in normalen
+ Dateien gespeichert. &name-web; ist in diesem Setup <emphasis>nicht</emphasis> verfügbar.</para>
+
+ <para>Mit Hilfe der <link linkend="quickstart-idoutils">Schnellstartanleitung für &name-icinga; mit &name-idoutils;</link> und der <link
+ linkend="quickstart-idoutils-freebsd">Schnellstartanleitung für &name-icinga; mit &name-idoutils; für &name-freebsd;</link> bekommen Sie
+ die o.g. Dinge sowie eine Datenbank zur Speicherung von aktuellen und historischen Informationen. Die Datenbank wird
+ <emphasis>nicht</emphasis> benutzt, um die Konfiguration über ein Web-Interface zu ermöglichen. Es gibt verschiedene <link
+ linkend="addons">Addons</link>, die auf diesen Zweck spezialisiert sind und es gibt keine Pläne für ein eingebautes Tool. Das neue
+ &name-icingaweb; kann installiert werden, wenn Sie dieses Setup benutzen. Separate Anweisungen finden Sie <link
+ linkend="icinga-web-scratch">hier</link>.</para>
+
<itemizedlist>
<listitem>
<para><link linkend="quickstart-icinga">Schnellstartanleitung für &name-linux;</link></para>
@@ -35,12 +58,16 @@
<listitem>
<para><link linkend="quickstart-idoutils">Schnellstartanleitung für &name-icinga; mit &name-idoutils;</link></para>
</listitem>
+
+ <listitem>
+ <para><link linkend="quickstart-idoutils">Schnellstartanleitung für &name-icinga; mit &name-idoutils; für &name-freebsd;</link></para>
+ </listitem>
</itemizedlist>
<para>Wenn Sie &name-icinga; auf einem Betriebssystem oder einer &name-linux;-Distribution installieren, die oben nicht aufgeführt ist,
- lesen Sie die <xref linkend="quickstart-icinga" />-Anleitung, um einen Überblick zu bekommen, was zu tun ist. Befehlsnamen, Pfade und
- anderes variiert stark zwischen verschiedenen Betriebssystemen/Distributionen, so dass Sie wahrscheinlich die Installationsanleitung ein
- wenig anpassen müssen, damit sie für Ihren besonderen Fall funktioniert.</para>
+ lesen Sie die <link linkend="quickstart-icinga">Schnellstartanleitung für Linux</link>, um einen Überblick zu bekommen, was zu tun ist.
+ Befehlsnamen, Pfade und anderes variiert stark zwischen verschiedenen Betriebssystemen/Distributionen, so dass Sie wahrscheinlich die
+ Installationsanleitung ein wenig anpassen müssen, damit sie für Ihren besonderen Fall funktioniert.</para>
<indexterm zone="quickstart">
<primary>Schnellstart</primary>
diff --git a/en/quickstart.xml b/en/quickstart.xml
index ae03751..f496ae9 100644
--- a/en/quickstart.xml
+++ b/en/quickstart.xml
@@ -11,7 +11,7 @@
<para><emphasis role="bold"><anchor xml:id="introduction_quickstart" />Introduction</emphasis></para>
<para>These quickstart guides will provide you with simple instructions on how to install &name-icinga; from source and have it monitoring
- your local machine within 20 minutes. Advanced installation options and configuration are discussed elsewhere.</para>
+ your local machine within 20 to 30 minutes. Advanced installation options and configuration are discussed elsewhere.</para>
<para>Links to configuration tools and other addons can be found <link linkend="addons">here</link>.</para>
@@ -24,6 +24,26 @@
&name-opensuse;). Because some distributions are similar you may succeed to use these instructions for &name-redhat;, &name-centos;,
&name-debian; and &name-sles; as well. Marcel Hecko provided a quickstart quide for &name-freebsd;.</para>
+ <note>
+ <para>Please note that sometimes names of packages change between different versions of the same OS so if you don't find the packages
+ mentioned it might be a good idea to use your favourite search engine to find out the correct name.</para>
+ </note>
+
+ <para>The <link linkend="quickstart-icinga">Quickstart guide for &name-linux;</link> and <link
+ linkend="quickstart-icinga-freebsd">Quickstart guide for &name-freebsd;</link>, resp., provide you with instructions on how to install
+ &name-icinga;, basic plugins to check several things and the classical GUI accessible through your web browser. The look and feel is quite
+ similar to &name-nagios; although the GUI offers some enhancements (extended CSV export, submit commands for a group of objects, etc.).
+ There is no database involved and all information is stored in flat files. &name-web; is <emphasis>not</emphasis> available in this
+ setup.</para>
+
+ <para>Using the <link linkend="quickstart-idoutils">Quickstart guide including &name-idoutils;</link> and <link
+ linkend="quickstart-idoutils-freebsd">Quickstart guide including &name-idoutils; on &name-freebsd;</link>, resp., you will get the things
+ mentioned above plus a database (using &name-mysql;, &name-oracle;, or &name-postgres;) to store current and historical information. The
+ database is <emphasis>not</emphasis> used to enable configuration via a web interface. There are several <link
+ linkend="addons">addons</link> specialised on this and there are no plans for a builtin tool. The new web interface can be installed when
+ you use this setup. There are <link linkend="icinga-web-scratch">separate instructions</link> on how
+ to do this after you installed &name-icinga; and &name-idoutils;.</para>
+
<itemizedlist>
<listitem>
<para>See: <link linkend="quickstart-icinga">Quickstart guide for &name-linux;</link></para>
@@ -36,10 +56,14 @@
<listitem>
<para>See: <link linkend="quickstart-idoutils">Quickstart guide including &name-idoutils;</link></para>
</listitem>
+
+ <listitem>
+ <para>See: <link linkend="quickstart-idoutils-freebsd">Quickstart guide including &name-idoutils; on &name-freebsd;</link></para>
+ </listitem>
</itemizedlist>
- <para>If you are installing &name-icinga; on an operating system or Linux distribution that isn't listed above, read <xref
- linkend="quickstart-icinga" /> for an overview of what you'll need to do.</para>
+ <para>If you are installing &name-icinga; on an operating system or Linux distribution that isn't listed above, read <link
+ linkend="quickstart-icinga">Quickstart guide for &name-linux;</link> for an overview on what you'll need to do.</para>
<para>Command names, paths, etc. vary widely across different Operating Systems/Distributions, so you'll likely need to tweak the
installation docs a bit to work for your particular case.</para>
diff --git a/ent/names.ent b/ent/names.ent
index 15b81d2..eaddcce 100644
--- a/ent/names.ent
+++ b/ent/names.ent
@@ -4,17 +4,17 @@
<!ENTITY name-nsca "NSCA">
<!ENTITY name-nsclient "NSClient++">
<!ENTITY name-nagios "Nagios">
-<!ENTITY name-nagioswiki "Nagios Wiki">
-<!ENTITY name-icingawiki "Icinga Wiki">
+<!ENTITY name-nagioswiki "Nagios-Wiki">
+<!ENTITY name-icingawiki "Icinga-Wiki">
<!ENTITY name-icinga "Icinga">
-<!ENTITY name-icingaweb "Icinga Webinterface">
-<!ENTITY name-web "Icinga Web">
+<!ENTITY name-icingaweb "Icinga-Webinterface">
+<!ENTITY name-web "Icinga-Web">
<!ENTITY name-ui "Icinga Classic UI">
-<!ENTITY name-core "Icinga Core">
-<!ENTITY name-docs "Icinga Docs">
-<!ENTITY name-api "Icinga API">
-<!ENTITY name-wapi "Icinga Web API">
-<!ENTITY name-rep "Icinga Reporting">
+<!ENTITY name-core "Icinga-Core">
+<!ENTITY name-docs "Icinga-Docs">
+<!ENTITY name-api "Icinga-API">
+<!ENTITY name-wapi "Icinga-Web-API">
+<!ENTITY name-rep "Icinga-Reporting">
<!ENTITY name-stats "icingastats">
<!ENTITY name-icingalists "Icinga mailing lists">
<!ENTITY name-idoutils "IDOUtils">
More information about the icinga-checkins
mailing list