Personalización de los archivos de propiedades de Jazz Team Server y de la solución de Rational para Collaborative Lifecycle Management para DB2 en z/OS

En este apartado se describe cómo editar y configurar los archivos teamserver.properties para que el servidor en z/OS pueda conectarse a DB2. La Jazz Team Server (JTS) y la otra solución Rational para las aplicaciones de Collaborative Lifecycle Management (CLM) tienen cada una archivos teamserver.properties que contienen propiedades de servidor.

Acerca de esta tarea

Ubique los directorios de configuración para las aplicaciones:
  • Jazz Team Server (JTS) - @confPath@/jts
  • Gestión de cambios y configuración (CCM) - @confPath@/ccm
  • Gestión de calidad (QM) - @confPath@/qm
  • Gestión de requisitos (RM) - utiliza la información de conexión de base de datos en Jazz Team Server teamserver.properties, así no tiene que repetir este paso para la aplicación RM.

En z/OS, @confPath@ es el valor de vía de acceso que se utiliza a la hora de personalizar el servidor mediante trabajos de ejemplo BLZCP* como, por ejemplo, /etc/jazz40. En sistemas distintos de z/OS, @confPath@ es la vía de instalación para el directorio de configuración como, por ejemplo, /opt/IBM/JazzTeamServer/server/conf enLinux.

De forma predeterminada, los archivos teamserver.properties en estos directorios están configurados para utilizar un repositorio Derby y un almacén de datos para el informe. Edite cada archivo teamserver.properties para utilizar DB2 para z/OS según las instrucciones incluidas en este tema.

Utilice el mandato -DIS DDF para que el subsistema DB2 for z/OS muestre algunos de los valores que necesita proporcionar. Por ejemplo, puede recuperar la ubicación, dirección IP y el puerto (tcpport) desde la siguiente pantalla:
-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                   
Modifique cada archivo teamserver.properties para que se ajuste a la configuración de bases de datos que ha creado en los pasos anteriores y también a la configuración de DB2 z/OS. Modifique las siguientes propiedades según la configuración que haya establecido:
  • ipAddress,
  • ipPort
  • ubicación
  • usuario
  • contraseña
  • dbname
  • schemaprefix
Notas:
  • Puede haber hasta cuatro repositorios: un repositorio para JTS, un repositorio para cada componente instalado que tenga una base de datos (CCM y QM), y un repositorio para el almacén de datos.
  • Cada uno de estos repositorios debe tener un nombre de base de datos exclusivo y un prefijo de esquema (si están en un subsistema de DB2 z/OS único).
  • Cada archivo de propiedades apuntará a la misma configuración de almacén de datos.

Para configurar el servidor o la aplicación para utilizar DB2 for z/OS, edite los archivos teamserver.properties en los directorios de configuración para Jazz Team Server u otra aplicación CLM instalada. Por ejemplo, los archivos @confPath@/jts/teamserver.properties y @confPath@/ccm/teamserver.properties y ubique las siguientes líneas. Este ejemplo es para 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 
Añada un # en la columna uno para comentar las siguientes propiedades de com.ibm.team.repository y com.ibm.team.datawarehouse del siguiente modo:
# 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
Anule las líneas mostradas en los ejemplos y edítelas para que coincidan con la configuración de base de datos que creó en los pasos anteriores y también para que coincidan con la configuración de DB2 .

Edite las propiedades location, user, password y dbname en función de la configuración.

