test

Sun Java Enterprise System 5 Installationshandbuch für Microsoft Windows

Kapitel 8 Problembehebung

Dieses Kapitel enthält Vorschläge zur Behebung von Problemen, die bei der Installation und Deinstallation von JavaTM Enterprise System (Java ES) auftreten.

Dieses Kapitel enthält die folgenden Abschnitte:

Allgemeine Methoden zur Problembehebung

Dieser Abschnitt enthält allgemeine Richtlinien zum Auffinden von Problemursachen. Folgende Themen werden behandelt:

Netzwerkkonnektivität

Java ES-Installationen werden auf eigenständigen (nicht an ein Netzwerk angebundenen) Hosts nicht unterstützt. Damit Java ES installiert werden kann, muss der betreffende Host mit einem Netzwerk verbunden sein.

Überprüfen der Directory Server-Konnektivität

Wenn Sie eine Komponente installieren, die von Directory Server abhängig ist, kann es in folgenden Situationen zu Problemen kommen:

Im Modus “Manuell nach der Installation konfigurieren” müssen Sie sich vergewissern, dass Directory Server läuft, bevor Sie von Directory Server abhängige Produkte konfigurieren.

Überprüfen der Konfiguration nach der Installation

Wenn beim Starten von Komponenten Probleme auftreten, sollten Sie überprüfen, ob die in Kapitel 5, Durchführen der nach der Installation vorgesehenen Konfiguration beschriebenen Verfahren ordnungsgemäß befolgt wurden.

Überprüfen von Ressourcen und Einstellungen

Die nachfolgend aufgeführten Aspekte auf Hostebene können zu Installationsproblemen führen.

Vor Installationsbeginn sollten Sie auch unter Systemanforderungen nachlesen, um zu überprüfen, dass alle Systemvoraussetzungen erfüllt sind.

Überprüfen der Distributionsdatenträger

Bei einer Installation von DVD sollten Sie prüfen, ob der Datenträger verschmutzt oder beschädigt ist. Verschmutzte Datenträger können zu Installationsproblemen führen.

Überprüfen der Protokolldateien der Komponente

Falls beim Start einer Komponente ein Problem auftritt, sollten Sie deren Protokolldatei überprüfen. Viele Komponenten-Protokolldateien sind unter Informationen zur Problembehebung bei Komponenten aufgeführt.

Überprüfen der Installationsprotokolldateien

Falls während der Installation bzw. Deinstallation ein Problem auftritt, sollten Sie die Protokolldatei %TEMP%/SunJavaES.log überprüfen.

%TEMP% ist das benutzerdefinierte temporäre Verzeichnis des betreffenden Systems.

Durch Überprüfen der Protokolldateien für die Deinstallation bzw. Installation (zusammen mit dem Java ES-Konfigurationsprotokoll) kann die Ursache von Problemen oft herausgefunden werden.

ProcedureSo überprüfen Sie die Installationsprotokolldateien

  1. Überprüfen Sie die Datei mit der Installationszusammenfassung, die eine anspruchsvolle Beschreibung der Installations- und Konfigurationsschritte enthält. Diese Datei ist JavaEs-Installationsverz\Summary.txt. Bei Auftreten eines Problems sollten Sie ermitteln, welche Komponente es verursacht hat. Wenn mehrere Probleme aufgetreten sind, sollten Sie zunächst das erste Problem eingrenzen.

  2. Überprüfen Sie die detaillierten Protokolldateien.

    1. Suchen Sie den ersten Fehler bzw. die erste Warnung, die ausgegeben wurde, und versuchen Sie, den Fehler zu beheben. In einigen Fällen werden durch die Behebung eines Fehlers eine Reihe anderer Fehler behoben, zwischen denen kein Zusammenhang zu bestehen scheint.

    2. Suchen Sie den Namen der Komponente, die das Problem verursacht hat.

    3. Überprüfen Sie das Konfigurationsprotokoll. Die Konfigurationsprotokolldateien befinden sich in den Installationsverzeichnissen der jeweiligen Komponenten. Genaue Informationen darüber, wo sich die Komponentenprotokolldateien befinden, entnehmen Sie bitte der Datei Summary.txt.

    4. Überprüfen Sie die Installationsprotokolldatei auf Probleme, die bei der Installation bzw. Deinstallation aufgetreten sind. Probleme auf Konfigurationsebene sind in den Konfigurationsprotokollen aufgeführt.

Entfernen von Dateien und Verzeichnissen

Um ein Überschreiben benutzerspezifisch angepasster Dateien wie z. B. geänderter Konfigurationsdateien zu verhindern, sollten Java ES 5-Komponents nicht in den vorherigen Installationsverzeichnissen, die solche Dateien enthalten, installiert werden.

