Jazz 技术文档团队 Jazz.net, 编辑, IBM Rational
2009 年 2 月 09 日 这里提供了帮助您规划安装 Rational Team Concert 所需的信息。
本文讨论：
安装规划概述
-
在规划安装时有几件事您需要注意。
-
选择一个 Rational® Team Concert 版本。
-
浏览支持的操作环境。
-
选项： 填写规划工作单。
注意：默认条件下，Jazz™ Team Server 在 不进行额外配置的前提下，被配置好。如果您想使用所有支持的程序服务器，数据库或者可选特性，那么您就可以 使用规划工作单来指导您的安装，以及配置决定和具体的细节。
支持的操作环境
浏览信息并确保您的操作环境支持安装。
-
支持的服务器环境
检查支持的 Jazz™ Team Server 操作环境。
-
支持的客户端环境
检查支持的 Rational® Team Concert 客户端环境。
-
支持的集成环境
检查支持的 Rational Team Concert 集成开发环境。
支持的服务器环境
检查支持的 Jazz™ Team Server 操作环境。
最低硬件需求
-
处理器： Pentium® Xeon® (32-bit)
-
内存： 1 GB
-
硬盘空间： 1 GB
-
显示器： 1024 x 768 分辨率
-
其他软件需求： 100 mbps/1000 mbps 流量
支持的操作系统
该服务器支持以下的操作系统：
-
Microsoft® Windows® 2003 Server with Service Pack 2
-
Red Hat Enterprise Linux® 5.0 Update 1
-
SUSE Linux Enterprise Server 10 with Service Pack 1
注意：尽管服务器是在 Windows XP 和 Windows Vista 之下工作的，但是它们并不是支持的产品环境。 Windows XP 和 Windows Vista 下操作运行良好，允许个人用户或者小的团队探索产品以及它的许多特性。
Java™ SE Runtime Environments （JREs）
服务器需要以下 JREs 中的一种：
-
IBM® JRE 1.5 Service Release 7
-
Sun JRE 1.5 Update 14
程序服务器
支持以下的程序服务器 ：
-
Apache Tomcat 5.5
-
IBM WebSphere® Application Server 6.1
注意： Jazz Team Server 并不使用 WebSphere Application Server Network Development 中支持的群件，并只在单一模式下工作。
特性管理系统
支持以下的特性管理 LDAP 服务器：
-
IBM Tivoli® Directory Server 6.0
-
Microsoft Windows Server 2003 Active Directory
关系数据库
支持以下的数据库：
-
IBM DB2® 9.1
-
IBM DB2 9.5
-
Oracle Database 10g release 2
-
Apache Derby 10.3.2.2
支持的客户端环境
检查支持的 Rational® Team Concert 客户端环境。
最低软件配置需求：
-
处理器：Intel® Pentium® 3 或者 4（最低）；intel Core 2 Duo （推荐）
-
内存： 最低 1 GB
-
硬盘空间：最低1 GB
-
显示器：最低1024 x 768 分辨率
-
其他硬件需求： 10/100 mbps 流量或者 802.11b
支持的操作系统
客户端支持以下的操作系统：
-
Windows® Vista with Service Pack 1
-
Windows XP with Service Pack 2
-
Red Hat Enterprise Linux® 5.0 Update 1
-
SUSE Linux Enterprise Desktop 10 with Service Pack 1
Java™ SE Runtime Environments （JREs）
客户端支持以下的 JREs ：
-
IBM® JRE 1.5 Service Release 7
-
Sun JRE 1.5 Update 14
Eclipse 构件
客户端支持以下的 Eclipse 构件：
-
Eclipse 3.3.2
-
Equinox 3.3.2
-
Graphical Editing Framework (GEF) 3.3.2
-
Eclipse Modeling Framework (EMF) 2.3.2
注意：确保您的 Eclipse 环境包含了插件开发环境（PDE）特性。
即时传信客户端
客户端集成了以下的即时传信客户端：
-
IBM Lotus® Sametime® 7.5.1
-
IBM Lotus Sametime 8.0
XMPP 服务器
与 XMPP 服务器相连的客户端使用 XMPP（Jabber）协议来进行交流：
Web 浏览器
Web 浏览器支持基于 Web 用户界面的使用：
-
Mozilla Firefox 2.0
-
Microsoft® Internet Explorer 7
支持的集成环境
检查支持的 Rational® Team Concert 集成环境。
IBM Rational ClearCase 版本
ClearCase® Connector 构件与以下版本的 IBM® Rational ClearCase 相连接：
IBM Rational ClearQuest 版本
ClearQuest® Connector 构件与以下版本的 IBM Rational ClearQuest 相连接：
子版本服务器
子版本服务器与以下的子版本相连接：
安装规划工作单
该工作单帮助您能进行一次成功的安装，并选择您的通用配置选项。
下面的表格列出了在安装和创建过程中，您可能会需要提供的选择和信息。在安装和创建您的服务器期间，该表格能够帮助您填表。
|
表 1. 安装规划工作单
|
|---|
|
决定您的需求和配置需求
|
安装考虑和一些实例答案
|
|---|
选择一个版本
|
-
Rational® Team Concert Express-C 版本
-
Rational Team Concert Express 版本
-
Rational Team Concert Standard 版本
|
有多少个客户端 您您是不是需要一些访问许可证？
注意：每一个用户都需要分配给一个 Client Access License，以运行 Rational Team Concert 中一些功能。查看 Client Access Licenses 以获得每一个 Client Access License 类型允许操作的列表。为了为每一个用户配置 CALs。查看 Managing client access licenses
|
-
Contributor
-
Developer
-
Build System
-
ClearCase® Connector
-
ClearQuest® Connector
|
确认您的服务器环境支持安装。
|
记录服务器环境
-
主机名： jazzserver.example.com
-
IP 地址： 192.168.1.1
-
平台： Linux RHEL 5
|
选择一个服务器程序
选择一个程序服务器
注意： IBM® WebSphere® Application Server 只支持在 Rational Team Concert Express 和Standard 版本下运行。
|
选择一个程序服务器：
Apache Tomcat（包含的）
IBM WebSphere Application Server
如果您正在安装 Jazz Team Server，以和 IBM WebSphere Application Server 一起使用，记录以下的信息 ：
-
Web 程序目录：
-
Windows: Program Files\IBM\JazzTeamServer\server （默认）
-
Linux: /opt/IBM/JazzTeamServer/server （默认）
如果默认的端口与正在使用的端口发生冲突，那么列出您使用的端口。
-
http port: 9080 （默认）
-
https port: 9443 （默认）
|
选择一个服务器和链接类型
注意： DB2® 和 Oracle a只支持在 Rational Team Concert Express Standard 版本下运行。
注意：尽管在默认的配置中已经包含了一个 Derby 数据库，而且需求不需要安装，该数据库也不能支持超过 10 个用户。如果您想要支持超过 10 个用户，并且没有访问现存的 DB2 的途径的话，那么您可以安装 DB2 Express
|
数据库信息：
-
Derby （默认）
-
DB2 Express（默认）
-
DB2
-
Oracle
数据库链接类型：
-
JDBC
-
JDBC Password: db2admin
-
JDBC Location: //localhost:50000/JAZZ:fullyMaterializeLobData=false （默认）
-
User name: db2admin
-
J2EE
-
J2EE Datasource: jdbc/mydatasource
数据库位置：
提示：在 DB2 Command Window 中，运行命令 db2 get dbm cfg，然后找到包含 SVCENAME 的行，这代表着 DB2 端口名或者号码。如果该命令显示了一个号码，使用它作为端口号码（在上面的例子中是 50000）。 如果命令行返回了一个非数值型的名字，决定什么端口号码会分配给该名字，并使用该端口号码。在 Linux 中，文件 /etc/services 包含了端口号码和名字之间的映射，而在 Windows 上，文件 C:\windows\system32\drivers\etc\services 包含了映射。如果您想要得到更多信息，询问您的数据库管理员或者咨询数据库文献。
提示：如果您安装的是 DB2 Express，接受安装简化 Jazz Team Server 配置时，接受默认的设置。
|
您想要怎样管理用户？
|
特性管理选项 ：
-
Apache Tomcat 用户数据库域
-
User ID: 用户名
-
Name: 全名
-
E-mail 地址：username@example.com
-
LDAP
-
LDAP Registry 位置： ldap://ldap.example.com:389
-
User Name: username
-
Password: SecretPassword
-
Base User DN: o=[company],l=[your city],c=[your country]
-
User Property Names Mapping: userId=mail,name=cn,emailAddress=mail
-
Base Group DN: ou=memberlist,ou=yourgroups,o=example.com
-
Jazz to LDAP Group Mapping: JazzAdmins= YourGroupA, JazzUsers= YourGroupB, JazzDWAdmins= YourGroupC, JazzGuests= YourGroupD
-
Group Name Property: cn
-
Group Member Property: uniquemember
-
Non-LDAP custom realm
-
User ID: username
-
Name: Full Name
-
User roles: JazzAdmins, JazzUsers, JazzDWAdmins, JazzGuests
注意：您需要建立能够映射到 Jazz J2EE 安全角色的组。
| |
选项：Optional: 您是否想要拥有 e-mail 注释功能？
|
SMTP Server 细节信息
-
SMTP Server: smtp.example.com
-
SMTP Username: EmailUserName
-
SMTP Password: SecretPassword
-
Mail From Address: you@example.com
-
Mail From Name: Your Mail Name
-
SMTP Reply Address: from@example.com
-
SMTP Server Port: 25
-
Use STARTTLS: True or False
您是否想要具有
e-mail whitelist，以限制 e-mail 注释功能？例如，*@example.com 会只允许 e-mails 发到您公司的 e-mail 地址。
| |
可选项： 您是否想要具有 Jabber 聊天服务器的功能？
|
Jabber Server 具体细节：
-
Server URL: jabberserver.example.com
-
端口：5222 或者 5223
|
确认您的客户端环境支持安装。
|
|
您是否想要使用 ClearCase Connector 或者 ClearQuest Connector？
-
配置并使用ClearCase Connector for Jazz source control
-
配置并使用ClearQuest Connector for Jazz work items
|
|
-
选择一个程序服务器
这些信息会处理选择一个选择服务器的考虑。
-
选择一个数据库
这些信息会处理选择一个数据库的考虑。
-
选择一种用户管理方法
选择以下用户管理选项中一项。
选择一个程序服务器
这些信息会处理选择一个选择程序服务器的考虑。
Jazz™ Team Server 包含了 Apache Tomcat，以作为默认的程序服务器。
如果您已经安装了 Apache Tomcat 的话，那么可以配置一下 Jazz Team Server，以让它能够在现存的环境中运行。
也可以配置 Jazz Team Server，以和 WebSphere® Application Server 一起运行。
选择一种数据库
这些信息处理的是选择一种数据库的考虑。 Jazz™ Team Server 包含了 Derby 以作为默认的数据库。
注意：尽管在默认的配置中包含了一个 Derby 数据库，而且不需要安装，该数据库也不能支持超过 10 个用户，不能访问现存的 DB2 或者 Oracle 数据库，您需要安装 DB2 Express。
Rational® Team Concert Express 和 Standard editions 包含了 DB2 Express 的一个版本。
如果您正在使用的就是环境中的 DB2® 或者 Oracle 的话，那么可以配置 Jazz Team Server 以和现存的数据库软件相协调。
-
特定 DB2 指南
在使用 DB2 数据库时，检查如下信息。
选择一种用户管理方法
在以下用户管理选项中选择一种。
-
管理使用 Apache Tomcat 用户数据库的用户
默认的用户管理，能够使您在没有外部用户管理系统帮助的条件下，也能够管理用户。 管理使用 Apache Tomcat 用户数据库的用户，只适用于 Apache Tomcat 安装。
-
管理使用 Lightweight Directory Access Protocol（LDAP）的用户
该信息能够帮助您去配置您的 LDAP 注册以管理用户。
-
管理使用通用域的用户
-
管理 IBM® WebSphere® Application Server 或者 Apache Tomcat 的认证机制以及组会员权。
管理使用 Apache Tomcat 用户数据库的用户
默认的用户管理方法，使您能够在没有外部用户管理系统帮助下也能够管理用户。管理使用 Apache Tomcat 用户数据库的用户，只适用于 Apache Tomcat 安装。
用户名和加密的密码存储在 tomcat-users.xml 文件中。更新，例如，创建一个新用户并更改用户密码或者储存库许可证，也会自动写入 xml 文件。您不需要编辑文件。
注意：文件位于 JazzInstallDir/server/tomcat/conf。
管理使用 Lightweight Directory Access Protocol （LDAP）的用户
这些信息能够帮助您去配置您的 LDAP 储存库，以管理用户。
默认条件下，Jazz™ Team Server 在用户数据库中，会存储带有加密密码的用户信息。
如果您要使用带有 Jazz Team Server 的 LDAP 储存库，您必须配置您的 Apache Tomcat 或者 WebSphere® Application Server，以使用一个 LDAP 储存库来认证用户。
为了配置 LDAP，以和 Jazz Team Server 一起协调工作。
-
理解 LDAP 配置参数。
-
配置 Apache Tomcat 或者 WebSphere Application Server 的Web 容器。
注意： Jazz Team Server 用户识别是用例灵敏性的。在使用 LDAP 来进行用户管理时，放弃用例非灵敏性的选项。与您的服务器管理员一起工作，或者咨询产品文件，以确保设置是用例敏感性的。
-
创建一个初始用户。用户就是初始的 Jazz Team Server 管理员。
-
配置 Jazz Team Server 以使用 LDAP。
-
引入用户。
理解 LDAP 配置参数
|
表 1. LDAP 参数以及描述
|
|---|
|
参数
|
值描述
|
|---|
|
LDAP 注册位置
|
引用您的 LDAP 服务器的 URL： ldap://ldap.example.com:389
| |
用户名
|
用户名会注册到 LDAP 服务器中。有些 LDAP 不需要注册和密码。在这种情况下，参数会设置成空白的。
| |
密码
|
密码会与用户名相联系
| |
Base User DN
|
搜索基底指示开始搜索用户层状结构的地方。例如，"o=[company],l=[your city],c=[your country]"
| |
User Property Names Mapping
|
用户属性名到 LDAP 注册条目属性名的映射。您必须定义以下的映射：
-
userId =[LDAP user ID]
-
name =[LDAP user name]
-
emailAddress =[LDAP user e-mail]
例如，userId=mail,name=cn,emailAddress=mail
| |
Base Group DN
|
搜索基底从开始搜索组名的层状结构开始，例如，ou=memberlist,ou=yourgroups,o=example.com
| |
Jazz 到 LDAP Group 的映射
|
Jazz 组和 LDAP 组之间的映射。一个 Jazz 组会映射至多个 LDAP 组。LDAP 组必须由半个冒号隔开。例如，JazzAdmins=LDAPAdmins1；LDAPAdmins2 映射至 JazzAdmins 组到 LDAPAdmins1 和 LDAPAdmins2。 Jazz Team Server 定义了 4 组以映射：
-
JazzAdmins =[LDAP Group for Jazz admins]
-
JazzUsers =[LDAP Group for Jazz users]
-
JazzDWAdmins =[LDAP Group for Jazz Data Warehouse Admin]
-
JazzGuests =[LDAP Group for Jazz guest]
例如，JazzAdmins= YourGroupA,，JazzUsers= YourGroupB，JazzDWAdmins= YourGroupC，JazzGuests= YourGroupD .
| |
Group Name Property
|
LDAP Property 代表了 LDAP 注册中的 Jazz 组的名字。例如，cn.
| |
Group Member Property
|
LDAP Property 代表了 LDAP 注册中组的成员。例如，uniquemember。
|
LDAP Configuration for Newbies
Apache Tomcat Realm Configuration
Configuring Lightweight Directory Access Protocol user registries
Mapping users to roles
管理使用通用域的用户
配置 IBM® WebSphere® Application Server 或者 Apache Tomcat 中的配置认证和组管理权。
Jazz™ Team Server 使用认证的 J2EE 安全性角色，访问所保护的资源，并认证一些储存库操作。这些角色会在程序服务器中配置的域中，映射为用户和组。当服务器被配置成使用 Apache Tomcat 用户数据库域或者 LDAP 域，Jazz Team Server 可以从域中引入用户到储存库中，并显示用户所有的角色（组）。 配置 IBM WebSphere Application Server 或者 Apache Tomcat 中认证和组会员权的您自己的域。 当您在使用那个选项时，Jazz Team Server 不能引入用户或者显示它们具有的角色，对您说那些角色是用于认证的。
特定服务器指南
一些服务器环境拥有特定的配置考虑。
如果您的配置包含了程序服务器，或者以下所列操作系统中一项或者多项，那么您可以在安装之前，检查这些信息。
-
Linux 的特定指南
当在 linux 上安装 Jazz™ Team Server 时，检查以下的特定指南。
-
安全性认证
Jazz Team Server 包含了 SSL with the Apache Tomcat 服务器的自适应机制。
Linux 的特定指南
当 Jazz™ Team Server is 安装在 Linux® 上时，检查以下特定的指南。
-
如果您要想使用 Security-Enhanced Linux （SELinux）的话，您 必须 禁止它，或者更改 Java Runtime Environment （JREs）的安全性内容，来允许文本重排，以安装并运行 Rational Team Concert。
-
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
tomcat_user soft nofile 5000
-
如果您在一个 64 位的系统上安装软件的话，一些 JVMs 会需要 32 位的 X11 库。32 位库可以与 64 位库共存。
-
Reports 构件需要在服务器上安装 32-bit X11 库。在 On Redhat Enterprise Linux 5 上，需要的包裹是 libXp, libXinerama，以及mesa-libGL。
-
如果您在 Linux 上安装了 DB2，设置 shmmax 为 1GB。
安全性认证
Jazz™ Team Server 包含了一个 SSL with the Apache Tomcat 服务器的认证性机制。
在访问您的 Jazz 存储库时，一些浏览器和客户端可能会显示一条警告信息。按照以下步骤，以避免出现这条警告信息：
-
得到您自己的认证机制并安装它。
-
如果您不需要加密的话，为 HTTP而不是 HTTP 访问配置服务器。
-
安装一个安全性认证机制
使用属于您自己公司的认证机制来替换自分配的认证机制。
-
禁止安全性认证设置
如果您不需要资源链接的话，那么您可以禁止安全性设置。
安装一个安全性认证机制
用 属于您公司的认证机制来替换自分配的认证机制。
-
配置一个 Apache Tomcat 安全性认证机制。
在文件中，JazzInstallDir/server/tomcat/conf/server.xml, 会从JazzInstallDir/server/tomcat/ibm-team-ssl.keystore 来配置 Apache Tomcat，以阅读服务器的认证机制。默认的 keystore 密码被设置为 ibm-team。该 keystore 包含了一种将服务器识别为“localhost”的自分配认证机制。
注意：为了提高安全性，更改默认的 keystore 密码。
IBM® JRE 包含的 Jazz™ Team Server 包含了一种 IBM 工具，该工具能够用于服务器上的管理密钥。该工具 iKeyman 位于目录 JazzInstallDir/server/win32/ibm-java2-i386-50/jre/bin/ (例如 Windows® 中的 ikeyman.exe)。
ikeyman 工具能够帮助您去创建您自己分配的认证机制，该机制通过主机的网络名来识别它，或者您可以通过一个受信任认证机制（CA）来支持一个认证机制。一个自分配的认证机制需要来自 Team Concert 客户机或者 Web 浏览器的接受。
-
配置 WebSphere® Application Server 安全性机制
如果您想要得到更多的信息，您可以
禁止安全性认证设置操作
如果您不需要安全链接，那么您可以禁止安全性设置操作。
重要点：接下来的信息解释了，怎样禁止 SSL 认证。按照下面的步骤，允许对服务器的非加密链接，包括用户注册信任。如果您需要安全性链接的话，那么您可以创建您自己自适应的认证机制，以通过主机的网络名来进行识别，或者通过一个受信任认证权（CA），来需要一次认证。
编辑 Apache Tomcat 设置
-
确保您至少开始 Apache Tomcat 一次。
-
转到 JazzInstallDir/server/tomcat/webapps/jazz/WEB-INF 目录。
-
编辑该目录下的 web.xml 文件，并更改所有地方出现的“CONFIDENTIAL”为 “NONE”。
-
转到 JazzInstallDir/server/tomcat/conf 目录并编辑 server.xml。
-
从 9080 Connector 元素中删除 redirectPort 属性，这样元素会以以下方式显示出来：
-
<Connector port="9080" maxHttpHeaderSize="8192"
-
maxThreads="150" minSpareThreads="25" maxSpareThreads="75"
-
enableLookups="false" acceptCount="100"
-
connectionTimeout="20000" disableUploadTimeout="true"
URIEncoding="UTF-8"/>
-
重启 Apache Tomcat。
-
使用
http://localhost:9080/jazz/admin 可以进行注册，并且不要回到 https://localhost:9443/jazz/admin。
编辑 WebSphere® Application Server 设置
-
编辑安装到 WebSphere Application Server 中从 jazz .war 文件中解压的 web.xml 文件，您需要提取 jazz .war 文件到一个暂时的区域，以得到该文件。
-
更改所有地方出现的 “CONFIDENTIAL”为“NONE”（这里应该有三个）。
-
确保 WebSphere Application Server 正在运行，并来到
https://localhost:9043/ibm/console/logon.jsp。
-
来到 Applications > Enterprise Applications 页面。
-
选择 jazz_war 程序并点击 Update 按钮。
-
选择“Replace or add a single file”图标选项。
-
在“指定路径，开始安装程序档案文件到替换或者添加的文件中”输入区域，输入“jazz.war/WEB-INF/web.xml”。
-
点击浏览按钮，并选择在前面步骤中编辑过的同一 web.xml 文件。
-
点击下一步并一直继续，直到程序被保存成功。
-
回到 Applications->Enterprise Applications 页面，并停止再开始 jazz_war 程序。
-
使用
http://localhost:9080/jazz/admin 您可以进行注册，并且不要再次来到 https://localhost:9443/jazz/admin。
关于作者  | | | Jazz 是一个 IBM Rational 的开放商业软件开发项目，由 Jazz.net 社区维护。 |
对本文的评价
| 
