JP1/Performance Management - Agent Option for OpenTP1
ここでは,PFM - Agent for OpenTP1を運用するための,セットアップについて説明します。
は使用する環境によって必要になるセットアップ項目,またはデフォルトの設定を変更する場合のオプションのセットアップ項目を示します。
- <この項の構成>
- (1) PFM - Agent for OpenTP1の登録
- (2) インスタンス環境の設定
- (3) ネットワークの設定
- (4) ログのファイルサイズ変更
- (5) パフォーマンスデータの格納先の変更
- (6) PFM - Agent for OpenTP1の接続先PFM - Managerの設定
- (7) 動作ログ出力の設定
(1) PFM - Agent for OpenTP1の登録
PFM - ManagerおよびPFM - Web Consoleを使ってPFM - Agentを一元管理するために,PFM - ManagerおよびPFM - Web ConsoleにPFM - Agent for OpenTP1を登録する必要があります。
PFM - Managerのバージョンが08-50以降の場合,PFM - Agentの登録は自動で行われるため,ここで説明する手順は不要です。ただし,PFM - Managerのリリースノートに記載されていないデータモデルバージョンのPFM - Agentは,手動で登録する必要があります。なお,PFM - Agent for OpenTP1のデータモデルのバージョンについては,「付録I バージョン互換」を参照してください。
PFM - Agentの登録の流れを次に示します。
図2-3 PFM - Agentの登録の流れ
- 注意
- PFM - Agentの登録は,インスタンス環境を設定する前に実施してください。
- すでにPFM - Agent for OpenTP1の情報が登録されているPerformance Managementシステムに,新たに同じバージョンのPFM - Agent for OpenTP1を追加した場合,PFM - Agentの登録は必要ありません。
- バージョンが異なるPFM - Agent for OpenTP1を,異なるホストにインストールする場合,古いバージョン,新しいバージョンの順でセットアップしてください。
- PFM - Managerと同じホストにPFM - Agentをインストールした場合,jpcagtsetupコマンドが自動的に実行されます。共通メッセージログに「KAVE05908-I エージェント追加セットアップは正常に終了しました」と出力されるので,結果を確認してください。コマンドが正しく実行されていない場合は,コマンドを実行し直してください。コマンドの実行方法については,マニュアル「JP1/Performance Management リファレンス」のコマンドの章を参照してください。
(a) PFM - Agent for OpenTP1のセットアップファイルをコピーする
PFM - Agent for OpenTP1をインストールしたホストにあるセットアップファイルをPFM - ManagerおよびPFM - Web Consoleをインストールしたホストにコピーします。手順を次に示します。
- PFM - Web Consoleが起動されている場合は,停止する。
- PFM - Agentのセットアップファイルをバイナリーモードでコピーする。
ファイルが格納されている場所およびファイルをコピーする場所を次の表に示します。
表2-2 コピーするセットアップファイル
コピー先 PFM - Agentの
セットアップファイルPFMプログラム名 OS コピー先ディレクトリ PFM - Manager Windows PFM - Managerのインストール先フォルダ\setup\ インストール先フォルダ\setup\jpcagthw.EXE UNIX /opt/jp1pc/setup/ インストール先フォルダ\setup\jpcagthu.Z PFM - Web Console Windows PFM - Web Consoleのインストール先フォルダ\setup\ インストール先フォルダ\setup\jpcagthw.EXE UNIX /opt/jp1pcwebcon/setup/ インストール先フォルダ\setup\jpcagthu.Z (b) PFM - Managerホストでセットアップコマンドを実行する
PFM - ManagerでPFM - Agent for OpenTP1をセットアップするための次のコマンドを実行します。
jpcagtsetup agth
- 注意
- コマンドを実行するローカルホストのPerformance Managementのプログラムおよびサービスが完全に停止していない状態でjpcagtsetupコマンドを実行した場合,エラーが発生することがあります。その場合は,Performance Managementのプログラムおよびサービスが完全に停止したことを確認したあと,再度jpcagtsetupコマンドを実行してください。
PFM - ManagerホストにあるPFM - Agentのセットアップファイルは,この作業が終了したあと削除してもかまいません。
(c) PFM - Web Consoleホストでセットアップコマンドを実行する
PFM - Web ConsoleでPFM - Agent for OpenTP1をセットアップするための次のコマンドを実行します。
jpcwagtsetupPFM - Web ConsoleホストにあるPFM - Agentのセットアップファイルは,この作業が終了したあと削除してもかまいません。
PFM - Agent for OpenTP1で監視するOpenTP1システムのインスタンス情報を設定します。インスタンス情報の設定は,PFM - Agentホストで実施します。
設定するインスタンス情報を次の表に示します。セットアップの操作を始める前に,次の情報をあらかじめ確認してください。OpenTP1システムのインスタンス情報の詳細については,マニュアル「OpenTP1 運用と操作」を参照してください。
表2-3 PFM - Agent for OpenTP1のインスタンス情報
項目 説明 設定できる値 デフォルト値 DCDIR 監視対象OpenTP1システムの環境変数DCDIRの値(OpenTP1ディレクトリのパス)。 50バイト以内の半角文字列 − DCCONFPATH 監視対象OpenTP1システムの環境変数DCCONFPATHの値(OpenTP1システム定義ファイル格納ディレクトリのパス)。 512バイト以内の半角文字列 − Store Version※ 使用するStoreバージョン。 {1.0 | 2.0} 2.0
- (凡例)
- −:なし
- 注※
- 次に示すどちらかの場合で,初めてインスタンス環境を設定するときに必要です。
- PFM - Agentと同一ホスト上のPFM - Baseが08-10以降の場合
- PFM - Agentと同一ホスト上のPFM - Managerが08-10以降の場合
- 注意
- インスタンス環境を設定していない場合,PFM - Agent for OpenTP1のサービスを起動できません。
インスタンス環境を構築するには,jpcinssetupコマンドを使用します。インスタンス環境の構築手順を次に示します。
- サービスキーおよびインスタンス名を指定して,jpcinssetupコマンドを実行する。
例えば,PFM - Agent for OpenTP1のインスタンス名SDCのインスタンス環境を構築する場合,次のように指定してコマンドを実行します。
jpcinssetup agth -inst SDC- OpenTP1システムのインスタンス情報を設定する。
表2-3に示した項目を,コマンドの指示に従って入力してください。各項目とも省略はできません。デフォルトで表示されている値を,項目の入力とする場合はリターンキーだけを押してください。
すべての入力が終了すると,インスタンス環境が構築されます。構築されるインスタンス環境を次に示します。
- インスタンス環境のフォルダ構成
インストール先フォルダ\agth下にインスタンス環境が構築されます。
構築されるインスタンス環境のフォルダ構成を次に示します。
表2-4 インスタンス環境のフォルダ構成
フォルダ名・ファイル名 説明 agent インスタンス名 jpcagt.ini Agent Collectorサービス起動情報ファイル jpcagt.ini.model※1 Agent Collectorサービス起動情報ファイルのモデルファイル log ログファイル格納フォルダ store インスタンス名 jpcsto.ini Agent Storeサービス起動情報ファイル jpcsto.ini.model※1 Agent Storeサービス起動情報ファイルのモデルファイル imoport※2 インポート先フォルダ partial※2 部分バックアップ先フォルダ *.DAT データモデル定義ファイル dump エクスポート先フォルダ backup バックアップ先フォルダ log ログファイル格納フォルダ
- 注※1
- インスタンス環境を構築した時点の設定値に戻したいときに使用します。
- 注※2
- Storeバージョン2.0を使用しているときだけ作成されます。
- インスタンス環境のサービスID
インスタンス環境のサービスIDは,プロダクトID,機能ID,インスタンス番号,デバイスIDをつないだ文字列になります。例えばサービスID「PN1001」は,次のインスタンス環境を表します。
サービスIDについては,マニュアル「JP1/Performance Management システム構築・運用ガイド」の,付録を参照してください。
- プロダクトID:P
- 機能ID:N
- インスタンス番号:1
- デバイスID:001
- インスタンス環境のWindowsのサービス名
インスタンス環境のWindowsのサービス名は次のようになります。
Windowsのサービス名については,マニュアル「JP1/Performance Management システム構築・運用ガイド」の,付録を参照してください。
- Agent Collectorサービス:PFM - Agent for OpenTP1 インスタンス名
- Agent Storeサービス:PFM - Agent for OpenTP1 インスタンス名
Performance Managementを使用するネットワーク構成に応じて,変更する場合にだけ必要な設定です。
ネットワークの設定では次の二つの項目を設定できます。
- IPアドレスを設定する
Performance Managementを複数のLANに接続されたネットワークで使用するときに設定します。複数のIPアドレスを設定するには,jpchostsファイルにホスト名とIPアドレスを定義します。設定したjpchostsファイルはPerformance Managementシステム全体で統一させてください。
詳細についてはマニュアル「JP1/Performance Management システム構築・運用ガイド」の,インストールとセットアップについて説明している章を参照してください。
- ポート番号を設定する
Performance Managementが使用するポート番号を設定できます。運用での混乱を避けるため,ポート番号とサービス名は,Performance Managementシステム全体で統一させてください。
ポート番号の設定の詳細についてはマニュアル「JP1/Performance Management システム構築・運用ガイド」の,インストールとセットアップについて説明している章を参照してください。
Performance Managementの稼働状況を,Performance Management独自のログファイルに出力します。このログファイルを「共通メッセージログ」と呼びます。共通メッセージログは,デフォルトで2,048キロバイトのファイルが2ファイル使用されます。このファイルサイズを変更したい場合にだけ,必要な設定です。
詳細については,マニュアル「JP1/Performance Management システム構築・運用ガイド」の,構成変更について説明している章を参照してください。
PFM - Agent for OpenTP1で管理されるパフォーマンスデータの格納先を変更したい場合に,必要な設定です。
パフォーマンスデータの格納先は次のとおりです。
- 保存先:インストール先フォルダ\agth\store\インスタンス名\
- バックアップ先:インストール先フォルダ\agth\store\インスタンス名\backup\
- 部分バックアップ先※:インストール先フォルダ\agth\store\インスタンス名\partial\
- エクスポート先:インストール先フォルダ\agth\store\インスタンス名\dump\
- インポート先※:インストール先フォルダ\agth\store\インスタンス名\import\
- 注※
- Storeバージョン2.0を使用しているときだけ設定できます。
詳細については,「2.4.1 パフォーマンスデータの格納先の変更」を参照してください。
(6) PFM - Agent for OpenTP1の接続先PFM - Managerの設定
PFM - Agentがインストールされているホストで,そのPFM - Agentを管理するPFM - Managerを設定します。接続先のPFM - Managerを設定するには,jpcnshostnameコマンドを使用します。
- 注意
- 同一ホスト上に,複数のPFM - Agentがインストールされている場合でも,接続先に指定できるPFM - Managerは,一つだけです。PFM - Agentごとに異なるPFM - Managerを接続先に設定することはできません。
- PFM - AgentとPFM - Managerが同じホストにインストールされている場合,接続先PFM - ManagerはローカルホストのPFM - Managerとなります。この場合,接続先のPFM - ManagerをほかのPFM - Managerに変更できません。
手順を次に示します。
- Performance Managementのプログラムおよびサービスを停止する
セットアップを実施する前に,ローカルホストでPerformance Managementのプログラムおよびサービスが起動されている場合は,すべて停止してください。サービスの停止方法については,マニュアル「JP1/Performance Management システム構築・運用ガイド」の,サービスの起動と停止について説明している章を参照してください。
jpcnshostnameコマンド実行時に,Performance Managementのプログラムおよびサービスが起動されている場合は,停止を問い合わせるメッセージが表示されます。
- 接続先のPFM - Managerホストのホスト名を指定して,jpcnshostnameコマンドを実行する
例えば,接続先のPFM - Managerがホストhost01上にある場合,次のように指定します。
jpcnshostname -s host01
PFMサービスの起動・停止時,またはPFM - Managerとの接続状態の変更時に動作ログを出力したい場合に必要な設定です。動作ログとは,システム負荷などのしきい値オーバーに関するアラーム機能と連動して出力される履歴情報です。
設定方法については,「付録J 動作ログの出力」を参照してください。
All Rights Reserved. Copyright (C) 2006, 2008, Hitachi, Ltd.
All Rights Reserved. Copyright (C) 2007, 2008, Hitachi Software Engineering Co.,Ltd.