Bei einer Neuinstallation von Java ES 5 sollten Sie sich vergewissern, dass die entsprechenden Verzeichnisse leer sind. Wenn dies nicht der Fall ist, sollten Sie die darin enthaltenen Dateien archivieren und die Installation nochmals durchführen.

Überprüfen von Passwörtern

Im Installationsprogramm ist es erforderlich, eine Reihe von Passwörtern für Komponenten einzugeben. Wenn Sie unterschiedliche Komponenten auf unterschiedlichen Hosts installieren, muss sichergestellt sein, dass auf jedem Host jeweils übereinstimmende Passwörter angegeben werden.

Zur Behebung von Passwortproblemen müssen Sie möglicherweise eine Deinstallation, gefolgt von einer erneuten Installation, durchführen. Lesen Sie unter Installation schlägt wegen während der Deinstallation nicht entfernter Dateien fehl nach, wenn die Deinstallation fehlgeschlagen ist.

Überprüfen von Komponentenabhängigkeiten

Eine Reihe von Komponenten weist auf dem Installationszeitpunkt basierende gegenseitige Abhängigkeiten auf. Probleme, die sich auf eine Komponente auswirken, können sich auch auf andere Komponenten auswirken. Machen Sie sich mit den in Überprüfen von Abhängigkeiten enthaltenen Informationen vertraut, wenn Sie eventuell nicht erfüllte Abhängigkeiten überprüfen wollen. Gehen Sie danach wie folgt vor:

Installationsprobleme

In diesem Abschnitt werden folgende Probleme behandelt, die möglicherweise bei der Installation auftreten:

Installation schlägt wegen während der Deinstallation nicht entfernter Dateien fehl

Beim Fehlschlagen einer Deinstallation kann es vorkommen, dass Komponenten, die von der Deinstallation vom System entfernt werden sollten, darauf verbleiben. In diesem Fall müssen vor der Neuinstallation von Java ES diese Komponenten manuell entfernt werden.

ProcedureSo entfernen Sie verbleibende Dateien

