Atualizando o Rational Engineering Lifecycle Manager em execução com o Apache Tomcat

Para atualizar o Rational Engineering Lifecycle Manager, instale a nova versão do produto, atualize os arquivos de configuração, inclua ou atualize as tabelas nos repositórios do banco de dados existente e migre seus dados existentes para a versão 5.0.1.

Antes de Iniciar

Procedimento

  1. Instale o Rational Engineering Lifecycle Manager.
    Esta etapa instala:
    • Rational Engineering Lifecycle Manager 5.0.1
    • Jazz Team Server 5.0.1
    • 5.0.1 do aplicativo Configuration Management
    Importante:
    • Selecione um grupo de pacotes e um diretório diferentes da instalação original.
    • Selecione a mesma raiz de contexto da instalação anterior.

      Se você fizer upgrade do Rational Engineering Lifecycle Manager versão 5.0 ou de versões mais antigas, o Jazz Reporting Service existente ou a raiz de contexto do SPARQL Gateway será SPARQL_Gateway e o nome do arquivo do aplicativo será SPARQL_Gateway.war. Ao instalar o Rational Engineering Lifecycle Manager 5.0.1, selecione uma opção de raiz de contexto customizada e insira SPARQL_Gateway no campo Valores de Raiz de Contexto do Aplicativo.

  2. Pare seu servidor antigo do Tomcat.
  3. Faça backup ou migre 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 de backup de banco de dados para DB2 que pode ser usado como uma diretriz.
    1. Assegure-se de que seu Jazz Team Server antigo seja interrompido.
    2. No DB2, localize os bancos de dados que são usados pelas instalações anteriores dos aplicativos Jazz Team Server.
    3. Faça backup de cada banco de dados que é usado por um aplicativo Jazz Team Server.
    4. Salve as alterações.
    Para obter mais informações sobre como fazer backup e restaurar o banco de dados, leia a Documentação para o Rational Solution for Collaborative Lifecycle Management.
    SQL Server

    A seguir, há um processo de amostra de backup de banco de dados para SQL Server que pode ser usado como uma diretriz.

    • Assegure-se de que tenha o nome do usuário e senha corretos.
    • Assegure-se de que tenha feito backup do banco de dados antes de ter iniciado o processo de upgrade.
    • Confirme se o driver Java Database Connectivity (JDBC) está instalado e está usando sqljdbc4.jar. Na versão 5.0.1, o JRE versão 5.0 não é mais suportado. Somente o JRE versão 6.0 e 7.0 é suportado
    • Assegure-se de que o serviço SQL seja iniciado.
    Para obter instruções completas, consulte a documentação fornecida pelo fornecedor do banco de dados.
    Oracle Assegure-se de que o driver Oracle JDBC ojdbc.jar esteja disponível no diretório $newRELMHome/JazzTeamServer/server/oracle.
  4. Faça o upgrade do aplicativo Configuration Management.
    Execute o script vvc_upgrade para atualizar a configuração e os arquivos de banco de dados e para reconstruir os índices do texto. Este é um exemplo de parâmetros:
    cd $newRELMHome/server/
    upgrade/vvc/vvc_upgrade.sh -oldApplicationHome oldRELMHome/server/conf
    • Se você fizer upgrade de uma topologia de instalação distribuída (diversos servidores), inclua o parâmetro a seguir com o script vvc_upgrade:
      -oldApplicationHome oldRELMHome/server/conf -ignoreJTSVersionCheck
    Dica: O aplicativo Configuration Management também pode ser instalado com o Rhapsody Design Manager. Quando você estiver instalando o Rational Engineering Lifecycle Manager, você terá a opção de instalar o aplicativo Configuration Management - esta opção é útil se quiser instalar o aplicativo em um servidor diferente do Rhapsody Design Manager. Integre somente um aplicativo Configuration Management com o Rational Engineering Lifecycle Manager. Se optar por instalar o componente em diversos servidores, assegure-se de selecionar o componente correto para instalação e upgrade.
  5. Atualize Rational Engineering Lifecycle Manager.
    Execute o comando relm_upgrade.sh para os arquivos de configuração e banco de dados e reconstrua os índices de texto.
    $newRELMHome/server/upgrade/relm/relm_upgrade.sh -oldApplicationHome oldRELMHome/server/conf
  6. Transporte as informações de configuração do Lifecycle Query Engine e o Jazz Reporting Service existente ou do SPARQL Gateway para a nova versão de produto.
    Copie o conteúdo do diretório SPARQL_Gateway na instalação antiga para o novo diretório SPARQL_Gateway.
    cp -R $oldRELMHome/server/conf/SPARQL_Gateway/* $newRELMHome/server/conf/SPARQL_Gateway
    Caso esteja fazendo o upgrade da versão 5.0 para 5.0.1, prossiga para a Etapa 7.
    Caso esteja fazendo upgrade da versão 4.x para 5.0.1, use um editor de texto para incluir as seguinte propriedades em $newRELMHome/server/conf/SPARQL_Gateway/SPARQL_Gateway.properties.
    • support.query.editing=false
    • support.db.derby=false
    • support.dwse=false
    • query.results.limit=3000
    • query.results.cache.timeout=300
    • user.account.cache.timeout=480
    Remova app.properties de SPARQL_Gateway
    rm $newRELMHome/server/conf/SPARQL_Gateway/app.properties
    Renomeie SPARQL_Gateway.properties para app.properties.
    mv $newRELMHome/server/conf/SPARQL_Gateway/SPARQL_Gateway.properties $newRELMHome/server/conf/SPARQL_Gateway/app.properties
    Renomeie SPARQL_Gateway_runtime.properties para app_runtime.properties. (Por padrão, SPARQL_Gateway_runtime.properties não existe, mas você pode criar o arquivo caso precise definir a configuração de tempo limite da conexão.)
    mv $newRELMHome/server/conf/SPARQL_Gateway/SPARQL_Gateway_runtime.properties $newRELMHome/server/conf/SPARQL_Gateway/app_runtime.properties
  7. Inicie o servidor Apache Tomcat.
  8. Se você fizer upgrade da versão 4.x, faça upgrade do Lifecycle Query Engine.

    Abra a página de administração do Lifecycle Query Engine https://relm_host_name:port/lqe/web/admin. Uma mensagem indica que o upgrade do Lifecycle Query Engine está em adamento e que o aplicativo está indisponível. Clique em Iniciar Upgrade. Quando o processo de upgrade for concluído, as origens de dados estão disponíveis.

  9. Faça o upgrade do aplicativo Configuration Management.
    1. Assegure-se de que um arquivo credentials.txt existe e contém: adminUserId, adminPassword, repositoryURL, smartCard, certificateFile.

      Se o arquivo não existir, crie-o. Um exemplo de arquivo de credencial é:

      adminUserId=yourAdminUserId
      adminPassword=yourAdminPassword 
      repositoryURL=https://yourserver.com:9443/vvc 
      smartCard=<none>
      certificateFile=<none>
    2. Execute o comando repotools-vvc de seu diretório do servidor Configuration_Application_install_dir/server.
      • Linux./repotools-vvc.sh -vvc_online_migrationCommand credentialsFile=credentials.txt fromVersion=<previous_version> logPort=52000 logLevel=DEBUG
      • Windowsrepotools-vvc.bat -vvc_online_migrationCommand credentialsFile=credentials.txt fromVersion=<previous_version> logPort=52000 logLevel=DEBUG
    3. Reinicie o Jazz Team Server.
    O comando repotools do aplicativo Configuration Management envia uma solicitação ao aplicativo Configuration Management em execução e aguarda uma resposta. Se o comando repotools-vvc parar imediatamente com um erro de autorização, verifique se o servidor está em execução e se o ID do usuário e senha no arquivo de credenciais estão corretos.
  10. Reinicie seu servidor do Tomcat.
  11. Reinicie seu servidor do Rational Engineering Lifecycle Manager para fazer upgrade automaticamente dos dados migrados para o formato requerido na nova versão do aplicativo. Este processo é chamado upgrade online. Efetue logon se quiser ver a página de status do upgrade.

Resultados

Quando o upgrade online for concluído com sucesso, o navegador da web será atualizado e exibirá a página de boas-vindas do Rational Engineering Lifecycle Manager. Se uma etapa de upgrade falhar, examine o arquivo relm.log para determinar o que causou a falha. Se tiver um grande número de produtos definidos no Rational Engineering Lifecycle Manager, o upgrade online levará muito tempo para ser concluído (várias horas).

O que Fazer Depois


Feedback