La migration du référentiel correspond à la procédure de
conversion du contenu de la base de données d'un format dans un autre. La
migration du référentiel est nécessaire lorsque vous mettez à niveau Jazz Team
Server
de la version X vers la version Y, s'il existe des modifications de schéma dans la version Y.
A propos de cette tâche
Généralement, la migration des données est une procédure en deux étapes :
- Exportation des données de la version X du référentiel Jazz vers un fichier TAR.
- Importation des données du fichier TAR dans la version Y du référentiel Jazz.
Vous pouvez
utiliser l'application repotools pour les opérations d'exportation et
d'importation.
Remarque : Jazz Team
Server doit être arrêté lorsque vous migrez le référentiel. La
migration peut prendre un temps considérable en fonction de la configuration
de votre machine, de votre système d'exploitation, de votre base de données,
etc. Vous devez donc planifier cette
indisponibilité.
Migration du répertoire de recherche documentaire
Jazz Team Server gère un répertoire en dehors de la base de données qui stocke toutes les données nécessaires pour traiter les requêtes de recherche documentaire. L'emplacement du répertoire est défini dans le fichier
teamserver.properties sous la propriété
com.ibm.team.fulltext.indexLocation.
Lorsque vous migrez votre base de données et voulez utiliser le répertoire précédent qui a servi pour l'indexation, vous devez vérifier que l'emplacement utilisé dans l'outil de référentiel
-rebuildTextIndices correspond à l'emplacement utilisé par le serveur. Lorsque vous démarrez le serveur ou exécutez la commande
-rebuildTextIndices, le chemin absolu de l'emplacement du répertoire de recherche documentaire figure dans les fichiers journaux.
Vous pouvez vérifier le fichier journal du serveur et le fichier journal
repotools_rebuildTextIndicies pour comparer les deux répertoires.
Conseil : Si le répertoire défini dans le fichier teamserver.properties est un chemin relatif, un avertissement figure dans le fichier journal. Il est recommandé de définir cette propriété en lui affectant un chemin de répertoire absolu.
Pour plus d'informations sur la création d'index de recherche documentaire, voir
-rebuildTextIndices.
La migration de Jazz Team
Server
est une procédure particulièrement intensive qui peut prendre un certain temps
selon la taille des données migrées. Voici une liste de contrôle des points à
vérifier pour éviter les pièges les plus courants.
Système d'exploitation :
- Sous Windows, vérifiez que le "cache d'écriture sur disque" est activé pour
tous les disques impliqués
- Sous Windows, désactivez "Service d'indexation Windows"
- Vérifiez que votre répertoire temp, votre base de données et le fichier
.tar se trouvent sur l'unité la plus rapide (de préférence sur un disque pisté/RAID/10)
- Sous Linux (pour DB2), assurez-vous d'avoir correctement ajusté le noyau
conformément à la rubrique suivante sur l'administration de DB2 : http://publib.boulder.ibm.com/infocenter/db2luw/v9r5/topic/com.ibm.db2.luw.qb.server.doc/doc/t0008238.html
Configuration
de Jazz Team Server :
DB2 :
- Par défaut, DB2 essaye de choisir la taille de pool de mémoire tampon
nécessaire. Si vous n'avez pas désactivé cette option, DB2 devrait
fonctionner correctement par défaut.
- Pour vérifier le pool de mémoire tampon, procédez comme suit :
- Connectez-vous à la base de données Jazz cible de l'importation en entrant
la commande suivante dans l'invite de commande :
db2 connect to
<nomBasededonnées>
- Exécutez ensuite la commande suivante :
db2 "select bufferpoolid, bpname from syscat.bufferpools"
Cette
commande génère un identificateur de pool de mémoire tampon au format suivant :BUFFERPOOLID BPNAME
------------ ----------------------------------
1 IBMDEFAULTBP
1 record(s) selected.
- Dans l'exemple ci-dessus, l'identificateur de pool de mémoire tampon est 1.
Exécutez ensuite la commande suivante :
db2mtrk -d
Cette
commande génère des données similaires aux suivantes :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
La sortie en gras indique la taille de pool de
mémoire tampon allouée pour votre base de données.
Pour
démarrer la migration, procédez comme suit :
Que faire ensuite
Vous pouvez maintenant démarrer le serveur
Jazz Team
Server de la
version Y.