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.
- 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.
- 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.
- Pare o Jazz
Team Server e quaisquer
aplicativos CLM distribuídos que estejam registrados com o Jazz
Team Server no
ambiente de produção.
- 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.
- 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
- 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
- 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.
- 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.
- Execute as etapas a seguir no ambiente de teste de temporariedade:
- 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.
- 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.
- 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
- 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:
repotools-jts.bat -importURLMappings
fromFile="C:\mappings.txt"
./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.
repotools-jts.bat -importURLMappings
fromFile="C:\mappings.txt" serverConfFile="C:\serverConf.txt"
./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:
repotools-jts.bat -importURLMappings
fromFile="C:\mappings.txt"
./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.
- 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.
- 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.
- 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.
- Opcional: Execute as etapas a seguir para configurar o Rational
Reporting for Development Intelligence (RRDI) no ambiente de temporariedade:
- 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).
- 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.
- 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.
- 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.
- Verifique se todos os relatórios importados anteriormente do servidor de relatório RRDI de produção continuam funcionando.
- ~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.
- Efetue logon no servidor de relatório RRDI.
- 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.
- Clique em Executar com Opções para executar novamente os relatórios
ou visualizações de relatório.
- No visualizador de relatório, clique em para
atualizar as versões de saída em cache associadas aos relatórios ou visualizações de
relatório.
- 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.
- 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.
- 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.