Migration multi-sessions

Pour migrer plusieurs sessions Pacbase, vous devez utiliser le même espace de travail en liaison avec un seul flux Rational Team Concert réservé à la migration.

Avant de commencer

Créez le flux de migration dans Rational Team Concert. Ce flux doit prendre en compte les scanners Rational Programming Patterns. Pour éviter tout conflit entre l'exécution de ces scanners et la remontée dans le serveur Rational Team Concert, positionnez le délai d'exécution à -1 durant toute la migration. Pour cela, effectuez les actions suivantes :
  • Connectez-vous en tant qu’administrateur à https://[nom de système hôte qualifié complet]:9443/ccm/admin.
  • Sous l’entrée Configuration, cliquez sur Propriétés avancées.
  • Déroulez les propriétés jusqu’à la catégorie Collecte de données du code source. Déroulez cette catégorie jusqu’à la ligne com.ibm.team.enterprise.internal.metadata.collection.service.MetadataCollectionLoopTaskService.
  • Modifiez la valeur de la propriété Source Code Data Scanning Fixed Delay (seconds). Cliquez sur sa valeur en cours et indiquez -1 à la place.

Le déroulement de la migration de chaque session est identique. Vous devez enchaîner les étapes suivantes :

Procédure

  1. Extrayez les données avec les procédures MIBA ou MIBR. Ces procédures fournissent la liste des Macros à générer par la procédure MIMA et les entrées des procédures MIA1, MIA2, MIA3 et MIA4.
  2. Transférez les fichiers vers le poste sur lequel sont installées les parties clientes de Rational Programming Patterns et des produits requis. Vous devez transférer les fichiers issus de la migration dans un même répertoire.
    Avertissement : Le fichier .ta2 qui reçoit les mouvements du journal depuis la précédente migration ne doit pas être nommé MIBR.ta2. Nommez-le, par exemple MIBJ.ta2 pour le distinguer du résultat d'une migration initiale.
  3. Exécutez la commande de migration automatique rpp --automaticMigration.

    Indiquez le paramètre --validationFile dans la commande de migration automatique pour lancer la validation de la migration en même temps que l'aide à la migration. L'aide à la migration migre alors les fichiers COBOL ne comportant plus de différences après l'application des types de validation et valide leur migration en même temps. Elle produit un fichier .log indiquant le nombre de fichiers COBOL validés. Cependant, avant d'indiquer le paramètre --validationFile sur la commande de migration automatique, il est conseillé de vérifier que les types de validation contenus dans le fichier validation.xml sont adaptés. Lancez la validation de la migration depuis la vue Gestionnaire de validation sur un nombre significatif de fichiers COBOL. Si les résultats de la validation vous conviennent, vous pouvez alors lancer la migration automatique avec le paramètre --validationFile.

  4. Exécutez le fichier de commandes résultat. Ce fichier doit comporter les commandes suivantes :
    • La commande d'import du fichier .ta2 produit par les procédures Pacbase : rpp --import.
    • La commande de répartition du code source des Macros : rpp --dispatchMacro.
    • La commande d'aide à la migration : rpp --migrationHelp. Cette commande est lancée automatiquement avec le paramètre --validationFile indiqué dans la commande de migration automatique.
  5. Sauvegardez les données dans Rational Team Concert.
  6. Prenez une image instantanée du flux de migration. Depuis la vue Artefacts de l'équipe, faites un clic droit sur le flux et sélectionnez Nouveau > Image instantanée.
  7. Construisez les index serveur.

    Dans la perspective Eléments de travail, vous devez sélectionner le flux de migration afin qu'il soit analysé. Pour cela, dans la vue Artefacts de l'équipe, sous votre zone de projet, sélectionnez Extensions d'entreprise > Données de code source > Sélection des flux pour l'analyse.

    Pour lancer la construction des index, sélectionnez le choix Mettre à jour les données de code source sur le flux de migration.

  8. Dupliquez le flux de migration. Depuis la vue Artefacts de l'équipe, faites un clic droit sur le flux et sélectionnez Dupliquer.
  9. Mettez à jour les index serveur.

    Dans la perspective Eléments de travail, vous devez sélectionner le flux dupliqué pour qu'il soit analysé. Pour cela, dans la vue Artefacts de l'équipe, sous votre zone de projet, sélectionnez Extensions d'entreprise > Données de code source > Sélection des flux pour l'analyse.

    Pour lancer la mise à jour des index, sélectionnez le choix Mettre à jour les données de code source sur le flux dupliqué.

Résultats

A la fin de la migration de chaque session, copiez l'espace de travail local. Cet espace de travail peut servir dans le cadre d'une migration progressive.

A partir de la migration de la deuxième session, certains traitements diffèrent, même si les étapes sont identiques.

En effet, vous devez indiquer le paramètre --previousSessionFolder dans la commande de migration automatique pour chaque nouvelle session. Ce paramètre réduit le temps de migration car les fichiers COBOL identiques dans les deux sessions (hormis les constantes Pacbase et la date de génération) ne sont pas réimportés. De plus, les commandes rpp --import et rpp --dispatchMacro ne prennent alors en compte que les instances ayant évolué.

Seules les vraies différences sont ainsi remontées dans le serveur Rational Team Concert.

Important : Pour ne pas fausser les résultats, vous devez enchaîner la migration des sessions sans effectuer de modifications locales dans Rational Programming Patterns. A la fin d'une migration multi-sessions, vous pourrez prendre en compte les modifications Pacbase en exécutant la procédure MIBJ.

Vos commentaires