Este tópico descreve as etapas necessárias para fazer upgrade do ClearQuest Synchronizer do release anterior para o release atual.
Procedimento
- Desative a sincronização de saída para a conexão do repositório
externo. No cliente do
Rational
Team Concert
para Eclipse IDE, mostre a visualização Regras de Sincronização. Expanda o nó Conexões do Repositório
Externo. Dê um clique duplo na conexão do repositório externo para abri-lo. Selecione Desativar sincronização de saída automática. Clique em OK.
- Desative a sincronização de saída para o
Jazz
Team Server.
Na página de administração do cliente da Web, clique em Propriedades
Avançadas. Role para o componente Interoperação do Item.
Para com.ibm.team.interop.service.internal.InteropService, clique em
Editar. Para Sincronização de Saída
Ativada, selecione falso na lista
suspensa. Clique em Salvar.
- Pare o ClearQuest Gateway.
- Pare o Jazz
Team Server.
- Faça o upgrade do servidor. Consulte Atualizando a Partir da Versão 2 (Processo de Duas Etapas) ou Atualizando para a Versão
4.0.
- Inicie o servidor e verifique o seguinte:
- É possível fazer login com a conta de usuário Jazz
que o ClearQuest Connector usa e é possível
realizar conexão com a área do projeto.
- A conexão do repositório externo existe. Consulte a visualização Regras
de Sincronização.
- As regras de sincronização existem. Consulte a visualização
Regras de Sincronização.
- Os itens de trabalho criados e sincronizados anteriormente com os registros
do ClearQuest existem.
- O Jazz
Team Server ainda
está configurado para desativar a sincronização de saída.
- Instale a nova versão do
ClearQuest Synchronizer.
Consulte o Instalando o Rational Team Concert ClearQuest Synchronizer Utilizando o IBM Installation Manager.
Nota: Se estiver fazendo upgrade a partir da versão 3.X, é possível usar a opção Atualizar no Installation Manager. Se estiver fazendo upgrade a partir da versão 2.X, você deve escolher a opção Instalar e, em seguida, desinstalar a versão 2.X (consulte
Etapa 17). A partir da versão 3.0, o diretório de instalação padrão é chamado de ClearQuest Synchronizer em vez de ClearQuest Connector.
- Navegue para o diretório install-directory/ClearQuest
Synchronizer/gateway e inicie o ClearQuest Gateway.
- Pare o ClearQuest Gateway. Iniciar e parar o ClearQuest Gateway
cria o diretório
install-directory/ClearQuest Synchronizer/gateway/tomcat/webapps/cqconnector.
- Se estiver fazendo upgrade a partir da versão 2.X, copie do diretório de instalação do ClearQuest Connector 2.0.0.2x para o diretório de instalação do ClearQuest Synchronizer qualquer arquivo configurável do usuário que tenha sido modificado. Especialmente, copie:
- cqconnector.properties de install-directory/ClearQuestConnector/gateway
para install-directory/ClearQuestSynchronizer/gateway.
- log4j.properties de install-directory/ClearQuestConnector/gateway
para install-directory/ClearQuestSynchronizer/gateway.
- tomcat-users.xml de install-directory/ClearQuestConnector/gateway/tomcat/conf
para install-directory/ClearQuestSynchronizer/gateway/tomcat/conf.
- web.xml de install-directory/ClearQuestConnector/gateway/tomcat/webapps/cqconnector/WEB-INF
para install-directory/ClearQuestSynchronizer/gateway/tomcat/webapps/cqconnector/WEB-INF.
Se estiver fazendo upgrade a partir da versão 3.X e escolher a opção Atualizar no Installation Manager, os arquivos de configuração modificados serão armazenados em um diretório de backup. Copie os arquivos de configuração modificados do diretório de backup para o novo diretório de instalação.
Nota: O
arquivo server.xml usado em liberações anteriores à 4.0 não é compatível com
o 4.0. Portanto, não é possível copiá-lo de install-directory/ClearQuestConnector/gateway/tomcat/conf
ou do diretório de backup para install-directory/ClearQuestSynchronizer/gateway/tomcat/conf.
Em vez disso, edite o arquivo server.xml 4.0 no novo diretório de instalação
(install-directory/ClearQuestSynchronizer/gateway/tomcat/conf)
para que ele contenha quaisquer mudanças que você tinha feito para a versão anterior.
- Opcional. Aplique a versão mais recente do pacote JazzInterop para seu
esquema ClearQuest e, em seguida,
faça o upgrade do banco de dados do usuário do ClearQuest
com a nova versão do esquema. Consulte
Fazendo upgrade do banco de dados do usuário com uma nova versão do pacote JazzInterop para obter detalhes.
- Inicie o ClearQuest
Gateway.
- Verifique o status do Gateway acessando a página de status em
http://host-name.example.com:8081/cqconnector/gateway.
A página deve mostrar que o Gateway está aceitando todos os pedidos.
- Ative a sincronização de saída da conexão do repositório externo.
- Ative a sincronização de saída para o servidor.
- Verifique se a sincronização funciona executando as seguintes
etapas:
- Crie diversos registros no banco de dados do usuário do
ClearQuest. Verifique se os
itens de trabalho correspondentes estão criados na área de projeto do
Rational
Team Concert.
- Crie diversos itens de trabalho na área de projeto. Verifique se os registros correspondentes são criados no banco de dados do usuário do ClearQuest.
- Edite diversos itens de trabalho que foram sincronizados no release
anterior. Verifique se as mudanças são propagadas para os registros ClearQuest correspondentes.
- Edite diversos registros ClearQuest que foram
sincronizados no release anterior. Verifique se as mudanças são propagadas para os itens
de trabalho correspondentes.
- Se estiver fazendo upgrade a partir da versão 2.X ou não tiver escolhido a opção Atualizar no Installation Manager, desinstale a liberação anterior do ClearQuest Connector. A operação
de desinstalação deve criar um diretório chamado backup-config-timestamp no
diretório install-directory/ClearQuestConnector.
Verifique se este diretório contém os seguintes diretórios e arquivos:
- gateway/cqconnector.properties
- gateway/log4j.properties
- gateway/tomcat/conf (diretório contém diversos arquivos e um diretório
Catalina)
- gateway/tomcat/webapps/cqconnector/WEB-INF/web.xml