IBM®
跳转到主要内容
    中国 [选择]    使用条款
 
 
Select a scope: Search for:    
    首页    产品    服务与解决方案     支持与下载    个性化服务    
跳转到主要内容

developerWorks 中国  >  Rational  >

Rational Team Concert Express-C Edition（免费版）安装概述

Jazz Team Server 安装指南

developerWorks
文档选项

未显示需要 JavaScript 的文档选项

英文原文

英文原文


级别： 初级

Jazz 技术文档团队 Jazz.net, 编辑, IBM Rational

2009 年 6 月 10 日

本文介绍了安装 Rational Team Concert Express-C Edition（免费版）的过程及注意事项，提供了帮助您去理解成功安装 Rational Team Concert 免费版所需要的信息。

本文讨论





回页首


免费版的安装概述

这个安装包包含您开始所需要的所有文件。

默认的配置包括以下这些项：

  • 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 安装完成之后，您必须安装，并按照安装指南所述的那样对它进行配置。

注意：在线帮助中可获得一个非强制性的 计划工作表，可以帮助您选择您的配置和记录您的决定。





回页首


准备安装免费版

在安装 Rational Team Concert Express-C 免费版服务器之前，验证能够满足这些特殊考虑因素。

Linux 的特殊操作指南

当 Jazz™ Team Server 安装到 Linux® 时，检查下面这些特殊操作指南。

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




回页首


安装免费版

下载并安装 Rational® Team Concert Express-C 版本的服务器。

Rational Team Concert Express-C 免费版 可以从 Jazz.net 下载（需要 注册 Jazz.net 用户，并登录进行下载）。

Jazz™ Team Server，Rational® Team Concert 客户端可以从 developerWorks 下载。

Build System Toolkit，ClearCase® Connector，ClearQuest® Connector 以及其它文件可以从 http://jazz.net 网站下载。

在整个安装信息中，JazzInstallDir 引用了这个产品地址的位置。例如，如果您将这个文件解压到 /opt/IBM/ ，那么 JazzInstallDir 就会指向 /opt/IBM/jazz。

  1. 将文件下载到您的电脑中。

两个不同档案包中的 Express-C 版本服务器都是可以使用的。每个包都是依赖的。这个一体化包包含服务器和客户端。服务器包仅仅包含服务器。如果您下载的是服务器包，那么您还需要单独下载一个客户端。

  1. 将这个包中的内容解压到您的文件系统中。

当您解压文件时，选择一个靠近这个文件系统的位置。长的文件路径名会产生一些不必要的错误或者警告。例如，将文件解压到 Windows® 上的 C:/IBM 或 Linux 上的 /opt/IBM。

转到 启动 Apache Tomcat 服务器。





回页首


启动服务器

您现在已经准备好启动 Apache Tomcat 服务器。

Apache Tomcat 已经安装到地址 JazzInstallDir/server/tomcat。这个 Web 应用软件 （jazz.war） 已经安装到 Apache Tomcat 地址 webapps 中。在一个常规窗口中，将您当前的地址设置为 JazzInstallDir/server。这个服务器的启动和关闭脚本都在这个地址中。

  • 如果您想要从任何其它地址运行这个启动和关闭脚本，您必须在 JazzInstallDir/server/provision_profiles 中更改 profiles.ini 文件，从而使用一个绝对路径。
  • 请看 修改 profile.ini 文件。
  • Apache Tomcat 的配置是使用文件 JazzInstallDir/server/tomcat/conf/server.xml 中的端口 9080 和 9443。如果需要的话，可以更改它们以适合您的系统。如果必要的话，还可以更新 Jazz 服务器的设置，Repository HTTP 端口在 Jazz Admin Web UI 的 Advanced Properties 配置页面中。
  • 地址 JazzInstallDir/server/tomcat/logs 包含这个服务器日志文件。如果您在启动这个服务器时出现问题，检查日志文件。

在 Windows 上启动服务器

运行启动文件从而在 Windows 上启动您的服务器。

  1. 要启动服务器，运行这个命令：
