4.4.4 セットアップ

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

注意
JPC_HOSTNAME環境変数は,Performance Managementで使用していますので,環境変数として設定しないでください。誤って設定した場合は,Performance Managementが正しく動作しません。
<この項の構成>
(1) PFM - Agent for OpenTP1を登録する
(2) 実行系ノードの論理ホスト環境をセットアップする
(3) 待機系の論理ホスト環境をセットアップする
(4) クラスタソフトへ登録する
(5) 起動・停止の確認
(6) クラスタシステムでの環境を設定する

(1) PFM - Agent for OpenTP1を登録する

Performance Managementシステムに,PFM - Agent for OpenTP1を追加する場合には,PFM - Agent for OpenTP1を登録するためのセットアップが必要です。

PFM - Agent for OpenTP1の登録は,PFM - ManagerおよびPFM - Web Consoleで実施します。PFM - Agent for OpenTP1を登録する手順は非クラスタシステムの場合と同じです。手順については,手順については,「3.1.4(2) PFM - Agent for OpenTP1の登録」を参照してください。

(2) 実行系ノードの論理ホスト環境をセットアップする

実行系ノードで,PFM - Agent for OpenTP1の論理ホスト環境をセットアップします。

注意
セットアップを実施する前に,Performance Managementシステム全体で,Performance Managementのプログラムのサービスをすべて停止してください。サービスの停止方法については,マニュアル「JP1/Performance Management システム構築・運用ガイド」の,Performance Managementの起動と停止について説明している章を参照してください。

(a) 共有ディスクをマウントする

共有ディスクがマウントされていることを確認します。共有ディスクがマウントされていない場合は,共有ディスクをマウントしてください。

(b) PFM - Agent for OpenTP1の論理ホスト環境をセットアップする

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

手順を次に示します。

  1. jpchasetup createコマンドを実行して,PFM - Agent for OpenTP1の論理ホスト環境を作成する。
    次のようにコマンドを実行します。

    jpchasetup create agth -lhost jp1-haltp1 -d /jp1

    論理ホスト名は,-lhostで指定します。ここでは,論理ホスト名をjp1-haltp1としています。DNS運用をしている場合はドメイン名を省略した論理ホスト名を指定してください。
    共有ディスクのディレクトリ名は,-dの環境ディレクトリ名に指定します。例えば-d /jp1と指定すると/jp1/jp1pcが作成されて,論理ホスト環境のファイルが作成されます。
  2. jpchasetup listコマンドを実行して,論理ホストの設定を確認する。
    次のようにコマンドを実行します。

    jpchasetup list all

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

(c) 接続先PFM - Managerを設定する

jpcnshostnameコマンドを実行して,PFM - Agent for OpenTP1を管理するPFM - Managerを設定します。

  1. jpcnshostnameコマンドを実行して,接続先PFM - Managerを設定する。
    次のようにコマンドを実行します。

    jpcnshostname -s jp1-hal -lhost jp1-haltp1

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

(d) インスタンス環境を設定する

jpcinssetupコマンドを実行して,PFM - Agent for OpenTP1のインスタンス環境を設定します。

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

    jpcinssetup agth -lhost jp1-haltp1 -inst SDC1

    論理ホスト名は,-lhostで指定します。ここでは,PFM - Agent for OpenTP1の論理ホスト名をjp1-haltp1としています。
  2. OpenTP1のインスタンス環境を設定する。
    設定するインスタンス環境は,非クラスタシステムの場合と同じです。設定するインスタンス情報については,「3.1.4(3) インスタンス環境の設定」を参照してください。

(e) その他のPerformance Managementのプログラムの論理ホスト環境をセットアップする

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

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

(f) ポート番号を設定する

ファイアウォールがあるネットワーク環境でPerformance Managementのプログラムを運用する場合だけに必要な設定です。ファイアウォール経由でPerformance Managementのプログラム間の通信をする場合には,jpcnsconfig portコマンドを使用してポート番号を設定します。

ポート番号の設定方法については,マニュアル「JP1/Performance Management システム構築・運用ガイド」の,インストールとセットアップについて説明している章を参照してください。

(g) IPアドレスを設定する

複数のLANに接続されたネットワーク環境でPerformance Managementを運用するときに使用するIPアドレスを指定したい場合は,IPアドレスの設定をします。IPアドレスを設定したい場合は,jpchostsファイルの内容を直接編集します。

IPアドレスの設定方法については,マニュアル「JP1/Performance Management システム構築・運用ガイド」のインストールとセットアップについて説明している章を参照してください。

注意
jpchostsファイルを編集した場合は,jpchostsファイルを実行系ノードから待機系ノードにコピーしてください。

(h) 論理ホスト環境定義をエクスポートする

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

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

  1. jpchasetup exportコマンドを実行して,論理ホスト環境定義をエクスポートする。
    これまでの手順で作成した論理ホスト環境の定義情報を,エクスポートファイルに出力します。エクスポートファイル名は任意です。
    例えば,lhostexp.txtファイルに論理ホスト環境定義をエクスポートする場合,次のようにコマンドを実行します。

    jpchasetup export -f lhostexp.txt

(i) 論理ホスト環境定義ファイルを待機系ノードにコピーする

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

(j) 共有ディスクをアンマウントする

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

