Configurando um banco de dados SQL Server para Rational Engineering Lifecycle Manager

Configure um banco de dados SQL Server para trabalhar com o Jazz Team Server, o Rational Engineering Lifecycle Manager e o aplicativo Configuration Management.

Antes de Iniciar

Este procedimento requer que os pré-requisitos a seguir sejam atendidos para o SQL Server:

Nota: Se você estiver usando o SQL Server em um idioma diferente do inglês, deve alterar o idioma para inglês antes de criar o data warehouse:
  1. No SQL Server Management Studio, clique com o botão direito na conexão com o servidor de banco de dados.
  2. Na janela pop-up, selecione Propriedades.
  3. Na janela Propriedades do Servidor, selecione Avançado e configure a entrada Idioma padrão como Inglês.
  4. Salve as alterações.

Procedimento

  1. Crie um banco de dados para cada instância do Jazz Team Server, Rational Engineering Lifecycle Manager e do aplicativo Configuration Management. Crie um banco de dados para o data warehouse associado ao servidor Jazz Team. Por exemplo, se você tiver um Rational Engineering Lifecycle Manager, um aplicativo Configuration Management, um Jazz Team Server e um data warehouse, crie quatro bancos de dados. Use os exemplos a seguir para criar o banco de dados do Jazz Team Server. Para criar os bancos de dados do Rational Engineering Lifecycle Manager e do aplicativo Configuration Management, substitua o jts pelo nome do banco de dados, por exemplo relm e vvc:
    CREATE DATABASE jts 
    IR 
  2. Crie um usuário e senha para cada banco de dados e altere a propriedade de cada banco de dados.
    Execute esses comandos:
    CREATE LOGIN jtsDBuser
    COM SENHA = 'jtsDBpswd';
    USE jts;
    exec sp_changedbowner 'jtsDBuser'
    IR 
  3. Altere a ordenação dos bancos de dados do Jazz Team Server, Rational Engineering Lifecycle Manager e do aplicativo Configuration Management. Na ferramenta de linha de comandos, execute esse comando para o Jazz Team Server. Para os bancos de dados do Rational Engineering Lifecycle Manager e do aplicativo Configuration Management, substitua jts por relm ou vvc.
    ALTER DATABASE jts COLLATE SQL_Latin1_General_CP437_CS_AS 
    IR
  4. Altere o sistema de versão de linha para os bancos de dados do Jazz Team Server, Rational Engineering Lifecycle Manager e do aplicativo Configuration Management. Na ferramenta de linha de comandos, execute esse comando para o Jazz Team Server. Para os bancos de dados do Rational Engineering Lifecycle Manager e do aplicativo Configuration Management, substitua jts por relm ou vvc.
    Nota: Assegure-se de que a conexão com o banco de dados esteja aberta para executar este comando.
    ALTER DATABASE jts SET READ_COMMITTED_SNAPSHOT ON
    IR
  5. Altere a ordenação do banco de dados do armazém de dados. Na linha de comandos, digite:
    ALTER DATABASE dw COLLATE SQL_Latin1_General_CP1_CS_AS
    IR
  6. Crie uma variável de ambiente que é nomeada SQLSERVER_JDBC_DRIVER_FILE e aponte para o driver JDBC sqljdbc4.jar. O local do driver varia dependendo de sua instalação.
    Windows
    1. Clique em Iniciar > Painel de Controle > Sistema.
    2. Clique na guia Avançado e, em seguida, clique em Varáveis de Ambiente.
    3. Na lista Variáveis do Sistema, clique em Novo.
    4. No Nome de Variável insira SQLSERVER_JDBC_DRIVER_FILE e no Valor da Variável insira C:\Path_to_JDBC_driver\sqljdbc4.jar.
    LinuxEm sistemas UNIX, inclua a declaração de variável de ambiente a seguir:
    SQLSERVER_JDBC_DRIVER_FILE =.:Path_to_JDBC_driver/sqljdbc4.jar
    Nota: O Rational Engineering Lifecycle Manager não suporta JRE 5.0. Os JREs suportados são a versão 6.0 e 7.0.

    Se você estiver usando o WebSphere Application Server, também é necessário incluir uma propriedade customizada que aponta para o driver JDBC sqljdbc4.jar. Para obter informações adicionais, consulte Configurando o WebSphere Application Server para Rational Engineering Lifecycle Manager.

  7. Para configurar as conexões com os bancos de dados e criar tabelas de banco de dados, conclua umas dessas etapas:
    1. Se você estiver usando o Tomcat ou se estiver implementando o WebSphere Application Server, inicie o servidor e continue com o Executando o assistente de configuração Jazz Team Server para aplicativos do Rational Engineering Lifecycle Manager.
    2. Se você preferir modificar manualmente o arquivo teamserver.properties para conexão com o banco de dados, execute os comandos repotools para criar tabelas de banco de dados. Para obter mais informações, leia sobre o Configurando Manualmente um Banco de Dados SQL Server.
    3. Se você estiver fazendo upgrade de uma versão anterior, continue a executar os scripts de upgrade apropriados, que migram suas conexões com o banco de dados existentes. Para obter mais informações, leia sobre o upgrade do Rational Engineering Lifecycle Manager.

Configurando Manualmente um Banco de Dados SQL Server

A execução do assistente de configuração é o método recomendado para configurar as conexões com o banco de dados e criar as tabelas de banco de dados. Se você preferir realizar este procedimento manualmente, edite o arquivo teamserver.properties para configurar uma conexão com o banco de dados do SQL Server e executar o comando -createTables para criar tabelas de banco de dados.

