![[目次]](FIGURE/CONTENT.GIF)
![[用語]](FIGURE/GLOSS.GIF)
![[索引]](FIGURE/INDEX.GIF)
![[前へ]](FIGURE/FRONT.GIF)
![[次へ]](FIGURE/AFTER.GIF)
JP1/Performance Management - Agent Option for Enterprise Applications
ここでは，クラスタシステムでPerformance Managementを運用するための，セットアップについて説明します。
- 注意
- JPC_HOSTNAME環境変数は，Performance Managementで使用していますので，環境変数として設定しないでください。誤って設定した場合は，Performance Managementが正しく動作しません。
- ＜この項の構成＞
- (1) PFM - Agent for Enterprise Applicationsを登録する
- (2) 実行系ノードの論理ホスト環境をセットアップする
- (3) 待機系の論理ホスト環境をセットアップする
- (4) クラスタソフトへ登録する
- (5) 起動・停止の確認
- (6) クラスタシステムでの環境を設定する
(1) PFM - Agent for Enterprise Applicationsを登録する
Performance Managementシステムに，PFM - Agent for Enterprise Applicationsを追加する場合には，PFM - Agent for Enterprise Applicationsを登録するためのセットアップが必要です。
PFM - Managerのバージョンが08-50以降の場合，PFM - Agentの登録は自動で行われるため，ここで説明する手順は不要です。ただし，PFM - Managerのリリースノートに記載されていないデータモデルバージョンのPFM - Agentは手動で登録する必要があります。なお，PFM - Agent for Enterprise Applicationsのデータモデルのバージョンについては，「付録I バージョン互換」を参照してください。
PFM - Agent for Enterprise Applicationsの登録は，PFM - ManagerおよびPFM - Web Consoleで実施します。PFM - Agent for Enterprise Applicationsを登録する手順は非クラスタシステムの場合と同じです。手順については，「3.1.4(2) PFM - Agent for Enterprise Applicationsの登録」を参照してください。
実行系ノードで，PFM - Agent for Enterprise Applicationsの論理ホスト環境をセットアップします。
- 注意
- セットアップを実施する前に，Performance Managementシステム全体で，Performance Managementのプログラムのサービスをすべて停止してください。サービスの停止方法については，マニュアル「JP1/Performance Management システム構築・運用ガイド」のPerformance Managementの起動と停止について説明している章を参照してください。
共有ディスクがマウントされていることを確認します。共有ディスクがマウントされていない場合は，共有ディスクをマウントしてください。
(b) PFM - Agent for Enterprise Applicationsの論理ホスト環境をセットアップする
jpchasetup createコマンドを実行して論理ホスト環境を作成します。コマンドを実行すると，共有ディスクに必要なデータがコピーされ，論理ホスト用の定義を設定して，論理ホスト環境が作成されます。
手順を次に示します。
- jpchasetup createコマンドを実行して，PFM - Agent for Enterprise Applicationsの論理ホスト環境を作成する。
次のようにコマンドを実行します。
論理ホスト名は，-lhostで指定します。ここでは，論理ホスト名をjp1-halr3としています。DNS運用をしている場合はドメイン名を省略した論理ホスト名を指定してください。
共有ディスクのディレクトリ名は，-dの環境ディレクトリ名に指定します。例えば-d /jp1と指定すると/jp1/jp1pcが作成されて，論理ホスト環境のファイルが作成されます。
- jpchasetup listコマンドを実行して，論理ホストの設定を確認する。
次のようにコマンドを実行します。
作成した論理ホスト環境が正しいことを確認してください。
jpcnshostnameコマンドを実行して，PFM - Agent for Enterprise Applicationsを管理するPFM - Managerを設定します。
- jpcnshostnameコマンドを実行して，接続先PFM - Managerを設定する。
次のようにコマンドを実行します。
接続先PFM - Managerのホスト名は，-sオプションで指定します。接続先PFM - Managerが論理ホスト運用されている場合は，-sオプションに接続先PFM - Managerの論理ホスト名を指定します。ここでは，PFM - Managerの論理ホスト名をjp1-halとしています。
また，PFM - Agent for Enterprise Applicationsの論理ホスト名は，-lhostで指定します。ここでは，PFM - Agent for Enterprise Applicationsの論理ホスト名をjp1-halr3としています。
jpcinssetupコマンドを実行して，PFM - Agent for Enterprise Applicationsのインスタンス環境を設定します。
- jpcinssetupコマンドを実行する。
次のようにコマンドを実行します。
論理ホスト名は，-lhostで指定します。ここでは，PFM - Agent for Enterprise Applicationsの論理ホスト名をjp1-halr3としています。
- SAPシステムのインスタンス環境を設定する。
設定するインスタンス環境は，非クラスタシステムの場合と同じです。設定するインスタンス情報については，「3.1.4(4) インスタンス環境の設定」を参照してください。
(e) その他のPerformance Managementのプログラムの論理ホスト環境をセットアップする
PFM - Agent for Enterprise Applicationsのほかに，同じ論理ホストにセットアップするPFM - ManagerやPFM - Agentがある場合は，この段階でセットアップしてください。
セットアップ手順については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，クラスタシステムでの構築と運用について説明している章，または各PFM - Agentマニュアルの，クラスタシステムでの運用について説明している章を参照してください。
ファイアウォールがあるネットワーク環境でPerformance Managementのプログラムを運用する場合だけに必要な設定です。ファイアウォール経由でPerformance Managementのプログラム間の通信をする場合には，jpcnsconfig portコマンドを使用してポート番号を設定します。
ポート番号の設定方法については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，インストールとセットアップについて説明している章，およびクラスタシステムでの構築と運用について説明している章を参照してください。
複数のLANに接続されたネットワーク環境でPerformance Managementを運用するときに使用するIPアドレスを指定したい場合は，IPアドレスの設定をします。IPアドレスを設定したい場合は，jpchostsファイルの内容を直接編集します。
IPアドレスの設定方法については，マニュアル「JP1/Performance Management システム構築・運用ガイド」のインストールとセットアップについて説明している章を参照してください。
- 注意
- jpchostsファイルを編集した場合は，jpchostsファイルを実行系ノードから待機系ノードにコピーしてください。
PFM - Agent for Enterprise Applicationsの論理ホスト環境が作成できたら，環境定義をファイルにエクスポートします。エクスポートでは，その論理ホストにセットアップされているPerformance Managementのプログラムの定義情報を一括してファイル出力します。同じ論理ホストにほかのPerformance Managementのプログラムをセットアップする場合は，セットアップが一とおり済んだあとにエクスポートしてください。
論理ホスト環境定義をエクスポートする手順を次に示します。
- jpchasetup exportコマンドを実行して，論理ホスト環境定義をエクスポートする。
これまでの手順で作成した論理ホスト環境の定義情報を，エクスポートファイルに出力します。エクスポートファイル名は任意です。
例えば，lhostexp.txtファイルに論理ホスト環境定義をエクスポートする場合，次のようにコマンドを実行します。
(i) 論理ホスト環境定義ファイルを待機系ノードにコピーする
「4.4.4(2)(h) 論理ホスト環境定義をエクスポートする」でエクスポートした論理ホスト環境定義ファイルを，実行系ノードから待機系ノードにコピーします。
ファイルシステムをアンマウントして，作業を終了します。なお，その共有ディスクを続けて使用する場合は，ファイルシステムをアンマウントする必要はありません。
- 注意
- 共有ディスクがアンマウントされていても，指定した環境ディレクトリにjp1pcディレクトリがあり，jp1pcディレクトリ以下のファイルがある場合は，共有ディスクをマウントしないでセットアップしています。この場合は次の手順で対処してください。
- ローカルディスク上の指定した環境ディレクトリにあるjp1pcディレクトリをtarコマンドでアーカイブする。
- 共有ディスクをマウントする。
- 共有ディスク上に指定した環境ディレクトリがない場合は，環境ディレクトリを作成する。
- 共有ディスク上の環境ディレクトリにtarファイルを展開する。
- 共有ディスクをアンマウントする。
- ローカルディスク上の指定した環境ディレクトリにあるjp1pcディレクトリ以下を削除する。
待機系ノードで，PFM - Agent for Enterprise Applicationsの論理ホスト環境をセットアップします。
実行系ノードからコピーしたエクスポートファイルを，待機系ノードにインポートします。
実行系ノードで作成した論理ホストのPerformance Managementのプログラムを，待機系ノードで実行するための設定には，jpchasetup importコマンドを使用します。一つの論理ホストに複数のPerformance Managementのプログラムがセットアップされている場合は，一括してインポートされます。
なお，このコマンドを実行するときには，共有ディスクをマウントしておく必要はありません。
- jpchasetup importコマンドを実行して，論理ホスト環境定義をインポートする。
次のようにコマンドを実行します。
コマンドを実行すると，待機系ノードの環境を，エクスポートファイルの内容と同じ環境になるように設定変更します。これによって，論理ホストのPFM - Agent for Enterprise Applicationsを起動するための設定が実施されます。
また，セットアップ時にjpcnsconfig portコマンドで固定のポート番号を設定している場合も，同様に設定されます。
- jpchasetup listコマンドを実行して，論理ホスト設定を確認する。
次のようにコマンドを実行します。
実行系ノードでjpchasetup listを実行した時と同じ内容が表示されることを確認してください。
Performance Managementのプログラムを論理ホスト環境で運用する場合は，クラスタソフトに登録して，クラスタソフトからの制御でPerformance Managementのプログラムを起動したり停止したりするように環境設定します。
ここでは，PFM - Agent for Enterprise Applicationsをクラスタソフトに登録するときに設定する内容を説明します。
(a) クラスタソフトへPFM - Agent for Enterprise Applicationsを登録する
一般にUNIXのクラスタソフトに，アプリケーションを登録する場合に必要な項目は「起動」「停止」「動作監視」「強制停止」の四つがあります。
PFM - Agent for Enterprise Applicationsでの設定方法を次の表に示します。
表4-5 クラスタソフトに登録するPFM - Agent for Enterprise Applicationsの制御方法
項目 説明 起動 次のコマンドを順に実行して，PFM - Agent for Enterprise Applicationsを起動する。
/opt/jp1pc/tools/jpcstart act lhost=論理ホスト名 /opt/jp1pc/tools/jpcstart agtm lhost=論理ホスト名 inst=インスタンス名起動するタイミングは，共有ディスクおよび論理IPアドレスが使用できる状態になったあととする。停止 次のコマンドを順に実行して，PFM - Agent for Enterprise Applicationsを停止する。
/opt/jp1pc/tools/jpcstop agtm lhost=論理ホスト名 inst=インスタンス名 /opt/jp1pc/tools/jpcstop act lhost=論理ホスト名停止するタイミングは，共有ディスクおよび論理IPアドレスを使用できない状態にする前とする。
なお，障害などでサービスが停止しているときは，jpcstopコマンドの戻り値が3になる。この場合はサービスが停止されているので，正常終了と扱う。戻り値で実行結果を判定するクラスタソフトの場合は，戻り値を0にするなどで対応すること。動作監視 次のプロセスが動作していることを，psコマンドで確認する。
ps -ef | grep "プロセス名 論理ホスト名" | grep -v "grep 監視対象のプロセス"監視対象のプロセスは，次のとおり。
jpcagtm,agtm/jpcsto,jpcahプロセス名ついては，「付録D プロセス一覧」またはマニュアル「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コマンドで論理ホストがすべて表示されているか確認してください。表示が途中で切れてしまっている場合は表示されている文字までを監視するように設定してください。
クラスタソフトからの操作で，Performance Managementのプログラムの起動および停止を各ノードで実行し，正常に動作することを確認してください。
Performance Managementのプログラムのセットアップ終了後，PFM - Web Consoleから，運用に合わせて監視対象の稼働状況についてのレポートを表示できるようにしたり，監視対象で問題が発生したときにユーザーに通知できるようにしたりするために，Performance Managementのプログラムの環境を設定します。
Performance Managementのプログラムの環境の設定方法については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，クラスタシステムでの構築と運用について説明している章を参照してください。
All Rights Reserved. Copyright (C) 2006, 2008, Hitachi, Ltd.