Fazendo Upgrade para o Rational Team Concert para System z 2.0.0.2

Existem vários cenários que podem ser seguidos para fazer upgrade de versões anteriores ao Rational Team Concert para System z 2.0.0.2

Em geral, é possível fazer upgrade de clientes e servidores Rational Team Concert para System z a partir de um arquivo .zip ou usando o IBM Installation Manager em plataformas diferentes do z/OS.

O processo de upgrade para o Rational Team Concert para System z 2.0.0.2 é semelhante ao upgrade para o Rational Team Concert 2.0.0.2, exceto nas seguintes considerações:
É possível fazer upgrade para o Rational Team Concert para System z 2.0.0.2 de várias maneiras, incluindo os seguintes cenários:
Instalando idiomas adicionais ao fazer upgrade : Se você usar o IBM® Installation Manager para instalar o Rational Team Concert para System z 2.0.0.2 em um computador no qual o Rational Team Concert para System z não está instalado, o Installation Manager solicitará que você selecione os idiomas que deseja instalar. No entanto, se você atualizar de uma versão anterior para o Rational Team Concert para System z 2.0.0.2, o Installation Manager assumirá que você deseja usar os idiomas atuais e não solicitará que selecione idiomas. Para selecionar idiomas adicionais, após atualizar para 2.0.0.2, selecione Modificar na tela principal do Gerenciador de Instalação e, em seguida, selecione a oferta. A tela a seguir mostra a lista de idiomas suportados. Selecione os necessários.
Se você iniciar o Jazz Team Server para System z depois de atualizar para 2.0.0.2 e antes de selecionar Modificar para incluir ou remover idiomas, deverá reconfigurar o servidor da seguinte forma:
  1. Em um navegador da Web, navegue para https://server-host:9443/jazz/admin.action=com.ibm.team.repository.admin.serverReset.
  2. Clique em Solicitar Redefinição do Servidor.
  3. Encerre o servidor.

Em seguida, é possível selecionar Modificar no Gerenciador de Instalação para adicionar ou remover idiomas.

Dica: Para problemas conhecidos ou informações adicionais sobre instalação do Rational Team Concert para System z, vá para a página Rational Team Concert for System z Release Notes em Jazz.net.

Fazendo Upgrade de um Cliente Rational Team Concert para System z para IDE Eclipse

Qualquer cliente do ambiente de desenvolvimento integrado (IDE) Eclipse deve estar na v2.0.0.1 ou mais recente para poder conectar-se a um servidor v2.x. Embora um cliente Rational Team Concert para System z 2.0.0.1 irá conectar-se a um servidor 2.0.0.2, é recomendável instalar o cliente Rational Team Concert para System z 2.0.0.2 para conectar-se ao servidor Rational Team Concert para System z 2.0.0.2. Este cliente pode ser instalado usando um arquivo .zip, ou é possível atualizar as instalações anteriores do IBM Installation Manager.
Nota: Os clientes Rational Team Concert 2.0 podem conectar-se a servidores Rational Team Concert para System z 2.0; no entanto, os clientes Rational Team Concert não poderão usar funções específicas do Rational Team Concert para System z.

Fazendo Upgrade de um Servidor de um Release de Avaliação para um Release Permanente

A partir do release de avaliação 2.0, você pode tornar seu servidor permanente, comprando e instalando o Kit de Ativação do Servidor para sua edição no Rational License Key Center. Os detalhes estão disponíveis aqui: http://www.ibm.com/software/rational/support/licensing. O kit de ativação consiste em um arquivo .jar que contém a chave do servidor permanente. Ele é instalado utilizando a página de Gerenciamento de Chaves de Licença de sua interface administrativa da Web.

Fazendo Upgrade de um Servidor do Rational Team Concert ou Rational Team Concert para System z 1.0.1

É possível fazer upgrade diretamente para o release 2.0 do Rational Team Concert para System z de releases anteriores do Rational Team Concert ou do Rational Team Concert para System z. É necessária uma migração do banco de dados.