Específicamente, edite las líneas siguientes en cada uno de los archivos teamserver.properties para ese repositorio:
  1. Asegúrese de que está línea está sin comentar:
    com.ibm.team.repository.db.vendor = db2z
  2. En esta línea:
    com.ibm.team.repository.db.jdbc.location=//ipAddress:ipPort/
    location:user=jazzDBuser;password={password};
    sustituya:
    • ipAddress con su dirección IP.
    • ipPort con su tcpport.
    • location con el valor incluido en el informe DDF en LOCATION.
    • jazzDBuser con el ID de usuario que haya creado, que tiene permiso para acceder a la base de datos DB2.
      Nota: No modifique password={password}.
  3. En esta línea:
    com.ibm.team.repository.db.jdbc.password=jazzDBpswd
    sustituya jazzDBpswd con la contraseña para el usuario de DB2 z/OS .
  4. En esta línea:
    com.ibm.team.repository.db.db2.dsn.dbname=JAZZDB
    sustituya JAZZDB por el nombre de base de datos que creó para este componente.
  5. En esta línea:
    #com.ibm.team.repository.db.schemaPrefix=xx
    debe eliminar el símbolo # y sustituir xx por un prefijo exclusivo para cada base de datos del mismo subsistema DB2 z/OS .
    Nota: Para crear varias bases de datos de Jazz en el mismo subsistema DB2, debe diferenciar los propietarios de las tablas de Jazz. Para ello, Jazz Team Server utiliza la directiva com.ibm.team.repository.db.schemaPrefix para añadir un prefijo a los objetos Jazz DB2 para que sean únicos dentro de un subsistema de DB2. El prefijo definido en com.ibm.team.repository.db.schemaPrefix se añadirá al prefijo propietario junto con guión bajo. Por ejemplo, CREATOR se modificará a X1_REPOSITORY, en una base de datos dada cuando com.ibm.team.repository.db.schemaPrefix=X1. Asegúrese de una referencia exclusiva utilizando el nombre CREATOR y TABLE .

Actualice los archivos teamserver.properties para referencias para el almacén de datos en DB2 z/OS.

Específicamente, edite las líneas siguientes:
  1. Comente las siguientes propiedades relacionadas con la configuración de almacén de datos Derby (es posible que la tercera propiedad no esté listada):
    # 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. Anule el comentario de las siguientes propiedades y haga actualizaciones similares como las del repositorio.
    #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
    # The database user for whom proper permissions will be granted
    #com.ibm.team.datawarehouse.report.user = RPTUSER
    #com.ibm.team.datawarehouse.db.db2.dsn.dbname=RIDW#com.ibm.team.datawarehouse.db.schemaPrefix=DWPREF
    Debe añadir la siguiente propiedad para especificar un prefijo de su elección para las tablas del almacén de datos:
    com.ibm.team.datawarehouse.db.schemaPrefix=DWPREF 
  3. En com.ibm.team.datawarehouse.report.user = RPTUSER, entre el usuario de informe al que se otorgará el permiso adecuado. El valor predeterminado es RPTUSER.
    Nota: Si utiliza el asistente de configuración, se otorgará el permiso adecuado al usuario de informe. Si desea otorgar permisos manualmente, este usuario debe poder realizar SELECCIONES en la base de datos para ver un informe.
    Específicamente, cuando ejecute las herramientas de repositorio –createWarehouse o inicialice el almacén de datos utilizando el asistente de configuración, se le otorgan permisos a RPTUSER para seleccionar desde las tablas, utilizando sentencias como:
        GRANT SELECT ON RIDW.VW_RQST_HISTORY TO $REP_USER;
Por último, sustituya todas las instancias de @workPath@ con la vía de acceso que seleccionó para @workPath@ si no están ya modificadas. Se debe estar hecha la sustitución de@workPath@ cuando se ejecutan los trabajos BLZCP* . Por ejemplo, estas propiedades:
  • 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

Consejo: Esta base de datos Jazz contiene columnas LOB (objeto grande) en sus tablas. Las columnas LOB están asociadas con la agrupación de almacenamiento intermedio que DB2 crea durante la creación de la tabla. La agrupación de almacenamiento intermedio predeterminada para un espacio de tabla se define en zparm TBSBPLOB. Puede establecer el valor en una agrupación de almacenamiento intermedio de 16K si no desea tamaños de página de 8K. Para obtener más información consulte el apartado "Alternatives in defining LOBs" en el IBM® Redbook LOBs with DB2 for z/OS: Stronger and Faster en http://www.redbooks.ibm.com/redbooks/pdfs/sg247270.pdf.

Comentarios