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:
- O upgrade do Rational Team Concert para System z 1.0.1 no z/OS
está documentado abaixo.
- O upgrade do Rational Team Concert para System z 2.0.0.1 no z/OS
está documentado nas informações de ++HOLD
para as PTFs que devem ser instaladas para concluir o upgrade.
- As informações de edição e de versão para o Rational Team Concert
não correspondem diretamente ao Rational Team Concert para System z.
- É possível fazer upgrade do Rational Team Concert para o Rational Team Concert
para System z, mas isso requer uma migração de repositório.
É 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:
- Fazendo upgrade de uma versão anterior do Rational Team Concert ou do Rational Team Concert para System z 1.0.1 para o Rational Team Concert para System z 2.0.0.2.
- Fazendo upgrade do Rational
Team Concert para System
z 1.0.1 para o Rational
Team Concert para System
z 2.0.0.2 no z/OS
- 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
- 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
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:
- Em um navegador da Web, navegue para https://server-host:9443/jazz/admin.action=com.ibm.team.repository.admin.serverReset.
- Clique em Solicitar Redefinição do Servidor.
- Encerre o servidor.
Em seguida, é possível selecionar Modificar no Gerenciador de Instalação para adicionar ou remover idiomas.
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:
- Exporte o conteúdo do banco de dados v1.0.1 usando repotools.
- 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.
- 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.
- 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.
- Remova as propriedades JVM customizadas anteriores:
- com.ibm.team.repository.provision.profile
- com.ibm.team.server.configURL
- log4j.configuration
- 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.
- 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:
- Navegue para .
- Selecione Usar dados de autenticação disponíveis quando um
URI não protegido for acessado.
- 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:
- É necessário ter permissões de Gravação para o fluxo para o qual você deseja coletar dados.
- Vá para a página Relatórios na interface da Web do Rational Team Concert para System z.
- No painel de navegação à esquerda, selecione Administrar Captura Instantânea do SCM. Uma lista de fluxos é exibida.
- 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:
- No cliente do Eclipse, abra a visualização Artefatos da Equipe.
- Expanda sua área de projeto, expanda Relatórios.
- 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.