Atualizando o Rational Engineering Lifecycle Manager

Para fazer upgrade de sua versão do Rational Engineering Lifecycle Manager para a versão mais recente, você fará uma instalação lado-a-lado da nova versão.

Antes de Iniciar

Se você estiver atualizando produtos integrados ao Rational Engineering Lifecycle Manager, assegure-se de seguir a orientação no Atualizar a Pilha de Produtos do Rational Engineering Lifecycle Manager

Procedimento

  1. Instale o Rational Engineering Lifecycle Manager utilizando as instruções em Instalar o Rational Engineering Lifecycle Manager e o Lifecycle Query Engine. Isso instalará:
    • Rational Engineering Lifecycle Manager v4.0.6
    • Jazz Team Server v 4.0.6
    • O aplicativo de Gerenciamento de Configuração
    Importante:
    • Certifique-se de selecionar um grupo de pacote e diretório diferentes da instalação original.
    • Assegure-se de selecionar a mesma raiz de contexto que a instalação anterior.
  2. Se você estiver usando o WebSphere Application Server, conclua o seguinte.
    1. Faça backup do perfil do WebSphere Application Server. Abra um prompt de comandos e altere para a pasta bin do diretório de instalação do WebSphere Application Server. Por exemplo, C:\Program Files\IBM\WebSphere\AppServer\profiles\AppSrv01\bin. Execute o comando a seguir. Observe que se a segurança do WebSphere Application Server estiver ativada, você deverá fornecer também o nome de usuário e a senha:
      backupConfig.bat <Caminho para um novo arquivo compactado para criar o backup do perfil> <nome do usuário administrativo primário do WAS> <senha administrativa do WAS>
      Por exemplo, backupConfig.bat C:\WAS_backup\clm_40_profile.zip -username WAS admin -password WAS admin password.
    2. Desinstale os aplicativos existentes do WebSphere Application Server. Para desinstalar os arquivos war do aplicativo, acesse cada servidor de aplicativos e execute as etapas a seguir.
      1. Efetue logon no WebSphere Application Server Integrated Solutions Console em https://hostname:9043/ibm/console/logon.jsp.
      2. Clique em Aplicativos > Tipos de Aplicativos > Aplicativos Corporativos do WebSphere.
      3. Pare e desinstale os seguintes aplicativos: relm.war, vvc.war, lqe.war, SPARQL_Gateway.war
      4. Quando solicitado, salve as mudanças na configuração principal.
    3. Atualize as propriedades customizadas do JAZZ_HOME e log4j.configuration.
      1. Efetue logon no WebSphere Application Server Integrated Solutions Console em https://hostname:9043/ibm/console/logon.jsp.
      2. Clique em Servidores>Tipos de Servidores>WebSphere Application Servers.
      3. Clique no nome do servidor para abri-lo. O nome do servidor padrão é server1.
      4. Sob a seção Infraestrutura do Servidor, clique em Gerenciamento de Java e Processos > Definição de Processo.
      5. Sob Propriedades Adicionais, clique em Java Virtual Machine.
      6. Altere o caminho para o Lifecycle Query Engine e SPARQL Gateway para o novo local.
      7. Localize o campo de texto de arquivos do Generic JVM, e inclua essa variável de ambiente para o processo de inicialização da JVM: -Dlqe.config.location=file://unidade:\pasta_de_instalação_do_lqe\server\conf\lqe
      8. Sob Propriedades Adicionais, clique em Propriedades Customizadas.
      9. Clique em JAZZ_HOME e atualize seu valor para file:///4.0.6_install_dir/server/conf. Por exemplo, file:///C:/PROGRA~2/IBM/JazzTeamServer_4.0.6/server/conf.
      10. Clique em log4j.configuration e atualize seu valor para file:///4.0.6_install_dir/server/conf/startup_log4j.properties. Por exemplo, file:///C:/PROGRA~2/IBM/JazzTeamServer_4.0.6/server/conf/startup.log4j.properties.
      11. Se você estiver se conectando a um banco de dados Oracle, assegure-se de que ORACLE_JDBC_DRIVER_FILE esteja apontando para o arquivo do driver JDBC correto.
      12. Quando solicitado, salve as mudanças na configuração principal.
    4. Pare o WebSphere Application Server.
    5. Limpe os diretórios temporários do WebSphere Application Server. Acesse cada servidor de aplicativos e remova os conteúdos relacionados do Rational Engineering Lifecycle Manager dos seguintes diretórios wscache e temp no perfil. Dependendo dos aplicativos instalados anteriormente, os diretórios a seguir estão presentes no perfil e podem ser removidos: relm_war, lqe_war, sparql e dados relacionados ao vvc.
      Raiz_do_perfil_do_WAS\wscache (por exemplo: C:\Program Files\IBM\WebSphere\AppServer\profiles\AppSrv01\wscache)
      Raiz_do_perfil_do_WAS\temp (por exemplo: C:\Program Files\IBM\WebSphere\AppServer\profiles\AppSrv01\temp)
    6. Limpe o diretório de logs. Acesse cada servidor de aplicativos e remova os logs relacionados ao Rational Engineering Lifecycle Manager do diretório de logs no perfil. Um diretório de logs típico pode ser: C:\Program Files\IBM\WebSphere\AppServer\profiles\AppSrv01\logs
  3. Para migrar seu banco de dados:
    Opção Descrição
    Derby Exclua os bancos de dados Derby que foram instalados com o upgrade e os substitua pelos arquivos Derby da instalação original.
    rm -rf $newRELMHome/server/conf/jts/derby/repositoryDB
    rm -rf $newRELMHome/server/conf/jts/indices
    rm -rf $newRELMHome/server/conf/relm/derby/repositoryDB
    rm -rf $newRELMHome/server/conf/vvc/derby/repositoryDB
    cp -R $oldRELMHome/server/conf/jts/derby/repositoryDB $newRELMHome/server/conf/jts/derby
    cp -R $oldRELMHome/server/conf/jts/indices $newRELMHome/server/conf/jts
    cp -R $oldRELMHome/server/conf/relm/derby/repositoryDB $newRELMHome/server/conf/relm/derby
    cp -R $oldRELMHome/server/conf/relm/indices $newRELMHome/server/conf/relm
    cp -R $oldRELMHome/server/conf/vvc/derby/repositoryDB $newRELMHome/server/conf/vvc/derby
    cp -R $oldRELMHome/server/conf/vvc/indices $newRELMHome/server/conf/vvc
    DB2 ou Oracle Para obter instruções completas, consulte a documentação fornecida pelo fornecedor do banco de dados. A seguir, há um processo de amostra para DB2 que pode ser usado como uma diretriz.
    1. Pare o seu Jazz Team Server antigo.
    2. No DB2, localize os bancos de dados usados pela instalação anterior de aplicativos JTS.
    3. Faça backup de cada banco de dados utilizado por um aplicativo JTS.
    4. Clique com o botão direito do mouse em cada banco de dados e selecione Restaurar > Restaurar para novo banco de dados.
    5. Digite um nome para o banco de dados e selecione o diretório que contém o backup.
    6. Abra o arquivo <Dir_Instalação_do_Jazz>/server/conf/jts/teamserver.properties.
    7. Substitua o nome do banco de dados Jazz pelo nome fornecido por você, conforme mostrado no exemplo a seguir.
      #
      # Configuração do DB2
      #
      
      # Comente as linhas acima, remova o comentário das três linhas a seguir e customize o local de exemplo para utilizar o DB2
      #com.ibm.team.repository.db.vendor = DB2
      #com.ibm.team.repository.db.jdbc.location=//localhost:50000/JAZZ:fullyMaterializeLobData=false;user=db2admin;password={password};
      #com.ibm.team.repository.db.jdbc.password=db2admin
    8. Repita as etapas d-g para cada banco de dados que você precisa restaurar.
    9. Salve as alterações.
  4. Atualize o aplicativo Configuration Management usando o script vvc_upgrade.bat. Isso fará upgrade dos arquivos de configuração, arquivos de banco de dados, e reconstruirá os índices de texto. Para obter uma descrição detalhada de como fazer upgrade do aplicativo Configuration Management, consulte o guia de upgrade disponível em: Guia de Upgrade Interativo para Configuration Management Um exemplo dos parâmetros para Linux seria:
    cd $newRELMHome/server/
    upgrade/vvc/vvc_upgrade.sh -oldApplicationHome oldRELMHome/server/conf
    • Se estiver atualizando uma topologia de instalação distribuída (várias máquinas), você precisará incluir o parâmetro a seguir no script vvc_upgrade: -oldApplicationHome oldRELMHome/server/conf -ignoreJTSVersionCheck
    • Se você estiver usando o WebSphere Application Server, precisará incluir um parâmetro no script vvc_upgrade informando para não atualizar o Tomcat:-oldApplicationHome oldRELMHome/server/conf -ignoreJTSVersionCheck -updateTomcatFiles=no
    Nota: O aplicativo Configuration Management também pode ser instalado com o Rhapsody Design Manager. Quando você estiver instalando o Rational Engineering Lifecycle Manager também terá a opção de instalar o aplicativo Configuration Management - isso será útil se você desejar instalar o aplicativo em uma máquina diferente do Rhapsody Design Manager. Um desses deverá estar integrado ao Jazz Team Server. Se optar por instalar o componente em várias máquinas, tenha cuidado ao instalar e fazer upgrade do componente de que está selecionando o conector correto.
  5. Atualizar o Rational Engineering Lifecycle Manager executando relm_upgrade.sh
    $newRELMHome/server/upgrade/relm/relm_upgrade.sh -oldApplicationHome oldRELMHome/server/conf
    Isso irá executar três atualizações. A primeira irá atualizar os arquivos de configuração. A segunda irá atualizar os arquivos de banco de dados. A terceira irá recompilar os índices do texto.
    Nota: Você deverá configurar o parâmetro da versão anterior no script relm_params antes de executar o script de upgrade. Uma descrição desse parâmetro e dos outros parâmetros disponíveis pode ser localizada em: Referência do Script relm_upgrade.
  6. Qualquer informação de configuração para o Lifecycle Query Engine e o componente SPARQL Gateway deve ser transportado para a nova instalação. Você deve copiar manualmente as versões antigas para o novo Jazz Team Server.
    rm -rf $newRELMHome/server/conf/lqe
    cp -R $oldRELMHome/server/conf/lqe $newRELMHome/server/conf/lqe
    rm -rf $newRELMHome/server/conf/SPARQL_Gateway
    cp -R $oldRELMHome/server/conf/SPARQL_Gateway $newRELMHome/server/conf/SPARQL_Gateway
  7. Edite as propriedades do SPARQL Gateway para remover a propriedade DBLocation. No arquivo a seguir, remova a linha DBLocation: $newRELMHome/server/conf/SPARQL_Gateway/SPARQL_Gateway.properties
  8. Se você estiver usando o Oracle, assegure-se de que o ojdbc.jar (Driver JDBC) do Oracle esteja disponível no diretório a seguir: $newRELMHome\JazzTeamServer\server\oracle
  9. Se você estiver usando o WebSphere Application Server, implemente os arquivos relm.war, vvc.war, lqe.war e sparql_gateway.war. Reinicie o WebSphere Application Server.
  10. Inicie o Jazz Team Server.
  11. Abra a página de administração do LQE https://server:port/lqe/web/admin. Uma mensagem será exibida indicando que o LQE está no modo de upgrade e indisponível. Clique em Iniciar Upgrade. Quando isso for concluído, as origens de dados estarão disponíveis.
  12. Assegure-se de que um arquivo credentials.txt exista com o conteúdo a seguir: adminUserId, adminPassword, repositoryURL, smartCard, certificateFile Se ele ainda não existir, crie o arquivo. Por exemplo, o arquivo de credenciais deve ser semelhante ao seguinte:
    adminUserId=yourAdminUserId
    adminPassword=yourAdminPassword 
    repositoryURL=https://yourserver.com:9443/vvc 
    smartCard=<none>
    certificateFile=<none>
  13. Execute o seguinte comando a partir do diretório Configuration_Application_install_dir/server
    • Linux: ./repotools-vvc.sh -migration_vvc_updateResourcesCommand credentialsFile=credentials.txt
    • Windows: repotools-vvc.bat -migration_vvc_updateResourcesCommand credentialsFile=credentials.txt

