Pour effectuer cette tâche, vous devez disposer des droits administrateur requis pour créer des zones de projet et des utilisateurs.
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.
Pour préparer Rational Team Concert à recevoir les données de migration, vous devez effectuer les actions suivantes :
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.
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).
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.
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.
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.
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.