Nota: Antes de começar atualizar um WebSphere Application Server, redefina o servidor navegando para https://servername:9443/jazz/admin#action=com.ibm.team.repository.admin.serverReset e clicando em Solicitar Redefinição do Servidor.

Se você instalou o release anterior a partir de um arquivo .zip (por exemplo, no Linux® para System z), não haverá nenhuma interseção com a instalação anterior. É possível instalar o release 2.0 a partir de um .zip em um novo local, ou usar o IBM Installation Manager para instalar uma instância de 2.0.

Se você tiver usado o IBM Installation Manager para instalar o release anterior, é possível instalar a 2.0 como uma instância separada ou atualizar a instância anterior para 2.0. Se você instalar uma instância separada do servidor para o release 2.0, selecione Criar um novo grupo de pacotes na página Instalar Pacotes do assistente de instalação.

Nota: Para fazer upgrade de uma implementação do WebSphere Application Server do Jazz Team Server para System z, remova o arquivo jazz.war anterior e implemente o arquivo jazz.war 2.0.

Para concluir o upgrade, consulte Copiando os Arquivos de Configuração Necessários a partir de uma Instalação de Servidor Anterior e Instalando chaves de ativação 2.0.

Fazendo Upgrade do Rational Team Concert para System z 1.0.1 no z/OS

Foram feitas mudanças estruturais no banco de dados do repositório na versão 2.0 que o impedirão de reutilizar o banco de dados do Rational Team Concert para System z 1.0.1 no z/OS. O processo de upgrade para 2.0 do Rational Team Concert para System z v1.0.1 consiste nas três etapas a seguir:
  1. Exporte o conteúdo do banco de dados v1.0.1 usando repotools.
  2. Instale e configure o Jazz Team Server para System z v2.0 na plataforma de destino desejada. Um novo banco de dados será criado durante essa etapa. Consulte Instalação do Rational Team Concert para System z no z/OS para obter detalhes sobre como instalar o Jazz Team Server para System z 2.0 em sua plataforma de destino.
  3. Importe o arquivo .tar criado na etapa um para o banco de dados do repositório v2.0 usando repotools.
Exportando o Rational Team Concert para o banco de dados do repositório do System z 1.0.1
Use o membro BLZEXPOR no hlq101.SBLZSAMP para exportar o conteúdo do banco de dados do repositório. A JCL de amostra neste membro usa o comando de exportação repotools para criar um arquivo .tar contendo o conteúdo do repositório.

Configure o membro BLZEXPOR seguindo as instruções no JCL de amostra. Submeta o JCL modificado e verifique o log da tarefa. A tarefa terá sido executada com êxito apenas se terminar com código de retorno 300.

O arquivo de exportação será colocado no local do HFS especificado por jazzExport @. O nome do arquivo será @dbexport@.tar, conforme definido no BLEXPOEX

Importando o banco de dados exportado para o Jazz Team Server para System z v2.0 no z/OS
Importando para um banco de dados Derby no z/OS
Use o membro BLZIMPO2 em hlq200.SBLZSAMP para importar o arquivo .tar v1.0.1 para o banco de dados Derby do Jazz Team Server para System z v2.0. Configure o BLZIMPO2 conforme descrito nos comentários do JCL, especificando o arquivo .tar exportado do banco de dados v1.0.1.

Submeta o JCL modificado e verifique o log da tarefa para ver se o repotools foi completado com êxito.

Importando para um banco de dados DB2 no z/OS
Use o membro BLZIMPOR em hlq200.SBLZSAMP para importar o arquivo .tar v1.0.1 para o banco de dados DB2 do Jazz Team Server para System z v2.0. Configure o BLZIMPOR conforme descrito nos comentários do JCL, especificando o arquivo .tar exportado do banco de dados v1.0.1.

Submeta o JCL modificado e verifique o log da tarefa para ver se o repotools foi completado com êxito.

Para completar o upgrade, consulte Copiando os Arquivos de Configuração Necessários a partir de uma Instalação de Servidor Anterior.

Fazendo Upgrade de um Servidor Rational Team Concert para System z de 2.0.0.1 para 2.0.0.2

