Fazendo Upgrade para o Rational Team Concert 2.0.0.2

Geralmente, é possível fazer upgrade dos clientes e servidores Rational Team Concert executando uma instalação de zip ou do IBM® Installation Manager.
Nota: Se você usar o IBM Installation Manager para instalar o Rational Team Concert 2.0.0.2 em um computador no qual o Rational Team Concert não está instalado no momento, o Installation Manager solicitará que você selecione os idiomas para instalação. No entanto, se você atualizar a partir de uma versão anterior para a 2.0.0.2, o IBM Installation Manager assumirá que você deseja usar os idiomas atuais e não solicitará que selecione idiomas. Para selecionar os idiomas adicionais, depois de atualizar para a 2.0.0.2, selecione Modificar na tela principal do IBM Installation Manager, 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 depois de atualizar para a 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 até
    https://<server-host>:<jazz-port>/jazz/admin?internal#action=com.ibm.team.repository.admin.serverReset
  2. Clique em Solicitar Reconfiguração do Servidor.
  3. Encerre o servidor.

Em seguida, você pode selecionar Modificar no IBM Installation Manager para incluir ou remover idiomas.

Compatibilidade de Clientes e Servidores do Rational Team Concert

A tabela a seguir mostra a compatibilidade das versões do cliente do Rational Team Concert com as versões do Jazz Team Server.
Tabela 1. Compatibilidade do Cliente e do Servidor
Versão do Cliente Rational Team Concert Versão compatível do Jazz Team Server
1.0.x para Eclipse 0.6.x
2.0.x para Eclipse 1.0.x
2.0.0.0 para Microsoft Visual Studio 1.0.0.0
2.0.x para Microsoft Visual Studio 1.0.x

Fazendo Upgrade de um Cliente Rational Team Concert para Eclipse IDE

Se você tiver as versões 1.0, 1.0.1 ou 1.0.1.1 do Cliente para Eclipse IDE, precisará obter o cliente 2.0.x para conectar-se ao novo servidor versão 2.0.x. É possível instalar isto usando um arquivo zip ou você pode atualizar suas instalações do IBM Installation Manager anteriores.

Instalando um Cliente Rational Team Concert para Microsoft Visual Studio IDE

Se você tiver a versão 1.0.1.1 do Cliente para Microsoft® Visual Studio IDE, precisará obter o cliente 2.0.x para conectar-se ao novo servidor versão 2.0.x.
Lembre-se: Um arquivo .zip não é fornecido para o Cliente para Microsoft Visual Studio. Para instalar ou fazer upgrade para a versão 2.0.x, você deverá usar o IBM Installation Manager.

Atualizando um Servidor a partir de um Release Experimental ou de Acesso Antecipado para um Release Permanente

Se estiver executando um release de Acesso Antecipado do Rational Team Concert, primeiro faça upgrade para o release Experimental 2.0.0.2.

A partir do release Experimental 2.0.0.2, você pode tornar seu servidor Permanente, comprando e instalando o Server Activation Kit para sua edição, que está disponível aqui: http://www.ibm.com/software/awdtools/rtc/. O kit de ativação consiste em um arquivo JAR contendo 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 de 1.0, 1.0.1, 1.0.1.1 ou 2.0

É possível fazer upgrade diretamente para o release 2.0.0.2 do Rational Team Concert de releases anteriores. Uma migração de banco de dados é necessária para atualizações de 1.x para 2.x. Para obter informações sobre como executar uma migração de banco de dados, consulte Migrando repositório Jazz após o upgrade do Jazz Team ServerMigrando repositório Jazz após o upgrade do Jazz Team Server.

Nota: Antes de iniciar o upgrade de um WebSphere Application Server, reconfigure o servidor navegando para https://{servername}:9443/jazz/admin#action=com.ibm.team.repository.admin.serverReset e clicando em Solicitar Reconfiguração do Servidor.

Se você instalou o release anterior a partir de um arquivo zip, não há interseção com a instalação anterior. Você pode instalar o release 2.0.0.2 de um zip em um novo local, ou pode usar o IBM Installation Manager para instalar uma instância de 2.0.0.2.

