Checkmk
diff --git a/‎src/common/de/monitoring_oracle.asciidoc‎
Lines changed: 31 additions & 22 deletions b/‎src/common/de/monitoring_oracle.asciidoc‎
Lines changed: 31 additions & 22 deletions
@@ -59,25 +59,25 @@ Das Agentenplugin für die Unix-artigen Betriebssysteme Linux, Solaris, AIX hei
 Zusätzliche Software wird weder auf dem {CMK}-Server noch auf dem Datenbankserver für eine Überwachung benötigt.
 
 Viele Schritte, um die Überwachung einzurichten, sind zwischen Linux und Windows gleich.
-Die Unterschiede sind im Kapitel zur xref:#detailed_setup[Einrichtung unter Linux, Solaris, AIX und Windows] gekennzeichnet.
-Mit der xref:glossar#agent_bakery[Agentenbäckerei] der kommerziellen Editionen haben Sie die Möglichkeit, die Einrichtung für verschiedene Umgebungen xref:#bakery[an einer Stelle] zu konfigurieren.
+Die Unterschiede sind im Kapitel zur xref:detailed_setup[Einrichtung unter Linux, Solaris, AIX und Windows] gekennzeichnet.
+Mit der xref:glossar#agent_bakery[Agentenbäckerei] der kommerziellen Editionen haben Sie die Möglichkeit, die Einrichtung für verschiedene Umgebungen xref:bakery[an einer Stelle] zu konfigurieren.
 
 
 [#first_steps]
 == Ersteinrichtung
 
 ifdef::onprem[]
 Die in diesem und den folgenden Kapiteln vorgestellten Konfigurationsdateien mit Beispielinhalten finden Sie auf dem {CMK}-Server -- entweder über die xref:files_cmk[Befehlszeile] oder über die {CMK}-Weboberfläche.
-In {RE} wählen Sie [.guihint]#Setup > Agents# und in den kommerziellen Editionen [.guihint]#Setup > Agents > Windows, Linux, Solaris, AIX  > Related.#
+In {RE} wählen Sie [.guihint]#Setup > Agents# und in den kommerziellen Editionen [.guihint]#Setup > Agents > Windows, Linux, Solaris, AIX  > Related#.
 In allen Editionen finden Sie dort Menüeinträge für die unterschiedlichen Betriebssysteme.
-Die Konfigurationsdateien finden Sie im Kasten [.guihint]#Example Configurations.#
+Die Konfigurationsdateien finden Sie im Kasten [.guihint]#Example Configurations#.
 endif::[]
 
 ifdef::saas[]
 Die in diesem und den folgenden Kapiteln vorgestellten Konfigurationsdateien mit Beispielinhalten finden Sie auf dem {CMK}-Server in der Weboberfläche.
-Wählen Sie [.guihint]#Setup > Agents > Windows, Linux, Solaris, AIX  > Related.#
+Wählen Sie [.guihint]#Setup > Agents > Windows, Linux, Solaris, AIX  > Related#.
 Dort finden Sie Menüeinträge für die unterschiedlichen Betriebssysteme.
-Die Konfigurationsdateien finden Sie im Kasten [.guihint]#Example Configurations.#
+Die Konfigurationsdateien finden Sie im Kasten [.guihint]#Example Configurations#.
 endif::[]
 
 
@@ -168,9 +168,8 @@ $DBUSER = @("checkmk","myPassword")
 --
 ====
 
-
 Der Standardbenutzer ist das Einzige, was das Agentenplugin zwingend benötigt.
-Alle anderen xref:#advanced[Einstellungen], die Sie unter Unix-artigen Systemen oder unter Windows verwenden können, sind optional.
+Alle anderen xref:advanced[Einstellungen], die Sie unter Unix-artigen Systemen oder unter Windows verwenden können, sind optional.
 
 
 [#oracle_wallet]
@@ -292,6 +291,7 @@ Anschließend sollten die Berechtigungen etwa wie folgt aussehen:
 
 Die Befehlsausgabe zeigt nur die Dateien und Verzeichnisse, um die es geht.
 
+
 [#detailed_setup]
 == Einrichtung für Linux, Solaris, AIX und Windows
 
@@ -351,7 +351,7 @@ Kopieren Sie die Datei `mk_oracle` vom {CMK}-Server aus dem Verzeichnis `~/share
 [.admonition-important]
 ****
 Das Agentenplugin für Unix-artige Systeme `mk_oracle` verträgt sich nicht gut mit `systemd` (siehe link:https://checkmk.com/de/werk/13732[Werk pass:[#]13732^]).
-Auf Systemen mit `systemd` müssen Sie das Agentenplugin daher xref:agent_linux#async_plugins[asynchron ausführen lassen.]
+Auf Systemen mit `systemd` müssen Sie das Agentenplugin daher xref:agent_linux#async_plugins[asynchron ausführen lassen].
 Das heißt, Sie installieren das Agentenplugin nicht unter `/usr/lib/check_mk_agent/plugins/` direkt, sondern in einem Unterordner `/usr/lib/check_mk_agent/plugins/<Zahl>/`.
 `<Zahl>` meint dabei das Ausführungsintervall in Sekunden.
 Wir empfehlen die minütliche Ausführung, also `/usr/lib/check_mk_agent/plugins/60/`.
@@ -375,7 +375,7 @@ Windows::
 --
 Die Agentenplugins für Windows werden bei der Installation des {CMK}-Agenten für Windows auf dem Host abgelegt.
 Kopieren Sie auf dem Oracle-Host die Datei `mk_oracle.ps1` aus dem Verzeichnis `C:\Program Files (x86)\checkmk\service\plugins\` in das oben beschriebene Plugin-Verzeichnis.
-Alternativ dazu können Sie in der Konfigurationsdatei des {CMK}-Agenten auf die Datei im Installationspfad xref:agent_windows#customizeexecution[verweisen.]
+Alternativ dazu können Sie in der Konfigurationsdatei des {CMK}-Agenten auf die Datei im Installationspfad xref:agent_windows#customizeexecution[verweisen].
 
 [.h4]#Besonderheiten#
 
@@ -409,10 +409,10 @@ Die Ausgabe aus dem Beispiel wurde zu Gunsten der Lesbarkeit komplett weggelasse
 PS C:\ProgramData\checkmk\agent\> Unblock-File -Path .\plugins\mk_oracle.ps1
 PS C:\ProgramData\checkmk\agent\> Unblock-File -Path .\config\mk_oracle_cfg.ps1
 ----
-
 --
 ====
 
+
 [#advanced]
 === Erweiterte Optionen
 
@@ -421,6 +421,7 @@ Je nach Anwendungsszenario werden Sie aber schnell weitere Möglichkeiten benöt
 Diese Optionen finden Sie in den nachfolgenden Abschnitten.
 Einige der Optionen stehen Ihnen nur in Unix-artigen Umgebungen zur Verfügung.
 
+
 [#advanced_user]
 ==== Erweiterte Benutzerkonfiguration
 
@@ -471,7 +472,6 @@ Diese werden immer gegenüber dem Standard bevorzugt.
 * Wird ein optionales Feld mittendrin ausgelassen, muss der Doppelpunkt geschrieben werden, wie beim Eintrag `DBUSER_MYINST2`, bei dem keine Rolle und kein Port angegeben wurde.
 * Werden ab einem bestimmten Punkt keine optionalen Felder mehr gebraucht, können Sie die Doppelpunkte weglassen, wie beim Eintrag `ASMUSER`, bei dem weder Host, Port noch TNS-Alias angegeben wurde.
 
-
 --
 Windows::
 +
@@ -504,6 +504,7 @@ Die Reihenfolge der Einträge ist nicht beliebig und darf daher nicht vertauscht
 --
 ====
 
+
 [#skip_include]
 ==== Instanzen ein- oder ausschließen
 
@@ -516,6 +517,7 @@ Um die Konfiguration im Einzelfall möglichst einfach zu machen, haben Sie versc
 Linux, Solaris, AIX::
 +
 --
+
 [cols="25,~",options="header"]
 |===
 |Parameter |Beschreibung
@@ -554,10 +556,12 @@ Da die positive Liste aus der ersten Zeile immer bevorzugt wird, wird die zweite
 Lediglich die vierte (letzte) Zeile wird zu einem späteren Zeitpunkt berücksichtigt, da hier die Instanz nur teilweise ausgewertet werden soll.
 
 In der Praxis ist es also sinnvoll, nur _eine_ der Variablen zu nutzen, um die Menge der zu überwachenden Instanzen zu bestimmen.
+
 --
 Windows::
 +
 --
+
 [cols="25,~",options="header"]
 |===
 |Parameter |Beschreibung
@@ -590,6 +594,7 @@ Beachten Sie, dass es sich bei `ONLY_SIDS` um eine Liste handelt, bei `EXCLUDE_I
 --
 ====
 
+
 [#sections]
 ==== Zu holende Daten bestimmen
 
@@ -624,6 +629,7 @@ Eine Konfiguration könnte dann zum Beispiel so aussehen:
 Linux, Solaris, AIX::
 +
 --
+
 ./etc/check_mk/mk_oracle.cfg
 [{file}]
 ----
@@ -687,12 +693,14 @@ Wollen Sie zum Beispiel nur `locks` aus der synchronen Abfrage herausnehmen, geb
 Linux, Solaris, AIX::
 +
 --
+
 ./etc/check_mk/mk_oracle.cfg
 [{file}]
 ----
 # Just exclude 'locks' from sync sections:
 SYNC_SECTIONS='instance sessions logswitches undostat recovery_area processes recovery_status longactivesessions dataguard_stats performance'
 ----
+
 --
 Windows::
 +
@@ -708,6 +716,7 @@ $SYNC_SECTIONS = @("instance", "sessions", "logswitches", "undostat", "recovery_
 
 Gleiches gilt auch für die anderen drei Variablen, in denen die Sektionen bestimmt werden.
 
+
 [#tns_config]
 ==== TNS-Alias und TNS_ADMIN konfigurieren (nur Linux, Solaris, AIX)
 
@@ -729,6 +738,7 @@ export TNS_ADMIN=/opt/oracle/product/19c/dbhome_1/network/admin/
 
 Nur falls die Variable gar nicht gesetzt ist, wird sie vom Agentenplugin auf `/etc/check_mk/` gesetzt.
 
+
 [#access]
 ==== Zugriffsrechte bei der Ausführung
 
@@ -813,10 +823,10 @@ plugins:
 
 {cee-only}
 In den kommerziellen Editionen können Sie sich diese Einträge mit der Agentenregel [.guihint]#Run plug-ins and local checks using non-system account# von der Agentenbäckerei erstellen lassen.
-
 --
 ====
 
+
 [#remote_instances]
 === Entfernte Datenbanken überwachen (nur Linux, Solaris, AIX)
 
@@ -902,7 +912,7 @@ Trotzdem können Sie nicht alle Funktionen des Agentenplugins über die Agentenb
 zum Beispiel wenn es Funktionen sind, welche einen größeren Eingriff benötigen und ein fundiertes Fachwissen voraussetzen.
 Entsprechend sind die xref:custom_sqls[benutzerdefinierten SQL-Abfragen] nicht in der Agentenbäckerei konfigurierbar.
 
-Über [.guihint]#Setup > Agents > Windows, Linux, Solaris, AIX# und das Menü [.guihint]#Agents > Agent rules# finden Sie die Seite mit dem xref:glossar#rule_set[Regelsatz] [.guihint]#Oracle databases (Linux, Solaris, AIX, Windows).# 
+Über [.guihint]#Setup > Agents > Windows, Linux, Solaris, AIX# und das Menü [.guihint]#Agents > Agent rules# finden Sie die Seite mit dem xref:glossar#rule_set[Regelsatz] [.guihint]#Oracle databases (Linux, Solaris, AIX, Windows)#.
 Erstellen Sie mit [.guihint]#Add rule# eine neue Regel.
 Hier finden Sie alle Optionen, die Ihnen für die Konfiguration des Agentenplugins zur Verfügung stehen:
 
@@ -925,7 +935,7 @@ Die Optionen, die in der xref:advanced_user[Konfigurationsdatei] mit Doppelpunkt
 finden Sie unter [.guihint]#Login Defaults# als einzelne Optionen, die Sie dann entsprechend ausfüllen.
 Natürlich können Sie auch hier das xref:oracle_wallet[Oracle Wallet] nutzen, indem Sie bei [.guihint]#Authentication method# einfach auf [.guihint]#Use manually created Oracle password wallet# wechseln.
 
-Die Konfiguration für ein Automatic Storage Management (ASM) erledigen Sie analog über die Option [.guihint]#Login for ASM,#
+Die Konfiguration für ein Automatic Storage Management (ASM) erledigen Sie analog über die Option [.guihint]#Login for ASM#,
 und die Ausnahmen für spezifische Instanzen tragen Sie bei [.guihint]#Login for selected databases# ein, so wie es bei der xref:advanced_user[erweiterten Benutzerkonfiguration] beschrieben ist.
 
 
@@ -939,7 +949,7 @@ In der folgenden Tabelle finden Sie die restlichen Optionen des Regelsatzes [.gu
 |Option |Beschreibung
 |[.guihint]#Host uses xinetd or systemd (Linux/AIX/Solaris only)# |Diese Option muss für Unix-artige Systeme mit `xinetd`/`systemd` aktiviert werden.
 Bei `systemd` ist die asynchrone Ausführung des Agentenplugins obligatorisch -- im von Ihnen festgelegten Intervall.
-Mehr dazu finden Sie bei der xref:install_plugin[Installation des Agentenplugins.]
+Mehr dazu finden Sie bei der xref:install_plugin[Installation des Agentenplugins].
 |[.guihint]#Instances to monitor# |Diese Option fasst mehrere Optionen der Konfigurationsdatei zusammen, mit denen Sie Instanzen für Linux, Solaris, AIX oder Windows xref:skip_include[ein- oder ausschließen] können.
 |[.guihint]#Add pre or postfix to TNSALIASes (Linux/AIX/Solaris only)# |Mit dieser Option können Sie den xref:tns_config[TNS-Alias] entweder global oder für eine spezifische Instanz erweitern.
 |[.guihint]#Sections - data to collect# |Alle verfügbaren Sektionen sind unter dieser Option gelistet und können individuell auf globaler Ebene konfiguriert werden.
@@ -1070,7 +1080,7 @@ Unter Windows steht diese Option nicht zur Verfügung.
 
 ==== SQL-Abfragen schreiben
 
-Die einfachste Weise so ein SQL anzubinden, ist die Nutzung des Check-Plugins link:https://checkmk.com/de/integrations/oracle_sql[Oracle Database: Custom SQLs.^]
+Die einfachste Weise so ein SQL anzubinden, ist die Nutzung des Check-Plugins link:https://checkmk.com/de/integrations/oracle_sql[Oracle Database: Custom SQLs^].
 Erstellen Sie dafür zunächst die Datei `MyCustomSQL.sql` in dem Konfigurationsverzeichnis des Agenten auf dem Hosts, auf dem das SQL ausgeführt werden soll.
 
 Nachfolgend ein Dummy, welcher die Syntax veranschaulicht:
@@ -1096,7 +1106,7 @@ prompt exit:2;
 ----
 
 Das Beispiel zeigt zum einen, dass Sie in einer solchen Datei beliebig viele Anweisungen definieren können.
-Zum anderen ist die Syntax dem eines xref:glossar#local_check[lokalen Checks] sehr ähnlich, vor allem mit Blick auf die xref:glossar#metric[Metriken.]
+Zum anderen ist die Syntax dem eines xref:glossar#local_check[lokalen Checks] sehr ähnlich, vor allem mit Blick auf die xref:glossar#metric[Metriken].
 Im Detail ist diese Syntax hier wesentlich mächtiger, da Sie mehrzeilige Ausgaben erzeugen können und diese dann auf dem {CMK}-Server als ein Service verarbeitet werden.
 Prinzipiell sind alle Zeilen optional und müssen nicht befüllt werden.
 
@@ -1203,6 +1213,7 @@ Sie kann nicht zusammen mit der Variable `SQLS_SECTION_NAME` benutzt werden. |Ja
 |`SQLS_TNSALIAS` |Bestimmt einen individuellen xref:tns_config[TNS-Alias] für eine Sektion. |Ja
 |===
 
+
 ifdef::onprem[]
 [#own_check_plug-in]
 === Eigene Check-Plugins nutzen
@@ -1304,7 +1315,6 @@ PS C:\ProgramData\checkmk\agent\plugins\> .\mk_oracle.ps1
 2020-08-23T12:48:20.3930944+02:00 DEBUG:value of sql_connect in dbuser = checkmk/myPassword@(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=localhost)(PORT=1521))(CONNECT_DATA=(SID=XE))) as sysdba
 <<<oracle_instance>>>
 XE|FAILURE|...
-
 ----
 --
 ====
@@ -1350,6 +1360,7 @@ Ist die Verbindung selbst stabil, können Sie in der Konfigurationsdatei die ech
 
 Mit Hilfe der erzeugten Log-Meldungen können Sie sehr genau identifizieren, an welcher Zeile des Skripts das Problem auftritt.
 
+
 [#debugging]
 === Debugging
 
@@ -1381,7 +1392,6 @@ Hier der Aufruf von `mk_oracle` für das Debugging auf einem Linux-Server mit `x
 In dieser Ausgabe werden keine sensiblen Daten wie Passwörter maskiert.
 Es ist also alles in Klartext lesbar.
 ****
-// ES: gilt das nur für Linux, oder für beide Szenarien? In dem Fall würde ich die Admonition natürlich aus der Tab-Box rausziehen.
 --
 Windows::
 +
@@ -1396,6 +1406,7 @@ PS C:\ProgramData\checkmk\agent\plugins\> .\mk_oracle.ps1
 --
 ====
 
+
 [#ora-01031]
 === Fehlermeldungen in Oracle Log-Dateien
 
@@ -1408,7 +1419,6 @@ Dies kann dann z.B. zu Oracle-Fehlermeldungen der Art `ORA-01031: insufficient p
 == Dateien und Verzeichnisse
 
 === Auf dem Oracle-Host
-// TK: Zu klären: Tab-Gruppe oder 3-spaltige Tabelle?
 
 [.tabs]
 ====
@@ -1441,7 +1451,6 @@ Windows::
 |`C:\ProgramData\checkmk\agent\config\tnsnames.ora` |Die Konfigurationsdatei, welche TNS-Alias enthält.
 Beispieldateien liegen auch in der Oracle-Installation, aber da sich der Pfad je nach Installation unterscheidet, kann er nicht pauschal angegeben werden.
 |===
-
 --
 ====