Hitachi

JP1 Version 13　JP1/Integrated Management 3 - Manager 構築ガイド

7.3.6　統合エージェントホストでのJP1/IM - Agentの新規インストール（Windowsの場合）

実行系サーバ，待機系サーバそれそれのローカルディスク上にJP1/IM - Agentをインストールしてください。

  1. JP1/IM - Agentを新規インストールする。

    インストール方法については，「1.3.1(3)JP1/IM - Agentのインストールの手順」を参照してください。

    インストール時のインストールモードは「通常インストールモード」を選択します。

    実行系サーバと待機系サーバの両方で実施します。

    Windowsの場合は，実行系サーバと待機系サーバでインストール先フォルダを同じパスにする必要があります。

    物理ホストのJP1/IM - Agentのサービスは起動しないでください。起動している場合はすべて停止してください。

  2. 論理ホスト用のフォルダを共有ディスクに作成する。

    共有ディスクに作成する論理ホスト用のフォルダを「共有フォルダ」と呼びます。次に規則に従って作成してください。

    • 共有ディスクのパスの長さは63バイト以内です。

    • 共有ディスクのパスに使用できる文字は，半角英数字，半角スペース，半角ハイフン，半角アンダースコア，半角ピリオド，半角のパスの区切り文字，および半角コロンです。

    • 論理ホストを複数作成する場合は，ほかの論理ホストの共有フォルダと重複しないようにします。

  3. 共有フォルダの中身を作成する。

    ■物理ホストでまだ運用を開始していない場合の手順

    1. 物理ホストの下記のフォルダを共有フォルダにコピーする。

      コピー元

      コピー先

      Agentパス\conf

      共有フォルダ\jp1ima\

      Agentパス\bin

      Agentパス\data

      Agentパス\logs

      Agentパス\tmp

    2. binフォルダの中身を空にする。

      共有フォルダ\jp1ima\binフォルダ下に存在するファイルをすべて削除してください。

      binフォルダは残す必要があります。

    3. 物理ホスト用の定義ファイルを削除する。

      共有フォルダ\jp1ima\confに存在するファイルのうち，拡張子が「.model」および「.update」以外のファイルは，物理ホスト用の定義ファイルであるため削除します。

    ■物理ホストですでに運用を開始済みの場合の手順

    1. 共有フォルダに下記のフォルダを作成する。

      コマンドプロンプトで共有フォルダに移動してから，次のコマンドを実行します。

      mkdir jp1ima
