Movendo uma Implementação Piloto para Produção Usando a Renomeação do Servidor

Este tópico descreve as etapas necessárias para alterar as URLs do servidor ao mover uma implementação piloto pequena de CLM para produção.

Antes de Iniciar

Antes de continuar com a renomeação, verifique se o ambiente atende aos critérios para o cenário de piloto para produção. Consulte Cenários Suportados para obter detalhes.

Importante: Para executar uma renomeação do servidor, o Jazz Team Server e todos os aplicativos CLM devem estar na versão 4 ou mais recente.

O diagrama a seguir mostra o fluxo geral da renomeação.

Cenário de piloto para produção

Sobre Esta Tarefa

Como parte desse procedimento, você copia os arquivos de dados e de configuração dos servidores piloto para os servidores de produção. Como você está movendo e não copiando os bancos de dados, o ambiente piloto deve ficar permanentemente fora de serviço para evitar contaminação do ambiente de produção.

O recurso de renomeação de servidor usa um arquivo de mapeamento para determinar as URLs que devem ser renomeadas. Um comando repotools é fornecido para gerar um arquivo de mapeamento inicial para você. O arquivo de mapeamento contém pares de origem-destino para o JTS e todos os aplicativos, bem como quaisquer outras URLs contribuídas por aplicativos. Consulte Entendendo o Arquivo de Mapeamento Usado pela Renomeação do Servidor para obter detalhes adicionais sobre o arquivo de mapeamento. Consulte Topologias e Arquivos de Mapeamento para o Cenário de Piloto para Produção para obter amostras de diagramas de topologia e arquivos de mapeamento.