Se você usou o IBM Installation Manager para instalar o release anterior, poderá instalar 2.0.0.2 como uma instância separada ou atualizar a instância anterior para 2.0.0.2. Se você instalar uma instância separada do servidor para o release 2.0.0.2, 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, remove o arquivo jazz.war anterior e implemente o arquivo jazz.war 2.0.0.2.

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.0.2.

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

É possível atualizar entre edições do Rational Team Concert. Geralmente os upgrades incluem mover de Express-C para Express ou de Express para Standard. Você também pode fazer downgrade na direção oposta, seguindo o mesmo processo.

Como todas as edições do Rational Team Concert 2.0.0.2 suportam bancos de dados Derby, você não precisa migrar do Derby para o DB2 ou Oracle se estiver mudando do Express-C para o Express ou Standard. Recomendamos que você migre sua edição do servidor primeiro, certifique-se de que as coisas funcionem sem problemas com o banco de dados existente e, em seguida, execute uma migração do banco de dados, se necessário. Observe que o banco de dados Derby suporta apenas 10 usuários. Para obter informações sobre executar uma migração de banco de dados, consulte Migrando repositório Jazz após o upgrade do Jazz Team Server Migrando repositório Jazz o após upgrade do Jazz Team Server.

Se você tiver instalado uma edição do Rational Team Concert 2.0.0.2 e desejar fazer upgrade para outra, faça download e instale a nova edição, ao lado da edição existente e, em seguida, copie os arquivos de configuração para executar a nova edição. A seção abaixo descreve os arquivos de configuração necessários.

Se você instalou a edição anterior a partir de um arquivo zip, não existe nenhuma interseção com a instalação anterior. É possível instalar a nova edição a partir de um zip em um novo local ou você pode usar a instalação do IBM Installation Manager para a nova edição. Recomendamos que o IBM Installation Manager seja usado para servidores de produção para possibilitar que futuras atualizações sejam aplicadas.

Se você usou o IBM Installation Manager para executar sua instalação de servidor anterior e desejar usar o IBM Installation Manager para instalar sua nova edição, durante a nova instalação do Installation Manager, não sobreponha a edição anterior. Na página Instalar Pacotes do assistente de instalação, selecione Criar um Novo Grupo de Pacotes.

Isso instalará a nova edição em um local diferente e criará atalhos de programa utilizando o novo nome do grupo de pacotes.

Se você não executar essa tarefa, a instalação falhará com uma colisão de arquivos. Isso ocorre se você vir um diálogo de erro intitulado Instalação Falhou e os detalhes mostram o seguinte texto:
Falha na instalação.
  Erro durante a fase de "instalação":
    Falha ao extrair zip padrão 1.0.1.I20081018-1820.  Arquivo
    D:\JazzTeamServer\server\license-update-site\site.xml já existe.

Se isso ocorre, ele não é fatal; é possível reiniciar a instalação e criar corretamente um novo grupo de pacotes.

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 2.0.0.2.
  1. Assegure-se de que os fix packs mais recentes para WAS e WASDK estejam instalados. Se estiver implementando no WAS 7.0, é crítico que pelo menos o WebSphere Application Server 7.0.0.3 esteja instalado.
  2. Remova as propriedades JVM customizadas antigas:
    1. com.ibm.team.repository.provision.profile
    2. com.ibm.team.server.configURL
    3. log4j.configuration
  3. Inclua a nova propriedade JVM customizada JAZZ_HOME e configure o valor para:
    file:///<Dir_de_Instalação_do_Jazz>/server/conf
  4. Assegure-se de que a configuração de segurança do WAS "Usar dados de autenticação disponíveis quando um URI desprotegido for acessado" esteja marcada. Se você estiver usando o Integrated Solutions Console do WAS, poderá fazer isto:
    1. Navegando para Segurança -> Administração, Aplicativos e Infraestrutura Seguros -> Segurança da Web - Configurações Gerais.
    2. Selecionando a caixa de opção para "Usar dados de autenticação disponíveis quando um URI desprotegido é acessado".

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 do servidor atualizado para criar backups. Se você usou o IBM Installation Manager para atualizar de 1.0, 1.0.1, ou 1.0.1.1 ou 2.0 para 2.0.0.2, um diretório de backup contendo seus arquivos de configuração 1.0.x ou 2.0 foi criado com um nome, por exemplo, backup-config-timestamp no subdiretório do servidor do local da instalação.

