RASCUNHO: Considerações para Fazer Upgrade de Recursos do Servidor ClearQuest

Antes de fazer upgrade ou aplicar fix packs, revise informações importantes que afetam os processos de upgrade, configuração e administração para recursos do servidor ClearQuest Web.

Os recurso de servidor ClearQuest Web, Full Text Search e de Relatório estão instalados no mesmo perfil do WebSphere Application Server (WebSphere Application Server). Ao fazer upgrade ou mover para um novo perfil do WebSphere Application Server, é necessário fazer upgrade e mover todos estes recursos juntos.
Importante: Se o ambiente ClearQuest inclui os recursos Full Text Search e Report Launcher, é necessário instalar a edição doWebSphere Application Server de 32 bits. Estes recursos não são suportados na edição do WebSphere Application Server de 64 bits. Para obter mais informações, consulte a Nota Técnica 1512059
Use estes links ou role a página para revisar informações mais detalhadas sobre upgrade de recursos do servidor ClearQuest.

Fazendo Upgrade do Servidor ClearQuest Web

Tabela 1 fornece uma visão geral do processo de upgrade para o servidor ClearQuest Web baseado na versão a partir da qual você está fazendo upgrade.
Tabela 1. Instruções de Upgrade do Servidor ClearQuest Web por Versão
Versões de software instaladas Visão geral do upgrade
ClearQuest versão 7.x No ClearQuest 8.x, o WebSphere Application Server é instalado separadamente do servidor ClearQuest Web, conhecido como o servidor ClearQuest CM no ClearQuest versão 7.x. A instalação separada permite que os ambientes do WebSphere Application Server e do IBM® HTTP Server sejam gerenciados de maneira independente do ambiente do ClearQuest. Se você estiver fazendo upgrade da versão 7.x, use o IBM Installation Manager para instalar uma versão suportada do WebSphere Application Server e do IBM HTTP Server antes de fazer upgrade dos recursos ClearQuest. Consulte o Preparando o Ambiente do WebSphere Application Server para Servidores da Web ClearCase e ClearQuest.
Restrição: Como a arquitetura do servidor de aplicativos e o processo de instalação doClearQuest são diferentes entre as versões, a operação de retrocesso não é suportada se você fizer upgrade do ClearQuest versão 7.x para a versão 8.x. Para restaurar a versão anterior, remova a nova versão e reinstale a versão anterior do produto.
ClearQuest versão 8.0 com o WebSphere Application Server 7.0
  1. Faça upgrade do WebSphere Application Server para a versão 8.5.
  2. Faça upgrade para o ClearQuest para a versão 8.0.1.
Restrição: A operação de retrocesso não é suportada se você fizer upgrade de uma implementação do ClearQuest 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. Para restaurar a versão anterior, remova a nova versão e reinstale a anterior.
ClearQuest versão 8.0.0.x, com o WebSphere Application Server versão 8.0 O ClearQuest versão 8.0.1 é suportado no WebSphere Application Server versão 8.0 e 8.5. Ao fazer upgrade, você tem duas opções:
  • Opção 1: Faça upgrade do Rational ClearQuest para a versão 8.0.1 sem fazer upgrade do WebSphere Application Server.
  • Opção 2: Faça upgrade do WebSphere Application Server para a versão 8.5, em seguida, faça upgrade do Rational ClearQuest para a versão 8.0.1.

Melhores Práticas e Dicas para Fazer Upgrade do Servidor ClearQuest Web

  • Antes de fazer upgrade, revise as Notas sobre a Liberação do ClearQuest para saber sobre quaisquer problemas ou limitações conhecidos relacionados à instalação e ao upgrade.
  • 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 do WebSphere Application Server versão 7.x for a porta 9080, ao fazer upgrade para a versão 8.0.x, a porta padrão que 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 do perfil durante o processo de upgrade do ClearQuest. Use o console do WebSphere Application Server para gerenciar a segurança administrativa do WebSphere Application Server.
  • Reinicie o IBM Installation Manager entre operações sucessivas se não for solicitado a reiniciar o sistema.

