Migrazione del repository Jazz dopo l'aggiornamentoJazz Team Server

La migrazione del repository è il processo di conversione del contenuto del database da un formato a un altro. La migrazione del repository è necessaria quando si esegue l'aggiornamento di Jazz Team Server dalla versione X alla versione Y, dove la versione Y presenta delle modifiche allo schema.
Prima di iniziare
È necessario eseguire la migrazione dei dati se ci sono delle modifiche allo schema tra le due versioni di Jazz Team Server. È necessario aver estratto i file compressi di Jazz Team Server di entrambe le versioni X e Y.
Informazioni su questa attività
In genere, la migrazione dei dati è un processo in due fasi:

Diagramma di migrazione dei repository

È possibile utilizzare l'applicazione repotools per l'operazione di esportazione e importazione.
Nota: Jazz Team Server deve essere arrestato quando si esegue la migrazione del repository. La migrazione potrebbe richiedere del tempo, a seconda della configurazione, del sistema operativo, del database, e così via, del computer. Pertanto, pianificare l'interruzione del servizio in modo appropriato.

Migrazione della directory di testo completo

Il Jazz Team Server gestisce una directory esterna al database che memorizza tutti i dati necessari per elaborare delle query di testo completo. L'ubicazione della directory è configurata nel file teamserver.properties sotto la proprietà com.ibm.team.fulltext.indexLocation. Quando si esegue la migrazione del database e si desidera utilizzare la directory precedente che era stata utilizzata per l'indicizzazione, è necessario assicurarsi che l'ubicazione utilizzata nello strumento repository -rebuildTextIndices corrisponda all'ubicazione utilizzata dal server. Quando si avvia il server o si esegue il comando -rebuildTextIndices, il percorso assoluto all'ubicazione della directory di tempo completo viene scritto nei file di log. È possibile controllare il file di log del server e il file di log di repotools_rebuildTextIndicies per confrontare entrambe le directory.
Suggerimento: Se la directory configurata nel file teamserver.properties è un percorso relativo, un'avvertenza verrà scritta nel file di log. Si consiglia di configurare questa proprietà in modo che sia un percorso di directory assoluto.
Per ulteriori informazioni sulla creazione di indici di testo completi, consultare -rebuildTextIndices.

La migrazione di Jazz Team Server è un processo che impiega una notevole quantità di risorse e che può richiedere un discreto lasso di tempo, a seconda della dimensione dei dati di cui si sta eseguendo la migrazione. Viene qui di seguito riportato un elenco di controllo degli elementi cui prestare attenzione per evitare le condizioni di errore comuni.

Sistema operativo:
  • Su Windows, assicurarsi che l'opzione "Abilita cache di scrittura su disco" sia abilitata per tutti i dischi interessati
  • Su Windows, disabilitare il "Servizio di indicizzazione di Windows"
  • Assicurarsi che la directory temporanea, il database e il file .tar si trovino sull'unità più veloce (idealmente, un disco striped/RAID/10)
  • Su Linux (per DB2), assicurarsi di aver regolato il kernel in modo appropriato, rispetto a quanto indicato nel seguente argomento di amministrazione di DB2:http://publib.boulder.ibm.com/infocenter/db2luw/v9r5/topic/com.ibm.db2.luw.qb.server.doc/doc/t0008238.html
Configurazione di Jazz Team Server:
  • Configurare le seguenti proprietà (in teamserver.properties) per assicurarsi che si stia accedendo al disco più veloce:
    com.ibm.team.repository.tmpdir
    com.ibm.team.scm.vcs.tmpdir
    com.ibm.team.scm.tmpdir
    com.ibm.team.fulltext.indexLocation