server.startup.bat

注意：会有一个独立的 Apache Tomcat 控制窗口打开。不要关闭这个窗口，否则这个服务器就会停止工作。另外，还有几个通知信息的启动器，包括一个关于 Apache Tomcat NatiLibrary 的消息也会停止。这些信息都不会影响 Jazz™ Team Server 的功能。

  1. 要关闭这个服务器，请运行这个命令：
server.shutdown.bat

注意：上面这个例子是直接从地址 JazzInstallDir/server 运行了启动和关闭脚本。如果您是使使用 IBM® Installation Manager 安装的 Jazz Team 服务器，那么您还可以从 Jazz Team Server Windows 开始菜单中运行这个命令。

在服务器上启动之后，转到 运行安装向导。

在 Linux 上启动服务器

运行这个启动文件可以在 Linux 上启动服务器。

  1. 启动服务器，就像用户根一样，运行这个命令: 
./server.startup

如果您的用户 ID 有管理员权限，就运行这个命令：

sudo ./server.startup

这是看不到一个独立的 Apache Tomcat 控制台窗口。您可以通过在 JazzInstallDir/server/tomcat/logs/catalina.out 中查看这个日志文件来检查这台服务器的启动过程。

  1. 要关闭服务器，也想用户根一样，运行这个命令：
./server.shutdown

如果您的用户 ID 拥有管理员权限，运行这个命令：

sudo ./server.shutdown

注意：这个例子是直接从地址 JazzInstallDir/server 运行启动和关闭脚本的。 如果您是通过使用 IBM Installation Manager 来安装的 Jazz Team Server，您还从 Jazz Team Server 应用软件开始菜单中运行这个命令。

当服务器启动之后，去到 运行安装向导。





回页首


运行安装向导

运行这个安装向导，验证这台服务器是正常运作的，并且指导您完成配置服务器的步骤。

要核实 Jazz™ Team Server 是与这个数据库连接着，可以查看日志或者控制台输出。这个连接和数据库信息在它的第一次访问就产生了共鸣。地址 JazzInstallDir/server/tomcat/logs 是这台服务器日志文件所使用的。

这个程序假设利用本地主机和默认端口 9443 时，您的服务器是可以使用的。如果需要的话，可以用您的服务器主机来取代本地主机和端口 9443 。

启动这个安装向导来配置您的服务器。可以利用 URL https://localhost:9443/jazz/setup。

默认的用户名和密码是有大小写区分的：

  • 用户名是 ADMIN。
  • 密码是 ADMIN。

如果您对这个 LDAP 地址 Web 容器进行了配置，就请用一个在您的 LDAP 地址中确定的 JazzAdmin 用户来登录。

选择一个安装路径。这个安装向导有两个主要路径。

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

注意：默认情况下，这个服务器配置是将 Derby 作为数据库。要使用另一个数据库，比如 DB2，就请选择自定义安装路径并完成步骤2：Configure Database。

当初始安装完成之后，可以通过利用 URL https://localhost:9443/jazz/admin 从 Jazz Team Server Admin Web 用户界面配置额外的选项。

如果这个服务器安装向导不能加载，请检查下面的项：

  • 验证这个应用服务器已经启动。使用这个 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。




回页首


完成安装

当这个服务器安装完成之后，您必须在继续操作之前考虑一些配置选项。

安装之后，需要进行几个额外的行为操作。

  • 有些文件含有密码。那些文件应该被保护，这样它们就成为只有拥有这个账户密码权限的用户才能查看的文件。
    • teamserver.properties —— Jazz™ Team Server 要求数据库密码保存在 JazzInstallDir/server/teamserver.properties 中。

当这些属性文件被保存时，这个应用软件通常会将相同地址中先前的版本进行备份。如果您想要清除所有包含明文密码的文件，就要在第一次配置服务器时清除这些备份属性文件。

  • 当把这台服务器与 Rational® Team Concert 客户端或者一个 Web 浏览器连接时，您应该可以看到安全认证的警告。要使警告无效，请看 Security certificates。
  • 您现在已经准备好将服务器连接到 Rational Team Concert 客户端或者一个 Web 浏览器。
  • 非强制性选项：Install the Build System Toolkit
  • 在在线帮助中浏览 Getting Started 话题。它们包含一些对服务器管理人员，小组成员，小组领导以及项目管理人员有用的工作。




