Preparando o Arquivo de Mapeamento

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.

For z/OS operating system 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.

Procedimento

  1. 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.
    1. Efetue login na página Administração do Jazz Team Server. Aponte o navegador da web para https://hostname:port/jts/admin.
    2. Clique na guia Servidor.
    3. Na área de janela esquerda, na seção Configuração, clique em Aplicativos Registrados.
    4. Verifique se todos os aplicativos foram registrados.

    Para obter mais detalhes, consulte Registrando Aplicativos com o Jazz Team Server.

  2. 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.
  3. 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.
    • For Windows operating system repotools-jts.bat -generateURLMappings toFile=mappings.txt adminUserId=<adminId> adminPassword=<adminPassword>
    • For Unix operating systems ./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.

  4. 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.

    1. Verifique se um par origem-destino existe para cada aplicativo que está sendo renomeado e para o arquivo WAR de Ajuda do CLM.
    2. Edite os target= urls para as metas que deseja renomear para serem os destinos corretos.
      Nota: Se você estiver renomeando um número de porta do JTS ou qualquer aplicativo, será necessário atualizar as informações da porta no servidor de aplicativos após a renomeação, mas antes de os servidores serem reiniciados. Para obter detalhes, consulte Alterando os Números de Porta Para o Servidor de Aplicativos. Se você estiver renomeando uma raiz de contexto do JTS ou qualquer aplicativo, consulte Alterando a Raiz de Contexto.
    3. Usando um '#', comente o par origem-> destino de quaisquer URLs que você não deseja que sejam renomeadas.
    4. 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.
  5. 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.

O que Fazer Depois

Continue a renomeação do servidor. Para obter detalhes, consulte Movendo uma Implementação Piloto para Produção Usando a Renomeação do Servidor ou Configurando um Ambiente de Temporariedade de Teste com Dados de Produção

Feedback