La migrazione del repository è il processo di conversione dei contenuti del
database da un formato ad un altro. La migrazione del repository è
necessaria quando si sta aggiornando il Jazz Team Server dalla
versione X alla versione Y, dove la versione Y ha modifiche di schema.
Prima di iniziare
È necessario eseguire la migrazione dei dati se ci sono modifiche
allo schema tra le due versioni
Jazz Team Server.
È necessario estrarre i file compressi di
Jazz Team Server di
entrambe le versioni X e Y.
Informazioni su questa attività
In genere, la migrazione di dati è un processo di due passi:
- Esportazione dei dati che si trovano nella versione X del repository Jazz
in un file TAR.
- Importazione dei dati dal file TAR alla versione
Y del repository Jazz.
È possibile utilizzare l'applicazione
repotools per l'operazione di esportazione ed importazione.
Nota: Jazz Team Server deve
essere arrestato quando si esegue la migrazione del repository. La migrazione potrebbe impiegare molto tempo
a seconda della configurazione della macchina, del sistema operativo e così via. Quindi, pianificare l'interruzione in modo appropriato.
Migrazione
della directory di testo completo
Il server Jazz
Team gestisce una directory
all'esterno del database in cui sono memorizzati tutti i dati necessari a elaborare le query di testo completo. La posizione della
directory è configurata nel file
teamserver.properties nella proprietà
com.ibm.team.fulltext.indexLocation.
Quando si migra il database e si desidera utilizzare la directory precedente
utilizzata per l'indicizzazione, è necessario assicurare che la posizione utilizzata
nello strumento di repository
-rebuildTextIndices corrisponda
alla posizione utilizzata dal server. Quando si avvia il server o si esegue il comando
-rebuildTextIndices, il percorso assoluto per la posizione della
directory di testo completo viene stampato nei file di log.
È possibile verificare il file log del server ed il file log
repotools_rebuildTextIndicies
per confrontare entrambe le directory.
Suggerimento: Se la
directory configurata nel file teamserver.properties è un percorso
relativo, verrà stampato un avviso nel file di log. Si consiglia di configurare questa proprietà
affinché sia un percorso di directory assoluto.
Per ulteriori informazioni sugli indici di testo completo, consultare
-rebuildTextIndices.
La migrazione di Jazz Team Server è
un processo molto intensivo che può impiegare una discreta quantità di tempo in base alla dimensione dei dati di cui si sta eseguendo la migrazione. Viene di seguito riportato un elenco di controllo di cose da controllare per evitare
pitfall comuni.
Sistema operativo:
- In Windows®, assicurarsi che l'opzione di "cache di scrittura su disco" sia abilitata per tutti i dischi interessati
- In Windows, disabilitare il "Servizio di indicizzazione di Windows"
- Verificare che la directory temporanea, il database ed il file
.tar siano sull'unità più
veloce (idealmente, disco striped/RAID/10)
- In 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:
DB2:
- DB2 prova, per impostazione predefinita, ad incrementare la dimensione del pool di
buffer in base alle esigenze.
A meno che non lo si è disabilitato, DB2 dovrebbe essere eseguito bene
nella configurazione standard.
- Per controllare il pool del buffer, procedere nel modo seguente:
- Connettersi al database Jazz che si desidera importare immettendo quando
segue nel prompt dei comandi:
db2 connect to <databaseName>
- Quindi, eseguire il comando:
db2 "select bufferpoolid, bpname from syscat.bufferpools"
Questo
emetterà un identificativo del pool di buffer in questo formato:BUFFERPOOLID BPNAME
------------ ----------------------------------
1 IBMDEFAULTBP
1 record selezionato.
- Nell'esempio di seguito riportato, l'identificativo del pool del buffer
è 1. Quindi, eseguire il seguente comando:
db2mtrk -d
Questo comando emetterà dati simili a quanto di seguito
riportato:Traccia memoria il: 04/06/2009 alle 22:19:17
Memoria per il 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 grassetto indica la dimensione del
pool del buffer assegnata per il database.
Per avviare la
migrazione: