设置 SQL Server 数据库,以便与 Jazz™ Team Server、“变更和配置管理”以及“质量管理”应用程序配合工作。
本过程要求满足 SQL Server 的下列先决条件:
- 已安装服务器,并且选择区分大小写数据库整理作为缺省设置。
- 已启动服务。
- 已安装 Java 数据库连接 (JDBC) 驱动程序。
- 已对 SQL Server 启用 TCP 协议。
- 创建数据库表的用户必须是 sysadmin 固定服务器角色中的成员或者数据库的所有者 (dbo)。
请确保您的服务器安全性处于混合方式。您可以通过检查服务器安全性来验证方式。此方式应该设置为 SQL Server 和 Windows 认证方式。
设置数据库
请使用 SQL Server 安装随附的
sqlcmd 命令行工具来设置 SQL Server 数据库。
对 Microsoft SQL Server 2008 Express Edition 激活 sqlcmd 工具: - 在“开始”菜单中,找到 Microsoft SQL Server 2008,然后单击。
- 在“SQL Server 配置管理器”窗口的左窗格中,单击 。
- 双击协议命名管道。
- 在“命名管道属性”对话框中,对已启用字段选择是。
- 更改命名管道,如下所示:\\.\pipe\sql\query。
- 单击应用;然后,重新启动 SQL Server Services。
此外,您还可以使用诸如 SQL Server Studio Management 之类的可视工具,此类工具也可用于和 SQL Server Studio Management Express® 相同的 Express 版本。有关更多信息,请参阅 SQL Server 文档或者与 SQL Server 数据库管理员 (DBA) 联系。
要点: 如果将 Jazz Team Server 与“变更和配置管理”或“质量管理”应用程序安装在同一计算机或分布式平台上,那么必须创建另一个数据库以及与该数据库相关联的数据库用户。
- 为“变更和配置管理”、“质量管理”、Jazz Team Server 和数据仓库的每个实例创建一个数据库。请使用以下示例并将 jts 替换为您的数据库名称:
注: “需求管理”应用程序与 Jazz Team Server 使用同一个数据库。
CREATE DATABASE jts
GO
- 通过运行下列命令,创建用户和密码,并更改数据库的所有权:
CREATE LOGIN jtsDBuser
WITH PASSWORD = 'jtsDBpswd';
USE jts;
exec sp_changedbowner 'jtsDBuser'
GO
- 更改 Jazz Team Server 数据库的整理顺序。从命令行工具中,输入以下内容:
ALTER DATABASE jts COLLATE SQL_Latin1_General_CP437_CS_AS
GO
- 更改数据库的行版本系统。请从命令行工具中运行以下命令:
注: 在运行此命令之前,请确保与数据库的连接处于打开状态。
ALTER DATABASE jts SET READ_COMMITTED_SNAPSHOT ON
GO
- 更改数据仓库数据库的整理顺序。从命令行输入:
ALTER DATABASE dw COLLATE SQL_Latin1_General_CP1_CS_AS
GO
- 创建一个名为 SQLSERVER_JDBC_DRIVER_FILE 的环境变量,并使其指向 sqljdbc4.jar JDBC 驱动程序。此驱动程序所在的位置视安装而定。
- 单击。
- 单击高级选项卡,然后单击环境变量。
- 在系统变量列表中,单击新建。
- 在变量名称中输入 SQLSERVER_JDBC_DRIVER_FILE,在变量值中输入 C:\Path_to_JDBC_dirver\sqljdbc4.jar。
- 在 Unix 系统上,添加以下环境变量声明:
SQLSERVER_JDBC_DRIVER_FILE =.;Path_to_JDBC_dirver/sqljdbc4.jar
注: Rational solution for CLM 4.0 不再支持 JRE 5.0。受支持的 JRE 版本为 6.0 和 7.0。
sqljdbc.jar 类库要求 JRE 5.0,而
sqljdbc4.jar 类库要求 JRE 6.0 或更高版本。您必须使用
sqljdbc4.jar。
如果您正在使用 WebSphere Application Server,那么您还必须添加指向 JDBC 驱动程序 sqljdbc4.jar 的定制属性。有关更多信息,请参阅设置 WebSphere Application Server。
- 要配置数据库连接并创建数据库表,请完成下列其中一个步骤:
- 如果您正在使用 Tomcat,请启动服务器,然后运行设置向导(定制设置)。
- 如果您正在部署 WebSphere Application Server,请参阅部署和启动 WebSphere Application Server,然后运行设置向导(定制设置)。
- 如果您希望手动修改 teamserver.properties 文件以建立数据库连接,并运行 repotools 命令来创建数据库表,请参阅手动配置 SQL Server 数据库。
- 如果您正在从先前版本进行升级,请接着运行相应的升级脚本,这些脚本将迁移现有的数据库连接。对于数据仓库,您可以在升级后配置服务器期间修改用于连接至数据库的信息。
故障诊断
如果 repotools 命令未成功,请检查 JazzInstallDir/server 目录中的相应日志文件。
并且,请验证是否符合下列条件:
- 是否已将 SQL Server 配置为允许使用 TCP/IP 协议来建立连接。如果需要,请重新启动 SQL 服务。
- SQL Server 计算机的主机名和端口是否正确反映在 teamserver.properties 文件中。
- 登录名、密码和数据库名称是否正确反映在 teamserver.properties 文件中。
- 防火墙未阻止您访问 SQL Server。请使用 Telnet 命令与使用 teamserver.properties 文件中的主机名和端口的服务器进行连接。
- 创建的用户在 Jazz Team Server 数据库中是否具有正确的许可权。
- 已针对环境正确配置了 JDBC 驱动程序环境变量。
注: Jazz Team Server 的数据库代码设计成具有通用性和标准性,能够在多种数据库平台上运行;但是,不同企业数据库在语法、优化策略和锁定语义方面有所差别。通过使用自动化测试和正常工作负载与压力测试模拟的组合,已在 SQL Server 上对服务器进行了测试。正常工作负载模拟已表明性能可接受。在部分实例中,已在自动化并发测试中观察到数据库死锁;但是,尚未在不同的服务器硬件上对这些数据库死锁一致地进行复制。
服务器旨在处理大量同步请求。在异常情况下,由于将在请求的相关事务中并发更新类似或等同的对象,因此存储库数据库会发生死锁。这些事件较为罕见,但很典型。系统的设计能够避免此类情况,并且将维护数据完整性,而不会丢失任何数据。有时,构建引擎执行之类的任务会记录死锁。通常,会检测条件并重试任务。死锁将导致构建失败。在极少数情况下,将停止用户操作(例如处理工作项或源代码)以解决死锁。在这种情况下,用户操作将失败,并且将向用户显示包含死锁详细信息的错误消息。然后,用户可以重试操作。
所有死锁都将记录在服务器上,以便提供有关出现死锁时发生的情况的信息。日志条目含有类似于以下条目的文本:com.ibm.team.repository.common.RetryableDatabaseException: Serialization failure。
如果系统遇到死锁,请参阅以下位置处的错误日志:https://servername:9443/jts/service/com.ibm.team.repository.common.internal.IFeedService?category=SystemLog。
如果您频繁遇到死锁,请联系产品支持人员或检查 jazz.net 上的论坛以获取最新信息、更新或缓解技术。