DB2:
  • DB2 prova, per impostazione predefinita, ad incrementare la dimensione del pool di buffer in base alle esigenze. Se questa opzione non è stata disabilitata, le prestazioni del DB2, nella configurazione standard, non dovrebbero presentare alcun problema.
  • Per controllare il pool di buffer, attenersi alla seguente procedura:
    1. Connettersi al database Jazz in cui si desidera eseguire l'importazione immettendo quanto segue nel prompt di comandi:
      db2 connect to <nomeDatabase>
    2. Eseguire quindi il seguente comando:
      db2 "select bufferpoolid, bpname from syscat.bufferpools"
      Questo genererà un output di un identificativo del pool di buffer nel seguente formato:
      BUFFERPOOLID BPNAME
      ------------ ----------------------------------
                 1 IBMDEFAULTBP
      
        1 record(s) selected.
    3. Nell'esempio sopra indicato, l'identificativo del pool di buffer è 1. Eseguire quindi il seguente comando:
      db2mtrk -d
      Questo genererà un output di dati simile al seguente:
      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
      L'output in grassetto indica la dimensione di pool di buffer assegnata per il database.
Oracle:
  • Disabilitare il cestino, che tiene traccia di tutti gli elementi che vengono eliminati, riempie il disco e può effettivamente causare dei problemi. Eseguire i seguenti comandi in sqlplus:
    "ALTER SYSTEM SET RECYCLEBIN" = 'OFF' 
    "PURGE RECYCLEBIN"
  • Disabilitare la conservazione della cronologia delle statistiche, che tiene traccia del runtime dei metodi precedenti:
    "exec dbms_stats.ALTER_STATS_HISTORY_RETENTION (0)"
    "exec dbms_stats.PURGE_STATS ( dataora_corrente )"
  • Assicurarsi che la tablespace Oracle includa solo un singolo file

Per avviare la migrazione:

  1. Arrestare Jazz Team Server versione X. Per arrestare Jazz Team Server, eseguire server.shutdown.sh per Linux o server.shutdown.bat per Windows, fornito in [dirinstall]/jazz/server.
  2. Creare una copia di backup del repository Jazz. Il backup è solo una misura preventiva nel caso si verificassero dei problemi con la migrazione.
    1. Per Derby, creare una copia di archivio dell'intera directory di database.
    2. Per DB2, utilizzare il comando di backup DB2 per generare un file di archivio del database con le informazioni su date e ore nella directory di destinazione specificata.
  3. Eseguire un backup dell'indice di testo completo. l'ubicazione dell'indice di testo completo è specificato nella proprietà com.ibm.team.fulltext.indexLocation del file teamserver.properties.
  4. Eseguire repotools per esportare i dati nel repository. Gli script, repotools.sh per Linux e repotools.bat per Windows, sono forniti nella directory [dirInstall]/jazz/server.

    Esempio: repotools -export toFile=./nome_file.tar

    Nota: Le informazioni di log e i messaggi di errore sono visualizzati sulla console e in un file di log. Il file di log contiene informazioni di debug sul numero di elementi esportati, la data/ora di esportazione degli elementi, gli errori e altre informazioni utili. Il file di log viene creato per impostazione predefinita nella stessa directory dello script repotools. È possibile modificare l'ubicazione del file di log utilizzando il parametro logFile.
    Si è ora esportato il contenuto del repository in un file TAR.
  5. Copiare il file teamserver.properties da [dirInstall]/jazz/server versione X a [dirInstall]/jazz/server versione Y.
  6. Dalla versione Y, eseguire repotools per importare i dati dal file TAR al repository.
    Esempio: repotools -import fromFile=./nome_file.tar
    Importante: Se il database utilizzato non è Derby, è necessario creare un nuovo database prima di eseguire lo strumento di importazione.
    Nota: L'opzione -import registra le informazioni sugli elementi importati e tralasciati e gli errori che si verificano durante l'importazione.
Operazioni successive
È ora possibile avviare Jazz Team Server versione Y.

Feedback

Il supporto è stato valido? È possibile fornire un feedback a Jazz.net (è richiesta la registrazione) lasciando dei commenti nei forum o tramite l'inoltro di un bug