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

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 for System z de la version X vers la version Y, s'il existe des modifications de schéma dans la version Y. La migration du référentiel est également requise si vous procédez à la mise à niveau à partir de Rational Team Concert vers Rational Team Concert for System z.

Avant de commencer
Vous devez migrer les données si le schéma a été modifié entre les deux versions de Jazz Team Server for System z. Vous devez avoir extrait les fichiers compressés des versions X et Y de Jazz Team Server for System z ou installé les deux versions avec IBM® Installation Manager dans des groupes de modules distincts ou sur des systèmes distincts.
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 for System z 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 système, de votre système d'exploitation, de votre base de données, etc. Vous devez donc planifier cette indisponibilité. Pour des instructions spécifiques sur l'importation et l'exportation des bases de données sous z/OS, voir la rubrique relative à la mise à niveau à partir de Rational Team Concert for System z 1.0.1 sous z/OS dans Mise à niveau vers Rational Team Concert for System z 2.0.

La migration de Jazz Team Server for System z 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 for System z. Pour arrêter Jazz Team Server for System z, 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
    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 for System z de la version Y.

Commentaires en retour

Avez-vous obtenu l'aide souhaitée ? Vous pouvez envoyer des commentaires en retour à Jazz.net (inscription nécessaire) : Commentaire dans les forums ou signaler un bogue