Arquivo de Mapeamento para Renomeação do Servidor

Este tópico descreve a estrutura do arquivo de mapeamento gerado pelo comando generateURLMappings e fornece instruções sobre como editar o arquivo de mapeamento para sua implementação.

Quando você estiver pronto para gerar um arquivo de mapeamento, siga as instruções em Preparando o Arquivo de Mapeamento.

O arquivo de mapeamento contém pares de URLs de origem-destino para o Jazz Team Server, seus aplicativos registrados e outras URLs de contribuição pelos aplicativos. As URLs são divididas em dois tipos:

Os pares URL que fazem parte da renomeação incluem tudo sob o domínio do Jazz Team Server. Eles incluem a URL pública do Jazz Team Server, URLs públicas do aplicativo e outras URLs contribuídas pelos aplicativos.

As URLs afetadas incluem todos os outros sistemas que interagem com essa topologia, mas não estão sob o domínio deste Jazz Team Server. Um aplicativo Rational Engineering Lifecycle Manager que é registrado em um Jazz Team Server diferente, mas que é amigo desse Jazz Team Server, representa uma URL afetada. Uma integração externa, como por exemplo, o Rational ClearQuest, também representa uma URL afetada.

Descrição de um Arquivo de Mapeamento de Amostra

# JTS
source=https://relmhost.example.org:9443/jts
target=https://relmhost2.example.org:9443/jts
#Additional Urls included in rename by relmhost.example.org:9443/jts
# ADMIN
source=https://relmhost.example.org:9443/admin
target=https://relmhost2.example.org:9443/admin
#(relm Help URL)
source=https://relmhost.example.org:9443/relmhelp
target=https://relmhost2.example.org:9443/relmhelp
# RELM
source=https://relmhost.example.org:9443/relm
target=https://relmhost2.example.org:9443/relm
# Jazz Reporting Service
source=https://relmhost.example.org:9443/sparql
target=https://relmhost2.example.org:9443/sparql

#The following list of URLs represent external servers that integrate 
with this Jazz Team Server or with applications registered to it.

#Do not uncomment these lines as they are for reference purposes only.
# Friend Entry
#source=https://friend1.example.org:9443/jts/rootservices 
#target=https://friend1.example.org:9443/jts/rootservices 
#source=https://cqconnector.example.org:9084/cqconnector/gateway
#target=https://cqconnector.example.org:9084/cqconnector/gateway

O arquivo de mapeamento gerado é um modelo que deve ser editado antes de executar o importURLMappings. É importante entender tudo no arquivo de mapeamento para assegurar que todos os sistemas na topologia estejam corretamente renomeados. A seção superior do arquivo inclui pares de URL que fazem parte da renomeação. Neste exemplo, é possível ver os pares de URLs para a URL pública do Jazz Team Server e todos seus aplicativos registrados. Também é possível ver os pares de URLs que são contribuídas por aplicativos.

Consulte cada uma dessas URLs e determine quais estão sendo alteradas. Atualize os destinos para qualquer URL de origem que será renomeada com seus novos valores. Se uma URL de origem fornecida não estiver sendo renomeada, comente o par usando um ' #'.

# JTS
#source=https://relmhost.example.org:9443/jts
#target=https://relmhost2.example.org:9443/jts

A seção inferior do arquivo de mapeamento contém uma lista de URLs afetadas que estão com as linhas comentadas. Essas URLs não fazem parte dessa renomeação, mas sofrem impacto pelas URLs em mudança. A menos que seja necessário mascarar as URLs de produção, você deve deixar essas URLs com as linhas comentadas, já que elas são destinadas apenas para propósitos de referência.

Se você estiver em um ambiente temporário, sempre deve mascarar as URLs afetadas para assegurar se não exista nenhum link cruzado entre os servidores de produção e os temporários. Veja os detalhes abaixo.

Mapeamentos Simulados para Proteger os Dados de Produção

Se for necessário mascarar uma URL afetada, será necessário remover comentário do par de origem/destino e fornecer um destino simulado.

Ao configurar um ambiente temporário, é necessário que crie mapeamentos simulados para qualquer URL afetada no arquivo de mapeamento. As URLs afetadas podem incluir outros aplicativos relm que são amigos desses servidores externos ou de implementação. Para entradas de amigos, crie um mapeamento simulado para a URL pública do amigo.

