Instale adaptadores de recursos em seus aplicativos para que eles possam acessar
origens de dados externas.
Antes de Iniciar
A especificação JCA Versão 1.6 inclui suporte para anotações Java em módulos RAR. Para obter informações adicionais
sobre suporte a anotações, consulte o tópico Suporte de JCA 1.6 para Anotações
em Módulos RAR.
Procedimento
- Monte um aplicativo contendo módulos RAR.
Consulte o tópico Montando aplicativos para obter mais informações.
- Instale o aplicativo. Siga as etapas no tópico
Instalando um novo aplicativo.
Na
etapa Mapear Módulos para Servidores, especifique servidores ou clusters
de destino para cada arquivo RAR. Certifique-se de mapear todos os outros módulos que
utilizam os adaptadores de recursos definidos nos módulos RAR para os mesmos destinos. Alem disso, especifique os
serviços da Web como destinos que servem como roteadores para as solicitações para
esse aplicativo. O arquivo de configuração do plug-in (plugin-cfg.xml)
para cada servidor da Web é gerado com base nos aplicativos que são roteados
por meio dele.
Na etapa de instalação de um aplicativo Metadados para Módulos,
é possível configurar ou desconfigurar o sinalizador de metadados completos,
conforme discutido no tópico Suporte à JCA 1.6, para obter anotações em
módulos RAR.
Nota: Ao instalar um arquivo RAR em um servidor, o
servidor de aplicativos procura o manifesto (MANIFEST.MF) do módulo
conector. O servidor de aplicativos procura primeiramente o arquivo
connectorModule.jar do arquivo RAR
e carrega o manifesto a partir do arquivo
connectorModule.jar.
Se a entrada do caminho de classe estiver no manifesto a partir do arquivo
connectorModule.jar,
o RAR usará esse caminho de classe.
Para garantir que o módulo conector
instalado localize as classes e os recursos necessários, verifique a configuração
do Caminho de Classe do RAR usando o console administrativo. Para obter informações
adicionais sobre como verificar essa configuração, consulte os tópicos Configurações do
Adaptador de Recursos e Configurações do Adaptador de Recursos Relacional do WebSphere.
- Clique em Concluir > Salvar para salvar as mudanças.
- Crie connection factories para o novo aplicativo instalado.
Consulte o tópico Configurando Factories de Conexão de Adaptadores de
Recursos nos Aplicativos para visualizar as etapas de conclusão desta etapa.
Resultados
Nota: Uma biblioteca nativa específica pode ser carregada apenas uma vez para cada instância da JVM (Java™ virtual machine). Como cada aplicativo possui seu próprio carregador de classes, aplicativos separados com arquivos RAR integrados não podem ambos usarem a mesma biblioteca nativa. O segundo aplicativo recebe uma exceção quando tenta carregar
a biblioteca.
Se algum aplicativo implementado no servidor de aplicativos usar um arquivo RAR incorporado que inclua elementos do caminho nativo, então, você deve
sempre assegurar que o servidor de aplicativos seja encerrado de forma limpa, sem
nenhuma transação pendente. Se o servidor de aplicativos não for encerrado de forma limpa,
ele executará a recuperação na nova inicialização do servidor e carregará os
arquivos RAR e as bibliotecas nativas requeridos.
Na conclusão da recuperação, não tente
nenhum trabalho relacionado a aplicativos. Encerre o servidor e inicie-o novamente. Nenhuma
outra recuperação será tentada pelo servidor de aplicativos nessa nova inicialização e o
processamento normal do aplicativo poderá prosseguir.