Configure um banco de dados do SQL Server para funcionar com o Jazz
Team Server.
Este procedimento assume que os seguintes pré-requisitos foram
atendidos:
- Você tem o SQL Server instalado
- O serviço do SQL Server está iniciado
- Você tem os drivers JDBC de SQL Server instalados. Para obter mais informações, consulte http://msdn2.microsoft.com/en-us/data/aa937724.aspx
- O protocolo TCP está ativado para o SQL Server
- O usuário que cria a tabela do BD deve ter uma das seguintes
permissões:
- Uma associação na função do servidor fixada por sysadmin ou propriedade
do banco de dados (dbo)
Lembre-se: O nome de login padrão definido no arquivo JazzInstallDir/server/teamserver.properties
para um banco de dados SQL Server é 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 SQL Server utilizando a ferramenta de linha de comandos sqlcmd,
fornecida com a 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:
- Crie um banco de dados do Jazz
Team Server.
A partir da ferramenta de linha de comandos, digite:
CREATE DATABASE jazz
GO
- Crie um usuário e senha e altere a propriedade do banco de dados do Jazz
Team Server.
A partir da ferramenta de linha de comandos, digite:
CREATE LOGIN jazzDBuser
WITH PASSWORD = 'jazzDBpswd';
USE jazz;
exec sp_changedbowner 'jazzDBuser'
GO
- Altere a intercalação do banco de dados do Jazz
Team Server.
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: Por
padrão, o arquivo teamserver.properties no diretório JazzInstallDir/server/conf/jazz
não é configurado para conectar-se a um banco de dados SQL Server. Todas as configurações padrão, junto com configurações
específicas do SQL Server, estão contidas no arquivo teamserver.sqlserver.properties
no mesmo diretório.
Para configurar o servidor:
- 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.
- Edite o arquivo de configuração do servidor se você usou um nome de usuário,
senha ou nome do BD diferente, instalou o servidor SQL em uma máquina diferente
de Jazz
Team Server
ou estiver usando uma porta diferente da padrão. Abra o arquivo teamserver.properties no diretório JazzInstallDir/server/conf/jazz
e altere as informações listadas abaixo para corresponderem a 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.
Importante: Apenas para Windows®.
Certifique-se de que a segurança de seu servidor esteja no modo combinado. É possível confirmar isto verificando a segurança do servidor. Ele deve ser configurado como "Modo de Autenticação do SQL Server
e Windows".
Para especificar o local do arquivo jar para JDBC:
- No mesmo diretório dos scripts de servidor
(JazzInstallDir/server),
crie um diretório denominado sqlserver.
- Localize o arquivo JAR do driver JDBC do SQL Server, 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.
- Especifique o local do arquivo JAR para JDBC concluindo 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ê deverá incluí-los entre aspas.
Dica: Se usar o WebSphere Application Server, configure uma propriedade chamada SQLSERVER_JDBC; depois configure-a para o caminho do diretório absoluto (não URL) que contém os drivers JDBC da SQL Server, por exemplo, se seu sqljdbc.jar estiver localizado em JazzInstallDir/server/sqlserver.
Para obter mais informações, consulte as instruções de configuração do WebSphere Application
Server. Anote o caminho de arquivo para uso posterior nessas instruções.
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:
- O SQL Server está configurado para permitir conexões utilizando o protocolo
TCP/IP. Se necessário, reinicie o serviço da SQL.
- O nome do host da máquina do SQL Server e a porta estão refletidos corretamente
no arquivo teamserver.properties.
- O nome de login, a senha e o nome do banco de dados estão refletidos corretamente
no arquivo teamserver.properties.
- Um firewall não está impedindo o acesso ao SQL Server.
Utilize um comando
telnet para efetuar telnet para a máquina utilizando o nome do host e a porta do arquivo teamserver.properties.
- O usuário criado possui permissões apropriadas no banco de dados do Jazz
Team Server.
Nota: O código do banco de dados para o
Jazz
Team Server 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 SQL Server 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 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 é 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. 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, conflitos são registrados
por tarefas, como a execução do mecanismo de construção. Geralmente, a condição é detectada e a tarefa repetida.
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 relacionados a um conflito é exibido
ao 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 frequentes, 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.