IBM Rational Performance Tester 版本 7.0

安装指南增补：数据收集体系结构的安装和配备

概述

数据收集体系结构

缺省情况下，数据收集体系结构会安装在已装有 IBM Rational Performance Tester V7.0 工作台的本地计算机工作站上。要从分布式应用程序使用的其他计算机系统上收集数据，这些远程主机上必须装有数据收集体系结构。您必须在分布式应用程序将使用的所有远程主机上安装 Rational Performance Tester Agent V7.0。

已在以下平台上对数据收集体系结构进行过测试：

• Intel^(R) IA32 上的 Microsoft^(R) Windows^(R) XP Professional（service pack 2）
• Intel IA32 上的 Microsoft Windows 2000 Professional（service pack 4）
• Intel IA32 上的 Microsoft Windows 2000 Advanced Server（service pack 4）
• Intel IA32 上的 Microsoft Windows 2000 Server（service pack 4）
• Intel IA32 上的 Microsoft Windows Server 2003 Standard Edition（service pack 1）。请注意：Windows 2003 上不支持包含空格的目录路径。
• Intel IA32 上的 Microsoft Windows Server 2003 Enterprise Edition（service pack 1）。请注意：Windows 2003 上不支持包含空格的目录路径。
• Red Hat Enterprise Linux^(R) Workstation V4.0（update 1）
• Red Hat Desktop V4.0（以 32 位方式运行）
• SuSE Linux Enterprise Server（SLES）V9（service pack 2）

数据收集体系结构可与 Java^(TM) 虚拟机（JVM）V1.5 或更高版本配合使用。以下是已对数据收集进行过测试的 JVM 版本：

• Linux IA32：J2RE 1.5 IBM 构建版 cxia321411-20040301；J2RE 1.5 IBM。RPT 可提供最终的构建版详细信息
• Windows IA32 J2RE：1.5 IBM Windows 32 构建版 cn1411-20040301a；J2RE 1.5 IBM Windows 32；Sun Java(TM) 2 Standard Edition（构建版 1.4.2_04-b05）。RPT 可提供最终的构建版详细信息

受支持的数据收集场景的服务器需求

数据收集体系结构可收集分布式应用程序的性能概要分析数据，并将这些数据发送到 Rational Performance Tester 工作台，您可以在工作台上查看和分析所收集的数据。您可以查询 IBM Tivoli^(R) Monitoring for Transaction Performance（TMTP）、IBM Tivoli Composite Application Manager for Response Time Tracking（ITCAM for RTT）或 IBM Tivoli Composite Application Manager for WebSphere^(R)（ITCAM for WebSphere）管理服务器数据库以收集生产环境中部署的应用程序过去的性能数据。使用 Rational Performance Tester 的"响应时间分解"功能部件，您还可以监视开发中或测试环境中的活动应用程序，并实时收集其数据。

在生产环境中，可以通过查询以下系统管理软件的管理服务器数据库来收集数据：

• 所有受支持平台上的 IBM Tivoli Monitoring for Transaction Performance V5.3 fix pack 1（5.3.0.1）。请参阅 TMTP 安装指南以了解关于受支持平台和配置的信息。
• 所有受支持平台上的 IBM Tivoli Composite Application Manager for Response Time Tracking（ITCAM for RTT）V6.0 和 V6.1。请参阅 ITCAM for RTT 安装指南以了解关于受支持平台和配置的信息。
• 所有受支持平台上的 IBM Tivoli Composite Application Manager for WebSphere（ITCAM for WebSphere）V6.0 和 V6.1。请参阅 ITCAM for WebSphere 安装指南以了解关于受支持平台和配置的信息。

对于活动的 Web 应用程序，数据收集体系结构从以下 Web 服务器收集性能概要分析数据：