Procedimento

  1. Para cada aplicativo, abra e modifique um teamserver.properties separado. Estes arquivos estão em seus próprios diretórios (jts, relm e vvc) no diretório <JazzInstallDir>/server/conf. Abra cada arquivo teamserver.properties e especifique os detalhes de banco de dados e conexão.
    1. Comente as linhas a seguir sob o Derby Configuration colocando um sinal de número (#) antes de cada linha. O exemplo é para o arquivo teamserver.properties JTS:
      #com.ibm.team.repository.db.vendor = DERBY
      # com.ibm.team.repository.db.jdbc.location=conf/jts/derby/repositoryDB
    2. Remova comentário das linhas a seguir sob SQL Server Configuration, removendo o sinal numérico (#) antes de cada linha:
      com.ibm.team.repository.db.vendor = SQLSERVER
      com.ibm.team.repository.db.jdbc.location=//localhost:1433;databaseName=jazz;user=jazzDBuser;password={password}
      com.ibm.team.repository.db.jdbc.password=jazzDBpswd
    3. Edite os valores a seguir nas propriedades com.ibm.team.repository.db.jdbc.location e com.ibm.team.datawarehouse.db.jdbc.location:
      • //localhost:1433: Digite o nome completo do host do servidor de base de dados.
        Nota: Você deve configurar manualmente a porta estática para 1433 usando a ferramenta SQL Server Configuration.
      • jazz: Digite o nome do banco de dados.
      • jazzDBuser: Digite o nome de usuário
      Nota: Não altere o texto password={password} nas propriedades com.ibm.team.repository.db.jdbc.location e com.ibm.team.datawarehouse.db.jdbc.location.
    4. Especifique a senha de usuário nas propriedades com.ibm.team.repository.db.jdbc.password e com.ibm.team.datawarehouse.db.jdbc.password.
    5. Altere o valor da linha com.ibm.team.fulltext.indexLocation=conf/jts/indices/workitemindex para o local do caminho completo do índice do texto integral. Por exemplo, insira com.ibm.team.fulltext.indexLocation=c:/Progra~1/IBM/JazzTeamServer/server/conf/jts/indices/workitemindex.
    6. Altere o valor da linha com.ibm.team.jfs.index.root.directory=indices para o local do caminho completo do diretório raiz do índice Jazz Foundation Service. Por exemplo, insira com.ibm.team.jfs.index.root.directory=c:/Progra~1/IBM/JazzTeamServer/server/conf/jts/indices.
  2. Após cada banco de dados ser criado, é necessário executar um comando repotools para criar tabelas de banco de dados.
    Importante: Execute o comando createTables somente se essa for uma nova instalação.
    Nota: Ao executar o comando repotools, o arquivo teamserver.properties será atualizado e o arquivo original com o conteúdo original será salvo no mesmo diretório. Você pode ver um aviso de que o URI Público não foi configurado. É possível ignorar esse aviso agora, porque o URI Público é configurado ao executar o assistente de configuração do Jazz Team Server para aplicativos Rational Engineering Lifecycle Manager.
    1. Para criar as tabelas de banco de dados para Jazz Team Server, acesse o diretório JazzInstallDir/server e execute este comando:
      repotools-jts -createTables 
    2. Para criar as tabelas de banco de dados para o aplicativo Rational Engineering Lifecycle Manager, acesse o diretório RELMInstallDir/server e execute este comando:
      repotools-relm -createTables
    3. Para criar as tabelas de banco de dados para o aplicativo Configuration Management, acesse o diretório VVCInstallDir/server e execute este comando:
      repotools-vvc -createTables 

Resolução de Problemas

Procedimento

  • Se o comando repotools não funcionar, verifique os arquivos de log apropriados, que estão no diretório JazzInstallDir/server.
  • Verifique se estas condições estão corretas:
    • O SQL Server está configurado para permitir conexões que usam o protocolo TCP/IP. Se necessário, reinicie o serviço da SQL.
    • O nome do host do computador do SQL Server e a porta estão refletidos corretamente nos arquivos teamserver.properties.
    • O nome de login, a senha e o nome do banco de dados estão refletidos corretamente nos arquivos teamserver.properties.
    • Um firewall não evita que você acesse o SQL Server. Use um comando Telnet para se conectar ao servidor. Insira o nome do host e a porta do arquivo teamserver.properties.
    • O usuário criado tem as permissões corretas no banco de dados do Jazz Team Server.
    • As variáveis de ambiente do driver JDBC são configuradas corretamente para seu ambiente.
    Nota: O Jazz Team Server é executado em diversas plataformas de banco de dados; entretanto, as diferenças entre os bancos de dados corporativos existem na sintaxe, nas estratégias de otimização e na semântica de bloqueio. O servidor foi testado no SQL Server usando uma combinação de testes automatizados e simulações de cargas de trabalho normais e teste de estresse. A simulação de cargas de trabalho normais mostrou um desempenho aceitável. Em algumas instâncias, ocorreram conflitos de banco de dados nos testes de simultaneidade automatizados; entretanto, estes erros não foram consistentemente reproduzidos no hardware de servidor diferente.

    O servidor foi designado para manusear um grande número de solicitações simultâneas. Em casos excepcionais, ocorrem conflitos no banco de dados do repositório, já que objetos semelhantes ou iguais são atualizados simultaneamente em transações que estão associadas às solicitações. Estes erros são raros, mas são eventos típicos. O sistema é defensivo contra conflitos e a integridade de dados é mantida; não há perda de dados. Ocasionalmente, conflitos são registrados por tarefas, como a execução do mecanismo de construção. Geralmente, a condição é detectada e a tarefa é executada novamente.

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

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

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


Feedback