安装可选软件

Rational® Performance Tester 的安装映像包含下列可选软件:

安装 Agent Controller

Agent Controller 是一个守护程序,它允许客户机应用程序启动和管理本地或远程应用程序,并向其他应用程序提供关于正在运行的应用程序的信息。您必须先单独安装 Agent Controller,然后才能使用以下工具:

注:

硬件先决条件

注:
对于 Rational Performance Tester,Agent Controller 应该通过使用 Installation Manager 安装在 Windows® 和 Linux® 系统上。

受支持的平台

Agent Controller V7.0.1 受以下平台支持:

受支持的 JVM

IBM Java™ SDK V5:

查找安装文件

安装文件在 Agent Controller 光盘上的下列目录中:

在 AIX 工作站上安装 Agent Controller

注:
对于 Rational Performance Tester,Agent Controller 应该通过使用 Installation Manager 安装在 Windows 和 Linux 系统上。

卸载先前版本的 Agent Controller

注:
在安装 Agent Controller V7.0.1 之前,必须卸载先前版本的 Agent Controller:

当卸载 AIX 平台上的 Agent Controller V6.x 或 V7.x 时,您将需要手动除去任何残留文件。要执行此操作,请停止 Agent Controller 并将其卸载,然后清理卸载后可能留下的以下任何文件:

AIX:

