欢迎使用 IBM(R) Performance Optimization Toolkit 6.1.2 for Rational(R) Performance Tester。本指南包含有关安装和设置工具包的信息。
可在工具包的发行说明中找到更多关于限制和变通方法的最新发布信息。
IBM Performance Optimization Toolkit 需要先安装 Rational Performance Tester 产品。该工具包提供以下功能部件:
在安装工具包之前,必须安装以下硬件。这些数据假设您还会在同一机器上安装数据收集体系结构:
以下是在与安装工作台不同的机器上安装数据收集体系结构所需的最小硬件需求:
在安装工具包的更新之前,必须安装以下软件:
注:如果已安装了这些产品中某一产品的 V6.x.0,请使用 Rational Product Updater 更新到 V6.x.1。
注:如果从头开始安装,请只安装工具包的工作台部分,不安装数据收集体系结构。如果已经安装了 V6.1 工具包的数据收集体系结构,则必须卸载它,然后再安装 V6.1.2 数据收集体系结构。
重要信息:在安装工具包之前,请先卸载所有 Beta 版本的 Rational Performance Analyst 和 Rational Performance Tester,然后安装以上列出的相应的 Rational Software Development Platform 产品。
请在您要从中收集数据的分布式应用程序涉及的所有主机上安装数据收集体系结构。此外,还建议(并且某些场景要求)在已安装工具包的本地机器上安装数据收集体系结构。
Linux 注释:数据收集体系结构的 Hyades 数据收集引擎功能部件是使用 libstdc++-libc6.2-2.so.3 共享库编译的。确保此共享库位于 /usr/lib 目录下面。如果不存在该库,则必须安装随操作系统安装介质一起提供的 RPM 数据包 compat-libstdc++。
已在以下平台上测试数据收集体系结构:
尚未经过测试,但是预计可在 Red Flag Advance Server V4.0 on Intel IA32 上运行。
总体而言,数据收集体系结构可以使用 JVM V1.4 和更高版本。以下是已测试数据收集的 JVM 版本(java -fullversion):
工具包收集分布式应用程序的性能概要分析数据,并将其发送到查看和分析所收集数据的工作台。您可以查询 Tivoli Monitoring for Transaction Performance(TMTP)、IBM Tivoli Composite Application Manager for Response Time Tracking(ITCAM for RTT)或 IBM Tivoli Composite Application Manager for WebSphere(ITCAM for WebSphere)管理服务器数据库,为某个部署在生产环境中的应用程序收集过去的性能数据。使用 IBM Performance Optimization Toolkit for Rational Performance Tester,还可以在开发或测试环境中监控活动的应用程序并实时收集它的数据。
在生产环境中,可以通过查询以下系统管理软件的管理服务器数据库来收集数据:
对于活动的 Web 应用程序,数据收集体系结构从以下 Web 服务器收集性能概要分析数据:
关于安装这些产品的完整指示信息,请参阅安装指南。以下安装指示信息包含关于如何配置这些产品以用于数据收集体系结构的信息。
在安装工具包之前,请检查环境变量 TEMP 或 TMP 是否正在指向一个至少具有 100 MB 可用空间的有效临时目录。这是除安装产品所需空间之外的可用空间。
要求预先安装的 V6.x.0 工具包及其安装指示信息可从以下 Web 站点获取:
要将工具包升级到 V6.x.1:
安装期间发生错误 - 用户已取消安装
在这种状态下试图卸载工具包时,可能会收到以下错误信息:
找不到合适的 JVM。请使用选项 -is:javahome <JAVA HOME DIR> 再次运行程序。
为解决此问题,必须再次重新运行安装程序来完成先前取消的修改,然后继续卸载工具包。
工具包是作为已安装的 Rational Software Development Platform 产品(Rational Performance Tester、Rational Application Developer 或 Rational Software Architect)的附加品安装的。要使用工具,请以常规方式启动此程序。例如,从开始菜单选择程序 > IBM Rational > Rational Software Development Platform。
在安装之后第一次启动时,可能会打开一个对话框,其中已指定了缺省的工作空间目录。如果要将工作保存在其他地方,则可以更改工作空间的名称和位置。 如果您希望始终使用此工作空间,请启用将此项作为缺省值使用且不再询问复选框。在窗口 > 首选项 > 工作台 > 启动和关闭页面中启动产品之后可以更改缺省值。
工作台可能会首先打开一系列给出产品概述的欢迎页面,其中包括关于工具包的概述信息、关于新增功能的信息,以及到基本产品的教程、样本和外部 Web 资源的链接。请花些时间浏览这些选项。另外,还要注意“帮助”菜单中所提供的信息来源。可以通过选择帮助 > 欢迎返回到这些欢迎页面。
注:如果已经安装了数据收集体系结构,则必须先卸载它,然后才能卸载工具包。关于指示信息,请参阅卸载数据收集体系结构。
要卸载工具包:
注:如果已经更新到 V6.X.1 但没有单击清除按钮,则可以避免此步骤。如果没有执行清除步骤,则:
rpu -enableRollback
如果您尝试部分卸载一个或多个必需的功能部件,将收到与此类似的错误消息:
选择无效: 无法卸载 ide_required:没有为卸载设置根目录
为解决此问题,请选择卸载向导中的产品卸载复选框。将重新初始化卸载面板,以便现在可以完全卸载工具包或清除对不想卸载的功能部件的选择。
在安装工具包之前,请检查以下各项:
要求预先安装的 V6.x.0 工具包及其安装指示信息可从以下 Web 站点获取:
要将工具包升级到 V6.x.1:
现在必须安装数据收集体系结构。关于指示信息,请参阅安装数据收集体系结构。
如果您重新运行安装程序以添加其他功能部件并选择在运行完成之前取消修改,则可能接收到以下错误:
安装期间发生错误 - 用户已取消安装
在此状态下尝试卸载产品时,可能接收到以下错误:
找不到合适的 JVM。请使用选项 -is:javahome <JAVA HOME DIR> 再次运行程序。
为解决此问题,必须再次重新运行安装程序以完成先前取消的修改,然后继续卸载产品。
有两种方法可避免此问题。第一种方法(也是推荐的方法)是将 RHEL 3 系统从 Red Hat 更新到 Quarterly Update 2 或更高版本。Update 2 能够对出故障的 pthread 库进行修订。
此外,另一种方法(仅当不使用 Update 2 时才建议使用此方法)是将安装程序切换到在 LinuxThreads 下运行。LinuxThreads 不显示此故障,可用于运行安装程序。要为安装程序启用 LinuxThreads,必须在将要运行安装程序的 shell 中设置两个环境变量。
运行以下两个命令:
export RPM_FORCE_NPTL=1 export LD_ASSUME_KERNEL=2.4.19
要验证变量是否已设置,运行以下命令:
env | grep RPM_FORCE_NPTL env | grep LD_ASSUME_KERNEL
这两个命令将返回变量以及在 export 命令中输入的值。然后照常进行安装。
工具包是作为已安装的 Rational Software Development Platform 程序(例如,Rational Performance Tester 或 Rational Application Developer)的附加品安装的。要从命令行启动 Software Development Platform,请转至安装目录并运行命令 ./rationalsdp.bin。
或者,如果正在 Gnome(它是 Red Hat 在缺省情况下使用的界面)中运行,则产品快捷方式将位于程序 > Rational Software Development Platform 下的主菜单上。如果正在 KDE(它是 SuSE 在缺省情况下使用的界面)中运行,则产品快捷方式将为 IBM Rational > Rational Software Development Platform。
在安装之后第一次启动时,可能会打开一个对话框,其中已指定了缺省的工作空间目录。如果要将工作保存在其他地方,则可以更改工作空间的名称和位置。 如果您希望始终使用此工作空间,请启用将此项作为缺省值使用且不再询问复选框。在窗口 > 首选项 > 工作台 > 启动和关闭页面中启动产品之后可以更改缺省值。
工作台可能会首先打开至一系列欢迎页面,提供产品概述和有关新增内容的信息,以及到教程、样本和外部 Web 资源的链接。请花些时间浏览这些选项。另外,还要注意“帮助”菜单中所提供的信息来源。可以通过选择帮助 > 欢迎返回到这些欢迎页面。
注:如果已经安装了数据收集体系结构,则必须先卸载它,然后才能卸载工具包。关于指示信息,请参阅卸载数据收集体系结构。
要在 Linux 上卸载工具包,请遵循下列步骤:
注:如果已经更新到 V6.X.1 但没有单击清除按钮,则可以避免此步骤。如果没有执行清除步骤,则:
rpu.bin -enableRollback
如果您尝试部分卸载一个或多个必需的功能部件,将收到与此类似的错误消息:
选择无效: 无法卸载 ide_required:没有为卸载设置根目录
为解决此问题,选择产品卸载复选框。将重新初始化卸载面板,以便现在可以完全卸载工具包或清除对不想卸载的功能部件的选择。
必须在运行应用程序(正在监视该应用程序,您要从中收集性能数据)所涉及的所有机器上安装数据收集体系结构。然后必须在那些机器上配置应用程序服务器来启用对其应用程序的概要分析。而且,要通过性能测试或装入测试调度收集数据,还必须在安装工具包前端的同一台机器上安装数据收集体系结构。
重要说明:
较早版本的 Agent Controller 已随较早的 IBM 产品提供,可驻留在从中收集数据的主机上。动态发现是数据收集“搜寻”分布式应用程序使用的主机并与每台主机上的 Agent Controller 联系的过程。如果分布式应用程序使用的某台主机上有较早版本的 Agent Controller,动态发现将在该主机上停止,直至事务越过该主机移动到使用的下一台主机后才继续通过该主机。 要修正此问题,可通过在应用程序使用的所有主机上卸载 Agent Controller 并安装数据收集体系结构来更新这些主机上的 Agent Controller 的版本。
数据收集体系结构与其他基于 Hyades 的数据收集机制冲突。如果具有先前版本的 Agent Controller 或从 Hyades 数据收集引擎获得的任何软件,则先停止它并接着卸载,并清除任何剩余的文件,然后才安装此版本的 Agent Controller。在卸载之后,可能还会保留以下文件,必须除去这些文件:
Windows:
%RASERVER_HOME%\*.*(Agent Controller 的安装目录) %SystemRoot%\system32\piAgent.dll(Windows 的 system32 目录) %SystemRoot%\system32\LogAgent.dll %SystemRoot%\system32\hcbnd.dll %SystemRoot%\system32\hcclco.dll %SystemRoot%\system32\hccldt.dll %SystemRoot%\system32\hccls.dll %SystemRoot%\system32\hcclserc.dll %SystemRoot%\system32\hcclsert.dll %SystemRoot%\system32\hcclsm.dll %SystemRoot%\system32\hcjbnd.dll %SystemRoot%\system32\hclaunch.dll %SystemRoot%\system32\hcthread.dll %SystemRoot%\system32\piAgent.dll %SystemRoot%\system32\rac.dll %SystemRoot%\system32\sysperf.dllLinux、AIX、HP-UX 和 Solaris:
$RASERVER_HOME/*(Agent Controller 的安装目录) /usr/lib/libpiAgent.so(或 .sl,在 HP-UX 上) /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
关于完整的卸载指示信息,请参阅随 Agent Controller 或其他您已安装的基于 Hyades 的数据收集机制提供的卸载指示信息。
注:在 Windows Server 2003 机器上使用长路径或带有空格的路径安装数据收集体系结构时会间歇性地出现已知问题。如果可能,请避免使用这样的目录。这不仅适用于目标安装目录,也适用于源安装目录。
要安装数据收集体系结构:
注(Linux):如果您在启动安装程序或启动剩余部分的安装时遇到问题,则可能需要设置所涉及文件的执行权限。请从已下载并解压缩映像的临时目录运行以下命令:
chmod 755 setup.bin chmod 755 setup/lplinuxbin chmod 755 dci_linux/disk1/setup/setup.bin
注:如果数据收集体系结构与 Rational Software Development Platform 产品(例如 Rational Application Developer 或 Rational Performance Tester)安装在同一台机器上,则必须在与此产品安装 Agent Controller 相同的位置中安装数据收集体系结构。
单击下一步。
单击下一步。
注:如果您在此阶段的安装过程中遇到了错误,并且已经从 Rational Application Developer 产品安装了 Agent Controller,请退出安装,卸载 Agent Controller(请遵循 Rational Application Developer 安装指南中的指示信息),然后再次尝试安装数据收集体系结构。
下一步是配置应用程序服务器以使用数据收集体系结构。
要安装数据收集体系结构:
/installDCIComponents.sh -console
在安装过程中发生的任何错误都将显示在控制台上。错误消息将指示安装错误日志文件的名称,您可以从中获取更多关于所发生事件的信息。某个阶段中的错误将使安装停止,且不会安装下一个组件。
重要说明(如果您要在 HP-UX 上使用 WebSphere Application Server V6.x):安装数据收集体系结构后,请确保设置了 SHLIB_PATH。否则,可能无法收集事务数据,ARM 中将报告 NoClassDef 错误。要设置 SHLIB_PATH,请运行以下命令:
export SHLIB_PATH=$(SHLIB_PATH):$tivoli_comp/app/instrument/5301/lib/$(interp):$tivoli_comp/bin/$(interp)/USRLIB
下一步是配置应用程序服务器以使用数据收集体系结构。
为使应用程序服务器能正确地将性能数据发送到数据收集体系结构,在开始使用数据收集之前必须正确配置并重新启动它。
注:
要配置应用程序服务器:
当停止服务器然后再重新启动它时,更改将生效。
对机器(将进行概要分析的应用程序的所有数据收集所涉及的机器)上的每个服务器重复这些配置步骤(通常,只有一个应用程序服务器,但有可能在一台机器上具有多个应用程序服务器)。
要查看 instrumentServer 命令的语法,请不带任何参数输入该命令:
AIX、HP-UX、Linux 和 Solaris:
./instrumentServer.shWindows:
instrumentServer
示例:
在非 Windows 机器上,要配置安装在目录 /opt/WebSphere/AppServer 中的名为 server1 的 IBM WebSphere Application Server V5.x 服务器(未启用安全性):
./instrumentServer.sh -install -type IBM -serverName server1 -serverHome /opt/WebSphere/AppServer -serverVersion 5在非 Windows 机器上,要配置安装在目录 /opt/WebSphere/AppServer 中的名为 server2 的 WebSphere Application Server V6.0 服务器(概要文件名为 profile1 且启用了安全性):
./instrumentServer.sh -install -type IBM -serverName server2 -serverHome /opt/WebSphere/AppServer -profileName default -user myUserId -password myPassword -serverVersion 6在非 Windows 机器上,要配置 BEA WebLogic 服务器(具体细节如下所示):
./instrumentServer.sh -install -type BEA -serverName server1 -serverHome /opt/bea/weblogic81 -domain mydomain -domainPath /opt/bea/weblogic81/mydomain -javaHome /opt/bea/jdk141_02 -nodeManagedHost hostname.xyz.com -nodeManagedPort 7001 -adminServer my_server -startScript /opt/bea/weblogic81/mydomain/startManagedWeblogic.sh在 Windows 机器上,要配置安装在 C:\Program Files\was-5.1 中的名为 my_Server 的 WebSphere Application Server V5.1 服务器(启用了安全性):
instrumentServer -install -type IBM -serverName my_Server -serverHome "C:\Program Files\was5.1" -user myUserId -password myPassword -serverVersion 5在 Windows 机器上,要配置 BEA WebLogic 服务器(具体细节如下所示):
instrumentServer -install -type BEA -serverName server1 -serverHome C:\bea\weblogic81 -domain mydomain -domainPath C:\bea\weblogic81\mydomain -javaHome C:\bea\jdk141_02 -nodeManagedHost localhost -nodeManagedPort 7001 -adminServer my_server -startScript C:\bea\weblogic81\mydomain\startManagedWeblogic.cmd
必须启动数据收集体系结构以从正在运行的应用程序和测试收集性能数据。
启动数据收集体系结构时会启动 Agent Controller 组件;在启动数据收集体系结构前停止其他 Agent Controller 实例是很重要的。出于此原因,如果正在使用 Rational Performance Tester,则在启动 Rational Performance Tester 前必须在本地机器上启动数据收集体系结构(其他原因下则启动 Agent Controller)。
在支持它的那些平台上,将在主启动菜单(例如,Windows 上的开始菜单)上生成一些用于启动和停止数据收集体系结构的条目。例如,在 Windows 上单击开始 > 程序 > IBM Rational > IBM Rational Software Development Platform > 启动数据收集体系结构或停止数据收集体系结构。
否则,要启动数据收集体系结构:
如果要在 WebSphere Application Server 上收集 Web service 数据,请注意:在启动 WebSphere Application Server 之前启动数据收集体系结构。否则,可能无法收集 Web service 数据。如果您在启动数据收集体系结构之后无法重新启动服务器,则您可以通过 JMX 或管理控制台,禁用再启用 ARM,来强制它重新连接到 ARM 引擎。
要停止数据收集体系结构:
HP-UX 的故障诊断技巧:如果在 HP-UX 上启动数据收集体系结构的 ARM 代理程序组件时遇到问题,则机器可能会有配置限制来阻止 ARM 代理程序正常启动。请检查以下内核配置参数来确保它们至少和以下给出的值一样大:
sema 1 semaem 16384 semmap 4098 semmni 4096 semmns 8192 semmnu 4092 semmsl 2048 semume 512 semvmx 32767
这些内核配置参数与系统上信号量的使用相关。有关修改 HP-UX 内核配置参数的详细指示信息,请参阅 HP-UX 系统文档或咨询系统管理员。此外,如果不想更新内核配置,则可以编辑数据收集体系结构安装目录中的文件 tapm_ep.cfg。在此文件中,您会找到两个参数:
IPCAppToEngSize=500 IPCEngToAppSize=500
将这些设置更改为:
IPCAppToEngSize=50 IPCEngToAppSize=50
此更改的副作用是可能会导致数据收集的性能下降。
已安装(并可能已使用)数据收集体系结构之后,可以通过执行以下步骤向访问列表添加更多主机:
注:如果在也安装了 Rational Software Development Platform 产品(例如 Rational Performance Tester、Rational Application Developer 或 Rational Software Architect)的机器上卸载数据收集体系结构,将除去该产品安装的 Agent Controller 或数据收集组件。如果您希望在卸载此工具包的数据收集体系结构之后在该产品中使用 Agent Controller 或数据收集,您必须使用该产品的安装过程重新安装它。
同样,如果您卸载已经安装了 Agent Controller 的某个 Rational Software Development Platform 产品(例如 Rational Application Developer 或 Rational Performance Tester),它将除去数据收集体系结构组件,并禁用它。您将不得不重新安装数据收集体系结构。
在卸载数据收集体系结构之前,必须将配置为用于数据收集体系结构的所有应用程序服务器的配置取消。要取消服务器的配置:
instrumentServer -uninstall -type IBM -serverName my_Server -serverHome "C:\Program Files\was5.1" -user myUserId -password myPassword -serverVersion 5
请参阅配置示例获取最初配置参数可能是哪些参数的其他示例。注:在文件 serverConfig.xml 中列出了所有已配置的服务器。
注:如果您没有取消服务器的配置就卸载它或除去服务器实例,则 instrumentServer 实用程序将仍认为它在那儿,但是将无法联系它来取消其配置。这将阻塞数据收集体系结构的卸载过程。为解决此问题,向 instrumentServer 命令添加 -force 参数。这将在 serverConfig.xml 中除去相应的行,而不必联系此缺失的服务器来取消其配置。与上例相同情况下的示例:
instrumentServer -uninstall -force -type IBM -serverName my_Server -serverHome "C:\Program Files\was5.1" -user myUserId -password myPassword -serverVersion 5
对每个配置用于数据收集的服务器重复取消配置步骤。一旦完成,serverConfig.xml 文件将是空的,且数据收集卸载将继续。
接下来,卸载数据收集体系结构。
要卸载数据收集体系结构,请使用操作系统的安装管理器(例如,Windows 上的添加/删除程序窗口)。找到程序 IBM Rational Data Collection Infrastructure V6.1 并除去它。
如果操作系统没有这样一个安装管理器,要卸载数据收集体系结构:
要卸载数据收集体系结构:
rpa_prod/rpa_comp/rpa_boot_stop_unix.sh
通过按显示的顺序运行以下命令来卸载每个数据收集组件。在每次卸载后,确认您要卸载该组件并在完成卸载时等待。注:对以下任何命令,可以使用 -silent 而不是 -console 来静默运行卸载。
/dci_prod/_uninst/uninstall.bin -console
/IBM_Agent_Controller/_uninst/uninstall.bin -console -W prod_id_uninstall.value=dci
/tau_prod/_uninst/uninstall.bin -console
/rpa_prod/tivoli_comp/_uninst/uninstall.bin -console
如果卸载数据收集体系结构有困难,则在尝试卸载前确保代理程序已停止。
在卸载数据收集体系结构后如果 WebSphere Application Server 不再启动,则可通过执行以下步骤来对它进行修订:
打开 <was_install>/config/cells/<cell>/nodes/<node>/servers/<server>/(<server> 可能是 server1,<cell> 和 <node> 可能是机器名)中的文件 server.xml。
找到以下行:genericJvmArgs="<some set of strings>"
用空字符串替代此处:genericJvmArgs=""
现在应该就可以启动应用程序服务器了。