Migration du référentiel Jazz après la mise à niveau de Jazz Team Server

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.
Avant de commencer
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.
A propos de cette tâche
Généralement, la migration des données est une procédure en deux étapes :

Diagramme de migration du référentiel

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 :
  • Configurez les propriétés suivantes (dans teamserver.properties) pour garantir l'accès à votre disque le plus rapide :
    com.ibm.team.repository.tmpdir
    com.ibm.team.scm.vcs.tmpdir
    com.ibm.team.scm.tmpdir
    com.ibm.team.fulltext.indexLocation
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 :
    1. 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>
    2. 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.
    3. 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.
Oracle :
  • Désactivez la corbeille de vidage ; elle garde une trace de tous les éléments supprimés, ce qui remplit le disque et peut générer des incidents. Exécutez les commandes suivantes dans sqlplus :
    "ALTER SYSTEM SET RECYCLEBIN" = 'OFF' 
    "PURGE RECYCLEBIN"
  • Désactivez la conservation de l'historique des statistiques ; elle garde une trace de l'environnement d'exécution des méthodes précédentes :
    "exec dbms_stats.ALTER_STATS_HISTORY_RETENTION (0)"
    "exec dbms_stats.PURGE_STATS (horodatage_actuel)"
  • Vérifiez que l'espace table Oracle ne s'étend que sur un fichier

Pour démarrer la migration, procédez comme suit :

  1. 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.
  2. 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.
    1. Pour Derby, effectuez une copie d'archivage de tout le répertoire de base de données.
    2. 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é.
  3. 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.
  4. 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.
  5. 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.
  6. 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.tar
    Important : Si votre base de données n'est pas une base de données Derby, vous devez créer une nouvelle base de données pour pouvoir exécuter l'outil d'importation.
    Remarque : L'option -import consigne les informations sur les éléments importés et ignorés, ainsi que les erreurs d'importation.
Que faire ensuite
Vous pouvez maintenant démarrer le serveur Jazz Team Server de la version Y.

Commentaires en retour

Etes-vous satisfait ? Vous pouvez faire part de vos commentaires à l'adresse Jazz.net (enregistrement requis) : Commentaire dans les forums ou soumettre un bogue