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.
Vous devez migrer les données si le schéma a été modifié entre
les deux versions de Jazz Team Server.
Vous devez avoir extrait les fichiers compressés des versions X et Y de Jazz Team Server.
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é.
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 :
- Arrêtez la version X de Jazz Team Server. Pour arrêter Jazz Team Server,
exécutez server.shutdown.sh pour Linux ou
server.shutdown.bat pour
Windows, dans [répInstall]/jazz/server.
- Effectuez une copie de sauvegarde du référentiel Jazz. Cette copie de
sauvegarde n'est qu'une mesure de prévention au cas où la migration ne se
déroulerait pas correctement.
- Pour Derby, effectuez une copie d'archivage de tout le répertoire de base de données.
- Pour DB2, utilisez la commande de sauvegarde de DB2 pour générer un
fichier d'archive de base de données horodaté dans le répertoire cible spécifié.
- Effectuez une copie de sauvegarde de l'index de recherche. L'emplacement
de l'index de recherche est spécifié dans la propriété com.ibm.team.fulltext.indexLocation
du fichier teamserver.properties.
- Exécutez repotools pour exporter les données du référentiel. Les scripts, repotools.sh pour Linux et repotools.bat pour
Windows, se trouvent dans le répertoire [répInstall]/jazz/server.
Exemple : repotools -export toFile=./file_name.tar
Remarque : Les informations et les messages d'erreur du journal sont affichés sur
la console et dans un fichier journal. Ce fichier journal contient les
informations de débogage relatives au nombre d'éléments exportés, à la durée
d'exportation de ces éléments et aux erreurs, ainsi que d'autres informations utiles.
Le fichier journal est créé par défaut dans le même répertoire que le script repotools. Vous
pouvez modifier l'emplacement du fichier journal à l'aide du paramètre logFile.
Vous avez exporté le contenu du référentiel dans un fichier TAR.
- Copiez le fichier teamserver.properties du répertoire
[répInstall]/jazz/server de la version X vers le
répertoire [répInstall]/jazz/server de la version Y.
- Dans la version Y, exécutez repotools pour importer les données du fichier TAR dans le référentiel.
Exemple :
repotools
-import fromFile=./file_name.tarRemarque : L'option -import consigne les informations sur les éléments importés et ignorés, ainsi que les erreurs d'importation.
Vous pouvez maintenant démarrer le serveur Jazz Team Server de la
version Y.