RTCz: Configuração de um Banco de Dados do Servidor SQL

Configure um banco de dados do Servidor SQL para funcionar com o Jazz Team Server para System z.

Este procedimento assume que os seguintes pré-requisitos foram atendidos:

Lembre-se: O nome de login padrão definido no arquivo JazzInstallDir/server/teamserver.properties para um banco de dados do Servidor SQL é jazzDBuser e a senha padrão é jazzDBpswd. Esses valores são utilizados nas etapas abaixo para criar um banco de dados. É possível substituir esses valores pelo nome do usuário e senha para o seu banco de dados.

Configurando um Banco de Dados

Esta seção descreve como configurar o banco de dados do Servidor SQL utilizando a ferramenta de linha de comandos sqlcmd, fornecida com a instalação do Servidor SQL. Também é possível usar uma ferramenta visual, como o SQL Server Studio Management, que também está disponível para a versão do Express como SQL Server Studio Management Express. Consulte a documentação do Servidor SQL ou um database administrator (DBA) do Servidor SQL, para obter informações adicionais.

Para configurar um banco de dados do Servidor SQL utilizando a ferramenta de comando sqlcmd:

  1. Crie um banco de dados do Jazz Team Server para System z. A partir da ferramenta de linha de comandos, digite:
    CREATE DATABASE jazz 
    IR 
  2. Crie um usuário e senha e altere a propriedade do banco de dados do Jazz Team Server para System z. A partir da ferramenta de linha de comandos, digite:
    CREATE LOGIN jazzDBuser
    WITH PASSWORD = 'jazzDBpswd';
    USE jazz;
    exec sp_changedbowner 'jazzDBuser'
    IR 
  3. Altere a intercalação do banco de dados do Jazz Team Server para System z. A partir da ferramenta de linha de comandos, digite:
    ALTER DATABASE jazz COLLATE SQL_Latin1_General_CP437_CS_AS 
    IR

Configurando o Servidor

Lembre-se: Pelo padrão, o arquivo teamserver.properties no diretório JazzInstallDir/server/conf/jazz não está configurado para se conectar a um banco de dados do Servidor SQL. Todas as configurações padrão, junto com configurações específicas do Servidor SQL, estão contidas no arquivo teamserver.sqlserver.properties no mesmo diretório.

Para configurar o servidor:

  1. Renomeie os seguintes arquivos:
    • Renomeie o arquivo JazzInstallDir/server/conf/jazz/teamserver.properties para teamserver.OtherDBProvider.properties
    • Renomeie o arquivo teamserver.sqlserver.properties para teamserver.properties
    Dica: Renomear o arquivo original teamserver.properties possibilita restaurar o arquivo para a versão de trabalho anterior. Por padrão, o Provedor do BD é derby.
  2. Edite o arquivo de configuração do servidor se tiver usado um nome de usuário, senha ou nome de BD diferente, instalado o Servidor SQL em uma máquina diferente do Jazz Team Server para System z, ou estiver usando uma porta diferente do padrão. Abra o arquivo teamserver.properties no diretório JazzInstallDir/server/conf/jazz, e altere as informações listadas abaixo para que correspondam à sua configuração.
    com.ibm.team.repository.db.vendor = SQLSERVER
    com.ibm.team.repository.db.jdbc.location=//SQL SERVER MACHINE IP:SQL SERVER TCIP PORT;databaseName=JAZZ DATABASE NAME;user=JAZZ USERNAME;password={password}
    com.ibm.team.repository.db.jdbc.password=JAZZ LOGIN PASSWORD
    Importante: Não altere o texto password={password} no repositório com.ibm.team.repository.db.jdbc.location. A senha de usuário deve ser especificada na propriedade com.ibm.team.repository.db.jdbc.password.
