Customizando os Arquivos de Propriedades do Jazz Team Server e da Solução Rational para Collaborative Lifecycle Management para DB2 no z/OS

Esta seção descreve como editar e configurar os arquivos teamserver.properties para que o servidor no z/OS possa estabelecer conexão com o DB2. O Jazz Team Server (JTS) e outros aplicativos Collaborative Lifecycle Management (CLM) da solução Rational possuem cada um arquivos teamserver.properties que contêm propriedades de servidor.

Sobre Esta Tarefa

Localize os diretórios de configuração para cada aplicativo:
  • Jazz Team Server (JTS) - @confPath@/jts
  • Change and Configuration Management (CCM) - @confPath@/ccm
  • Quality Management (QM) - @confPath@/qm
  • Requirements Management (RM) - usa as informações de conexão com o banco de dados no teamserver.properties do Jazz Team Server para que não seja necessário repetir esta etapa para o aplicativo RM.

No z/OS, o @confPath@ é o valor do caminho que foi usado ao customizar o servidor usando as tarefas de amostra BLZCP*, como /etc/jazz40. Em sistemas diferentes do z/OS, @confPath@ é o caminho da instalação do diretório de configuração, como /opt/IBM/JazzTeamServer/server/conf no Linux.

Por padrão, os arquivos teamserver.properties nesses diretórios são configurados para usar um repositório Derby e um armazém de dados para relatório. Edite cada arquivo teamserver.properties para usar o DB2 para z/OS de acordo com as instruções neste tópico.

Use o comando -DIS DDF para seu subsistema DB2 para z/OS para exibir alguns dos valores que precisam ser fornecidos. Por exemplo, é possível recuperar o location, ipaddr e port (tcpport) a partir da seguinte exibição:
-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 arquivo teamserver.properties para correspondência com a configuração do banco de dados criado nas etapas anteriores, e também para corresponder com a configuração do DB2 z/OS. Edite as seguintes propriedades de acordo com sua configuração:
  • ipAddress,
  • ipPort
  • location
  • user
  • Senha
  • dbname
  • schemaprefix
Notas:
  • Pode haver até quatro repositórios: um repositório para o JTS, um repositório para cada componente instalado que tiver um banco de dados (CCM e QM), e um repositório para o armazém de dados.
  • Cada um desses repositórios deve ter um nome de banco de dados e um prefixo de esquema exclusivos (se estiverem em um único subsistema DB2 z/OS).
  • Cada arquivo de propriedades apontará para a mesma configuração de armazém de dados.

Para configurar o servidor ou o aplicativo para usar o DB2 para z/OS, edite cada um dos arquivos teamserver.properties nos diretórios de configuração para o Jazz Team Server ou outro aplicativo CLM instalado. Por exemplo, arquivos @confPath@/jts/teamserver.properties e @confPath@/ccm/teamserver.properties, localize as linhas a seguir. Este exemplo é para o CCM:

# Local do BD do Repositório JDBC, a especificação dessa propriedade desativa 
# a seleção baseada em sistema do local padrão 
# OBSERVE QUE CADA INSTÂNCIA DO APLICATIVO E O JAZZ TEAM SERVER 
# REQUEREM SEU PRÓPRIO BANCO DE DADOS EXCLUSIVO
com.ibm.team.repository.db.vendor = DERBY 
com.ibm.team.repository.db.jdbc.location=conf/ccm/derby/repositoryDB

# Local do BD do Armazém de Dados JDBC, a especificação dessa propriedade desativa 
# a seleção baseada em sistema do local padrão
com.ibm.team.datawarehouse.db.vendor=derby_net
com.ibm.team.datawarehouse.db.jdbc.location=//localhost:1527/conf/jts/derby/warehouseDB 
Inclua um # na coluna um para comentar a linha das propriedades a seguir para as propriedades com.ibm.team.repository e com.ibm.team.datawarehouse, da seguinte forma:
# Local do BD do Repositório JDBC, a especificação dessa propriedade desativa 
# a seleção baseada em sistema do local padrão
# 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

# Local do BD do Armazém de Dados JDBC, a especificação dessa propriedade desativa 
# a seleção baseada em sistema do local padrão
#com.ibm.team.datawarehouse.db.vendor=derby_net
#com.ibm.team.datawarehouse.db.jdbc.location=//localhost:1527/conf/jts/derby/warehouseDB
Remova comentário das linhas mostradas nos exemplos e edite para corresponder à configuração do banco de dados criada nas etapas anteriores e para corresponder também à sua configuração do DB2.

