Fazendo upgrade do Rational Engineering Lifecycle Manager em execução com o WebSphere Application Server

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 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. Configure seu servidor de aplicativos.
    1. Assegure-se de que o servidor antigo esteja em execução.
    2. Faça backup do perfil do WebSphere Application Server.
      1. Abra um prompt de comandos e altere para o diretório bin do diretório de instalação do WebSphere Application Server.
      2. Execute este comando. Se a segurança do WebSphere Application Server estiver ativada, especifique o nome de usuário e a senha.
        Dica: O caminho do diretório para o arquivo compactado deve existir antes de iniciar o processo de backup.
        • Linux
          backupConfig.sh <caminho para um novo arquivo compactado para criação de backup de perfil> -username <nome de usuário admin principal do WAS> -password <senha admin do WAS>
          Por exemplo:
          backupConfig.sh /root/WAS_backup/relm_50_profile.zip -username <WAS_admin> -password <WAS_admin_password>
        • Windows
          backupConfig.bat <Path_to_a_new_compressed_file_to_create_backup_of_profile> -username <WAS_primary_administrative_user_name> -password <WAS_administrative_password>
          Por exemplo:
          backupConfig.bat C:\WAS_backup\relm_50_profile.zip -username <WAS_admin> -password <WAS_admin_password>
      O comando encerra o servidor antes de iniciar o processo de backup.
    3. Desinstale os aplicativos existentes do WebSphere Application Server.
      1. Inicie o servidor.
      2. Efetue logon no WebSphere Application Server Integrated Solutions Console em https://host_name:9043/ibm/console/logon.jsp
      3. Clique em Aplicativos > Tipos de aplicativos > Aplicativos corporativos WebSphere.
      4. Pare e desinstale os aplicativos a seguir: relm.war, relmhelp.war, vvc.war, lqe.war, SPARQL_Gateway.war.
      5. Quando solicitado, salve as mudanças na configuração principal.
    4. Atualize as propriedades customizadas JAZZ_HOME e log4j.configuration.
      1. Efetue logon no WebSphere Application Server Integrated Solutions Console em https://host_name:9043/ibm/console/logon.jsp.
      2. Clique em Servidores > Tipos de servidor > Servidores de aplicativos WebSphere.
      3. Clique no nome do servidor para abri-lo. O nome do servidor padrão é server1.
      4. Na seção Infraestrutura do servidor, clique em Java e gerenciamento de processo > Definição de processo.
      5. Em Propriedades adicionais, clique em Java Virtual Machine.
      6. Altere o caminho para o Lifecycle Query Engine e Jazz Reporting Service para o novo local.
      7. Localize o campo de texto Argumentos Genéricos do JVM, e inclua essa variável de ambiente para o processo de inicialização da JVM:

        -Dlqe.config.location=file://drive:/lqe_installation_dir/server/conf/lqe

      8. Em Propriedades adicionais, clique em Propriedades customizadas.
      9. Clique em JAZZ_HOME e atualize seu valor para file:///<new_version_install_dir>/server/conf.

        Por exemplo, file:///C:/PROGRA~2/IBM/JazzTeamServer_5.0.1/server/conf.

      10. Clique em log4j.configuration e atualize seu valor para file:///<new_version_install_dir>/server/conf/startup_log4j.properties.

        Por exemplo, file:///C:/PROGRA~2/IBM/JazzTeamServer_5.0.1/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.
    5. Configure a biblioteca compartilhada do Jazz Reporting Service.
      1. No console administrativo, acesse Ambiente > Bibliotecas Compartilhadas.
      2. Na lista, clique em Biblioteca Compartilhada do JRS.
      3. Altere o caminho da classe do local de instalação do Jazz Reporting Service existente para o novo local.

        Por exemplo: 5.0.1_install_dir/server/conf/SPARQL_Gateway/SharedLibrary

      4. Em Carregamento de Classe, assegure-se de que Usar um Carregador de Classes Isolado para a Biblioteca Compartilhada seja selecionado. Clique em Aplicar e Salvar.
    6. Pare o WebSphere Application Server.
      • Linux Execute o comando stopServer.sh.
      • Windows Execute o comando stopServer.bat.
    7. Limpe os diretórios temp do WebSphere Application Server.

      Remova o Rational Engineering Lifecycle Manager relacionado ao conteúdo dos diretórios wscache e temp no perfil. Dependendo de quais aplicativos foram instalados, esses diretórios podem estar no perfil e podem ser removidos: relm_war, lqe_war, sparql e os dados relacionados ao aplicativo Configuration Management.

      • Linux
        WAS_profile_root/wscache (for example: opt/IBM/WebSphere/AppServer/profiles/AppSrv01/temp/wscache)
        WAS_profile_root/temp (for example: opt/IBM/WebSphere/AppServer/profiles/AppSrv01/temp)
      • Windows
        WAS_profile_root\wscache (for example: C:\IBM\WebSphere\AppServer\profiles\AppSrv01\wscache)
        WAS_profile_root\temp (for example: C:\IBM\WebSphere\AppServer\profiles\AppSrv01\temp)
    8. Limpe o diretório de log do WebSphere Application Server.
      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 é:
      • Linux opt/IBM/WebSphere/AppServer/profiles/AppSrv01/logs
      • Windows C:\IBM\WebSphere\AppServer\profiles\AppSrv01\logs
    9. Inicie seu servidor de aplicativos WebSphere.
      • Linux Execute o comando startServer.sh.
      • Windows Execute o comando startServer.bat.
  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
    • Para ignorar a atualização do Tomcat, inclua o parâmetro a seguir para o script vvc_upgrade:
      -oldApplicationHome oldRELMHome/server/conf -ignoreJTSVersionCheck -updateTomcatFiles=no
    Dica: O aplicativo Configuration Management também pode ser instalado com o Rhapsody Design Manager. Quando você estiver instalando o Rational Engineering Lifecycle Manager, selecione o aplicativo Configuration Management, se desejar instalar o componente em uma máquina diferente do sistema 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. Implemente os arquivos relm.war, relmhelp.war, vvc.war, lqe.war e SPARQL_Gateway.war.
    1. A partir do console administrativo do WebSphere Application Server, selecione Aplicativos > Tipos de aplicativo > Aplicativos corporativos WebSphere.
    2. Na página Aplicativos corporativos, clique em Instalar.
    3. Em Caminho para o Novo Aplicativo, selecione $newRELMHome/server/webapps/relm.war e clique em Abrir.
    4. Selecione Fast path e, em seguida, Avançar.
    5. Aceite os valores padrão e clique em Avançar no assistente de configuração. Na página Mapear raízes de contexto para módulos da web, insira a raiz de contexto /relm. Em seguida, clique em Concluir.
    6. Uma mensagem indica que relm.war foi instalado com êxito. Clique em Salvar diretamente na configuração principal.
    7. Instale a documentação do Rational Engineering Lifecycle Manager, relmhelp.war. Use as etapas de a-f mencionadas acima. Use $newRELMHome/server/webapps/relmhelp.war para o caminho e /relmhelp como a raiz de contexto.
    8. Instale o aplicativo Configuration Management, vvc.war. Use as etapas de a-f mencionadas acima. Use $newRELMHome/server/webapps/vvc.war para o caminho e /vvc como a raiz de contexto.
    9. Configure seu servidor de aplicativos WebSphere para oLifecycle Query Engine e implemente o arquivo lqe.war.
    10. Instale o aplicativo Jazz Reporting Service, SPARQL_Gateway.war. Use as etapas de a-f mencionadas acima. Use $newRELMHome/server/webapps/SPARQL_Gateway.war para o caminho. Use SPARQL_Gateway como a raiz de contexto.
    11. Inclua a referência de biblioteca do Jazz Reporting Service.
      1. Acesse Aplicativos > Tipos de aplicativo > Aplicativos corporativos WebSphere e SPARQL_Gateway_war na lista de aplicativos.
      2. Na seção Referência, clique em Referências da biblioteca compartilhada.
      3. Selecione a caixa de seleção próxima a SPARQL_Gateway_war e clique em Referenciar bibliotecas compartilhadas.
      4. Selecione Biblioteca compartilhada JRS e clique na seta para a direita.
      5. Clique em OK. Em seguida, clique em OK novamente para salvar suas configurações na configuração principal.
    12. Assegure-se de que a ordem do carregamento de classe do Jazz Reporting Service está configurada corretamente.
      1. Acesse Aplicativos > Tipos de aplicativo > Aplicativos corporativos WebSphere e SPARQL_Gateway_war na lista de aplicativos.
      2. Na seção Propriedades de detalhes, clique em Carregamento de classes e detecção de atualização.
      3. Na seção Ordem do carregador de classes, selecione Classes carregadas com o carregador de classes local primeiro (pai por último).
      4. Clique em OK e em Salvar na configuração principal.
    13. Reinicie o WebSphere Application Server.
  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 o servidor de aplicativos.
    • Linux Execute os comandos stopServer.sh e startServer.sh.
    • Windows Execute os comandos stopServer.bat e startServer.bat.
  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