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.

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
- 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.
- 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.
- 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.
- 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.
- 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
- 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
- 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.
- 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.
- Se você tiver uma implementação tudo em um, importe o arquivo de mapeamentos usando
o comando repotools-jts -importURLMappings conforme a seguir:
repotools-jts.bat -importURLMappings
fromFile=".\mappings.txt"
./repotools-jts.sh -importURLMappings
fromFile="./mappings.txt"
A renomeação começará offline no Jazz
Team Server,
antes que o servidor seja 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=".\mappings.txt" serverConfFile=".\serverConf.txt"
./repotools-jts.sh -importURLMappings
fromFile="./mappings.txt" serverConfFile="./serverConf.txt"
- 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.
- 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.
- 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.
- Execute as etapas de verificação de renomeação do servidor descritas em Verificando Renomeação de Servidor.
- Opcional: Execute as etapas a seguir para configurar o
Rational Reporting for Development
Intelligence (RRDI) no ambiente de produção:
- 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).
- 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.
- 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 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.
- Verifique se todos os relatórios importados anteriormente do servidor de relatório
RRDI piloto continuam funcionando.
- 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.
- Efetue logon no servidor de relatório RRDI.
- 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.
- 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 armazenadas em cache associadas aos relatórios ou às visualizações de
relatório.
- 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.
- 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.
- 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.