• IBM WebSphere Application Server V5.0 和 V6.0 以及更高版本
• 嵌入式 IBM WebSphere Application Server V6.0
• BEA WebLogic Application Server V8.1
• 如果要对 Web service 的性能进行概要分析，必须使用以下某一版本的 WebSphere Application Server Base 修订版：
  • 版本 6.0
  • 版本 5.1.1.1 以及更高服务级别（如果使用的是 WAS 5.1.1.1 或更高级别，则不需要补丁）
  • 版本 5.1.1.0（带有补丁 PQ91494_Fix.jar）
  • 版本 5.1.0.5（带有补丁 PQ89492_5105_Fix.jar）；服务级别 5.1.0.0 以及更高级别（带有补丁 PQ89492_510x_Fix.jar）
  • 版本 5.0.2.7（带有补丁 PQ89492_5027_Fix.jar）；服务级别 5.0.2.0 以及更高级别（带有补丁 PQ89492_502x_Fix.jar）

请参阅安装指南以获取有关安装这些产品的完整说明。接下来的安装说明包括了如何配置这些产品以与数据收集体系结构一起使用的信息。

配置、启动和停止数据收集体系结构

配备应用程序服务器以与数据收集体系结构配合使用

从命令行配备安装在本地主机上的应用程序服务器

1. 打开命令行，转至数据收集体系结构安装目录下的 rpa_prod 目录。
2. 在 Linux 系统上，配备实用程序称为 instrumentServer.sh，在 Windows 系统上，它称为 instrumentServer.bat。不带参数输入命令名可查看该命令的语法详细信息。
3. 输入命名名，附带您想要用来对服务器进行配备的参数。请参阅下面的示例。
4. 重新启动应用程序服务器。

重新启动服务器后更改将生效。

对于将要进行概要分析的应用程序的任何数据收集所涉及的计算机系统上的每个应用程序服务器，重复配备步骤。通常只有一个应用程序服务器，但也有可能在一个系统上有多个应用程序服务器。

命令行配备命令的语法和示例

要查看 instrumentServer 命令的语法，请从安装配备实用程序的目录下不带任何参数输入该命令。

• Linux：./instrumentServer.sh
• Windows：instrumentServer

示例

要对配有 IBM WebSphere Application Server V5.0 或更高版本（服务器名为 server1、安装在目录 /opt/WebSphere/AppServer 下且未启用安全性）的 Linux 系统进行配备：

./instrumentServer.sh -install -type IBM -serverName server1 -serverHome
/opt/WebSphere/AppServer -serverVersion 5

要对配有 IBM WebSphere Application Server V6.0（服务器名为 server2、安装在目录 /opt/WebSphere/AppServer 下、概要文件名称为 default 且启用了安全性）的 Linux 系统进行配备：

./instrumentServer.sh -install -type IBM -serverName server2 -serverHome
/opt/WebSphere/AppServer -serverVersion 6
-profileName default -user my_WAS_userId -password my_WAS_password

要对配有 BEA WebLogic Application Server（其具体情况如下所示）的 Linux 系统进行配备：

./instrumentServer.sh -install -type BEA -serverName server1 -serverHome
/opt/bea/weblogic81 -javaHome /opt/bea/jdk141_02 -adminServerHost hostname.xyz.com
-adminServerPort 7001 -user my_BEA_userId -password my_BEA_password
-startScript /opt/bea/weblogic81/mydomain/startManagedWeblogic.sh

要对配有 IBM WebSphere Application Server V5.0 或更高版本（服务器名为 my_Server、安装在 C:\Program Files\was5.x 下且启用了安全性）的 Windows 系统进行配备：

instrumentServer -install -type IBM -serverName my_Server
-serverHome "C:\Program Files\was5.x" -user my_WAS_userId
-password my_WAS_password -serverVersion 5

要对配有 IBM WebSphere Application Server V6.0（服务器名为 my_Server2、安装在 C:\Program Files\was6.0 下、概要文件名称为 default 且启用了安全性）的 Windows 系统进行配备：

instrumentServer -install -type IBM -serverName my_Server2 
-serverHome "C:\Program Files\was6.0" -user my_WAS_userId 
-password my_WAS_password -serverVersion 6 -profileName default

要对配有 BEA WebLogic Application Server（其具体情况如下所示）的 Windows 系统进行配备：

