Rational Team Concert 3.0安装

标准板的安装概述' Z' N4 y7 J) w8 g
这个安装包包含您开始所需要的所有文件。* v0 b9 T3 e: j' q1 Q3 U
默认的配置包括以下这些项：

Windows® 和 Linux 的 Java™ Development Kit (JDK) 支持版本。
一个包含 Jazz™ Web 应用软件的 Apache Tomcat Web 应用服务器的工作镜像。
一个 Derby 数据库和所有必需的数据库集（Database Library）。
重要提示：利用 Jazz Team Server 和一个多达十个用户的 Derby 数据库支持。要支持多于十个用户，就要使用 DB2® Express，DB2 或者 Oracle 数据库。当您使用 IBM Installation Manager 时，DB2 Express 包含在 Rational® Team Concert 标准版和标准板安装包中。如果您使用的是压缩文件安装方法，可以在与 Rational® Team Concert 下载的同一个网站上下载 DB2 Express。当 DB2 Express 安装完成之后，您必须安装，并按照安装指南所述的那样对它进行配置。
注意：在线帮助中可获得一个非强制性的 计划工作表，可以帮助您选择您的配置和记录您的决定。) A) Z$ g4 u( b6 X( j5 z

准备安装标准板3 Z2 H, `& r" w/ ^+ L9 f2 @
在安装服务器之前，验证能够满足这些特殊考虑因素。- R: E- e8 G3 _
Linux 的特殊操作指南0 E; k! F4 }9 m( I% ?' O* R% n
当 Jazz™ Team Server 安装到 Linux® 时，检查下面这些特殊操作指南。
如果 Security-Enhanced Linux（SELinux）是激活的，您 必须 使它无效或者更改 Java Runtime Environment (JREs) 的安全上下文，允许文本的重置，从而能够安装和运行 Rational Team Concert。要获得更多的信息，请看 Installing Rational Team Concert with Security-Enhanced Linux。
Jazz Team Server 安装路径名不能包含空格。这个安装脚本（JazzInstallDir/server/server.startup）和信息库工具脚本（JazzInstallDir/server/repotools.sh）发现并报告了这个问题。
将文件数量增加到最大，那么 Apache Tomcat 用户就能处理多达 5000 的文件。在 Redhat Enterprise Linux，您可以通过将下面的命令添加到 /etc/security/limits.conf 来实现：

tomcat_user hard nofile 5000' I- Y" n9 [7 L/ Y, L5 A tomcat_user soft nofile 5000& q! H! W' @* `/ }6 M }

如果您将软件安装到一个64位的系统上，那么有些 JVMs 就会需要32位 X11 存储库。这个32位存储库能与64位的存储库兼容。
这个 Reports 组件需要将32位 X11 存储库安装在这个服务器上。在 Redhat Enterprise Linux 5 中，必需的包是 libXp，libXinerama，以及 mesa-libGL。
如果您将 DB2 安装在 Linux 上，将 shmmax 设置为1GB。# s" i! ` [1 t+ H$ `4 P. l

6 C$ \) h* @9 t9 U0 R

安装标准板
开始之前，您需要获取安装文件。
Jazz™ Team Server，Rational® Team Concert 客户端可以从 developerWorks 下载。

