Instalando um Adaptador de Recursos do eXtreme Scale

[Version 8.5 and later] O adaptador de recursos WebSphere eXtreme Scale é compatível com Java Connector Architecture (JCA) 1.5 e pode ser instalado em um Java 2 Platform, Enterprise Edition (J2EE) 1.4 ou servidor de aplicativos posterior, como o WebSphere Application Server.

Antes de Iniciar

O adaptador de recursos está no arquivo wxsra.rar Resource Adapter Archive (RAR), que está disponível em todas as instalações do eXtreme Scale. O arquivo RAR está nos diretórios a seguir:

O adaptador de recursos é acoplado ao ambiente de tempo de execução eXtreme Scale. Ele requer os arquivos JAR de tempo de execução eXtreme Scale no caminho de classe correto. Em geral, é possível atualizar o ambiente de tempo de execução eXtreme Scale sem atualizar o adaptador de recursos. Atualizar o ambiente de tempo de execução eXtreme Scale também atualiza o ambiente de tempo de execução do adaptador de recursos. O adaptador de recursos suporta a versão 8.5 e até duas versões posteriores do ambiente de tempo de execução eXtreme Scale. As versões mais recentes do adaptador de recursos podem precisar das versões mais recentes do ambiente de tempo de execução eXtreme Scale conforme ficam disponíveis.

O arquivo wxsra.rar requer que um dos arquivos JAR de tempo de execução do cliente eXtreme Scale opere. Para obter detalhes sobre qual arquivo JAR de tempo de execução do cliente é apropriado, consulte Arquivos de Tempo de Execução para Instalação Independente do WebSphere eXtreme Scale e Arquivos de Tempo de Execução para o WebSphere eXtreme Scale Integrado ao WebSphere Application Server, que inclui detalhes sobre os arquivos JAR de tempo de execução disponíveis.

Sobre Esta Tarefa

É possível instalar o adaptador de recursos do eXtreme Scale usando várias opções que permitem cenários de implementação flexíveis. O adaptador de recursos pode ser integrado ao aplicativo Java Platform, Enterprise Edition (Java EE) ou pode ser instalado como um arquivo RAR independente que é compartilhado entre os aplicativos.

A integração do adaptador de recursos com o aplicativo simplifica a implementação, porque os connection factories só são criados com o escopo do aplicativo e não podem ser compartilhados entre os aplicativos. Com o adaptador de recursos integrado no aplicativo, você também pode integrar os objetos de cache e as classes de plug-in do cliente ObjectGrid no aplicativo. Integrar o adaptador de recursos também protege o aplicativo de compartilhar inadvertidamente objetos de cache entre os aplicativos, o que pode resultar em exceções java.lang.ClassCastExceptions.

Ao instalar o arquivo wxsra.rar como um adaptador de recursos independente, é possível criar connection factories do gerenciador de recursos no escopo do nó. Essa opção é útil nas situações a seguir:
  • Quando não for prático integrar o arquivo wxsra.rar no aplicativo
  • Quando a versão do eXtreme Scale não for conhecida no tempo da construção
  • Quando você desejar compartilhar uma conexão do cliente eXtreme Scale com diversos aplicativos
Importante: Em diversas versões do WebSphere Application Server, até a Versão 8.0.2, não é possível instalar o adaptador de recursos eXtreme Scale em um arquivo EAR do aplicativo e o servidor independente simultaneamente. O resultado, quando você usa o arquivo archive corporativo (EAR) que também tem o arquivo RAR instalado, é que o aplicativo presencia uma exceção, como ClassCastException: com.ibm.websphere.xs.ra.XSConnectionFactory incompatível com com.ibm.websphere.xs.ra.XSConnectionFactory. A mensagem de exemplo WebSphere Application Server a seguir e a pilha de chamada para esse erro são exibidas quando um servlet encontra esta exceção:
SRVE0068E: An exception was thrown by one of the service methods of the servlet [ClientServlet]
in application [JTASampleClientEAR]. Exception created : [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)

Procedimento

O que Fazer Depois

Agora que você instalou o adaptador de recursos eXtreme Scale, é possível configurar os connection factories para que os seus aplicativos Java EE possam se conectar a uma grade de dados eXtreme Scale remota.