instrumentServer -install -type BEA -serverName server1 
-serverHome C:\bea\weblogic81 -javaHome C:\bea\jdk141_02 
-adminServerHost localhost -adminServerPort 7001 
-user my_BEA_userID -password my_BEA_password
-startScript C:\bea\weblogic81\mydomain\startManagedWeblogic.cmd

使用图形用户界面配备安装在本地主机上的应用程序服务器

1. 如果要配备 BEA WebLogic 服务器，请启动该服务器。配备 WebSphere Application Server 时则不需要此操作，因为基于 GUI 的配备器将自动为您启动该服务器。
2. 单击开始 -> 程序 -> IBM Software Development Platform -> IBM Rational 数据收集体系结构 -> 应用程序服务器配备器。
3. 使用所需的参数对服务器进行配备。请参阅下面的示例。
4. 如果要配备 BEA WebLogic 服务器，请停止该服务器，然后重新启动。（配备 WebSphere Application Server 时则不需要此步骤，因为基于 GUI 的配备器将自动为您停止该服务器并重新启动。）

对于将要进行概要分析的应用程序的任何数据收集所涉及的系统上每个服务器，重复配备步骤。通常只有一个应用程序服务器，但也有可能在一个系统上有多个应用程序服务器。

基于 GUI 的配备的语法和示例

要调用基于图形用户界面的配备器，请单击开始 -> 程序 -> IBM Software Development Platform -> IBM Rational 数据收集体系结构 -> 应用程序服务器配备器。

示例

要对配有 IBM WebSphere Application Server V5.0 或更高版本（服务器名为 server1、安装在目录 /opt/WebSphere/AppServer 下且未启用安全性）的 Linux 系统进行配备：

1. 单击添加本地。
2. 从类型菜单选择 IBM WebSphere Application Server V5.x。
3. 在服务器名称字段中输入 server1。
4. 在服务器主目录字段中输入 /opt/WebSphere/AppServer。
5. 单击确定。

要对配有 WebSphere Application Server V6.0（服务器名为 server2、安装在目录 /opt/WebSphere/AppServer 下、概要文件名称为 default 且启用了安全性）的 Linux 系统进行配备：

1. 单击添加本地。
2. 从类型菜单选择 IBM WebSphere Application Server V6.x。
3. 在概要文件名称字段中输入 default。
4. 在服务器名称字段中输入 server2。
5. 在服务器主目录字段中输入 /opt/WebSphere/AppServer。
6. 选中需要全局安全性复选框。
7. 在用户字段中输入 my_WAS_userId。
8. 在密码字段中输入 my_WAS_password。
9. 单击确定。

要对配有 BEA WebLogic Application Server（名为 server1、安装在目录 /opt/bea/weblogic81 下、Java 主目录为 /opt/bea/jdk15、管理服务器主机为 hostname.xyz.com、管理服务器端口为 7001 且启动脚本文件为 /opt/bea/weblogic81/mydomain/startManagedWeblogic.sh）的 Linux 系统进行配备：

1. 启动 WebLogic 服务器。
   注:
   WebLogic 服务器必须使用该产品自身包含的 JVM 来启动。另外，请注意 JRockit VM 不是受支持的 JVM。对于受管 WebLogic 服务器，Java 主目录变量（在配置 -> 远程启动下）必须指向随 WebLogic 提供的 Sun JVM，以便配备的服务器正常启动。
2. 单击添加本地。
3. 从类型菜单选择 BEA WebLogic Application Server V8.x。
4. 在服务器名称字段中输入 server1。
5. 在服务器主目录字段中输入 /opt/bea/weblogic81。
6. 在 Java 主目录字段中输入 /opt/bea/jdk15。
7. 在管理服务器主机字段中输入 hostname.xyz.com。
8. 在管理服务器端口字段中输入 7001。
9. 在用户字段中输入 my_BEA_userId。
10. 在密码字段中输入 my_BEA_password。
11. 选中脚本启动此服务器复选框。
12. 在脚本文件字段中输入 /opt/bea/weblogic81/mydomain/startManagedWeblogic.sh。
13. 单击确定。
14. 停止该服务器，然后重新启动。

