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:
Dieser Abschnitt enthält allgemeine Richtlinien zum Auffinden von Problemursachen. Folgende Themen werden behandelt:
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.
Wenn Sie eine Komponente installieren, die von Directory Server abhängig ist, kann es in folgenden Situationen zu Problemen kommen:
Sie haben eine falsche Benutzer-ID und ein falsches Passwort für Directory Server angegeben.
Sie haben einen falschen LDAP (Lightweight Directory Access Protocol)-Port angegeben.
Der Verbindungsaufbau mit Directory Server ist nicht möglich.
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.
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.
Die nachfolgend aufgeführten Aspekte auf Hostebene können zu Installationsproblemen führen.
Updates. Haben Sie die empfohlenen Service-Packs installiert?
Festplattenspeicherplatz. Wie ist die Festplatte partitioniert, und auf welche Partitionen verweisen die Installationsverzeichnisse?
Netzwerk-Ports. Die Portnummern für Java ES-Komponenten werden bei der Konfiguration angegeben. Überprüfen Sie wie folgt, dass die Portinformationen richtig sind:
Überprüfen Sie in der Datei die Standard-Portnummern.
Vergleichen Sie anhand der Zusammenfassungsprotokolldatei Ihre Einstellungen mit den Standardeinstellungen. Ist Ihnen bei der Eingabe einer Portnummer ein Fehler unterlaufen oder haben Sie einen Server auf einen Port eingestellt, der normalerweise für einen anderen Server verwendet wird?
Verwenden Sie den Befehl netstat -a, um die aktuelle Portnutzung im System anzuzeigen. Haben Sie eine Portnummer zugewiesen, die bereits verwendet wurde?
Überprüfen Sie, ob Sie während der Konfiguration den richtigen Hostnamen und den korrekten Domänennamen angegeben haben.
Vor Installationsbeginn sollten Sie auch unter Systemanforderungen nachlesen, um zu überprüfen, dass alle Systemvoraussetzungen erfüllt sind.
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.
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.
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.
Ü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.
Überprüfen Sie die detaillierten Protokolldateien.
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.
Suchen Sie den Namen der Komponente, die das Problem verursacht hat.
Ü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.
Überprüfen Sie die Installationsprotokolldatei auf Probleme, die bei der Installation bzw. Deinstallation aufgetreten sind. Probleme auf Konfigurationsebene sind in den Konfigurationsprotokollen aufgeführt.
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.
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.
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:
Sehen Sie in der Zusammenfassungsdatei und den Protokolldateien nach, ob bei zugehörigen Komponenten ein Fehler aufgetreten ist. Diese Informationen geben möglicherweise Aufschluss darüber, welches Problem zuerst behoben werden sollte.
Vergewissern Sie sich, dass Sie die richtigen Verbindungsinformationen angegeben haben. Beispiel:
Stimmen die Informationen, die Sie bei der Konfiguration von Directory Server angegeben haben, mit den Verzeichnisinformationen überein, die Sie für die Komponenten angegeben haben, von denen Directory Server verwendet wird?
Stimmen die Access Manager-Informationen, die Sie für Portal Server oder Portal Server Secure Remote Access angegeben haben, mit den für Access Manager angegebenen Informationen überein?
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
Stille Installation schlägt fehl: “Antwortdatei inkompatibel oder beschädigt”
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.
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.
Vergewissern Sie sich, dass alle Java ES-Dienste angehalten und vom Menü “Systemsteuerung > Verwaltung > Dienste” entfernt wurden.
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.
Ü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 |
Löschen Sie Einträge aus der Registrierung.
Löschen Sie HKEY_LOCAL_MACHINE\Software\Sun Microsystems\Entsys5\Installer.
Starten Sie vor Installationsbeginn das System neu, wenn Sie einen der vorherigen Schritte ausgeführt haben.
Die Installation kann aufgrund eines Fehlers des Windows-Installationsprogramms fehlschlagen.
Fehler 1603 - Schwerwiegender Fehler bei der Installation: Dieser Fehler tritt auf, wenn auf dem Zielhost Windows 2003 Enterprise Server mit SP1 installiert ist. Mögliche Ursachen dieses Fehlers werden unter http://support.microsoft.com/default.aspx?scid=kb;en-us;834484 behandelt.
In einem solchen Fall müssen Sie ein Update für Windows 2003 Enterprise Server SP1 installieren. Dieses können Sie von der folgenden URL herunterladen: http://support.microsoft.com/kb/898715.
Wenn Sie die Antwortdatei bearbeitet haben, sind Ihnen hierbei möglicherweise Fehler unterlaufen. Sie sollten z. B. Folgendes überprüfen:
Sind alle lokalen Hostparameter gesetzt und sind auf konsistente Werte eingestellt?
Weisen die Parameterwerte die richtige Groß-/Kleinschreibung auf?
Haben Sie einen erforderlichen Parameter gelöscht, ohne einen Ersatzparameter einzugeben?
Sind alle Portnummern zulässig? Sind einige Portnummern möglicherweise nicht zugewiesen?
Beheben Sie das Problem und erstellen Sie die Antwortdatei neu (siehe Erstellen einer Antwortdatei).
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.
Zu den möglichen Ursachen externer Fehler zählen:
Strom- bzw. Systemausfall
Drücken der Tastenkombination STRG-C oder Beenden des Installationsprogramm-Prozesses im Task-Manager von Windows
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.
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:
Halten Sie Java DB nicht an.
Wenn Java DB angehalten wird, starten Sie Java DB mit dem folgenden Befehl neu, damit die Application Server-Datenbank an einem anderen Speicherort erstellt werden kann.
asadmin start-database --dbhome JavaES-Installationsverz\portal\data\derby
Wenn die Datenbank im Standardverzeichnis installiert werden soll, müssen sie zunächst mithilfe eines nicht standardmäßigen Ports eine zweite Java DB-Instanz starten und diesen Port dann in den Application Server-Beispielen angeben. Geben Sie zum Beispiel ein:
asadmin start-database --dbport 1528
In diesem Abschnitt finden Sie unterschiedliche Hinweise zu Komponenten, die auf hilfreiche Dokumentationen verweisen.
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. |
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. |
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. |
Thema |
Details |
---|---|
Konfigurationsdateien |
Für Monitoring Console:
Für Monitoring Framework:
|
Protokolldateien |
Für Monitoring Console:
Für Monitoring Framework:
|
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. |
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. |
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. |
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 |
Folgende zusätzliche Informationen in diesem Handbuch sind bei der Problembehebung hilfreich:
Kapitel 5, Durchführen der nach der Installation vorgesehenen Konfiguration enthält Anweisungen zur Konfiguration nach der Installation.
Kapitel 6, Überprüfen der installierten Java ES-Komponenten enthält Anweisungen zum Überprüfen installierter Java ES-Komponenten.
Kapitel 7, Deinstallation von Java ES-Komponenten enthält Informationen, die während der Deinstallation der Java ES-Software auftreten können.