Kapitel 11 Problembehebung

Dieses Kapitel enth�lt Vorschl�ge hinsichtlich von Problemen, die bei der Installation und bei der Deinstallation von Sun Java™ Enterprise System (Java ES) auftreten.

Allgemeine Methoden zur Problembehebung

Dieser Abschnitt enth�lt Ans�tze, die Sie beim Ermitteln der Ursache eines Problems unterst�tzen. Folgende Themen werden behandelt:

�berpr�fen der Installationsprotokolldateien

Wenn bei der Installation oder Deinstallation ein Problem auftritt, �berpr�fen Sie die entsprechende Protokolldatei.

Die �berpr�fung der Protokolldateien des Deinstallations- und Installationsprogramms (in Kombination mit dem Java ES-Konfigurationsprotokoll) kann Ihnen beim Ausfindigmachen der Ursache von Problemen helfen.

Um die Protokolldateien zur Problembehebung einzusetzen, versuchen Sie das Problem einzugrenzen, das als erstes auftrat. H�ufig zieht das erste Problem weitere Probleme nach sich. Gehen Sie in dieser Reihenfolge vor:

�berpr�fen Sie die Datei mit der Installationszusammenfassung, die eine anspruchsvolle Beschreibung der Installations- und Konfigurationsschritte enth�lt. Diese Datei befindet sich in <InstallDir>\Summary.txt. Wenn ein Problem aufgetreten ist, finden Sie heraus, welche Komponente es verursacht hat. Wenn mehrere Probleme aufgetreten sind, grenzen Sie das erste ein.

�berpr�fen Sie die detaillierten Protokolldateien.

Suchen Sie nach dem ersten Fehler bzw. der ersten 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 die Konfigurationsprotokolle. Die Konfigurationsprotokolle befinden sich in Produkt <installdir>s; genaue Speicherortangaben finden Sie in Summary.txt.

�berpr�fen Sie die Installationsprogramm-Protokolldatei auf Installations-/Deinstallationsprobleme und pr�fen Sie die Konfigurationsprogrammprotokolle auf konfigurationsbezogene Probleme.

�berpr�fen der Protokolldateien der Komponente

Wenn beim Starten einer Komponente ein Problem auftritt, �berpr�fen Sie die zugeh�rigen Protokolldateien. Zahlreiche Komponentenprotokolldateien werden unter Informationen zur Problembehebung vom Komponenten aufgelistet.

�berpr�fen der Produktabh�ngigkeiten

Eine Reihe von Komponenten weist auf dem Installationszeitpunkt basierend gegenseitige Abh�ngigkeiten auf. Probleme, die sich auf eine Komponente auswirken, k�nnen sich auch auf andere Komponenten auswirken. Wenn Sie auf gegenseitige Abh�ngigkeiten pr�fen m�chten, die nicht erf�llt wurden, machen Sie sich mit den Informationen unter Wie wirken sich die gegenseitigen Abh�ngigkeiten der Komponenten auf meine Installation aus? vertraut. F�hren Sie die folgenden Schritte aus:

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. Zum 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 SRA angegeben haben, mit den f�r Access Manager angegebenen Informationen �berein?

�berpr�fen von Ressourcen und Einstellungen

Die nachfolgend aufgef�hrten Aspekte auf Hostebene k�nnen zu Installationsproblemen f�hren:

Lesen Sie Sind Ihre Systeme bereit?, wenn Sie �berpr�fen m�chten, ob alle Anforderungen erf�llt sind, bevor Sie mit der Installation beginnen.

Netzwerkanschl�sse. Bei der Konfiguration geben Sie Anschlussnummern f�r Sun Java Enterprise System-Komponenten an. F�hren Sie die folgenden Schritte aus:

Pr�fen Sie die standardm��igen Anschlussnummern in der Datei.

Vergleichen Sie anhand der Zusammenfassungsprotokolldatei Ihre Einstellungen mit den Standardeinstellungen. Ist Ihnen bei der Eingabe einer Anschlussnummer ein Fehler unterlaufen oder haben Sie einen Server auf einen Anschluss eingestellt, der normalerweise f�r einen anderen Server verwendet wird?