Por exemplo, se sua URL de entrada de amigo for https://friendhost.example.org:9443/jts/rootservices, a URL pública geralmente será https://friendhost.example.org:9443/jts. Inclua um par de URL na parte inferior do seu arquivo de mapeamento para mascarar esta URL, configurando o destino para um nome do host falso. Verifique se o nome do host de destino simulado está inatingível antes de selecioná-lo.

# Friend
source=https://friendhost.example.org:9443/jts
target=https://dummyfriendhost.example.org:9443/jts

Para quaisquer URLs afetadas que não sejam entradas de amigo, inclua o par de URL a seguir na parte inferior do arquivo de mapeamento.

source=https://externalserver.example.org:9555/
target=https://dummyhost.example.org:9555/

Não é permitido usar o mesmo destino mais de uma vez. Se você tiver várias entradas de amigos, use dummyhost2, dummyhost3 e assim por diante. Se você tiver uma implementação de servidor único na qual o Jazz Team Server e todos os aplicativos residem no mesmo host e porta, será possível usar um mapeamento simplificado, conforme descrito abaixo.

Usando um Arquivo de Mapeamento Simplificado

Se você tiver uma topologia simples, em que o protocolo, o host, o domínio e a porta sejam comuns para todas as URLs, o arquivo de mapeamento pode ser reduzido para conter apenas uma entrada de origem-destino. Por exemplo, se você tiver uma implementação multifuncional em relmhost.example.org e desejar renomear tudo para usar o newhost.example.org, será possível editar o arquivo de mapeamento gerado apenas para incluir as URLs a seguir:

Nota: O mapeamento simplificado de relmhost.example.org para newhost.example.org renomeia apenas os aplicativos Jazz Team Server e o Jazz. Ele não renomeia quaisquer outras integrações do Rational ou de terceiros. Execute sempre generateURLMappings para determinar se o cenário é suportado e para assegurar que tudo na topologia esteja mapeado corretamente.
source=https://relmhost.example.org:9443
target=https://newhost.example.org:9443
Importante: Não use um arquivo de mapeamento simplificado se desejar distribuir sua implementação em uma data posterior.

URLs com Portas Padrão

Se alguma das URLs de origem usar a porta padrão e o número da porta padrão não estiver incluído explicitamente, dois conjuntos de mapeamentos serão necessários: um com a porta padrão e outro sem a porta padrão. O comando generateURLMappings vai gerar automaticamente os mapeamentos adicionais. As portas padrão são 443 para https e 80 para http.

Por exemplo,Rational Engineering Lifecycle Manager está executando em https://relmhost.example.org/relm. Neste caso, o Rational Engineering Lifecycle Manager foi implementado em um servidor usando a porta padrão (configurando a porta para o servidor de aplicativos ou usando um servidor http de proxy reverso na porta padrão). No Rational Engineering Lifecycle Manager, os links também podem ter sido armazenados para URLs para os recursos nos quais a porta esteja incluída explicitamente na URL, por exemplo:

https://relmhost.example.org:443/resource/...

Por causa da possibilidade de que as URLs possam ser armazenadas com ambos os formatos, é necessário um mapeamento para cada uma. Por exemplo, suponha que relmhost.example.org esteja renomeado como newhost.example.org. Nesse caso, os mapeamentos a seguir seriam necessários para executar uma renomeação. Os pares são gerados automaticamente pelo generateURLMappings.

source=https://relmhost.example.org/relm
target=https://newhost.example.org/relm

source=https://relmhost.example.org:443/relm
target=https://newhost.example.org:443/relm

Distinção entre Maiúsculas e Minúsculas

É recomendável que as URLs sejam especificadas com todas as letras minúsculas. As URLs fazem distinção entre maiúsculas e minúsculas.

Erros Durante a Geração do Arquivo de Mapeamento

Devido à quantia de processamento envolvido, existe um potencial para que os erros ocorram. Alguns erros são claramente indicados, como se você tentar gerar o arquivo de mapeamento antes de iniciar o servidor, ou se você usar as credenciais de login erradas. Os outros erros são menos óbvios. Para obter detalhes sobre os erros de renomeação do servidor, consulte Resolução de Problemas de Renomeação de Servidor.

Verificando um Arquivo de Mapeamentos

Após gerar e editar o arquivo de mapeamentos, assegure-se de executar o comando repotools-jts -verifyURLMappings para verificar os mapeamentos ausentes e executar várias outras verificações. Em alguns casos, será possível ignorar os mapeamentos ausentes encontrados, se não for necessário mapear essa URL. Para obter detalhes adicionais, consulte Comando de Ferramentas de Repositório para Verificar um Arquivo de Mapeamento.


Feedback