Se você estiver fazendo upgrade para a edição Standard ou Enterprise e adquiriu o Developer Client Activation Kit para Express, adquira e instale o Developer Client Activation Kit para Standard ou Enterprise Editions, para que você possa usar as licenças do cliente. Suas designações de licença do Developer ainda estarão em vigor, mas as licenças do Developer serão desativadas até que o kit de ativação correto seja instalado.

Instalando Chaves de Ativação 2.0.0.2

O release 2.0.0.2 usa as Chaves de ativação 2.0.0.2. Se for feito upgrade de um servidor de 1.0.x.x para 2.0.x, ele reverterá para uma licença para teste após o upgrade e você precisará obter as chaves de ativação 2.0 ou 2.0.0.2 do IBM Rational License Key Center.

Para obter informações adicionais sobre o IBM Rational License Key Center, consulte o site de suporte de licença do IBM Rational e o jazz.net Tech Tip relacionado.

Abaixo estão os nomes das chaves aplicáveis para cada kit:

  • IBM Rational Team Concert Express Edition Server Activation Kit V2.0, 2.0.0.2
  • IBM Rational Team Concert Standard Edition Server Activation Kit V2.0, 2.0.0.2
  • IBM Rational Team Concert Enterprise Edition Server Activation Kit V2.0, 2.0.0.2
  • IBM Rational Team Concert Contributor Client Access Activation Kit V2.0, 2.0.0.2
  • IBMRational Team Concert Developer Client Access Activation Kit V2.0, 2.0.0.2
  • IBM Rational Team Concert Express Edition Developer Client Access Activation Kit V2.0, 2.0.0.2
  • IBM Rational Team Concert Floating Contributor Client Access Activation Kit V2.0, 2.0.0.2
  • IBM Rational Team Concert Floating Developer Client Access Activation Kit V2.0, 2.0.0.2

Configurando uma Linha de Tempo do Projeto

No Rational Team Concert 1.x, os projetos podiam ter múltiplas linhas de tempo (anteriormente chamadas de "linhas de desenvolvimento") e todas essas linhas de tempo eram consideradas iguais.

No Rational Team Concert 2.0, os projetos ainda podem ter múltiplas linhas de tempo, mas 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 primária do projeto não é conhecida, portanto, seus projetos não terão uma linha de tempo de projeto configurada. Você pode atualizar manualmente seus projetos para configurar a linha de tempo do projeto, após seu upgrade para 2.0

Configurando a Captura Instantânea do Gerenciamento de Controle de Origem

A captura instantânea de Source Control Management (SCM) para o Data Warehouse coleta dados nos fluxos, incluindo informações sobre o tamanho dos fluxos e a atividade (conjunto de alterações e alterações de arquivo/pasta) dentro dele. Na versão 1.0, esta captura instantânea coletava automaticamente informações sobre todos os fluxos. Como esta pode ser uma operação dispendiosa, na versão 2.0, as opções de configuração são incluídas na captura instantânea do SCM para permitir que os usuários decidam para quais fluxos os dados devem ser coletados. O impacto imediato desta alteração é que, a menos que você a configure, nenhum dado será coletado.

Para configurar a captura instantânea do SCM:
  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 UI da Web.
  3. No painel de navegação esquerdo, selecione Administrar Captura Instantânea do SCM. Uma lista de fluxos é exibida.
  4. Selecione a caixa de opção para um ou mais fluxos e, em seguida, selecione Salvar Alterações.

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

Alterações Incompatíveis nos Relatórios do BIRT

Se você tiver usado o designer de relatório do BIRT para criar seus próprios modelos de relatório, poderá encontrar um ou mais problemas ao tentar usar estes relatórios na versão 2.0. Você deve estar ciente dos seguintes problemas:
  • Alterações na ordem em que as classes Java e JavaScript são resolvidas. Se você tiver gravado o código JavaScript em seu relatório BIRT que usa a instrução importPackage() para importar o pacote java.lang, esteja ciente que referências não qualificadas ao Objeto no código, que costumavam referir-se à classe Java, podem agora referir-se à classe JavaScript (e como resultado não funcionarão corretamente). Outras classes que são nomeadas de maneira idêntica entre JavaScript e Java, como java.util.Date, podem ter o mesmo problema. A solução é qualificar totalmente sua referência à classe Java e remover a instrução importPackage().
  • Alterações no processamento dos conjuntos de dados. No passado, o simples ato de ligar um elemento (tal como um Rótulo) a um conjunto de dados, fazia com que o conjunto de dados fosse processado em sua totalidade quando o elemento era renderizado. Isto era conveniente porque significava que alguém poderia impingir uma ordenação no processamento do conjunto de dados usando (ocultos) rótulos ligados aos conjuntos de dados na ordem em que eles deveriam ser processados. Agora, uma ligação desse tipo processará somente a primeira linha do conjunto de dados. Para obter o comportamento anterior, use um elemento de Texto Dinâmico e invoque algum código JavaScript que forçará o processamento do conjunto de dados inteiro. Total.count() é uma boa opção.
  • Os erros do designer de relatório do BIRT podem causar perda de dados. Estes problemas aparecem quando você abre um arquivo de design do relatório do BIRT criado no BIRT 2.2.2 (ou seja, RTC 1.0) com o designer de relatório do BIRT 2.3.2 (ou seja, RTC 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 do Relatório" podem ser perdidos. A solução alternativa é reinserir os valores ou copiar e colar os valores de uma versão anterior do editor. Após salvar o arquivo com os novos valores inseridos, o problema não se repetirá.
    • Ao editar um arquivo de design de relatório pela primeira vez com o BIRT 2.3.2, o valor-padrão para os parâmetros do relatório pode ser perdido. Isto também pode ocorrer após o problema anterior descrito. A solução alternativa é reinserir os valores ou copiar e colar os valores de uma versão anterior do editor. Após salvar o arquivo com os novos valores inseridos, o problema não se repetirá.

    Estes problemas podem ser muito sérios se não observados, pois os dados reunidos pelo relatório poderão estar incorretos. É uma boa prática verificar 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 do 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 alterações acima são feitas em todos os relatórios prontos para utilização do Rational Team Concert 2.0 - nenhuma ação é necessária. Entretanto, se você tiver criado manualmente modelos de relatórios em sua área do projeto usando nossos relatórios prontos para utilização e não tiver especificado um identificador apropriado (consistente com o uso), seu modelo de relatório não será atualizado quando for migrado. Ou seja, o conteúdo estará desatualizado e não funcionará. Nesse caso, você deve fazer upload do novo conteúdo para os modelos afetados, usando o arquivo .rptdesign padrão apropriado.

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

No Rational Team Concert 2.0, há várias alterações de esquema nas tabelas de item de trabalho no armazém de dados. Como consequência, ao migrar de 1.0 para 2.0, o importador ignorará quaisquer dados de itens de trabalho no 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 a captura instantânea dos itens de trabalho ser executada pela primeira vez ou fazer com que ela seja executada manualmente após você iniciar o servidor. Na primeira execução após a migração, a captura instantânea dos itens de trabalho reconstituirá as informações de itens de trabalho de histórico inteiras no armazém de dados. Isto também significa que a primeira execução da captura instantânea após a migração provavelmente demorará mais tempo que uma execução média à noite.

Descobrindo Novos Relatórios

No Rational Team Concert 2.0, vários novos relatórios são incluídos. Embora estes relatórios aparecem nos novos modelos de processos que são fornecidos com o produto, eles não são incluídos automaticamente nas áreas do projeto existentes na migração. Nós incluímos uma nova ação que o ajudará a descobrir e implementar estes novos modelos de relatórios em suas áreas do projeto existentes após a migração. Para implementar novos modelos de relatórios:
  1. No rich client, abra a visualização Artefatos da Equipe.
  2. Expanda sua área do 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 o ajudará a descobrir quaisquer 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. Após a criação, é possível criar novos relatórios a partir dos 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 trabalho, funções e manipuladores de eventos são preservadas quando você faz upgrade de 1.x para 2.0. Se você customizou um modelo de processo predefinido (tal como Scrum), esteja ciente que, se você reimplementar o modelo predefinido (na visualização Modelos de Processo), sobrescreverá suas customizações. Se você precisar reimplementar o modelo predefinido, deverá primeiro alterar o nome e ID do modelo predefinido que você customizou, de forma que ele não será sobrescrito.


Feedback

Isto foi útil? É possível fornecer feedback em Jazz.net (é necessário registrar-se): Comentar nos fóruns ou submeter um erro