Windows 上での IBM MQ のアンインストール

コントロール・パネル、コマンド行 ( msiexec )、 MQParms、またはインストール・メディアを使用して、 Windows システム上の IBM® MQ MQI clients およびサーバーをアンインストールできます。この場合は、オプションでキュー・マネージャーも削除できます。

始める前に

デフォルトでは、 Windowsでアンインストールのロギングは有効になっていません。アンインストールのログを受け取るようにするには、以下の手順を実行します。

コマンド・プロンプトで、コマンド regedit を発行してレジストリー・エディターを開きます。
適切なレジストリー・キーを作成または編集します。HKEY_LOCAL_MACHINE\Software\Policies\Microsoft\Windows\Installer
このレジストリー・キーの下に以下の情報を追加します。

名前

ロギング

データ・タイプ

REG_SZ

値

voicewarmup
更新されたレジストリー・キーを保存します。

手順

プロシージャーの最初の部分では、実行中の IBM MQ プログラムまたはプロセスがないことを確認します。

Microsoft Cluster Service (MSCS) を使用して IBM MQ を実行している場合は、 IBM MQをアンインストールする前に、MSCS 制御からキュー・マネージャーを除去してください。現在 MSCS コントロール下にある各キュー・マネージャーについて、次のステップを実行してください。
1. キュー・マネージャー・リソースをオフラインにします。
2. リソース・インスタンスを破棄します。
3. 共用ドライブからキュー・マネージャー・ファイルを取り戻します。このステップは、 MSCS 制御からキュー・マネージャーを除去するでオプションとして示されています。しかし、このケースでは必須です。
アンインストールするインストール済み環境に関連付けられているすべての IBM MQ アプリケーションを停止します。
すべての Managed File Transfer エージェントを閉じます。
Managed File Transfer Agent が実行中の場合は、 fteStopAgent コマンドを使用して閉じてください。 fteStopエージェント ( Managed File Transfer Agentの停止)を参照してください。
サーバー・インストールの場合は、すべての IBM MQ アクティビティーを終了します。
1. グループ mqmのユーザーとしてログインします。
2. IBM MQ エクスプローラーを使用するか、以下のコマンドを入力して、実行中のすべてのキュー・マネージャーおよびリスナーを停止します。
  1. 以下のコマンドを入力して、アンインストール対象のインストールを処理する環境をセットアップします。
```
 MQ_INSTALLATION_PATH\bin\setmqenv -s
```
    ここで、 MQ_INSTALLATION_PATH は、 IBM MQ がインストールされている場所です。
  2. 各キュー・マネージャーに対して、以下のコマンドを入力してキュー・マネージャーを停止します。
```
endmqm queue_manager_name
```
  3. 各キュー・マネージャーに対して、以下のコマンドを入力して、キュー・マネージャーに関連したリスナーをすべて停止します。
```
endmqlsr -m queue_manager_name
```
IBM MQを停止します。
これを行うには、システム・トレイ内の IBM MQ アイコンを右クリックして、「停止」IBM MQを選択します。
すべての IBM MQ ウィンドウを閉じます。
すべてのモニター・サービスを停止します。

IBM MQ に関連付けられているすべてのプロセスが実行されなくなったら、 IBM MQをアンインストールできます。

以下のいずれかの方法を使用して IBM MQ をアンインストールします。
- Windows コントロール・パネルを使用します。このプロセスについては、コントロール・パネルを使用した IBM MQ のアンインストールで説明されています。この方法では、キュー・マネージャーのデータは削除されません。
- コマンド行を使用するには、 msiexec を使用した IBM MQ のアンインストールの説明に従って、 msiexec コマンドを実行します。この方法では、キュー・マネージャーのデータは削除されません。
- MQParms に適切なパラメーターを指定して使用します。このプロセスについては、 MQParms を使用した IBM MQ のアンインストールで説明されています。この方法では、キュー・マネージャーのデータは削除されません。
- インストール・メディアを使用した Windows での IBM MQ のアンインストールの説明に従って適切なオプションを選択し、インストール・メディアを使用します。該当する場合には、キュー・マネージャー・データを除去するオプションが「サーバー機能の除去」パネルに表示されます。
アンインストール・プロセスを終了前に取り消す必要がある場合は、 IBM MQ サービスの削除のロールバックでサービスのユーザー・アカウント・パスワードを設定できないため、 IBM MQ 準備ウィザードを使用して IBM MQ を再構成しなければならない場合があります。以下のコマンドを使用して、 IBM MQを再構成します。
```
MQ_INSTALLATION_PATH\bin\amqmjpse.exe -r
```
IBM MQ 準備ウィザードについて詳しくは、 IBM MQ 準備ウィザードを使用した IBM MQ の構成を参照してください。
Windows イベント・ログを確認し、必要に応じてシステムを再始動してください。
イベント ID 10005 が Windows イベント・ログに書き込まれる場合は、システムを再始動してアンインストール・プロセスを完了する必要があります。
オプション: IBM MQの最後のインストールまたは唯一のインストールをアンインストールする場合、必要に応じて、システムに保持されている以前のインストールに関するすべての情報を削除できます。この目的では、 ResetMQ.cmd を使用する必要があります。詳しくは、 IBM MQ インストール設定のクリアを参照してください。
以下のレジストリー値は、アンインストール後も残ります。
- My Computer\HKEY_LOCAL_MACHINE\SOFTWARE\IBM\WebSphere MQ\LogDefaultPath
- My Computer\HKEY_LOCAL_MACHINE\SOFTWARE\IBM\WebSphere MQ\WorkPath
- My Computer\HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\IBM\WebSphere MQ\LogDefaultPath
- My Computer\HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\IBM\WebSphere MQ\WorkPath
データ・フォルダーもそのまま MQ_DATA_PATH\Configに配置されます。ここで、MQ_DATA_PATH は IBM MQ データ・ディレクトリーのロケーションです。残されるファイルのほとんどは、INI ファイル、エラー・ログ、FDC ファイルなどのテキストを含むファイルです。また、実行可能ファイル共用ライブラリー mqzsd.dll も残ります。

LogDefaultPath レジストリー値が以前のサーバー・インストールのままになっているシステムにクライアントがインストールされている場合、クライアント・インストールは、このディレクトリーがまだ存在していなければ、このディレクトリーを作成しようとします。この動作を望まない場合は、LogDefaultPath レジストリー値を除去してからクライアントをインストールしてください。