解除安裝代理程式

從受管理系統解除安裝單一代理程式或所有代理程式。

開始之前

對於多重實例代理程式，必須先移除所有代理程式實例，然後再解除安裝代理程式。否則，無法從登錄清除代理程式項目。若要移除實例，請執行下列指令：
  • 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 伺服器。
  • 若為 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 代理程式，請確保用來解除安裝代理程式的使用者 ID，對資料收集器起始目錄中的 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，並執行 ism-agent.bat 檔搭配 uninstall 當作引數。如果您想要使用 smai-agent.bat 來解除安裝伺服器上所有的監視代理程式，請先執行 ism-agent.bat 搭配 uninstall 當作引數，然後執行 smai-agent.bat
  • 對於 Monitoring Agent for SAP NetWeaver Java™ Stack，在解除安裝代理程式之前，請使用下列指令來停止所有 SAP NetWeaver 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. 若要解除安裝特定的監視代理程式，請輸入代理程式 Script 名稱及解除安裝選項，其中 name 是代理程式 Script 名稱：
    • Linux 或 AIX./name-agent.sh uninstall
    • Windowsname-agent.bat uninstall
    如需代理程式 Script 名稱的清單，請參閱使用代理程式指令。
    記住： 若為 Monitoring Agent for Microsoft .NET，您必須以管理者專用權執行該指令。

    將從受管理系統解除安裝監視代理程式。

    如果您已分別解除安裝所有監視代理程式，請繼續進行以移除架構檔案。請參閱下一步。

  3. 若要在有確認提示的情況下從受管理系統解除安裝所有監視代理程式，請輸入 Script 名稱及解除安裝全部選項：
    • Linux 或 AIX./smai-agent.sh uninstall_all
    • Windowssmai-agent.bat uninstall_all
    即會顯示確認提示。鍵入 1 以繼續，或鍵入 2 以取消。
    將從系統或 VM 解除安裝所有監視代理程式。
  4. Linux 或 AIX 在 Linux 及 UNIX 上，若要在沒有確認提示的情況下強制解除安裝所有監視代理程式，請輸入 Script 名稱及強制解除安裝全部選項：
    ./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 應用程式。