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
- Para ativar a renomeação do servidor você deve obter um arquivo-chave de recurso, chamado
ImportURLMappings.activate, do Suporte de Software IBM®. Em seguida, você deverá copiar o arquivo no diretório server.
Ao entrar em contato com o suporte IBM, certifique-se de mencionar que você está solicitando um Arquivo-chave de Recurso de Renomeação do Servidor.
- Para um estudo de caso sobre como alterar a raiz de contexto, consulte https://jazz.net/library/article/1148.
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
- 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. .
- 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.
- 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
- 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.
- 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.
- 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.
- Opcional: Atualize o nome de todos os aplicativos renomeados.
- Efetue login na UI administrativa do
Jazz Team Server
e acesse .
- Clique em Editar e renomeie cada aplicativo com sua nova raiz
de contexto ou com qualquer outro nome de sua escolha.