É possível fazer upgrade diretamente para o release do Rational Team Concert para System z 2.0.0.2 de releases anteriores. Ações adicionais para atualizações do repositório podem ser necessárias, consulte a página Rational Team Concert for System z Release Notes em Jazz.net para obter detalhes.

Nota: Antes de começar atualizar um WebSphere Application Server, redefina o servidor navegando para https://servername:9443/jazz/admin#action=com.ibm.team.repository.admin.serverReset e clicando em Solicitar Redefinição do Servidor.

Se você instalou o release anterior a partir de um arquivo .zip (por exemplo, no Linux para System z), não haverá nenhuma interseção com a instalação anterior. É possível instalar o novo release a partir de um .zip em um novo local, ou usar o IBM Installation Manager para instalar uma instância de 2.0.

Se você tiver usado o IBM Installation Manager para instalar o release anterior, é possível instalar a 2.0 como uma instância separada ou atualizar a instância anterior para 2.0. Se você instalar uma instância separada do servidor para o release 2.0, selecione Criar um novo grupo de pacotes na página Instalar Pacotes do assistente de instalação.

Nota: Para fazer upgrade de uma implementação do WebSphere Application Server do Jazz Team Server para System z, remova o arquivo jazz.war anterior e implemente o arquivo jazz.war 2.0.

Para concluir o upgrade, consulte Copiando os Arquivos de Configuração Necessários a partir de uma Instalação de Servidor Anterior e Instalando chaves de ativação 2.0.

Fazendo Upgrade de um Servidor de uma Edição do Rational Team Concert para System z para Outra

As edições do Rational Team Concert para System z (Starter, Standard e Enterprise) são fornecidas em modo de avaliação. Para fazer upgrade de uma edição para outra, carregue um conjunto combinado de chaves de ativação de teste para a edição de destino. Essas chaves de teste combinadas, podem ser transferidas por download de https://jazz.net/downloads/rational-team-concert-z/.

As chaves de ativação de teste combinadas estão incluídas em um arquivo .zip para a edição de destino. Este arquivo .zip combinado é instalado usando a página Gerenciamento de Chaves de Licença na interface administrativa da Web do servidor.

O Rational Team Concert para System z é fornecido como modo de avaliação da Starter Edition apenas para instalação no z/OS na versão 2.0.0.1 e Standard Edition na versão 2.0.0.2. Se precisar fazer upgrade para outra edição do Rational Team Concert para System z no z/OS, primeiro, você deverá fazer upgrade para a edição necessária, em seguida, carregar os kits de Ativação do Servidor permanentes e as Licenças de Acesso do Cliente para sua edição.

Fazendo Upgrade do Rational Team Concert para System z 2.0.0.1 para o Rational Team Concert para System z 2.0.0.2 no z/OS

O pacote de instalação do SMP/E contém o RTCz 2.0.0.1. São necessárias PTFs para fazer upgrade dos componentes do z/OS para 2.0.0.2. As PTFs estão disponíveis no ShopzSeries, IBM Support Portal, Jazz.net ou em seu canal de serviços regular.

Procure os seguintes APARs e solicite as PTFs correspondentes: PM04798, PM04800, PM04802, PM05340, PM05341, PM05342 e PM05701.

Estas PTFs devem ser aplicadas à instalação base do Rational Team Concert para System z 2.0.0.1 usando o SMP/E. Informações adicionais sobre as etapas para aplicar as PTFs estão incluídas com as PTFs.

São necessárias etapas de configuração adicionais para atualizar a configuração existente após a aplicação das PTFs.

Atualizações de Configuração do WebSphere Application Server

