Atualizando o ClearQuest Synchronizer

Este tópico descreve as etapas necessárias para fazer upgrade do ClearQuest Synchronizer do release anterior para o release atual.

Procedimento

  1. 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.
  2. 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.
  3. Pare o ClearQuest Gateway.
  4. Pare o Jazz Team Server.
  5. 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.
  6. 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.
  7. 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.
  8. Navegue para o diretório install-directory/ClearQuest Synchronizer/gateway e inicie o ClearQuest Gateway.
  9. Pare o ClearQuest Gateway. Iniciar e parar o ClearQuest Gateway cria o diretório install-directory/ClearQuest Synchronizer/gateway/tomcat/webapps/cqconnector.
  10. 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.

  11. 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.
  12. Inicie o ClearQuest Gateway.
  13. 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.
  14. Ative a sincronização de saída da conexão do repositório externo.
  15. Ative a sincronização de saída para o servidor.
  16. 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.
  17. 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

Feedback