Alterando a Raiz de Contexto

Em vez de alterar o nome do host ao executar uma renomeação do servidor, é possível alterar apenas a raiz de contexto.

Antes de Iniciar

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. Para obter informações adicionais sobre como alterar a raiz de contexto, consulte Estudo de Caso: Renomeação do Servidor.

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 Customizados de Raiz de Contexto e insira seus valores customizados de raiz de contexto. Mesmo que você esteja apenas renomeando a raiz de contexto para um único aplicativo, deverá instalar todos os aplicativos que pretende executar. .
  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 configuração, mesmo que você não esteja renomeando a raiz de contexto de um aplicativo específico.
    Nota: Se você tiver alterado as raízes de contexto na instalação antiga, substitua estes exemplos padrão por 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 índices.
    • Em server/conf/relm, copie teamserver.properties e o diretório índices.
    • Em server/conf/lqe, copie teamserver.properties e o diretório índices.
    • Em server/conf/sparql, copie fronting.properties e o diretório indices.
  3. Assegure-se de que as seguintes propriedades do banco de dados nos arquivos teamserver.properties 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 do texto relativo para usar o novo local. Certifique-se de incluir a nova raiz de contexto no caminho.
    com.ibm.team.fulltext.indexLocation=conf/new_context_root/indices/workitemindex
  4. Se você estiver usando o WebSphere Application Server, desinstale os aplicativos da instalação antiga e instale-os na nova instalação. Além disso, atualize o JAZZ_HOME para apontar para a nova instalação.
  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 com relação à antiga instalação, que serve apenas como um backup, até ter certeza de que a nova instalação esteja 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