Abschnitt 6.2.3, Hinzufügen von Benutzeranwendungs-Konfigurationsdateien und JVM-Systemeigenschaften
Abschnitt 6.2.5, Anwenden der freigegebenen Bibliothek für einen neuen Class Loader
Abschnitt 6.2.6, Importieren der eDirectory-Herkunftsverbürgung in den WebSphere-Keystore
Abschnitt 6.2.7, Anwenden der uneingeschränkten Richtliniendateien für das IBM JDK
Abschnitt 6.2.8, Übergeben der preferIPv4Stack-Eigenschaft an die JVM
Zum Konfigurieren einer Datenbank zur Verwendung mit WebSphere müssen Sie einen JDBC-Provider und eine Datenquelle erstellen. Dieser Abschnitt enthält Anweisungen zum Erstellen des Providers und der Datenquelle.
So erstellen Sie einen JDBC-Provider:
Erweitern Sie
links auf der Seite „Integrated Solutions Console“:Erweitern Sie
:Klicken Sie auf
:Erweitern Sie
:Wählen Sie
.Klicken Sie auf die Schaltfläche
.Wählen Sie den
aus (z. B. DB2).Klicken Sie auf
.Geben Sie die JDBC-Klassenpfadinformationen ein.
Klicken Sie auf
.Klicken Sie auf
.Klicken Sie auf den Link
.So erstellen Sie eine Datenquelle:
Erweitern Sie
im linken Seitenbereich.Erweitern Sie
.Klicken Sie auf
.Erweitern Sie
.Wählen Sie
.Klicken Sie auf die Schaltfläche
.Geben Sie den Namen der Datenquelle und den JNDI-Namen ein (z. B. für beide „IDMUADataSource“).
Klicken Sie auf
.Klicken Sie auf
.Wählen Sie den zuvor erstellten JDBC-Provider aus.
Klicken Sie auf
.Geben Sie die erforderlichen Datenbankinformationen für die Datenquelle ein (Datenbankname, Servername, Port, Benutzername und Passwort).
Klicken Sie auf
.Geben Sie Informationen für den Security Alias ein oder behalten Sie die Standardwerte bei.
Klicken Sie auf
.Klicken Sie auf
.Klicken Sie auf
.Wählen Sie Ihre neue Datenquelle aus, indem Sie auf das Kontrollkästchen links neben dem Namen klicken.
Klicken Sie auf die Schaltfläche
und vergewissern Sie sich, dass zurückgegeben wird.Stellen Sie die WAR-Datei mithilfe der WebSphere-Bereitstellungswerkzeuge bereit.
Für eine erfolgreiche WebSphere-Installation sind folgende Schritte erforderlich:
Kopieren Sie die Datei sys-configuration-xmldata.xml aus dem Installationsverzeichnis der Benutzeranwendung in ein Verzeichnis auf dem Computer, der den WebSphere-Server hostet, beispielsweise /UserAppConfigFiles.
Das Installationsverzeichnis der Benutzeranwendung ist das Verzeichnis, in dem Sie die Benutzeranwendung installiert haben.
WICHTIG:Configupdate.sh aktualisiert die lokale Version dieser Datei. Wenn Sie configupdate.sh zukünftig ausführen, müssen Sie die Version von WebSphere für diese Datei aktualisieren, indem Sie sie erneut kopieren. Vorsichtshalber sollten Sie auch Sicherungen aller Versionen dieser Datei erstellen.
Geben Sie den Pfad zur Datei sys-configuration-xmldata.xml in den JVM-Systemeigenschaften an. Melden Sie sich dazu als Admin-Benutzer bei der Administrationskonsole von WebSphere an.
Rufen Sie in der linken Kontrollleiste
auf.Klicken Sie in der Serverliste auf den Servernamen, z. B. „server1“.
Rufen Sie in der Liste der Einstellungen auf der rechten Seite unter
die Option auf.Erweitern Sie den Link und wählen Sie
.Wählen Sie aus der Liste
die Option .Wählen Sie unter der Überschrift
für die JVM-Seite die Option .Klicken Sie auf
, um eine neue JVM-Systemeigenschaft hinzuzufügen.Geben Sie als extend.local.config.dir an.
Geben Sie als
den Namen des Installationsordners (Verzeichnis) ein, den Sie während der Installation angegeben haben.Das Installationsprogramm hat in diesem Ordner die Datei sys-configuration-xmldata.xml erstellt.
Geben Sie unter Pfad zu sys-configuration-xmldata.xml.
eine Beschreibung der Eigenschaft ein, beispielsweiseKlicken Sie auf
, um die Eigenschaft zu speichern.Klicken Sie auf
, um eine weitere neue JVM-Systemeigenschaft hinzuzufügen.Geben Sie als idmuserapp.logging.config.dir an.
Geben Sie als
den Namen des Installationsordners (Verzeichnis) ein, den Sie während der Installation angegeben haben.Geben Sie unter Pfad zu idmuserapp_logging.xml.
eine Beschreibung der Eigenschaft ein, beispielsweiseKlicken Sie auf
, um die Eigenschaft zu speichern.Die Datei idmuserapp-logging.xml wird erst dann erstellt, wenn Sie die Änderungen über permanent gespeichert haben.
HINWEIS:Wenn Sie planen, eine Cluster-Umgebung zu konfigurieren, sollten Sie auch die Workflow-Engine-ID explizit als JVM-Systemeigenschaft angeben. Um die Engine-ID anzugeben, müssen Sie eine Systemeigenschaft namens com.novell.afw.wf.engine-id hinzufügen (indem Sie die Schritte ausführen, die Sie zur Definition anderer JVM-Systemeigenschaften verwendet haben) und jeden beliebigen Wert für die ID angeben.
Wenn Sie WebSphere 7.0 mit Version 4.0.2 des RBPM verwenden, müssen Sie sicherstellen, dass bestimmte JAR-Dateien in dieser Version von RBPM jeweils auf die neueste verfügbare Version aktualisiert wurden. Bei JAR-Dateien, die im Lieferumfang von WebSphere vorhanden sind, treten Klassenladeprobleme auf, wenn Sie keine freigegebene Bibliothek für RBPM konfigurieren. Dadurch wird sichergestellt, dass WebSphere die RBPM-Versionen dieser JAR-Dateien verwendet.
WebSphere-Klassenladeprobleme können als die folgenden Arten von Aufnahmen auftreten:
ClassCastException
ClassNotFoundException
NoClassDefFoundException
UnsatisfiedLinkError
LinkageError
So konfigurieren Sie die gemeinsame Bibliothek:
Klicken Sie im linken Navigationsmenü auf
.Klicken Sie auf
.Klicken Sie auf die Schaltfläche
.Geben Sie einen Namen ein (z. B. „IDMUA Classpath“).
Geben Sie die Liste der erforderlichen JAR-Dateien in das Feld „Klassenpfad“ ein:
antlr.jar
log4j.jar
commons-logging.jar
HINWEIS:Sie müssen diese JAR-Datei von der Apache-Website herunterladen.
xalan.jar
xercesImpl.jar
xsltc.jar
jaxb-impl.jar
IDMselector.jar
Wählen Sie
.Klicken Sie auf
.Klicken Sie auf den Link
.Die freigegebene Bibliothek muss nun auf einen neuen Class Loader angewendet werden.
So wenden Sie die freigegebene Bibliothek auf einen neuen Class Loader an:
Erstellen Sie die freigegebene Bibliothek wie unter Abschnitt 6.2.4, Konfigurieren der freigegebenen Bibliothek beschrieben.
Gehen Sie zu Servername .
HINWEIS:Standardmäßig wird diese Option im Abschnitt
minimiert angezeigt.Klicken Sie auf
, um einen neuen Class Loader zu erstellen, und wählen Sie .Klicken Sie auf
.Wählen Sie
aus.Klicken Sie auf
und wählen Sie die freigegebene Bibliothek aus, die Sie vorher erstellt haben.Klicken Sie auf
.Klicken Sie auf
.Klicken Sie auf
, um die Änderungen in der Hauptkonfiguration zu speichern.Kopieren Sie die eDirectory-Herkunftsverbürgungszertifikate auf den WebSphere-Server.
Bei der Installation der Benutzeranwendung werden die Zertifikate in das Verzeichnis exportiert, in dem Sie die Benutzeranwendung installieren.
Importieren Sie die Zertifikate in den WebSphere-Keystore. Sie können dies mithilfe der WebSphere-Administrationskonsole (Zertifikate mit der WebSphere-Administrationskonsole importieren) oder über die Befehlszeile (Zertifikate über die Befehlszeile importieren) tun.
Melden Sie sich bei der Administrationskonsole von WebSphere als Admin-Benutzer an.
Rufen Sie in der linken Kontrollleiste
auf.Navigieren Sie in der Liste der Einstellungen auf der rechten Seite zu
unter .Wählen Sie
(oder den Verbürgungsspeicher, den Sie verwenden).Wählen Sie rechts unter
die Option aus.Klicken Sie auf
.Geben Sie den Aliasnamen und den vollständigen Pfad zur Zertifikatsdatei ein.
Ändern Sie den Datentyp in der Dropdown-Liste in
.Klicken Sie auf
. Jetzt sollte das Zertifikat in der Liste der Signierzertifikate angezeigt werden.Klicken Sie oben im Bildschirm auf den Link
.Führen Sie in der Befehlszeile auf dem Computer, der den WebSphere-Server hostet, das Keytool aus, um das Zertifikat in den WebSphere-Keystore zu importieren.
HINWEIS:Sie müssen das WebSphere-Keytool ausführen, damit dies funktioniert. Vergewissern Sie sich außerdem, dass der Store-Typ PKCS12 ist.
Das WebSphere-Keytool befindet sich unter/IBM/WebSphere/AppServer/java/bin.
Im Folgenden finden Sie ein Beispiel für einen Keytool-Befehl:
keytool -import -trustcacerts -file servercert.der -alias myserveralias -keystore trust.p12 -storetype PKCS12
Wenn sich auf Ihrem System mehrere trust.p12-Dateien befinden, müssen Sie ggf. den vollständigen Pfad zu der Datei angeben.
In Abschnitt 6.1, Installieren und Konfigurieren der Benutzeranwendungs-WAR, in dem die Installation des RBPM auf WebSphere erklärt wird, wurden die IBM JDK-Richtliniendateien für das IBM JDK des Installationsprogramms angewendet. Diese uneingeschränkten Richtliniendateien müssen auch für jeden WebSphere IBM JDK-Server angewendet werden, auf dem das RBPM ausgeführt wird.
Überprüfen Sie jeden IBM JDK am WebSphere-Server, um sicherzustellen, dass die uneingeschränkten Richtliniendateien angewendet wurden. Ohne diese uneingeschränkten Richtliniendateien tritt beim Starten des RBPM der Fehler Ungültige Schlüsselgröße
auf.
Die Benutzeranwendung verwendet JGroups für die Caching-Implementierung. Bei einigen Konfigurationen erfordert JGroups, dass die preferIPv4Stack-Eigenschaft auf „true“ gesetzt wird, um sicherzustellen, dass die mcast_addr-Bindung erfolgreich ist.
Ohne diese Option tritt möglicherweise der folgende Fehler auf:
[10/1/09 16:11:22:147 EDT] 0000000d UDP W org.jgroups.util.Util createMulticastSocket could not bind to /228.8.8.8 (IPv4 address); make sure your mcast_addr is of the same type as the IP stack (IPv4 or IPv6).
Alternativ könnten Sie auch den folgenden Fehler sehen:
[3/21/12 10:04:32:470 EDT] 00000024 UDP E org.jgroups.protocols.TP down failed sending message to null (131 bytes) java.lang.Exception: dest=/228.8.8.8:45654 (134 bytes) at org.jgroups.protocols.UDP._send(UDP.java:353)
Der Parameter java.net.preferIPv4Stack=true ist eine Systemeigenschaft, die auf dieselbe Weise festgelegt werden kann wie andere Systemeigenschaften, wie z. B. extend.local.config.dir. Anweisungen zum Festlegen von Systemeigenschaften finden Sie in Abschnitt 6.2.3, Hinzufügen von Benutzeranwendungs-Konfigurationsdateien und JVM-Systemeigenschaften.