Use essa tarefa para ativar os adaptadores locais otimizados para usar o suporte de alta disponibilidade.
Antes de Iniciar
O adaptador de recurso local
otimizado participa no suporte de alta disponibilidade do WebSphere Application Server, que fornece a possibilidade de especificar um nome JNDI de connection
factory alternativo nas propriedades customizadas do conjunto de connection factory.
Importante: Para que o suporte de alta disponibilidade funcione corretamente, o nome de registro de recurso
deve ser especificado na conexão gerenciada usando o atributos de Nome de Registro do
connection factory para os connection factories de recursos principal e alternativo. Usar o método setRegisterName()
evita que o recurso alternativo obtenha o controle.
Para usar o suporte de alta disponibilidade de adaptadores
locais otimizados, conclua as seguintes etapas.
Procedimento
- Inclua a propriedade, alternateResourceJNDIName, nas propriedades do conjunto de conexões
para um connection factory. Especifique um nome JNDI do
connection factory do recurso alternativo.
Por exemplo,
se seu JNDI primário for eis/ola e você desejar tornar eis/ola_backup o
alternativo, configure a propriedade alternateResourceJNDIName como eis/ola_backup e
inclua esta propriedade em uma propriedade do conjunto de conexões na connection factory
eis/ola.
- Certifique-se de que o espaço de endereço externo associado ao nome
de registro do connection factory alternativo esteja disponível para o
failover ocorrer.
O processo de failover de recurso do adaptador local otimizado
é acionado quando o aplicativo faz uma solicitação
getconnection() para um recurso que falha porque o registro de destino
não está disponível. Durante esse processo, o nome do recurso JNDI
alternativo é usado para o getconnection() no lugar. O número de tentativas
com falha antes que o failover é tentado pode ser configurado ao incluir outra
propriedade do connection pool, failurethreshold. Configurar um limite
de 1 significa que depois que uma tentativa única
em obter uma conexão falhar (com Exceção de Recurso),
solicitações subsequentes são roteadas para o connection factory alternativo.
Um failover de evento aciona um processo de enviar solicitações subsequentes
para o recurso alternativo com o nome JNDI e nome de registro alternativo e inicia
um processo de pesquisa onde o gerenciamento de conexão do WebSphere Application Server envia uma solicitação a cada 10 segundos para determinar se o recurso principal está disponível novamente. O gerenciamento de conexão do WebSphere Application Server também pode enviar
uma mensagem para o log servidor WebSphere Application Server, indicando o failover para o alternativo e alternar de volta para o principal. É possível usar a
propriedade failureNotificationActionCode no conjunto de conexão para o
connection factory para selecionar qual notificação é desejada.
O valor padrão 1 indica que as mensagens são enviadas
para o log de tarefas do servidor. Consulte o tópico Roteamento de Recurso
para a origem de dados e connection factory para obter mais informações.
Quando o adaptador de recursos WOLA detectar que o recurso principal está disponível novamente ou que o nome
de registro está ativo, o gerenciamento de conexão do WebSphere Application Server está notificado para que solicitações futuras para o JNDI de recurso principal possam ser roteadas de volta para o connection factory principal. Como há um atraso de 10 segundos entre
as solicitações para verificar o principal, quando o registro principal estiver
ativo novamente, poderá demorar até 10 segundos antes que a alternância ocorra
de volta para o registro principal.
- Reinicie o servidor. Depois de incluir o alternateResourceJNDIName
e qualquer outra propriedade do conjunto de conexões, o servidor deverá
ser reiniciado para que as propriedades entrem em vigor.