Configurando um Banco de Dados do SQL Server

Este tópico descreve como configurar um banco de dados do SQL Server para trabalhar com o IBM® Rational Quality Manager.

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

Nota: O nome de login padrão definido no arquivo RQM_install_dir/server/conf/jazz/teamserver.properties para um banco de dados do SQL Server é jazzDBuser e a senha padrão é jazzDBPswd. Esses valores são utilizados nas etapas abaixo para criar um banco de dados. Você pode substituir esses valores pelo nome de usuário e senha de seu banco de dados.

Configurando um Banco de Dados

Nota: Esta seção descreve como configurar o banco de dados do SQL Server utilizando a ferramenta de linha de comandos sqlcmd, que é fornecida pela instalação do SQL Server. Também é possível utilizar 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 SQL Server ou um administrador de banco de dados do SQL Server (DBA) para obter informações adicionais.

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

  1. Crie um banco de dados do Rational Jazz Team Server. Na ferramenta de linha de comandos, digite:
    CREATE DATABASE jazz 
    GO 
  2. Crie um usuário e senha e altere a propriedade do banco de dados do Rational Jazz Team Server. Na ferramenta de linha de comandos, digite:
    CREATE LOGIN jazzDBuser
    WITH PASSWORD = 'jazzDBPswd';
    USE jazz;
    exec sp_changedbowner 'jazzDBuser'
    GO 
  3. Altere a ordenação do banco de dados do Rational Jazz Team Server. Na ferramenta de linha de comandos, digite:
    ALTER DATABASE jazz COLLATE SQL_Latin1_General_CP437_CS_AS 
    GO

Configurando o Servidor

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

Para configurar o servidor:

  1. Faça uma cópia de backup do arquivo teamserver.properties antes de fazer as edições conforme descrito na próxima etapa.
    Nota: Fazer o backup do arquivo teamserver.properties original permite restaurar o arquivo para a versão de trabalho anterior. Por padrão, o Provedor do DB é derby.
  2. Edite o arquivo teamserver.properties incluindo caracteres # no início de cada linha da seção mostrada abaixo:
    #
    # DERBY Configuration
    #
    # Local do DB JDBC, especificar essa propriedade desativa a seleção do local padrão baseada no sistema
    #com.ibm.team.repository.db.vendor=DERBY
    #com.ibm.team.repository.db.jdbc.location=repositoryDB
  3. Edite a seguinte seção no arquivo teamserver.properties e altere as informações listadas abaixo para corresponderem à 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
  4. Crie um diretório denominado InstallDir/server/sqlserver e copie o arquivo JAR dos drivers JDBC sqljdbc.jar para esse diretório. Consulte http://msdn2.microsoft.com/en-us/data/aa937724.aspx para obter informações adicionais.
  5. Abra o server.startup.bat no diretório InstallDir/server, navegue até a linha set SQLSERVER_JDBC=%START_DIR%\sqlserver e modifique a seção de forma que sua aparência fique como a mostrada abaixo:
    set JAVA_PTS=-Djava.awt.headless=true - 
    DSQLSERVER_JDBC="%SQLSERVER_JDBC%" -
    DORACLE_JDBC=%ORACLE_JDBC%" - DDB21_JDBC="%DB21_JDBC%" -
    DDB2Z_JDBC="%DB2Z_JDBC%" -
    Dorg.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin=true -
    Dcom.ibm.team.repository.provision.profile="%cd%"\provision_profiles -
    Dcom.ibm.team.repository.tempDir=%TEMP% -Dcom.ibm.rqm.create.samples=false -
    Xss512k -Xmx700M

Você concluiu a configuração de seu banco de dados. Agora, crie as tabelas de banco de dados do Rational Jazz Team Server. Para obter informações adicionais, consulte Criando Tabelas de Banco de Dados do Servidor Jazz.

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 InstallDir/server.

Além disso, verifique o seguinte:

O código do banco de dados para o Rational Jazz Team Server foi designado para ser genérico e padrão a fim de ser executado em várias plataformas de banco de dados; no entanto, existem diferenças de sintaxe, estratégias de otimização e semântica de bloqueio entre os fornecedores de banco de dados corporativos. O servidor foi testado no SQL Server utilizando uma combinação de testes automatizados e simulações de cargas de trabalho normais e teste de carga. A simulação de cargas de trabalho normais mostrou desempenho aceitável. Em alguns casos, foram observados conflitos de banco de banco de dados em testes de simultaneidade automatizados; no entanto, eles não foram reproduzidos consistentemente em hardware de servidor diferente.

O servidor foi projetado para serviço em um grande número de pedidos simultâneos. Em casos excepcionais, podem ocorrer conflitos no banco de dados do repositório, como objetos similares ou iguais serem atualizados simultaneamente em transações associadas aos pedidos. Esses eventos são raros, mas normais. O sistema foi projetado para ser defensivo contra isso e a integridade de dados é mantida, não há perda de dados. Ocasionalmente, os conflitos são registrados por tarefas, como execução do mecanismo de build. Geralmente, a condição é detectada e a tarefa repetida. O conflito pode resultar em um build com falha. Em casos muito raros, pode ser uma ação do usuário, como trabalhar com itens de trabalho ou código de origem, que é interrompida para resolver um conflito. Nesse caso, a ação do usuário falha e um erro com detalhes relacionados a um conflito é exibido ao usuário. O usuário pode então repetir a ação.

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

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

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


Feedback