要对配有 WebSphere Application Server V5.0 或更高版本（服务器名为 my_Server、安装在 C:\Program Files\was5.x 下且启用了安全性）的 Windows 系统进行配备：

1. 单击添加本地。
2. 从类型菜单选择 IBM WebSphere Application Server V5.x。
3. 在服务器名称字段中输入 my_Server。
4. 在服务器主目录字段中输入 C:\Program Files\was5.x。
5. 选中需要全局安全性复选框。
6. 在用户字段中输入 my_WAS_userId。
7. 在密码字段中输入 my_WAS_password。
8. 单击确定。

要对配有 WebSphere Application Server V6.0（服务器名为 my_Server2、安装在 C:\Program Files\was6.0 下、概要文件名称为 default 且启用了安全性）的 Windows 系统进行配备：

1. 单击添加本地。
2. 从类型菜单选择 IBM WebSphere Application Server V6.x。
3. 在概要文件名称字段中输入 default。
4. 在服务器名称字段中输入 my_Server2。
5. 在服务器主目录字段中输入 C:\Program Files\was6.0。
6. 选中需要全局安全性复选框。
7. 在用户字段中输入 my_WAS_userId。
8. 在密码字段中输入 my_WAS_password。
9. 单击确定。

要对配有 BEA WebLogic Application Server（名为 server1、安装在目录 C:\bea\weblogic81 下、Java 主目录为 C:\bea\jdk15、管理服务器主机为 localhost、管理服务器端口为 7001 且启动脚本文件为 C:\bea\weblogic81\mydomain\startManagedWeblogic.cmd）的 Windows 系统进行配备：

1. 启动 WebLogic 服务器。
   注:
   WebLogic 服务器必须使用该产品自身包含的 JVM 来启动。另外，请注意 JRockit VM 不是受支持的 JVM。对于受管 WebLogic 服务器，Java 主目录变量（在配置 -> 远程启动下）必须指向随 WebLogic 提供的 Sun JVM，以便配备的服务器正常启动。
2. 单击添加本地。
3. 从类型菜单选择 BEA WebLogic Application Server V8.x。
4. 在"服务器名称"字段中输入 server1。
5. 在服务器主目录字段中输入 C:\bea\weblogic81。
6. 在 Java 主目录字段中输入 C:\bea\jdk15。
7. 在管理服务器主机字段中输入 localhost。
8. 在管理服务器端口字段中输入 7001。
9. 在用户字段中输入 my_BEA_userId。
10. 在密码字段中输入 my_BEA_password。
11. 选中脚本启动此服务器复选框。
12. 在脚本字段中输入 C:\bea\weblogic81\mydomain\startManagedWeblogic.cmd。
13. 单击确定。
14. 停止该服务器，然后重新启动。

使用图形用户界面配备安装在远程主机上的应用程序服务器

基于图形用户界面的配备器使您能够从工作站配备多个远程主机上的应用程序服务器。首先必须确保在每台远程主机上都安装了 Rational Performance Tester Agent V7.0。请参阅《IBM Rational Performance Tester V7.0 安装指南》以获取更多信息。还必须在每台主机上安装安全 shell 服务器（对于 Linux 系统为 ssh 服务器，对于 Windows 系统为 cygwin）。

要对远程主机进行配备：

1. 单击开始 -> 程序 -> IBM Software Development Platform -> IBM Rational 数据收集体系结构 -> 应用程序服务器配备器。
2. 使用所需的参数对服务器进行配备。请参阅下面的示例。

对于将要进行概要分析的应用程序的任何数据收集所涉及的远程主机上的每个服务器，以及装有需要配备的应用程序服务器的每个远程主机，重复配备步骤。通常只有一个应用程序服务器，但也有可能在一个主机服务器上有多个应用程序服务器。

基于 GUI 的远程应用程序服务器配备的语法和示例

要调用基于图形用户界面的配备器，请单击开始 -> 程序 -> IBM Software Development Platform -> IBM Rational 数据收集体系结构 -> 应用程序服务器配备器。

