Use o assistente de atualização resource adapter archive (RAR) para atualizar os arquivos RAR independentes para uma versão mais recente. O servidor de aplicativos utiliza as classes e outros códigos que formam um RAR (resource adapter archive) para suportar os adaptadores de recursos configurados.
Antes de Iniciar
Um adaptador de recursos deve ser instalado no servidor de aplicativos e você deve ter uma nova versão que seja compatível com a versão antiga. É possível criar o arquivo RAR com uma ferramenta de montagem,
ou o fornecedor do adaptador de recursos pode fornecer a nova versão.
Se a nova versão de um arquivo RAR não for compatível com a versão antiga do adaptador de recursos, não será possível fazer uma atualização.
A especificação Java™ Connector Architecture
(JCA) Versão 1.6 inclui suporte para anotações Java em módulos RAR. Para obter mais informações sobre suporte a anotações e metadados, consulte o tópico de suporte a JCA 1.6 para obter anotações em módulos RAR.
Sobre Esta Tarefa
Atualize um arquivo RAR quando você determinar que um adaptador de
recursos, ou um conjunto de adaptadores de recursos, precisa ser atualizado com uma
versão diferente. Diferentes versões de adaptadores de recursos podem incluir
configurações diferentes, de modo que atualizar o adaptador talvez seja benéfico se
você precisar de um determinado conjunto de opções de configuração.
É de sua opção atualizar
o adaptador de recursos para todos os nós em uma célula ou todos os nós
em um cluster. Se alguns de seus nós
forem anteriores à Versão 7.0, a atualização do RAR não será suportada
até esses nós serem migrados para a Versão 7.0. As atualizações dos adaptadores JCA 1.6 são aplicáveis apenas em um nó Versão 9.0.
Se preferir ter mais de uma versão de um adaptador de recursos
ativa em uma determinada Java Virtual
Machine (JVM), o assistente de atualização não fornecerá a opção de criar
outra versão e manter a antiga. Neste caso, você precisa criar
um adaptador de recursos isolado e configurá-lo de forma apropriada. Consulte o tópico sobre como configurar um adaptador de recursos para obter informações adicionais.
Procedimento
- Salve todas as alterações de configuração.
- Faça backup de suas definições de configuração com a ferramenta backupConfig. A ferramenta backupConfig está localizada no diretório app_server_root/bin.
Leia o tópico sobre o comando backupConfig para obter informações adicionais
sobre como usar este comando.
- Sincronize qualquer um dos nós
a serem atualizados.
- Verifique se os agentes de nós estão em execução, se eles estiverem associados ao adaptador de recursos que você está atualizando.
- Pare os servidores que contêm o arquivo RAR atualizado.
Você deve
parar todos os servidores no nó ou cluster ao qual o arquivo RAR
está associado. Consulte o tópico Administrando Aplicativos e seus
Ambientes para obter informações sobre como parar ou iniciar um servidor
de aplicativos.
- Clique em .
- Selecione a caixa de opção próxima ao arquivo RAR a ser atualizado e
clique em Atualizar RAR.
- Especifique o comando de instalação do arquivo RAR e clique em Avançar.
- Se seu arquivo RAR estiver localizado na mesma estação de trabalho do navegador, selecione Sistema de Arquivos Local e procure o arquivo.
- Se seu arquivo RAR estiver localizado na estação de trabalho do servidor na qual o servidor de aplicativos está instalado, selecione Sistema de Arquivos Remoto e especifique o caminho completo para o arquivo.
- Reveja as informações de configuração fornecidas para o arquivo RAR. As seguintes informações são exibidas para o arquivo RAR:
- Nome
- Atual versão do RAR
- Nova versão do RAR
- Escopo
- Quaisquer cópias existentes do adaptador de recursos. Os adaptadores de recursos com um asterisco (*) são cópias do adaptador de recursos e também devem ser atualizados ao mesmo tempo.
Clique em Avançar quando
tiver concluído.
- Opcional: Edite todas as propriedades que foram incluídas pela nova versão do adaptador de recursos. Você também pode editar essas propriedades depois de concluir a atualização.
- Selecione um recurso na lista para editar as novas propriedades. Somente os recursos com novas propriedades são incluídos na lista.
- Edite as propriedades do recurso. Utilize a tabela que é fornecida para configurar os valores para as novas propriedades do recurso selecionado.
- Selecione a caixa de opção Configurar para todos para aplicar
o valor da propriedade a todos os recursos do mesmo tipo.
- Clique no botão Reconfigurar para o Padrão para reconfigurar
todas as propriedades para os valores-padrão que estão definidos no arquivo RAR. Esta reconfiguração de propriedade afeta apenas o recurso selecionado.
- Clique em Avançar.
- Reveja o painel de resumo e clique em Concluir quando estiver satisfeito com as definições de configuração. Quando você clicar em Concluir,
todas as mudanças na configuração serão salvas automaticamente.
Para reverter para uma versão mais antiga do adaptador de recursos, você deve executar o processo de atualização novamente e especificar a versão mais antiga do arquivo RAR.
- Reinicie os servidores que contêm o arquivo RAR atualizado.
O que Fazer Depois
Se você não estiver satisfeito com os resultados e tiver feito backup de sua configuração com a ferramenta backupConfig, use a ferramenta restoreConfig para restaurar sua configuração de backup. Leia o tópico sobre o comando restoreConfig
para obter informações adicionais sobre como usar este comando.