Fehlerbehebung bei dem WebSphere Application Server, der als Host für Cognos dient

Wenn Probleme beim Implementieren oder Konfigurieren der IBM® WebSphere Application Server-Instanz auftreten, die als Host für den IBM Cognos-Server dient, verwenden Sie die folgenden Informationen, um den Fehler zu beheben.

WAS-Probleme und -Lösungen

In Tabelle 1 werden Probleme aufgelistet, die bei WebSphere Application Server auftreten können. Außerdem finden Sie dort entsprechende Lösungsvorschläge.

Tabelle 1. Mögliche Probleme mit WebSphere Application Server, der Cognos Business Intelligence hostet, und Lösungsvorschläge
Problem Lösung

Sie müssen WebSphere Application Server stoppen (oder erneut starten).

Warten Sie jedes Mal, wenn Sie WebSphere Application Server stoppen (oder erneut starten) müssen, vor dem Neustart mindestens eine ganze Minute, um sicherzustellen, dass alle Cognos-Prozesse, die auf diesem Server gehostet werden, vollständig gestoppt wurden:
  • IBM AIX oder Linux: Prozesse cgsServer.sh und CAM_LPSvr
  • Microsoft Windows: Prozesse cgsLauncher.exe und CAM_LPSvr

Die Task zum Einbinden des Cognos-Knotens in den Deployment Manager ist mit einer SOAP-Connector-Ausnahme fehlgeschlagen, da der angegebene Host und der Port möglicherweise nicht erreicht werden können:

Cannot create a SOAP connector to connect to host servername at port xxx.

Das Problem weist darauf hin, dass der Server, der dem Deployment Manager als Host dient, während der Task zum Einbinden nicht verfügbar war. Gehen Sie wie folgt vor, um das Problem zu lösen:

  1. Überprüfen Sie, ob der Deployment Manager ausgeführt wird.
  2. Überprüfen Sie, ob Sie den richtigen Port für den SOAP-Connector des Deployment Managers bei der Ausführung des Befehls "addNode" verwendet haben. Sie können die Porteinstellung für den SOAP-Connector in der folgenden Datei überprüfen: /opt/IBM/Websphere/AppServer/profiles/Dmgr01/logs/AboutThisProfile.txt
  3. Überprüfen Sie, ob beide Server entweder im DNS registriert sind oder jeweils in der Datei "/etc/hosts" des anderen Servers angegeben sind. Stellen Sie unter Linux sicher, dass der angegebene Hostname derzeit auf dem Deployment Manager gültig ist.
  4. Binden Sie den Cognos-Knoten ein.

Die folgende Ausnahmebedingung wird im WebSphere-Serverprotokoll SystemOut.log angezeigt:

com.ibm.ws.webcontainer.webapp.WebApp logServletError SRVE0293E: [Servletfehler]-[CMServlet]: java.security.AccessControlException: Zugriff verweigert (java.lang.RuntimePermission createClassLoader)
Diese Nachricht weist auf ein Sicherheitsproblem hin, aufgrund dessen die Benutzerüberprüfung fehlschlägt. Sie können diesen Fehler beheben, indem Sie die Sicherheit von Java 2 im Deployment Manager wie folgt inaktivieren:
  1. Melden Sie sich bei der Integrated Solutions Console als WebSphere-Administrator an.
  2. Klicken Sie auf Sicherheit > Globale Sicherheit.
  3. Überprüfen Sie den Bereich "Java 2 security" (Java 2-Sicherheit) und heben Sie die Auswahl der Option Use Java 2 security to restrict application access to local resources (Java 2-Sicherheit zur Begrenzung des Anwendungszugriffs auf lokale Ressourcen) auf.
  4. Klicken Sie auf Übernehmen und anschließend auf OK.
  5. Speichern Sie die Änderung in der Masterkonfiguration, indem Sie im Feld "Nachrichten" auf Speichern klicken.

Die folgende Ausnahmebedingung wird im WebSphere-Serverprotokoll SystemOut.log angezeigt:

Cannot parse URL java.net.MalformedURLException: no protocol (URL java.net.MalformedURLException kann nicht geparst werden: kein Protokoll)

Überprüfen Sie, ob der Wert von cogroot.link mit dem Installationspfad des Cognos BI-Servers übereinstimmt. Wenn der installierte Pfad abweicht (weil Sie z. B. die Dateien verschoben oder das Verzeichnis umbenannt haben), können Sie die Cognos BI-Anwendungsdatei so aktualisieren, dass sie den richtigen Pfad referenziert. Anweisungen hierzu finden Sie unter Manually changing the installation directory name affects installations running under an application server (Manuelles Ändern des Installationsverzeichnisnamens beeinflusst Installationen, die auf einem Anwendungsserver ausgeführt werden) im Cognos Information Center.

Die folgende Ausnahmebedingung wird im WebSphere-Serverprotokoll SystemOut.log angezeigt:

java.lang.UnsatisfiedLinkError: JCAM_Crypto_JNI (Not found in java.library.path) (java.lang.UnsatisfiedLinkError: JCAM_Crypto_JNI (Nicht in java.library.path gefunden)

Überprüfen Sie die JVM-Umgebungsvariablen, um sicherzustellen, dass sie die Position der JVM-Umgebung (Java Virtual Machine) und des Bibliothekspfades richtig angeben. Wenn die Variablen falsch sind, können Sie sie korrigieren. Anweisungen hierzu finden Sie unter Set environment variables (Umgebungsvariablen festlegen) im Cognos Information Center.

Die folgende Ausnahmebedingung wird im WebSphere-Serverprotokoll SystemOut.log angezeigt:

A WebGroup/Virtual Host to handle p2pd/servlet/gc has not been defined. (Es wurde kein WebGroup/Virtual Host für die Verarbeitung von p2pd/servlet/gc definiert.)

Überprüfen Sie die Einstellungen für den virtuellen Host im Deployment Manager und stellen Sie sicher, dass der Cognos Server-Port enthalten ist. Weitere Informationen hierzu und eine Lösungsstrategie finden Sie im folgenden technischen Hinweis: SRVE0255E: A WebGroup/Virtual Host to handle /p2pd/servlet/dispatch has not been defined.

Unter Linux stoppt der Cognos WebSphere Application Server kurz nach dem Start.

Zusatzinformation: Überprüfen Sie die Fehler und Stopps in der SystemOut-Protokolldatei /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/logs/cognos_server/SystemOut.log.
WSVR0103E: An error occurred destroying com.ibm.ws.webservices.admin.component.WebServicesAdminComponentImpl@5fd85fd8java.lang.IllegalStateException: The service has been unregistered

Fügen Sie diese Variable zur JVM-Umgebungsvariable hinzu:

  1. Melden Sie sich an der WebSphere Application Server-Administrationskonsole des Cognos-Servers an.
  2. Klicken Sie auf Server > Servertypen > WebSphere-Anwendungsserver.
  3. Klicken Sie auf den "cognos_server"-Link.
  4. Klicken Sie auf JAVA und anschließend auf Prozessverwaltung > Prozessdefinition > Umgebungseinträge.
  5. Klicken Sie auf Neu, um den folgenden Eintrag hinzuzufügen:
    LD_PRELOAD = /usr/lib64/libfreebl3.so