Configurando um Ambiente de Temporariedade de Teste com Dados de Produção

Este tópico descreve como usar o recurso de renomeação do servidor para preparar um ambiente de temporariedade com dados reais de produção. Um ambiente de temporariedade é um ambiente de simulação de teste que está isolado do ambiente de produção. Ele pode ser utilizado para experimentar novos recursos ou funções com dados reais de saída sem impactar o banco de dados de produção.

Sobre Esta Tarefa

Importante: Este procedimento não pode ser usado para atualizar seu ambiente a partir de uma liberação anterior. A renomeação de servidor é suportada apenas na versão 4 e liberações mais recentes. Portanto, o upgrade para a versão 4 é um pré-requisito para configurar um ambiente de temporariedade usando a renomeação de servidor.

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 Jazz Team Server 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 Configurar um Ambiente Temporário do Teste para obter amostras de diagramas de topologia e arquivos de mapeamento.

Ao planejar um ambiente de temporariedade, você precisa ter cuidado especial para não contaminar os dados de produção ou vice-versa. É possível fazer isso de duas maneiras: incluindo entradas no arquivo hosts, se ele for permitido no ambiente e criando mapeamentos para mascarar os servidores que não estão presentes em seu ambiente de temporariedade. Certifique-se de incluir no mapeamento quaisquer servidores CLM adicionais ou produtos não CLM que possam estar conectados ao servidor de produção. Consulte a Etapa 3.c e Mapeamentos fictícios para ambientes de temporariedade para obter detalhes.

Por exemplo, você pode ter um aplicativo Change and Configuration Management (CCM) em um servidor de produção com links para o CCM em outro servidor de produção, e links para o Quality Management (QM) ainda em outro servidor de produção. Além disso, você pode ter integrações com produtos não CLM, como o Rational ClearQuest. Nesse caso, você deve primeiro mascarar as URLs dos servidores CCM e QM adicionais e assegurar que a URL para o Rational ClearQuest também esteja mascarada ou mapeada para um servidor gateway do Rational ClearQuest em estágio.

Importante: Não conecte um cliente Rational Team Concert aos repositórios de produção e temporário ao mesmo tempo. Sempre utilize uma área de trabalho de temporária para conexão com o servidor de temporariedade.

O diagrama abaixo exibe as principais etapas que são necessárias para configurar um ambiente de temporariedade usando a renomeação do servidor. Presume-se que as versões mais recentes do CLM (versão 4) e do RRDI (versão 2) já estejam instaladas.

Produção para o cenário de temporariedade

