A migração do repositório é o processo de converter o conteúdo
do banco de dados de um formato para outro. A migração do repositório é
necessária quando você está fazendo upgrade do Jazz Team Server para System z da
versão X para a versão Y, em que a versão Y possui mudanças de esquema. A migração do repositório também será necessária se você estiver fazendo o upgrade do Rational Team Concert para o Rational Team Concert para System z.
Antes de Iniciar
É necessário fazer a migração de dados se houver qualquer mudança de esquema
entre as duas versões do
Jazz Team Server para System z.
É necessário ter extraído os arquivos compactados do
Jazz Team Server para System z da versão X e Y ou ter as duas versões instaladas usando o IBM® Installation Manager em grupos de pacotes separados ou em sistemas separados.
Por Que e Quando Desempenhar Esta Tarefa
Geralmente, a migração de dados é um processo de duas etapas:
- Exportar dados que estão presentes na versão X do repositório do Jazz para um arquivo TAR.
- Importar dados do arquivo TAR para a versão Y do repositório do Jazz.
É
possível usar o aplicativo repotools para a operação de exportação e importação.
Nota: O
Jazz Team Server para System z deve
ser interrompido quando você migrar o repositório. A migração pode demorar, dependendo da configuração do sistema, do sistema operacional, do banco de dados, e assim por diante. Portanto, planeje
sua interrupção de maneira apropriada.
Para obter instruções específicas sobre como importar e exportar dados no z/OS, consulte
Fazendo Upgrade a partir do Rational Team Concert para System z 1.0.1 no z/OS em
Fazendo Upgrade para o Rational Team Concert para System z 2.0.
A migração do Jazz Team Server para System z
é um processo muito intenso que pode demorar uma quantidade de tempo considerável dependendo
do tamanho dos dados que estão sendo migrados. Aqui está uma lista de verificação das coisas
a considerar para evitar imprevistos comuns.
Sistema operacional:
- No Windows®, assegure-se de que o "cache de gravação em disco" esteja ativado para todos os discos envolvidos
- No Windows, desative o "Serviço de Indexação do Windows"
- Assegure-se de que o diretório temp, o banco de dados e o arquivo TAR estejam na unidade mais rápida (idealmente, disco dividido/RAID/10)
- No Linux® (para DB2), assegure-se de que você tenha sintonizado o kernel de acordo com o tópico de administração do DB2 aqui: http://publib.boulder.ibm.com/infocenter/db2luw/v9r5/topic/com.ibm.db2.luw.qb.server.doc/doc/t0008238.html
Configuração do Jazz Team Server:
DB2:
- Por padrão, o DB2 tenta aumentar o tamanho do buffer pool para o máximo necessário. A menos que você tenha desativado isso, o DB2 deve executar bem na configuração padrão
- Para verificar o buffer pool, faça o seguinte:
- Conecte ao banco de dados do Jazz para o qual você deseja importar digitando o seguinte no prompt de comandos:
db2 connect to <databaseName>
- Em seguida, execute o seguinte comando:
db2 "select bufferpoolid, bpname from syscat.bufferpools"
Isso gerará um identificador de bufferpool neste formato:BUFFERPOOLID BPNAME
------------ ----------------------------------
1 IBMDEFAULTBP
1 record(s) selected.
- No exemplo acima, o identificador do buffer pool é 1. Em seguida, execute
o seguinte comando:
db2mtrk -d
Isso gerará
dados semelhantes aos seguintes:Tracking Memory on: 2009/06/04 at 22:19:17
Memory for database: <databaseName>
utilh pckcacheh other catcacheh bph (1) bph (S32K)
64.0K 384.0K 128.0K 128.0K 95.4M 832.0K
bph (S16K) bph (S8K) bph (S4K) shsorth lockh dbh
576.0K 448.0K 384.0K 64.0K 2.5M 20.8M
apph (269) apph (268) apph (267) apph (266) apph (265) apph (262)
64.0K 64.0K 64.0K 64.0K 64.0K 64.0K
appshrh
128.0K
A saída em negrito indica o tamanho do
buffer pool de seu banco de dados.
Para iniciar a migração:
- Pare o Jazz Team Server para System z da
versão X. Para parar o Jazz Team Server para System z,
execute server.shutdown.sh para Linux ou server.shutdown.bat para Windows empacotado em [installDir]/jazz/server.
- Faça um backup do repositório do Jazz.
O backup é apenas
uma medida preventiva caso algo dê errado com a migração.
- Para Derby, faça uma cópia de archive do diretório do banco de dados
inteiro.
- Para o DB2, use o comando backup do DB2 para gerar um arquivo archive com informações de data e hora no diretório de destino especificado.
- Faça um backup do índice de texto completo. O local do
índice de texto completo é especificado na propriedade com.ibm.team.fulltext.indexLocation
do arquivo teamserver.properties.
- Execute repotools para exportar os dados no repositório. Os scripts, repotools.sh para Linux e repotools.bat para Windows, são empacotados no diretório [installDir]/jazz/server.
Exemplo: repotools
-export toFile=./file_name.tar
Nota: As informações
de log e mensagens de erro são exibidas no console e em um
arquivo de log. O arquivo de log contém informações sobre depuração sobre vários
itens exportados, horário para exportar itens, erros e outras informações úteis.
O arquivo de log é criado por padrão no mesmo diretório que o script
repotools. É possível alterar o local do arquivo de log usando o parâmetro
logFile.
Agora você exportou o conteúdo
do repositório para um arquivo TAR.
- Copie o arquivo teamserver.properties
de [installDir]/jazz/server da versão X para [installDir]/jazz/server da
versão Y.
- A partir da versão Y, execute repotools para importar os dados do
arquivo TAR para o repositório.
Exemplo:
repotools
-import fromFile=./file_name.tarNota: A opção -import
registra informações sobre os itens importados e ignorados, bem como
erros durante a importação.
O que Fazer Depois
Agora você pode iniciar o
Jazz Team Server para System z da
versão Y.