Standalone-Enqueue-Server überwachen 
Sie können den Enqueue-Server und den Enqueue-Replikationsserver mit dem Kommandozeilenprogramm ensmon (ensmon.exe unter Windows) überwachen.
Voraussetzungen
Der Standalone-Enqueue-Server läuft. Im folgenden bezeichnet <profile> die Profildatei, mit der einer der Applikationsserver gestartet wurde. Diese enthält die Informationen, die das Überwachungsprogramm benötigt.
Weitere Informationen: Standalone-Enqueue-Server installieren
Vorgehensweise
Der ensmon-Prozess verbindet sich über das Netzwerk mit dem Enqueue-Server. Sie müssen den Namen des Rechners, auf dem der Enqueue-Server läuft, entweder durch Angabe der Profildatei pf=<profile> oder mit der Aufrufoption -H <hostname> angeben. Mit dem Parameter -I <serverinstance> geben Sie an, welche Instanznummer der Enqueue Server hat. Sollte ensmon auf einem Rechner gestartet werden, auf dem nicht die SAP Standardservices sapdpXX (XX=Instanznummer) konfiguriert sind, können Sie über die Option -S <serverport> auch den Port direkt angeben (Standard: 32XX).
Rufen Sie ensmon ohne Parameter auf, wird eine kurze Hilfe zur Benutzung angezeigt:
standalone enqueue server monitor
=================================
usage: ensmon [--help|-help|-h] [pf=<profile>]
[-H <hostname> [-I <serverinstance>|-S
<serverservicename/serverport>]]
[<opcode>] [<parameters (depending on opcode)>]
Befehlscodes
Das Verhalten des Programms ensmon wird über numerische Befehlscodes (opcodes) gesteuert. Sie erhalten eine Übersicht über diese Befehlscodes, wenn Sie ensmon -help eingeben.
Für die meisten Befehlscodes gibt es weitere Parameter. Die wichtigsten Befehlscodes sind 2 und 3. Mit dem Befehlscode 3 holen Sie eine Datei vom Enqueue Server und speichern sie auf der lokalen Festplatte.
Monitoring
Mit dem Befehlscode 2 ermitteln Sie den Zustand des Enqueue-Servers und der Replikation. Das kann insbesondere auch von der HA-Software benutzt werden, um den Enqueue-Server und den Replikationsserver zu überwachen. Dieser Befehlscode hat folgende Returncodes, die direkt ausgewertet werden können.
0: alles in Ordnung: der Enqueue-Server läuft, die Replikation ist aktiv (falls sie konfiguriert wurde)
4: Warnung: der Enqueue-Server läuft, die Replikation ist per Parameter konfiguriert aber nicht aktiv (evtl. wegen eines Fehlers).
8: Fehler: ensmon kann keinen Kontakt mit dem Enqueue-Server aufnehmen. Die Ursache kann ein Netzwerkproblem, aber auch ein Problem des Enqueue-Servers sein.
Außerdem gibt ensmon mit diesem Befehlscode den Status der Replikation im Klartext aus (vgl. Funktionsweise der Replikation), den der Enqueue-Server intern hält.
Je nach dem aktuellen Wert des Replikationszustandes liefert ensmon einen anderen Returncode, der von der HA-Software leicht ausgewertet werden kann.
Folgende Status sind möglich.
Statusmeldung |
Bedeutung |
Rückgabewert |
|---|---|---|
Replication is disabled in server! |
Der Replikationsmechanismus ist abgeschaltet: der Profilparameter enque/server/replication hat den Wert false. Weitere Informationen: Profilparametereinstellungen beim Einsatz des Standalone-Enqueue |
0 |
Replication is enabled in server, but no repl. server is connected |
Der Replikationsmechanismus ist eingeschaltet (enque/server/replication = true), aber es ist kein Replikationsserver mit dem Enqueue-Server verbunden. |
4 |
Replication is enabled in server, repl. server is connected. Still needs a copy of the repl. table |
Der Replikationsserver hat die Verbindung zum Enqueue Server aufgebaut, muss aber noch die Übermittlung des Zustandes (state transfer) anfordern. |
4 |
Replication is enabled in server, repl. server is connected. The state transfer is currently getting prepared |
Der Replikationsserver hat die Übermittlung des Zustandes angefordert, der Enqueue-Server muss diesen aber noch zusammen stellen. |
4 |
Replication is enabled in server, repl. server is connected. The state transfer is currently getting collected |
Der Enqueue-Server hat begonnen, die Daten für die Übermittlung des Zustandes zu sammeln. In diesem Moment kann der Enqueue-Server keine Enqueue-Requests bearbeiten (kann aber aufgrund der Multithreaded Architektur weitere Requests annehmen und in einer internen Queue sammeln). |
4 |
Replication is enabled in server, repl. server is connected. State transfer is sent, but still waiting for confirmation |
Der Enqueue-Server hat dem Replikationsserver den Zustand der Sperrtabelle übermittelt, wartet aber noch auf die Bestätigung, dass er erfolgreich angekommen ist. Ab diesem Zustand werden die Änderungen an der Sperrtabelle durch weitere Enqueue-Requests bereits an den Replikationsserver gesendet. |
4 |
Replication is enabled in server, repl. server is connected, Replication is active |
Die Replikation arbeitet normal |
0 |
Replication is enabled in server, repl. server is connected, Shutdown command was sent to replication server |
Der Replikationsserver wurde vom Enqueue-Server aus beendet. Weitere Informationen: . Funktionsweise der Replikation |
4 |
Replication is enabled in server, repl. server is connected but the replication was suspended due to errors during state transfer |
Die Replikation ist im Zustand "suspended". Weitere Informationen: . Funktionsweise der Replikation |
4 |
Achtung
Der Rückgabewert (Returncode) ist nicht in der Ausgabe von ensmon zu sehen. Der Wert ist (unter UNIX) in der Shell-Variable $? gespeichert, kann also mit echo $? ausgegeben werden.
Hinweis
Sie können ensmon automatisiert oder interaktiv benutzen. Bei der automatisierten Verwendung geben Sie beim Aufruf alle Optionen und den Befehlscode an und verwenden die Ausgabe wie gewünscht. Bei der interaktiven Verwendung lassen Sie den Befehlscode weg und geben ihn dann interaktiv ein. Dies ist im folgenden Beispiel dargestellt.
Beispiel
Geben Sie ensmon pf=<profile> ein, so erhalten Sie z.B. die Ausgabe:
Try to connect to host binmain service sapdp54 Enqueue Server monitor main menu ================================ 1: Dummy request 2: Get replication information 3: Get a file from the enqueue server q: quit h: help ==> |
Geben Sie nun den Befehlscode 2 ein, so bekommen Sie:
get replinfo request executed successfully Replication is enabled in server, but no repl. server is connected ============================================================ Information from the enqueue server side: ========================================= . . . . . |