Edite as propriedades location, user, password, e dbname de acordo com sua configuração.

Especificamente, edite as linhas a seguir em cada arquivo teamserver.properties para esse repositório:
  1. Assegure que esta linha não esteja comentada:
    com.ibm.team.repository.db.vendor = db2z
  2. Na linha seguinte:
    com.ibm.team.repository.db.jdbc.location=//ipAddress:ipPort/
    location:user=jazzDBuser;password={password};
    substitua:
    • ipAddress por seu ipaddr.
    • ipPort por seu tcpport.
    • location pelo valor listado no relatório DDF sob LOCATION.
    • jazzDBuser pelo ID de usuário criado, que possui o acesso adequado ao banco de dados DB2.
      Nota: Não modifique password={password}.
  3. Na linha seguinte:
    com.ibm.team.repository.db.jdbc.password=jazzDBpswd
    substitua jazzDBpswd pela senha para seu usuário do DB2 z/OS.
  4. Na linha seguinte:
    com.ibm.team.repository.db.db2.dsn.dbname=JAZZDB
    substitua JAZZDB pelo nome do banco de dados criado para este componente.
  5. Na linha seguinte:
    #com.ibm.team.repository.db.schemaPrefix=xx
    você deve remover o # e substituir xx por um prefixo exclusivo para cada banco de dados no mesmo subsistema DB2 z/OS.
    Nota: Para criar diversos bancos de dados do Jazz no mesmo subsistema DB2, diferencie os proprietários de tabela para tabelas do Jazz. Para fazer isso, o Jazz Team Server usa a diretiva com.ibm.team.repository.db.schemaPrefix para incluir um prefixo para os objetos Jazz DB2 para que sejam exclusivos dentro de um subsistema DB2. O prefixo configurado em com.ibm.team.repository.db.schemaPrefix é incluído no prefixo do proprietário juntamente com um sublinhado. Por exemplo, o CREATOR será modificado para X1_REPOSITORY, em um determinado banco de dados quando com.ibm.team.repository.db.schemaPrefix=X1. Assegure uma referência exclusiva usando o nome de CREATOR e de TABLE.

Atualize os arquivos teamserver.properties para referências ao armazém de dados no DB2 z/OS.

Especificamente, edite as linhas a seguir:
  1. Remova comentário das propriedades a seguir relacionadas à configuração do armazém de dados Derby (a terceira propriedade pode não estar 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. Remova comentário das propriedades a seguir e faça atualizações semelhantes como para o repositório.
    #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
    Você deve incluir a seguinte propriedade para especificar um prefixo de sua escolha para as tabelas do armazém de dados:
    com.ibm.team.datawarehouse.db.schemaPrefix=DWPREF 
  3. Em com.ibm.team.datawarehouse.report.user = RPTUSER, insira o usuário do relatório para o qual a permissão adequada será concedida. O padrão é RPTUSER.
    Nota: Se usar um assistente de configuração, a permissão adequada será concedida ao usuário do relatório. Se quiser conceder permissões manualmente, esse usuário deve ser capaz de executar SELECT no banco de dados para visualizar um relatório.
    Especificamente, ao executar as ferramentas de repositório –createWarehouse ou ao inicializar o armazém de dados usando o assistente de configuração, RPTUSER está tendo permissão concedida para selecionar nas tabelas, usando instruções como:
        GRANT SELECT ON RIDW.VW_RQST_HISTORY TO $REP_USER;
Por fim, substitua todas as instâncias de @workPath@ pelo caminho selecionado para @workPath@ se ainda não estivem modificadas. A substituição de @workPath@ deve ter sido feita quando você executou as tarefas BLZCP*. Por exemplo, essas propriedades:
  • 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

Dica: O banco de dados Jazz contém colunas LOB (objeto grande) em suas tabelas. As colunas LOB estão associadas a um buffer pool que é criado pelo DB2 durante a criação das tabelas. O buffer pool padrão para o espaço de tabela LOB está definido em zparm TBSBPLOB. É possível configurar o valor para um buffer pool de 16K se você não desejar tamanhos de página de 8K. Para obter informações adicionais, consulte "Alternatives in defining LOBs" no IBM® Redbook LOBs with DB2 for z/OS: Stronger and Faster em http://www.redbooks.ibm.com/redbooks/pdfs/sg247270.pdf.

Feedback