Intégration avec Rational Team Concert

Rational Programming Patterns est installé par dessus IBM® Rational Team Concert. Vous devez maintenant configurer Rational Team Concert de façon à y intégrer Rational Programming Patterns.

Pourquoi et quand exécuter cette tâche

L'objectif de cette intégration est de permettre la construction des index sur la partie serveur de Rational Programming Patterns. Vous devez effectuer les actions suivantes :

Pour une intégration optimale, il est conseillé de modifier quelques paramètres par défaut.

Remarque : Après une succession d’installations et réinstallations, le cache du serveur peut être déphasé par rapport à la configuration réelle du serveur. Il se peut, par exemple, que les scanners Rational Programming Patterns ne soient pas visibles et que les définitions de langage liées à Rational Programming Patterns ne puissent donc pas être correctement spécifiées. Vous devez alors réinitialiser le cache.
  1. Connectez-vous en tant qu’administrateur à https://[nom de système hôte qualifié complet]:9443/ccm/admin?internal.
  2. Sous l’entrée Outils internes, cliquez sur Statut de la provision. Tous les contributeurs au serveur Rational Team Concert, s’affichent. Si les plug-ins Rational Programming Patterns apparaissent parmi ces contributeurs, vous devez réinitialiser le cache.
  3. Pour réinitialiser le cache, cliquer sur Réinitialisation du serveur, situé juste après .Statut de la provision.
  4. Cliquez sur le bouton Demander la réinitialisation du serveur. Le cache sera alors réinitialisé lors du prochain démarrage du serveur.
  5. Arrêtez et redémarrez le serveur. Le démarrage est plus long qu'un démarrage standard car le cache est réinitialisé

