Migrando o Repositório Jazz após o Upgrade de Jazz Team Server

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.
Por Que e Quando Desempenhar Esta Tarefa
Geralmente, a migração de dados é um processo de duas etapas:

diagrama de migração do repositório

É 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, assegure-se de que "gravar armazenamento em cache no 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, striped/RAID/10 disk)
  • No Linux (para DB2), assegure-se de que você tenha sintonizado adequadamente 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:
  • Configure as seguintes propriedades (em teamserver.properties) para assegurar que seu disco mais rápido esteja sendo acessado:
    com.ibm.team.repository.tmpdir
    com.ibm.team.scm.vcs.tmpdir
    com.ibm.team.scm.tmpdir
    com.ibm.team.fulltext.indexLocation
DB2:
  • O DB2 por padrão tenta aumentar o tamanho do buffer pool tão grande quanto o necessário. A menos que você tenha desativado isto, o DB2 deve executar bem conforme o padrão.
  • Para verificar o buffer pool, faça o seguinte:
    1. Conecte-se ao banco de dados do Jazz para o qual deseja importar digitando o seguinte no prompt de comandos:
      db2 connect to <databaseName>
    2. 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.
    3. 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.
Oracle:
  • Desative recycle bin - isto controla todos os elementos que são excluídos, preenche o disco e pode efetivamente causar problemas. Execute os comandos a seguir em sqlplus:
    "ALTER SYSTEM SET RECYCLEBIN" = 'OFF' 
    "PURGE RECYCLEBIN"
  • Desative a retenção de histórico de estatística - isto controla o tempo de execução de métodos passados:
    "exec dbms_stats.ALTER_STATS_HISTORY_RETENTION (0)"
    "exec dbms_stats.PURGE_STATS ( current_timestamp )"
  • Assegure-se de que o espaço de tabela se estenda apenas em um único arquivo

Para iniciar a migração:

  1. Pare o Jazz Team Server da versão X. Para parar Jazz Team Server, execute server.shutdown.sh para Linux ou server.shutdown.bat para Windows compactados em [installDir]/jazz/server.
  2. Faça um backup do repositório do Jazz. O backup é apenas uma medida preventiva caso algo dê errado com a migração.
    1. Para Derby, faça uma cópia de archive do diretório do banco de dados inteiro.
    2. Para DB2, use o comando backup do DB2 para gerar um arquivo archive de banco de dados com informações de data e hora no diretório de destino especificado.
  3. 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.
  4. Execute repotools para exportar os dados no repositório. Os scripts, repotools.sh para Linux e repotools.bat para Windows, estão compactados 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.
  5. Copie o arquivo teamserver.properties de [installDir]/jazz/server da versão X para [installDir]/jazz/server da versão Y.
  6. 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.tar
    Importante: Se seu banco de dados não for Derby, você deve criar um novo banco de dados antes de executar a ferramenta de importação.
    Nota: 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 da versão Y.

Feedback

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