Procedimento

  1. Prepare-se para a renomeação seguindo as etapas descritas no tópico Preparando o Arquivo de Mapeamento.

    Certifique-se de criar um mapeamento simulado para quaisquer URLs afetadas no arquivo de mapeamento. Faça isso para evitar a vinculação cruzada entre os ambientes de temporariedade e os ambientes de produção. Consulte Mapeamentos de simulação para ambientes de temporariedade para obter detalhes.

    O resultado final da fase preparatória é um arquivo de mapeamento que é gerado no Jazz Team Server de origem original. Depois de revisar e editar o arquivo de mapeamento cuidadosamente, copie-o para o diretório JazzInstallDir\server no Jazz Team Server de destino no ambiente de temporariedade.

  2. Faça backup do ambiente de produção versão 4 e copie os índices de texto e os arquivos de configuração de aplicativo para o servidor de temporariedade de destino.

    Como é necessário parar os servidores de produção ao executar essas etapas, certifique-se de escolher um momento conveniente para executar o backup, preferencialmente um pouco antes de configurar o ambiente de temporariedade. Se forem feitas mudanças no ambiente de produção antes que você prossiga para a renomeação real, será necessário gerar novamente o arquivo de mapeamento antes de importá-lo para o servidor de temporariedade. Enquanto os servidores estiverem inoperantes, os usuários não poderão criar ou atravessar links de nenhum sistema externo que esteja integrado à implementação do CLM que está prestes a ser renomeada.

    1. Pare o Jazz Team Server e quaisquer aplicativos CLM distribuídos que estejam registrados com o Jazz Team Server no ambiente de produção.
    2. Faça backup de todos os bancos de dados no ambiente de produção do CLM 4.0, incluindo o banco de dados Jazz Team Server, os bancos de dados para os aplicativos CCM e QM, o banco de dados de armazém de dados e o banco de dados de armazenamento de conteúdo RRDI. Copie os bancos de dados da produção para o ambiente de temporariedade seguindo as etapas em Movendo o Banco de Dados CLM.
    3. Copie os índices JFS/text do servidor de produção de origem para o servidor de temporariedade de destino. (Para sistemas distribuídos, acesse o servidor adequado para copiar os arquivos).

      Os seguintes exemplos para um servidor Linux presumem que as unidades dos computadores de temporariedade estejam montados em rede. Se isso não for possível em seu ambiente, utilize outros métodos de transferência de arquivos 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 de produção de origem para o servidor de temporariedade de destino. (Para sistemas distribuídos, acesse o servidor adequado para copiar os arquivos). Como acontece com a etapa anterior, os exemplos a seguir para um servidor Linux pressupõem que as unidades dos computadores de temporariedade estejam 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.
      Nota: Se alguma mudança na configuração for feita na implementação do CLM antes de você executar a próxima etapa, você precisará gerar novamente o arquivo de mapeamento.
    6. Reinicie todos os servidores CLM e permita que os usuários continuem a usar o ambiente de produção. Todas as etapas restantes se aplicam ao ambiente de teste de temporariedade.
  3. Execute as etapas a seguir no ambiente de teste de temporariedade:
    1. Restaure os backups de banco de dados do ambiente de produção para o ambiente de temporariedade. É recomendável que você use um servidor de banco de dados separado no ambiente de temporariedade para evitar desgaste do servidor de banco de dados de produção.
    2. Substitua os parâmetros de conexão com o banco de dados nos arquivos JazzInstallDir/server/conf/applicationName/teamserver.properties de forma que eles apontem para os parâmetros de conexão da cópia de temporariedade do banco de dados no ambiente de teste. Eles incluem as entradas para o banco de dados jts, os bancos de dados dos aplicativos ccm e qm, o banco de dados de armazém de dados e as senhas atualizadas.
    3. Como uma precaução adicional para os mapeamentos simulados no arquivo de mapeamento, se for permitido em seu ambiente, atualize o arquivo hosts para evitar o acesso às URLs do sistema de produção e evitar edições acidentais em artefatos no servidor de produção.

      O objetivo aqui é resolver os nomes do host para um endereço IP falso que não esteja sendo utilizado por nenhum dos servidores CLM no ambiente de produção. Assim, se um servidor no ambiente de temporariedade tentar estabelecer uma conexão com um servidor de produção, a conexão falhará.

      Faça uma lista de todos os nomes de host distintos que aparecem em seu arquivo de mapeamento. Podem ser URLs de origem ou afetadas. Para cada nome de host individual, crie uma entrada no arquivo de hosts que mapeia o nome do host para um endereço IP falso. É necessário editar o arquivo de hosts para todos os servidores em seu ambiente de temporariedade, incluindo servidores de terceiros e estações do cliente. O arquivo de host a seguir mostra entradas de amostra para seu servidor de temporariedade:

       # 10.10.10.10 refers to an IP address that does not host a clm application. 
        10.10.10.10   ProductionServerP1
        10.10.10.10   ProductionServerP2
        10.10.10.10   ProductionServerP3
    4. Abra um prompt de comandos no diretório JazzInstallDir\server e importe o arquivo de mapeamentos para o Jazz Team Server de destino usando o comando repotools-jts -importURLMappings.
      • Se você tiver uma implementação tudo em um, importe o arquivo de mapeamento usando o comando repotools-jts -importURLMappings da seguinte maneira:

        For Windows operating system repotools-jts.bat -importURLMappings fromFile="C:\mappings.txt"

        For Unix operating systems ./repotools-jts.sh -importURLMappings fromFile="opt/mappings.txt"

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

      • 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="C:\mappings.txt" serverConfFile="C:\serverConf.txt"

        For Unix operating systems ./repotools-jts.sh -importURLMappings fromFile="/opt/mappings.txt" serverConfFile="/opt/serverConf.txt"

      • Se você tiver uma implementação do CLM distribuída e não tiver permissão para remapear unidades de rede, continue com o comando repotools-jts -importURLMappings mostrado a seguir:

        For Windows operating system repotools-jts.bat -importURLMappings fromFile="C:\mappings.txt"

        For Unix operating systems ./repotools-jts.sh -importURLMappings fromFile="opt/mappings.txt"

        Em seguida, copie o arquivo server/conf/jts/.mappingEvent para os diretórios de configuração do aplicativo remoto server/conf/application_name), isto é, ccm, qm e rm. 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.

      Verifique se a renomeação foi bem-sucedida verificando a saída de console e o arquivo server/repotools-jts_importURLMappings.log. Se algum erro for exibido, ou se 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.

      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.
  4. Inicie o Jazz Team Server e quaisquer aplicativos CLM distribuídos que estejam registrados com o Jazz Team Server.

    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. Deve demorar 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://novo host:porta/jts/serverRenameStatus para verificar o status da renomeação.

    Aguarde até que todas as renomeações de aplicativo sejam concluídas e que a etapa Finalizar Renomeação do Servidor tenha sido concluída. Verifique se a mensagem a seguir é mostrada: A renomeação de servidor foi concluída com êxito. O Jazz Team Server e os aplicativos estão totalmente operacionais. Você pode começar a usar os servidores imediatamente e nenhuma reinicialização é necessária.

    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.
    Nota: Se tiver introduzido mapeamentos de simulação para proteger o ambiente de produção, você deverá ver erros sobre essa URL na seção Aplicativos e Amigos da página Diagnósticos do Aplicativo no servidor temporário.
  7. Opcional: Execute as etapas a seguir para configurar o Rational Reporting for Development Intelligence (RRDI) no ambiente de temporariedade:
    1. Faça backup dos seguintes bancos de dados do ambiente de produção e restaure-os em um novo servidor de banco de dados para a nova instalação do RRDI no ambiente de temporariedade:
      • O banco de dados de armazenamento de conteúdo (por exemplo, RICM)
      • 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 temporariedade. 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 atualize 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 para apontar para o servidor de relatório RRDI temporário.
      Nota: Esta etapa só será necessária se o arquivo de mapeamento não tiver as URLs para o RRDI.
    5. Verifique se todos os relatórios importados anteriormente do servidor de relatório RRDI de produção continuam funcionando.
    6. ~Todos os relatórios Cognos ou visualizações de relatório com ação configurada para Visualizar relatório mais recente, devem ser executados novamente depois que a renomeação do servidor CLM tiver o relatório HTML em cache atualizado.
      1. Efetue logon no servidor de relatório RRDI.
      2. Procure os relatórios ou visualizações de relatório com versões de saída em cache.
        Nota: Se uma versão de saída em cache existir para um relatório ou visualização de relatório, será possível clicar em Visualizar as Versões de Saída desse relatório para visualizar os relatórios em cache. Se os relatórios ou visualizações de relatório foram gerados antes da renomeação do servidor CLM, você deverá executar novamente os relatórios ou visualizações de relatório para atualizá-los. Caso contrário, os usuários que estiverem executando os relatórios ou visualizações de relatório verão links inválidos 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 em cache associadas aos relatórios ou visualizações de relatório.
    7. Importe um novo relatório a partir do servidor de relatório RRDI temporário. 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. Se você estiver incluindo outros componentes em seu ambiente de temporariedade, tais como o Jazz Build Engines, clientes Rational Team Concert, Rational ClearQuest ou Rational ClearCase, execute as etapas adicionais necessárias. Para obter detalhes, consulte Restrições e Informações Adicionais.

Feedback