Considerações para atualizar componentes do servidor ClearQuest

Revise as mudanças no ClearQuest versão 8.0 que afetam os processos de instalação, upgrade e configuração de componentes do servidor da web ClearQuest. Essas mudanças afetam os processos de instalação, configuração e administração dos componentes do servidor ClearQuest, como Rational ClearQuest Web, Relatório, Procura de Texto Completo e autenticação.

Atualizando o servidor ClearQuest CM da versão 7.x para o servidor da web ClearQuest versão 8.x

No ClearQuest versão 8.0, o novo nome do ClearQuest CM e servidor da web ClearQuest. O processo de instalação dos componentes do servidor ClearQuest também foi alterado para que seja possível gerenciar e configurar os ambientes WebSphere Application Server e IBM® HTTP Server independente do ambiente ClearQuest.

Como resultado, você deve instalar o software do WebSphere Application Server e IBM HTTP Server separadamente antes de atualizar qualquer componente do servidor ClearQuest. Essa mudança afeta estes componentes do servidor ClearQuest:

  • Servidor ClearQuest CM
  • Servidor de Procura de Texto Completa
  • Report Launcher for ClearQuest
  • Servidor de Relatório para Relatórios Crystal

Instalando o WebSphere Application Server e o IBM HTTP Server

Para poder atualizar os componentes do servidor ClearQuest, você deve instalar o software do WebSphere Application Server e IBM HTTP Server. Decida se deve ser instalada a versão 7.0 ou versão 8.0:
  • Se você selecionar o WebSphere Application Server e o IBM HTTP Server versão 7.0, será possível atualizar para qualquer liberação do ClearQuest 8.0.0.x.
  • Se você selecionar o WebSphere Application Server e o IBM HTTP Server versão 8.0, deverá atualizar para o ClearQuest versão 8.0.0.1 ou mais recente.
Dica:
  • Seja cuidadoso ao substituir as designações de número de porta padrão durante o processo de upgrade. Durante as operações de upgrade ou instalação, os números de porta padrão são designados para assegurar que cada porta seja exclusiva. Por exemplo, se a porta padrão para o perfil AppSrv01 criado no WebSphere Application Server versão 7.0 for a porta 9080, quando você atualizar para a versão 8.0, a porta padrão designada a AppSrv01 será 9081. Se você substituir o número de porta padrão, estará arriscando a introduzir conflitos de número de porta.
  • Não é possível modificar as configurações de segurança de perfil durante um upgrade. Use o console do WebSphere Application Server para gerenciar a segurança administrativa do WebSphere Application Server.
  • Reinicie o Installation Manager entre operações sucessivas se você não for solicitado a reiniciar o sistema.
Restrição:

Como a arquitetura de servidor de aplicativos e o processo de instalação do ClearQuest são diferentes entre as versões, a operação de retrocesso não é suportada para esses cenários de upgrade.

  • Atualize do ClearQuest versão 7.x para versão 8.x.
  • Atualize de uma implementação do ClearQuest versão 8.0 no WebSphere Application Server 7.0 para uma implementação do ClearQuest versão 8.0.0.x com o WebSphere Application Server 8.0.
Nesses casos, a única maneira de restaurar a versão anterior é remover completamente a nova versão e reinstalar a anterior do produto

ClearQuest Report Server e Componentes de Relatório

O ClearQuest versão 8.0 introduz uma nova estratégia de relatório que poderá afetar o processo de upgrade. Se o seu plano de upgrade tiver suporte para atualização e inclusão de relatório do Rational ClearQuest, consulte ../../com.ibm.rational.clearquest.reporting.doc/topics/c_reporting_ovw.htm#c_admin_cqw__cq_reporting_chngs para obter informações sobre essas mudanças.

O ClearQuest Web, Report Launcher e Report Server são todos incluídos no mesmo perfil do WebSphere Application Server. Quando você atualiza ou move para um novo perfil do WebSphere Application Server, todos esses componentes devem ser atualizados ou movidos juntos.

Atualizando a Procura de Texto Completo

Se sua implementação do ClearQuest Web incluir o componente Procura de Texto Completo, você deverá executar algumas etapas antes de atualizar ou aplicar fix packs. Essas etapas asseguram um upgrade bem-sucedido e preservam a configuração e os dados da procura de texto completo após o novo software ser instalado. As etapas requeridas dependem da versão do ClearQuest a partir da qual você está atualizando e de como o recurso de procura de texto completo foi configurado.

Upgrade do ClearQuest versão 7.1.x para a versão 8.x

Se você tiver feito download e instalado a ferramenta Administrador de Procura de Texto Completo do ClearQuest 7.1.x no website de download do DCF, será necessário remover ou renomear o script de procura de texto completo cqtsadmin.pl e o diretório CQTsAdmin no diretório home do ClearQuest 7.1.x antes de atualizar esse componente. O local padrão desses recursos é:
  • Windows:C:\Program Files\IBM\RationalSDLC\ClearQuest\
  • UNIX/Linux:/opt/ibm/RationalSDLC/clearquest/

Se a ferramenta Administrador de Procura de Texto Completo não foi usada para a implementação da Procura de Texto Completo original, consulte a Nota técnica nº 1515900 Atualizando e Migrando a Procura de Texto Completo do ClearQuest 7.1.x para o ClearQuest 8.0 quando a ferramenta Administrador de Procura de Texto Completo não foi usada para a implementação da Procura de Texto Completo original

Atualizando ou aplicando fix packs para implementações do ClearQuest versão 8.x

Durante o processo de instalação do ClearQuest versão 8.x, o software para o recurso de Servidor de Procura de Texto Completo é copiado no perfil do WebSphere para o aplicativo da web ClearQuest. Após a instalação, configure a procura de texto completo para seu ambiente. Para preservar essas informações ao atualizar, remover o recurso ou aplicar fix packs, você deve fazer backup e restaurar a configuração e os dados da procura de texto completo. Esses comandos estão disponíveis para backup e restauração das informações de procura de texto completo:
  • cqtsadmin.pl -prep_upgd_was_profiles
  • cqtsadmin.pl --restore_was_profiles

Se você estiver atualizando as versões do ClearQuest e WebSphere Application Server, instale o WebSphere Application Server 8.0 antes de fazer backup do perfil do WebSphere. Em seguida, atualize o ClearQuest. Por exemplo, é possível seguir esse processo ao fazer upgrade da versão do ClearQuest 8.0 para 8.0.0.1 e do WebSphere Application Server versão 7.0 para 8.0.

Atualizando ambientes configurados para autenticação de cartão inteligente

Se você estiver atualizando uma implementação do ClearQuest Web configurada para autenticação de cartão inteligente e desejar incluir recursos para ativar a autenticação de cartão inteligente para integrações do OSLC, será necessário atualizar e reimplementar o arquivo do descritor de implementação do ClearQuest Web, web.xml. Essa tarefa pode ser executada após o upgrade do software do servidor. Para obter instruções, consulte Configuring client certificate authentication for ClearQuest Web.


Feedback