Este tópico descreve os procedimentos de resolução de problemas e recuperação para
falhas durante a renomeação online.
A UI de status de renomeação de servidor pesquisa os aplicativos para seus status de
renomeação individuais. Se alguma renomeação de aplicativo falhar, a renomeação de servidor
geral não será concluída. Se encontrar uma falha, a primeira coisa que você deve fazer é
verificar os logs de Jazz
Team Server e do aplicativo
para ver o que houve de errado. Aqui está uma lista dos erros comuns e de como
corrigi-los.
A UI Indica que uma Renomeação não Foi Iniciada
Depois de executar
importURLMappings, você visualiza /serverRenameStatus e
isso indica que uma renomeação de servidor não foi iniciada.
- Consulte o repotools-jts_importURLMappings.log.
Verifique se o comando foi bem-sucedido.
- Pare o Jazz
Team Server.
- Execute repotools-jts -exportServerRenameURLMappingHistory
toFile=history.txt.
O arquivo history.txt mostra o histórico
de eventos de mapeamento que foram criados. Verifique se os resultados correspondem às
suas expectativas. Além disso, veja se o evento de mapeamento informa "COMPLETED". Se todos os
eventos de mapeamento estiverem concluídos, o Jazz
Team Server terá
processado tudo e não haverá mais uma renomeação em andamento.
Para obter detalhes, consulte Revisando um Histórico de Renomeações de Servidor.
Você Não é Redirecionado à Página serverRenameStatus Após uma Renomeação
Esse
é o comportamento esperado, se a renomeação já tiver sido concluída. Para verificar, acesse
https://jts.example.org:9443/jts/serverRenameStatus e verifique se tudo
está em 100% e verde.
A Renomeação do Aplicativo Falha
- Verifique se o aplicativo está em execução e se é possível executar ping dele a partir do Jazz
Team Server.
- Verifique se é possível acessar cada aplicativo rootservices no navegador. Para
CCM, verifique https://ccm.example.org:9443/ccm/rootservices.
Repita para outros aplicativos.
- Se o aplicativo não estiver em execução, inicie-o. Não é
necessário reiniciar o Jazz
Team Server.
Ele continuará pesquisando pelo status do aplicativo. Quando o aplicativo estiver
novamente online, o status será atualizado na UI.
- Se o aplicativo estiver em execução, verifique se é possível contatar o aplicativo, como
CCM, em https://ccm.example.org:9443/ccm/appServerRenameStatus.
Se você receber um erro 404, isso indica que o aplicativo não é um aplicativo 4.0. Um
aplicativo deve estar na versão 4.0 ou superior para suportar a renomeação de servidor. É possível executar um upgrade antes de realizar uma renomeação de servidor. Para obter detalhes, consulte roadmap_clm_upgrade.html.
- Verifique os logs do Jazz
Team Server e do aplicativo para obter mensagens de erro mais detalhadas.
- Verifique se um arquivo .mappingEvent está presente no diretório
server/conf/ de todos os aplicativos.
A UI Mostra que a Renomeação Está Concluída, Mas Existem Erros
Neste
caso, a UI mostra que a renomeação está concluída, mas ocorrem erros quando uma ação é
executada no aplicativo. Isso indica que a renomeação não foi concluída.
- Verifique o log do aplicativo para determinar se ele acha que a renomeação geral foi concluída.
- Encerre a aplicação.
- Abra o arquivo war do aplicativo e acesse WEB/web.xml.
Consulte os elementos a seguir no XML:
<filter>
<filter-name>bridgefilter</filter-name>
<filter-class>com.ibm.team.repository.server.servletbridge.BridgeFilter</filter-class>
</filter>
<filter-mapping>
<filter-name>bridgefilter</filter-name>
<servlet-name>equinoxbridgeservlet</servlet-name>
</filter-mapping>
- Se essas entradas não existirem, os aplicativos nunca saberiam se a renomeação geral foi concluída. Inclua as entradas e reimplemente o arquivo war. Reinicie o servidor de aplicativos e
abra uma página no navegador que acionará o aplicativo a ser iniciado. Por exemplo, acesse
https://ccm.example.org:9443/ccm/admin para o aplicativo CCM.
- Verifique se os outros arquivos war do aplicativo contêm as entradas e execute o mesmo
conjunto de etapas se as entradas não existirem.
Falha ao Finalizar Renomeação de Servidor
Ocorrem inúmeras coisas no
Jazz
Team Server depois que todas as renomeações de aplicativo forem concluídas.
- Verifique o log do Jazz
Team Server para determinar qual etapa de finalização falhou.
- É possível que ocorra um erro ao atualizar o armazém de dados.
Verifique se a
configuração do armazém de dados está correta e se o servidor de banco de dados está disponível.
- Depois de identificar o problema, siga os Procedimentos Gerais de Recuperação.
Não é possível tentar novamente a etapa de finalização.
Um Arquivo de Evento de Mapeamento Está Ausente
Se o seu ambiente
for distribuído, é possível que o arquivo de evento de mapeamento não seja copiado para o
diretório de configuração de aplicativo. Verifique se o diretório server/conf/ do aplicativo com falha contém um arquivo .mappingEvent. Se
nenhum arquivo .mappingEvent estiver presente, execute o seguinte:
- Encerre a aplicação.
- Copie o arquivo .mappingEvent do diretório server/conf/jts para o diretório
server/conf para o aplicativo.
Nota: Todos os arquivos
.mappingEvent para a topologia JTS fornecida são idênticos.
- Reinicie o servidor de aplicativos. Não é necessário reiniciar o Jazz
Team Server.
Ele continuará pesquisando pelo status do aplicativo. Assim que o aplicativo estiver
novamente online, o status será atualizado na UI.