As etapas a seguir são necessárias para configurar corretamente o WebSphere Application Server no Rational Team Concert para System z 2.0.
  1. Certifique-se de que os fix packs mais recentes para o WebSphere Application Server e o Java™ SDK associado estejam instalados. Se estiver implementando no WebSphere Application Server 7.0, é essencial que pelo menos o WebSphere Application Server 7.0.0.3 esteja instalado. Com o WebSphere Application Server 6.1, é crítico que pelo menos o WebSphere Application Server 6.1.0.25 esteja instalado.
  2. Remova as propriedades JVM customizadas anteriores:
    1. com.ibm.team.repository.provision.profile
    2. com.ibm.team.server.configURL
    3. log4j.configuration
  3. Se ainda não estiver disponível, inclua a nova propriedade JVM customizada JAZZ_HOME e configure o valor para:
    file:///<JazzInstallDir>/server/conf   
    em sistemas diferentes do z/OS.
    No z/OS, configure o valor para:
    arquivo:///@confPath@
    em que @confPath@ é o caminho de configuração definido em BLZCPDIR.
  4. Certifique-se de selecionar a configuração do WebSphere Application Server: Use os dados de autenticação disponíveis quando um URI não protegido for acessado. Se estiver usando o WebSphere Application Server Integrated Solutions Console, você poderá fazer isto seguindo estas etapas:
    1. Navegue para Segurança > Administração, Aplicativos e Infraestrutura Seguros > Segurança da Web - Configurações Gerais.
    2. Selecione Usar dados de autenticação disponíveis quando um URI não protegido for acessado.
  5. Certifique-se de que tenha implementado o arquivo jazz.war do Rational Team Concert para System z. jazz.war deve ser atualizado para a versão mais recente do Rational Team Concert para System z.

Copiando os Arquivos de Configuração Necessários a partir de uma Instalação de Servidor Anterior

Copie os seguintes arquivos do servidor de origem para o servidor de destino. Primeiro, renomeie os arquivos originais na instalação de servidor de upgrade para criar backups. Se você usou o IBM Installation Manager para atualizar para o Rational Team Concert para System z 2.0, foi criado um diretório de backup contendo os arquivos de configuração 1.0.1 com um nome como backup-config-<timestamp> no subdiretório do servidor do local da instalação.

Se estiver fazendo upgrade para a edição Standard ou Enterprise, e tiver comprado o Developer Client Activation Kit para a edição Starter, compre e instale o Developer Client Activation Kit para as edições Standard ou Enterprise para poder usar essas licenças do cliente. As designações de licença do desenvolvedor ainda estarão em vigor, mas as licenças do desenvolvedor serão desativadas até que você instale o kit de ativação correto.

Instalando chaves de ativação 2.0

O release do Rational Team Concert for System z 2.0 usa as chaves de ativação do Rational Team Concert para System z 2.0. Se for feito upgrade de um servidor da 1.0.1 para 2.0, ou do Rational Team Concert para o Rational Team Concert para System z, ele será revertido para uma licença de avaliação após o upgrade, e será necessário obter as chaves de ativação do Rational Team Concert para System z 2.0 do Rational License Key Center. A seguir estão os nomes das chaves aplicáveis a cada kit:

  • IBM Rational Team Concert for System z Starter Edition - Server License Activation Kit V2.0 Multiplatform (jazz_team_server_starter_zSeries-release.jar)
  • IBM Rational Team Concert for System z Starter Edition - Developer Client License Activation Kit V2.0 Multiplatform (rtcz_starter_developer_unlocked.jar)
  • IBM Rational Team Concert for System z - Contributor Client License Activation Kit V2.0 Multiplatform (rtcz_all_contributor_unlocked.jar)
  • IBM Rational Team Concert for System z Standard Edition - Server License Activation Kit V2.0 Multiplatform (jazz_team_server_standard_zSeries-release.jar)
  • IBM Rational Team Concert for System z Developer Client License Activation Kit V2.0 Multiplatform (rtcz_standard_developer_unlocked.jar)
  • IBM Rational Team Concert for System z Floating Developer Client License Activation Kit V2.0 Multiplatform (rtcz_std_floating-developer_unlocked.jar)
  • IBM Rational Team Concert for System z - Floating Contributor Client License Activation Kit V2.0 Multiplatform (rtcz_std_floating-contrib_unlocked.jar)
  • IBM Rational Team Concert for System z Enterprise Edition - Server License Activation Kit V2.0 Multiplatform (jazz_team_server_enterprise_zSeries-release.jar)

Configuração de uma Linha de Tempo de Projeto

