Este tópico descreve as etapas para renomear uma pequena implementação de produção piloto ou integral.
Antes de Iniciar
Como o LQE não pode ser migrado automaticamente, ele deverá ser removido da lista de aplicativos registrados do
Jazz Team Server e o Jazz Team Server deverá ser reiniciado antes de começar o processo de renomeação do 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.
- Remova o Lifecycle
Query Engine como um aplicativo registrado.
- Pare o servidor do Lifecycle
Query Engine.
- Reinicie o Jazz Team Server.
Nota: Após a renomeação, o(s) servidor(es) de origem deverá(ão) ser retirado(s) permanentemente de serviço para evitar a contaminação do ambiente de produção.
Sobre Esta Tarefa
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 Arquivo de Mapeamento para Renomeação do Servidor para obter detalhes
adicionais sobre o arquivo 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.
O resultado final da fase preparatória é um arquivo de mapeamento gerado no
Jazz Team Server de origem.
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 de origem existente e copie os índices do texto e os arquivos de configuração de aplicativo na nova instalação de destino. Para sistemas distribuídos, acesse o servidor adequado para copiar os arquivos.
Nota: Se você estiver executando uma renomeação no local e não estiver movendo para o novo hardware, estará copiando o ambiente de uma instalação para uma segunda instalação no mesmo sistema.
- Pare o Jazz Team Server e os aplicativos distribuídos registrados com o Jazz Team Server.
Além disso, pare quaisquer outros aplicativos que estão afetados pela renomeação do servidor ou quaisquer integrações afetadas e suportadas.
Nota: Enquanto o(s) servidor(es) estiver(em) inoperante(s), os usuários não poderão criar ou
atravessar links de nenhum sistema externo que esteja integrado com a implementação do
Rational Engineering Lifecycle
Manager que está prestes a ser renomeado.
- Faça backup dos bancos de dados para o ambiente de origem, incluindo o banco de dados do Jazz Team Server,
os bancos de dados para os aplicativos, o banco de dados do armazém de dados.
Se você estiver alterando o fornecedor ou o servidor de banco de dados, consulte Movendo o Banco de Dados para as etapas adicionais.
- Copie os índices de JFS/texto da instalação de origem para a instalação de destino.
Os exemplos a seguir para um servidor Linux supõem que as unidades para os computadores de produção de destino sejam montadas 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/relm/indices TargetJazzInstallDir/server/conf/relm
- Copie os arquivos de configuração de aplicativo da instalação de origem para a instalação de produção de destino. Assim como
nas etapas anteriores, os exemplos a seguir são para um servidor Linux e supõem que as unidades dos computadores de produção de destino sejam montadas em rede.
cp SourceJazzInstallDir/server/conf/jts/teamserver*.properties TargetJazzInstallDir/server/conf/jts
cp SourceJazzInstallDir/server/conf/relm/teamserver*.properties TargetJazzInstallDir/server/conf/relm
cp SourceJazzInstallDir/server/conf/admin/admin.properties* TargetJazzInstallDir/server/conf/admin
cp SourceJazzInstallDir/server/conf/admin/friends.rdf* TargetJazzInstallDir/server/conf/admin
- Copie o arquivo de mapeamento para o diretório TargetJazzInstallDir\server no servidor de produção de destino. 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 distribuída e não tiver permissão para remapear as 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 do 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.
Verifique se a renomeação foi bem-sucedida verificando a saída do console e o arquivo
JazzInstallDir/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.
- Inicie o Jazz Team Server e quaisquer aplicativos distribuídos que estiverem instalados.
Neste ponto os aplicativos serão sincronizados com o Jazz Team Server para aplicar os mapeamentos da URL e atualizar seus dados do armazém de dados. Isso deverá 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://new host:port/jts/serverRenameStatus.
Isso inicia o processo de renomeação real. Quando a renomeação estiver concluída, será possível verificar a renomeação e executar qualquer ação corretiva que for necessária. Durante o processo de verificação, o Jazz Team Server e todos os aplicativos serão colocados no modo somente leitura, mas será possível procurar os dados e verificar links quebrados e URLs não mapeadas.
Consulte Verificando URLs e links após Uma Renomeação do Servidor para obter detalhes.
- Antes de concluir o processo de verificação, assegure-se de ter executado as verificações adicionais específicas ao produto descritas em Concluindo o Processo de Verificação de Renomeação do Servidor. Ao ter certeza de que os dados renomeados estão corretos, clique na caixa de seleção Verifiquei a Renomeação do Servidor... e clique em Concluir.
Neste ponto, o Jazz Team Server e todos os aplicativos registrados sairão do modo somente leitura e o uso normal do produto poderá continuar.
- Apenas produção completa: Se você tiver um segundo Jazz Team Server ou aplicativos adicionais vinculados ao Jazz Team Server renomeado,
deverá executar o repotools-jts -importURLMappings no segundo Jazz Team Server.
Essa etapa é necessária para atualizar os links do segundo servidor para o servidor renomeado.
Importante: Não gere um novo arquivo de mapeamento. Você deve usar o mesmo arquivo de mapeamento usado para o primeiro servidor renomeado.
- Copie o arquivo de mapeamentos editado do primeiro servidor para o segundo servidor.
Certifique-se de incluir todos os mapeamentos corretivos aplicados a partir do processo de verificação.
- Revise o arquivo de mapeamento e, se necessário, remova os pares de origem-destino que não desejar aplicar ao segundo servidor.
- Execute a renomeação no segundo servidor repetindo as Etapas de 3 até 6 no segundo Jazz Team Server.
O que Fazer Depois
Após as etapas nesta tarefa estarem prontas, conclua as etapas em
Concluindo a Renomeação do Servidor para o Lifecycle Query Engine para reincluir o LQE e gerar novamente o índice.