回页首


解决服务器故障

您可以使用管理 Web 界面来解决服务的问题。

您必须登录到 Admin Web UI，而且必须是 JazzAdmins 小组的成员之一。

要检修服务器的问题，可以在 Admin Web UI 中点击 Server 键符。在这个页面，您可以找到服务器状态信息，可以帮助您解决问题。

提示：查看 Jazz.net Tech Notes 或者 Server troubleshooting FAQ，从而查找另外的故障处理提示。

下面这个表格列出了常见的一些问题和解决方案。

问题 需要检查的部分
数据库无法使用 检查服务器状态：点击 Status 概要。
  • 在 Status Summary 页面中的 Server Status 面板上，验证数据库的状态是连接的。如果这个状态无法使用，就要检查 Database Status 面板获取详细情况。失败的可能情况包括数据库配置无效，以及数据库的有效配置不能被初始化。
注意：Derby 数据库仅仅支持一个连接；如果另一个服务器实例正在运行，那么它可能仅仅使用一个数据库连接。如果这个问题发生了，那么 Service Error Summary 面板会列出多个错误。
  • 在 Server VM 面板中，验证这个服务器运行的是正确的 JDK。
  • 在 Service Error Summary 面板中，检查错误的信息。
无法更改配置属性 检查服务器配置属性：在 Configuration 下，点击下面的条目之一:
  • E-mail Settings
  • Database Connections
  • Feed Settings
  • License Key Management
  • Advanced Properties
在这些页面中，您可以查看和更新配置属性。当您将变更保存到配置属性中时，它们会传播到 teamserver.properties 文件中。如果这个数据库没有连接，您可以仅仅通过编辑 teamserver.properties 文件来更改配置属性。
故障服务 检查服务的状态：点击 Component Status。
在 Component Status 页面上，检查堆栈跟踪，从而获取更多关于故障服务的信息。
降低服务器的活动性 检查运行的服务：点击 Active Services。
在 Active Services 页面，检查运行的服务和它们的堆栈跟踪。检查在延长时间内运行的服务。
检查这个服务器的活动性：点击 Statistics。
在 Server Statistics 页面，检查这个服务器的活动性，比如 Web 服务的统计资料，异步任务，以及缓冲行为。

补充资源和提示

要获取更多的信息，您可以访问日志源:

  • 如果您运行的是一个安全连接，可以从这个位置访问这个日志源: 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

如果这个日志源无法使用，请从一个 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）或者一个备份文件中重新安装数据库。



参考资料

学习

获得产品和技术

讨论
  • 访问 Jazz.net 上的 Jazz 社区。并注册成为 Jazz.net 用户，您可以随时了解 Jazz 项目开发的最新进展，获取免费的 Jazz 平台软件及相关试用版软件下载。

  • 访问 Jazz Space。在 developerWorks 这个专门为 Jazz 平台准备的 Space 里，您将发现更多关于 Jazz 的技术资源和信息，包括博客、产品演示、RSDC 讲座、Podcast、Webcast，以及 基于 Jazz 的商用产品试用版下载等资源。

  • 参加 Rational 大学，与 IBM Rational 专家一起分享 Rational 产品最佳实践。

  • 查看 developerWorks 博客 并加入 developerWorks 社区。


关于作者

Jazz 是一个 IBM Rational 的开放商业软件开发项目，由 Jazz.net 社区维护。




对本文的评价










回页首


IBM 公司保留在 developerWorks 网站上发表的内容的著作权。未经IBM公司或原始作者的书面明确许可，请勿转载。如果您希望转载，请通过 提交转载请求表单 联系我们的编辑团队。
    关于 IBM      隐私条约      联系 IBM      使用条款