Eigenschaftendateien von Jazz Team Server und der Rational-Lösung für Collaborative Lifecycle Management an DB2 für z/OS anpassen

Dieser Abschnitt beschreibt, wie die Dateien teamserver.properties bearbeitet und konfiguriert werden müssen, damit der Server unter z/OS eine Verbindung zu DB2 herstellen kann. Jazz Team Server (JTS) und die anderen Anwendungen der Rational-Lösung für Collaborative Lifecycle Management (CLM) verfügen jeweils über eine Datei teamserver.properties, in der Servereigenschaften gespeichert sind.

Informationen zu diesem Vorgang

Suchen Sie das Konfigurationsverzeichnis der einzelnen Anwendungen:
  • Jazz Team Server (JTS) - @confPath@/jts
  • Change and Configuration Management (CCM) - @confPath@/ccm
  • Quality Management (QM) - @confPath@/qm
  • Requirements Management (RM) - Verwendet die Datenbankverbindungsdaten in der Datei Jazz Team Server teamserver.properties, sodass Sie diesen Schritt für die Anwendung RM nicht wiederholen müssen.

Unter z/OS gibt @confPath@ den Pfad an, der beim Anpassen des Servers mit den BLZCP*-Beispieljobs verwendet wurde, z. B. /etc/jazz40. Auf Nicht-z/OS-Systemen gibt @confPath@ den Installationspfad für das Konfigurationsverzeichnis an, z. B. /opt/IBM/JazzTeamServer/server/conf unter Linux.

Standardmäßig sind die Dateien teamserver.properties in diesen Verzeichnissen für die Verwendung eines Derby-Repositorys und eines Derby-Data-Warehouse für Berichte konfiguriert. Bearbeiten Sie jede der Dateien teamserver.properties gemäß den Anweisungen in diesem Abschnitt für die Verwendung von DB2 unter z/OS.

Verwenden Sie den Befehl -DIS DDF für Ihr DB2-für-z/OS-Subsystem, um einige Werte anzuzeigen, die Sie bereitstellen müssen. Beispielsweise können Sie die Werte location, ipaddr und port (tcpport) aus der folgenden Anzeige entnehmen:
-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                   
Modifizieren Sie jede der Dateien teamserver.properties so, dass sie zu der in vorherigen Schritten erstellten Datenbankkonfiguration und zu Ihrer DB2-Konfiguration für z/OS passt. Bearbeiten Sie die folgenden Eigenschaften entsprechend Ihrer Konfiguration:
  • ipAddress
  • ipPort
  • location
  • user
  • password
  • dbname
  • schemaprefix
Hinweise:
  • Es kann bis zu vier Repositorys geben, eines für JTS, eines für jede installierte Komponente mit eigener Datenbank (CCM und QM) und eines für das Data Warehouse.
  • Für jedes dieser Repositorys muss es einen eindeutigen Datenbanknamen und ein eindeutiges Schemapräfix geben (sofern sie sich in demselben DB2-z/OS-Subsystem befinden).
  • Jede Eigenschaftendatei zeigt auf dieselbe Data-Warehouse-Konfiguration.

Wenn Sie den Server oder die Anwendung für die Verwendung von DB2 für z/OS konfigurieren möchte, bearbeiten Sie jede der Dateien teamserver.properties im Konfigurationsverzeichnis für Jazz Team Server oder für die anderen installierten CLM-Anwendungen. Suchen Sie beispielsweise in den Dateien @confPath@/jts/teamserver.properties und @confPath@/ccm/teamserver.properties die folgenden Zeilen. Beispiel für CCM:

# JDBC-Position der Repository-Datenbank. Bei Angabe dieser Eigenschaft ist die
# systembasierte Auswahl der Standardposition inaktiviert.
# JEDE ANWENDUNGSINSTANZ UND DER JAZZ TEAM SERVER ERFORDERN
# JEWEILS EINE EIGENE EINDEUTIGE DATENBANK.
com.ibm.team.repository.db.vendor = DERBY 
com.ibm.team.repository.db.jdbc.location=conf/ccm/derby/repositoryDB

