设置 WebSphere Application Server

本主题描述如何将 Jazz™ Team Server 设置为与 WebSphere® Application Server 一起工作。此设置假定您在 Websphere Application Server 所在的机器上安装 Jazz Team Server
开始之前
开始这些步骤之前,您应先完成下列操作:
提示: 使用 IBM® Installation Manager 时,Jazz Team Server 文件可以安装到 Web 应用程序目录。在安装过程期间,不应安装包括的 Apache Tomcat 应用程序服务器;这将使 Installation Manager 询问 Web 应用程序目录,并且仅安装 WebSphere 需要的文件。 缺省目录为 C:\Program Files\IBM\JazzTeamServer(在 Windows® 上)或 /opt/IBM/JazzTeamServer(在 Linux® 上)。 在此过程中,该安装目录称为 JazzInstallDir。如果您使用 IBM Installation Manager 将文件安装到 WebSphere Application Server Web 应用程序目录中,那么您不需要按照如上所述手动移动文件。
关于此任务
注: 本文档不教授 WebSphere 认证或 SSL 的配置,这是一个复杂的主题。WebSphere 信息中心中涉及了有关 WebSphere 的各种认证和加密选项的详细信息。有关更多信息,请转至 WebSphere 信息中心并搜索保护应用程序及其环境。 Jazz Web UI 要求配置认证以便执行授权以及个性化应用程序。
  1. 检查并更新 teamserver.properties 文件中的数据库位置。
    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
    注: 这是一个 DB2 配置样本。应根据数据库供应商 (Oracle/MS-SQL) 更新 teamserver.properties。
  2. 验证或更新 WebSphere Application Server 级别。

    Jazz Team Server 需要已应用 IBM Java SDK 1.5 SR5 或更高版本累积修订的 WebSphere Application Server V6.1,或者已至少安装 7.0.0.7 的 WebSphere Application Server V7.0。IBM Java SDK 1.5 SR6 SDK 更新可从 http://www-1.ibm.com/support/docview.wss?rs=180&uid=swg24017492 获取。如果使用 WebSphere 6.1 和 GA IBM Java SDK,在若干操作次数后 Jazz 将开始报告“代理错误”

    您必须获取与 IBM Java SDK 1.5 SR9 或 IBM Java SDK 1.6 SR4 的修订程序对应的 WebSphere Application Server i-fix,要使 IBM Rational Team Concert™ 2.0 正确运行,这些修订程序是必需的。否则,服务器中的部分服务可能不会正确启动。i-fix 可在其对应的 WebSphere Application Server APAR 下获取。对于 IBM Java SDK 1.5/WebSphere Application Server 6.1,APAR 为 PK85942,并且您可以从 ftp://ftp.software.ibm.com/software/websphere/appserv/support/fixes/PK85942/ 下载文件。安装 JRE i-fix 之前,先至少安装 WebSphere Application Server 6.1 修订包 19。对于 IBM Java SDK 1.6/WebSphere Application Server 7.0,APAR 为 PK 86771,并且您可以从 ftp://ftp.software.ibm.com/software/websphere/appserv/support/fixes/PK86771/ 下载文件。

  3. 更新 JVM 参数。

    Jazz Team Server 在用于运行自身的 Java 虚拟机上需要某些特定设置。

    通用 JVM 参数中需要设置的第一个属性是缺省最大内存分配,该属性使用 -Xmx 设置指定。应基于服务器支持的团队大小以及正在运行 Jazz Team Server 的服务器的内存容量进行设置。典型中等大小团队可使用值 -Xmx1536M,该值为 Jazz Team Server 进程提供 1536 MB 大小的堆内存。

    通用 JVM 参数中需要设置的第二个属性是线程堆栈大小,该属性专用于 Rational® Quality ManagerRational Quality Manager 的典型堆栈大小是 -Xss786K。

    如果您正在连接到 Oracle 数据库或 SQL Server 数据库,那么需要添加名为“ORACLE_JDBC”或“SQLSERVER_JDBC”的属性。 将属性设置为相应 JDBC 驱动程序的绝对文件路径(非 URL)。

    以下示例显示用于连接到 Oracle 数据库和 SQL Server 数据库的通用 JVM 参数,以及缺省最大内存分配和线程堆栈大小。将 JazzInstallDir 替换为您的 Jazz Team Server 安装目录。

    -DORACLE_JDBC=JazzInstallDir\server\oracle -Xmx1536M -Xss768k
    -DSQLSERVER_JDBC=JazzInstallDir\server\sqlserver -Xmx1536M -Xss768k

    还需要设置其他若干系统属性以控制特定服务器行为。以下包括了这些属性。以下是在 WebSphere 管理控制台中设置这些 JVM 属性的具体信息。将 JazzInstallDir 替换为您的 Jazz Team Server 安装目录:

    1. 单击服务器 > 应用程序服务器
    2. 单击 server1
    3. 单击 Java 和进程管理 > 进程定义
    4. 单击 Java 虚拟机
    5. 将值 100 添加到初始堆
    6. 将值 1000 添加到最大堆大小
    7. 单击应用
    8. 单击日志记录和跟踪。单击更改日志详细级别Jazz Team Server 使用 BIRT 报告引擎。要阻止 BIRT 参考条目写入 WebSphere 日志文件,对于 org.eclipse.birt.* 程序包,请将记录级别设置为严重。单击应用
    9. 单击定制属性 需要添加的定制属性之一是 JAZZ_HOME,这是一个系统属性,指定用于查找特定配置文件的位置。该属性使用 URL 而不是简单路径,因此应将值指定为 file:// 样式的 URL。
    10. 添加以下属性: 单击新建;输入名称;然后单击“确定”。
      • 名称:java.awt.headless :true
      • 名称:org.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin :true
      • 名称: JAZZ_HOME : file:///JazzInstallDir/server/conf
    11. 单击保存可直接保存到主配置。
    要点: 仅适用于 Solaris,还必须添加以下 Java 命令行参数:
    -XX:MaxPermSize=256m
    有关其他信息,请参阅 IBM WebSphere Application Server V6.1 on the Solaris 10 Operating System 红皮书的第二章“Configuring a Solaris environment for WebSphere Application Server”。
  4. 重新启动 Websphere 以安装 Jazz 应用程序
    在以下命令行示例中,WASInstallDir 表示在服务器上安装 WebSphere Application Server 的位置。
    • 在 Windows 上,WebSphere 安装目录的缺省值是:
      C:\Program Files\IBM\WebSphere\AppServer
      您可以通过以下命令在 Windows 上重新启动服务器:
      cd WASInstallDir\bin 
      stopServer.bat server1 [for a secure server, include: -username {LDAP_User} -password {LDAP_Password}] 
      startServer.bat server1
    • 在 Linux 上,WebSphere 安装目录的缺省值是:
      /opt/IBM/WebSphere/AppServer
      您可以通过以下命令在 Linux 上重新启动服务器:
      cd WASInstallDir/bin
      ./stopServer.sh server1 [for a secure server, include: -username {LDAP_User} -password {LDAP_Password}] 
      ./startServer.sh server1
    1. 打开 WebSphere Application Server 的管理控制台。
    2. 单击应用程序 > 安装新应用程序
    3. 新应用程序的路径下,单击“本地文件系统”。
    4. 完整路径下输入:
      JazzInstallDir/server/jazz.war
    5. 上下文根设置为 /jazz。
    6. 单击下一步并继续执行安装新应用程序的其余步骤。
    7. 单击完成
    8. 单击保存可直接保存到主配置。
    9. 单击应用程序 > 企业应用程序
    10. 选择 jazz_war 旁边的框;并单击启动

      应显示绿色箭头指示已成功启动应用程序。

下一步做什么
服务器启动后,继续运行安装向导

有关该主题的更多信息,请访问以下链接:

http://jazz.net/library/techtip/95

https://jazz.net/wiki/bin/view/Main/WASSetupFAQ


反馈