エージェントのアンインストール
管理対象システムから 1 つのエージェントまたはすべてのエージェントをアンインストールします。
始める前に
複数インスタンス・エージェントの場合は、エージェントをアンインストールする前に、すべてのエージェント・インスタンスを削除する必要があります。そうしないと、エージェントの項目がレジストリーからクリアされません。インスタンスを削除するには、以下のコマンドを実行します。
name-agent.bat remove instance_name
./name-agent.sh remove instance_name
以下のエージェントの場合、アンインストール手順を実行する前にエージェント固有のタスクを完了する必要があります。
- 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 エージェントの場合は、エージェントのアンインストールに使用されるユーザー ID が、データ・コレクターのホーム・ディレクトリー内の logs ディレクトリーと runtime ディレクトリー、およびそこに含まれているすべてのサブディレクトリーとファイルに対する完全な読み取りおよび書き込み許可を備えていることを確認してください。データ・コレクターのホーム・ディレクトリーは以下のとおりです。
- install_dir¥dchome¥7.3.0.14.08
- install_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 の場合は、エージェントをアンインストールする前に、次のコマンドを使用してすべての SAP NetWeaver Java Stack エージェント・インスタンスを停止します。
sap_netweaver_java_stack-agent.bat stop instance_name
このタスクについて
手順
-
1 つ以上のモニター・エージェントがインストールされている VM またはシステムで、コマンド行を開始して、以下のバイナリー・ディレクトリーに移動します。
- install_dir/bin
- install_dir¥BIN
ここで、install_dir は 1 つ以上のモニター・エージェントのインストール・ディレクトリーです。 -
特定のモニター・エージェントをアンインストールするには、エージェント・スクリプト名とアンインストール・オプションを入力します。name はエージェント・スクリプト名です。
- ./name-agent.sh
uninstall
- name-agent.bat
uninstall
エージェント・スクリプト名のリストについては、エージェント・コマンドの使用を参照してください。要確認: Monitoring Agent for Microsoft .NET の場合、管理者特権でコマンドを実行する必要があります。管理対象システムからモニター・エージェントがアンインストールされます。
すべてのモニター・エージェントを個別にアンインストールした場合は、続いてフレームワークのファイルを削除します。次の処置を参照してください。
-
確認プロンプト付きで管理対象システムからすべてのモニター・エージェントをアンインストールするには、
次のようにスクリプト名と全アンインストール・オプションを入力します。
- ./smai-agent.sh uninstall_all
- smai-agent.bat uninstall_all
確認プロンプトが表示されます。続行するには 1 を入力し、キャンセルするには 2 を入力します。システムまたは VM からすべてのモニター・エージェントがアンインストールされます。 -
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 の場合:
pyc構成ファイルを削除して、リストアしたpycファイルが確実にバイナリーを生成するようにします。- Apache サーバーを再始動して、Apache プロセスでロードされたミドルウェアを削除します。
Monitoring Agent for Rubyの場合、診断データ・コレクターをアンインストールするには以下の手順を実行します。
- アプリケーションのホーム・ディレクトリーにナビゲートして、その
Gemfileを開き、ファイルからgem 'stacktracer'という行を削除します。 - Ruby on Rails アプリケーションを再始動します。
- 診断データ・コレクターをアンインストールします。以下を入力します。
gem uninstall Gemfile - データ・コレクターの runtime ディレクトリーを削除します。このディレクトリーのデフォルトの場所は、install_dir/install-images/kkm/dchome です。
Monitoring Agent for Microsoft .NETの場合は、以下のステップを実行します。
- 以下のオプションのいずれかを使用して、データ・コレクターの
dllファイルを削除します。- オペレーティング・システムをリブートする。
- ファイル
install_dir¥qe¥bin64¥CorProfLog.dllの削除を試みます。「使用中のファイル」ダイアログが表示されます。 そこに、現在実行中の .NET プロセスが示されます。
- 各 .NET プロセスを再始動します。
- .NET アプリケーションを再始動します。