作者：张 捷, 软件工程师, IBM
转自：http://www.ibm.com/developerworks/cn/rational/r-cn-jazzrtc20install/index.html
本文介绍了在实际应用中如何进行 Rational Team Concert 2.0（RTC 2.0）的安装配置，包括简单的 Derby+Tomcat 环境以及复杂的 DB2+WebSphere+LDAP 环境。本文包含很多相关细节和实际操作图，能够有效的帮助读者以最快的速度建立起 RTC2.0 应用环境。
Rational Team Concert（RTC）是 Jazz 产品中最重要的一个。不论是小团队还是大的开发队伍，都能使用 RTC 进行简单有效的，自动化的项目管理控制。数据和报告可以自动的收集和生成，再加上支持所有人的同时协作，极大的提高了效率，降低了成本。RTC 包含了源代码控制，工作项管理和构建管理等功能，内建支持 Agile，Scrum， OpenUp， Eclipse Way 等项目开发模式，能够满足不同规模开发团队几乎所有的需求。
RTC2.0 分为 Express-C（三个免费 Developer 用户）， Express，Standard 和 Enterprise 版本。不论是几个人的小团队还是上千人的巨型开发队伍，都能找到适合自己的 RTC。
RTC 的安装配置并不十分复杂，本文的目的也不是写成安装手册。在此就 RTC 各个版本在项目中的实际情况介绍安装配置的过程，希望能够帮助 RTC 的用户更快，更简单的安装配置 RTC。
RTC Express-C 版本是一个免费版本，含有 3 个免费的开发者（developer）用户和无限制的贡献者（contributor）用户，当然用户可以购买更多的 License 以支持更多的开发者用户。不过因为 Express-C 版本只支持 Derby 数据库，就限制了开发者的用户最大为 10 个。RTC 所有的版本使用 Derby 数据库时都有这个限制。RTC Express-C 版比 Standard 和 Enterprise 版还缺少一些功能，比如可定制的工作流，报表，ClearCase 和 ClearQuest 同步功能等。RTC 2.0 各版本之间的功能详细比较可以在 RTC 2.0 的下载页面看到（参见参考资料）。
RTC2.0 的版本还有 Express，Standard 和 Enterprise 三个，其实他们都包含有 3 个免费的开发者用户。
Express 版本与 Express-C 一样比 standard 和 Enterprise 版缺少一些功能，但支持 DB2 Server Group（DB2、Oracle、SQL Server）和 WAS，并且最大支持 50 个开发者用户。
Standard 版本支持 RTC 全部功能以及 DB2 Server Group（DB2、Oracle、SQL Server）和 WAS，最大开发者用户数限制为 250。
Enterprise 版本与 standard 版本不同的地方是 Enterprise 版本没有最大用户数的限制，同时 Enterprise 版本支持 High availability 特性。
各个开发小组可以根据小组的规模以及对功能的需求来决定选择哪一个版本的 RTC。
RTC 2.0 Express-C 版本安装（derby+tomcat）
RTC Express-C 非常适合人数不多的小团队，就让我们从这个版本开始 RTC 的安装吧。
RTC 2.0 的 Express-C 版本可以在 jazz.net 站点下载（参见参考资料）。
用户可以选择只下载客户端，只下载服务器端，或者是服务器和客户端绑定在一起的 zip 文件。我们的项目中 RTC 架构在 windows 上，并且为了方便，我们使用服务器和客户端绑定在一起的 zip 文件作为示例。
Windows 版本下载后为一 RTC-ExpressC-Full-2.0-Win.zip 文件。解压缩后可得到包含服务器和客户端的 jazz 文件夹。
其中 client 目录为包含了 eclipse 的客户端，直接启动 jazz\client\eclipse\eclipse.exe 即可启动客户端。Server 目录即为包含了 Tomcat 的服务器端。
RTC Express-C 版本只能使用 Derby 和 Tomcat，所以安装最为简单。RTC 其它版本的服务器，如果只是使用 Derby 和 Tomcat 的话，安装也如 RTC Express-C 一样。
启动服务器只需运行 jazz\server\server.startup.bat 即可。停止服务器运行 jazz\server\server.shutdown.bat。
RTC 2.0 Standard 版本安装（db2+websphere）
RTC2.0 Express、Standard 和 Enterprise 版本都支持 DB2 和 WebSphere，所以我选择了支持几乎所有功能并且能够满足绝大部分 team 需求的 Standard 版本作为示例。Standard 版本如果使用 derby 数据库的话将只能使用 10 个用户许可证，所以绝大多数用户会选择 DB2，Oracle 以及 SQL server 这几个数据库来进行安装。而 WebSphere 服务器将提供给 RTC 用户更多的选择。
以下将以 db2 和 WebSphere 作为示例介绍 RTC2.0 Standard 版本的安装。
RTC 2.0 Standard 版本的下载地址（参见参考资料）。
用户只能下载分离的客户端和服务器端，Standard 版本不提供服务器和客户端绑定在一起的 zip 文件了。
把 RTC2.0 standard server 的 zip 文件解压缩后得到如下目录结构。
图 2. RTC2.0 Standard Server 目录结构
RTC 2.0 支持 DB2 9.1 和 9.5 版本，我使用的是 DB2 9.5 FP4 这个版本。建立数据库可以参考下面语句：
create database jazz on c: using codeset UTF-8 territory en pagesize 8192
其中 UTF-8 是为了能够支持多种语言，pagesize 至少为 8k，4k 会导致以后创建表失败。如果使用 DB2 管理工具图形界面建立数据库，请注意这两个参数。
数据库建立以后我们就需要配置数据库连接信息。在 RTC2.0 server 的目录结构中，数据库配置文件的位置在 jazz\server\conf\jazz 目录。把 teamserver.properties 另存为别的名字，比如 teamserver.derby.properties。该文件为默认 derby 数据库使用的配置文件。把 teamserver.db2.win32.properties（teamserver.db2.linux.properties 文件用与 linux 系统）文件复制并重命名为 teamserver.properties。打开该文件，在”DB2 configuration”段落找到如下文字，进行修改。
com.ibm.team.repository.db.vendor = DB2
com.ibm.team.repository.db.jdbc.location=//localhost:50000/JAZZ:user=db2admin;password={password};
com.ibm.team.repository.db.jdbc.password=db2admin
需要修改的有数据库服务器的 hostname，端口号，用户名。密码在“com.ibm.team.repository.db.jdbc.password”变量处指定。不要修改 {password} 字样。
修改后保存即可。
RTC2.0 支持的 Websphere 版本
用户想把 RTC2.0 部署在 Websphere 中的话需要注意，RTC2.0 支持 WAS6.1 和 WAS7.0，不过 WAS6.1 需要升级到 6.1.0.19，WAS7.0 需要升级到 7.0.0.3，并且需要安装特定的 i-fix（参见参考资料）。
本文已 WAS7.0.0.3 作为例子进行介绍，在 WAS6.1 中安装也没有什么大的区别。
部署 RTC2.0 web 应用
接下来就需要部署 RTC2.0 的 web 应用了。用 Websphere 的应用安装即可，需要安装的 web 应用文件是 jazz\server\tomcat\webapps\jazz.war。安装时必须指定 context root 为 /jazz，不用修改任何参数。
修改 Websphere 参数
进入 Websphere 的管理界面，修改 Java 虚拟机堆参数。进入 Application servers 菜单，选择 RTC2.0 所部署的服务器，这里以 server1 为例。选择 Process definition，选择 Java Virtual Machine。修改 Initial heap size 为 100，Maximum heap size 为 1000（这个值可以根据实际使用情况进行调整，在 RTC2.0 的 web 管理界面中有 RTC2.0 的内存使用情况显示。）
图 3. WebSphere V7 Java 虚拟机参数设置
修改保存后，我们还需要在 Java 虚拟机中添加几个参数。就在 Java Virtual Machine 页面中有一项 Custom properties，进入这里，添加 3 个参数。
JAZZ_HOME=file:///{YourRTCPath}/jazz/server/conf
java.awt.headless=true
org.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin=true
接下来需要修改服务器的报告级别。因为 RTC2.0 使用 BIRT 报告引擎，WebSphere 默认会把 BIRT 报告写入 WebSphere 日志，这样不但不必要，而且会影响性能。我们可以在这里关闭这个项目。进入 Websphere 的管理界面，进入 Application servers 菜单，选择 RTC2.0 所部署的服务器，这里以 server1 为例。选择 Process definition，选择 Logging and Tracing，选择 Change log detail levels。展开 All Components，找到 org.eclipse.birt.*，选择该项目，修改 Message and Trace Levels 为 fatal。注意 org.eclipse.birt.* 在部署了 RTC2.0 的 web 应用之后才会出现在 WebSphere 的 Log 设定里。
图 4. WebSphere V7 Log Level 修改路径
图 5. WebSphere V7 Log Level 修改
启动和停止服务器
上面步骤这些完成以后就可以重启 WebSphere。RTC2.0 服务器的启动和停止也就相应的成为了 WebSphere 服务器的启动和停止。
把 RTC2.0 部署在自带的 Tomcat 服务器上时，可以选择使用 RTC2.0 自带的用户管理系统，用户信息都储存在 jazz\server\tomcat\conf\tomcat-users.xml 中。当然也可以选择使用 LDAP 作为认证管理系统。
而当 RTC2.0 部署在 WebSphere 上时，就必须使用 LDAP 作为认证管理系统了。所以这一步是必须的。
在 WebSphere 中配置安全性
首先需要把 WebSphere 的安全性配置成 LDAP。这一部分属于配置 WebSphere 的范畴了。”Enable application security”需要被选择上，但是”Java2 security”一定不能选择。选择了 Standalone LDAP registry 后需要进入 Configure 去进行 LDAP 的设置。
把 LDAP 相关信息在 Configure 页面中配置完毕后可以选择”Test connection”去测试一下配置是否正确，LDAP 服务器是否能被连接上。在该页面中，有一项重要的链接叫做”Advanced Lightweight Directory Access Protocal (LDAP) user registry settings”，这里的设置会根据不同的 LDAP 服务器有所区别。”Test connection”按钮的测试会用到这里面的设置，如果设置的不对，也无法通过测试。
测试通过后保存修改，重新启动 WebSphere，这之后启动和停止 WebSphere 服务器就需要提供用户名和密码了。
配置 RTC 用户组
RTC2.0 有 4 个用户组，JazzAdmins、JassDWAdmins、JazzUsers 和 JazzGuests。在 LDAP 服务器中，同样需要建立 4 个相应的用户组与之对应。完成这一步后，在 WebSphere 中，我们可以配置这两组用户组直接的对应关系。具体的位置在 Enterprise Applications 中点击安装的 jazz 应用，然后选择”Security role to user/group mapping”。其中已经有了 RTC2.0 的 4 个用户组，选择其中一个，然后选择”Map Groups”。在新弹出的页面中选择”Search”，会搜索出 LDAP 服务器中的用户组，选择对应的用户组，确定，就完成了一组用户组的对应。以此类推完成所有用户组的对应配置。最后的结果如图。
这之后需要配置 RTC 用户时，需要把该用户添加到相应的用户组，才能登录 RTC2.0
配置 RTC2.0 LDAP 参数
完成了上面的任务之后，我们就可以访问 RTC2.0 了。创建一个 LDAP 用户作为管理员用户，并让他属于 JazzAdmins 和 JazzUsers 用户组。然后访问 http://servername:9080/jazz。用刚才建立的管理员用户登录就进入了 RTC2.0 的管理界面，注意 RTC2.0 的登录信息时大小写敏感的，对用户名和密码都是。选择服务器 -> 高级属性，找到 com.ibm.team.repository，service.internal.userregistry.ExtenalUserRegistryService 项，把缺省的 DETECT 修改成 LDAP。
然后往下找到 com.ibm.team.repository.service.internal.userregistry.ldap.LDAPUserRegistryProvider 项，按照 LDAP 服务器的具体情况修改其中的参数。
其中需要注意的是 RTC2.0 的用户 ID 在参数中称为 userid，默认对应的是 LDAP 中的 uid。配置好 LDAP 参数后，在用户管理中进行用户导入时，默认是使用的“按用户标识查找用户”查询。不配置好 uid 相关参数会导致导入用户时查找失败。
在下载的 RTC2.0 standard server zip 文件中，包含有各种语言的安装说明，以 html 格式提供，可以作为安装的参考。在 jazz.net 网站上有更多的资源提供给用户。
安装后如果使用 tomcat 服务器，并且没有配置 LDAP，那么直接使用 http://servername:9080/jazz 访问，用 ADMIN 用户登录即可进行管理，密码也是 ADMIN。建议在添加了新的 JazzAdmins 组用户，并用该用户成功登录管理 jazz 后禁用 ADMIN 用户，或者修改 ADMIN 用户的密码。如果配置了 LDAP，就不用做这一步，直接用配置好的 JazzAdmins 用户组的用户登录管理即可。
用管理员登录后可以访问 http://servername:9080/jazz/setup 链接，这里可以配置数据库链接，Email 提醒服务，LDAP 参数等。这些配置都可以在管理界面中配置，不进行 setup 也可以。
用管理员登录后，进入的是 http://servername:9080/jazz/admin 链接，进入“服务器”，这里可以对 RTC 2.0 Jazz team server 进行所有的配置。
很多情况下 Express-C 版本的 3 个免费许可证无法满足开发小组的要求，那么就需要够买更多的许可证。在 http://servername:9080/jazz/admin 的“服务器”中有一项“许可证密钥管理”。在这里可以添加客户访问许可证或者浮动许可证服务器。
在 http://servername:9080/jazz/admin 的“服务器”中有一项“电子邮件设置”。在这里设置了正确的 SMTP 服务器参数后可以开通电子邮件通知。这项功能对使用 RTC2.0 的用户十分重要。如果不开通这项功能，那么用户很可能错过很多 RTC2.0 服务器上工作项目的各种变化，影响项目的进度。
如果 RTC2.0 服务器使用的是内建的用户管理机制的话，那么直接在 Web 客户端的用户管理界面添加和管理用户即可，在这里需要为用户分配用户组和访问许可证。
如果 RTC2.0 服务器配置使用了 LDAP 作为用户认证机制，那么添加用户以及为用户分配用户组的工作都在 LDAP 服务器中完成了。但是还需要在 Web 客户端的用户管理界面把用户导入进 RTC，才能为用户分配访问许可证。
前面两次提到分配用户访问许可证，这是一个很重要的过程，因为只有有了用户许可证，用户才可以在 RTC2.0 中进行操作，否则就只是只读用户。RTC2.0 并没有限制只读用户的数量。
不使用或者需要删除的用户，之需要在用户管理界面对用户进行归档即可。以后还可以在已归档用户中把该用户恢复出来。
RTC2.0 支持 Eclipse、Microsoft visual studio 客户端，也支持 web 客户端。Web 客户端用来做管理和配置比较方便。而普通用户使用一般都是用 Eclipse 或者 Visual Studio 客户端。在我们的项目中使用的是 Eclipse 客户端。因为 RTC2.0 的 Eclipse 客户端包含了 Eclipse，可以直接使用，最为方便。
在安装配置以后，一个 RTC2.0 Repository 就建立完毕。用户就可以建立项目区域，分配需要的用户，真正的开始一个项目的管理了。本文介绍的安装过程和细节是根据作者的实际安装经验得来的，调整了官方文档中一些不合理的顺序，并添加了更多的细节。希望本文提供的作者实际安装使用经验，能够帮助那些对 RTC 安装，尤其是在 DB2 和 WebSphere 上没有安装经验的用户，以最快的速度搭建起 RTC2.0 服务器，开始他们的 RTC 之旅。
来自 “ ITPUB博客 ” ，链接：http://blog.itpub.net/14780873/viewspace-615620/，如需转载，请注明出处，否则将追究法律责任。
转载于:http://blog.itpub.net/14780873/viewspace-615620/
481
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