O que Fazer Depois

Após fazer upgrade de todos os softwares necessários, o Lifecycle Query Engine poderá precisar reindexar o seu conteúdo. Novos vocabulários foram incluídos no Lifecycle Query Engine na versão 4.0.3 e, se você desejar que o Rational Engineering Lifecycle Manager use os dados incluídos nesses vocabulários, será necessário reindexar o aplicativo.
Tabela 1. Visão Geral dos Requisitos de Reindexação por Produto
Produto v1.x para v4.0.6 v4.0.3 para v4.0.6 v4.0.4 para v4.0.6 v4.0.5 para v4.0.6
Rational Team Concert A reindexação é necessária A reindexação não é necessária A reindexação não é necessária A reindexação não é necessária
Rational Quality Manager A reindexação é necessária Reindexação recomendada. Uma nova propriedade denominada oslc:shortld foi incluída em todos os recursos do QM. Se desejar usar esta propriedade em qualquer consulta, deverá reindexar. A reindexação não é necessária A reindexação não é necessária
Rhapsody Design Management A reindexação não é necessária, mas pode remover entradas de índice duplicado e ajudar a melhorar o desempenho. Reindexe se novos dados devem ser usados nas consultas. A reindexação não é necessária A reindexação não é necessária A reindexação não é necessária
Rational DOORS A reindexação é fortemente recomendada para dados de produção. A reindexação é recomendada se você tiver criado consultas com relação à URI mailto. Reindexação recomendada para dados de produção. A reindexação é recomendada se você tiver criado consultas com relação à URI mailto. A reindexação não é necessária A reindexação não é necessária
Rational DOORS Next Generation não-aplicável não-aplicável A reindexação não é necessária A reindexação não é necessária
Rational Engineering Lifecycle Manager A reindexação é necessária A reindexação é necessária A reindexação é necessária A reindexação é necessária
Jazz Team Server Users TRS (jts/trsUsers) A reindexação é necessária. A reindexação não é necessária A reindexação não é necessária A reindexação não é necessária

Feedback