示例

要对配有 IBM WebSphere Application Server V5.0 或更高版本（服务器名为 server1、安装在目录 /opt/WebSphere/AppServer 下且未启用安全性）的名为 linux1 的远程 Linux 主机进行配备：

1. 单击添加远程。
2. 填写应用程序服务器选项卡：
   • 从类型菜单选择 IBM WebSphere Application Server V5.x。
   • 在服务器名称字段中输入 server1。
   • 在服务器主目录字段中输入 /opt/WebSphere/AppServer。
3. 填写连接选项卡：
   • 在主机字段中输入 linux1。
   • 在用户字段中输入 SSH_linux1_userId。
   • 在密码字段中输入 SSH_linux1_password。
4. 单击确定。

要对配有 IBM WebSphere Application Server V6.0（服务器名为 server2、安装在目录 /opt/WebSphere/AppServer 下、概要文件名称为 default 且启用了安全性）的名为 linux2 的远程 Linux 主机进行配备：

1. 单击添加远程。
2. 填写应用程序服务器选项卡：
   • 从类型菜单选择 IBM WebSphere Application Server V6.x。
   • 在概要文件名称字段中输入 default。
   • 在服务器名称字段中输入 server2。
   • 在服务器主目录字段中输入 /opt/WebSphere/AppServer。
   • 选中需要全局安全性复选框。
   • 在用户字段中输入 my_WAS_userID。
   • 在密码字段中输入 my_WAS_password。
   • 根据您的意愿选中或清除保存密码复选框。
3. 填写连接选项卡：
   • 在主机字段中输入 linux2。
   • 在用户字段中输入 SSH_linux2_userId。
   • 在密码字段中输入 SSH_linux2_password。
4. 填写高级选项卡：
   • 输入 RSA/DSA 认证信息。
   • 根据需要提供选项。
5. 单击确定。

要对配有 BEA WebLogic Application Server（名为 server1、安装在目录 /opt/bea/weblogic81 下、Java 主目录为 /opt/bea/jdk15、管理服务器主机为 hostname.xyz.com、管理服务器端口为 7001 且启动脚本文件为 /opt/bea/weblogic81/mydomain/startManagedWeblogic.sh）的名为 linux3 的远程 Linux 主机进行配备：

1. 启动 WebLogic 服务器。
   注:
   WebLogic 服务器必须使用该产品自身包含的 JVM 来启动。另外，请注意 JRockit VM 不是受支持的 JVM。对于受管 WebLogic 服务器，Java 主目录变量（在配置 -> 远程启动下）必须指向随 WebLogic 提供的 Sun JVM，以便配备的服务器正常启动。
2. 单击添加远程。
3. 填写应用程序服务器选项卡：
   • 从类型菜单选择 BEA WebLogic Application Server V8.x。
   • 在服务器名称字段中输入 server1。
   • 在服务器主目录字段中输入 /opt/bea/weblogic81。
   • 在 Java 主目录字段中输入 /opt/bea/jdk15。
   • 在管理服务器主机字段中输入 hostname.xyz.com。
   • 在管理服务器端口字段中输入 7001。
   • 在用户字段中输入 my_BEA_userId。
   • 在密码字段中输入 my_BEA_password。
   • 选中脚本启动此服务器复选框。
   • 在脚本字段中输入 /opt/bea/weblogic81/mydomain/startManagedWeblogic.sh。
4. 填写连接选项卡：
   • 在主机字段中输入 linux3。
   • 在用户字段中输入 SSH_linux3_userId。
   • 在密码字段中输入 SSH_linux3_password。
5. 单击确定。
6. 停止该服务器，然后重新启动。

要对配有 IBM WebSphere Application Server V5.0 或更高版本（服务器名为 my_Server、安装在 C:\Program Files\was5.x 下且启用了安全性）的名为 windows1 的远程 Windows 主机进行配备：

