Remontée dans le serveur Rational Team Concert

Pour effectuer cette tâche, vous devez disposer des droits administrateur requis pour créer des zones de projet et des utilisateurs.

Avant de commencer

Avant de lancer le processus de remontée, vous devez récupérer le fichier qui définit les règles d'encodage et les délimiteurs utilisés lors de la première restitution. Vous devez donc récupérer le fichier magic.properties du répertoire ...\rpp\properties et le déposer dans le répertoire jazz-scm. Pour plus de détails, consultez les explications sur ce fichier dans jazz.net.

Vous devez ensuite éditer le fichier preferences.properties, situé dans le répertoire jazz-scm. Dans ce fichier, ajoutez la propriété trace.disable: true afin d'optimiser la remontée.

Procédure

  1. Préparation de l'environnement Rational Team Concert
    Important : Pour des explications sur les notions Rational Team Concert évoquées ici, reportez-vous à l'aide Rational Team Concert.

    Pour préparer Rational Team Concert à recevoir les données de migration, vous devez effectuer les actions suivantes :

    1. Ouvrez la perspective Eléments de travail dans Rational Team Concert.
    2. Créez une connexion au référentiel Jazz.
    3. Créez une zone de projet à partir de la connexion au référentiel Jazz déjà créée. Cette zone de projet permettra de gérer les livrables du projet, la structure de l'équipe, les processus et le planning.
    4. Créez une zone d'équipe dans laquelle vous devez ajouter l'utilisateur de migration avec le rôle permettant d'assurer les actions de gestion de la configuration (autorisation aux actions liées au contrôle des sources comme Restituer ou Distribuer).
    5. Créez un flux pour le stockage initial des artefacts. Par la suite, ce flux permettra de livrer les artefacts modifiés, et d'accepter les modifications d'artefacts des autres membres de l'équipe.
  2. Modification du fichier de déverrouillage
    Cette étape doit être effectuée pour reprendre les verrous Pacbase sur les instances migrées à partir de la procédure d'extraction du journal MIBJ.
    Remarque : L'option de reprise des verrous doit avoir été indiquée dans la procédure.

    Les instances verrouillées doivent être déverrouillées avant d'être distribuées sur le serveur, puis reverrouillées si nécessaire.

    Vous lancez le déverrouillage en lançant le fichier de script scmUnLock.bat avant de distribuer sur le serveur Rational Team Concert. Ce fichier est automatiquement créé dans le répertoire .metadata de l'espace de travail de migration lors de la phase d'import du journal.

    Le déverrouillage s'applique aux instances modifiées ou supprimées par le journal. Les instances crées par le journal ne figurent pas dans le fichier de script.

    Le script doit être modifié pour préciser l'adresse du serveur Rational Team Concert, le flux concerné et le chemin d'accès aux commandes scm.

    Le code et le mot de passe de l'administrateur Rational Team Concert doivent être renseignés dans le fichier de script. Ils peuvent être saisis manuellement, ou pris en compte automatiquement à partir d'un fichier qui doit être explicitement créé. Ce fichier doit se nommer pac_rtc_users et se situer dans le même répertoire que le fichier d'import ta2. Il doit contenir au moins une ligne calquée sur la syntaxe suivante :

    Utilisateur Pacbase#Utilisateur RTC#Mot de passe RTC#A

    Le code utilisateur Pacbase est facultatif pour le déverrouillage. Le #A indique qu'il s'agit d'un administrateur. Une ligne d'administrateur est obligatoire.

    L'exécution du script scmUnLock.bat génère un fichier scmUnLocklog dans le répertoire .metadata pour vérifier l'exécution de la commande de déverrouillage.

  3. Partage des projets de l'espace de travail local

    Un fichier de script contenant les commandes scm de Rational Team Concert nécessaires au partage des projets est automatiquement créé à la fin du processus de migration, par l'exécution du fichier de commandes (rpp --commands).

    Ce fichier, nommé scmtools_entries.bat, se trouve dans le répertoire .metadata de votre espace de travail. Il contient toutes les commandes scm d'initialisation des paramètres, de création d'un espace de travail de référentiel associé au flux et les commandes de remontée des informations dans le flux.
    Important : L’espace de travail ayant servi à remonter les données sur le serveur n’est plus utilisable après la remontée.
    Vous devez d'abord éditer ce fichier pour modifier les commandes d'initialisation des paramètres des lignes de commande.
    Tableau 1. Liste des commandes d'initialisation des paramètres
    Lignes de commande à saisir Explications
    SET path="C:\Program Files\IBM\SDP\scmtools\eclipse";%PATH% Chemin du répertoire Eclipse des scmtools
    SET jazz_wsp=WksRef Nom de l'espace de travail référentiel.

    Vous devez indiquer le même espace de travail référentiel pour remonter successivement les données issues de plusieurs sessions Pacbase.

    SET jazz_id=user Utilisateur de migration (défini dans Jazz)
    SET jazz_uri=https://uri:9443/ccm/ URI d'accès au référentiel (indiqué lors de la création d'une connexion au référentiel Jazz depuis la vue Artefacts de l'équipe)
    SET project_area="zone de projet" Nom de la zone de projet à laquelle les composants seront associés
    SET jazz_Stream=StreamMigr Nom du flux pour la migration
    SET Snapshot=image instantanée Nom de l’image instantanée.
    SET Comment="xx" Commentaire sur l’ensemble d’artefacts modifiés
    SET LocalWS=C:\xxxx Nom de l'espace de travail local

    Exécutez ensuite le fichier scmtools_entries.bat. Pour des informations sur les commandes exécutées par ce fichier, référez-vous à l'aide Rational Team Concert sur les lignes de commande de contrôle des sources.

  4. Modification du fichier de verrouillage
    Cette étape doit être effectuée pour reprendre les verrous Pacbase sur les instances migrées à partir des procédures d'extraction MIBR ou MIBJ.
    Remarque : L'option de reprise des verrous doit avoir été indiquée dans la procédure.
    Vous devez lancer le fichier de script scmLock.bat après la distribution sur le serveur Rational Team Concert. Ce fichier de script est automatiquement créé dans le répertoire .metadata de l'espace de travail de migration lors de la phase d'import. Il contient la liste des instances qui seront verrouillées (ou reverrouillées dans le cadre d'une migration progressive) sur le serveur Rational Team Concert après la distibution. Seul l'utilisateur propriétaire du verrou pourra alors remonter l'instance verrouillée.
    Remarque : L'espace de travail de référentiel utilisé pour la migration doit être public pour permettre aux utilisateurs de verrouiller les instances.

    Le script doit être modifié pour préciser l'adresse du serveur Rational Team Concert, le flux concerné et le chemin d'accès aux commandes scm.

    L'exécution du script génère un fichier scmLocklog dans le répertoire .metadata pour vérifier l'exécution de la commande de verrouillage.

    Le fichier de script doit transférer les verrous des utilisateurs Pacbase vers les utilisateurs Rational Team Concert, qui sont généralement différents. Les codes des utilisateurs Pacbase sont automatiquement récupérés depuis les enregistrements du fichier d'import ta2. Ils doivent être mis en correspondance avec les utilisateurs Rational Team Concert. Vous pouvez le faire manuellement dans le script ou créer un fichier pac_rtc_users et l'enregistrer dans le même répertoire que le fichier d'import ta2. Les utilisateurs seront alors mis en correspondance. Chaque ligne du fichier de correspondance représente un utilisateur, selon la syntaxe suivante :

    Utilisateur Pacbase#Utilisateur RTC#Mot de passe RTC

    Si l'utilisateur est un administrateur Rational Team Concert, vous devez ajouter #A à la fin de la ligne. Une ligne d'administrateur n'est pas nécessaire pour le verrouillage et, si elle existe, elle n'a pas besoin d'être en correspondance avec un utilisateur Pacbase. Si les mots de passe ne sont pas indiqués dans le fichier de correspondance, la concaténation de l'utilisateur Rational Team Concert et du mot _password sera générée dans le fichier script généré pour former les mots de passe.

  5. Construction des index serveur

    Dans la perspective Eléments de travail, vous devez sélectionner le ou les flux créés afin qu'ils soient analysés. 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.

    Ainsi, à chaque mise à jour de ces flux, les index serveur seront créés, si nécessaire.

    Pour lancer la construction initiale des index, sélectionnez le choix Réinitialiser les données de code source, disponible dans le même menu que Sélection des flux pour l'analyse.

    Important : Cette étape peut être très longue. Vous devez donc modifier le paramètre de connexion au serveur Rational Team Concert pour éviter des problèmes de dépassement de temps. Pour cela, faites un clic droit sur votre connexion au référentiel dans la vue Artefacts de l'équipe. Sur la page Connexion au référentiel Jazz, indiquez 0 dans la zone Délai de connexion (en secondes). Cliquez sur OK.
  6. Traitement d'autres contextes Pacbase

    Pour remonter plusieurs contextes, vous devez vérifier que la valeur de la propriété avancée Encourager les noms de composants à être uniques a bien été changée en true, comme indiqué dans le guide d’installation de Rational Programming Patterns.


Vos commentaires