Bevor Sie versuchen, Fehler der Anwendung IBM Telephone Directory Version 5.2 zu beheben, sollten Sie die folgenden Fragen beantworten. Diese Antworten können helfen, häufige Probleme bei der Ausführung der Anwendung zu lösen.
Sollten dennoch Probleme mit der Anwendung auftreten, lesen Sie die folgenden Informationen:
Konfigurationsfehler beheben
Problem | Ursache | Lösung |
Ihre Installation ist mit der folgenden Nachricht gescheitert: ldap_search: Insufficient access. | Sie haben das falsche LDAP-Administratorkennwort eingegeben. | Korrigieren Sie das Kennwort oder setzen Sie es zurück. |
Ihr Setup-Script ist mit der folgenden Nachricht gescheitert: ldap_search: No such object Error 32 verifying LDAP settings | Möglicherweise gibt es auf dem LDAP-Server keinen Basis-DN. | Es könnte ein Fehler bei der Basiskonfiguration des LDAP-Servers vorliegen. |
Authentifizierungsfehler beheben
Problem | Ursache | Lösung |
Die Anmeldung scheitert. | Benutzer-IDs und Kennwörter der Anwendung müssen Zeichen enthalten, die der vom HTTP Server verwendeten Job-CCSID entsprechen. Andernfalls ist keine Authentifizierung möglich. | Stellen Sie sicher, dass die eingegebenen Zeichen der vom HTTP Server verwendeten Job-CCSID entsprechen. Sie können die Job-CCSID für den HTTP Server ermitteln, indem Sie in einer OS/400-Befehlszeile WRKACTJOB eingeben und Display job definition attributes auswählen. Die CCSID von HTTP Server wird von der Anweisung defaultFSCCSID bestimmt. Weitere Informationen hierzu finden Sie im Artikel Bemerkungen und Einschränkungen. |
Der URL funktioniert nicht oder die Anwendung wird nicht angezeigt. | Wenn Sie die Anwendung IBM Welcome Page nicht gestartet haben, funktioniert der URL nicht (http://Name.Ihres.Servers:Port/ibm-bizApps/welcome-home.do oder http://Name.Ihres.Servers:Port/ibm-bizApps/welcome-admin.do). Probleme treten auch auf, wenn Sie die Anwendung IBM Welcome Page gestartet haben, nicht aber die Anwendung IBM Telephone Directory. Wenn die Anwendung IBM Telephone Directory nicht aktiv ist, gibt es in der Anwendung Welcome Page keine Links zu IBM Telephone Directory. | Starten Sie die Anwendung IBM Welcome Page und die Anwendung IBM Telephone Directory. |
Anforderungen an die Anwendung scheitern. | Falls Sie für die Referenzierung der Anwendung IBM Telephone Directory Version 5.2 den internen HTTP Server von WebSphere Application Server verwenden, schlagen bestimmte Anforderungen an die Anwendung fehl. | Sie müssen für die Referenzierung der Anwendung den zugeordneten IBM HTTP Server verwenden. Während der Erstellung einer neuen Anwendungsserverinstanz konfiguriert die Anwendung IBM Telephone Directory die für sie erforderlichen Sicherheitsanweisungen für die LDAP-Serverauthentifizierung. Der interne HTTP Server von WebSphere Application Server wird nicht mit den notwendigen Sicherheitsanweisungen konfiguriert, so dass bei Verwendung des internen HTTP Servers bestimmte Anforderungen an die Anwendung scheitern. Weitere Informationen hierzu finden Sie im Artikel Interaktion mit IBM HTTP Server. |
Verwendungsfehler beheben
Problem | Ursache | Lösung |
Es gibt keinen Link zur Anwendung. | Mit dem URL http://Name.Ihres.Servers:Port/ibm-bizApps/welcome/home.do wird der Eingangspunkt zu IBM Business Solutions und damit zur Anwendung IBM Telephone Directory Version 5.2 aufgerufen. | Wenn der Link zur Anwendung IBM Telephone Directory Version 5.2 fehlt, überprüfen Sie, ob sowohl die Anwendung IBM Welcome Page als auch die Anwendung IBM Telephone Directory gestartet ist. |
Welche Benutzer-ID muss für die Verwaltung verwendet werden? | Möglicherweise sind Sie unsicher, welche Benutzer-ID Sie eingeben müssen, um von der Anwendung authentifiziert zu werden, wenn Sie (als Administrator) in einer Umgebung mit geschlossener Registrierung einen Benutzereintrag aktualisieren oder registrieren müssen. | Die Standardbenutzer-ID ist Administrator und das Kennwort wurde während der Installation festgelegt. Geben Sie nicht Ihre persönliche Benutzer-ID mit Kennwort ein. Die IDs von Anwendungsbenutzern können von jedem eingesehen werden. Falls Sie die Benutzer-ID für einen Eintrag nicht kennen, verwenden Sie die Suchseite der Anwendung, um den Eintrag zu finden. Die Benutzer-ID wird unter dem Bild angezeigt. |
Bei einer Suche oder Registrierung tritt ein interner Serverfehler auf. | Wenn bei dem Versuch, nach einem Benutzer zu suchen oder einen Benutzer zu registrieren, ein interner Serverfehler angezeigt wird (HTTP 500 - Internal Server Error), kann dies darauf hinweisen, dass Ihre Konfigurationsdateien beschädigt wurden. Die Anwendung IBM Telephone Directory Version 5.2 kann möglicherweise nicht die zugehörigen Konfigurationsdateien für die Anwendung finden. | Installieren Sie die Anwendung IBM Telephone Directory Version 5.2 erneut. |
Während der Suche tritt ein Systemfehler auf. | Wenn Sie bei der Suche nach einem Benutzer die Fehlernachricht A system error has occurred! Try again later empfangen, bedeutet dies in der Regel, dass Ihr LDAP-Server nicht gestartet ist. | Starten Sie den LDAP-Server und versuchen Sie es erneut. |
Während der Registrierung wird ein Operationsfehler angezeigt. | Wenn Sie bei der Registrierung eines Benutzers die Fehlernachricht ERROR: Operation failed! Contact your IBM Telephone Directory application administrator empfangen, bedeutet dies in der Regel, dass Ihr LDAP-Server nicht gestartet ist. | Starten Sie den LDAP-Server und versuchen Sie es erneut. |
Beim Aktualisieren oder Löschen von Einträgen wird ein Operationsfehler angezeigt. | Wenn Sie beim Aktualisieren oder Löschen eines Profils die Fehlernachricht ERROR: Operation failed! Contact your IBM Telephone Directory application administrator empfangen, sind unter Umständen nicht die richtigen Anweisungen in HTTP Server konfiguriert. Dieses Problem macht sich dadurch bemerkbar, dass vor der Ausführung von Änderungen Ihre Benutzer-ID und Ihr Kennwort nicht im Authentifizierungsdialog eingegeben werden. | Fügen Sie die fehlenden LDAP-Konfigurationsanweisungen manuell zur Konfiguration von HTTP Server hinzu oder installieren Sie die Anwendung IBM Telephone Directory Version 5.2 erneut. |
Ein Objekt wird nicht gefunden. | Wenn Sie in der Anwendung IBM Telephone Directory einen Fehler (404) empfangen, weil ein Objekt nicht gefunden wurde, ist möglicherweise Ihre Datei plugin-cfg.xml beschädigt. | Führen Sie die folgenden Schritte aus, um diese Datei zu überprüfen und ggf. zu korrigieren:
|
Fehler durch Überschreitung der maximalen Profilanzahl | IBM Telephone Directory ist ein freies Programm für maximal 1000 Benutzereinträge. Der LDAP-Verzeichnisserver muss so konfiguriert sein, dass die Anzahl der zulässigen Suchbegriffe unter dem Basis-DN von IBM Telephone Directory bei 1000 liegt oder größer ist. | Weitere Informationen zur Begrenzung auf 1000 Benutzereinträge finden Sie im Artikel Bemerkungen und Einschränkungen. |
Einige Werte wurden nicht gespeichert. | Falls Sie nicht berechtigt sind, ein bestimmtes Feld hinzuzufügen, zu ändern oder zu entfernen, und dennoch versuchen, eine solche Operation auszuführen, empfangen Sie die Nachricht, dass einige Werte nicht gespeichert wurden, weil das Verzeichnis Ihnen nicht erlaubt, die Werte zu Ihrem Profil hinzuzufügen. Sie werden aufgefordert, sich an den Anwendungsadministrator zu wenden. | Der Empfang dieser Fehlernachricht bedeutet, dass die Anwendung IBM Telephone Directory Version 5.2 für 'Authentifizierung erforderlich' konfiguriert ist. |
Sonderzeichen (wie ", &, < oder >) werden nicht richtig verarbeitet. | Die Anwendung IBM Telephone Directory Version 5.2 wurde so geschrieben, dass sie alle Zeichen richtig verarbeiten kann. Dazu gehören auch Zeichen, die in HTML-, JavaScript- und LDAP-Filtern sowie Attributwerten als Sonderzeichen (oder Metazeichen) gelten. | Es ist getestet und erwiesen, dass die Anwendung IBM Telephone Directory Sonderzeichen für LDAP-Attributwerte ordnungsgemäß nach Standard RFC 2253 verarbeitet. Dieser Standard wird jedoch vom Verzeichnisserver nicht voll unterstützt. Tritt ein solcher Fehler auf, können Sie nichts anderes tun, als die entsprechenden Zeichen zu vermeiden. Anführungszeichen (") sind ein Beispiel für dieses Problem. Der Standard RFC 2253 gibt an, dass dem Zeichen ein umgekehrter Schrägstrich (\) vorangestellt werden muss, wenn es in einem LDAP-Attributwert als Literal akzeptiert werden soll. Da die aktuelle Version der Directory Services (LDAP) keine vollständige Unterstützung für RFC 2253 bietet, speichert der Server sowohl den umgekehrten Schrägstrich als auch das Anführungszeichen. |
Fehlerprotokollierung und Debug
Fehlerprotokolle
Für den Anwendungsserver gibt es zahlreiche Protokolle, in die Nachrichten geschrieben werden. Systemnachrichten, die von jeder Anwendungsserverkomponente oder Anwendung geschrieben werden können,
werden in allgemeine Protokolle wie die JVM-Protokolle (Java Virtual Machine) und die IBM Serviceprotokolle geschrieben. Andere Protokolle sind sehr spezifisch und einer bestimmten Komponente oder Aktivität vorbehalten. Das HTTP-Server-Plug-in verwaltet beispielsweise ein komponentenspezifisches Plug-in-Protokoll.
Generelle Protokolle wie die JVM-Protokolle und IBM Serviceprotokolle werden verwendet, um die Vitalität des Anwendungsservers zu überwachen und die Fehlerbehebung zu unterstützen. Die Fehlerbehebung für bestimmte Komponenten kann eine zusätzliche Protokollanalyse erfordern, für die komponenten- oder produktspezifische Protokolldateien herangezogen werden.
Trace-Anweisungen
Für das Debug von Problemen können Anweisungen für den Anwendungs-Trace aktiviert werden. Treten Fehler wiederholt auf, müssen Sie
den IBM Kundendienst verständigen.
Der Kundendienst wird Sie wahrscheinlich um eine Kopie der Trace-Ausgabe der Anwendung bitten. Zum Aktivieren von Trace-Anweisungen müssen Sie eine Zeile zur Konfigurationsdatei der Anwendung hinzufügen und die Anwendung dann
neu starten.
Beim Start liest die Anwendung die neue Konfiguration. Dabei wird die Anweisung für den Anwendungs-Trace aktiviert. Nach dieser Aktivierung werden Trace-Anweisungen in die Datei SystemOut.log des Servers geschrieben.