Ressourcenadapter von eXtreme Scale installieren

[Version 8.5 und höher] 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

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.