Systemstart- und Systemstoppverfahren überwachen

Objectives

After completing this lesson, you will be able to:
  • Speicherorte von Trace- und Protokolldateien suchen
  • Wichtige Trace- und Protokolldateien zur Fehlerbehebung benennen

Log- und Tracedateien

Bei einem Fehler oder unerwartetem Verhalten des Java Startup and Control Frameworks ist es wichtig, das Arbeitsverzeichnis der AS Java Instanzen (PAS/AAS) unter folgendem Pfad zu prüfen: /usr/sap/<SID>/J<Instanznummer.>/work.

Als eine Art Best Practice können Sie die Dateien absteigend nach Datum und Zeitstempel sortieren und den Inhalt der aktuellsten Protokoll- und Trace-Dateien auf Fehler und Warnungen prüfen. Dieselbe Strategie sollte auch bei Problemen mit der Central-Services-Instanz (SCS) berücksichtigt werden. Denken Sie immer daran, dass es viele potenzielle Probleme und Fehlersituationen gibt. Es gibt also eine Vielzahl von Grundursachen. Protokoll- und Trace-Dateien helfen dem Administrator bei der Analyse der Situation, indem sie auf ein Hardware- (mangelhaftes oder fehlerhaftes) oder softwarebasiertes Problem (fehlende oder falsche Version) verweisen und fehlerhafte Parametrisierung identifizieren. Im Folgenden sind einige der wichtigsten Protokoll- und Trace-Dateien aufgeführt.

Wichtige Log- und Tracedateien:

  • dev_jstart

  • dev_<Knotenname> (z.B. dev_server0, dev_icm)

  • jvm_<Knotenname>.out (z.B. jvm_bootstrap.out)

  • std_server<Nr.>.out (z.B. std_server1.out)

  • log_bootstrap<Nr.>.log

  • stderr<Nr.> (z.B. stderr1)

  • sapstart.log, sapstart<Nr.>.trc, sapstartsrv.log

  • available.log

Notiz

Achten Sie auch auf die Instanz von SAP Central Services (SCS). Verwenden Sie den folgenden Pfad, um auf das Arbeitsverzeichnis zuzugreifen: /usr/sap/<SID>/SCS<Instanznummer/work

Die Trace- und Logdateien werden im work Verzeichnis einer Instanz abgelegt. Dieses Verzeichnis heißt /usr/sap/<SID>/J<instance_number>/work (UNIX) und im Windows-Umfeld analog.

dev_jstart ist die Trace-Datei für den Instanz-Controller. Es ist die wichtigste Trace-Datei für Problemmeldungen beim Starten des AS Java. Aktuelle Meldungen werden ans Ende der Datei geschrieben.

dev_<Knotenname> ist die Trace-Datei für die Server-Prozesse, den ICM und weitere Prozesse. Die Trace-Datei dev_<Knotenname> wird für jeden gestarteten Prozess und damit für jeden ICM- und Serverprozess geschrieben.

jvm_<Knotenname>.out ist die Ausgabedatei für die Java Virtual Machine (JVM). Jeder Knoten (außer ICM) stellt einen Java-Knoten dar, z.B. einen Bootstrap oder einen Serverprozess und damit eine JVM. Die Ausgabe einer JVM wird an die Datei jvm_<Knotenname>.out im Arbeitsverzeichnis einer Java-Instanz weitergeleitet.

std_server<X>.out ist die Standardausgabedatei für die gestarteten Manager und Services der entsprechenden Knoten, eine der am häufigsten verwendeten Dateien zur Fehlerbehebung beim Start des Frameworks eines Serverprozesses.

log_bootstrap<Nummer>.log ist die Protokolldatei für die Synchronisation von Binärdaten in der Java-Datenbank mit dem lokalen Dateisystem, das Lesen der Java-Instanzbeschreibung aus der Java-Datenbank und das Aktualisieren der Datei instance.properties.

stderr<number> werden vom Prozess sapstartsrv beim Start der Instanz erzeugt. Die Instanzprozesse, die vom sapstartsrv gestartet werden, schreiben in die einzelnen STDERR<n>-Dateien, abhängig von der Reihenfolge, in der sie im Instanzprofil aufgeführt sind.

available.log zeigt die Instanzverfügbarkeit an.

Für die meisten der oben aufgeführten Protokolldateien finden Sie auch Protokolldateien im Arbeitsverzeichnis mit der Endung.<Nr.>, mit älteren Versionen der Dateien, die auch häufig zur Fehlerbehebung verwendet werden können. Im Startprozess einer Instanz werden die oben genannten Dateien neu geschrieben und die Dateinamen von x geändert.<Nr.> bis x.<Nr.+1>. Die Anzahl der alten Versionen richtet sich nach dem Parameter jstartup/keep_old_logfiles (default = 2).

Neben den Knotennamen für ICM- und Serverprozesse gibt es auch Entwickler-Traces für Datensammlungen (datcol). Bei Startproblemen liefert der Datenkollektor Informationen über das Problem und schreibt in die Entwickler-Traces.