1. 单击添加远程。
2. 填写应用程序服务器选项卡：
   • 从类型菜单选择 IBM WebSphere Application Server V5.x。
   • 在服务器名称字段中输入 my_Server。
   • 在服务器主目录字段中输入 C:\Program Files\was5.x。
   • 选中需要全局安全性复选框。
   • 在用户字段中输入 my_WAS_userId。
   • 在密码字段中输入 my_WAS_password。
3. 填写连接选项卡：
   • 在主机字段中输入 windows1。
   • 在用户字段中输入 SSH_windows1_userId。
   • 在密码字段中输入 SSH_windows1_password。
4. 单击确定。

要对配有 IBM WebSphere Application Server V6.0（服务器名为 my_Server2、安装在 C:\Program Files\was6.0 下、概要文件名称为 default 且启用了安全性）的名为 windows2 的远程 Windows 主机进行配备：

1. 单击添加远程。
2. 填写应用程序服务器选项卡：
   • 从类型菜单选择 IBM WebSphere Application Server V6.x。
   • 在概要文件名称字段中输入 default。
   • 在服务器名称字段中输入 my_Server2。
   • 在服务器主目录字段中输入 C:\Program Files\was6.0。
   • 选中需要全局安全性复选框。
   • 在用户字段中输入 my_WAS_userId。
   • 在密码字段中输入 my_WAS_password。
3. 填写连接选项卡：
   • 在主机字段中输入 windows2。
   • 在用户字段中输入 SSH_windows2_userId。
   • 在密码字段中输入 SSH_windows2_password。
4. 单击确定。

要对配有 BEA WebLogic Application Server（名为 server1、安装在目录 C:\bea\weblogic81 下、Java 主目录为 C:\bea\jdk15、管理服务器主机为 localhost、管理服务器端口为 7001 且启动脚本文件为 C:\bea\weblogic81\mydomain\startManagedWeblogic.cmd）的名为 windows1 的远程 Windows 主机进行配备：

1. 启动 WebLogic 服务器。
   注:
   WebLogic 服务器必须使用该产品自身包含的 JVM 来启动。另外，请注意 JRockit VM 不是受支持的 JVM。对于受管 WebLogic 服务器，Java 主目录变量（在配置 -> 远程启动下）必须指向随 WebLogic 提供的 Sun JVM，以便配备的服务器正常启动。
2. 单击添加远程。
3. 填写应用程序服务器选项卡：
   • 从类型菜单选择 BEA WebLogic Application Server V8.x。
   • 在服务器名称字段中输入 server1。
   • 在服务器主目录字段中输入 C:\bea\weblogic81。
   • 在 Java 主目录字段中输入 C:\bea\jdk15。
   • 在管理服务器主机字段中输入 localhost。
   • 在管理服务器端口字段中输入 7001。
   • 在用户字段中输入 my_BEA_userId。
   • 在密码字段中输入 my_BEA_password。
   • 选中脚本启动此服务器复选框。
   • 在脚本字段中输入 C:\bea\weblogic81\mydomain\startManagedWeblogic.cmd。
4. 填写连接选项卡：
   • 在主机字段中输入 windows1。
   • 在用户字段中输入 SSH_windows1_userId。
   • 在密码字段中输入 SSH_windows1_password。
5. 单击确定。
6. 停止该服务器，然后重新启动。

启动和停止数据收集体系结构

启动 RAC 以及数据收集体系结构

1. 退出所有运行中的 Rational Performance Tester V7.0 工作台实例。
2. 启动 Agent Controller：
   • 在 Windows 系统上，将 Agent Controller 作为服务启动。
   • 在非 Windows 系统上，将工作目录切换至 AgentController 安装目录中的 /bin 子目录，然后在命令行中输入 ./RAStart.sh。
3. 启动数据收集体系结构：
   • 在 Windows 系统上，单击开始 -> 程序 -> IBM Software Development Platform -> IBM Rational 数据收集体系结构 -> 启动监视。
   • 在 Linux 系统上，从开始菜单单击应用程序 -> 系统工具 -> 启动监视。
   • 在其他平台上，将工作目录切换至 DCI 安装目录中的 rpa_prod/rpa_comp 子目录，然后在命令行中输入 ./startDCI.sh。
