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 da
versão X para a versão Y, em que a versão Y possui alterações de esquema.
Antes de Iniciar
É necessário fazer a migração de dados se houver qualquer alteração de esquema
entre as duas versões do
Jazz Team
Server.
É necessário ter extraído os arquivos compactados do
Jazz Team
Server de
ambas as versões, X e Y.
Sobre Esta Tarefa
Geralmente, a migração de dados é um processo de duas etapas:
- Exportar os dados que estão na versão X do repositório do Jazz para um arquivo TAR.
- Importar os dados do arquivo TAR na 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 deve
ser interrompido quando você migrar o repositório. A migração poderá
demorar dependendo da configuração da máquina, do sistema operacional, do banco de dados,
etc. Portanto, planeje
sua interrupção de maneira apropriada.
Migrando o diretório de texto completo
O Jazz Team
Server gerencia um diretório
fora do banco de dados que armazena todos os dados que são necessários para processar
consultas de texto completas. O local do diretório está configurado no arquivo
teamserver.properties na propriedade
com.ibm.team.fulltext.indexLocation.
Quando migrar seu banco de dados e quiser usar o diretório anterior que foi usado para indexação, você deverá certificar-se de que o local usado na ferramenta de repositório
-rebuildTextIndices corresponda ao local usado pelo servidor. Quando iniciar o servidor ou executar o comando
-rebuildTextIndices, o caminho absoluto do diretório de texto completo será impresso nos arquivos de log.
É possível verificar o arquivo de log do servidor e o arquivo de log
repotools_rebuildTextIndicies para comparar ambos os diretórios.
Dica: Se o diretório configurado no arquivo teamserver.properties for um caminho relativo, será impresso um aviso no arquivo de log. É recomendado configurar esta propriedade como um caminho do diretório absoluto.
Para obter mais informações sobre a criação de índices de texto completo, consulte
-rebuildTextIndices.
A migração do Jazz Team
Server
é 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®, certifique-se de que "gravar armazenamento em cache no disco" esteja ativada para todos os discos envolvidos
- No Windows, desative "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, striped/RAID/10 disk)
- No Linux® (para DB2), certifique-se de ter sintonizado corretamente 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 o máximo possível necessário. A menos que você tenha desativado isso, o DB2 deverá ter um desempenho de acordo com o padrão.
- Para verificar o buffer pool, faça o seguinte:
- Conecte-se ao banco de dados do Jazz no qual 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:
O que Fazer Depois
Agora você pode iniciar o
Jazz Team
Server da
versão Y.