$RASERVER_HOME/*(Agent Controller 的安装目录)
/usr/lib/libLogAgent.so
/usr/lib/libhcbnd.so
/usr/lib/libhcclco.so
/usr/lib/libhccldt.so
/usr/lib/libhccls.so
/usr/lib/libhcclserc.so
/usr/lib/libhcclsert.so
/usr/lib/libhcclsm.so
/usr/lib/libhcjbnd.so
/usr/lib/libhclaunch.so
/usr/lib/libhcthread.so

配置操作系统环境

请执行以下命令来设置必需的环境变量:

PATH={path to java installation}/jre/bin:$PATH
export PATH
LIBPATH={path to java installation}/jre/bin: {path to java installation}/jre/bin/
    classic:$LIBPATH
export LIBPATH
注:
设置环境变量后,命令“java -fullversion”可用来验证 Java 版本。

安装 Agent Controller

  1. 以 Administrator(或 root)用户身份登录。
  2. 将目录切换到解压了相应平台的安装文件的目录。
  3. 在继续安装之前关闭所有 Eclipse 平台。
  4. 运行 setup.bin
  5. 单击欢迎屏幕上的下一步继续安装。
  6. 阅读许可协议。
  7. 选择我接受许可协议中的条款,并单击下一步继续安装。
  8. 指定将要安装 Agent Controller 的位置,并单击下一步继续安装。
  9. 指定 Java 运行时环境(JRE)可执行程序 java.exe 或 Agent Controller 将要使用的 java 的路径。此处输入的 JRE 将由 Agent Controller 用来启动 Java 应用程序。因此,您可能要更改安装程序预填的 JRE 路径。
    注:
    您此时提供的 JRE 既用来运行 Agent Controller,也将由 Agent Controller 用来启动 Java 应用程序。但是,稍后您可能要配置 Agent Controller 来对这些功能中的每一项功能使用独立的 JRE。有关详细信息,请参阅 Agent Controller 帮助主题配置要由 Agent Controller 启动的应用程序

    单击下一步继续安装。

  10. 可选:如果在上面的第 9 步中选择了“WebSphere Application Server 的远程支持”,请指定 IBM WebSphere Application Server 的版本。单击下一步继续安装。
  11. 可选:如果在上面的第 9 步中选择了“WebSphere Application Server 的远程支持”,请指定 IBM WebSphere Application Server V5.0(仅 Windows)和 V5.1 的路径。单击下一步继续安装。
  12. 指定哪些主机可以访问 Agent Controller。对于 Rational Performance Tester,必须选择特定计算机。单击下一步继续安装。
  13. 接受安全性设置的缺省值(禁用)。单击下一步继续安装。
  14. 单击摘要屏幕上的下一步,安装 Agent Controller。
  15. 安装完成之后单击完成

静默安装 Agent Controller

您可以对安装命令使用以下参数来运行静默安装过程:

参数 描述

-silent

如果使用静默安装,则需要此变量。

-V licenseAccepted=true
可选:告诉安装程序静默运行,否则将出现一个显示已输入内容的安装向导。

-P installLocation
可选:指定安装路径。缺省安装路径为“$D(install)/IBM/AgentController”。

示例:

对于 Windows:C:\Program Files\IBM\AgentController

对于 UNIX/Linux:/opt/IBM/AgentController

-V VJavaPath
必需:指定 Java 可执行文件的标准路径

-V VAccessLocal

-V VAccessCustom

-V VAccessAll

可选:指定客户机与 Agent Controller 之间的连接方式(ALL、LOCAL 和 CUSTOM)。仅将以下变量中的一个设置为 true,其他设置为 false。缺省情况下,VAccessAll="true"

  • 任何计算机:           VAccessAll="true"           :允许任何客户机
  • 仅此计算机: VAccessLocal="true"       :仅允许本地主机 (缺省值)
  • 特定计算机:   VAccessCustom="true"    :允许一组客户机 (也需要 -V VHosts 参数)

-V VHosts
必需,如果 VAccessCustom="true"

指定客户机主机名,用逗号分隔

必须同时指定以下两个变量,并且应该设置为相反的值:

-V VSecurity="true" or "false"
-V VSecurityDisable="false"
 or "true"
可选:(true,false)

缺省值:

VSecurity=true
VSecurityDisable=false

-V VUsers
必需:如果 VSecurity="true"

指定哪些用户可以连接到 Agent Controller

-V VWAS6

-V VWAS5
可选:

-V VWAS6="true"(缺省值):如果使用 WAS V6

-V VWAS5="true":如果使用 WAS V5.x

-V VWAS_HOME_V50

-V VWAS_HOME_V51
可选:如果 -V VWAS5="true"

指定 IBM WebSphere Application Server 5.1 和 5.0 的安装位置

示例:

从命令行执行安装:

-P installLocation="D:\IBM\AgentController"

-V VJavaPath=" D:\jdk1.4.2\jre\bin\java.exe "

-V VAccessLocal="false"

-V VAccessCustom="true"

-V VAccessAll="false"

-V VHosts="host1,host2"

-V VSecurity="true"

-V VSecurityDisable="false"

-V VUsers="user1,user2"

-V VWAS5="true"

-V VWAS_HOME_V51="D:\WebSphere5.1\AppServer"

-V VWAS_HOME_V50="D:\WebSphere5.0\AppServer"

使用响应文件执行安装:

您可以创建一个响应文件(例如 setup.rsp)来存储所有参数,而不是对命令行指定这些参数。以下是 Windows 示例:Linux/UNIX 平台与此类似:

setup.exe -silent -options setup.rsp

响应文件的内容:

      # Start of response file

-P installLocation="D:\IBM\AgentController"

-V licenseAccepted="true"

-V VJavaPath=" D:\jdk1.4.2\jre\bin\java.exe "

-V VAccessLocal="false"

-V VAccessCustom="true"

-V VAccessAll="false"

-V VHosts="host1,host2"

-V VSecurity="true"

-V VSecurityDisable="false"

-V VUsers="user1,user2"

-V VWAS5="true"

-V VWAS_HOME_V51="D:\WebSphere5.1\AppServer"

-V VWAS_HOME_V50="D:\WebSphere5.0\AppServer"

 
      # End of response file

启动和停止 Agent Controller

卸载 Agent Controller

  1. 从安装位置的 _uninst 目录(例如,/opt/IBM/AgentController/_uninst)运行 uninstall.bin 程序。
  2. 遵循屏幕上的指示信息来完成卸载。
  3. 要执行静默卸载,请使用命令 uninstall.bin -silent

卸载在工作站上有多个引用的 Agent Controller

Agent Controller V7.0.1 阻止产品的多个实例安装在一个工作站上。当执行更多安装时,无论是独立安装还是作为产品内部的嵌入式安装,Agent Controller 会记录对正在启动新安装的产品名的引用。

如果 Agent Controller 已安装了多次 — 即存在多个引用计数 — 则无论是独立安装还是作为产品内部的嵌入式安装,它都只能在卸载了最后一个引用产品后才能卸载;最后一个引用产品仍旧需要 Agent Controller。

如果您尝试在其他产品仍旧需要 Agent Controller 时卸载 Agent Controller,卸载不会进行,您将收到一条消息“无法卸载该产品,因为其他产品需要该产品”。

在 z/OS(OS/390®)上安装 Agent Controller

卸载先前版本的 Agent Controller

如果有先前版本的 Agent Controller,请先停止并卸载它,然后安装此版本的 Agent Controller。

配置操作系统环境

  1. 创建 RAC 的安装目录。例如:mkdir /u/rpt/IBM/RAC。
  2. 设置 ASSIZEMAX=2147483647。此操作可能需要系统程序员的支持。
  3. 将以下导出命令添加到用于启动 RAC 的用户标识的 .profile 中:
    export RASERVER_HOME={install location}
    export LIBPATH=$LIBPATH:{install location}/lib:{path to java installation}/bin:
        {path to java installation}/bin/classic
    export PATH=$PATH:{install location}/bin:{path to java installation}/bin
    export _BPX_SHAREAS="NO"
注:
设置环境变量后,命令“java -fullversion”可用来验证 Java 版本。

安装 Agent Controller

  1. 在 UNIX® System Services shell 中,转至要安装 Agent Controller 的目录。建议您将它安装在 /usr/lpp/ 目录中。
  2. 将安装映像 ibmrac.os390.paxtptpdc.os390.pax 传送到安装目录中。
  3. 发出以下命令解压 Agent Controller 文件:

    pax -ppx -rvf ibmrac.os390.pax
  4. 发出以下命令解压测试和性能工具(TPTP)Agent Controller 文件:

    pax -ppx -rvf tptpdc.os390.pax
  5. 在 UNIX System Services shell 中发出以下命令使 Agent Controller 共享的对象文件程序成为受控文件:

    extattr +p /usr/lpp/IBM/AgentController/lib/*.so

    如果要安装本地语言包,请完成下面的步骤 7 和步骤 8。如果不安装本地语言包,请继续执行步骤 9。

  6. 将 NL 安装映像 tptpdc.nl1.os390.pax、tptpdc.nl2.os390.pax、ibmrac.os390.nl1.pax 和 ibmrac.os390.nl2.pax 传送到安装目录中。
  7. 发出以下命令解压 Agent Controller 文件:

    	pax -ppx -rf tptpdc.nl1.os390.pax
    	pax -ppx -rf tptpdc.nl2.os390.pax
    	pax -ppx -rf ibmrac.os390.nl1.pax
    	pax -ppx -rf ibmrac.os390.nl2.pax
  8. 在 Agent Controller 之后,将目录切换到安装位置的 bin 目录 /usr/lpp/IBM/AgentController/bin,并通过输入以下命令运行安装脚本:

    ./SetConfig.sh
  9. 遵循屏幕上的提示来配置 Agent Controller。

启动和停止 z/OS(OS/390)上的 Agent Controller

注:RAServer 需要将包含可执行文件库(例如 libjvm.so)的 JRE 目录添加到 LIBPATH 环境变量中。例如,如果您正在使用 IBM JRE 1.4.1,则 LIBPATH 变量将设置如下:

export LIBPATH=/usr/lpp/java/IBM/J1.4/bin/classic:
/usr/lpp/java/IBM/J1.4/bin:$LIBPATH

卸载 z/OS(OS/390)上的 Agent Controller

使用代理控制器的安全性功能

以下列表包含有关在所有平台上使用代理控制器安全性功能的提示与技巧:

工作台/Agent Controller 兼容性摘要

向后兼容性(将较早版本的工作台与 V6.0.1 Agent Controller 一起使用):二者是兼容的,因为新的 Agent Controller 支持先前版本中的所有功能(例如,控制通道上的“安全性”)。但是,您将不能使用包括多路复用(通过控制通道返回数据,使其尽可能安全)在内的新功能。

向前兼容性(将 6.0.1 工作台与较早版本的 Agent Controller 一起使用):一般情况下不支持向前兼容性。

跨版本的 Agent Controller 间的兼容性:一些产品或工具(例如 IBM Performance Optimization Toolkit)要去多个主机(除了工作台以外)上的 Agent Controller 能彼此“发现”和通信。从一个版本到下一个版本围绕此功能所作的更改表示,如果您需要使用此功能,则必须在所有涉及的主机上使用 Agent Controller V6.0.0.1 或 Agent Controller V6.0.1。即,在各 Agent Controller 实例之间使用动态发现时不能混合使用各版本和将各版本进行匹配。

已知问题和局限性

本节说明了与安装和卸载 Agent Controller 有关的已知问题和局限性。除非另有声明,否则以下信息适用于支持 Agent Controller 的所有操作系统。

Agent Controller 可能无法在非 Windows 平台上启动

Agent Controller 可能无法在非 Windows 平台上启动,并带有以下消息:

RAServer failed to start.

当 TCP/IP 端口 10002 不处于空闲状态时,通常会导致该故障。Agent Controller 在缺省情况下侦听此端口。在启动 Agent Controller 时系统上运行的另一进程可能正在使用此端口;或者也可能是 Agent Controller 刚刚停止,随即在端口释放之前重新启动。

如果 Agent Controller 未能启动,可以按如下指示来启动它:

安装和卸载过程中的其他错误

如果在安装和卸载过程中遇到错误,这可能是由于 Agent Controller 的对象文件是由正在运行的进程装入的。要确保可以修改对象文件,请执行以下操作:

  1. 关闭 Eclipse 工作台。
  2. 终止包含 Java 概要分析代理程序或 J2EE 请求概要分析程序的所有 java.exe 进程。

安装 ClearCase LT

Rational ClearCase LT 是供小型项目团队使用的配置管理工具。ClearCase LT 是 IBM Rational ClearCase 产品系列的一部分,此产品系列既能满足小型项目工作组的要求,也能满足分支机构遍布全球的企业的要求。

您的安装介质包含 Rational ClearCase LT V7.0.1。它是从 Rational Performance Tester 中独立安装的。

如果在工作站上已安装 ClearCase LT,则可以将其升级到当前版本。有关从先前版本升级 ClearCaseLT 的信息,请参阅此产品的安装文档。

要使 Rational Performance Tester 能够与 ClearCase LT 配合工作,必须安装 Rational ClearCase SCM 适配器功能部件。缺省情况下,此功能部件是在您安装 Rational Performance Tester 时安装的。但是,如果未安装此功能部件,则以后可以使用 IBM Installation Manager 的“修改软件包”向导进行安装。有关详细信息,请参阅修改安装版本

在使用 Rational ClearCase SCM 适配器之前,必须将其启用。有关启用和使用此适配器的详细信息,请参阅联机帮助。

查找 ClearCase LT 安装说明和发行说明

有关安装 Rational ClearCase LT 的完整说明,请参阅 ClearCase LT 安装介质附带提供的安装文档。在安装本产品之前,强烈建议您阅读 ClearCase LT 发行说明。

某些文档处于 Acrobat® PDF 文件中。要打开文件,您需要 Adobe® Reader 软件,您可以从 http://www.adobe.com/products/acrobat/readstep2.html 下载该软件。

对于 Windows。可以从 ClearCase LT 安装启动板中查看安装说明和发行说明。请参阅开始安装 Rational ClearCase LT

要打开安装说明:

从 IBM 出版物中心获取文档

也可以从 IBM 出版物中心下载 Rational ClearCase LT 的安装说明和发行说明。

  1. 访问以下地址:http://www.ibm.com/shop/publications/order
  2. 在“出版物中心”的欢迎页面上选择您所在的国家/地区。
  3. 单击“搜索出版物”。
  4. 在相应的搜索字段中输入文档标题或出版物编号。
    表 2. ClearCase 出版物编号
    文档 出版物编号
    IBM Rational ClearCase, ClearCase MultiSite®, and ClearCase LT Installation and Upgrade Guide (Windows) GI11-6365-00
    IBM Rational ClearCase, ClearCase MultiSite, and ClearCase LT Installation and Upgrade Guide (UNIX) GI11-6366-00
    IBM Rational ClearCase LT Release Notes® GI11-6369-01

开始安装 Rational ClearCase LT

本节中的安装说明旨在帮助您启动 Rational ClearCase LT 的安装过程。安装此产品时,您必须参阅 Rational ClearCase LT Installation Guide 中的完整安装说明。在开始进行安装前,强烈建议您阅读发行说明。

开始在 Windows 上安装 Rational ClearCase LT

  1. 使用以下某种方法启动 Rational ClearCase LT 启动板程序:
  2. 如果您尚未阅读发行说明,请阅读该信息。
  3. 单击安装 IBM Rational ClearCase LT。 将打开 Rational ClearCase LT 安装向导。

请按照安装向导中的说明执行操作,以完成安装过程。

在 Linux 上安装 Rational ClearCase LT

IBM Rational ClearCase, ClearCase MultiSite, and ClearCase LT Installation Guide, 7.0, Linux and UNIX 文档中提供了关于在 Linux 工作站上安装 Rational ClearCase LT V7.0 的完整说明,您可从 600 下载此文档。

配置 Rational ClearCase LT 许可证发放功能

在 Rational ClearCase LT 所在的计算机上安装 Rational Performance Tester 之后,不需要配置 Rational ClearCase LT 许可证发放功能。但是,如果在未安装 Rational Performance Tester 的情况下安装 Rational ClearCase LT,则需要配置 ClearCase LT 许可证发放功能。

请参阅 ClearCase LT Installation Guide 以获取有关配置许可证的详细信息。