对服务器进行概要分析允许您在运行 Web 应用程序时分析性能、线程技术和内存使用情况。在某些情况下,必须先在目标主机计算机上设置环境变量,才能在概要分析方式下启动服务器。必须先设置环境变量,才能启动服务器进行概要分析。在运行 z/OS® 的计算机上,还需要设置 Rational® Agent
Controller 所使用的目录的许可权。
确定是否必须手动设置环境变量以进行概要分析
在某些情况下,在进行概要分析时,不需要在目标计算机上手动设置环境变量;工作台将为您自动设置这些环境变量。但是,在某些情况下,必须手动设置这些环境变量。以下因素决定是否有必要手动设置环境变量以及要设置哪些环境变量:
- 服务器的目标计算机是与安装工作台的计算机(本地服务器)相同,还是服务器位于不同的计算机(远程服务器)上。
- 用户标识是否对 WebSphere® Application Server(本地服务器)的 /java/jre/bin/ 目录具有写访问权。
- 已安装的 Rational Agent
Controller(远程服务器)的版本。
下表显示了自动设置环境变量的条件以及必须手动设置环境变量的条件。
表 1. 用于在概要分析时自动或手动设置环境变量的场景. 环境变量将针对本地和远程服务器进行设置。环境变量 |
本地服务器 |
远程服务器 |
- PATH
- LD_LIBRARY_PATH
- LIBPATH
|
由工作台自动设置。 |
如果远程服务器使用的是 Rational Agent Controller V8.3 或更高版本,那么将自动设置。否则,将手动设置。注: 必须确保 LIBPATH 环境变量包括路径 <XML Toolkit installation directory>/xml4c-5_7/lib。
例如,如果已将 XML 工具箱安装在 /usr/lpp/ixm/IBM/xml4c-5_7,那么 LIBPATH 环境变量必须包含以下路径:LIBPATH=/usr/lpp/ixm/IBM/xml4c-5_7/lib。
|
TPTP_AC_HOME |
由工作台自动设置。 |
如果远程服务器使用的是 Rational Agent Controller V8.3 或更高版本,那么将自动设置。否则,将手动设置。 |
PROBEKIT_HOME(仅当使用“探针插入”监视选项时才需要此项。) |
由工作台自动设置。 |
手动设置。 |
JAVA_PROFILER_HOME |
由工作台自动设置。 |
如果远程服务器位于使用 Rational Agent Controller V8.3 或更高版本的 Windows 或 Linux 操作系统上,那么将自动设置。否则,将手动设置。 |
手动设置本地服务器的概要分析环境变量
对于与工作台运行在同一机器上的服务器,请完成下列步骤:
- 在 IBM® Rational Software Delivery Platform 的安装目录下面,找到以下插件文件夹
注: 当存在同一插件的多个版本时,请始终选取具有最新版本号及最新时间戳记的插件。
表 2. 用于定义在本地服务器进行概要分析的环境变量的插件的路径. 使用插件路径来确定环境变量。描述 |
插件路径 |
<Agent Controller Home> |
- <install_dir>\IBMIMShared\plugins\org.eclipse.tptp.platform.ac.win_<XXXX>\agent_controller
- <install_dir>/IBMIMShared/plugins/org.eclipse.tptp.platform.ac.linux_<XXXX>/agent_controller
其中,<install_dir> 是 IBM Rational Software Delivery
Platform 的安装目录,并且 <XXXX> 取决于操作系统的架构设计师。通过选择 ia32(对应 32 位处理器)、em64(对应 64 位处理器)或 ipf(对应 Itanium 处理器系列处理器)将 <XXXX> 取代为相应的处理器,例如 org.eclipse.tptp.platform.ac.win_ia32_<n.n.n>.v<yyyymmddtttt>(其中,<n.n.n> 是版本号,<yyyymmddtttt> 是插件的日期和时间戳记)。 |
<Probekit Home> |
- <install_dir>\IBMIMShared\plugins\org.eclipse.hyades.probekit<n.n.n>.v<yyyymmddtttt>\os\win32\x86
- <install_dir>/IBMIMShared/plugins/org.eclipse.hyades.probekit<n.n.n>.v<yyyymmddtttt>/os/linux/x86
其中,<install_dir> 是 IBM Rational Software Delivery
Platform 的安装目录,并且 <XXXX> 取决于操作系统的架构设计师。通过选择 ia32(对应 32 位处理器)、em64(对应 64 位处理器)或 ipf(对应 Itanium 处理器系列处理器)将 <XXXX> 取代为相应的处理器,例如 org.eclipse.tptp.platform.ac.win_ia32_<n.n.n>.v<yyyymmddtttt>(其中,<n.n.n> 是版本号,<yyyymmddtttt> 是插件的日期和时间戳记)。 |
- 在启动工作台和应用程序服务器之前,先设置以下环境变量。打开命令提示符并通过将 <Agent
Controller Home> 和可选的 <Probekit
Home> 替换为第一步中确定的插件路径来输入以下命令:
set TPTP_AC_HOME=<Agent Controller Home>
set PROBEKIT_HOME=<Probekit Home>
set PATH=%TPTP_AC_HOME%\bin;%TPTP_AC_HOME%\lib;%PROBEKIT_HOME%;%PATH%
export TPTP_AC_HOME=<Agent Controller Home>
export PROBEKIT_HOME=<Probekit Home>
export LD_LIBRARY_PATH=$TPTP_AC_HOME/bin:$TPTP_AC_HOME/lib:$PROBEKIT_HOME:$LD_LIBRARY_PATH
手动设置用于在远程服务器上进行概要分析的环境变量
对于与工作台运行在不同计算机上的应用程序服务器,请完成下列步骤:
注: 如果要对远程应用程序服务器进行概要分析,那么必须在该应用程序服务器所在的机器上安装 Rational Agent Controller。请验证应用程序服务器的启动流程是否选取了以下环境变量设置。
在远程应用程序服务器所在的计算机上,先手动设置任何环境变量,然后再启动工作台和应用程序服务器。您可以通过将 <
AC installation
directory> 替换为 Rational Agent Controller 的安装目录,在目标系统上手动设置以下环境变量。
此外,如果您使用的是
探针插入监视选项,请指定 PROBEKIT_HOME 环境变量:
set TPTP_AC_HOME=<AC installation directory>
set JAVA_PROFILER_HOME=%TPTP_AC_HOME%\plugins\org.eclipse.tptp.javaprofiler
set PROBEKIT_HOME=%TPTP_AC_HOME%\plugins\org.eclipse.hyades.probekit
set PATH=%JAVA_PROFILER_HOME%;%TPTP_AC_HOME%\bin;%TPTP_AC_HOME%\lib;%PROBEKIT_HOME%\lib;%PATH%
export TPTP_AC_HOME=<AC installation directory>
export JAVA_PROFILER_HOME=$TPTP_AC_HOME$/plugins/org.eclipse.tptp.javaprofiler
export PROBEKIT_HOME=$TPTP_AC_HOME$/plugins/org.eclipse.hyades.probekit
export LD_LIBRARY_PATH=$JAVA_PROFILER_HOME:$TPTP_AC_HOME/bin:$TPTP_AC_HOME/lib:$PROBEKIT_HOME/lib:$LD_LIBRARY_PATH
export TPTP_AC_HOME=<AC installation directory>
export JAVA_PROFILER_HOME=$TPTP_AC_HOME$/plugins/org.eclipse.tptp.javaprofiler
export PROBEKIT_HOME=$TPTP_AC_HOME$/plugins/org.eclipse.hyades.probekit
export LIBPATH=$JAVA_PROFILER_HOME:$TPTP_AC_HOME/bin:$TPTP_AC_HOME/lib:$PROBEKIT_HOME/lib:$LIBPATH
export TPTP_AC_HOME=<AC installation directory/RACzOS64 or 31bit>
export JAVA_PROFILER_HOME=$TPTP_AC_HOME$/plugins/org.eclipse.tptp.javaprofiler
export XERCESC_HOME=<XML Toolkit installation directory>/xml4c-5_7/lib
export PROBEKIT_HOME=$TPTP_AC_HOME$/plugins/org.eclipse.hyades.probekit
export LIBPATH=$JAVA_PROFILER_HOME:$TPTP_AC_HOME/bin:$TPTP_AC_HOME/lib:$XERCESC_HOME/lib:$PROBEKIT_HOME/lib:$LIBPATH
其中,<XML Toolkit installation directory> 通常是 /usr/lpp/ixm/IBM。
注: 如果在安装 Rational Agent
Controller 时已启用安全性,请输入以下命令:
- extattr +ap <Rational Agent Controller
directory>/lib/*
- extattr +ap <Rational Agent Controller
directory>/plugins/org.eclipse.tptp.javaprofiler/*
- extattr +ap <XML Toolkit installation
directory>/xml4c-5_7/lib/*
启动工作台
设置必需的环境变量之后,请从命令提示符启动 IBM Rational Software
Delivery Platform 工作台,以便工作台进程获取环境变量。例如,运行以下命令
C:\Program Files\IBM\SDP>eclipse
/opt/IBM/SDP>./eclipse
注: 使用 WebSphere Application
Server 进行概要分析时,可在位于服务器安装的 /bin 文件夹中的文件 setupCmdLine.bat (Windows) 或 setupCmdLine.sh (Linux) 内添加环境变量设置。
设置用于在 z/OS 上进行概要分析的文件许可权
如果要在 z/OS 上进行概要分析,那么必须对以下目录(及其路径中的所有目录)具有读和执行许可权:
- <Rational Agent Controller 安装目录>/lib/*
- <Rational Agent Controller 安装目录>/plugins/org.eclipse.tptp.javaprofiler/*
- <XML Toolkit 安装目录>/xml4c-5_7/lib*
注: 这些目录中的路径内的所有目录也需要读和执行许可权。例如,如果
<Rational Agent Controller 安装目录>
是 /opt/IBM/RAC,那么需要对下列每个目录都具有读取许可权和执行许可权:/opt、/opt/IBM、/opt/IBM/RAC
和 /opt/IBM/RAC/lib/ 目录。
要通过运行命令 umask 022 来提供对这些目录的正确许可权,请执行下列操作:
- 在 UNIX 系统服务 Shell 中,切换到 <Rational Agent Controller installation
directory>/RACzOS31bit/bin 目录。
- 运行以下命令:umask 022
- 启动代理控制器:./ACStart.sh。