Para especificar o local do arquivo JAR para JDBC:
  1. No mesmo diretório dos scripts de servidor (JazzInstallDir/server), crie um diretório chamado sqlserver.
  2. Localize o arquivo JAR do driver JDBC do Servidor SQL, denominado sqljdbc.jar. O local pode variar, dependendo de onde os drivers foram instalados, conforme indicado na seção de pré-requisitos. Copie o arquivo no diretório sqlserver recém-criado.
  3. Especifique o local do arquivo JAR do JDBC para JDBC executando a seguinte tarefa:
    • Configure a variável de ambiente SQLSERVER_ABSPATH para apontar para o diretório que contém o arquivo JAR. Se o caminho contiver caracteres de espaço, você deve incluí-los com aspas.
      Dica: Se você utilizar o WebSphere Application Server, configure uma propriedade denominada SQLSERVER_JDBC; em seguida, configure-a como o caminho absoluto do arquivo (não a URL) para o diretório de drivers JDBC do Servidor SQL. Para obter informações adicionais, consulte as instruções de configuração do WebSphere Application Server. Anote o caminho de arquivo para uso posterior nessas instruções.

Você concluiu a configuração do seu banco de dados. Agora, crie as tabelas de banco de dados do Jazz Team Server para System z. Para obter informações adicionais, consulte Criação das Tabelas de Banco de Dados do Jazz Team Server para System z no DB2 e Oracle.

Resolução de Problemas

Se o comando repotools não for bem-sucedido, verifique o arquivo de log denominado repotools_createTables.log, localizado no diretório JazzInstallDir/server.

Além disso, verifique o seguinte:

Nota: O código do banco de dados para o Jazz Team Server para System z foi projetado para ser genérico e padrão a fim de ser executado em várias plataformas de bancos de dados; entretanto, diferenças entre os fornecedores de bancos de dados corporativos existem na sintaxe, nas estratégias de otimização e na semântica de bloqueio. O servidor foi testado no Servidor SQL utilizando uma combinação de testes automatizados e simulações de cargas de trabalho normais e testes de estresse. A simulação de cargas de trabalho normais mostrou um desempenho aceitável. Em algumas instâncias foram observados conflitos de banco de dados em testes de simultaneidade automatizados; no entanto, estes não foram reproduzidos consistentemente no hardware do servidor diferente.

O servidor é projetado para prestar serviço a um grande número de pedidos simultâneos. Em casos excepcionais, conflitos podem ocorrer no banco de dados do repositório, já que objetos semelhantes ou iguais são atualizados simultaneamente em transações associadas aos pedidos. Estes são eventos raros, mas normais. O sistema é projetado para ser defensivo em relação a isto e a integridade de dados é mantida; não há nenhuma perda de dados. Ocasionalmente, conflitos são registrados por tarefas, como a execução do mecanismo de construção. Normalmente, a condição é detectada, e a tarefa é tentada novamente. O conflito pode resultar em uma construção com falha. Em casos muito raros, ela pode ser uma ação do usuário, como trabalhar com itens de trabalho ou código-fonte, que é interrompida para resolver um conflito. Nesse caso, a ação do usuário falha e um erro com detalhes relativos a um conflito é exibido para o usuário. O usuário pode então tentar novamente a ação.

Todos os conflitos encontrados são registrados no servidor para fornecer informações sobre o que aconteceu quando o conflito ocorreu. A entrada de log possui texto semelhante ao seguinte: com.ibm.team.repository.common.RetryableDatabaseException: Falha de serialização.

Se o seu sistema encontrar conflitos, consulte o log de erros, que está disponível no endereço https://servername:9443/jazz/service/com.ibm.team.repository.common.internal.IFeedService?category=SystemLog.

Se você encontrar exceções de conflito freqüentes, entre em contato com o seu suporte ao produto ou verifique os fóruns no jazz.net para obter as informações, atualizações ou técnicas mitigantes mais recentes.


Feedback

Isto ajudou? Você pode fornecer feedback em Jazz.net (registro necessário): Comment in the forums ou submit a bug