Atualizando o Servidor de 3.0.1.x com WebSphere Application Server e DB2 for z/OS

Este tópico descreve as etapas necessárias para atualizar o servidor da versão 3.0.1.x dos aplicativos da solução Rational para Collaborative Lifecycle Management (CLM) para a versão 4 com uma configuração que usa o WebSphere Application Server e o DB2 for z/OS.

Antes de Iniciar

Faça cópias dos membros de BLZSAMP para que seja possível revisar os arquivos originais se necessário. Revise os logs de tarefa das amostras depois que as tarefas forem submetidas. O código de retorno esperado é 0.

Sobre Esta Tarefa

As etapas a seguir migrarão a configuração da versão 3.0.1.x para uma configuração da versão 4.0.

Procedimento

  1. Instale o pacote do CLM versão 4 usando a instalação SMP/E. O local da configuração da versão 4 deve ser diferente do local da configuração da versão 3.0.1.x. A instalação do pacote SMP/E fornece novas ferramentas de backup de banco de dados usadas para o upgrade. Para obter detalhes, consulte Visão Geral do Processo de Instalação do SMP/E.
    Nota: Os FMIDs para a versão 4 mudaram, de modo que não há PTFs para atualizar da versão 3.0.1.x para a versão 4.
  2. Pare o servidor e faça backup dos repositórios do 3.0.1.x usando os utilitários LOAD e UNLOAD do DB2 for z/OS fornecidos. Para obter detalhes, consulte Usando o Processo de Descarregamento e Carregamento do DB2 para Backup. É possível usar outras ferramentas para fazer cópias de backup se as ferramentas tiverem sido testadas e verificadas.
    Importante: Você deve fazer cópias de backup dos repositórios antes de continuar um upgrade porque o processo de upgrade faz mudanças no modelo de repositório que não podem ser retrocedidas.
    1. Para verificar os procedimentos de backup e restauração, conclua as etapas para UNLOAD e LOAD para um novo banco de dados e novo prefixo de esquema.
    2. Use a tarefa de amostra BLZCREDB da versão 3.0.1.x para criar as tabelas nos novos bancos de dados.
    3. Para testar completamente os procedimentos de backup e restauração do banco de dados, crie bancos de dados adicionais para cada repositório. Os bancos de dados recém-criados precisam ter as mesmas permissões dos bancos de dados existentes.
    4. Se estiver restaurando uma cópia de um armazém de dados, ele deve ser restaurado para um subsistema diferente do DB2 z/OS porque dois armazéns de dados não podem existir em um subsistema.
    5. Crie diretórios de UNIX System Services (ussWorkDir) separados para cada banco de dados.
    6. Use prefixos de esquema de repositório que tenham o mesmo número de caracteres.
    7. Verifique se os novos repositórios do 3.0.1.x foram criados com êxito antes de continuar com as etapas do upgrade.
  3. Configure o Jazz Team Server (JTS) modificando e submetendo o membro BLZCPJTS da amostra SBLZSAMP da versão 4 para configurar a estrutura da configuração do servidor e os diretórios de trabalho, incluindo o aplicativo Lifecycle Project Administration.
    Nota: Os diretórios de configuração (JAZZ_HOME) e de trabalho que você criar para a versão 4 devem ser diferentes dos diretórios da versão 3.0.1.x para que os utilitários de upgrade possam mesclar as duas versões. Por exemplo, o diretório de configuração padrão para a versão 3.0.1.x é /etc/jazz, portanto, para a versão 4, use /etc/jazz40. De modo semelhante, para o diretório de trabalho, use /u/jazz40.
    Siga as instruções no membro de amostra ou consulte Criando Diretórios Adicionais para o Jazz Team Server e para Aplicativos da Solução Rational para Collaborative Lifecycle Management.
  4. Configure o servidor do Change and Configuration Management (CCM) modificando e submetendo o membro BLZCPCCM da amostra SBLZSAMP da versão 4 para configurar a nova configuração do servidor e estrutura de diretório de trabalho com definições do CCM. Siga as instruções no membro de amostra ou consulte Criando Diretórios Adicionais para o Jazz Team Server e para Aplicativos da Solução Rational para Collaborative Lifecycle Management.
  5. Configure o servidor do Quality Management (QM) modificando e submetendo o membro BLZCPQM da amostra SBLZSAMP da versão 4 para configurar a nova configuração do servidor e estrutura de diretório de trabalho com definições do QM. Siga as instruções no membro de amostra.
  6. Configure o servidor do Requirements Management (RM) modificando e submetendo o membro BLZCPRM da amostra SBLZSAMP da versão 4 para configurar a nova configuração do servidor e estrutura de diretório de trabalho com definições do RM. Siga as instruções no membro de amostra.
  7. Desinstale os aplicativos 3.0.1.x do WebSphere Application Server concluindo as seguintes etapas:
    1. Efetue logoon no WebSphere Application Server Integrated Solutions Console em: https://example.com:9043/ibm/console/logon.jsp
    2. Clique em Aplicativos > Tipos de Aplicativos > Aplicativos Corporativos WebSphere.
    3. Anote o mapeamento das funções de segurança dos seguintes aplicativos da versão 3.0.1.x para poder recriá-las para suas contrapartes da versão 4:
      • jts_war
      • ccm_war
      • qm_war
    4. Pare e desinstale os aplicativos 3.0.1.x a seguir:
      • jts_war
      • ccm_war
      • qm_war
      • rm_war
      • clmhelp_war
      • admin_war
    5. Quando solicitado, salve as mudanças na configuração principal.
  8. Atualize as propriedades customizadas JAZZ_HOME e log4j.configuration concluindo as seguintes etapas:
    1. Efetue logoon no WebSphere Application Server Integrated Solutions Console em: https://example.com:9043/ibm/console/logon.jsp
    2. Clique em Servidores > Tipos de Servidores > 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, selecione Gerenciamento Java e de Processos> Definição de Processo.
    5. Sob Propriedades Adicionais, selecione Java Virtual Machine.
    6. Sob Propriedades Adicionais, selecione Propriedades Customizadas.
    7. Selecione JAZZ_HOME e atualize seu valor para: file:///<4.0_configuration_dir>. Por exemplo, file:///etc/jazz40.
    8. Selecione log4j.configuration e atualize seu valor para: file:///<4.0_configuration_dir>/startup_log4j.properties. Por exemplo, file:///etc/jazz40/startup_log4j.properties.
    9. Quando solicitado, salve as mudanças na configuração principal.
    Para obter informações adicionais, consulte Configurando um WebSphere Application Server.
  9. Pare o WebSphere Application Server.
  10. Exclua os arquivos e diretórios temporários do WebSphere e limpe o cache concluindo as seguintes etapas:
    1. Acesse o diretório temporário sob seu perfil do WebSphere Application Server, geralmente algo como <WAS_profile_root>/temp/<node_name>/<server_name> e exclua quaisquer diretórios <application>_war.
    2. Acesse <WAS_profile_root>/temp/wscache e exclua <application>_war, se existir.
  11. Migre a configuração do servidor JTS. Use ferramentas de repositório para mesclar as configurações de arquivo de configuração da versão 3.0.1.x nos arquivos de configuração para JTS da versão 4 modificando o membro BLZJTSU da amostra SBLZSAMP da versão 4. Antes de submeter a tarefa BLZJTSU, conclua as seguintes etapas:
    1. Exclua as linhas que contêm os seguintes parâmetros:
      oldTomcatHome
      newTomcatHome 
    2. Altere a linha a seguir de: updateTomcatFiles=yes para updateTomcatFiles=no
    3. Substitua a variável @pathPrefix@ para apontar para o prefixo do caminho dos arquivos binários da versão 4.
      Nota: O comando migration_jts_updateConfigurationFiles das ferramentas de repositório usado por este membro de amostra foi incluído na versão 3.0.1. Se o @pathPrefix@ apontar para versões anteriores, o comando das ferramentas de repositório não usará o comando de atualização da versão 4.
    4. Conclua as instruções na tarefa BLZJTSU de amostra.
    Submeta a tarefa BLZJTSU e revise a saída da tarefa e o arquivo de propriedades atualizado.
    Nota: Propriedades do armazém de dados que apontem para um armazém de dados Derby são mantidas como parte desta mesclagem mas serão endereçadas em uma etapa posterior.
  12. Migre a configuração do servidor CCM. Use ferramentas de repositório para mesclar as configurações de arquivo de configuração da versão 3.0.1.x nos arquivos de configuração para CCM da versão 4 modificando o membro BLZCCMU da amostra SBLZSAMP da versão 4. Antes de submeter a tarefa BLZCCMU, conclua as seguintes etapas:
    1. Exclua as linhas que contêm os seguintes parâmetros:
      oldTomcatHome
      newJTSTomcatHome 
      newApplicationTomcatHome
    2. Altere a linha a seguir de: updateTomcatFiles=yes para updateTomcatFiles=no
    3. Altere a linha a seguir de: applicationContextRoot=jazz para applicationContextRoot=ccm. O contexto de aplicativos deve ser /ccm, a menos que o servidor da versão 3.0.1.x tenha sido migrado da versão 2.x.
    4. Substitua a variável @pathPrefix@ para apontar para o prefixo do caminho dos arquivos binários da versão 4.
      Nota: O comando migration_ccm_updateConfigurationFiles das ferramentas de repositório usado por este membro de amostra foi incluído na versão 3.0.1.x. Se o @pathPrefix@ apontar para versões anteriores, o comando das ferramentas de repositório não usará o comando de atualização da versão 4.
    5. Conclua as instruções na tarefa BLZCCMU de amostra.
    Submeta a tarefa BLZCCMU e revise a saída da tarefa e o arquivo de propriedades atualizado.
    Nota: Propriedades do armazém de dados que apontem para um armazém de dados Derby são mantidas como parte desta mesclagem mas serão endereçadas em uma etapa posterior.
  13. Migre a configuração do servidor QM. Use ferramentas de repositório para mesclar as configurações de arquivo de configuração da versão 3.0.1.x nos arquivos de configuração para QM da versão 4 modificando o membro BLZQMU da amostra SBLZSAMP da versão 4. Antes de submeter a tarefa BLZQMU, conclua as seguintes etapas:
    1. Exclua as linhas que contêm os seguintes parâmetros:
      oldTomcatHome
      newJTSTomcatHome 
      newApplicationTomcatHome
    2. Altere a linha a seguir de: updateTomcatFiles=yes para updateTomcatFiles=no
    3. Substitua a variável @pathPrefix@ para apontar para o prefixo do caminho dos arquivos binários da versão 4.
      Nota: O comando migration_qm_updateConfigurationFiles das ferramentas de repositório usado por este membro de amostra foi incluído na versão 3.0.1.x. Se o @pathPrefix@ apontar para versões anteriores, o comando das ferramentas de repositório não usará o comando de atualização da versão 4.
    4. Conclua as instruções na tarefa BLZQMU de amostra.
    Submeta a tarefa BLZQMU e revise a saída da tarefa e o arquivo de propriedades atualizado.
    Nota: Propriedades do armazém de dados que apontem para um armazém de dados Derby são mantidas como parte desta mesclagem mas serão endereçadas em uma etapa posterior.
  14. Migre a configuração do servidor RM. Use ferramentas de repositório para mesclar as configurações de arquivo de configuração da versão 3.0.1.x nos arquivos de configuração para RM da versão 4 modificando o membro BLZRMU da amostra SBLZSAMP da versão 4. Antes de submeter a tarefa BLZRMU, conclua as seguintes etapas:
    1. Exclua as linhas que contêm os seguintes parâmetros:
      oldTomcatHome
      newJTSTomcatHome 
      newApplicationTomcatHome
    2. Altere a linha a seguir de: updateTomcatFiles=yes para updateTomcatFiles=no
    3. Substitua a variável @pathPrefix@ para apontar para o prefixo do caminho dos arquivos binários da versão 4.
      Nota: O comando migration_rm_updateConfigurationFiles das ferramentas de repositório usado por este membro de amostra foi incluído na versão 3.0.1.x. Se o @pathPrefix@ apontar para versões anteriores, o comando das ferramentas de repositório não usará o comando de atualização da versão 4.
    4. Conclua as instruções na tarefa BLZRMU de amostra.
    Submeta a tarefa BLZRMU e revise a saída da tarefa e o arquivo de propriedades atualizado.
    Nota: Propriedades do armazém de dados que apontem para um armazém de dados Derby são mantidas como parte desta mesclagem mas serão endereçadas em uma etapa posterior.
  15. Copie os arquivos de índice concluindo as seguintes etapas:
    1. Copie seus índices de JFS/text da versão 3.0.1.x para a versão 4. Para sistemas distribuídos, acesse o servidor apropriado e copie os arquivos.
      • Abra um prompt de comandos e insira o comando a seguir para limpar o diretório de índices padrão de 4.0:
        rm -rf <4.0_configuration_dir>/jts/indices
        rm -rf <4.0_configuration_dir>/ccm/indices
        rm -rf <4.0_configuration_dir>/qm/indices
      • Abra um prompt de comandos e insira o comando a seguir para copiar os índices da versão 3.0.1.x para a versão 4:
        cp -R <3.0.1.x_configuration_dir>/jts/indices <4.0_configuration_dir>/jts/indices
        cp -R <3.0.1.x_configuration_dir>/ccm/indices <4.0_configuration_dir>/ccm/indices
        cp -R <3.0.1.x_configuration_dir>/qm/indices <4.0_configuration_dir>/qm/indices
      Edite os arquivos teamserver.properties do JTS, CCM e QM para assegurar que com.ibm.team.fulltext.indexLocation e com.ibm.team.jfs.index.root.directory tenham as informações de local corretas.
  16. Atualize o banco de dados do JTS. Use ferramentas de repositório para incluir as tabelas de banco de dados do 4.0 no repositório do JTS modificando e submetendo uma cópia do membro BLZADDTB da amostra SBLZSAMP da versão 4. A variável de aplicativo @appl@ deve ser configurada como jts. Siga as instruções incluídas com o membro de amostra e revise cuidadosamente a saída da tarefa.
  17. Atualize o banco de dados do CCM. Se você configurou o aplicativo CCM, use ferramentas de repositório para incluir as tabelas de banco de dados do 4.0 no repositório do CCM modificando e submetendo uma cópia do membro BLZADDTB da amostra SBLZSAMP da versão 4. A variável de aplicativo @appl@ deve ser configurada como ccm. Siga as instruções incluídas com o membro de amostra e revise cuidadosamente a saída da tarefa.
  18. Atualize o banco de dados do QM. Se você configurou o aplicativo QM, use ferramentas de repositório para incluir as tabelas de banco de dados do 4.0 no repositório do QM modificando e submetendo uma cópia do membro BLZADDTB da amostra SBLZSAMP da versão 4. A variável de aplicativo @appl@ deve ser configurada como qm. Siga as instruções incluídas com o membro de amostra e revise cuidadosamente a saída da tarefa.
  19. Opcional: Configure o armazém de dados. Edite os arquivos teamserver.properties do JTS, CCM e QM para incluir configurações para o repositório do armazém de dados. As mesmas configurações irão para todos os três arquivos.
    Importante: Se você não estiver implementando o armazém de dados independente agora, será possível ignorar esta etapa. No entanto, se ignorar esta etapa, você deverá ignorar a etapa de configuração do armazém de dados quando usar o assistente de configuração do Jazz Team Server.
    Se estiver configurando o armazém de dados agora, você deve atualizar os arquivos teamserver.properties do JTS, CCM e QM para incluir parâmetros db2z de armazém de dados e remover quaisquer propriedades existentes do armazém de dados Derby. Especificamente, comente as linhas usando um # como neste exemplo:
    #com.ibm.team.datawarehouse.db.net.port 
    #com.ibm.team.datawarehouse.db.vendor=DERBY (or derby_net) 
    #com.ibm.team.datawarehouse.db.jdbc.location=/directoryInYourWorkdirectory or 
    #com.ibm.team.datawarehouse.db.jdbc.location=//localhost\:1527// ...
    Inclua as seguintes informações:
    com.ibm.team.datawarehouse.db.vendor = db2z 
    com.ibm.team.datawarehouse.db.jdbc.location=//ipAddress:ipPort/location:user=jazzDBuser;password={password}; 
    com.ibm.team.datawarehouse.db.jdbc.password=jazzDBpswd 
    # The database user for whom proper permissions will be granted 
    com.ibm.team.datawarehouse.report.user = RPTUSER
    com.ibm.team.datawarehouse.db.db2.dsn.dbname=RIDW 
  20. Atualize o armazém de dados. Se você configurou o armazém de dados, use ferramentas de repositório para atualizar o repositório do armazém de dados modificando e submetendo uma cópia do membro BLZDWHUP da amostra SBLZSAMP da versão 4. Siga as instruções incluídas com o membro de amostra e revise cuidadosamente a saída da tarefa.
  21. Inicie o WebSphere Application Server.
  22. Implemente os arquivos WAR da versão 4 no WebSphere Application Server concluindo as seguintes etapas:
    1. Efetue logoon no WebSphere Application Server Integrated Solutions Console em: https://example.com:9043/ibm/console/logon.jsp
    2. Abra a página Aplicativos Corporativos selecionando Aplicativos > Tipos de Aplicativos > Aplicativos corporativos do WebSphere
    3. Instale os seguintes arquivos .war da versão 4:
      • jts.war
      • ccm.war
      • qm.war
      • rm.war
      • clmhelp.war
      • admin.war
    4. Mapeis as funções de segurança para os seguintes aplicativos da versão 4 de acordo com o que você anotou quando os desinstalou em uma etapa anterior:
      • jts_war
      • ccm_war
      • qm_war
  23. Inicie os aplicativos no WebSphere Application Server Integrated Solutions Console:
    • jts_war
    • ccm_war
    • qm_war
    • rm_war
    • clmhelp_war
    • admin_war
  24. Reconfigure o servidor abrindo um navegador e colando as seguintes URLs:
    https://jts_server.mydomain.com:9443/jts/admin#action=com.ibm.team.repository.admin.serverReset
    https://ccm_server.mydomain.com:9443/ccm/admin#action=com.ibm.team.repository.admin.serverReset
    https://qm_server.mydomain.com:9443/qm/admin#action=com.ibm.team.repository.admin.serverReset
    Nota: Você deve reiniciar o servidor para que a reconfiguração do servidor entre em vigor.
  25. Ative as licenças concluindo as seguintes etapas:
    1. Efetue login como um administrador no Jazz Team Server 4.0.
    2. Navegue até a página Administração do Servidor > Gerenciamento de Chaves de Licença e ative as licenças.
      Nota: Não é necessário executar a configuração no sistema 4.0 porque tudo já está configurado.
    Notas sobre Licença:
    • Com liberações de marcos, você deve ativar as Licenças de Acesso Antecipado enviadas com o marco.
    • Para a liberação final versão 4.0, você deve comprar novas licenças. As licenças da versão 4 são compatíveis com aplicativos da versão 3, mas os aplicativos da versão 4 não funcionam com licenças da versão 3. Para obter informações adicionais, consulte Gerenciando Licenças.
  26. Migre o Rational Requirements Composer (RRC). Se tiver configurado os aplicativos RM, você deverá executar o utilitário de migração online do RM concluindo as seguintes etapas:
    1. Abra seu navegador, limpe o cache do navegador e navegue até o Web client do RM. Especifique o nome do servidor e o número da porta na seguinte URL: https://server_name:port/rdm/web/projects/migration. A porta padrão é 9443. A página detecta que uma migração está em andamento e o assistente de migração é iniciado.
    2. Aceite a licença de Acesso de Cliente do Rational Requirements Composer - Analyst.
    3. Clique em Abrir Painel de Serviço de Migração e selecione o assistente de migração para iniciar a migração do Rational Requirements Composer. Status sobre qual área de armazenamento está sendo processada e quando ela inicia a indexação é relatado ao administrador na página da web de migração enquanto a migração está em andamento.
      Importante: Depois da migração iniciar, não é possível cancelar esta operação até a migração estar concluída.
      Após a migração ser concluída, os dados do Rational Requirements Composer são reindexados.
    4. Após a conclusão da reindexação, o aplicativo executa a validação e as verificações de consistência nos dados migrados e fornece feedback ao administrador.
    5. Quando a mensagem indicando que a migração está concluída for exibida, clique em Fechar. Você será redirecionado para o aplicativo RRC.
    Para obter detalhes adicionais, consulte Etapas de Atualização de Migração Online.

Feedback