Personnalisation des fichiers de propriétés de Jazz Team Server et de Rational solution for Collaborative Lifecycle Management pour DB2 sous z/OS

Cette section explique comment éditer et configurer les fichiers teamserver.properties pour que le serveur sous z/OS puisse se connecter à DB2. Jazz Team Server (JTS) et les autres applications Rational solution for Collaborative Lifecycle Management (CLM) ont chacune leur fichier de propriétés teamserver.properties, qui contient des propriétés du serveur.

Pourquoi et quand exécuter cette tâche

Localisez les répertoires de configuration de chaque application :
  • Jazz Team Server (JTS) - @confPath@/jts
  • Gestion des modifications et de la configuration (CCM) - @confPath@/ccm
  • Gestion de la qualité (QM) - @confPath@/qm
  • Gestion des exigences (RM) - utilise les informations de connexion à la base de données figurant dans le fichier teamserver.properties de Jazz Team Server, de sorte que vous n'avez pas à répéter cette étape pour l'application RM.

Sous z/OS, @confPath@ correspond à la valeur du chemin utilisée lors de la personnalisation du serveur à l'aide des exemples de travaux BLZCP*, par exemple /etc/jazz40. Sur des systèmes autres que z/OS, @confPath@ correspond au chemin d'installation du répertoire de configuration, par exemple /opt/IBM/JazzTeamServer/server/conf sous Linux.

Par défaut, les fichiers teamserver.properties sont configurés de sorte à utiliser un référentiel et un entrepôt de données Derby pour la génération de rapports. Editez chaque fichier teamserver.properties pour l'utilisation de DB2 for z/OS conformément aux instructions de cette rubrique.

Utilisez la commande -DIS DDF pour votre sous-système DB2 for z/OS afin d'afficher certaines des valeurs que vous devez fournir. Par exemple, vous pouvez extraire les paramètres location, ipaddr et port (tcpport) de l'affichage suivant :
-DSN9 DIS DDF                                                   
 DSNL080I  -DSN9 DSNLTDDF DISPLAY DDF REPORT FOLLOWS: 548        
 DSNL081I STATUS=STARTD                                          
 DSNL082I LOCATION           LUNAME            GENERICLU         
 DSNL083I NS32DB             NETA.NS32DB       -NONE             
 DSNL084I TCPPORT=3500  SECPORT=3510  RESPORT=3501  IPNAME=-NONE 
 DSNL085I IPADDR=9.42.81.74                                    
 DSNL086I SQL    DOMAIN=RALNS32.example.com              
 DSNL086I RESYNC DOMAIN=RALNS32.example.com              
 DSNL099I DSNLTDDF DISPLAY DDF REPORT COMPLETE                   
Modifiez chaque fichier teamserver.properties en fonction de la configuration que vous avez créée au cours des étapes précédentes et en fonction de votre configuration DB2 z/OS. Editez les propriétés suivantes en fonction de votre configuration :
  • ipAddress,
  • ipPort
  • location
  • user
  • password
  • dbname
  • schemaprefix