4. 启动 Web 应用程序服务器。
   注:
   为在 WebSphere Application Server 上收集 Web service 数据，在启动 WebSphere Application Server 前，必须先启动数据收集体系结构。否则，可能会无法收集 Web service 数据。
5. 启动 Rational Performance Tester V7.0。

停止数据收集体系结构

1. 在 Windows 系统上，单击开始 -> 程序 -> IBM Software Development Platform -> IBM Rational 数据收集体系结构 -> 停止监视。
2. 在 Linux 系统上，从开始菜单单击应用程序 -> 系统工具 -> 停止监视。
3. 在其他平台上，将工作目录切换至 DCI 安装目录中的 rpa_prod/rpa_comp 子目录。在命令行中输入 ./stopDCI.sh。

从应用程序服务器卸载数据收集体系结构

从命令行取消对应用程序服务器的配备

1. 打开命令行，然后打开数据收集体系结构安装目录中的 rpa_prod 目录。
2. 配备实用程序称为 instrumentServer.sh，它也可用于取消对服务器的配备（在 Windows 系统上，该实用程序称为 instrumentServer.bat）。不带参数输入命令可查看语法详细信息。
3. 输入命令名，附带 -uninstall 参数以及其他所有您最初用来对服务器进行配备的参数。例如，在 Windows 上，要卸载 IBM WebSphere Application Server V5.1（服务器实例名为 my_Server、安装在 C:\Program Files\was5.1 中且启用了安全性），请输入以下命令和参数：instrumentServer -uninstall -type IBM -serverName my_Server -serverHome "C:\Program Files\was5.1" -user my_WAS_userId -password my_WAS_password -serverVersion 5 有关其他初始配备参数的示例，请参阅配备示例。注：文件 InstrumentationRegistry.xml 中列出了所有已配备的服务器。要点：如果没有取消配备就卸载了服务器或除去了服务器实例，则 instrumentServer 实用程序将不会发现缺少了服务器，并且也无法与服务器联系以进行取消配备操作。这将导致数据收集体系结构的卸载过程无法进行。
4. 重新启动服务器。

对于每个已经过配备来进行数据收集的服务器，重复取消配备步骤。完成这些操作后，InstrumentationRegistry.xml 文件将为空。您就可以继续数据收集体系结构的卸载了。

使用图形用户界面取消对本地或远程应用程序服务器的配备

1. 单击开始 -> 程序 -> IBM Software Development Platform -> IBM Rational 数据收集体系结构 -> 应用程序服务器配备器。
2. 突出显示您想要取消配备的服务器。
3. 单击除去。
4. 重新启动服务器。

在 Windows 和 Linux 系统上卸载先前版本的数据收集体系结构

如果操作系统没有安装管理器，请使用以下方法卸载数据收集体系结构：

1. 停止数据收集体系结构。
2. 转至数据收集体系结构安装目录中的 dci_prod/_uninst 子目录。
3. 运行 ./uninstall.bin。
4. 遵循向导中的指示信息。

故障诊断

如果卸载先前版本的数据收集体系结构时遇到问题，请确保在尝试卸载前停止了代理程序。

有关其他初始配备参数的示例，请参阅配备示例。

如果卸载数据收集体系结构后 WebSphere Application Server 不再启动，则通过执行以下步骤也许能修正：

1. 打开 <was_install>/config/cells/<cell>/nodes/<node>/servers/<server>/（<server> 可能是 server1，<cell> 和 <node> 可能是系统名称）中 server.xml 文件。
2. 查找以下行：genericJvmArgs="<some set of strings>"。
3. 用空字符串进行替换：genericJvmArgs=""。

启动应用程序服务器。

声明

(C) Copyright IBM Corporation 2000, 2007.

本 IBM 产品中包含的 XDoclet Documentation 需在获得许可之后才能使用，并受以下版权归属声明保护：Copyright (C) 2000-2004, XDoclet Team. All rights reserved.

U.S. Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

