Fazendo Upgrade ou Reinstalando o ClearQuest em uma Implementação de Procura de Texto Completa com Diversos Perfis do WebSphere

O IBM Installation Manager não reconhece os perfis do WebSphere Application Server associados com o recurso de procura de texto completa. Consequentemente, se você planeja fazer upgrade ou reinstalar o IBM Rational ClearQuest, use o comando cqtsadmin.pl para fazer backup e excluir estes perfis. Após fazer upgrade ou reinstalar o ClearQuest, use o comando cqtsadmin.pl novamente para restaurar os perfis.

Antes de Iniciar

Este cenário inclui etapas para executar antes e depois de fazer upgrade ou atualizar ou reinstalar o ClearQuest.

O cenário assume que você está usando o banco de dados SAMPL. Em um ambiente de produção, as etapas de pré-upgrade ou pré-instalação e as etapas de pós-upgrade ou pós-reinstalação podem levar de alguns minutos a algumas horas para serem concluídas, dependendo do número de perfis do WebSphere Application Server de procura de texto completa em sua implementação. Para cada perfil, as etapas devem levar alguns minutos para serem concluídas.

Observe que é possível executar o comando cqtsadmin.pl com relação a qualquer instância de procura de texto completa no servidor porque o comando é global para todas as implementações de procura de texto completa no servidor. Após o comando cqtsadmin.pl se concluído com relação a uma implementação de procura de texto completa, as outras implementações no servidor serão atualizadas.

Procedimento

  1. Execute as tarefas pré-upgrade ou pré-instalação a seguir.
    1. Edite o arquivo de configuração cqtsadmin-TextSearch-SAMPL.xml. Altere o valor da tag <deleteFtsWASProfiles> disto:

      <newValue required="no"><newValue>

      para esta:

      <newValue required="no">true<newValue>

    2. Execute o comando cqtsadmin.pl, com a opção prep_upgd_was_profiles, em uma janela de prompt de comando. Esta opção da linha de comandos criar um backup de todos os dados do seu perfil WebSphere Application Server de procura de texto completa no servidor e, então, exclui os perfis. Os dados armazenados em backup são salvos no diretório FTSBackupWASProfiles.
    3. Edite o arquivo cqtsadmin-TextSearch-SAMPL.xml novamente. Altere o valor da tag <deleteFtsWASProfiles> disto:

      <newValue required="no">true<newValue>

      para esta:

      <newValue required="no"><newValue>

    A edição impede que acidentalmente execute novamente esta opção da linha de comandos destrutiva.

  2. Faça upgrade ou reinstale o ClearQuest.
  3. Execute o cqtsadmin.pl comando novamente para restaurar todos os perfis do WebSphere Application Server de procura de texto completa implementados e armazenados em backup anteriormente. Há dois cenários de caso de uso:
    • Cenário A: Restaurar todos os perfis do WebSphere Application Server de procura de texto completa anteriormente implementados e armazenados em backup usando a opção de linha de comandos restore_was_profiles:

      cqperl cqtsadmin.pl --username admin --password secret --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --restore_was_profiles D:\FTSBackupWASProfiles

    • Cenário B: Restaurar todos os perfis do WebSphere Application Server de procura de texto completa anteriormente implementados e armazenados em backup e consolidar estes perfis em um diretório, usando as opções de linhas de comandos restore_was_profiles e fts_was_profile_home, respectivamente:

      cqperl cqtsadmin.pl --username admin --password secret --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --restore_was_profiles D:\FTSBackupWASProfiles --fts_was_profile_home D:\FTS.wasprofiles


Feedback