ClearQuest Report Server e Recursos 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 Relatando sobre Origens de Dados do Rational ClearQuest para obter informações sobre essas mudanças.

Atualizando a Procura de Texto Completo

Antes de fazer o upgrade ou aplicar fix packs em um ambiente da Web do ClearQuest com o recurso Full Text Search ativado, faça backup da configuração de procura de texto completo e dos dados de forma que seja possível restaurar o ambiente após a atualização do software. É necessário fazer backup destas informações antes de fazer upgrade do WebSphere Application Server e do servidor ClearQuest Web. O Tabela 2 fornece uma visão geral do processo de upgrade para caminhos de upgrade diferentes. Para obter informações adicionais, consulte Cenários para Definir e Configurar a Procura de Texto Completa.

Tabela 2. Instruções de Upgrade do ClearQuest Full Text Search por Versão
Versão do ClearQuest Visão geral do upgrade
ClearQuest versão 7.1.x a 8.0.x
  • Se você transferiu por download e instalou a ferramenta ClearQuest 7.1.x Full Text Search Administrator a partir do website de download do DCF, remova ou renomeie o script de procura de texto completo cqtsadmin.pl e o diretório CQTsAdmin no diretório inicial do ClearQuest 7.1.x antes de fazer upgrade deste recurso. Estes são os locais padrão para estes recursos:
    • Windows: C:\Program Files\IBM\RationalSDLC\ClearQuest\
    • UNIX/Linux:/opt/ibm/RationalSDLC/clearquest/
    Após renomear o diretório, continue com o processo de upgrade do ClearQuest.
  • Se a ferramenta Full Text Search Administrator não foi usada para a implementação original do Full-Text Search, consulte a Technote # 1515900 Upgrading and Migrating ClearQuest 7.1.x Full-Text Search to ClearQuest 8.0 when the Full-Text Search Administrator tool WebSphere para obter informações sobre upgrade do Full Text Search Server.
ClearQuest versão 8.0.0.1 ou posterior a 8.0.x Durante o processo de instalação doClearQuest versão 8.x, o software para o recurso Full Text Search Server é copiado no perfil do WebSphere Application Server para o aplicativo da web do ClearQuest. Para preservar estas informações ao fazer upgrade, remover o recurso ou aplicar fix packs, use o script cqtsadmin.pl do ClearQuest para fazer backup da configuração de procura de texto completa e dos dados. Após o upgrade, use o cqtsadmin.pl para restaurar os dados. Para obter instruções, consulte Fazendo Upgrade ou Reinstalando o ClearQuest em uma Implementação de Procura de Texto Completa com Diversos Perfis do WebSphere.
Importante: Para executar o comando cqtsadmin.pl, a variável de ambiente CQFTS_AppServer_HOME deve ser configurada para o diretório no qual o WebSphere Application Server está instalado.
Sob determinadas circunstâncias, tal como quando você instala o ClearQuest em um perfil existentes do WebSphere ou quando instalar o recurso de procura de texto completa em um sistema separado que acessa remotamente servidores ClearQuest Web, a variável de ambiente CQFTS_AppServer_HOME não é configurada e um erro semelhante a este é exibido:
Cannot determine WebSphere’s AppServer home. See the ClearQuest Full-Text Search Administrator Guide on how to set it via the CQFTS_AppServer_HOME environment variable.
Para resolver o problema, execute o comando a seguir para configurar o CQFTS_AppServer_HOME
  • No Windows: set CQFTS_AppServer_HOME=C:\Program Files\IBM\WebSphere\AppServer
  • No Linux: setenv CQFTS_AppServer_HOME /opt/IBM/WebSphere/AppServer

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

Se você estiver fazendo upgrade de uma implementação da web do ClearQuest que está configurada para autenticação de cartão inteligente e desejar incluir recursos para ativar a autenticação de cartão inteligente para integrações OSLC, é necessário atualizar e implementar novamente o arquivo descritor de implementação da web do ClearQuest, web.xml. Conclua esta tarefa após fazer upgrade do software do servidor. Para obter instruções, consulte Configurando a Autenticação por Certificado de Cliente para o ClearQuest Web.


Feedback