1.21.1　JP1/IM - Agentのサービスの設定

(a)　アドオンプログラムの有効化

■インストール時に設定する場合

インストール時に使用する初期設定コマンドで，有効化したいアドオンプログラムを選択します。

詳細については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「3.15.9　初期設定コマンド」の説明を参照してください。

なお，バージョンアップインストール時は，既存の設定を引き継ぎます。ただし，新バージョンで新たに追加されたアドオンプログラムは無効化された状態となります。

■インストール後に設定する場合

JP1/IM - Agentのアドオンプログラムのサービスを有効化する手順を，次に示します。

1. サービスが起動中の場合は，次のコマンドを実行して停止する。

   Agentパス\tools\jpc_service_stop -s all

2. 次のコマンドを実行して，サービスを有効化する。

   Agentパス\tools\jpc_service -on [JP1/IM - Agentのサービスキー]

3. サービスに対応するディスカバリ設定ファイルを移動する。

   次に示すサービスに対応するディスカバリ設定ファイルを，Agentパス\conf\jpc_file_sd_config_offフォルダからAgentパス\confフォルダに移動します。

   サービス	ディスカバリ設定ファイル
   prometheus_server	なし
   alertmanager	なし
   windows_exporter	jpc_file_sd_config_windows.yml
   blackbox_exporter	jpc_file_sd_config_blackbox_http.yml jpc_file_sd_config_blackbox_icmp.yml
   ya_cloudwatch_exporter	jpc_file_sd_config_cloudwatch.yml
   fluentd	なし
   promitor	jpc_file_sd_config_promitor.yml
   script_exporter	なし

4. サービスが有効化されたことを確認する。

   コマンドプロンプトで「services.msc」を実行すると，管理コンソールでサービスを確認できます。該当するサービスが存在する場合，そのサービスは有効です。

5. 「1.21.2(16) IM管理ノードのツリー情報の作成と反映（Windowsの場合）（必須）」を実施する。

(b)　アドオンプログラムの無効化

JP1/IM - Agentのアドオンプログラムのサービスを無効化する手順を，次に示します。

1. サービスが起動中の場合は，次のコマンドを実行して停止する。

   Agentパス\tools\jpc_service_stop -s all

2. 次のコマンドを実行して，サービスを無効化する。

   Agentパス\tools\jpc_service -off [JP1/IM - Agentのサービスキー]

3. サービスに対応するディスカバリ設定ファイルを移動する。

   次に示すサービスに対応するディスカバリ設定ファイルを，Agentパス\confフォルダからAgentパス\conf\jpc_file_sd_config_offフォルダに移動します。

   サービス	ディスカバリ設定ファイル
   prometheus_server	なし
   alertmanager	なし
   windows_exporter	jpc_file_sd_config_windows.yml
   blackbox_exporter	jpc_file_sd_config_blackbox_http.yml jpc_file_sd_config_blackbox_icmp.yml
   ya_cloudwatch_exporter	jpc_file_sd_config_cloudwatch.yml
   fluentd	なし
   promitor	jpc_file_sd_config_promitor.yml
   script_exporter	なし

4. サービスが無効化されたことを確認する。

   コマンドプロンプトで「services.msc」を実行すると，管理コンソールでサービスを確認できます。該当するサービスが存在しない場合，そのサービスは無効です。

(a)　自動起動の有効化

OS起動時のサービス自動起動を有効にする手順を，次に示します。

1. 次のコマンドを実行して，JP1/IM - Agentのすべてのサービスの自動起動を有効にする。

   jpc_service_autostart -on

(b)　自動起動の無効化

OS起動時のサービス自動起動を無効にする手順を，次に示します。

1. 次のコマンドを実行して，JP1/IM - Agentのすべてのサービスの自動起動を無効にする。

   jpc_service_autostart -off

(c)　自動起動および自動停止の確認方法

コマンドプロンプトで「services.msc」を実行すると，管理コンソールでサービスを確認できます。

該当するサービスのプロパティを開き，「スタートアップの種類」が「自動」または「自動（遅延）」であれば有効です。それ以外であれば無効です。サービス名については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「2.9 JP1/IM - Agentのサービス」を参照してください。

(d)　OSシャットダウン時の自動停止についての注意事項

Windowsをシャットダウンする前に，統合エージェントのすべてのサービスを手動で停止してください。Windowsのシャットダウンは，サービスの停止完了を待たないため，サービスが稼動中にWindowsをシャットダウンするとサービスが正常に停止できない場合があります。この場合，イベントログにエラーや警告が出力され，OSシャットダウンした前後の統合エージェントのログの内容が不正になることがあります。また，次回のサービスの起動に時間がかかることがあります。