Verwenden Sie den Befehl netstat -a, um die aktuelle Anschlussnutzung im System anzuzeigen. Haben Sie eine Anschlussnummer zugewiesen, die bereits verwendet wurde?

Vergewissern Sie sich, dass Sie bei der Konfiguration den richtigen Hostnamen und Dom�nennamen angegeben haben.

Pr�fen der nach der Installation vorgenommenen Konfiguration

�berpr�fen des Verteilungsmediums

Gilt bei der Installation von DVD oder CD: Ist das Medium verschmutzt oder besch�digt? Verschmutzte Datentr�ger k�nnen zu Installationsproblemen f�hren.

�berpr�fen der Directory Server-Konnektivit�t

Wenn Sie eine Komponente installieren, die von Directory Server abh�ngig ist, kann es durch einen der folgenden Fehler zu Problemen kommen:

Im Modus „Sp�ter konfigurieren“ m�ssen Sie sicherstellen, dass Directory Server ausgef�hrt wird, bevor Sie die Produkte konfigurieren, die von Directory Server abh�ngig sind.

Entfernen von Web Server-Dateien und -Verzeichnissen

Um das �berschreiben benutzerdefinierter Dateien, beispielsweise bearbeiteter Konfigurationsdateien, zu verhindern, kann Web Server nicht in einem Verzeichnis installiert werden, das Dateien enth�lt.

Wenn Sie eine Neuinstallation von Web Server durchf�hren, vergewissern Sie sich, dass die entsprechenden Verzeichnisse leer sind. Archivieren Sie anderenfalls die Dateien an einem anderen Ort und f�hren Sie die Installation erneut durch.

�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 jeweils �bereinstimmende Passw�rter angegeben werden.

Probleme bei der Installation

In diesem Abschnitt werden folgende Probleme abgedeckt, die m�glicherweise bei der Installation auftreten:

Installation schl�gt aufgrund von nach der Deinstallation nicht entfernten Dateien fehl

Wenn ein Deinstallationsvorgang fehlschl�gt, bleiben m�glicherweise Komponenten zur�ck. In diesem Fall m�ssen vor der Neuinstallation von Java ES die Komponenten manuell entfernt werden.

So bereinigen Sie die Dateien

Die folgenden Bereinigungsschritte sind erforderlich, bevor das Sun Java Enterprise System installiert werden kann, wenn zuvor eine fehlerhafte Installation oder Dekonfiguration aufgetreten ist.

Stellen Sie sicher, dass alle Sun Java Enterprise System-Dienste beendet und aus > Verwaltung>Dienste der Systemsteuerung entfernt wurden.

L�schen Sie alle ggf. zuvor installierten Sun-Ordner.

�berpr�fen Sie, ob Diensteintr�ge verblieben sind. Wenn unter „Dienste“ ein Diensteintrag verblieben ist, m�ssen Sie die Registrierung bereinigen. Eine Liste der Diensteintr�ge finden Sie in Tabelle 11-1.

Registrierungsbereinigung:

L�schen Sie HKLM\Software\Sun Microsystems\Entsys\Installer.

L�schen Sie alle Sun Java ES-Diensteintr�ge unter HLKM\System\CurrentControlSet\Services.

Wenn Sie einen der oben beschriebenen Schritte ausgef�hrt haben, starten Sie das System neu, bevor Sie mit der Installation beginnen.

Tabelle 11-1 Diensteintr�ge f�r vor einer erneuten Installation zu l�schende Komponenten
Produkname	Diensteintrag
Directory Server	slapd-<Hostname>
Administration Server	admin52-serv
Calendar Server	JavaESCalendarAdminService6 JavaESCalendarDWPService6 JavaESCalendarHTTPService6 JavaESENSService6 JavaESNotificationService6
HADB	HADBMgmtAgent
WebAdminServer	https-admserv61
Webserver	https-<hostname>.red.iplanet.com
Instant Messaging	iim calagent
Message Queue	MQ_Broker
Directory Proxy Server	SunONEDPS
Messaging Server	Messaging Bootstrap

Installationsfehler

Die Installation kann aufgrund eines Fehlers von Windows Installer fehlschlagen.

Unerwartete externe Fehler

M�glicherweise ist es zu einem Strom- oder Systemausfall gekommen oder Sie haben Strg+C eingegeben bzw. das Installationsprogramm �ber den Task-Manager beendet, um den Installationsvorgang anzuhalten.

Wenn der Ausfall w�hrend der Installation oder Konfiguration aufgetreten ist, hat dies h�chstwahrscheinlich zu einer Teilinstallation gef�hrt. F�hren Sie das Deinstallationsprogramm aus. Wenn das Deinstallationsprogramm fehlschl�gt, befolgen Sie die Anweisungen unter Installation schl�gt aufgrund von nach der Deinstallation nicht entfernten Dateien fehl.

Stille Installation schl�gt fehl: „Antwortdatei inkompatibel oder besch�digt“

Wenn Sie eine Antwortdatei verwenden, die auf der Plattform erstellt wurde, auf der Sie sie verwenden, ist das Problem m�glicherweise auf einen unbekannten Dateikorruptionsfehler zur�ckzuf�hren.

Empfehlung. Erstellen Sie eine neue Antwortdatei und f�hren Sie die Installation erneut durch.

Stille Installation schl�gt fehl

Wenn Sie die Antwortdatei bearbeitet haben, sind Ihnen hierbei m�glicherweise Fehler unterlaufen. Pr�fen Sie beispielsweise Folgendes:

Empfehlung. Beheben Sie das Problem und erstellen Sie die Antwortdatei wie unter Erstellen einer Antwortdatei beschrieben neu.

Probleme bei der Deinstallation

In diesem Abschnitt wird folgendes Problem abgedeckt, das m�glicherweise bei der Deinstallation auftritt:

Deinstallation schl�gt fehl und es bleiben Dateien zur�ck

Wenn eine manuelle Bereinigung erforderlich ist, weil die Deinstallation fehlschl�gt und Dateien oder Diensteintr�ge hinterl�sst, lesen Sie So bereinigen Sie die Dateien.

Informationen zur Problembehebung vom Komponenten

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

Access Manager-Tools zur Problembehebung

Tabelle 11-2 Access Manager -Tools zur Problembehebung
Aspekt	Details
Konfigurationsdatei	AMConfig.properties <INSTALL-DIR>/AccessManager/Config
Protokolldateien und Debug-Dateien	Protokolldateiverzeichnis: <INSTALL-DIR>/AccessManager/Logs Debug-Dateiverzeichnis: <INSTALL-DIR>/AccessManager/Debug
Debug-Modus	Ziehen Sie den Sun Java System Access Manager Developer’s Guide (http://docs.sun.com/doc/817-7649) zurate.

Administration Server-Tools zur Problembehebung

Tabelle 11-3 Administration Server-Tools zur Problembehebung
Aspekt	Details
Protokolldateien	Installationsprotokollverzeichnis: <INSTALL-DIR>/Server-root/admin-serv/logs/ Konfigurationsprotokolldateien: Administration_Server_install.Azeitstempel Administration_Server_install.Bzeitstempel Weitere Informationen zu den Protokollierungsoptionen finden Sie im Sun Java System Administration Server Administration Guide (http://docs.sun.com/doc/817-7612).
Problembehebung	Ziehen Sie den Sun Java System Administration Server Administration Guide (http://docs.sun.com/doc/817-7612) zurate.

Application Server-Tools zur Problembehebung

Tabelle 11-4 Application Server-Tools zur Problembehebung
Aspekt	Details
Protokolldateien	Protokolldateiverzeichnis: <INSTALL-DIR>/ApplicationServer/Setup/ Application Server-Objektprotokollverzeichnis (Standardverzeichnis f�r das anf�nglich erstellte Objekt): <INSTALL-DIR>/ApplicationServer/ Nachrichtenprotokoll-Dateiname: server.log, f�r jede Server-Instanz
Konfigurationsdateien	Konfigurationsdateiverzeichnis: <INSTALL-DIR>/ApplicationServer/Config
Problembehebung	Ziehen Sie den Sun Java System Application Server Enterprise Edition Troubleshooting Guide (http://docs.sun.com/doc/819-0086) zurate.

Calendar Server-Tools zur Problembehebung

Tabelle 11-5 Calendar Server-Tools zur Problembehebung
Aspekt	Details
Protokolldateien	Administrationsdienst (csadmind): admin.log Dienst f�r verteilte Datenbanken (csdwpd): dwp.log HTTP-Dienst (cshttpd): http.log Benachrichtigungsdienst (csnotifyd): notify.log Standardprotokollverzeichnis: <INSTALL_DIR>/CalenderServer/logs Weitere Informationen finden Sie im Sun Java System Calendar Server Administration Guide (http://docs.sun.com/doc/819-0024).
Konfigurationsdatei	<INSTALL-DIR>/CalenderServer/bin/config/ics.conf
Debug-Modus	Zur Verwendung des Debug-Modus stellt ein Calendar Server-Administrator den Konfigurationsparameter logfile.loglevel in der Datei ics.conf ein. Zum Beispiel: logfile.loglevel = "debug" Weitere Informationen finden Sie im Sun Java System Calendar Server Administration Guide (http://docs.sun.com/doc/819-0024).
Problembehebung	Ziehen Sie den Sun Java System Calendar Server Administration Guide (http://docs.sun.com/doc/819-0024) zurate.

Communications Express-Tools zur Problembehebung

Tabelle 11-6 Administration Server-Tools zur Problembehebung
Aspekt	Details
Protokolldateien	Installationsprotokollverzeichnis: uwc-installed-path/install/uwc.log Ist von dem Wert abh�ngig, der in der Datei „uwc logging.properties“ angegeben wird.
Problembehebung	Lesen Sie das Kapitel „Troubleshooting“ im Sun Java System Communications Express Administration Guide, http://docs.sun.com/doc/819-0115.

Directory Proxy Server-Tools zur Problembehebung

Tabelle 11-7 Directory Proxy Server-Tools zur Problembehebung
Aspekt	Details
Protokolldateien	Standardprotokolldatei: <INSTALL DIR>/Server-Root/dps- hostname/logs/fwd.log Weitere Informationen finden Sie im Sun Java System Directory Proxy Server Administration Guide (http://docs.sun.com/doc/817-7615).
Problembehebung	Ziehen Sie den Sun Java System Directory Proxy Server Administration Guide (http://docs.sun.com/doc/817-7615) zurate.

Directory Server-Tools zur Problembehebung

Tabelle 11-8 Directory Server-Tools zur Problembehebung
Aspekt	Details
Protokolldateien	Die Installationsprotokolldatei befindet sich im Ordner „tmp“. Konfigurationsprotokolldateien: Directory_Server_install.Azeitstempel Directory_Server_install.Bzeitstempel Informationen zur Verwaltung von Protokolldateien finden Sie im Sun Java System Directory Server Administration Guide (http://docs.sun.com/doc/817-7613).
Problembehebung	Ziehen Sie den Sun Java System Directory Server Administration Guide (http://docs.sun.com/doc/817-7613) zurate.

Instant Messaging-Tools zur Problembehebung

Tabelle 11-9 Instant Messaging-Tools zur Problembehebung
Aspekt	Details
Protokolldateien	Serverprotokoll: xmppd.log Agenten-Kalenderprotokoll: agent-calendar.log Standardprotokollverzeichnis: <INSTALL_DIR>/Instant Messaging/log Weitere Informationen finden Sie im Sun Java System Instant Messaging Server Administration Guide (http://docs.sun.com/doc/819-0430).
Konfigurationsdatei	<INSTALL_DIR>/Instant Messaging/config/iim.conf
Debug-Modus	Zur Verwendung des Debug-Modus legt ein Messaging Server-Administrator den Konfigurationsparameter iim.log.iim_server.severity in der Datei iim.conf fest. Zum Beispiel: ! Protokollschweregrad f�r die Serverkomponente. iim.log.iim_server.severity = „DEBUG“ ! Protokollschweregrad f�r die Multiplexor-Komponente. iim.log.iim_mux.severity = „DEBUG“ Weitere Informationen finden Sie im Sun Java System Instant Messaging Server Administration Guide (http://docs.sun.com/doc/ <Dokumnt-Nr.:>).
Problembehebung	Ziehen Sie den Sun Java System Instant Messaging Server Administration Guide (http://docs.sun.com/doc/819-0024) zurate.

Message Queue-Tools zur Problembehebung

Tabelle 11-10 Message Queue-Tools zur Problembehebung
Aspekt	Details
Protokolldateien	Installationsprotokolldatei: <INSTALL_DIR>/MessageQueue/var/instances/<Instanzname>/log Ziehen Sie den Sun Java System Message Queue Administration Guide (http://docs.sun.com/doc/818-0066) zurate.
Problembehebung	Ziehen Sie bei Leistungsproblemen das Kapitel „Analyzing and Tuning a Message Service“ im Sun Java System Message Queue Administration Guide (http://docs.sun.com/doc/819-0066) zurate. Die Message Queue-Problembehebung wird im Kapitel „Troubleshooting Problems“ im Sun Java System Message Queue Administration Guide sowie im MQ-Forum unter folgender Adresse behandelt: http://swforum.sun.com/jive/forum.jspa?forumID=24. Weitere Artikel stehen in der Knowledge Base unter http://developers.sun.com/prodtech/msgqueue/reference/techart/index.html zur Verf�gung.

Messaging Server-Tools zur Problembehebung

Tabelle 11-11 Messaging Server-Tools zur Problembehebung
Aspekt	Details
Verzeichnis der ausf�hrbaren Datei	<INSTALL-DIR>/Sun/Server-root/sbin
Protokolldateien	<INSTALL-DIR>/Sun/Server-root/data/log
Problembehebung	Ziehen Sie den Sun Java System Messaging Server Administration Guide (http://docs.sun.com/doc/819-0105) zurate.

Portal Server-Tools zur Problembehebung

Tabelle 11-12 Portal Server-Tools zur Problembehebung
Aspekt	Details
Protokolldateien und Debug-Dateien	Portal Server verwendet dieselben Protokolldateien und Debug-Dateien wie Access Manager. Die zugeh�rigen Verzeichnisse lauten wie folgt: Protokolldatei: <INSTALL-DIR>/AccessManager/Logs Debug-Datei: <INSTALL-DIR>/AccessManager/debug Informationen zur Verwaltung der Protokolldateien und Debug-Dateien von Portal Server finden Sie in Sun Java System Portal Server Administration Guide (http://docs.sun.com/doc/817-5324). F�r Portal Server Desktop finden Sie die Debug-Dateien hier: "desktop.debug "desktop.dpadmin.debug Informationen zur Verwaltung dieser Dateien finden Sie im Sun Java System Portal Server Administration Guide (http://docs.sun.com/doc/817-5324). Die Portal Server-Befehlszeilendienstprogramme dpadmin, par, rdmgr und sendrdm verf�gen �ber Optionen zur Erstellung von Debugging-Nachrichten. Eine Erl�uterung der Optionen finden Sie im Portal Server Administrator’s Guide.

Portal Server Secure Remote Access-Tools zur Problembehebung

Tabelle 11-13 Portal Server Secure Remote Access-Tools zur Problembehebung
Aspekt	Details
Debug-Protokolle	Die Debug-Protokolle von Portal Gateway befinden sich in folgendem Verzeichnis: <INSTALL-DIR>/PortalServer/debug HINWEIS: Wenn die Protokollierung �ber Access Manager Administration Console aktiviert wird, befinden sich die Protokolle f�r Portal Server-Dienste (z. B. NetFile) im Verzeichnis „/<INSTALL_DIR>/AccessManager/debug“.

Web Server-Tools zur Problembehebung

Tabelle 11-14 Web Server-Tools zur Problembehebung
Aspekt	Details
Protokolldateien	Es stehen zwei Typen von Web Server-Protokolldateien zur Verf�gung: die Protokolldatei errors und die Protokolldatei access, die sich beide in folgendem Verzeichnis befinden: <INSTALL-DIR>/Web Server>/https-instanz-name/logs Die errors-Protokolldatei enth�lt alle Fehler, auf die der Server gesto�en ist. Die access-Protokolldatei erfasst Informationen �ber Anforderungen an den Server und Antworten des Servers. Weitere Informationen finden Sie in Sun ONE Web Server 6.1 Administrator’s Guide (http://docs.sun.com/doc/817-6247-10).
Problembehebung	Ziehen Sie den Sun One Web Server 6.1 Installation and Migration Guide Guide (http://docs.sun.com/doc/819-0131) zurate.
Konfigurationsdateiverzeichnis	<INSTALL_DIR>/Web Server>/https-instanz-name/config
Debug-Modus	Die folgenden Optionen stehen zur Verf�gung: Die Protokollausgabe kann zu Diagnose- und Problembehebungszwecken verwendet werden. Sie k�nnen f�r das loglevel-Attribut des LOG-Elements in der Datei /server_root/https-instanzenname/config/server.xml folgende Werte festlegen: INFO, GENAU, GENAUER oder SEHR GENAU. Diese Werte geben die Genauigkeit der Debug-Meldungen an, wobei SEHR GENAU f�r die maximale Ausf�hrlichkeit steht. Weitere Informationen zum LOG-Element erhalten Sie in der Sun ONE Web Server Administrator’s Configuration File Reference (http://docs.sun.com/doc/817-6248-10). Es kann eine Debug-Flagge aktiviert werden, um den Server-Webcontainer im Debug-Modus mit der Bereitschaft f�r den Anhang mit einem Java Platform Debugger Architecture-Debugger (JPDA) zu starten. Setzen Sie hierf�r den Wert f�r die jvm.debug-Flagge des JAVA-Attributs in der Datei/instance_root/https-servername/config/server.xml auf true. Weitere Informationen finden Sie in der Sun ONE Web Server Administrator’s Configuration File Reference (http://docs.sun.com/doc/817-6248-10). Das Plugin f�r Sun Java System Studio 5, Standard Edition erm�glicht das Debugging von Webanwendungen. Weitere Informationen finden Sie im Sun ONE Web Server Programmer’s Guide to Web Applications (http://docs.sun.com/doc/817-6251-10).

Delegated Administrator-Tools zur Problembehebung

Tabelle 11-15 Delegated Administrator-Tools zur Problembehebung
Aspekt	Details
Protokolldateien	Installationsprotokollverzeichnis: IscliCfgDefaults.properties Installer.properties statefile.properties
Verzeichnis der ausf�hrbaren Datei	[INSTALL_DIR]\DelegatedAdmin\lib
Problembehebung	Weitere Informationen finden Sie im Delegated Administrator Guide (http://docs.sun.com/doc/819-0114-10).

High Availability Session Store-Tools zur Problembehebung

Tabelle 11-16 High Availability Session Store-Tools zur Problembehebung
Aspekt	Details
Protokolldateien	HADB.properties mgt.cfg
Verzeichnis der ausf�hrbaren Datei	[INSTALL_DIR]\Hadb\4.4.1-7\lib
Problembehebung	Weitere Informationen finden Sie im High Availability Session Store Administrator’s Guide (http://docs.sun.com/doc/819-0216).

Zus�tzliche Informationen zur Problembehebung

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

Zur�ck Inhalt Index Weiter
Sun Java Enterprise System Installationshandbuch f�r Microsoft Windows