Erros de UI de Status de Renomeação de Servidor

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.

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

  1. Verifique se o aplicativo está em execução e se é possível executar ping dele a partir do Jazz Team Server.
  2. Verifique se é possível acessar cada aplicativo rootservices no navegador. Para CCM, verifique https://ccm.example.org:9443/ccm/rootservices. Repita para outros aplicativos.
  3. 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.
  4. 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.
  5. Verifique os logs do Jazz Team Server e do aplicativo para obter mensagens de erro mais detalhadas.
  6. 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.

  1. Verifique o log do aplicativo para determinar se ele acha que a renomeação geral foi concluída.
  2. Encerre a aplicação.
  3. 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>
  4. 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.
  5. 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.

  1. Verifique o log do Jazz Team Server para determinar qual etapa de finalização falhou.
  2. É 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.
  3. 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:

  1. Encerre a aplicação.
  2. 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.
  3. 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.

Feedback