Procedimento

  1. Prepare e revise o arquivo de mapeamento antes da renomeação real, enquanto os servidores ainda estão online, seguindo as etapas descritas no tópico Preparando o Arquivo de Mapeamento.

    Se você estiver movendo sua implementação para um novo computador, execute a instalação no novo computador. Se você estiver alterando a URL no mesmo computador, execute a instalação em um diretório separado da instalação existente. Se você também estiver alterando a raiz de contexto, consulte Alterando a Raiz de Contexto.

    O resultado final da fase preparatória é um arquivo de mapeamento gerado no Jazz Team Server piloto. O arquivo de mapeamento contém pares de origem-destino para o Jazz Team Server e todos os aplicativos, bem como quaisquer outras URLs contribuídas por aplicativos.

  2. Faça backup do ambiente piloto versão 4 e copie os índices de texto e os arquivos de configuração de aplicativo para a nova instalação.
    1. Pare o Jazz Team Server e quaisquer aplicativos CLM distribuídos que estejam registrados com o Jazz Team Server.

      Além disso, pare todos os outros aplicativos afetados pela renomeação do servidor, como o Jazz Build Engine, ou qualquer integração suportada afetada, como Rational Reporting for Development Intelligence (RRDI), Rational ClearCase ou Rational ClearQuest.

      Nota: Enquanto o(s) servidor(es) está(ão) inoperante(s), os usuários não podem criar ou atravessar links de nenhum sistema externo que esteja integrado com a implementação do CLM que está prestes a ser renomeado.
    2. Faça backup dos bancos de dados no ambiente piloto do CLM 4.0, incluindo o banco de dados do Jazz Team Server, os bancos de dados para os aplicativos CCM e QM, o banco de dados do armazém de dados e o banco de dados de armazenamento de conteúdo do RRDI, se você estiver usando o RRDI. Se você estiver alterando o servidor ou o fornecedor do banco de dados, consulte Movendo o Banco de Dados do CLM para obter etapas adicionais.
    3. Copie os índices JFS/texto do servidor piloto de origem para o servidor de produção de destino. (Para sistemas distribuídos, acesse o servidor adequado para copiar os arquivos).

      Os exemplos a seguir para um servidor Linux presumem que as unidades dos computadores de produção sejam montadas em rede. Se isso não for possível em seu ambiente, use outros métodos de transferência de arquivo para assegurar que os arquivos sejam copiados.

      cp -R SourceJazzInstallDir/server/conf/jts/indices TargetJazzInstallDir/server/conf/jts 
      cp -R SourceJazzInstallDir/server/conf/ccm/indices TargetJazzInstallDir/server/conf/ccm 
      cp -R SourceJazzInstallDir/server/conf/qm/indices TargetJazzInstallDir/server/conf/qm 
    4. Copie os arquivos de configuração de aplicativo do servidor piloto de origem para o servidor de produção de destino. (Para sistemas distribuídos, acesse o servidor adequado para copiar os arquivos). Como com a etapa anterior, os exemplos a seguir se referem a um servidor Linux e presumem que as unidades dos computadores de produção sejam montadas em rede.
      cp SourceJazzInstallDir/server/conf/jts/teamserver*.properties TargetJazzInstallDir/server/conf/jts 
      cp SourceJazzInstallDir/server/conf/ccm/teamserver*.properties TargetJazzInstallDir/server/conf/ccm 
      cp SourceJazzInstallDir/server/conf/qm/teamserver*.properties TargetJazzInstallDir/server/conf/qm 
      cp SourceJazzInstallDir/server/conf/admin/admin.properties* TargetJazzInstallDir/server/conf/admin
      cp SourceJazzInstallDir/server/conf/admin/friends.rdf* TargetJazzInstallDir/server/conf/admin 
      cp SourceJazzInstallDir/server/conf/rm/fronting.properties TargetJazzInstallDir/server/conf/rm 
      cp SourceJazzInstallDir/server/conf/rm/friendsconfig.rdf TargetJazzInstallDir/server/conf/rm 
    5. Copie o arquivo de mapeamento para o diretório TargetJazzInstallDir\server no servidor de produção. Consulte Preparando o Arquivo de Mapeamento para obter detalhes sobre o arquivo de mapeamento.
  3. Execute a parte offline da renomeação do servidor importando o arquivo de mapeamento no Jazz Team Server de produção de destino, usando o comando repotools-jts -importURLMappings.
    1. Se você tiver uma implementação tudo em um, importe o arquivo de mapeamentos usando o comando repotools-jts -importURLMappings conforme a seguir:
      • For Windows operating system repotools-jts.bat -importURLMappings fromFile=".\mappings.txt"
      • For Unix operating systems ./repotools-jts.sh -importURLMappings fromFile="./mappings.txt"

      A renomeação começará offline no Jazz Team Server, antes que o servidor seja reiniciado.

    2. Se você tiver uma implementação distribuída e tiver permissão para mapear unidades de rede, mapeie uma unidade de rede do host do Jazz Team Server para cada um dos hosts de aplicativos. Em seguida, crie um arquivo (por exemplo, serverConfFile.txt) que contenha uma lista de diretórios server/conf remotos em sua implementação, no seguinte formato:
       # Remote CCM server
         x:/JazzTeamServer/server/conf
         # Remote QM server
         y:/JazzTeamServer/server/conf
         # Remote RM server
         z:/JazzTeamServer/server/conf

      Finalmente, continue com o comando repotools-jts -importURLMappings e inclua o parâmetro serverConfFile=, conforme mostrado abaixo.

      • For Windows operating system repotools-jts.bat -importURLMappings fromFile=".\mappings.txt" serverConfFile=".\serverConf.txt"
      • For Unix operating systems ./repotools-jts.sh -importURLMappings fromFile="./mappings.txt" serverConfFile="./serverConf.txt"
    3. Se você tiver uma implementação do CLM distribuída e não tiver permissão para mapear unidades de rede, continue com o comando repotools-jts -importURLMappings (sem o parâmetro serverConfFile=). Em seguida, copie o arquivo server/conf/jts/.mappingEvent para os diretórios de configuração de aplicativo remoto (server/conf/application_name), isto é, ccm, qm e rm. O arquivo de evento é gerado quando você importa os mapeamentos. Você deve copiar o arquivo .mappingEvent após importar o arquivo de mapeamento, mas antes de iniciar o servidor.

      O arquivo .mappingEvent contém informações de que os aplicativos precisam para entrar em contato com o Jazz Team Server em seu novo local. O conteúdo do arquivo .mappingEvent é igual para um determinado Jazz Team Server e seus aplicativos registrados.

    Nota: Os servidores em execução no z/OS devem ser renomeados usando o membro JCL de amostra HLQ.SBLZSAMP(BLZRENAM). Consulte o cabeçalho de comentário do BLZRENAM para obter instruções detalhadas sobre customização.

    Verifique se a renomeação foi bem-sucedida verificando a saída do console e o arquivo JazzInstallDir/server/repotools-jts_importURLMappings.log. Se qualquer erro for exibido, ou você perceber que cometeu um erro em seu arquivo de mapeamento, consulte Resolução de Problemas de Renomeação de Servidor para identificar e corrigir o problema.

  4. Inicie o Jazz Team Server e quaisquer aplicativos CLM distribuídos que estejam instalados.

    Neste ponto, os aplicativos CLM irão sincronizar com o Jazz Team Server para aplicar os mapeamentos de URL e atualizar seus dados no armazém de dados. Isso deve levar aproximadamente cinco minutos para um conjunto de dados pequeno e até 30 minutos ou mais para um conjunto de dados muito grande.

  5. Efetue login no Jazz Team Server em https://hostname:port/jts/serverRenameStatus (por exemplo, https://clmhost.production.example.org:9443/jts/serverRenameStatus) para controlar o progresso da renomeação. Essa página é atualizada automaticamente até que a renomeação seja concluída.

    Se algum erro for exibido, consulte Resolução de Problemas de Renomeação de Servidor para identificar e corrigir o problema.

    Nota: Qualquer tentativa de login na UI da web para qualquer dos aplicativos CLM antes que a renomeação seja concluída redirecionará você para esta página de status.
  6. Execute as etapas de verificação de renomeação do servidor descritas em Verificando Renomeação de Servidor.
  7. Opcional: Execute as etapas a seguir para configurar o Rational Reporting for Development Intelligence (RRDI) no ambiente de produção:
    1. Faça backup dos seguintes bancos de dados do ambiente piloto e restaure-os em um novo servidor de banco de dados para a nova instalação do RRDI no ambiente de produção:
      • O banco de dados de armazenamento de conteúdo (por exemplo, RICM, se não tiver sido feito backup nem restauração)
      • O armazém de dados (por exemplo, RIDW, caso ainda não tenha sido submetido a backup e restaurado).
    2. Instale o Rational Reporting for Development Intelligence versão 2.0 no ambiente de produção. Para obter detalhes, consulte Instalando o Rational Reporting for Development Intelligence Usando o Installation Manager.
    3. Configure o servidor de relatório, executando o aplicativo Configuração RRDI. Para obter detalhes, consulte Tarefas de Pós-instalação. Lembre-se para executar estas ações:
      • Na página Configurar Banco de Dados de Armazenamento de Conteúdo, especifique as propriedades de conexão para o banco de dados de armazenamento de conteúdo (por exemplo, RICM) que você restaurou na Etapa 7.a.
      • Na página Configurar Armazém de Dados, especifique as propriedades de conexão para o banco de dados de armazém de dados (por exemplo, RIDW) que você restaurou na Etapa 7.a.
    4. Efetue logon no Jazz Team Server e verifique se as URLs do servidor de relatório armazenadas em Propriedades Avançadas do Jazz Team Server e nas páginas de Administração do CCM e QM apontam para o servidor de relatório do RRDI de produção. Se elas não apontarem para o sistema de produção, atualize-as adequadamente.
      Nota: Se o arquivo de mapeamento continha mapeamentos para a URL do servidor de relatório, isso deverá ter sido atualizado automaticamente.
    5. Verifique se todos os relatórios importados anteriormente do servidor de relatório RRDI piloto continuam funcionando.
    6. Qualquer relatório ou visualização de relatório do Cognos com a ação configurada como Visualizar relatório mais recente deve ser executado novamente após uma renomeação do servidor CLM para que o relatório HTML armazenado em cache seja atualizado.
      1. Efetue logon no servidor de relatório RRDI.
      2. Procure relatórios ou visualizações de relatório com versões de saída armazenadas em cache.
        Nota: Se uma versão de saída armazenada em cache existir para um relatório ou visualização de relatório, será possível clicar em Visualizar versões de saída para esse relatório a fim de visualizar os relatórios armazenados em cache. Se os relatórios ou visualizações de relatório foram gerados antes da renomeação do servidor CLM, você deve executá-los novamente para atualizá-los. Caso contrário, os usuários que executam relatórios ou visualizações de relatório verão links antigos apontando para o servidor CLM antigo.
      3. Clique em Executar com Opções para executar novamente os relatórios ou visualizações de relatório.
      4. No visualizador de relatório, clique em Manter esta versão > Salvar Relatório para atualizar as versões de saída armazenadas em cache associadas aos relatórios ou às visualizações de relatório.
    7. Importe um novo relatório do servidor de relatório RRDI de produção. Verifique se a importação foi bem-sucedida e se o relatório importado é executado sem problema.
    8. Se você tiver configurado os relatórios em tempo real do Rational Quality Manager no RRDI, siga as etapas para gerar o arquivo xdc para o novo servidor e configure-o no gerenciador ODBC de 32 bits. Para obter detalhes, consulte Configurando Relatórios em Tempo Real.
  8. Execute qualquer etapa adicional de pós-renomeação do servidor que for necessária para integração com outros componentes e produtos, como Jazz Build Engines, Rational Reporting, clientes Rational Team Concert, Rational ClearQuest ou Rational ClearCase. Para obter detalhes, consulte Restrições e Informações Adicionais.

Feedback