注意
共有ディスクがアンマウントされていても,指定した環境ディレクトリにjp1pcディレクトリがあり,jp1pcディレクトリ以下のファイルがある場合は,共有ディスクをマウントしないでセットアップしています。この場合は次の手順で対処してください。
  1. ローカルディスク上の指定した環境ディレクトリにあるjp1pcディレクトリをtarコマンドでアーカイブする。
  2. 共有ディスクをマウントする。
  3. 共有ディスク上に指定した環境ディレクトリがない場合は,環境ディレクトリを作成する。
  4. 共有ディスク上の環境ディレクトリにtarファイルを展開する。
  5. 共有ディスクをアンマウントする。
  6. ローカルディスク上の指定した環境ディレクトリにあるjp1pcディレクトリ以下を削除する。

(3) 待機系の論理ホスト環境をセットアップする

待機系ノードで,PFM - Agent for OpenTP1の論理ホスト環境をセットアップします。

(a) 論理ホスト環境定義をインポートする

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

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

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

  1. jpchasetup importコマンドを実行して,論理ホスト環境定義をインポートする。
    次のようにコマンドを実行します。

    jpchasetup import -f lhostexp.txt

    コマンドを実行すると,待機系ノードの環境を,エクスポートファイルの内容と同じ環境になるように設定変更します。これによって,論理ホストのPFM - Agent for OpenTP1を起動するための設定が実施されます。
    また,セットアップ時にjpcnsconfig portコマンドで固定のポート番号を設定している場合も,同様に設定されます。
  2. jpchasetup listコマンドを実行して,論理ホスト設定を確認する。
    次のようにコマンドを実行します。

    jpchasetup list all

    実行系ノードでjpchasetup listを実行した時と同じ内容が表示されることを確認してください。

(4) クラスタソフトへ登録する

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

ここでは,PFM - Agent for OpenTP1をクラスタソフトに登録するときに設定する内容を説明します。

(a) クラスタソフトへPFM - Agent for OpenTP1を登録する

一般にUNIXのクラスタソフトに,アプリケーションを登録する場合に必要な項目は「起動」「停止」「動作監視」「強制停止」の四つがあります。

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

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

項目説明
起動次のコマンドを順に実行して,PFM - Agent for OpenTP1を起動する。

/opt/jp1pc/tools/jpcstart act lhost= 論理ホスト名
/opt/jp1pc/tools/jpcstart agth lhost= 論理ホスト名 inst= インスタンス名

起動するタイミングは,共有ディスクおよび論理IPアドレスが使用できる状態になったあととする。
停止次のコマンドを順に実行して,PFM - Agent for OpenTP1を停止する。

/opt/jp1pc/tools/jpcstop agth lhost= 論理ホスト名 inst= インスタンス名
/opt/jp1pc/tools/jpcstop act lhost= 論理ホスト名

停止するタイミングは,共有ディスクおよび論理IPアドレスを使用できない状態にする前とする。
なお,障害などでサービスが停止しているときは,jpcstopコマンドの戻り値が3になる。この場合はサービスが停止されているので,正常終了と扱う。戻り値で実行結果を判定するクラスタソフトの場合は,戻り値を0にするなどで対応すること。
動作監視次のプロセスが動作していることを,psコマンドで確認する。

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

監視対象のプロセスは,次のとおり。

jpcagth,agth/jpcsto,jpcah

プロセス名については,マニュアル「JP1/Performance Management システム構築・運用ガイド」を参照のこと。なお,運用中にメンテナンスなどでPerformance Managementを一時的に停止する場合を想定して,動作監視を抑止する方法(例えば,メンテナンス中のファイルがあると監視をしないなど)を用意しておくことをお勧めする。
強制停止強制停止が必要な場合は,次のコマンドを実行する。

/opt/jp1pc/tools/jpcstop all lhost=論理ホスト名 kill=immediate

第一引数のサービスキーに指定できるのは,allだけである。
注意
コマンドを実行すると,指定した論理ホスト環境すべてのPerformance Managementのプロセスが,SIGKILL送信によって強制停止される。このとき,サービス単位ではなく,論理ホスト単位でPerformance Managementが強制停止される。
なお,強制停止は,通常の停止を実行しても停止できない場合に限って実行するよう設定すること。
注意
  • クラスタに登録するPerformance Managementは,クラスタから起動および停止を制御しますので,OS起動時の自動起動設定をしないでください。
  • Performance Managementを日本語環境で実行する場合,クラスタソフトに登録するスクリプトでLANG環境変数を設定してから,Performance Managementのコマンドを実行するようにしてください。
  • クラスタソフトがコマンドの戻り値で実行結果を判定する場合は,Performance Managementのコマンドの戻り値をクラスタソフトの期待する値に変換するように設定してください。Performance Managementのコマンドの戻り値については,各コマンドのリファレンスを確認してください。
  • psコマンドで表示される文字の長さはOSによって異なります。論理ホスト名とインスタンス名を合わせて,47文字以内になるように設定してください。また,psコマンドで動作監視する場合,事前にpsコマンドで論理ホストがすべて表示されているか確認してください。表示が途中で切れてしまっている場合は表示されている文字までを監視するように設定してください。

(5) 起動・停止の確認

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

(6) クラスタシステムでの環境を設定する

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

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