Este tópico descreve as etapas necessárias para atualizar o
servidor do Rational
Team Concert (RTC)
versão 3.0 para aplicativos da versão 4 da solução Rational
para Collaborative Lifecycle Management (CLM)
com uma configuração que usa um servidor de aplicativos Tomcat 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 do RTC
versão para uma configuração do CLM versão 4.0.
Procedimento
- 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. 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
para a versão 4.
- Faça backup dos
repositórios do 3.0 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.
- 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.
- Use a tarefa de amostra BLZCREDB da versão 3.0 para criar as
tabelas nos novos bancos de dados.
- 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.
- Crie diretórios de UNIX System
Services (ussWorkDir) separados para cada banco de dados.
- Use prefixos de esquema de repositório que tenham o mesmo número
de caracteres.
- Verifique se os novos repositórios do 3.0 foram criados com êxito
antes de continuar com as etapas do upgrade.
- 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 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 é /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.
- 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.
- Crie um novo
banco de dados DB2 for z/OS chamado RIDW para
usar como o armazém de dados e conceda permissões. Para obter detalhes, consulte Configurando o DB2 para z/OS para Uso com o Jazz Team Server.
- Implemente os
aplicativos iniciando e parando o servidor Tomcat versão 4
(ou implemente os arquivos ccm.war e jts.war).
Nota: Se os arquivos web.xml de aplicativos da versão 3.0
tiverem sido customizados (por exemplo, para suportar um registro LDAP), as etapas restantes
migrarão esses arquivos customizados para os aplicativos da versão 4
e modificarão o arquivo web.xml em cada um
dos aplicativos. No entanto, os arquivos .war são
assinados, portanto, modificações somente pode ser feitas na versão implementada
do arquivo .war. Se os aplicativos forem reimplementados
após a migração, os arquivos da versão 3.0 deverão ser customizados
de novo manualmente.
- 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 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:
- 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.
- 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.
- 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:
- 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 tenha sido migrado da versão 2.x.
- 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. 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.
- 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.
- Pare o servidor Tomcat do RTC versão 3.
- Copie os
arquivos de índice concluindo as seguintes etapas:
- Copie seus índices de JFS/text da versão 3 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
Abra um prompt de comandos
e insira o comando a seguir para copiar os índices da versão 3
para a versão 4:cp -R <3.0_configuration_dir>/jts/indices <4.0_configuration_dir>/jts/indices
cp -R <3.0_configuration_dir>/ccm/indices <4.0_configuration_dir>/ccm/indices
Edite os arquivos teamserver.properties do JTS e do CCM
para assegurar que com.ibm.team.fulltext.indexLocation e com.ibm.team.jfs.index.root.directory tenham
as informações de local corretas.
- 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.
- 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.
- Opcional: Configure o armazém de dados. Edite os arquivos
teamserver.properties do JTS e do CCM 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ê
deverá atualizar os arquivos teamserver.properties do JTS e do CCM
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
- Se você tiver atualizado o arquivo teamserver.properties para
o armazém de dados, crie um repositório de armazém de dados modificando e
submetendo o membro BLZCREDB da amostra SBLZSAMP da versão 4 para criar
as tabelas do armazém de dados. Configure a variável de aplicativo @appl@ como jts.
O comando @repotoolsCommand@ das ferramentas de repositório é -createWarehouse.
- Inicie os servidores Tomcat da versão 4 modificando e submetendo
o membro BLZSRVD da amostra SBLZSAMP da versão 4. Certifique-se de que a variável do
diretório de configuração @confPath@ e a variável do diretório de trabalho @workPath@
estejam configuradas para os novos valores dos diretórios da versão 4.
- Ative as licenças concluindo as seguintes etapas:
- Efetue login como um administrador no Jazz Team Server 4.0.
- 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.
- Se desejar incluir os aplicativos Quality Management (QM) ou Requirements
Management (RM), siga as instruções para novas instalações.
Para obter detalhes, consulte Instalando e Configurando o Jazz Team Server e a Solução Rational para Aplicativos Collaborative Lifecycle Management no z/OS.