This is only available in english

Die Entwickler-Traces aus dem Arbeitsverzeichnis können auch einfach mit der SAP MC (oder SAP MMC) ausgewertet werden. Siehe Abbildung oben. Die Analyse zeigt die Fehlermeldungen aus den dev_<...>-Dateien an (sowie weitere Meldungen aus den Protokoll- und Trace-Dateien, die Sie in der Einheit Monitoring kennenlernen). Eventuell werden auch Warnungen oder andere Meldungen aus den dev_<...>-Dateien angezeigt.

Optional: Protokolle der Start- und Stoppprozesse eines AS-Java-basierten SAP-Systems

Unternehmensszenario

Der Startvorgang eines SAP-Systems ist eine kritische Aktion. Wenn Probleme auftreten, muss der Administrator mit den wichtigsten Protokoll- und Trace-Dateien vertraut sein, die während des Startvorgangs geschrieben wurden. Die Fehleranalyse ist in hohem Maße auf das Expertenwissen des Verwaltungspersonals angewiesen. Um die Grundursache des Problems zu ermitteln, besteht einer der ersten Schritte darin, den für das Problem verantwortlichen Bereich (BS, Datenbank, JVM, Parameter usw.) einzuschränken. Wenn das Problem bis zu diesem Zeitpunkt nicht behoben werden konnte, ist ein weiterer Untersuchungsschritt erforderlich, und Sie können Fehlercodes filtern, die in Protokoll- und Trace-Dateien gefunden wurden, um Details zur Fehlersituation zu erhalten. Diese Textextrakte, Meldungen, Rückgabewerte (usw.) können als Suchbegriffe verwendet werden, wobei verschiedene von SAP bereitgestellte Quellen (z. Hinweissuche über das Support Launchpad oder Wiki-Seiten).

Gültig für diese Übung

ParameterWert
SAP ClassroomWTS
SAP System IDSMJ
Hostname (FQDN)smhost.wdf.sap.corp
BetriebssystemWindows
Betriebssystembenutzer/Kennwort für Q-Gruppesmaadm / <Kennwort>
Betriebssystembenutzer/Kennwort für P-Groupsmjadm / <Kennwort>
Central-Services-InstanzSCS90
Primary Application Server (PAS)J91
SAP Management ConsoleSAP MC

Notiz

In dieser Übung erwarten wir nicht viele Fehler. Ziel dieser praktischen Arbeit ist es, mit den potenziellen Speicherorten und Dateinamen auf Betriebssystemebene vertraut zu sein und zu wissen, wie die Analyse in der Regel erfolgen soll (z.B. Sortierung nach Zeitstempel).

Notiz

Die Anmeldung auf Betriebssystemebene ist zu Fehlerbehebungszwecken nicht obligatorisch. Nicht jeder Administrator hat die Berechtigung und erhält die Credentials eines BS-Admin-Benutzers. Die SAP MC ist ein sehr guter Ausgangspunkt für die Analyse, wenn die Mindestvoraussetzungen gegeben sind (z.B. werden sapstartsrv-Services ausgeführt).

Aufgabe 1: Optional: Protokoll- und Trace-Dateien der Start- und Stoppprozedur

Prüfen Sie die neuesten Protokoll- und Trace-Dateien, die beim Starten eines Java-basierten SAP-Systems geschrieben werden. Verschaffen Sie sich einen Überblick über den Inhalt des Arbeitsverzeichnisses, und prüfen Sie einige wichtige Protokoll- und Trace-Dateien.

Notiz

Es gibt einige Unterschiede unter UNIX/Linux im Vergleich zu Windows-Betriebssystemen, und einige Klassen können auf einer anderen Betriebssystemplattform ausgeführt werden. In dieser Klasse läuft das Java-basierte SAP-System auf einer Windows-Plattform.

