ここでは,PFM - Agent for OpenTP1を運用するための,セットアップについて説明します。
は使用する環境によって必要になるセットアップ項目,またはデフォルトの設定を変更する場合のオプションのセットアップ項目を示します。
(1) LANG環境変数の設定
PFM - Agent for OpenTP1で使用できるLANG環境変数を次の表に示します。
なお,これらのLANG環境変数を設定する前に,設定する言語環境が正しくインストール・構築されていることを確認しておいてください。正しくインストール・構築されていない場合,文字化けが発生したり,定義データが不当に書き換わってしまったりすることがあります。
表3-2 PFM - Agent for OpenTP1で使用できるLANG環境変数
OS | 言語種別 | LANG環境変数の値 | |
---|---|---|---|
AIX | 日本語 | Shift-JISコード | Ja_JP |
EUCコード | ja_JP | ||
英語(日本語なし) | C | ||
Linux | 日本語 | Shift-JISコード | (該当なし) |
EUCコード | (該当なし) | ||
UTF-8コード | ja_JP.UTF-8 | ||
英語(日本語なし) | C |
(2) 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の登録の流れを次の図に示します。
図3-4 PFM - Agentの登録の流れ
(a) PFM - Agent for OpenTP1のセットアップファイルをコピーする
PFM - Agent for OpenTP1をインストールしたホストにあるセットアップファイルをPFM - ManagerおよびPFM - Web Consoleをインストールしたホストにコピーします。手順を次に示します。
表3-3 コピーするセットアップファイル
コピー先 | PFM - Agentの セットアップファイル | ||
---|---|---|---|
PFMプログラム名 | OS | コピー先ディレクトリ | |
PFM - Manager | Windows | PFM - Managerのインストール先フォルダ¥setup¥ | /opt/jp1pc/setup/jpcagthw.EXE |
UNIX | /opt/jp1pc/setup/ | /opt/jp1pc/setup/jpcagthu.Z | |
PFM - Web Console | Windows | PFM - Web Consoleのインストール先フォルダ¥setup¥ | /opt/jp1pc/setup/jpcagthw.EXE |
UNIX | /opt/jp1pcwebcon/setup/ | /opt/jp1pc/setup/jpcagthu.Z |
(b) PFM - Managerホストでセットアップコマンドを実行する
PFM - ManagerでPFM - Agent for OpenTP1をセットアップするための次のコマンドを実行します。
jpcconf agent setup -key OpenTP1(jpcagtsetup agth)
PFM - ManagerホストにあるPFM - Agentのセットアップファイルは,この作業が終了したあと,削除してもかまいません。
(c) PFM - Web Consoleホストでセットアップコマンドを実行する
PFM - Web ConsoleでPFM - Agent for OpenTP1をセットアップするための次のコマンドを実行します。
jpcwagtsetup
PFM - Web ConsoleホストにあるPFM - Agentのセットアップファイルは,この作業が終了したあと削除してもかまいません。
(3) インスタンス環境の設定
PFM - Agent for OpenTP1で監視するOpenTP1システムのインスタンス情報を設定します。インスタンス情報の設定は,PFM - Agentホストで実施します。
設定するインスタンス情報を次の表に示します。セットアップの操作を始める前に,次の情報をあらかじめ確認してください。OpenTP1システムのインスタンス情報の詳細については,OpenTP1のマニュアルを参照してください。
表3-4 PFM - Agent for OpenTP1のインスタンス情報
項目 | 説明 | 設定できる値 | デフォルト値 |
---|---|---|---|
DCDIR | 監視対象OpenTP1システムの環境変数DCDIRの値(OpenTP1ディレクトリのパス)。 | Linuxの場合:20バイト以内の半角文字列 Linux以外の場合:50バイト以内の半角文字列 | - |
DCCONFPATH | 監視対象OpenTP1システムの環境変数DCCONFPATHの値(OpenTP1システム定義ファイル格納ディレクトリのパス)。 | 512バイト以内の半角文字列 | - |
OPENTP1_ADMIN | OpenTP1管理者のユーザー名。 | 255バイト以内の半角文字列 | - |
OPENTP1_LIBPATH | OpenTP1管理者の共用ライブラリーパス。 AIXの場合:環境変数LIBPATHと同じ値 Linuxの場合:環境変数LD_LIBRARY_PATHと同じ値 | 512バイト以内の半角文字列 | - |
Store Version※ | 使用するStoreバージョン。 | {1.0 | 2.0} | 2.0 |
インスタンス環境を構築するには,jpcconf inst setup(jpcinssetup)コマンドを使用します。インスタンス環境の構築手順を次に示します。
jpcconf inst setup -key OpenTP1 -inst SDC(jpcinssetup agth -inst SDC)
すべての入力が終了すると,インスタンス環境が構築されます。構築されるインスタンス環境を次に示します。
表3-5 インスタンス環境のディレクトリ構成
ディレクトリ名・ファイル名 | 説明 | ||
---|---|---|---|
agent | インスタンス名 | jpcagt.ini | Agent Collectorサービス起動情報ファイル |
jpcagt.ini.model※1 | Agent Collectorサービス起動情報ファイルのモデルファイル | ||
log | ログファイル格納ディレクトリ | ||
store | インスタンス名 | jpcsto.ini | Agent Storeサービス起動情報ファイル |
jpcsto.ini.model※1 | Agent Storeサービス起動情報ファイルのモデルファイル | ||
import※2 | インポート先ディレクトリ | ||
partial※2 | 部分バックアップ先ディレクトリ | ||
*.DAT | データモデル定義ディレクトリ | ||
dump | エクスポート先ディレクトリ | ||
backup | バックアップ先ディレクトリ | ||
log | ログファイル格納ディレクトリ |
プロダクトID 機能ID インスタンス番号 インスタンス名 [ホスト名]
(4) ネットワークの設定
Performance Managementを使用するネットワーク構成に応じて,変更する場合にだけ必要な設定です。
ネットワークの設定では次の二つの項目を設定できます。
(5) ログのファイルサイズ変更
Performance Managementの稼働状況を,Performance Management独自のログファイルに出力します。このログファイルを「共通メッセージログ」と呼びます。共通メッセージログは,デフォルトで2,048キロバイトのファイルが2ファイル使用されます。このファイルサイズを変更したい場合にだけ,必要な設定です。
詳細については,マニュアル「JP1/Performance Management 設計・構築ガイド」の,構成変更について説明している章を参照してください。
(6) パフォーマンスデータの格納先の変更
PFM - Agent for OpenTP1で管理されるパフォーマンスデータの格納先を変更したい場合に,必要な設定です。
パフォーマンスデータの格納先は次のとおりです。
詳細については,「3.4.1 パフォーマンスデータの格納先の変更」を参照してください。
(7) PFM - Agent for OpenTP1の接続先PFM - Managerの設定
PFM - Agentがインストールされているホストで,そのPFM - Agentを管理するPFM - Managerを設定します。接続先のPFM - Managerを設定するには,jpcconf mgrhost define(jpcnshostname)コマンドを使用します。
手順を次に示します。
jpcconf mgrhost define -host host01(jpcnshostname -s host01)
(8) 動作ログ出力の設定
PFMサービスの起動・停止時,またはPFM - Managerとの接続状態の変更時に動作ログを出力したい場合に必要な設定です。動作ログとは,システム負荷などのしきい値オーバーに関するアラーム機能と連動して出力される履歴情報です。
設定方法については,「付録J 動作ログの出力」を参照してください。