No Rational Team Concert 1.0.1 ou Rational Team Concert para System z 1.0.1, os projetos podiam ter várias linhas de tempo (chamadas anteriormente de "linhas de desenvolvimento"), e todas estas linhas de tempo eram consideradas iguais.

No Rational Team Concert para System z 2.0, os projetos ainda podem ter várias linhas de tempo, mas apenas uma delas pode ser marcada como a "linha de tempo do projeto". Ao migrar seu banco de dados para 2.0, a linha de tempo de projeto primária não é conhecida, portanto, seus projetos não terão uma linha de tempo do projeto configurada. Os projetos podem ser atualizados manualmente para configurar a linha de tempo do projeto após o upgrade para 2.0.

Configurando a captura instantânea do Gerenciamento de Controle de Origem

A captura instantânea de Gerenciamento de Controle de Origem (SCM) para o armazém de dados coleta dados nos fluxos, incluindo informações sobre o tamanho dos fluxos e a atividade (conjunto de mudanças e mudanças de arquivo/pasta) dentro dele. Na versão 1.0.1, esta captura instantânea automaticamente coleta informações sobre todos os fluxos. Como esta pode ser uma operação de alto custo, na versão 2.0, as opções de configuração são incluídas na captura instantânea SCM para permitir que você decida para quais fluxos os dados devem ser coletados. O impacto imediato desta mudança é que, a menos que você faça a configuração, nenhum dado será coletado.

Para configurar a captura instantânea SCM, execute as seguintes etapas:
  1. É necessário ter permissões de Gravação para o fluxo para o qual você deseja coletar dados.
  2. Vá para a página Relatórios na interface da Web do Rational Team Concert para System z.
  3. No painel de navegação à esquerda, selecione Administrar Captura Instantânea do SCM. Uma lista de fluxos é exibida.
  4. Selecione Um ou Mais Fluxos, em seguida, selecione Salvar Mudanças.

Os dados serão coletados para os fluxos selecionados em todas as capturas subsequentes.

Alterações Incompatíveis para Relatórios BIRT

Se você tiver usado o designer de relatório do BIRT para criar seus próprios modelos de relatório, poderá encontrar problemas ao tentar usar estes relatórios na versão 2.0. Você deve estar ciente dos seguintes problemas:
  • Mudanças na ordem em que as classes Java e JavaScript™ são resolvidas: Se você tiver gravado código JavaScript em seu relatório BIRT que usa a instrução importPackage() para importar o pacote java.lang, observe que, referências não qualificadas a Object no código, que anteriormente eram referidas à classe Java, agora podem referir-se à classe JavaScript e, portanto, não funcionarão corretamente. Outras classes com nomes idênticos entre JavaScript e Java, tais como, java.util.Date, podem ter o mesmo problema. A solução é qualificar completamente sua referência à classe Java e remover a instrução importPackage().
  • Mudanças no processamento de conjuntos de dados: No passado, o ato de ligar um elemento (como um rótulo) a um conjunto de dados fazia o conjunto de dados ser totalmente processado quando o elemento era renderizado. Isto era útil porque significava que você poderia aplicar uma ordem ao processamento do conjunto de dados, usando rótulos ocultos ligados aos conjuntos de dados na ordem em que eles devem ser processados. Agora, esta conexão processará somente a primeira linha do conjunto de dados. Para aplicar o comportamento anterior, use um elemento de Texto Dinâmico e chame algum código JavaScript, que forçará o processamento de todo o conjunto de dados. Total.count() é uma boa opção.
  • Erros do BIRT Report Designer podem causar perda de dados: Estes problemas aparecem quando você abre um arquivo de design de relatório BIRT criado no BIRT 2.2.2 (Rational Team Concert 1.0) com o designer de relatório BIRT 2.3.2 (Rational Team Concert 2.0). Os problemas a seguir foram observados:
    • Ao editar um conjunto de dados pela primeira vez com o BIRT 2.3.2, na página Parâmetros, os campos Valor-padrão e Parâmetro de Relatório podem ser perdidos. A solução alternativa é inserir novamente os valores, ou copiar e colar os valores de uma versão anterior do editor. Depois de salvar o arquivo com os novos valores, o problema não ocorrerá novamente.
    • Ao editar um arquivo de design de relatório pela primeira vez com o BIRT 2.3.2, o valor-padrão e os parâmetros de relatório podem ser perdidos. Isto também pode ocorrer após o problema anterior descrito. A solução alternativa é inserir novamente os valores, ou copiar e colar os valores de uma versão anterior do editor. Depois de salvar o arquivo com os novos valores, o problema não ocorrerá novamente.
    Nota: Estes problemas podem ser muito sérios se não forem monitorados, pois os dados reunidos pelo relatório podem estar incorretos. Verifique cada conjunto de dados e cada parâmetro de relatório ao editar um relatório pela primeira vez com o designer de relatório BIRT 2.3.2. Estes problemas não ocorrem para novos relatórios que são criados com as ferramentas do BIRT 2.3.2.

    As mudanças acima são feitas em todos os relatórios prontos para uso do Rational Team Concert para System z 2.0. Nenhuma ação é necessária da sua parte. No entanto, se você tiver criado manualmente modelos de relatório em sua área do projeto usando relatórios prontos para uso do Rational Team Concert para System z 2.0 e não tiver especificado um identificador apropriado (consistente com o uso do Rational Team Concert para System z), seu modelo de relatório não será atualizado quando for migrado. Ou seja, o conteúdo estará desatualizado e não funcionará. Neste caso, você deverá fazer upload do novo conteúdo para os modelos afetados, usando o arquivo .rptdesign não padrão.

