Der Ressourcenadapter von WebSphere eXtreme Scale
ist mit Java Connector Architecture (JCA)
1.5 kompatibel und kann in einem J2EE-Anwendungsserver (Java 2
Platform, Enterprise Edition) der Version 1.4 oder höher wie WebSphere Application
Server installiert werden.
Vorbereitende Schritte
Der Ressourcenadapter ist in der RAR-Datei (Ressourcenadapterarchiv)
wxsra.rar
enthalten, die in allen Installationen von
eXtreme Scale verfügbar ist. Die RAR-Datei befindet sich in den folgenden Verzeichnissen:
Der Ressourcenadapter
ist mit der Laufzeitumgebung von eXtreme Scale gekoppelt.
Er setzt die JAR-Dateien der Laufzeitumgebung von eXtreme Scale
im richtigen Klassenpfad voraus.
Im Allgemeinen können Sie ein Upgrade der Laufzeitumgebung von
eXtreme Scale durchführen, ohne den Ressourcenadapter zu aktualisieren.
Bei einem Upgrade der Laufzeitumgebung von eXtreme Scale
wird auch ein Upgrade der Laufzeitumgebung des Ressourcenadapters durchgeführt.
Der Ressourcenadapter unterstützt Version 8.5 und bis zu zwei neuere Versionen der Laufzeitumgebung von
eXtreme Scale.
Neuere Versionen des Ressourcenadapters können neuere Versionen der Laufzeitumgebung von
eXtreme Scale erfordern, sobald diese verfügbar sind
Die Datei
wxsra.rar erfordert eine der JAR-Dateien für die Clientlaufzeitumgebung von
eXtreme Scale, um verwendet werden zu können.
Einzelheiten zur geeigneten JAR-Datei für die Clientlaufzeitumgebung
finden Sie in den Abschnitten Laufzeitdateien für eine eigenständige Installation von WebSphere eXtreme Scale und Laufzeitdateien für eine integrierte Installation von WebSphere eXtreme Scale in WebSphere Application Server, die Details zu den verfügbaren JAR-Dateien für die Laufzeitumgebungen enthalten.
Informationen zu diesem Vorgang
Sie können den Ressourcenadapter von eXtreme Scale über verschiedene Optionen
installieren, die flexible Implementierungsszenarien unterstützen.
Der Ressourcenadapter kann mit der Java-EE-Anwendung (Java Platform, Enterprise Edition) eingebettet oder als eigenständige
RAR-Datei installiert werden, die von mehreren Anwendungen gemeinsam genutzt wird.
Das Einbetten des Ressourcenadapters mit der Anwendung vereinfacht die Implementierung, weil
Verbindungsfactorys nur im Geltungsbereich der Anwendung erstellt werden und nicht von mehreren Anwendungen gemeinsam genutzt werden können.
Mit dem in die Anwendung eingebetteten Ressourcenadapter
können Sie auch die Cacheobjekte und die
ObjectGrid-Client-Plug-in-Klassen in die Anwendung einbetten. Das Einbetten
des Ressourcenadapters schützt die Anwendung auch vor einer versehentlichen gemeinsamen Nutzung von Cacheobjekten durch mehrere Anwendungen, was
zu Ausnahmen des Typs java.lang.ClassCastExceptions führen kann.
Wenn Sie die
Datei
wxsra.rar als eigenständigen Ressourcenadapter
installieren, können Verbindungsfactorys des Ressourcenmanagers auf Knotenebene erstellt werden.
Diese Option ist in den folgenden Situationen hilfreich:
- Es ist nicht zweckmäßig, die Datei wxsra.rar in die Anwendung einzubetten.
- Die Version von eXtreme Scale ist zur Buildzeit nicht bekannt.
- Sie möchten, dass eine Clientverbindung von eXtreme Scale von mehrere Anwendungen gemeinsam genutzt wird.
Wichtig: In mehreren Versionen von
WebSphere Application
Server bis hin zu Version 8.0.2
kann der Ressourcenadapter von
eXtreme Scale nicht gleichzeitig in einer
Anwendungs-EAR-Datei und in einem eigenständigen Server installiert werden.
Deshalb tritt bei der Verwendung der EAR-Datei, in der auch die RAR-Datei installiert ist,
in der Anwendung eine Ausnahme ein, wie z. B.
ClassCastException: com.ibm.websphere.xs.ra.XSConnectionFactory
incompatible with com.ibm.websphere.xs.ra.XSConnectionFactory.
Der folgende Beispielnachrichten- und Beispielaufrufstack von
WebSphere Application
Server
zu diesem Fehler wird angezeigt, wenn diese Ausnahme in einem Servlet auftritt:
SRVE0068E: Es wurde eine nicht abgefangene Ausnahme in einer der
Servicemethoden des Servlets [ClientServlet] in der Anwendung [JTASampleClientEAR] erstellt.
Erstellte Ausnahme: [java.lang.ClassCastException:
com.ibm.websphere.xs.ra.XSConnectionFactory incompatible with com.ibm.websphere.xs.ra.XSConnectionFactory
at com.ibm.websphere.xs.sample.jtasample.WXSClientServlet.connectClient(WXSClientServlet.java:484)
at com.ibm.websphere.xs.sample.jtasample.WXSClientServlet.doGet(WXSClientServlet.java:200)
at javax.servlet.http.HttpServlet.service(HttpServlet.java:575)
at javax.servlet.http.HttpServlet.service(HttpServlet.java:668)
at com.ibm.ws.webcontainer.servlet.ServletWrapper.service(ServletWrapper.java:1214)
at com.ibm.ws.webcontainer.servlet.ServletWrapper.handleRequest(ServletWrapper.java:774)
at com.ibm.ws.webcontainer.servlet.ServletWrapper.handleRequest(ServletWrapper.java:456)
Vorgehensweise
- Installieren Sie einen eingebetteten Ressourcenadapter von eXtreme Scale.
Wenn die Datei wxsra.rar in die EAR-Datei der Anwendung eingebettet ist,
muss der Ressourcenadapter Zugriff auf die Laufzeitbibliotheken von
eXtreme Scale haben.
Für Anwendungen, die in WebSphere Application Server ausgeführt werden,
sind die folgenden Optionen und Folgeaktionen verfügbar:
Option |
Bezeichnung |
Wenn eXtreme Scale mit dem Knoten von WebSphere Application
Server integriert ist |
Die Laufzeitbibliotheksdateien sind bereits im Systemklassenpfad verfügbar, und es ist keine weitere Aktion erforderlich. |
Wenn eXtreme Scale nicht mit dem Knoten von WebSphere Application
Server integriert ist |
Sie müssen die Datei wsogclient.jar in den Klassenpfad von
der Datei wxsra.rar einfügen. |
Für Anwendungen, die nicht in WebSphere Application Server ausgeführt werden,
muss die Laufzeitbibliotheksdatei des Clients, ogclient.jar, oder die Laufzeitbibliotheksdatei des Servers,
objectgrid.jar, im Klassenpfad der RAR-Datei enthalten sein.
- Installieren Sie einen eigenständigen Ressourcenadapter von eXtreme Scale.
Wenn Sie die Datei wxsra.rar als eigenständigen Ressourcenadapter
installieren, muss dieser Zugriff auf die Laufzeitbibliotheken von
eXtreme Scale haben.
Für Anwendungen, die in WebSphere Application Server ausgeführt werden,
sind die folgenden Optionen und Folgeaktionen verfügbar:
Option |
Bezeichnung |
Wenn eXtreme Scale mit dem Knoten von WebSphere Application
Server integriert ist |
Die Laufzeitbibliotheksdateien sind bereits im Systemklassenpfad verfügbar, und es ist keine weitere Aktion erforderlich. |
Wenn eXtreme Scale nicht mit dem Knoten von WebSphere Application
Server integriert ist |
Sie müssen die Datei wsogclient.jar in den Klassenpfad von
der Datei wxsra.rar einfügen. |
Für Anwendungen, die nicht in WebSphere Application Server ausgeführt werden,
muss die Laufzeitbibliotheksdatei des Clients, ogclient.jar, oder die Laufzeitbibliotheksdatei des Servers,
objectgrid.jar, im Klassenpfad der RAR-Datei enthalten sein.
- Erteilen Sie dem Ressourcenadapter Zugriff auf alle gemeinsam genutzten Klassen. Alle ObjectGrid-Plug-in-Klassen und -Anwendungen, die diese Klassen verwenden, müssen ein gemeinsames Klassenladeprogramm verwenden.
Da der Ressourcenadapter von mehreren Anwendungen gemeinsam genutzt wird, müssen alle Klassen über dasselbe Klassenladeprogramm zugänglich sein.
Sie können diesen Zugriff erstellen, indem Sie eine gemeinsam genutzte Bibliothek für alle Anwendungen verwenden,
die mit dem Ressourcenadapter interagieren.
Nächste Schritte
Nachdem Sie nun den Ressourcenadapter von
eXtreme Scale installiert haben,
können Sie Verbindungsfactorys konfigurieren, damit Ihre Java-EE-Anwendungen
eine Verbindung zu einem fernen Datengrid von
eXtreme Scale herstellen können.