Erros importURLMappings

Este tópico descreve os procedimentos de recuperação para os erros com o comando importURLMappings.

Se um erro ocorrer durante a execução de importURLMappings, será possível verificar o arquivo JazzInstallDir/server/repotools-jts_importURLMappings.log.

Você Perdeu uma Entrada de Mapeamento em seu Arquivo de Mapeamentos

Se você descobrir que uma entrada estava ausente em seu arquivo de mapeamentos original, como um par de origem-destino de um dos aplicativos CLM, execute as etapas a seguir:

  1. Encerre seu servidor.
  2. Crie um novo arquivo de mapeamentos com apenas a entrada ausente.
  3. Aplique o novo arquivo de mapeamentos, executando novamente o comando repotools-jts -importUrlMappings.

Você Cometeu um Erro na URL de Destino de um Mapeamento

Se você cometeu um erro em uma URL de destino, aplique o procedimento corretivo a seguir. As correções são acumulativas, ou seja, elas podem acontecer a qualquer momento desde que o servidor foi encerrado. É possível fazer essas correções para mais de uma entrada, mas você deve incluir apenas entradas para erros. As URLs que você acha que mapeou corretamente não devem ser incluídas. Suponha que você tenha a entrada a seguir em seu arquivo de mapeamentos original:
...
source=https://myOriginalUrl
target=https://myTargetUrlWithATypo
...
  1. Encerre o servidor.
  2. Crie um novo arquivo de mapeamentos com o mapeamento corretivo. Não inclua essa entrada no arquivo de mapeamentos original. A entrada pode ser semelhante a esta:
    source=https://myTargetUrlWithATypo
    target=https://myCorrectTargetUrl
  3. Aplique o novo arquivo de mapeamentos, executando novamente o comando repotools-jts -importUrlMappings.

Você Cometeu um Erro na URL de Origem de um Mapeamento

O processo é semelhante à seção anterior, mas um pouco mais complicado porque você tem que executar dois mapeamentos corretivos separadamente. Suponha que você tenha a entrada a seguir em seu arquivo de mapeamentos original:

...
source=https://myOriginalUrlWithATypo
target=https://myTargetUrl
...
  1. Crie um novo arquivo de mapeamentos com o mapeamento corretivo a seguir. O propósito desse arquivo de mapeamento é mover o destino, myTargetUrl, para fora do caminho.
    source=https://myTargetUrl
    target=dummy://aDummyUrl
  2. Aplique o novo arquivo de mapeamentos, executando novamente o comando repotools-jts -importUrlMappings. Aplique o mapeamento correto conforme a seguir:
    source=https://myOriginalUrl
    target=https://myTargetUrl

Não tente combinar esses mapeamentos em um único arquivo. Os mapeamentos corretivos acima têm de ser aplicados separadamente para que o sistema possa corrigir-se, sem ambiguidades.

Você Inverteu Acidentalmente a Origem e o Destino no Arquivo de Mapeamento

Por exemplo, sua posição inicial é esta:

...
source=https://myTargetUrl
target=https://mySourceUrl
...
Importante: Este cenário é recuperável apenas através dos procedimentos gerais de recuperação.

Para corrigir essa situação, você terá de seguir as regras de recuperação geral. O problema é que tal mapeamento expressa que o aplicativo em https://myTargetUrl também existe em https://mySourceUrl. Como esse é o local no qual seu aplicativo já existe, isso introduz uma ambiguidade que não pode ser desfeita.

Você Cometeu um Erro de Sintaxe no Mapeamento

Corrija o erro e execute importURLMappings novamente.

O Comando Falha com CRJAZ2436E

A renomeação de servidor não é suportada em um cluster. O Jazz Team Server e os servidores de aplicativos CLM devem permanecer não armazenados em cluster para as partes offline e online da renomeação.

O Comando Falha com CRJAZ2449E

Um upgrade foi iniciado mas não foi concluído. Geralmente, isso acontece se uma renomeação for tentada antes de concluir um upgrade online. O RM tem uma migração online que deve ser executada após a conclusão do upgrade offline. Conclua o upgrade online. Para obter detalhes, consulte roadmap_clm_upgrade.html. Encerre o servidor e tente o importURLMappings novamente.

O Comando Fornece o Aviso CRJAZ2425W

Este aviso indica que o arquivo de evento de mapeamento não continha nenhum novo mapeamento. Isso pode acontecer se o mesmo arquivo de mapeamento for importado duas vezes ou se o arquivo de eventos de mapeamento gerado original não foi atualizado para especificar as URLs de destino. Verifique se o argumento do arquivo de mapeamento está apontando para o arquivo correto e valide o conteúdo do arquivo.

O Comando Mostra a Mensagem CRJAZ2197E

Existem erros no log importURLMappings com uma mensagem CRJAZ2197E, ou a mensagem CRJAZ2197E aparece quando você inicia o servidor depois de executar importURLMappings.

Esta mensagem indica O URI público para este servidor já foi configurado para https://jts.source.example.org:9443/jts. Ele não pode ser alterado para https://jts.target.example.org:9443/jts depois que o servidor tiver sido configurado. Se o servidor foi movido para um novo local em https://jts.target.example.org:9443/jts, siga as instruções para renomear o servidor.

Sempre que importURLMappings falhar, ele deve reverter as URLs no JTS teamserver.properties de volta para os valores originais. Se isso não acontecer, é possível atualizar manualmente o teamserver.properties para que contenha a URL original e executar novamente o importURLMappings ou reiniciar o servidor.


Feedback