Este tópico descreve como preparar o arquivo de mapeamento que você usará posteriormente na renomeação real do(s) servidor(es) CLM. É possível preparar e revisar o arquivo de mapeamento antes da renomeação real enquanto os servidores ainda estão online.
Antes de Iniciar
Importante: A capacidade de renomear um servidor é um recurso do CLM versão 4. Portanto, para poder executar uma renomeação de servidor,
você deve atualizar o Jazz
Team Server e todos os aplicativos do CLM para a versão 4.
Sobre Esta Tarefa
Há várias etapas que você precisa executar antes de realmente
renomear o servidor. Em grande parte, isso envolve preparar e revisar o
arquivo de mapeamento que você irá usar para executar a operação de renomeação.
O arquivo de mapeamento lista as URLs de origem existentes e as URLs de destino renomeadas
em sua implementação. Essas incluem as URLs para o Jazz
Team Server,
os aplicativos CLM, o arquivo WAR da ajuda do CLM e quaisquer outros aplicativos que sejam
impactados. Consulte Topologias e Arquivos de Mapeamento para Configurar um Ambiente Temporário do Teste para obter amostras de
diagramas de topologia e arquivos de mapeamento.
É possível executar estas etapas em uma implementação completa do CLM, na qual o Jazz
Team Server e os aplicativos CLM são todos instalados no mesmo computador, ou em uma implementação distribuída, na qual os aplicativos CLM são instalados em computadores diferentes. Essas etapas preparatórias podem ser usadas com vários cenários, por exemplo, em que um computador é movido para um novo local físico, ao configurar um ambiente de simulação de teste em um novo computador ou no caso de uma consolidação de datacenter que envolve um ambiente renomeado em novos computadores.
Nota: A renomeação de um servidor é suportada no z/OS, mas existem várias diferenças no processo de criação de um arquivo de mapeamento.
Para obter detalhes, consulte
Renomeação do Servidor
no z/OS.
- Após o upgrade de todos os servidores envolvidos na renomeação para a versão 4, inicie o Jazz
Team Server (JTS) e verifique se os aplicativos foram registrados corretamente no servidor.
- Efetue login na página Administração do
Jazz
Team Server.
Aponte o navegador da web para https://hostname:port/jts/admin.
- Clique na guia Servidor.
- Na área de janela esquerda, na seção Configuração, clique em Aplicativos
Registrados.
- Verifique se todos os aplicativos foram registrados.
Para obter mais detalhes, consulte
Registrando Aplicativos com o Jazz Team Server.
- Abra um prompt de comandos no computador no qual o Jazz
Team Server está
instalado e altere para o diretório JazzInstallDir\server.
Nota: Certifique-se de executar essa etapa e as seguintes etapas no Jazz
Team Server original, mesmo se você mudará para um novo hardware.
- Use o comando repotools-jts -generateURLMappings
para gerar um arquivo de mapeamento inicial para ser usado como um modelo para
edição adicional, como mostrado a seguir. Se você já tiver executado o comando, ou o arquivo já existir, inclua
o parâmetro overwrite=true.
Nota: Quaisquer exemplos mostrados
para UNIX também
são válidos para Linux.
repotools-jts.bat -generateURLMappings
toFile=mappings.txt adminUserId=<adminId> adminPassword=<adminPassword>
./repotools-jts.sh -generateURLMappings
toFile=mappings.txt adminUserId=<adminId> adminPassword=<adminPassword>
A saída desse comando é um arquivo de mapeamento que lista a URL Pública de origem existente
e uma URL de destino padrão para o Jazz
Team Server e
para cada aplicativo CLM (CCM, QM e RM) que está registrado com o Jazz
Team Server.
Ele também identifica URLs de origem e de destino para o arquivo WAR da ajuda do CLM
e quaisquer sistemas externos afetados.
Verifique se não há erros no arquivo de log em JazzInstallDir/server/repotools-jts_generateURLMappings.log.
- Revise e edite cuidadosamente o arquivo de mapeamento
gerado. Procure erros de digitação no nome do host, porta ou contextos-raiz.
Alguns desses erros de digitação não são detectáveis pelas ferramentas de renomeação de servidor, e podem
resultar em um produto não funcional.
Familiarize-se com a estrutura do arquivo de mapeamento revisando o tópico Entendendo o Arquivo de Mapeamento Usado pela Renomeação do Servidor. Revise e edite cuidadosamente o arquivo de mapeamento
gerado.
- Verifique se um par origem-destino existe para cada aplicativo que está
sendo renomeado e para o arquivo WAR de Ajuda do CLM.
- Edite os target= urls para as metas que
deseja renomear para serem os destinos corretos.
- Usando um '#', comente o par
origem-> destino de quaisquer URLs que você não deseja que sejam renomeadas.
- Revise a lista de URLs afetadas. Embora o comando procure todas as URLs conhecidas na implementação, é possível que algumas estejam ausentes. Se você tiver dúvidas sobre o ambiente, fale com um administrador antes de continuar com a renomeação.
Nota: Se alguma mudança na configuração for feita na implementação do CLM antes
de você continuar para a renomeação real, você precisará gerar novamente
o arquivo de mapeamento.
- Se seu cenário envolver novo hardware, instale o CLM versão
4 nos novos computadores. Não execute o assistente de Configuração do Jazz ou inicie o Jazz
Team Server.
Consulte o Instalando o Jazz Team Server e Aplicativos da Solução Rational para Collaborative Lifecycle Management.