本信息是为在美国提供的产品和服务编写的。IBM 可能在其他国家或地区不提供本文档中讨论的产品、服务或功能特性。有关您当前所在区域的产品和服务的信息，请向您当地的 IBM 代表咨询。任何对 IBM 产品、程序或服务的引用并非意在明示或暗示只能使用 IBM 的产品、程序或服务。只要不侵犯 IBM 的知识产权，任何同等功能的产品、程序或服务都可以代替 IBM 产品、程序或服务。但是，评估和验证任何非 IBM 产品、程序或服务，则由用户自行负责。

IBM 公司可能已拥有或正在申请与本文档内容有关的各项专利。提供本文档并未授予用户使用这些专利的任何许可。您可以用书面方式将许可查询寄往：

有关双字节（DBCS）信息的许可查询，请与您所在国家或地区的 IBM 知识产权部门联系，或用书面方式将查询寄往：

本条款不适用英国或任何这样的条款与当地法律不一致的国家或地区：International Business Machines Corporation“按现状”提供本出版物，不附有任何种类的（无论是明示的还是暗含的）保证，包括但不限于暗含的有关非侵权、适销和适用于某种特定用途的保证。某些国家或地区在某些交易中不允许免除明示或暗含的保证。因此本条款可能不适用于您。

本信息中可能包含技术方面不够准确的地方或印刷错误。此处的信息将定期更改；这些更改将编入本资料的新版本中。IBM 可以随时对本资料中描述的产品和/或程序进行改进和/或更改，而不另行通知。

本信息中对非 IBM Web 站点的任何引用都只是为了方便起见才提供的，不以任何方式充当对那些 Web 站点的保证。那些 Web 站点中的资料不是 IBM 产品资料的一部分，使用那些 Web 站点带来的风险将由您自行承担。本程序的被许可方如果要了解有关程序的信息以达到如下目的：（i）允许在独立创建的程序和其他程序（包括本程序）之间进行信息交换，以及（ii）允许对已经交换的信息进行相互使用，请与下列地址联系：

只要遵守适当的条件和条款，包括某些情形下的一定数量的付费，都可获得这方面的信息。

本资料中描述的许可程序及其所有可用的许可资料均由 IBM 依据 IBM 客户协议、IBM 国际软件许可协议或任何同等协议中的条款提供。

此处包含的任何性能数据都是在受控环境中测得的。因此，在其他操作环境中获得的数据可能会有明显的不同。有些测量可能是在开发级的系统上进行的，因此不保证与一般可用系统上进行的测量结果相同。此外，有些测量是通过推算而估计的。实际结果可能会有差异。本文档的用户应当验证其特定环境的适用数据。

涉及非 IBM 产品的信息可从这些产品的供应商、其出版说明或其他可公开获得的资料中获取。IBM 没有对这些产品进行测试，也无法确认其性能的精确性、兼容性或任何其他关于非 IBM 产品的声明。 有关非 IBM 产品性能的问题应当向这些产品的供应商提出。

所有关于 IBM 未来方向或意向的声明都可随时更改或收回，而不另行通知，它们仅仅表示了目标和意愿而已。

本信息包含在日常业务操作中使用的数据和报告的示例。为了尽可能完整地说明他们，示例中可能会包括个人姓名以及公司、品牌和产品的名称。所有这些名称都是虚构的，如与实际的商业企业使用的名称和地址有任何相似之处，纯属巧合。

版权许可

本信息包括源语言形式的样本应用程序，这些样本说明不同操作平台上的编程方法。如果是为按照在编写样本程序的操作平台上的应用程序编程接口（API）进行应用程序的开发、使用、经销或分发为目的，您可以任何形式对这些样本程序进行复制、修改、分发，而无须向 IBM 付费。这些示例并未在所有条件下作全面测试。因此，IBM 不能担保或暗示这些程序的可靠性、可维护性或功能。

凡这些实例程序的每份拷贝或其任何部分或任何衍生产品，都必须包括如下版权声明：

(C)（贵公司的名称）（年）。此部分代码是根据 IBM 公司的样本程序衍生出来的。(C) Copyright IBM Corp. 2000, 2007.

商标和服务标记

请访问 www.ibm.com/legal/copytrade.shtml。