Unter einer Repositorymigration ist der Prozess zu verstehen, bei dem der Inhalt einer Datenbank von einem Format in ein anderes umgewandelt wird. Eine Repositorymigration wird erforderlich, wenn Sie für den Jazz Team Server ein Upgrade von Version X auf Version Y (mit Schemaänderungen) vornehmen.
Informationen zu diesem Vorgang
Gewöhnlich ist die Datenmigration ein Prozess in zwei Schritten:
- Die Daten aus der Version X des Jazz-Repositorys werden in eine TAR-Datei exportiert.
- Die Daten aus der TAR-Datei werden in die Version Y des Jazz-Repositorys importiert.
Für die Export- und Importoperationen können Sie die Anwendung repotools verwenden.
Anmerkung: Für die Migration des Repositorys muss Jazz Team Server gestoppt werden. Je nach Systemkonfiguration, Betriebssystem, Datenbank usw. kann die Migration etliche Zeit in Anspruch nehmen. Planen Sie die anfallende Betriebsunterbrechung daher entsprechend.
Volltextverzeichnis migrieren
Vom Jazz Team Server wird ein Verzeichnis außerhalb der Datenbank verwaltet, in dem alle Daten gespeichert werden, die zum Verarbeiten von Abfragen im Volltextmodus erforderlich sind. Die Position des Verzeichnisses wird in der Datei
teamserver.properties in der Eigenschaft
com.ibm.team.fulltext.indexLocation definiert. Wenn Sie Ihre Datenbank migrieren und dabei das vorher für die Indexierung benutzte Verzeichnis verwenden möchten, müssen Sie sicherstellen, dass die im Befehl
-rebuildTextIndices verwendete Position der vom Server verwendeten Position entspricht. Wenn Sie den Server starten oder den Befehl
-rebuildTextIndices ausführen, wird der absolute Pfad zur Position des Volltextverzeichnisses in die Protokolldateien eingetragen. Sie können die Serverprotokolldatei und die
repotools_rebuildTextIndicies-Protokolldatei überprüfen, um die Angaben zu den beiden Verzeichnissen miteinander zu vergleichen.
Tipp: Wenn das konfigurierte Verzeichnis in der Datei teamserver.properties einem relativen Pfad entspricht, wird eine Warnung in die Protokolldatei eingetragen. Es wird empfohlen, für diese Eigenschaft einen absoluten Verzeichnispfad zu konfigurieren.
Weitere Informationen zum Erstellen von Volltextindexen finden Sie unter
-rebuildTextIndices.
Bei einer Jazz Team Server-Migration handelt es sich um einen sehr komplexen Prozess, der je nach Umfang der zu migrierenden Daten ziemlich zeitintensiv sein kann. In der folgenden Liste sind Aspekte aufgeführt, die zur Vermeidung der üblichen Probleme zu beachten sind.
Betriebssystem:
- Unter Windows muss für alle betroffenen Datenträger "write caching on disk" aktiviert werden.
- Unter Windows muss "Windows Indexing Service" inaktiviert werden.
- Temporäres Verzeichnis, Datenbank und .tar-Datei müssen sich auf dem schnellsten Laufwerk (idealerweise einem Striped-/RAID-/10-Datenträger) befinden.
- Unter Linux (für DB2) ist sicherzustellen, dass der Kernel entsprechend den über den folgenden Link aufzurufenden DB2-Verwaltungsrichtlinien ordnungsgemäß optimiert wurde: http://publib.boulder.ibm.com/infocenter/db2luw/v9r5/topic/com.ibm.db2.luw.qb.server.doc/doc/t0008238.html.
Jazz Team Server-Konfiguration:
DB2:
- Von DB2 wird standardmäßig versucht, den Umfang des Pufferpools auf die erforderliche Größe zu bringen. Wenn Sie diese Option nicht inaktiviert haben, sollte DB2 ohne Vorbereitungs- oder Anpassungsaufwand problemlos funktionieren.
- Führen Sie die folgenden Schritte aus, um den Pufferpool zu überprüfen:
- Stellen Sie eine Verbindung zu der Jazz-Datenbank her, in die importiert werden soll. Nehmen Sie dazu über die Eingabeaufforderung den folgenden Eintrag vor:
db2 connect to <datenbankname>
- Führen Sie dann den folgenden Befehl aus:
db2 "select bufferpoolid, bpname from syscat.bufferpools"
Das führt zur Ausgabe einer Pufferpoolkennung in folgendem Format: BUFFERPOOLID BPNAME
------------ ----------------------------------
1 IBMDEFAULTBP
1 record(s) selected.
- Im oben genannten Beispiel lautet die Pufferpoolkennung "1". Führen Sie nun den folgenden Befehl aus:
db2mtrk -d
Das führt zur Ausgabe von Daten ähnlich den folgenden: Tracking Memory on: 2009/06/04 at 22:19:17
Memory for database: <datenbankname>
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
Bei der Angabe in Fettschrift handelt es sich um die Ihrer Datenbank zugeordnete Pufferpoolgröße.
So
starten Sie die Migration:
Nächste Schritte
Sie können nun die Version Y von
Jazz Team Server starten.