mkdir jp1ima\conf
mkdir jp1ima\conf\secret
mkdir jp1ima\conf\user
mkdir jp1ima\conf\user\cert
mkdir jp1ima\conf\user\secret
mkdir jp1ima\conf\jpc_file_sd_config_off
mkdir jp1ima\bin
mkdir jp1ima\data
mkdir jp1ima\data\alertmanager
mkdir jp1ima\data\prometheus_server
mkdir jp1ima\data\fluentd
mkdir jp1ima\logs
mkdir jp1ima\logs\imagent
mkdir jp1ima\logs\imagentproxy
mkdir jp1ima\logs\imagentaction
mkdir jp1ima\logs\alertmanager
mkdir jp1ima\logs\prometheus_server
mkdir jp1ima\logs\windows_exporter
mkdir jp1ima\logs\blackbox_exporter
mkdir jp1ima\logs\ya_cloudwatch_exporter
mkdir jp1ima\logs\promitor_scraper
mkdir jp1ima\logs\promitor_resource_discovery
mkdir jp1ima\logs\script_exporter
mkdir jp1ima\logs\fluentd
mkdir jp1ima\logs\tools
mkdir jp1ima\tmp
mkdir jp1ima\tmp\upload
mkdir jp1ima\tmp\download
mkdir jp1ima\tmp\lockfiles

    2. 定義ファイルを共有フォルダにコピーする。

      実行系サーバのAgentパス\confに存在する拡張子が「.model」と「.update」のファイルを，共有フォルダ\jp1ima\confにコピーします。

    3. 初期シークレットを登録する。

      初期シークレットを，シークレット管理コマンドで登録します。コマンドラインを次に示します。

      jimasecret -add -key immgr.initial_secret -s "初期シークレット" -l 共有フォルダ

    4. 統合エージェント制御基盤のプロキシのパスワードを設定する。

      • エージェントホストからマネージャーホストに接続する際に認証が必要なプロキシを経由する場合，プロキシの認証IDをパスワードを設定する必要があります。

      • プロキシの認証IDの設定については，「1.21.2(2)(e)プロキシ認証の認証IDとパスワードを設定する（Windowsの場合）（オプション）」を参照してください。定義ファイルが共有フォルダ下のファイルである点に注意してください。

      • プロキシのパスワードは，シークレット管理コマンドで設定します。コマンドラインを次に示します。

        jimasecret -add -key immgr.proxy_user.認証ID -s "プロキシのパスワード" -l 共有フォルダ

  4. 定義ファイルのファイル名から「.model」または「.update」を除去する。

    共有フォルダ\jp1ima\confにコピーしたすべての定義ファイルに対して，ファイル名の末尾に付与されている「.model」または「.update」を除去します。

  5. TLSの設定を行う。

    TLSを有効にして運用する場合は，共有フォルダ\jp1ima\conf\user\certにCA証明書ファイルを配置してください。

    また，共有フォルダ\jp1ima\conf\jpc_imagentcommon.jsonのimmgr.tls_config.ca_fileにCA証明書のフルパスを記入してください。

  6. 定義ファイル内に記載されている変数を書き換える。

    共有フォルダ\jp1ima\confにコピーした定義ファイルには，下記の表に示す変数名が記載されています。各変数名で検索して，該当する個所をすべて下記の表のとおりに書き換えます。

    変数名

    書き換える値

    @@immgr.host@@

    接続先マネージャーホストのホスト名に置換します。

    @@immgr.imbase_port@@

    接続先のimbaseプロセスのポート番号に置換します。

    @@immgr.imbaseproxy_port@@

    接続先のimbaseproxyプロセスのポート番号に置換します。

    @@immgr.proxy_url@@

    統合マネージャーホストに接続する際にプロキシを経由する場合，プロキシのURLに置換します。

    プロキシ経由ではない場合は空文字列に置換します。

    @@immgr.proxy_user@@

    プロキシが認証が必要な場合にプロキシのユーザー名に置換します。

    プロキシ経由ではない場合，または，認証しない場合は空文字列に置換します。

    @@autostart@@

    「Manual」に置換します。

    @@hostname@@

    論理ホスト名に置換します。

    @@installdir1@@

    JP1/IM - Agentのインストール先フォルダのパスに置換します。

    @@installdir2@@

    共有フォルダのパスに置換します。

  7. IPバインド方式に変更する。

    物理ホストと論理ホストの両方で設定する必要があります。

    物理ホストについては，両ノードで設定が必要です。物理ホストについては設定変更後にサービスの再起動が必要となります。

    物理ホストでは，下記の定義ファイルの変更個所に，物理ホスト名を設定します。

    サービス

    対象ファイル

    変更個所

    prometheus_server

    Agentパス\bin\jpc_prometheus_server_service.xml

    --web.listen-addressに物理ホスト名を指定する。

    --web.listen-address="ホスト名:ポート"

    alertmanager

    Agentパス\bin\jpc_alertmanager_service.xml

    --web.listen-addressに物理ホスト名を指定する。

    --web.listen-address="ホスト名:ポート"

    windows_exporter

    Agentパス\bin\jpc_windows_exporter_service.xml

    --telemetry.addrに物理ホスト名を指定する。

    --telemetry.addr="ホスト名:ポート"

    blackbox_exporter

    Agentパス\bin\jpc_blackbox_exporter_service.xml

    --web.listen-addressに物理ホスト名を指定する。

    --web.listen-address="ホスト名:ポート"

    fluentd

    なし

    該当なし

    jpc_windows_exporter

    Agentパス\binのサービス定義ファイル

    --telemetry.addrに物理ホストのIPアドレスを指定する。

    jpc_ya_cloudwatch_exporter

    Agentパス\binのサービス定義ファイル

    -listen-addressに物理ホストのIPアドレスを指定する。

    jpc_promitor_scraper

    Agentパス\conf\promitor\scraperのPromitor Scraper runtime設定ファイル

    resourceDiscovery.hostに物理ホストのIPアドレスを指定する。

    jpc_promitor_resource_discovery

    なし

    該当なし

    jpc_script_exporter

    Agentパス\binのサービス定義ファイル

    --web.listen-addressに物理ホストのIPアドレスを指定する。

    jpc_fluentd（ログメトリクス機能）

    Agentパス\conf\userのログメトリクス定義ファイル

    bindに物理ホストのIPアドレスを指定する。

    また，下記の定義ファイルの変更個所に"IP"を設定します。

    サービス

    対象ファイル

    変更個所

    • imagent

    • imagentproxy

    Agentパス\conf\jpc_imagentcommon.json

    JP1_BIND_ADDRに"IP"を指定する。

    論理ホストでは，下記の定義ファイルの変更個所に論理ホスト名を設定します。

    サービス

    対象ファイル

    変更個所

    imagent

    共有フォルダ\jp1ima\conf\jpc_imagent_service.xml

    次のようにコマンドラインオプション-hostnameを<arguments>に追記する。

    <arguments>

    -hostname 論理ホスト名

    </arguments>

    image proxy

    共有フォルダ\jp1ima\conf\jpc_imagentproxy_service.xml

    次のようにコマンドラインオプション-hostnameを<arguments>に追記する。

    <arguments>

    -hostname 論理ホスト名

    </arguments>

    imagentaction

    共有フォルダ\jp1ima\conf\jpc_imagentaction_service.xml

    次のようにコマンドラインオプション-hostnameを<arguments>に追記する。

    <arguments>

    -hostname 論理ホスト名

    </arguments>

    prometheus_server

    共有フォルダ\jp1ima\conf\jpc_prometheus_server_service.xml

    --web.listen-addressに論理ホスト名を指定する。

    --web.listen-address="ホスト名:ポート"

    alertmanager

    共有フォルダ\jp1ima\conf\jpc_alertmanager_service.xml

    --web.listen-addressに論理ホスト名を指定する。

    --web.listen-address="ホスト名:ポート"

    windows_exporter

    共有フォルダ\jp1ima\conf\jpc_windows_exporter_service.xml

    --telemetry.addrに論理ホスト名を指定する。

    --telemetry.addr="ホスト名:ポート"

    blackbox_exporter

    共有フォルダ\jp1ima\conf\jpc_blackbox_exporter_service.xml

    --web.listen-addressに論理ホスト名を指定する。

    --web.listen-address="ホスト名:ポート"

    fluentd

    なし

    該当なし

    jpc_windows_exporter

    共有フォルダ\jp1ima\confのサービス定義ファイル

    --telemetry.addrに論理ホストのIPアドレスを指定する。

    jpc_ya_cloudwatch_exporter

    共有フォルダ\jp1ima\confのサービス定義ファイル

    -listen-addressに論理ホストのIPアドレスを指定する。

    jpc_promitor_scraper

    共有フォルダ\jp1ima\conf\promitor\scraperのPromitor Scraper runtime設定ファイル

    resourceDiscovery.hostに論理ホストのIPアドレスを指定する。

    jpc_promitor_resource_discovery

    なし

    該当なし

    script_exporter

    共有フォルダ\jp1ima\confのサービス定義ファイル

    --web.listen-addressに論理ホストのIPアドレスを指定する。

    jpc_fluentd（ログメトリクス機能）

    共有フォルダ\jp1ima\conf\userのログメトリクス定義ファイル

    bindに論理ホストのIPアドレスを指定する。

    また，下記の定義ファイルの変更個所に"IP"を設定します。

    サービス

    対象ファイル

    変更個所

    • imagent

    • imagentproxy

    共有フォルダ\jp1ima\conf\jpc_imagentcommon.json

    JP1_BIND_ADDRに"IP"を指定する。

    promitor_scraper，promitor_resource_discoveryについては，論理ホスト用に新しくポートを用意します。

    次に示す定義ファイルの個所に，用意したポート番号を設定します。

    サービス

    対象ファイル

    変更個所

    設定する値

    promitor_scraper

    共有フォルダ\jp1ima\conf\promitor\scraperのPromitor Scraper runtime設定ファイル

    server.httpPort

    promitor_scraperのポート番号

    resourceDiscovery.port

    promitor_resource_discoveryのポート番号

    共有フォルダ\jp1ima\confのPromitorディスカバリ設定ファイル

    targets

    promitor_scraperのポート番号

    promitor_resource_discovery

    共有フォルダ\jp1ima\conf\promitor\resource-discoveryのPromitor Resource Discovery runtime設定ファイル

    server.httpPort

    promitor_resource_discoveryのポート番号

  8. サービス定義ファイルのサービスIDと表示名に論理ホスト名を付与する。

    共有フォルダ\jp1ima\confにあるすべてのサービス定義ファイルに対して，ファイル内に記載されている<id>と<name>に論理ホスト名を付与します。

    サービス定義ファイルのファイル名：jpc_サービス名_service.xml

    使用しないサービスに対しても実施してください。

    jpc_alertmanager_service.xmlの場合の編集例を次に示します。

    変更前

    変更後

    <id>jpc_alertmanager</id>

    <id>jpc_alertmanager_論理ホスト名</id>

    <name>JPC Alertmanager</name>

    <name>JPC Alertmanager 論理ホスト名</name>

  9. サービス定義ファイルのファイル名に論理ホスト名を付与する。

    共有フォルダ\jp1ima\conf下にあるサービス定義ファイルのファイル名に論理ホスト名を付与します。

    変更前のファイル名：jpc_サービス名_service.xml

    変更後のファイル名：jpc_サービス名_service_論理ホスト名.xml

    使用しないサービスに対しても実施してください。

    jpc_alertmanager_service.xmlの場合の例を次に示します。

    変更前のファイル名

    変更後のファイル名

    jpc_alertmanager_service.xml

    jpc_alertmanager_service_論理ホスト名.xml

  10. サービス定義ファイルをインストール先フォルダにコピーする。

    共有フォルダ\jp1ima\conf下にあるサービス定義ファイル（手順8でファイル名を変更したファイル）を，実行系サーバと待機系サーバの両方のAgentパス\binにコピーします。

  11. 共有フォルダにあるサービス定義ファイルを削除する。

    共有フォルダ\jp1ima\conf下にあるサービス定義ファイル（手順9のコピー元ファイル）は不要であるため，削除します。

  12. 論理ホスト用のWindowsサービス化プログラムを生成する。

    実行系サーバと待機系サーバの両方で，Agentパス\binにあるWindowsサービス化プログラムをコピーして，論理ホスト用のWindowsサービス化プログラムを作成します。

    ファイル名を変更するのではなく，コピーする点に注意してください。コピー元のファイルも残してください。

    コピー元のファイル名：jpc_サービス名_service.exe

    コピー先のファイル名：jpc_サービス名_service_論理ホスト名.exe

    使用しないサービスに対しても実施してください。

    jpc_alertmanager_service.exeの場合の例を次に示します。

    コピー元ファイル名

    コピー先ファイル名

    jpc_alertmanager_service.exe

    jpc_alertmanager_service_論理ホスト名.exe

  13. 論理ホスト用のサービスをWindowsに登録する。

    論理ホストで使用するサービスについて，実行系サーバと待機系サーバの両方で，論理ホスト用のサービスをWindowsに登録します。

    論理ホストのサービスの登録には，次のコマンドを使用します。

    Agentパス\tools\jpc_service -on サービスキー -h 論理ホスト名

    Alertmanagerのサービスを登録する場合の例を次に示します。

    Agentパス\tools\jpc_service -on jpc_alertmanager -h 論理ホスト名

    また，論理ホストで使用しないサービスについて，次に示すディスカバリ設定ファイルを，共有フォルダ\jp1ima\confフォルダから共有フォルダ\jp1ima\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

    なし

  14. Windowsサービスが登録されたことを確認する。

    実行系サーバと待機系サーバの両方で，Windowsサービスを表示して，論理ホスト用のサービスが登録されたことを確認します。

    論理ホスト用のサービスの名称は，手順7で<name>に設定した名称となります。

  15. 必要な設定を行う。

    「7.3.7 統合エージェントホストでのJP1/IM - Agentの新規インストール時のセットアップ（Windowsの場合）」，「1.21.2 JP1/IM - Agentの設定」を参照して必要な設定変更を行います。

  16. クラスタソフトに論理ホスト用のサービスを登録する。

    JP1/IM - Agentのサービスのクラスタソフトへの登録については，「7.5 新規インストール・セットアップでのクラスタソフトへの登録（Windowsの場合）」を参照してください。

    また，次に示すサービスについて，使用するサービスだけをクラスタソフトに登録します。

    サービス名

    依存関係

    jpc_windows_exporter_service_論理ホスト名

    • IPアドレスリソース

    • 物理ディスクリソース

    jpc_cloudwatch_exporter_service_論理ホスト名

    jpc_promitor_scraper_service_論理ホスト名

    jpc_promitor_resource_discovery_service_論理ホスト名

    jpc_script_exporter_service_論理ホスト名

    jpc_fluentd_service_論理ホスト名

    jpc_imagentaction_service_論理ホスト名

  17. クラスタの設定でJP1/IM - Agentのサービスが停止したと判定する期間を1分に設定する。

    統合オペレーション・ビューアーに定義ファイルをアップロードすると，定義ファイルを配置した後にサービスの再起動が行われることがあります。また，アップロードした定義ファイルの内容が不正でサービスの起動に失敗した場合，定義ファイルを元に戻してサービスを起動します。

    上記のように，一時的にサービスが停止することがあるため，クラスタが一時的なサービス停止を検知しないように設定する必要があります。

  18. 動作に問題がないか確認する。

    • クラスタソフトからサービスを起動します。

    • フェールオーバーさせます。

ページの先頭へ

Copyright (C) 2023, 2024 Hitachi, Ltd.

Copyright (C) 2023, 2024 Hitachi Solutions, Ltd.