Procédure

  1. Création d'un utilisateur et attribution des droits :
    1. Lancez Jazz Team Server et ouvrez son assistant de configuration (https://[nom de système hôte qualifié complet]:9443/jts/setup).

      Suivez les instructions de la documentation Rational Team Concert : Exécution de l'assistant de configuration.

    2. Si cela n'a pas été fait lors de la phase de configuration du serveur Jazz, créez un utilisateur.
    3. Affectez à cet utilisateur une Licence d'Accès Client Developer for IBM Enterprise Platforms.
    4. Vérifiez que l'utilisateur créé possède tous les droits d'accès au référentiel, ainsi que la Licence d'Accès Client Developer for IBM Enterprise Platforms.
  2. Création d'une zone de projet :
    1. Lancez Rational Programming Patterns.
    2. Ouvrez la perspective Eléments de travail.
    3. Dans la vue Artefacts de l'équipe, créez une connexion au serveur à l'adresse :

      https://[nom de système hôte qualifié complet]:9443/ccm

      avec un utilisateur administrateur précédemment créé.

    4. Créez une zone de projet.
      Remarque : Toutes les explications sur les zones de projet se trouvent dans la documentation Solution Rational pour Collaborative Lifecycle Management.
  3. Vérification des droits d'accès :

    En tant qu’administrateur, vous devez vérifier que l’utilisateur qui va créer les définitions de langage pour les artefacts de Rational Programming Patterns a les droits d'accès nécessaires.

    1. Depuis la perspective Eléments de travail de l’espace de travail Eclipse, ouvrez la zone de projet en faisant un clic droit dessus et en sélectionnant Ouvrir.
    2. Sur l'onglet Présentation de la zone de projet, vérifiez le rôle attribué à l’utilisateur qui va créer les définitions de langage.
    3. Ouvrez l'onglet Configuration du processus. Développez Configuration de projet dans la partie Configuration et sélectionnez Droits d'accès. Dans la liste des Rôles, sélectionnez le rôle de l’utilisateur qui va créer les définitions de langage. Dans l'arbre Actions autorisées, vérifiez que les lignes Définitions de langage et Données de code source sont sélectionnées.
      Figure 1. Onglet Configuration du processus
      Onglet Configuration du processus
    4. Sauvegardez.
  4. Création des définitions de langage et association des scanners :
    Vous pouvez maintenant créer quatre définitions de langage :
    • RPP Design
    • RPP Design Path
    • RPP Generated
    • RPP Macro
    1. Développez la zone de projet dans la vue Artefacts de l'équipe. Développez ensuite Extensions d'entreprise > Définitions du système > z/OS. Faites un clic droit sur Définitions de langage et sélectionnez Nouvelle définition de langage. L'éditeur Définition de langage s'ouvre. Il contient un onglet Général et un onglet Scanners.
      Figure 2. Editeur Définition de langage
      Editeur Définition de langage
    2. Créez la définition du langage pour les artefacts du design.
      1. Dans l'onglet Général :
        • Saisissez RPP Design dans la zone Nom.
        • Saisissez optionnellement une description, telle que RPP Design File Scanner, dans la zone Description.
        • Sélectionnez COBOL dans la zone Langage.
        • Indiquez les extensions de fichier suivantes dans la zone Extensions de fichier. Toutes ces extensions devant être indiquées, il est conseillé de copier et coller les lignes suivantes :
          dataaggregate,dataelement,dataunit,pacblockbase,pacdialog,pacscreen,
          pacdialogserver,pacserver,paclibrary,pacprogram,pacreport,pacinputaid,
          pactext,metaentity,userentity,metadataaggregate,metaentitytype
          Important : Seules les extensions ci-dessus sont prises en compte par Rational Programming Patterns. Les caractères génériques sont interdits.
          Avertissement : Jusqu'à la version V9.1, l'extension pacmacro faisait partie des extensions d'artefacts de design. Cette extension fait maintenant l'objet d'une définition de langage spécifique. Vous devez donc la supprimer de la définition de langage pour les artefacts du design et créer une définition de langage pour les Macros.
      2. Dans l'onglet Scanners, supprimez le scanner par défaut et ajoutez le RPP Design Scanner pour cette définition de langage.
      3. Sauvegardez.
    3. Créez la définition du langage pour les artefacts du chemin du design.
      1. Sélectionnez à nouveau Nouvelle définition de langage.
      2. Dans l'onglet Général :
        • Saisissez RPP Design Path dans la zone Nom.
        • Saisissez optionnellement une description, telle que RPP DesignPath File Scanner, dans la zone Description.
        • Sélectionnez COBOL dans la zone Langage.
        • Saisissez l'extension de fichier suivante dans la zone Extensions de fichier :

          designpath

          Important : Seule l'extension ci-dessus est prise en compte par Rational Programming Patterns. Les caractères génériques sont interdits.
      3. Dans l'onglet Scanners, supprimez le scanner par défaut et ajoutez le RPP Designpath Scanner pour cette définition de langage.
      4. Sauvegardez.
    4. Créez la définition du langage pour les artefacts générés.
      • Sélectionnez à nouveau Nouvelle définition de langage.
      • Dans l'onglet Général :
        • Saisissez RPP Generated dans la zone Nom.
        • Saisissez optionnellement une description, telle que RPP Generated File Scanner, dans la zone Description.
        • Sélectionnez COBOL dans la zone Langage.
        • Saisissez les extensions de fichier suivantes dans la zone Extensions de fichier. Toutes ces extensions devant être indiquées, il est conseillé de copier et coller la ligne suivante :

          cblpdp,bmspdp,mappdp,mfspdp,dllpdp,txtpdp

          Important : Seules les extensions ci-dessus sont prises en compte par Rational Programming Patterns. Les caractères génériques sont interdits.
        • Dans l'onglet Scanners, supprimez le scanner par défaut et ajoutez le RPP Generated File Scanner pour cette définition de langage.
        • Sauvegardez.
    5. Créez la définition du langage pour les Macros.
      • Sélectionnez à nouveau Nouvelle définition de langage.
      • Dans l'onglet Général :
        • Saisissez RPP Macro dans la zone Nom.
        • Saisissez optionnellement une description, telle que RPP Macro Scanner, dans la zone Description.
        • Sélectionnez COBOL dans la zone Langage.
        • Saisissez l'extension de fichier suivante dans la zone Extensions de fichier :

          pacmacro

          Important : Seule l'extension ci-dessus est prise en compte par Rational Programming Patterns. Les caractères génériques sont interdits.
        • Dans l'onglet Scanners, supprimez le scanner par défaut et ajoutez le RPP Macro Scanner pour cette définition de langage.
        • Sauvegardez.
  5. Association des flux concernés :

    Indiquez les flux concernés par l'analyse. Dans la vue Artefacts de l'équipe, sous Extensions d'entreprise, faites un clic droit sur Données de code source. puis sélectionnez Sélectionner des flux pour l'analyse. Sélectionnez le flux.

    Si vous ne voyez aucun flux, vous devez en créer un avant de pouvoir sélectionner ce choix. Suivez les instructions de la documentation Rational Team Concert : création de flux.

    Figure 3. Comment ouvrir l'assistant de sélection du flux
    Sélection de flux pour l'analyse
  6. Modification des paramètres :
    • Paramètres mémoire du poste client
      • eclipse.ini :

        Vous devez modifier le paramètre de la mémoire de la Software Delivery Platform. La valeur maximale est différente suivant le système d'exploitation et la mémoire disponible. Vous devez donc trouver la valeur maximale supportée par votre configuration.

        Pour ce faire, éditez le fichier eclipse.ini situé directement sous la racine de la Software Delivery Platform.

        Par défaut, la taille de segment de mémoire Java™ est positionnée à 1024 (dans -Xmx1024m). Cette valeur peut être augmentée pour s'adapter à votre configuration matérielle.
        Remarque : Pour une installation en mode 32 bits, la valeur maximale est de 1,5 gigaoctet.
      • scm.ini :

        La migration des données Pacbase dans Rational Programming Patterns utilise les scmtools pour la sauvegarde des données migrées dans Rational Team Concert.

        Vous devez modifier le fichier scm.ini de la même façon que le fichier eclipse.ini.

        Le fichier scm.ini se trouve dans ...\scmtools\eclipse. Par défaut, la taille de segment de mémoire Java est positionnée à 512 (dans -Xmx512m).

    • Paramètre mémoire du poste serveur :

      Vous pouvez adapter le fichier server.startup.bat, situé dans le répertoire ...\server. Dans un environnement 64 bits, et sur un serveur le supportant, vous pouvez modifier la ligne set JAVA_OPTS=%JAVA_OPTS% -Xmx4G pour monter la mémoire maximum utilisée à 8G.

    • Propriétés du serveur Rational Team Concert :
      • Blocage de la création de composants en double :

        Par défaut, les noms des composants ne sont pas uniques dans le référentiel Rational Team Concert. Pour éviter des incohérences, il est conseillé qu’un administrateur interdise aux utilisateurs de créer des composants dont les noms ne sont pas uniques.

        1. Connectez-vous en tant qu’administrateur à https://[nom de système hôte qualifié complet]:9443/ccm/admin.
        2. Sous l’entrée Configuration, cliquez sur Propriétés avancées.
        3. Déroulez les propriétés jusqu’à la catégorie SCM. Déroulez cette catégorie jusqu’à la ligne com.ibm.team.scm.service.internal.tasks.InternalScmService.
        4. Trouvez la propriété Encourager les noms de composants à être uniques.
        5. Cliquez sur sa valeur en cours (false par défaut) et changez-la en true.
        6. Cliquez sur le bouton Sauvegarder, situé au début de la page des propriétés.
      • Nombre maximum de fichiers dans une ressource de données de code source :
        Cette modification permet d'éviter une consommation mémoire trop importante.
        1. Connectez-vous en tant qu’administrateur à https://[nom de système hôte qualifié complet]:9443/ccm/admin.
        2. Sous l’entrée Configuration, cliquez sur Propriétés avancées.
        3. Déroulez les propriétés jusqu’à la catégorie Collecte de données du code source. Cette catégorie contient la ligne com.ibm.team.enterprise.internal.metadata.collection.service.Metadata
          CollectionService.
        4. Modifiez la valeur de la propriété Nombre max. de fichiers dans une ressource de données de code source. Cliquez sur sa valeur en cours et indiquez 100 à la place.
    • Paramètre DB2 :
      Pour faire fonctionner Rational Team Concert avec une base DB2, vous pouvez consulter le site jazz.net pour des détails sur la mise au point de DB2. Pour importer de très grosses bases DB2, vous devez augmenter les valeurs suivantes :
      db2 UPDATE DB CFG FOR CCM using LOGPRIMARY 100
      db2 UPDATE DB CFG FOR CCM using LOGSECOND 100
      100 représente la valeur augmentée. Pour voir les valeurs, utilisez la commande suivante :
      db2 GET DB CFG FOR sample |grep '(LOG[FPS]'
      Vous obtenez alors la liste des valeurs suivantes :
       Taille des fichiers journaux (4 Ko)    (LOGFILSIZ) = 1000
       Nombre de fichiers journaux primaires  (LOGPRIMARY) = 3
       Nombre de fichiers journaux secondaires (LOGSECOND)  = 2

Résultats

Les étapes de configuration sont maintenant achevées.

Quand vous distribuerez un projet contenant des artefacts Rational Programming Patterns, ceux-ci seront indexés, après l'activation manuelle ou automatique du processus d'indexation. Vous pourrez alors effectuer des recherches sur le référentiel serveur.


Vos commentaires