Schritte

  1. Nur Windows: Falls noch nicht geschehen (siehe vorherige Übungen), melden Sie sich am Server smhost.wdf.sap.corp Ihres Schulungssystems mit Remote Desktop Connection unter Verwendung des Betriebssystembenutzers smjadm mit dem Kennwort <Kennwort> an.

    Hinweis: Wenn Sie noch über RDP mit der Betriebssystemebene verbunden sind (siehe vorherige Übung), fahren Sie mit dem nächsten relevanten Schritt fort.

    1. Wählen Sie auf Ihrem WTS die Windows-Starttaste in der unteren linken Ecke.

    2. Blättern Sie im Kachelbereich nach unten, und wählen Sie die Kachel Remote Desktop...

    3. Geben Sie im Dialogfenster Remote Desktop Connection im Feld Computer den Wert smhost.wdf.sap.corp ein.

    4. Geben Sie im nächsten Dialogfeld Windows-Sicherheit - Geben Sie Ihre Anmeldeinformationen ein, und geben Sie den folgenden Benutzer und das folgende Kennwort für die Authentifizierung ein.

      • Q- Gruppe: smaadm / <Kennwort>
      • P- Gruppe: smjadm / <Kennwort>
    5. Bestätigen Sie den nächsten sicherheitsbezogenen Dialog Remote Desktop Connection mit dem Text Die Identität des Remote-Computers kann nicht verifiziert werden. Möchten Sie trotzdem eine Verbindung herstellen? mit Ja.

  2. Nur Windows: Listen Sie die zuletzt geschriebenen Protokoll- und Trace-Dateien der primären Application-Server-Instanz (PAS-Instanz) auf.

    1. Voraussetzung: Sie sind über Remote Desktop Connection mit der Windows-Betriebssystemebene verbunden (siehe vorheriger Schritt). Wenn sie noch offen ist, finden Sie die Anwendung in der Windows-Taskleiste des WTS. Wenn Sie es auswählen, zeigt RDP oben einen tiefen blauen Balken mit dem Namen des Windows-Servers an, z.B. smhost oder ein anderer Windows-Hostname, der in der Schulungsklasse verwendet wird.

    2. Doppelklicken Sie auf das gelbe Ordnersymbol in der Windows-Taskleiste der Remote Desktop Connection.

    3. Wählen Sie links im Navigationsbereich des Datei-Explorers Laufwerk (D:), und navigieren Sie im Content-Bereich auf der rechten Seite zum folgenden Verzeichnis, indem Sie auf die Ordner doppelklicken: usrsap<SID>(z. SMJ)J<Instanzname><Instanznummer>(z.B. J91)arbeiten (z. D:\usr\sap\SMJ\J91\work).

    4. Klicken Sie im Inhaltsbereich auf der rechten Seite des Fensters auf die Spalte Änderungsdatum, um die Elemente absteigend zu sortieren.

      Hinweis

      Um den Datei-Explorer auf Vollbild zu setzen, verwenden Sie das Symbol Maximieren in der oberen rechten Ecke.

      Notiz

      In einem Fehlerbehebungsszenario sind in der Regel die aktuellsten Informationen, die in Dateien geschrieben wurden, für die Analyse relevant. Daher wird das Arbeitsverzeichnis absteigend nach Datum/Uhrzeit sortiert, und die Liste gibt einen ersten Überblick darüber, welche Services und Prozesse zuletzt in dieses Verzeichnis geschrieben wurden.
    5. Öffnen Sie einige Dateien im Datei-Explorer, der das Arbeitsverzeichnis in absteigender Reihenfolge wie folgt anzeigt: Doppelklicken Sie auf einige Dateien (Beispiele finden Sie in der Liste unten). Durch das Öffnen von Dateien mit dieser Aktion wird ein Popup-Fenster Wie möchten Sie diese Datei öffnen? fordert zur Auswahl eines Werkzeugs auf. Wählen Sie Notepad oder WordPad, und wählen Sie OK.

      Hinweis

      Um die aktuellsten Informationen in den mit Notepad oder WordPad geöffneten Dateien anzuzeigen, wählen Sie die Tastenkombination STRG+ENDE auf Ihrer Tastatur, oder blättern Sie nach unten bis zum Ende des Dateiinhalts.

      • dev_<Knotenname> (z.B. dev_server0)

      • std_<Knotenname><Nr.>.out (z.B. std_server1.out)

      • jvm_<Knotenname>.out (z.B. jvm_server0.out)

      • sapstart.log oder dev_sapstart

      Hinweis: Der Begriff Knoten entspricht einem Prozess im AS Java

  3. Nur Windows:

    Sehen Sie sich die sehr wichtigen Protokoll- und Trace-Dateien der Central-Services-Instanz an.

    • Voraussetzungen für diesen Schritt:
    • 1. Verbindung zur Windows-Betriebssystemebene (WTS) über Remote Desktop Connection (siehe vorheriger Schritt).
    • 2. Öffnen Sie den Datei-Explorer im Arbeitsverzeichnis einer Anwendungsserverinstanz (PAS oder AAS) über den Pfad D:\usr\sap\<SID>\<Instanzname><Instanznummer.>\work(siehe vorheriger Schritt).
    • dev_ms (Message-Server-Protokolldatei)

    • dev_enqlisten (Enqueue-Listener-Protokolldatei)

    • enquelog (Enqueue-Operationen und Konflikterkennung)

    • dev_rd (Gateway-Service-Protokolldatei)

    • stderr<Nr.> (Beginn einzelner Services - bei geschriebenem Status wie Info/Warnung/Fehler)

    Hinweis: Diese Liste erhebt keinen Anspruch auf Vollständigkeit!

    1. Verwenden Sie in Remote Desktop Connection den Datei-Explorer, um den Inhalt eines PAS/AAS-Arbeitsverzeichnisses anzuzeigen (D:\usr\sap\<SID>\<Instanzname><Instanz-Nr.>\work.

    2. Öffnen Sie die relevanten Dateien (siehe Liste oben), z.B. mit Notepad (siehe vorherigen Schritt zum Fortfahren), und blättern Sie zum Ende. Prüfen sie die Einträge seit dem letzten Start des Systems.