Alterando a Raiz de Contexto

Este tópico fornece instruções sobre como alterar a raiz de contexto durante uma renomeação de servidor.

Sobre Esta Tarefa

Embora seja mais comum alterar o nome do host durante uma renomeação de servidor, também é possível alterar a raiz de contexto. Fazer isso requer uma nova instalação de servidor que espelha a antiga instalação, mas com novas raízes de contexto. Certifique-se de gerar um arquivo de mapeamento contra o servidor original, conforme detalhado em Preparando o Arquivo de Mapeamento. Altere as raízes de contexto necessárias neste arquivo de mapeamento.

Procedimento

  1. Use o Installation Manager para instalar uma versão 4 do Jazz Team Server separada. Quando chegar ao painel Opções de Raiz de Contexto, clique em Selecionar valores de raiz de contexto customizados e digite seus valores de raiz de contexto customizados. Mesmo se você estiver apenas renomeando a raiz de contexto para um único aplicativo, deve instalar todos os aplicativos que pretende executar. Para obter instruções de instalação adicionais, consulte Instalando com o IBM Installation Manager.
  2. Copie os arquivos de configuração a seguir da instalação antiga server/conf/oldContextRoot para a instalação nova server/conf/newContextRoot. Copie todos esses arquivos de aplicativos, mesmo se não estiver renomeando a raiz de contexto de um determinado aplicativo.
    Nota: Se você tiver alterado as raízes de contexto na instalação antiga, substitua os exemplos padrão a seguir pelas suas próprias versões customizadas.
    • Em server/conf/admin, copie admin.properties e friends.rdf.
    • Em server/conf/jts, copie: teamserver.properties e o diretório indices.
    • Em server/conf/ccm, copie teamserver.properties e o diretório indices.
    • Em server/conf/qm, copie: teamserver.properties e o diretório indices.
    • Em server/conf/rm, copie fronting.properties e friendsconfig.rdf.
  3. Assegure-se de que as seguintes propriedades do banco de dados nos arquivos teamserver.properties para CCM, QM e JTS estejam apontadas para os locais corretos do banco de dados.
    • com.ibm.team.repository.db.jdbc.location
    • com.ibm.team.datawarehouse.db.jdbc.location

    Finalmente, corrija o local de índices de texto relativo para utilizar o novo local, conforme mostrado abaixo. A nova raiz de contexto deve ser mostrada no caminho.
    com.ibm.team.fulltext.indexLocation=conf/new_context_root/indices/workitemindex
  4. Se estiver usando o WebSphere Application Server, é possível desinstalar os aplicativos da instalação antiga e instalá-los na nova instalação. Também é necessário atualizar JAZZ_HOME para apontar para a nova instalação. Para obter detalhes sobre a implementação de aplicativos para o WebSphere Application Server, consulte Implementando os Aplicativos da Solução Rational para Collaborative Lifecycle Management no WebSphere Application Server.
  5. Se você estiver usando o registro do usuário do Tomcat, copie o arquivo OldJazzInstallDir/server/tomcat/conf/tomcat-users.xml para o diretório NewJazzInstallLocation/server/tomcat/conf para sincronizar os usuários existentes.
  6. Siga as instruções de renomeação padrão, iniciando na etapa importURLMappings. Você deve executar o comando importURLMappings na nova instalação utilizando o arquivo de mapeamento gerado a partir da instalação antiga. Não execute nenhuma etapa adicional na antiga instalação, que serve apenas como um backup até que você tenha certeza de que a nova instalação está funcionando corretamente.
    Nota: É possível que a raiz de contexto antiga do aplicativo seja exibida na UI de status de renomeação do servidor. A UI exibe o nome do aplicativo registrado. Por padrão, o nome é a raiz de contexto. Portanto, se você nunca alterou o nome do padrão, a raiz de contexto antiga será mostrada.
  7. Opcional: Atualize o nome de todos os aplicativos renomeados.
    1. Efetue login na UI administrativa do Jazz Team Server e acesse Configuração > Aplicativos Registrados.
    2. Clique em Editar e renomeie cada aplicativo com sua nova raiz de contexto ou com qualquer outro nome de sua escolha.

Feedback