Importação dos Dados de Item de Trabalho no Armazém de Dados

No Rational Team Concert para System z 2.0, existem várias mudanças de esquema nas tabelas de itens de trabalho no armazém de dados. Por isso, ao migrar de 1.0.1 para 2.0, o importador ignorará quaisquer dados de itens de trabalho do armazém. Como resultado, quando você iniciar o servidor 2.0 pela primeira vez, seus relatórios de itens de trabalho poderão não funcionar corretamente. A solução alternativa é aguardar que a captura instantânea de itens de trabalho execute pela primeira vez, ou fazer com que ela execute manualmente após você iniciar o servidor. Na primeira execução depois da migração, a captura instantânea de itens de trabalho irão reconstituir todas as informações de itens de trabalho históricas no armazém de dados. Isto também significa que a primeira execução da captura instantânea depois da migração pode provavelmente demorar mais do que uma execução noturna média.

Descoberta de Novos Relatórios

No Rational Team Concert para System z 2.0, foram incluídos vários novos relatórios. Embora estes relatórios apareçam nos novos modelos de processo fornecidos com o Rational Team Concert para System z, eles não são automaticamente incluídos nas áreas do projeto existentes durante a migração de dados para o Rational Team Concert para System z 2.0. Para descobrir e implementar estes novos modelos de relatório em suas áreas do projeto existentes após a migração, execute as seguintes etapas:
  1. No cliente do Eclipse, abra a visualização Artefatos da Equipe.
  2. Expanda sua área de projeto, expanda Relatórios.
  3. Clique com o botão direito do mouse em Modelos de Relatório e selecione Implementar Novos Modelos.

O diálogo que se abre o ajudará a descobrir os modelos de relatório que estão disponíveis, mas ainda não foram implementados em sua área do projeto. Você pode selecionar um ou mais deles e eles serão criados. Depois da criação, você pode criar novos relatórios a partir destes modelos usando as ações de menu disponíveis.

Customizações

As alterações que você fez nos tipos de item de trabalho, atributos, fluxos de trabalhos, atribuições e manipuladores de eventos são preservados quando você atualiza de 1.0.1 para 2.0. Se você customizou um modelo de processo predefinido (como Scrum), observe que, se reimplementar o modelo predefinido (na visualização Modelos de Processo), suas customizações serão sobrescritas. Se precisar reimplementar o modelo predefinido, primeiro você deverá alterar o nome e ID do modelo predefinido customizado para que ele não seja sobrescrito.