试用版下载：Rational® Team Concert Standard Edition（标准版）
试用版下载：Rational® Team Concert Express Edition（标准板）7 `3 x7 Z5 K' X. s# J: K

Build System Toolkit，ClearCase® Connector，ClearQuest® Connector 以及其它文件可以从 http://jazz.net/ 网站下载。0 J9 ~9 t7 ?; {2 S9 ~: N, G/ N

创建数据库' }! @9 p2 W9 E: X
当您的数据库安装之后，需要进行一些配置工作。
快速路径：如果您使用的是内置的 Derby 数据库，那么就不需要额外创建。继续转入 启动服务器。 {- `) A, a! p) d, [
创建数据库的大概步骤如下：7 Z8 ~4 l5 u& \1 P

创建一个数据库。
配置属性文件。
创建数据库表。
如果是使用的是 DB2® 或者 DB2 Express，请转到创建一个 DB2 数据库。# X; r1 z6 O% b8 q4 V4 A
如果您使用的是 Oracle，转到 创建一个 Oracle 数据库。
创建一个 DB2 数据库
创建一个 DB2 或者 DB2 Express 数据库与 Jazz Team Server 一起操作。
创建一个 Oracle 数据库, A3 N; G1 r0 e3 S
创建一个 Oracle 数据库与 Jazz Team Server 一起操作。
创建一个 SQL Server 数据库5 }1 `0 S; ?1 C' s7 `: l* d
创建一个 SQL Server 数据库与 Jazz Team Server 一起操作。
创建这个 Jazz Team Server 数据库表格
利用存储库工具创建这个数据库表。* s& S( ^! \( c& `/ M

4 Y0 F, F2 W; ` j. h$ a3 U" d/ e

启动服务器# e) @# m, c! X% [+ b, m* I3 f
这个论题描述了运行服务器启动脚本的几种不同的方法。1 c- p: L+ b* X/ b; n. f
如果您打算使用内置的 Apache Tomcat 应用服务器，您就准备好启动 Jazz™ Team Server 了。$ I! r( o% k! {1 a2 Z- h0 z) ~! S
如果您打算使用 WebSphere® Application Server，您就按照 安装一个 WebSphere Application Server 描述的那样安装您的服务器环境。1 |; g* E* J$ f4 {" a( y" N+ d

启动这个 Apache Tomcat 服务器. W. V+ W J( `! V# G1 M. t+ b
您现在已经准备好启动这台 Apache Tomcat 服务器。
安装一个 WebSphere Application Server2 s: {2 E5 P t3 |
这个论题描述了如何安装 Jazz Team Server 从而与 WebSphere Application Server 一起操作。这个安装假设您将 Jazz Team Server 安装在同一台机器上作为 Websphere Application Server。, X' D7 x' d& t7 ^3 E2 u7 F, f! [

# V2 b' [, x. b& a7 r5 _; E
. z9 v+ ~0 E. L0 f# r0 E
运行安装向导4 W, q s: O X# d7 x
运行这个安装向导，验证这台服务器是正常运作的，并且指导您完成配置服务器的步骤。1 I, s" A& B' m8 i! o& n
要核实 Jazz™ Team Server 是与这个数据库连接着，可以查看日志或者控制台输出。这个连接和数据库信息在它的第一次访问就产生了共鸣。地址 JazzInstallDir/server/tomcat/logs 是这台服务器日志文件所使用的。
这个程序假设利用本地主机和默认端口9443时，您的服务器是可以使用的。如果需要的话，可以用您的服务器主机来取代本地主机和端口9443。

启动服务器

[root@sdp server]# ./server.startup
启动这个安装向导来配置您的服务器。可以利用 URL https://localhost:9443/jazz/setup。: m, U; n+ p* K& e& ~) ~" T2 W C2 C
默认的用户名和密码是有大小写区分的：5 ?; ?5 Q# t. k/ ~

用户名是 ADMIN。
密码是 ADMIN。
如果您对这个 LDAP 地址 Web 容器进行了配置，就请用一个在您的 LDAP 地址中确定的 JazzAdmin 用户来登录。+ v8 J4 G+ Z# L+ W2 B
选择一个安装路径。这个安装向导有两个主要路径。' q! {: t, \1 i3 F) f: U9 e

Fast Path Setup 使用默认的配置。如果您想要使服务器快速运行，快速路径安装是一个很好的选择。在 Fast Path Setup 过程中，安装用户存储库。
Custom Setup 引导您完成详细的服务器配置，包括激活电子邮件通知的性能。在 Custom Setup 过程中，您可以安装以下这些项：

数据库
电子邮件通知
用户登录! i8 q4 Y, `( z9 B' |, q

注意：默认情况下，这个服务器配置是将 Derby 作为数据库。要使用另一个数据库，比如 DB2，就请选择自定义安装路径并完成步骤2：Configure Database。
当初始安装完成之后，可以通过利用 URL https://localhost:9443/jazz/admin 从 Jazz Team Server Admin Web 用户界面配置额外的选项。& ~! @, o" j/ {% j2 q7 X
如果这个服务器安装向导不能加载，请检查下面的项：

验证这个应用服务器已经启动。使用这个 URL http://localhost:9080。 验证 Jazz Team Server 已经通过利用 URL https://localhost:9443/jazz/admin 登录到 Jazz Team Server Admin Web UI 被启动。如果这个页面不能加载或者这台服务器有错误，那么这台服务器就不能正确地启动。
Jazz Team Server 路径的 URI 根必须是 /jazz。例如必须使用 URL https://example.com:9443/jazz，而不是 URL https://example.com:9443/。

完成安装
当这个服务器安装完成之后，您必须在继续操作之前考虑一些配置选项。
安装之后，需要进行几个额外的行为操作。; O& b# B; G+ \ ?! r1 \' J4 M7 F

有些文件含有密码。那些文件应该被保护，这样它们就成为只有拥有这个账户密码权限的用户才能查看的文件。

teamserver.properties —— Jazz™ Team Server 要求数据库密码保存在 JazzInstallDir/server/teamserver.properties 中。
当这些属性文件被保存时，这个应用软件通常会将相同地址中先前的版本进行备份。如果您想要清除所有包含明文密码的文件，就要在第一次配置服务器时清除这些备份属性文件。
当把这台服务器与 Rational® Team Concert 客户端或者一个 Web 浏览器连接时，您应该可以看到安全认证的警告。要使警告无效，请看 Security certificates。

如果您将服务器配置为用户端口而不是默认值，那么这些端口也应该配置到 Jazz 配置中。这些端口数字是用来组成类似源连接和邮件通知中条目连接的 URLs 的。要更新这些默认值，可以使用 Admin Web UI 的高级属性配置页面来修改下面的属性：

com.ibm.team.repository.servlet.internal.ServletConfigurationService8 E' d9 S$ W/ L8 k. r

Repository HTTP 端口
Repository HTTPS端口

com.ibm.team.repository.service.internal.webuiInitializer.ConfigPropertyInitializer9 r6 q* x# ^; w# P) m+ e

URL HTTP端口
URL HTTPS端口

您现在已经准备好将服务器连接到 Rational Team Concert 客户端或者一个 Web 浏览器。# e1 t- M8 [, t8 Q/ `$ K3 W

, ^7 E' ^$ Z* O6 [, @

解决服务器故障% B5 A) c; ^' H/ B/ e% P
您可以使用管理 Web 界面来解决服务的问题。
您必须登录到 Admin Web UI，而且必须是 JazzAdmins 小组的成员之一。! m# h. C# t9 D3 A# Y" |
要检修服务器的问题，可以在 Admin Web UI 中点击 Server 键符。在这个页面，您可以找到服务器状态信息，可以帮助您解决问题。4 Q2 c. P$ H6 u# l. K6 [1 B" K6 J
提示：查看 Jazz.net Tech Notes 或者 Server troubleshooting FAQ，从而查找另外的故障处理提示。
下面这个表格列出了常见的一些问题和解决方案。/ O. i2 V1 }2 k* D9 n8 G8 F

问题	需要检查的部分
数据库无法使用	检查服务器状态：点击 Status 概要。% o" _2 s7 H5 i3 \+ v) H 在 Status Summary 页面中的 Server Status 面板上，验证数据库的状态是连接的。如果这个状态无法使用，就要检查 Database Status 面板获取详细情况。失败的可能情况包括数据库配置无效，以及数据库的有效配置不能被初始化。+ ?- n. b& r( a9 f g. f 注意：Derby 数据库仅仅支持一个连接；如果另一个服务器实例正在运行，那么它可能仅仅使用一个数据库连接。如果这个问题发生了，那么 Service Error Summary 面板会列出多个错误。 在 Server VM 面板中，验证这个服务器运行的是正确的 JDK。' b# }+ Q* |2 _- N; Q! N& W g 在 Service Error Summary 面板中，检查错误的信息。
无法更改配置属性	检查服务器配置属性：在 Configuration 下，点击下面的条目之一: E-mail Settings Database Connections Feed Settings License Key Management Advanced Properties4 d7 _7 }- \) ~ 在这些页面中，您可以查看和更新配置属性。当您将变更保存到配置属性中时，它们会传播到 teamserver.properties 文件中。如果这个数据库没有连接，您可以仅仅通过编辑 teamserver.properties 文件来更改配置属性。
故障服务	检查服务的状态：点击 Component Status。 在 Component Status 页面上，检查堆栈跟踪，从而获取更多关于故障服务的信息。
降低服务器的活动性	检查运行的服务：点击 Active Services。 在 Active Services 页面，检查运行的服务和它们的堆栈跟踪。检查在延长时间内运行的服务。# O6 i# d! z. K9 k( E! k$ J 检查这个服务器的活动性：点击 Statistics。) Q- k# e8 ]0 q ?) o6 {. R 在 Server Statistics 页面，检查这个服务器的活动性，比如 Web 服务的统计资料，异步任务，以及缓冲行为。

补充资源和提示/ P+ Y2 |2 A6 B0 ~; N
要获取更多的信息，您可以访问日志源:, D y: l: R$ ]0 R5 L

如果您运行的是一个安全连接，可以从这个位置访问这个日志源:

https://localhost:9443/jazz/service/com.ibm.team.repository.common.internal.IFeedService?category=SystemLog

如果您没有运行安全连接，可以从这个位置访问日志源:

http://localhost:9080/jazz/service/com.ibm.team.repository.common.internal.IFeedService?category=SystemLog

B8 t4 q# s2 |, v! G7 U$ m

如果这个日志源无法使用，请从一个 Windows 控制窗口中或者在 installdir/tomcat/logs/catalina.out 查看这个 Tomcat 日志源，这里的installdir 就是您安装这个服务器的位置。
如果这个 teamserver.properties 文件在启动过程中没有找到，这个服务器就不能正常工作，并且这个 Tomcat 日志和日志源中也会包含错误。这个 server.startup 脚本提供了到特性文件的路径。
确保默认的 Tomcat 连接端口 9080 和 9443 没有被使用。这个连接端口是在 installdir/tomcat/conf/server.xml 文件中确定的，这里的 installdir 就是您安装服务器的位置。
如果这些问题还不能解决，就要考虑重新安装数据库或者 Web 档案文件（WAR）。您可以从最初的分配文件中（repositoryDB.zip）或者一个备份文件中重新安装数据库。