Hitachi

JP1 Version 12　JP1/Performance Management - Remote Monitor for Platform

5.4.4　UNIX版のクラスタシステムでのセットアップ手順

ここでは，クラスタシステムでPerformance Managementを運用するためのセットアップについて説明します。

クラスタシステムで運用する場合，実行系ノードと待機系ノードをそれぞれセットアップする必要があります。実行系ノード，待機系ノードの順にセットアップしてください。

なお，[図データ]は実行系ノードで実施する項目を，[図データ]は待機系ノードで実施する項目を示します。また，[図データ]は次に示すセットアップ項目を示します。

重要

環境変数JPC_HOSTNAMEは，Performance Managementで使用しています。このため，JPC_HOSTNAMEを環境変数として設定しないでください。設定した場合は，Performance Managementが正しく動作しません。

〈この項の構成〉

(1)　PFM - RM for Platformの登録[図データ]　[図データ]　[図データ]

Performance ManagementシステムでPFM - RM for Platformを一元管理するには，PFM - ManagerおよびPFM - Web Consoleに，PFM - RM for Platformを登録する必要があります。

登録する条件および手順はクラスタシステムを適用していない場合と同じです。登録する条件および手順については，「3.2.4(2)　PFM - RM for Platformの登録」を参照してください。

ページの先頭へ

(2)　共有ディスクのマウント[図データ]

共有ディスクがマウントされていることを確認します。

共有ディスクがマウントされていない場合は，クラスタソフトやボリュームマネージャでの操作で，共有ディスクをマウントしてください。

ページの先頭へ

(3)　PFM - RM for Platformの論理ホストのセットアップ[図データ]

jpcconf ha setupコマンドを実行して論理ホスト環境を作成します。コマンドを実行すると，共有ディスクに必要なデータがコピーされ，論理ホスト用の定義が設定されて，論理ホスト環境が作成されます。

注意

コマンドを実行する前に，Performance Managementシステム全体で，Performance Managementのプログラムおよびサービスをすべて停止してください。サービスの停止方法については，マニュアル「JP1/Performance Management 運用ガイド」のPerformance Managementの起動と停止について説明している章を参照してください。

手順を次に示します。

  1. jpcconf ha setupコマンドを実行して，PFM - RM for Platformの論理ホスト環境を作成する。

    次のようにコマンドを実行します。

    jpcconf ha setup -key RMPlatform -lhost jp1-halrmp -d /jp1

    論理ホスト名は，-lhostオプションで指定します。ここでは，論理ホスト名をjp1-halrmpとしています。DNS運用をしている場合はドメイン名を省略した論理ホスト名を指定してください。

    共有ディスクのディレクトリ名は，-dオプションの環境ディレクトリ名に指定します。例えば-d /jp1と指定すると/jp1/jp1pcが作成されて，論理ホスト環境のファイルが作成されます。

  2. jpcconf ha listコマンドを実行して，論理ホストの設定を確認する。

    次のようにコマンドを実行します。

    jpcconf ha list -key all

    作成した論理ホスト環境が正しいことを確認してください。

ページの先頭へ

(4)　接続先PFM - Managerの設定[図データ]

jpcconf mgrhost defineコマンドを実行して，PFM - RM for Platformを管理するPFM - Managerを設定します。

  1. jpcconf mgrhost defineコマンドを実行して，接続先PFM - Managerを設定する。

    次のようにコマンドを実行します。

    jpcconf mgrhost define -host jp1-hal -lhost jp1-halrmp

    接続先PFM - Managerのホスト名は，-hostオプションで指定します。接続先PFM Managerが論理ホストで運用されている場合は，-hostオプションに接続先PFM - Managerの論理ホスト名を指定します。ここでは，PFM - Managerの論理ホスト名をjp1-halとしています。

    PFM - RM for Platformの論理ホスト名は，-lhostオプションで指定します。ここでは，PFM - RM for Platformの論理ホスト名をjp1-halrmpとしています。

    ここでは，対話形式の実行例を示していますが，jpcconf mgrhost defineコマンドは非対話形式でも実行できます。jpcconf mgrhost defineコマンドの詳細については，マニュアル「JP1/Performance Management リファレンス」のコマンドについて説明している章を参照してください。

ページの先頭へ

(5)　インスタンス環境の設定[図データ]

jpcconf inst setupコマンドを実行して，PFM - RM for Platformのインスタンス環境を設定します。

