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.
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:
... source=https://myOriginalUrl target=https://myTargetUrlWithATypo ...
source=https://myTargetUrlWithATypo target=https://myCorrectTargetUrl
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 ...
source=https://myTargetUrl target=dummy://aDummyUrl
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.
Por exemplo, sua posição inicial é esta:
... source=https://myTargetUrl target=https://mySourceUrl ...
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.
Corrija o erro e execute importURLMappings novamente.
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.
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.
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.
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.