# JDBC-Position des Data Warehouse. Bei Angabe dieser Eigenschaft ist die
# systembasierte Auswahl der Standardposition inaktiviert.
com.ibm.team.datawarehouse.db.vendor=derby_net
com.ibm.team.datawarehouse.db.jdbc.location=//localhost:1527/conf/jts/derby/warehouseDB 
Fügen Sie in der ersten Spalte das Zeichen # hinzu, um die beiden Eigenschaften com.ibm.team.repository und com.ibm.team.datawarehouse wie nachfolgend gezeigt auf Kommentar zu setzen:
# JDBC-Position der Repository-Datenbank. Bei Angabe dieser Eigenschaft ist die
# systembasierte Auswahl der Standardposition inaktiviert.
# JEDE ANWENDUNGSINSTANZ UND DER JAZZ TEAM SERVER ERFORDERN JEWEILS EINE EIGENE EINDEUTIGE DATENBANK.
#com.ibm.team.repository.db.vendor = DERBY
#com.ibm.team.repository.db.jdbc.location=conf/ccm/derby/repositoryDB

# JDBC-Position des Data Warehouse. Bei Angabe dieser Eigenschaft ist die
# systembasierte Auswahl der Standardposition inaktiviert.
#com.ibm.team.datawarehouse.db.vendor=derby_net
#com.ibm.team.datawarehouse.db.jdbc.location=//localhost:1527/conf/jts/derby/warehouseDB
Entfernen Sie das Kommentarzeichen für die im Beispiel gezeigten Zeilen. Passen Sie die Zeilen an die in vorherigen Schritten erstellte Datenbankkonfiguration und an Ihre DB2-Konfiguration an.

Passen Sie die Eigenschaften location, user, password und dbname an Ihre Konfiguration an.

Bearbeiten Sie insbesondere die folgenden Zeilen in jeder Datei teamserver.properties für dieses Repository:
  1. Stellen Sie sicher, dass die folgende Zeile nicht auf Kommentar gesetzt ist:
    com.ibm.team.repository.db.vendor = db2z
  2. Ersetzen Sie in der Zeile
    com.ibm.team.repository.db.jdbc.location=//ipAddress:ipPort/
    location:user=jazzDBuser;password={password};
    die Einträge
    • ipAddress durch Ihre IP-Adresse,
    • ipPort durch Ihren TCP-Port,
    • location durch den im DDF-Bericht unter LOCATION aufgelisteten Wert,
    • jazzDBuser durch die Benutzer-ID, die Sie erstellt haben und die über die erforderliche Zugriffsberechtigung auf die DB2-Datenbank verfügt.
      Anmerkung: Die Angabe password={password} dürfen Sie nicht ändern.
  3. Ersetzen Sie in der Zeile
    com.ibm.team.repository.db.jdbc.password=jazzDBpswd
    den Eintrag jazzDBpswd durch das Kennwort für Ihren DB2-z/OS-Benutzer.
  4. Ersetzen Sie in der Zeile
    com.ibm.team.repository.db.db2.dsn.dbname=JAZZDB
    den Eintrag JAZZDB durch den Namen der Datenbank, die Sie für diese Komponente erstellt haben.
  5. Entfernen Sie in der folgenden Zeile das Kommentarzeichen #:
    #com.ibm.team.repository.db.schemaPrefix=xx
    Ersetzen Sie xx durch ein eindeutiges Präfix für jede Datenbank in demselben DB2-z/OS-Subsystem.
    Anmerkung: Zum Erstellen mehrerer Jazz-Datenbanken in demselben DB2-Subsystem müssen unterschiedliche Tabelleneigner für die Jazz-Tabellen angegeben werden. Dazu verwendet Jazz Team Server die Anweisung com.ibm.team.repository.db.schemaPrefix, um den Jazz-DB2-Objekten ein Präfix hinzuzufügen, sodass sie innerhalb eines DB2-Subsystems eindeutig sind. Das in com.ibm.team.repository.db.schemaPrefix festgelegte Präfix wird zusammen mit einem Unterstreichungszeichen zum Eignerpräfix hinzugefügt. Wenn beispielsweise com.ibm.team.repository.db.schemaPrefix=X1 gesetzt ist, wird CREATOR in einer gegebenen Datenbank in X1_REPOSITORY geändert. Stellen Sie sicher, dass die Referenzierung mit den Namen für CREATOR und TABLE eindeutig ist.

Aktualisieren Sie die Dateien teamserver.properties mit Verweisen auf das Data Warehouse in DB2 z/OS.

Bearbeiten Sie insbesondere die folgenden Zeilen:
  1. Setzen Sie die folgenden Eigenschaften für die Derby-Data-Warehouse-Konfiguration auf Kommentar. (Möglicherweise ist die dritte Eigenschaft nicht aufgelistet.)
    # 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. Entfernen Sie das Kommentarzeichen vor den folgenden Eigenschaften und aktualisieren Sie das Data Warehouse ähnlich wie das Repository.
    #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
    # Datenbankbenutzer, dem die entsprechenden Berechtigungen eingeräumt werden.
    #com.ibm.team.datawarehouse.report.user = RPTUSER
    #com.ibm.team.datawarehouse.db.db2.dsn.dbname=RIDW
    #com.ibm.team.datawarehouse.db.schemaPrefix=DWPREF
    Sie müssen die folgende Eigenschaft hinzufügen, um für die Data-Warehouse-Tabellen ein Präfix Ihrer Wahl anzugeben:
    com.ibm.team.datawarehouse.db.schemaPrefix=DWPREF 
  3. Geben Sie in com.ibm.team.datawarehouse.report.user = RPTUSER den Berichtsbenutzer ein, dem die entsprechende Berechtigung erteilt werden soll. Die Standardeinstellung ist RPTUSER.
    Anmerkung: Wenn Sie den Setup-Assistenten verwenden, wird dem Berichtsbenutzer die erforderliche Berechtigung gewährt. Falls Sie Berechtigungen manuell erteilen möchten, muss dieser Benutzer in der Lage sein, in der Datenbank die für die Anzeige eines Berichts erforderlichen SELECT-Operationen auszuführen.
    Wenn Sie den Repository-Tools-Befehl –createWarehouse ausführen oder das Data Warehouse mit dem Setup-Assistenten initialisieren, wird dem Benutzer RPTUSER mit Anweisungen wie der folgenden die Auswahlberechtigung für die Tabellen gewährt:
        GRANT SELECT ON RIDW.VW_RQST_HISTORY TO $REP_USER;
Ersetzen Sie schließlich alle Vorkommen von @workPath@ durch den Pfad, den Sie als @workPath@ (Arbeitspfad) ausgewählt haben, sofern diese Vorkommen noch nicht modifiziert wurden. Die Ersetzung von @workPath@ sollten Sie bereits bei der Ausführung der Jobs BLZCP* vorgenommen haben. Nehmen Sie die Anpassung beispielsweise für folgende Eigenschaften vor:
  • 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

Tipp: Die Jazz-Datenbank enthält LOB-Spalten (Large Object, großes Objekt) in ihren Tabellen. Den LOB-Spalten ist ein Pufferpool zugeordnet, der von DB2 während der Tabellenerstellung erstellt wurde. Der Standardpufferpool für einen LOB-Tabellenbereich wird in zparm TBSBPLOB definiert. Sie können den Wert auf einen 16-KB-Pufferpool setzen, wenn Sie keine 8-KB-Seitengröße wünschen. Weitere Informationen hierzu finden Sie im Abschnitt "Alternatives in defining LOBs" im IBM® Redbook LOBs with DB2 for z/OS: Stronger and Faster auf der Website http://www.redbooks.ibm.com/redbooks/pdfs/sg247270.pdf.

Feedback