Personnalisation des fichiers de propriétés Jazz Team Server for System z pour DB2 for z/OS

Cette section décrit comment éditer et configurer le fichier teamserver.properties pour que z/OS puisse se connecter à DB2.

Pourquoi et quand exécuter cette tâche
Recherchez le répertoire de configuration dans @confPath@/jazz. Par défaut, le fichier teamserver.properties de ce répertoire est configuré pour utiliser une base de données Derby.
  1. Renommez le fichier teamserver.properties en teamserver_derby.properties.
  2. Renommez le fichier teamserver_db2z.properties en teamserver.properties.
  3. Finissez d'éditer le fichier teamserver.properties 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.rtp.raleigh.ibm.com              
 DSNL086I RESYNC DOMAIN=RALNS32.rtp.raleigh.ibm.com              
 DSNL099I DSNLTDDF DISPLAY DDF REPORT COMPLETE                   
Pour configurer le serveur, éditez le fichier @confPath@/jazz/teamserver.properties et recherchez les lignes suivantes :
com.ibm.team.repository.db.vendor = db2z
com.ibm.team.repository.db.jdbc.location=//ipAddress:ipPort
/location:user=jazzDBuser;password={password};
com.ibm.team.repository.db.jdbc.password=jazzDBpswd
com.ibm.team.repository.db.db2.dsn.dbname=JAZZDB
#com.ibm.team.repository.db.schemaPrefix=xx
Editez ces lignes en fonction de la configuration de base de données que vous avez créée dans les étapes précédentes et de votre configuration DB2. Editez les propriétés location, user, password et dbname en fonction de votre configuration.
Plus précisément, éditez les éléments suivants :
  1. 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}.
  2. Dans la ligne suivante :
    com.ibm.team.repository.db.jdbc.password=jazzDBpswd
    remplacez jazzDBpswd par le mot de passe de votre utilisateur DB2.
  3. Dans la ligne suivante :
    com.ibm.team.repository.db.db2.dsn.dbname=JAZZDB
    remplacez JAZZDB par le nom de la base de données que vous avez créée.
  4. Dans la ligne suivante :
    #com.ibm.team.repository.db.schemaPrefix=xx
    vous pouvez supprimer le # et remplacer xx par un préfixe de votre choix. Cette opération est facultative. Cela permet d'avoir plusieurs référentiels Jazz dans un même sous-système DB2.
    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 cela, Jazz Team Server for System z utilise l'instruction com.ibm.team.repository.db.schemaPrefix pour ajouter un préfixe aux objets DB2 Jazz afin qu'ils deviennent uniques dans un sous-système DB2. Le préfixe défini dans com.ibm.team.repository.db.schemaPrefix est ajouté au propriétaire avec un trait de soulignement. Par exemple, la table WORKITEMS_SNAPSHOT.WORKITEM_CHNGS sera créée sous le nom X1_WORKITEMS_SNAPSHOT.WORKITEM_CHNGS, dans une base de données donnée si com.ibm.team.repository.db.schemaPrefix=X1.
En outre, remplacez toutes les instances de @workPath@ par le chemin d'accès que vous avez sélectionné pour @workPath@ ; par exemple, les propriétés suivantes :
  • 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
Remarque : Jazz Team Server for System z crée ces répertoires.
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 8 ko si vous ne voulez pas de pages de 4 ko. Pour plus d'informations, voir"Alternatives in defining LOBs" dans le IBM® Redbook LOBs with DB2 for z/OS: Stronger and Faster disponible à l'adresse http://www.redbooks.ibm.com/redbooks/pdfs/sg247270.pdf.