Bevor Sie Java ES nach einer fehlgeschlagenen Installation bzw. Dekonfiguration neu installieren, sollten Sie zunächst die folgenden Schritte zum Beseitigen verbleibender Dateien durchführen.

  1. Vergewissern Sie sich, dass alle Java ES-Dienste angehalten und vom Menü “Systemsteuerung > Verwaltung > Dienste” entfernt wurden.

  2. Löschen Sie alle vorher installierten Sun-Ordner. Falls die Ordner nicht gelöscht werden können, sollten Sie das System neu starten und die Ordner dann löschen.

  3. Überprüfen Sie, ob noch immer Diensteinträge vorhanden sind. Falls unter “Dienste” noch Diensteinträge enthalten sind, müssen Sie diese manuell aus der Windows-Registrierung entfernen. In der folgenden Tabelle sind mögliche Einträge aufgeführt.

    Komponentenname  

    Diensteintrag  

    Common Agent Container 

    Common Agent Container 2 (#CRC:default) 

    HADB 

    HADB4.4MgmtAgent

    Message Queue 

    MQ3.7UR1_Broker

    Portal Server 

    sra.gateway.SRA-Instanz

    sra.netletproxy.SRA-Instanz

    sra.rewriterproxy.SRA-Instanz

    WebAdminServer 

    https-admserv70

    Web Console 

    Web Console 3.0.2 console  

    Web Proxy Server 

    Sun Java System Socks Server 4.0.4 (server1)

    Sun Java System Web Proxy Server 4.0.4 (proxy-server1)

    Sun Java System Web Proxy Server 4.0.4 Administration Server  

    Web Server 

    Sun Java System Web Server 7.0 (https-Hostname.Domänenname)

    Sun Java System Web Server 7.0 Administration Server 

  4. Löschen Sie Einträge aus der Registrierung.

    Löschen Sie HKEY_LOCAL_MACHINE\Software\Sun Microsystems\Entsys5\Installer.

  5. Starten Sie vor Installationsbeginn das System neu, wenn Sie einen der vorherigen Schritte ausgeführt haben.

Fehler des Windows-Installationsprogramms

Die Installation kann aufgrund eines Fehlers des Windows-Installationsprogramms fehlschlagen.

Stille Installation schlägt fehl

Wenn Sie die Antwortdatei bearbeitet haben, sind Ihnen hierbei möglicherweise Fehler unterlaufen. Sie sollten z. B. Folgendes überprüfen:

Beheben Sie das Problem und erstellen Sie die Antwortdatei neu (siehe Erstellen einer Antwortdatei).

Stille Installation schlägt fehl: “Antwortdatei inkompatibel oder beschädigt”

Wenn Sie eine Antwortdatei verwenden, die auf der gleichen Plattform erstellt wurde, auf der Sie diese Datei verwenden, ist das Problem möglicherweise auf einen unbekannten Dateikorruptionsfehler zurückzuführen. Versuchen Sie, eine neue Antwortdatei zu erstellen und dann eine Neuinstallation durchzuführen.

Weitere Informationen finden Sie unter Erstellen einer Antwortdatei.

Unerwartete externe Fehler

Zu den möglichen Ursachen externer Fehler zählen:

Wenn der Ausfall während der Installation oder Konfiguration aufgetreten ist, hat dies höchstwahrscheinlich zu einer unvollständigen Installation geführt. Führen Sie das Deinstallationsprogramm aus. Arbeiten Sie die Anweisungen unter Installation schlägt wegen während der Deinstallation nicht entfernter Dateien fehl ab, wenn das Deinstallationsprogramm fehlgeschlagen ist.

Portaldatenbank wird nach einem Java DB-Neustart nicht gefunden

Dies kann auftreten, wenn Sie ein Application Server-Beispiel bereitstellen, das Java DB verwendet, nachdem Sie den Standardbefehl von Application Server für den Neustart von Java DB (asadmin stop-databsse, dann asadmin start-database ) ausgeführt haben. Auf Portal Server-Beispiele kann dann nicht mehr zugegriffen werden.

Abhilfemaßnahme: Führen Sie eine der folgenden Abhilfemaßnahmen durch:

Informationen zur Problembehebung bei Komponenten

In diesem Abschnitt finden Sie unterschiedliche Hinweise zu Komponenten, die auf hilfreiche Dokumentationen verweisen.

Tipps zur Problembehebung in Access Manager

Tabelle 8–1 Tipps zur Problembehebung in Access Manager

Thema 

Details 

Konfigurationsdatei 

AccessManager-Basisverz\Config\AMConfig.properties

Protokoll- und Debug-Dateien 

Protokolldateiverzeichnis: 

AccessManager-Basisverz\Logs

Debug-Dateiverzeichnis: 

AccessManager-Basisverz\Debug

Debug-Modus 

Siehe Sun Java System Access Manager Developer’s Guide.

Tipps zur Problembehebung für Application Server

Tabelle 8–2 Tipps zur Problembehebung für Application Server

Thema 

Details 

Protokolldateien 

Protokolldateiverzeichnis: 

JavaES-Installationsverz\appserver\domain\Domäne1 \logs

Nachrichtenprotokoll-Dateiname: server.log (für jede Serverinstanz)

Konfigurationsdateien 

Konfigurationsdatei-Verzeichnis: ApplicationServer-Basisverz\Config.

Problembehebung 

Siehe Sun Java System Application Server Enterprise Edition Troubleshooting Guide.

Tipps zur Problembehebung für Directory Server

Tabelle 8–3 Tipps zur Problembehebung für Directory Server

Thema 

Details 

Protokolldateien 

Die Installationsprotokolldatei befindet sich im Ordner tmp.

Konfigurationsprotokolldateien: 

  • DirectoryServer-Basisverz.AZeitrahmen

  • DirectoryServer-Basisverz.B Zeitrahmen

Informationen zur Verwaltung von Protokolldateien finden Sie im Sun Java System Directory Server Administration Guide

Problembehebung 

Siehe Sun Java System Directory Server Administration Guide.

Tipps zur Problembehebung für HADB

Tabelle 8–4 Tipps zur Problembehebung für HADB

Thema 

Details 

Protokolldateien 

JavaES-Installationsverz\Hadb\4.4.3-5\ma\ma.log

Konfigurationsdateien 

  • HADB.properties

  • mgt.cfg

Diese Dateien befinden sich im Verzeichnis JavaES-Installationsverz\Hadb\4.4.3-5\lib\ .

Programmdateiverzeichnis 

JavaES-Installationsverz\Hadb\4.4.3-5\bin\

Problembehebung 

Siehe High Availability Session Store Administrator’s Guide.

Tipps zur Problembehebung für Message Queue

Tabelle 8–5 Tipps zur Problembehebung für Message Queue

Thema  

Details 

Protokolldateien 

Installationsprotokolldatei: 

MessageQueue-Basisverz\var\instances\ Instanzname\log

Siehe Sun Java System Message Queue 3.7 UR1 Administration Guide.

Problembehebung 

Bei Leistungsproblemen sollten Sie in Kapitel 11, Analyzing and Tuning a Message Service in Sun Java System Message Queue 3.7 UR1 Administration Guide nachlesen.

Die Problembehebung für Message Queue wird in Kapitel 12, Troubleshooting Problems in Sun Java System Message Queue 3.7 UR1 Administration Guide behandelt. Siehe dazu auch das Message Queue Forum unter: http://swforum.sun.com/jive/forum.jspa?forumID=24.

Zusätzliche Artikel finden Sie in der Knowledge Base unter http://developers.sun.com/prodtech/msgqueue/reference/techart/index.html.

Tipps zur Problembehebung für Monitoring Console

Tabelle 8–6 Tipps zur Problembehebung für Monitoring Console

Thema 

Details 

Konfigurationsdateien 

Für Monitoring Console: 

  • MonitoringConsole-Basisverz\WEB-INF\web.xml

Für Monitoring Framework: 

  • JavaES-Installationsverz\share\mfwk\config\mfwk.properties

Protokolldateien 

Für Monitoring Console: 

  • JavaES-Installationsverz\share\webconsole\console\console_config_log

Für Monitoring Framework: 

  • JavaES-Installationsverz\share\mfwk\logs

Problembehebung 

Wenn Sie nicht auf Monitoring Console zugreifen können, sollten Sie unter Fehlerbehebung an der Monitoring Console in Sun Java Enterprise System 5 Überwachungshandbuch nachlesen. Informationen zur Problembehebung an der Monitoring Console finden Sie unter Fehlerbehebung am Monitoring Framework in Sun Java Enterprise System 5 Überwachungshandbuch.

Tipps zur Problembehebung für Portal Server Secure Remote Access

Tabelle 8–7 Tipps zur Problembehebung für Portal Server Secure Remote Access

Thema 

Details 

Debug-Protokolle 

Debug-Protokolle für das Portal-Gateway befinden sich im Verzeichnis PortalServer-Basisverz\debug.

Hinweis –

Wenn die Protokollierung über Access Manager Administration Console aktiviert ist, befinden sich die Protokolle für Portal Server-Dienste (z. B. NetFile) im Verzeichnis AccessManager-Basisverz>\debug.

Tipps zur Problembehebung für Portal Server

Tabelle 8–8 Tipps zur Problembehebung für Portal Server

Thema  

Details 

Protokolldateien und Debug-Dateien 

Protokolldateien für Portal Server sind: 

  • psadmin-Protokolle: PortalServer-Basisverz\data\admin

  • Configuration logsPortalServer-Basisverz\data\config

  • Protokolle für Portal Server-Instanzen: PortalServer-Basisverz\data\portals\Portal-ID\logs\ Instanz-ID

Tipps zur Problembehebung für Service Registry

Tabelle 8–9 Tipps zur Problembehebung für Service Registry

Thema 

Details  

Protokolldateien 

Standard-Protokolldatei:ServiceRegistry-Basisverz\domains\registry\logs\server.log

Weitere Informationen finden Sie im Service Registry 3.1 Administration Guide.

Problembehebung 

Siehe Service Registry 3.1 Administration Guide.

Tipps zur Problembehebung für Web Proxy Server

Tabelle 8–10 Tipps zur Problembehebung für Web Proxy Server

Thema 

Details 

Protokolldateien 

Standard-Protokolldateien: 

  • JavaES-Installationsverz\ Instanzname\config\logs\errors

  • JavaES-Installationsverz\ Instanzname\config\logs\access

  • JavaES-Installationsverz\ Admin-Name\config\logs\errors

  • JavaES-Installationsverz\ Admin-Name\config\logs\access

Weitere Informationen finden Sie im Sun Java System Web Proxy Server Administration Guide.

Problembehebung 

Siehe Sun Java System Web Proxy Administration Guide.

Tipps zur Problembehebung für Web Server

Tabelle 8–11 Tipps zur Problembehebung für Web Server

Thema  

Details 

Protokolldateien 

Die Protokolldateien errors und access befinden sich im verzeichnis WebServer-Basisverz\WebServer_Install.log .

Die Protokolldatei errors enthält alle Fehler, auf die der Server gestoßen ist. Die Protokolldatei access erfasst Informationen über Anforderungen an den Server und Antworten des Servers. Weitere Informationen finden Sie im Sun Java System Web Server 7.0 Administrator’s Guide.

Problembehebung 

Siehe Sun Java System Web Server 7.0 Troubleshooting Guide.

Konfigurationsdatei-Verzeichnis 

WebServer-Basisverz\https-instance-name\config

Zusätzliche Informationen zur Problembehebung

Folgende zusätzliche Informationen in diesem Handbuch sind bei der Problembehebung hilfreich: