Este tópico descreve como preparar o arquivo de mapeamento que será usado
posteriormente na renomeação real de seu Jazz Team Server.
Você pode preparar e revisar o arquivo de mapeamento antes da renomeação real enquanto os servidores ainda estão online.
Antes de Iniciar
Importante: Para ativar a renomeação do servidor, você deve obter um arquivo-chave de recurso do Suporte de Software IBM®. Ao entrar em contato com o suporte IBM, mencione que você está solicitando um "Arquivo-chave de Recurso de Renomeação do Servidor".
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. Isso inclui as URLs para o Jazz Team Server, os aplicativos Jazz e quaisquer outros aplicativos que forem impactados.
É possível executar essas etapas em uma implementação multifuncional, em que o Jazz Team Server e os aplicativos Jazz estão todos instalados no mesmo computador ou, em uma implementação distribuída, em que os aplicativos Jazz estã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 envolva um ambiente renomeado
em novos computadores.
- Após fazer upgrade do Jazz Team Server (JTS)
e de todos os aplicativos Jazz, inicie o Jazz Team Server 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.
Se não, registre-os.
- Se você registrou quaisquer aplicativos na etapa anterior, reinicie 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: Assegure-se de executar esta 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 a ser usado como modelo para edição
adicional, conforme mostrado abaixo. Se você já tiver executado o comando, ou o arquivo já existir, inclua
o parâmetro overwrite=true.
- Windows: repotools-jts.bat
-generateURLMappings toFile=mappings.txt adminUserId=<adminId>
adminPassword=<adminPassword> additionalURLFile=additionalurl.txt
- Linux: ./repotools-jts.sh
-generateURLMappings toFile=mappings.txt adminUserId=<adminId>
adminPassword=<adminPassword> additionalURLFile=additionalurl.txt
A saída deste comando é um arquivo de mapeamento que lista a URL Pública da origem e uma URL de destino padrão para oJazz Team Server e
cada aplicativo Jazz(Rational Engineering Lifecycle
Manager, Lifecycle
Query Engine, Jazz
Reporting Service)
que é registrado com o Jazz Team Server.
Ele também identifica URLs de origem e de destino para o arquivo WAR de ajuda e quaisquer sistemas externos afetados conhecidos.
Além disso, é criado um segundo arquivo que contém uma lista de todas as URLs que podem precisar ser mapeadas ou que referenciam integrações de terceiros que podem precisar ser consideradas. É possível incluir essas URLs no arquivo de mapeamentos. Para implementações simples, não é incomum para esse arquivo não conter nenhuma URL adicional. Se você incluir o parâmetro additionalURLFile=additionalurl.txt, será possível especificar um nome diferente para esse arquivo. Para obter detalhes adicionais sobre esse parâmetro, consulte Comando de Ferramentas de Repositório para Gerar o Arquivo de Mapeamentos de Renomeação do Servidor.
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. Para familiarizar-se com a estrutura do arquivo de mapeamento, consulte Arquivo de Mapeamento para Renomeação do Servidor.
- Verifique se um par de origem-destino existe para cada aplicativo que está sendo renomeado e para o arquivo WAR de Ajuda.
- 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. Se você
estiver renomeando uma raiz de contexto do JTS ou qualquer aplicativo, consulte
Alterando a Raiz de Contexto.
- 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 alguma dessas URLs afetadas precisar ser mapeada, remova o comentário do par origem/destino da URL afetada e forneça a nova URL de destino. Se você tiver dúvidas sobre o ambiente, fale com um administrador antes de continuar com a renomeação.
- Revise o arquivo additionalurls.
Para obter detalhes, consulte Comando de Ferramentas de Repositório para Gerar o Arquivo de Mapeamentos de Renomeação do Servidor.
Nota: Se quaisquer mudanças na configuração forem feitas para a implementação antes de continuar para a renomeação real, incluindo os aplicativos adicionais de registro, será necessário gerar novamente o arquivo de mapeamento.
- Use o comando repotools-jts -verifyURLMappings para verificar o arquivo de mapeamento.
- repotools-jts.bat -verifyURLMappings
mappingFile=mappings.txt repositoryURL=<serverURL> adminUserId=<adminId>
adminPassword=<adminPassword>
- ./repotools-jts.sh -verifyURLMappings
mappingFile=mappings.txt repositoryURL=<serverURL> adminUserId=<adminId>
adminPassword=<adminPassword>
Para obter detalhes adicionais sobre os tipos de verificações executados por este comando, consulte Comando de Ferramentas de Repositório para Verificar um Arquivo de Mapeamento.
- Se seu cenário envolver um novo hardware, instale o Rational Engineering Lifecycle
Manager nos novos computadores. Não execute o assistente de Configuração do Jazz ou inicie o Jazz Team Server.