Remarques :
  • Il peut y avoir jusqu'à quatre référentiels : un référentiel pour JTS, un référentiel pour chaque composant installé qui dispose d'une base de données (CCM et QM) et un référentiel pour l'entrepôt de données.
  • Chacun de ces référentiels doit avoir un nom de base de données et un préfixe de schéma uniques (s'ils sont hébergés sur le même sous-système DB2 z/OS).
  • Chaque fichier de propriétés doit pointer vers la même configuration d'entrepôt de données.

Pour configurer le serveur ou l'application afin d'utiliser DB2 for z/OS, modifiez chaque fichier teamserver.properties dans les répertoires de configuration pour Jazz Team Server ou les autres applications CLM installées. Par exemple, ouvrez les fichiers @confPath@/jts/teamserver.properties et @confPath@/ccm/teamserver.properties et recherchez les lignes suivantes : Cet exemple correspond à CCM :

# JDBC Repository DB location, specifying this property disables 
# system-based selection of default location 
# NOTE THAT EVERY APPLICATION INSTANCE AND JAZZ TEAM SERVER 
# REQUIRES ITS OWN UNIQUE DATABASE
com.ibm.team.repository.db.vendor = DERBY 
com.ibm.team.repository.db.jdbc.location=conf/ccm/derby/repositoryDB

# JDBC Data Warehouse DB location, specifying this property disables 
# system-based selection of default location
com.ibm.team.datawarehouse.db.vendor=derby_net
com.ibm.team.datawarehouse.db.jdbc.location=//localhost:1527/conf/jts/derby/warehouseDB 
Ajoutez le signe # dans la colonne 1 pour mettre en commentaire les propriétés suivante pour com.ibm.team.repository et com.ibm.team.datawarehouse, comme suit :
# JDBC Repository DB location, specifying this property disables 
# system-based selection of default location
# NOTE THAT EVERY APPLICATION INSTANCE AND JAZZ TEAM SERVER REQUIRES ITS OWN UNIQUE DATABASE
#com.ibm.team.repository.db.vendor = DERBY
#com.ibm.team.repository.db.jdbc.location=conf/ccm/derby/repositoryDB

# JDBC Data Warehouse DB location, specifying this property disables 
# system-based selection of default location
#com.ibm.team.datawarehouse.db.vendor=derby_net
#com.ibm.team.datawarehouse.db.jdbc.location=//localhost:1527/conf/jts/derby/warehouseDB
Annulez la mise en commentaire des lignes figurant dans les exemples et modifiez-les pour les adapter à la configuration de base de données créée dans les étapes précédentes, ainsi qu'à votre configuration DB2.

Modifiez les propriétés location, user, password et dbname conformément à votre configuration.

Notamment, éditez les lignes suivantes dans chaque fichier teamserver.properties pour ce référentiel :
  1. Prenez soin d'annuler la mise en commentaire de la ligne suivante :
    com.ibm.team.repository.db.vendor = db2z
  2. Dans la ligne suivante :
    com.ibm.team.repository.db.jdbc.location=//ipAddress:ipPort/
    location:user=jazzDBuser;password={password};
    remplacez :
    • ipAddress par votre adresse IP.
    • ipPort par votre port TCP.
    • location par la valeur répertoriée dans le rapport DDF sous LOCATION.
    • jazzDBuser par l'ID utilisateur que vous avez créé et qui possède un accès approprié à la base de données DB2.
      Remarque : Ne modifiez pas password={password}.
  3. Dans la ligne suivante :
    com.ibm.team.repository.db.jdbc.password=jazzDBpswd
    remplacez jazzDBpswd par le mot de passe de votre utilisateur DB2 z/OS.
  4. Dans la ligne suivante :
    com.ibm.team.repository.db.db2.dsn.dbname=JAZZDB
    remplacez JAZZDBpar le nom de la base de données que vous avez créée pour ce composant.
  5. Dans la ligne suivante :
    #com.ibm.team.repository.db.schemaPrefix=xx
    vous devez supprimer le signe # et remplacer xx par un préfixe unique pour chaque base de données dans le même sous-système DB2 z/OS.
    Remarque : Pour créer plusieurs bases de données Jazz dans le même sous-système DB2, vous devez différencier les propriétaires de table des tables Jazz. Pour ce faire, Jazz Team Server utilise la directive com.ibm.team.repository.db.schemaPrefix pour ajouter un préfixe aux objets DB2 Jazz afin qu'ils soient uniques sur un sous-système DB2. Le préfixe défini dans com.ibm.team.repository.db.schemaPrefix est ajouté au préfixe du propriétaire, accompagné d'un caractère de soulignement. Par exemple, CREATOR sera changé en X1_REPOSITORY dans une base de données quelconque lorsque com.ibm.team.repository.db.schemaPrefix=X1. Assure une référence unique utilisant CREATOR et le nom TABLE.

Mettez à jour les fichiers teamserver.properties afin qu'ils se réfèrent à l'entrepôt de données sous DB2 z/OS.

Plus précisément, éditez les lignes suivantes :
  1. Mettez en commentaire les propriétés suivantes associées à la configuration de l'entrepôt de données Derby (il se peut que la troisième propriété ne soit pas listée) :
    # com.ibm.team.datawarehouse.db.vendor=DERBY
    # com.ibm.team.datawarehouse.db.jdbc.location=conf/jts/derby/warehouseDB
    # com.ibm.team.datawarehouse.db.net.port=1527
  2. Annulez la mise en commentaire des propriétés suivantes et mettez-les à jour comme pour le référentiel.
    #com.ibm.team.datawarehouse.db.vendor = db2z
    #com.ibm.team.datawarehouse.db.jdbc.location=//ipAddress:ipPort/location:user=jazzDBuser;password={password};
    #com.ibm.team.datawarehouse.db.jdbc.password=jazzDBpswd
    # Utilisateur de base de données auquel les autorisations appropriées seront octroyées
    #com.ibm.team.datawarehouse.report.user = RPTUSER
    #com.ibm.team.datawarehouse.db.db2.dsn.dbname=RIDW
    #com.ibm.team.datawarehouse.db.schemaPrefix=DWPREF
    Vous devez ajouter la propriété suivante pour indiquer le préfixe de votre choix pour les tables de l'entrepôt de données :
    com.ibm.team.datawarehouse.db.schemaPrefix=DWPREF 
  3. Dans com.ibm.team.datawarehouse.report.user = RPTUSER, entrez l'utilisateur de rapport auquel les droits appropriés doivent être accordés. La valeur par défaut est RPTUSER.
    Remarque : Si vous utilisez l'assistant de configuration, une autorisation adéquate sera octroyée à l'utilisateur de rapports. Si vous souhaitez octroyer ces droits manuellement, cet utilisateur doit pouvoir émettre une instruction SELECT sur la base de données pour visualiser un rapport.
    Spécifiquement, lorsque vous exécutez les outils de référentiel –createWarehouse ou initialisez l'entrepôt de données à l'aide de l'assistant de configuration, RPTUSER se voit attribuer l'autorisation de sélectionner dans les tables, à l'aide d'instructions telles que :
        GRANT SELECT ON RIDW.VW_RQST_HISTORY TO $REP_USER;
Enfin, remplacez toutes les instances de @workPath@ par le chemin d'accès que vous avez sélectionné @workPath@, si ce n'est déjà fait. Le remplacement de @workPath@ devrait avoir eu lieu lorsque vous avez effectué les travaux BLZCP*. Exemples de propriété :
  • com.ibm.team.fulltext.indexLocation=@workPath@/workitemindex
  • com.ibm.team.repository.tmpdir=@workPath@/contentservice
  • com.ibm.team.scm.tmpdir=@workPath@/contentservice
  • com.ibm.team.scm.vcs.tmpdir=@workPath@/versionedcontentservice

Conseil : La base de données Jazz contient des colonnes d'objets LOB dans ses tables. Les colonnes LOB sont associées à un pool de mémoire tampon créé par DB2 lors de la création de la table. Le pool de mémoire tampon par défaut d'un espace table LOB est défini dans zparm TBSBPLOB. Vous pouvez spécifier un pool de mémoire tampon de 16 ko si vous ne voulez pas de pages de 8 ko. Pour plus d'informations, voir "Alternatives in defining LOBs" dans le manuel IBM® Redbook LOBs with DB2 for z/OS: Stronger and Faster disponible à l'adresse http://www.redbooks.ibm.com/redbooks/pdfs/sg247270.pdf.

Commentaires