設定手順は，クラスタシステムを適用していない場合と同じです。ただし，クラスタシステムの場合，jpcconf inst setupコマンドの実行時に，-lhostオプションで論理ホスト名を指定する必要があります。

クラスタシステムの場合のjpcconf inst setupコマンドの指定方法を次に示します。 

jpcconf inst setup -key RMPlatform -lhost 論理ホスト名 -inst インスタンス名

ここでは，対話形式の実行例を示していますが，jpcconf inst setupコマンドは非対話形式でも実行できます。jpcconf inst setupコマンドの詳細については，マニュアル「JP1/Performance Management リファレンス」のコマンドについて説明している章を参照してください。

また，このほかの設定内容や手順については，「3.2.4(3)　インスタンス環境の設定」を参照してください。

ページの先頭へ

(6)　監視対象の設定[図データ]

jpcconf target setupコマンドを実行して，PFM - RM for Platformの監視対象ホストの情報を設定します。

設定手順は，クラスタシステムを適用していない場合と同じです。

ただし，クラスタシステムの場合，jpcconf target setupコマンドの実行時に，-lhostオプションで論理ホスト名を指定する必要があります。

クラスタシステムの場合のjpcconf target setupコマンドの指定方法を次に示します。 

jpcconf target setup -key RMPlatform -lhost 論理ホスト名 -inst インスタンス名 -target 監視対象名

ここでは，対話形式の実行例を示していますが，jpcconf target setupコマンドは非対話形式でも実行できます。jpcconf target setupコマンドの詳細については，マニュアル「JP1/Performance Management リファレンス」のコマンドについて説明している章を参照してください。

また，設定内容や手順については，「3.2.4(4)　監視対象の設定」を参照してください。

ページの先頭へ

(7)　他Performance Managementプログラムの論理ホストのセットアップ[図データ]　[図データ]

PFM - RM for Platformのほかに，同じ論理ホストにセットアップするPFM - Manager，PFM - AgentまたはPFM - RMがある場合は，この段階でセットアップしてください。

セットアップ手順については，マニュアル「JP1/Performance Management 運用ガイド」のクラスタシステムでの構築と運用について説明している章を参照してください。

ページの先頭へ

(8)　ネットワークの設定[図データ]　[図データ]

Performance Managementを使用するネットワーク構成に応じて，ネットワーク環境の設定を変更したい場合に必要な設定です。

ネットワーク環境の設定として，次の2つの項目があります。必要に応じて設定を変更してください。

ページの先頭へ

(9)　ログのファイルサイズ変更[図データ]　[図データ]

Performance Managementの稼働状況を，Performance Management独自のログファイルに出力します。このログファイルを「共通メッセージログ」と呼びます。このファイルサイズを変更したい場合にだけ，必要な設定です。

詳細については，マニュアル「JP1/Performance Management 設計・構築ガイド」の，インストールとセットアップについて説明している章を参照してください。

ページの先頭へ

(10)　パフォーマンスデータの格納先の変更[図データ]　[図データ]

PFM - RM for Platformで管理されるパフォーマンスデータを格納するデータベースの保存先，バックアップ先，エクスポート先，またはインポート先のディレクトリを変更したい場合に必要な設定です。

設定方法については，「3.6.1　パフォーマンスデータの格納先の変更」を参照してください。

ページの先頭へ

(11)　動作ログ出力の設定[図データ]　[図データ]

アラーム発生時に動作ログを出力したい場合に必要な設定です。

動作ログとは，システム負荷などのしきい値オーバーに関するアラーム機能と連動して出力される履歴情報です。設定方法については，「付録J　動作ログの出力」を参照してください。

ページの先頭へ

(12)　論理ホスト環境定義ファイルのエクスポート[図データ]

PFM - RM for Platformの論理ホスト環境が作成できたら，環境定義をファイルにエクスポートします。

エクスポートでは，その論理ホストにセットアップされているPerformance Managementのプログラムの定義情報をファイルに一括出力します。同じ論理ホストにほかのPerformance Managementのプログラムをセットアップする場合は，セットアップが一とおり済んだあとにエクスポートしてください。

論理ホスト環境定義をエクスポートする手順を次に示します。

  1. jpcconf ha exportコマンドを実行して，論理ホスト環境定義をエクスポートする。

    これまでの手順で作成した論理ホスト環境の定義情報を，エクスポートファイルに出力します。エクスポートファイル名は任意です。

    例えば，lhostexp.txtファイルに論理ホスト環境定義をエクスポートする場合，次のようにコマンドを実行します。 

    jpcconf ha export -f lhostexp.txt

    ここでは，対話形式の実行例を示していますが，jpcconf ha exportコマンドは非対話形式でも実行できます。jpcconf ha exportコマンドの詳細については，マニュアル「JP1/Performance Management リファレンス」のコマンドについて説明している章を参照してください。

ページの先頭へ

(13)　論理ホスト環境定義ファイルの待機系ノードへのコピー[図データ]　[図データ]

「(12)　論理ホスト環境定義ファイルのエクスポート」でエクスポートした論理ホスト環境定義ファイルを，実行系ノードから待機系ノードにコピーします。

ページの先頭へ

(14)　共有ディスクのアンマウント[図データ]　[図データ]

ファイルシステムをアンマウントして，作業を終了します。

なお，その共有ディスクを続けて使用する場合は，ファイルシステムをアンマウントする必要はありません。

注意

共有ディスクがアンマウントされていても，指定した環境ディレクトリにjp1pcディレクトリがあり，jp1pcディレクトリ以下にファイルがある場合は，共有ディスクをマウントしないでセットアップしています。

この場合は次の手順で対処してください。

  1. ローカルディスク上の指定した環境ディレクトリにあるjp1pcディレクトリをtarコマンドでアーカイブする。

  2. 共有ディスクをマウントする。

  3. 共有ディスク上に指定した環境ディレクトリがない場合は，環境ディレクトリを作成する。

  4. 共有ディスク上の環境ディレクトリにtarファイルを展開する。

  5. 共有ディスクをアンマウントする。

  6. ローカルディスク上の指定した環境ディレクトリにあるjp1pcディレクトリ以下を削除する。

ページの先頭へ

(15)　論理ホスト環境定義ファイルのインポート[図データ]

実行系ノードからコピーしたエクスポートファイルを，待機系ノードにインポートします。

実行系ノードで作成した論理ホストのPerformance Managementのプログラムを，待機系ノードで実行するための設定には，jpcconf ha importコマンドを使用します。1つの論理ホストに複数のPerformance Managementのプログラムがセットアップされている場合は，一括してインポートされます。

なお，このコマンドを実行するときには，共有ディスクをマウントしておく必要はありません。

論理ホスト環境定義ファイルをインポートする手順を次に示します。

  1. jpcconf ha importコマンドを実行して，論理ホスト環境定義をインポートする。

    次のようにコマンドを実行します。

    jpcconf ha import -f lhostexp.txt

    ここでは，対話形式の実行例を示していますが，jpcconf ha importコマンドは非対話形式でも実行できます。jpcconf ha importコマンドの詳細については，マニュアル「JP1/Performance Management リファレンス」のコマンドについて説明している章を参照してください。

    コマンドを実行すると，待機系ノードの環境が，エクスポートファイルの内容と同じ環境になるように変更されます。これによって，論理ホストのPFM - RM for Platformを起動するための設定が実施されます。

    また，セットアップ時にjpcconf port defineコマンドで固定のポート番号を設定している場合も，同様に設定されます。

  2. jpcconf ha listコマンドを実行して，論理ホスト設定を確認する。

    次のようにコマンドを実行します。

    jpcconf ha list -key all

    実行系ノードでjpcconf ha listコマンドを実行したときと同じ内容が表示されることを確認してください。

ページの先頭へ

(16)　クラスタソフトへのPFM - RM for Platformの登録[図データ]　[図データ]

Performance Managementのプログラムを論理ホスト環境で運用する場合は，クラスタソフトに登録して，クラスタソフトからの制御でPerformance Managementのプログラムを起動したり停止したりするように環境設定します。

クラスタソフトへPFM - RM for Platformを登録する方法は，クラスタソフトのマニュアルを参照してください。

PFM - RM for Platformをクラスタソフトに登録するときに設定する内容を説明します。

UNIXのクラスタソフトにアプリケーションを登録する場合，一般的に必要な項目は「起動」「停止」「動作監視」および「強制停止」の4つです。

PFM - RM for Platformでの設定方法を次の表に示します。

表5‒4　クラスタソフトに登録するPFM - RM for Platformの制御方法

項番

項目

説明

1

起動

次のコマンドを順に実行して，PFM - RM for Platformを起動します。

  1. jpcspm start -key AH -lhost 論理ホスト名

  2. jpcspm start -key RMPlatform -lhost 論理ホスト名 -inst インスタンス名

起動するタイミングは，共有ディスクと論理IPアドレスが使用できる状態になったあとです。

2

停止

次のコマンドを順に実行して，PFM - RM for Platformを停止します。

  1. jpcspm stop -key RMPlatform -lhost 論理ホスト名 -inst インスタンス名

  2. jpcspm stop -key AH -lhost 論理ホスト名

停止するタイミングは，共有ディスクと論理IPアドレスが使用できない状態になる前です。

なお，障害などでサービスが停止している場合は，jpcspm stopコマンドの戻り値が3になります。この場合はサービスが停止されているので，正常終了で処理されます。

戻り値で実行結果を判定するクラスタソフトの場合は，戻り値を0に設定するなどの対応をしてください。

3

動作監視

psコマンドを実行して，次のプロセスが動作していることを確認します。

  • ps -ef | grep "プロセス名 論理ホスト名" | grep -v "grep 監視対象のプロセス"

監視対象のプロセスを次に示します。

  • jpcagt7，agt7/jpcsto,jpcah

プロセス名については，マニュアル「JP1/Performance Management 運用ガイド」のクラスタシステムでの構築と運用について説明している章を参照してください。

なお，Performance Managementの運用中，メンテナンスなどの理由でプロセスが一時的に停止することがあります。これに備えて，動作監視を抑止する方法（例えば，メンテナンス中を意味するファイルがあると監視をしないなど）を用意することをお勧めします。

4

強制停止

強制停止が必要な場合は，次のコマンドを実行します。

  • jpcspm stop -key all -lhost 論理ホスト名 -kill immediate

-keyオプションのサービスキーに指定できるのは，allだけです。

注意

コマンドを実行すると，指定した論理ホスト環境すべてのPerformance Managementのプロセスが，SIGKILL送信によって強制停止されます。このとき，サービス単位ではなく，論理ホスト単位でPerformance Managementが強制停止されます。

強制停止は，通常の停止を実行しても停止できない場合に限って実行するように設定してください。
注意

  • クラスタに登録するPerformance Managementのプログラムは，クラスタで起動や停止を制御します。このため，OS起動時の自動起動設定をしないでください。

  • Performance Managementのプログラムを日本語環境で実行する場合，クラスタソフトに登録するスクリプトでLANG環境変数を設定してから，Performance Managementのコマンドを実行するようにしてください。

  • クラスタソフトがコマンドの戻り値で実行結果を判定する場合は，Performance Managementのコマンドの戻り値をクラスタソフトの期待する値に変換するように設定してください。Performance Managementのコマンドの戻り値については，各コマンドのリファレンスを確認してください。

  • psコマンドで表示される文字の長さはOSによって異なります。論理ホスト名とインスタンス名を合わせて，47文字以内になるように設定してください。また，psコマンドで動作監視する場合，事前にpsコマンドで論理ホストがすべて表示されているか確認してください。表示が途中で切れてしまっている場合は表示されている文字までを監視するように設定してください。なお，psコマンドでプロセス名および論理ホスト名を特定する場合，psコマンドがプロセス名および論理ホスト名の取得に失敗することがあります。psコマンドがプロセス名および論理ホスト名の取得に失敗すると，［　］（角括弧）が付いて表示されるケースがあります。OSのpsコマンドのリファレンスを確認して，コマンドを再実行してください。

  • 監視対象ホストを起動してから，PFM - RM for Platformを起動してください。また，停止する場合は，PFM - RM for Platformを停止してから，監視対象ホストを停止してください。

ページの先頭へ

(17)　クラスタソフトからの起動・停止の確認[図データ]　[図データ]

クラスタソフトからの操作で，Performance Managementのプログラムの起動および停止を各ノードで実行し，正常に動作することを確認してください。

ページの先頭へ

(18)　クラスタシステムでの環境設定[図データ]　[図データ]

Performance Managementのプログラムのセットアップ終了後，PFM - Web Consoleから，運用に合わせて監視対象の稼働状況についてのレポートを表示できるようにしたり，監視対象で問題が発生したときにユーザーに通知できるようにしたりするために，Performance Managementのプログラムの環境を設定します。

Performance Managementのプログラムの環境設定方法については，マニュアル「JP1/Performance Management 運用ガイド」のクラスタシステムでの構築と運用について説明している章を参照してください。

ページの先頭へ

Copyright (C) 2019, 2020, Hitachi, Ltd.

Copyright (C) 2019, 2020, Hitachi Solutions, Ltd.