卸载代理程序

从受管系统卸载单个代理程序或所有代理程序。

开始之前

对于多实例代理程序，必须先移除所有代理程序实例，然后再卸载该代理程序。否则，不会从注册表中清除代理程序条目。要移除实例，请运行以下命令：
  • Windowsname-agent.bat remove instance_name
  • Linux 或 AIX./name-agent.sh remove instance_name
其中，name 是代理程序名称，instance_name 是实例名称。有关更多信息，请参阅使用代理程序命令。要获取多实例代理程序的列表，请参阅表 1。
对于以下代理程序，必须先完成特定于代理程序的任务，然后再完成卸载过程：
  • 对于 Monitoring Agent for HTTP Server，必须先删除 http.conf 文件中的 Include 语句，例如 "Include "/opt/ibm/apm/agent/tmp/khu/kvm65s2_8044.conf"，然后再重新启动 IBM® HTTP Server。
  • 对于 Monitoring Agent for Python，运行 install_dir/lx8266/pg/bin/uninstall.sh 以移除注入代码，然后再卸载代理程序。
  • 对于 Monitoring Agent for PHP，运行 install_dir/bin/lx8266/pj/lib/uninstall.instance_name.sh 以移动注入代码，然后再卸载代理程序。
  • 对于 Monitoring Agent for WebSphere® Applications，在卸载代理程序之前，必须为所有受监视的服务器实例取消配置数据收集器。遵循WebSphere Applications 代理程序：取消配置数据收集器 中的指示信息。
    对于 WebSphere Applications 代理程序，请确保用来卸载代理程序的用户标识对数据收集器主目录中的 logs 和 runtime 目录，及其中所含的所有子目录及文件，具有完全的读写许可权。数据收集器主目录如下：
    • Windowsinstall_dir\dchome\7.3.0.14.08
    • Linux 或 AIXinstall_dir/yndchome/7.3.0.14.08
  • 针对 Node.js 代理程序，您必须在卸载代理程序前从 Node.js 应用程序移除监视插件。遵循Node.js 代理程序：移除监视插件 中的指示信息。
  • 针对 Microsoft .NET 代理程序，您必须在卸载代理程序前从 .NET 应用程序中移除数据收集器。遵循Microsoft .NET 代理程序：移除 .NET 数据收集器 中的指示信息。
  • 对于 IBM Integration Bus 代理程序，如果使用提供了用户出口的代理程序为代理配置了事务跟踪，那么首先必须移除用户出口，然后才能卸载代理程序。遵循 中的指示信息移除 KQIUserExit 用户出口.
  • 有关 Internet Service Monitoring，请转至 <candle_home>\BIN 并使用 uninstall 作为自变量运行 ism-agent.bat 文件。以防您要使用 smai-agent.bat 文件卸载服务器上的所有监视代理程序，请先将 uninstall 作为自变量运行 ism-agent.bat，然后运行 smai-agent.bat
  • 对于 Monitoring Agent for SAP NetWeaver Java™ Stack，在卸载代理程序前，请使用以下命令停止所有 SAPNetWeaver Java Stack 代理程序实例：
    • Windowssap_netweaver_java_stack-agent.bat stop instance_name

关于此任务

Windows 系统上的 Oracle 代理程序只能使用命令提示符进行卸载。

过程

  1. 在安装了监视代理程序的 VM 或系统上，启动命令行并切换至二进制目录：
    • Linux 或 AIXinstall_dir/bin
    • Windowsinstall_dir\BIN
    其中，install_dir 是这一个或多个监视代理程序的安装目录。
  2. 要卸载特定监视代理程序，请输入代理程序脚本名称和卸载选项，其中 name 是代理程序脚本名称：
    • Linux 或 AIX./name-agent.sh uninstall
    • Windowsname-agent.bat uninstall
    有关代理程序脚本名称的列表，请参阅使用代理程序命令。
    切记： 针对 Monitoring Agent for Microsoft .NET，您必须使用管理员特权运行该命令。

    将从受管系统卸载监视代理程序。

    如果已单独卸载所有监视代理程序，那么请继续移除框架文件。请参阅后续步骤。

  3. 要在出现确认提示时从受管系统卸载所有监视代理程序，请输入脚本名称并卸载所有选项：
    • Linux 或 AIX./smai-agent.sh uninstall_all
    • Windowssmai-agent.bat uninstall_all
    将显示确认提示。输入 1 以继续，或输入 2 以取消。
    将从系统或 VM 卸载所有监视代理程序。
  4. Linux 或 AIX 在 Linux 和 UNIX 上，要强制卸载所有监视代理程序，而不提示确认，请输入脚本名称和强制卸载所有选项：
    ./smai-agent.sh uninstall_all force

下一步做什么

对于 Monitoring Agent for HTTP Server，在卸载代理程序之后，您必须手动移除以下文件：
  • /tmp/khu_cps.properties
  • /tmp/httpserver-disc.error
对于 Monitoring Agent for Python：
  1. 删除 Django pyc 配置文件，以确保复原的 Django pyc 文件生成自己的二进制文件。
  2. 重新启动 Apache 服务器以移除在 Apache 进程中装入的中间件。
针对 Monitoring Agent for Ruby，要卸载诊断数据收集器：
  1. 浏览到应用程序的主目录，打开其 Gemfile，并从该文件移除以下行：gem 'stacktracer'
  2. 重新启动 Ruby on Rails 应用程序。
  3. 卸载诊断数据收集器。输入：gem uninstall Gemfile
  4. 移除数据收集器的运行时目录。此目录的缺省位置为 install_dir/install-images/kkm/dchome
针对 Monitoring Agent for Microsoft .NET，完成以下步骤：
  1. 使用以下一个选项移除数据收集器 dll 文件：
    • 重新引导操作系统。
    • 尝试删除文件 install_dir\qe\bin64\CorProfLog.dll。

      将显示 File in Use 对话框。它标识了当前正在运行的 .NET 进程。

    • 重新启动每个 .NET 进程。
  2. 重新启动 .NET 应用程序。