JP1/Performance Management - Agent Option for Oracle(R) WebLogic Server
ここでは,クラスタシステムでPerformance Managementを運用するための,セットアップについて説明します。
セットアップ手順には,実行系ノードの手順と,待機系ノードの手順があります。実行系ノード,待機系ノードの順にセットアップしてください。
は実行系ノードで行う項目を,
は待機系ノードで行う項目を示します。また,
は使用する環境によって必要になるセットアップ項目,またはデフォルトの設定を変更する場合のオプションのセットアップ項目を示します。
- <この項の構成>
- (1) PFM - Agentの登録
- (2) 共有ディスクをオンラインにする
- (3) PFM - Agentの論理ホストのセットアップ
- (4) 接続先PFM - Managerの設定
- (5) インスタンス環境の設定
- (6) 他Performance Managementプログラムの論理ホストのセットアップ
- (7) ネットワークの設定
- (8) ログのファイルサイズ変更
- (9) パフォーマンスデータの格納先の変更
- (10) 動作ログ出力の設定
- (11) 論理ホスト環境定義ファイルのエクスポート
- (12) 論理ホスト環境定義ファイルの待機系ノードへのコピー
- (13) 共有ディスクをオフラインにする
- (14) 論理ホスト環境定義ファイルのインポート
- (15) クラスタソフトへのPFM - Agentの登録
- (16) クラスタソフトからの起動・停止の確認
- (17) クラスタシステムでの環境設定
PFM - ManagerおよびPFM - Web Consoleを使ってPFM - Agentを一元管理するために,PFM - ManagerおよびPFM - Web ConsoleにPFM - Agent for WebLogic Serverを登録する必要があります。
PFM - Agent for WebLogic Serverを登録する必要があるのは次の場合です。
- Performance Managementシステムに新しくPFM - Agent for WebLogic Serverを追加する場合
- すでに登録しているPFM - Agent for WebLogic Serverのデータモデルのバージョンを更新する場合
登録はPFM - Manager上およびPFM - Web Console上で実施します。手順は非クラスタシステムの場合と同じです。
手順については,「2.1.4(1) PFM - Agent for WebLogic Serverの登録」を参照してください。
共有ディスクがオンラインになっていることを確認します。共有ディスクがオンラインになっていない場合は,クラスタソフトからの操作やボリュームマネージャの操作などで,共有ディスクをオンラインにしてください。
jpcconf ha setup(jpchasetup create)コマンドを実行して論理ホスト環境を作成します。コマンドを実行する前に,Performance Managementシステム全体で,Performance Managementのプログラムおよびサービスをすべて停止してください。サービスの停止方法については,マニュアル「JP1/Performance Management 運用ガイド」のPerformance Managementの起動と停止について説明している章を参照してください。
コマンドを実行すると,共有ディスクに必要なデータがコピーされ,論理ホスト用の定義が設定されて,論理ホスト環境が作成されます。
手順を次に示します。
- jpcconf ha setup(jpchasetup create)コマンドを実行して,PFM - Agent for WebLogic Serverの論理ホスト環境を作成する。
次のようにコマンドを実行します。
論理ホスト名は,-lhostオプションで指定します。ここでは,論理ホスト名をjp1-halsとしています。DNS運用をしている場合はドメイン名を省略した論理ホスト名を指定してください。
jpcconf ha setup -key WebLogic -lhost jp1-hals -d S:\jp1(jpchasetup create agts -lhost jp1-hals -d S:\jp1)
共有ディスクのディレクトリ名は,-dオプションの環境ディレクトリ名に指定します。例えば-d S:\jp1と指定するとS:\jp1\jp1pcが作成されて,論理ホスト環境のファイルが作成されます。
- jpcconf ha list(jpchasetup list)コマンドを実行して,論理ホストの設定を確認する。
次のようにコマンドを実行します。
作成した論理ホスト環境が正しいことを確認してください。
jpcconf ha list all(jpchasetup list all)
jpcconf mgrhost define(jpcnshostname)コマンドを実行して,PFM - Agent for WebLogic Serverを管理するPFM - Managerを設定します。
- jpcconf mgrhost define(jpcnshostname)コマンドを実行して,接続先PFM - Managerを設定する。
次のようにコマンドを実行します。
接続先PFM - Managerのホスト名は,-sオプションで指定します。接続先PFM - Managerが論理ホスト運用されている場合は,-sオプションに接続先PFM - Managerの論理ホスト名を指定します。ここでは,PFM - Managerの論理ホスト名をjp1-halとしています。
jpcconf mgrhost define -s jp1-hal -lhost jp1-hals(jpcnshostname -s jp1-hal -lhost jp1-hals)
また,PFM - Agent for WebLogic Serverの論理ホスト名は,-lhostオプションで指定します。ここでは,PFM - Agent for WebLogic Serverの論理ホスト名をjp1-halsとしています。
jpcconf inst setup(jpcinssetup)コマンドを実行して,PFM - Agent for WebLogic Serverのインスタンス環境を設定します。
設定手順は,非クラスタシステムの場合と同じです。ただし,クラスタシステムの場合,jpcconf inst setup(jpcinssetup)コマンドの実行時に,「-lhost」で論理ホスト名を指定する必要があります。
クラスタシステムの場合のjpcconf inst setup(jpcinssetup)コマンドの指定方法を次に示します。
jpcconf inst setup -key WebLogic -lhost 論理ホスト名 -inst インスタンス名(jpcinssetup agts -lhost 論理ホスト名 -inst インスタンス名)このほかの設定内容,および手順については,「2.1.4(2) インスタンス環境の設定」を参照してください。
(6) 他Performance Managementプログラムの論理ホストのセットアップ
PFM - Agent for WebLogic Serverのほかに,同じ論理ホストにセットアップするPFM - ManagerやPFM - Agentがある場合は,この段階でセットアップしてください。
セットアップ手順については,マニュアル「JP1/Performance Management 運用ガイド」の,クラスタシステムでの構築と運用について説明している章,または各PFM - Agentマニュアルの,クラスタシステムでの運用について説明している章を参照してください。
Performance Managementを使用するネットワーク構成に応じて,変更する場合にだけ必要な設定です。
ネットワークの設定では次の二つの項目を設定できます。
- IPアドレスを設定する
複数のLANに接続されたネットワーク環境でPerformance Managementを運用するときに使用するIPアドレスを指定したい場合には,jpchostsファイルの内容を直接編集します。
このとき,編集したjpchostsファイルは,実行系ノードから待機系ノードにコピーしてください。
IPアドレスの設定方法については,マニュアル「JP1/Performance Management 設計・構築ガイド」のインストールとセットアップについて説明している章を参照してください。
- ポート番号を設定する
ファイアウォール経由でPerformance Managementのプログラム間の通信をする場合には,jpcconf port(jpcnsconfig port)コマンドを使用してポート番号を設定します。
ポート番号の設定方法については,マニュアル「JP1/Performance Management 設計・構築ガイド」の,インストールとセットアップについて説明している章,およびマニュアル「JP1/Performance Management 運用ガイド」のクラスタシステムでの構築と運用について説明している章を参照してください。
Performance Managementの稼働状況を,Performance Management独自のログファイルに出力します。このログファイルを「共通メッセージログ」と呼びます。共通メッセージログは,デフォルトで2,048キロバイトのファイルが2個使用されます。このファイルサイズを変更したい場合に必要な設定です。
詳細については,マニュアル「JP1/Performance Management 設計・構築ガイド」の,インストールとセットアップについて説明している章を参照してください。
PFM - Agentで管理されるパフォーマンスデータを格納するデータベースの保存先,バックアップ先,エクスポート先,またはインポート先のフォルダを変更したい場合に必要な設定です。
設定方法については,「2.4.1 パフォーマンスデータの格納先の変更」を参照してください。
アラーム発生時に動作ログを出力したい場合に必要な設定です。動作ログとは,システム負荷などのしきい値オーバーに関するアラーム機能と連動して出力される履歴情報です。
設定方法については,「付録I 動作ログの出力」を参照してください。
PFM - Agent for WebLogic Serverの論理ホスト環境が作成できたら,環境定義をファイルにエクスポートします。エクスポートでは,その論理ホストにセットアップされているPerformance Managementのプログラムの定義情報を一括してファイル出力します。同じ論理ホストにほかのPerformance Managementのプログラムをセットアップする場合は,セットアップが一とおり済んだあとにエクスポートしてください。
手順を次に示します。
- jpcconf ha export(jpchasetup export)コマンドを実行して,論理ホスト環境定義をエクスポートする。
これまでの手順で作成した論理ホスト環境の定義情報を,エクスポートファイルに出力します。エクスポートファイル名は任意です。
例えば,lhostexp.txtファイルに論理ホスト環境定義をエクスポートする場合,次のようにコマンドを実行します。
jpcconf ha export -f lhostexp.txt(jpchasetup export -f lhostexp.txt)
(12) 論理ホスト環境定義ファイルの待機系ノードへのコピー
エクスポートした論理ホスト環境定義ファイルを,実行系ノードから待機系ノードにコピーします。
クラスタソフトからの操作やボリュームマネージャの操作などで,共有ディスクをオフラインにして,作業を終了します。なお,その共有ディスクを続けて使用する場合は,オフラインにする必要はありません。
実行系ノードからコピーしたエクスポートファイルを,待機系ノードにインポートします。
実行系ノードで作成した論理ホストのPerformance Managementのプログラムを,待機系ノードで実行するための設定には,jpcconf ha import(jpchasetup import)コマンドを使用します。一つの論理ホストに複数のPerformance Managementのプログラムがセットアップされている場合は,一括してインポートされます。
なお,このコマンドを実行するときには,共有ディスクをオンラインにしておく必要はありません。
手順を次に示します。
- jpcconf ha import(jpchasetup import)コマンドを実行して,論理ホスト環境定義をインポートする。
次のようにコマンドを実行します。
コマンドを実行すると,待機系ノードの環境を,エクスポートファイルの内容と同じ環境になるように設定変更します。これによって,論理ホストのPFM - Agent for WebLogic Serverを起動するための設定が実施されます。
jpcconf ha import -f lhostexp.txt(jpchasetup import -f lhostexp.txt)
また,セットアップ時にjpcconf port(jpcnsconfig port)コマンドで固定のポート番号を設定している場合も,同様に設定されます。
- jpcconf ha list(jpchasetup list)コマンドを実行して,論理ホスト設定を確認する。
次のようにコマンドを実行します。
実行系ノードでjpcconf ha list(jpchasetup list)を実行した時と同じ内容が表示されることを確認してください。
jpcconf ha list all(jpchasetup list all)
Performance Managementのプログラムを論理ホスト環境で運用する場合は,クラスタソフトに登録して,クラスタソフトからの制御でPerformance Managementのプログラムを起動したり停止したりするように環境設定します。
クラスタソフトへPFM - Agent for WebLogic Serverを登録する方法は,クラスタソフトのマニュアルを参照してください。
PFM - Agent for WebLogic Serverをクラスタソフトに登録するときの設定内容を,Windows MSCSに登録する項目を例として説明します。
PFM - Agent for WebLogic Serverの場合,次の表のサービスをクラスタソフトに登録します。
表4-3 クラスタソフトに登録するPFM - Agent for WebLogic Serverのサービス
項番 名前 サービス名 依存関係 1 PFM - Agent Store for WebLogicServer インスタンス名 [LHOST] JP1PCAGT_SS_インスタンス名 [LHOST] IPアドレスリソース
物理ディスクリソース2 PFM - Agent for WebLogicServer インスタンス名 [LHOST] JP1PCAGT_SA_インスタンス名 [LHOST] 項番1のクラスタリソース 3 PFM - Action Handler [LHOST] JP1PCMGR_PH [LHOST] IPアドレスリソース
物理ディスクリソース[LHOST]の部分は,論理ホスト名に置き換えてください。
インスタンス名がAPSV,論理ホスト名がjp1-halsの場合,サービスの名前は「PFM - Agent Store for WebLogicServer APSV [jp1-hals]」,サービス名は「JP1PCAGT_SS_APSV [jp1-hals]」のようになります。
MSCSの場合は,これらのサービスをMSCSのリソースとして登録します。各リソースの設定は次のようにします。下記の[ ]は,MSCSで設定する項目です。
- [リソースの種類]は「汎用サービス」として登録する。
- [名前],[サービス名],および[依存関係]を表4-3のとおりに設定する。
なお,名前はサービスを表示するときの名称で,サービス名はMSCSから制御するサービスを指定するときの名称です。
- [起動パラメータ]および[レジストリ複製]は設定しない。
- プロパティの[詳細設定]タブは,Performance Managementのプログラムの障害時にフェールオーバーするかしないかの運用に合わせて設定する。
例えば,PFM - Agent for WebLogic Serverの障害時に,フェールオーバーするように設定するには,次のように設定します。
[再開する]:チェックする
[グループに適用する]:チェックする
再起動試行回数の[しきい値]:3※
- 注※
- 再起動試行回数の[しきい値]は3回を目安に設定してください。
- 注意
- クラスタソフトに登録するサービスは,クラスタソフトから起動および停止を制御しますので,OS起動時に自動起動しないよう[スタートアップの種類]を[手動]に設定してください。なお,jpcconf ha setup(jpchasetup create)コマンドでセットアップした直後のサービスは[手動]に設定されています。また,次のコマンドで強制停止しないでください。
- jpcspm stop all -lhost 論理ホスト名 -kill immediate(jpcstop all lhost=論理ホスト名 kill=immediate)
クラスタソフトからの操作で,Performance Managementのプログラムの起動および停止を各ノードで実行し,正常に動作することを確認してください。
Performance Managementのプログラムのセットアップ終了後,PFM - Web Consoleから,運用に合わせて監視対象の稼働状況についてのレポートを表示できるようにしたり,監視対象で問題が発生したときにユーザーに通知できるようにしたりするために,Performance Managementのプログラムの環境を設定します。
Performance Managementのプログラムの環境設定方法については,マニュアル「JP1/Performance Management 運用ガイド」の,クラスタシステムでの構築と運用について説明している章を参照してください。
Copyright (C) 2009, Hitachi, Ltd.
Copyright (C) 2009, Hitachi Software Engineering Co., Ltd.