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:
- Para instalações do WebSphere Application Server: wxs_install_root/optionalLibraries/ObjectGrid
- Para instalações independentes: diretório wxs_install_root/ObjectGrid/lib
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
- Instale um adaptador de recursos do eXtreme Scale integrado.
Quando o arquivo wxsra.rar é integrado no arquivo EAR
do aplicativo, o adaptador de recursos deve ter acesso às bibliotecas de
tempo de execução do eXtreme Scale.
Para os aplicativos que são executados no WebSphere Application Server, as opções a seguir
e as ações subsequentes ficam disponíveis:
Opção |
Descrição |
Se o eXtreme Scale for
integrado com o nó do WebSphere Application
Server |
Os arquivos de biblioteca de tempo de execução já estão disponíveis no caminho de classe
e nenhuma outra ação é requerida. |
Se o eXtreme Scale não for
integrado com o nó do WebSphere Application
Server |
Você deve incluir o arquivo wsogclient.jar
no caminho de classe wxsra.rar. |
Para os aplicativos que não são executados no WebSphere Application Server, o arquivo da
biblioteca de tempo de execução do cliente, ogclient.jar, ou o arquivo da biblioteca do tempo de execução
do servidor, objectgrid.jar, deve estar
no caminho de classe do arquivo RAR.
- Instale um adaptador de recursos do eXtreme Scale independente.
Ao instalar o arquivo wxsra.rar como um
adaptador de recursos independente, ele deve ter acesso às bibliotecas de tempo de execução do eXtreme Scale.
Para os aplicativos que são executados no WebSphere Application Server, as opções a seguir
e as ações subsequentes ficam disponíveis:
Opção |
Descrição |
Se o eXtreme Scale for
integrado com o nó do WebSphere Application
Server |
Os arquivos de biblioteca de tempo de execução já estão disponíveis no caminho de classe
e nenhuma outra ação é requerida. |
Se o eXtreme Scale não for
integrado com o nó do WebSphere Application
Server |
Você deve incluir o arquivo wsogclient.jar
no caminho de classe wxsra.rar. |
Para os aplicativos que não são executados no WebSphere Application Server, o arquivo da
biblioteca de tempo de execução do cliente, ogclient.jar, ou o arquivo da biblioteca do tempo de execução
do servidor, objectgrid.jar, deve estar
no caminho de classe do arquivo RAR.
- Conceda o acesso ao adaptador de recursos a qualquer classe compartilhada. Todas as classes de plug-in do ObjectGrid e os aplicativos que as usam
devem compartilhar um carregador de classes. Uma vez que o adaptador de recursos é compartilhado
por diversos aplicativos, todas as classes devem ser acessíveis pelo mesmo
carregador de classes. É possível criar esse acesso usando uma biblioteca compartilhada
entre todos os aplicativos que interagem com o adaptador de recursos.
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.