PFM - RM for Platformのセットアップ手順について説明します。
なお,ここでのは,次に示すセットアップ項目を示します。
(1) LANG環境変数の設定
LANG環境変数を設定します。
PFM - RM for Platformで使用できるLANG環境変数を次の表に示します。これらのLANG環境変数の設定前に,設定する言語環境が正しくインストールおよび構築されていることを確認してください。インストールや構築が不正な場合,文字化けが発生したり,定義データが不当に書き換えられたりすることがあります。
表2-24 PFM - RM for Platformで使用できるLANG環境変数
項番 | 言語種別 | LANG 環境変数の値 | |
---|---|---|---|
1 | 日本語 | UTF-8コード |
|
2 | 英語(日本語なし) | C |
(2) PFM - RM for Platformの登録
Performance ManagementシステムでPFM - RM for Platformを一元管理するには,PFM - ManagerおよびPFM - Web Consoleに,PFM - RM for Platformを登録する必要があります。
PFM - RM for Platformの登録は,次のタイミングで実施する必要があります。
PFM - RM for Platformを登録する作業の流れを次の図に示します。
図2-15 PFM - RM for Platformを登録する作業の流れ(UNIXの場合)
以降で,PFM - RM for Platformを登録する作業について説明します。
(a) PFM - RM for Platformのセットアップファイルをコピーする
PFM - RMホストにあるセットアップファイルを,PFM - ManagerとPFM - Web Consoleのインストール先ホストにコピーします。
コピーする手順を次に示します。
表2-25 コピーするセットアップファイル(UNIXの場合)
項番 | コピー元 (PFM - RM for Platformの セットアップファイル) | コピー先 | ||
---|---|---|---|---|
プログラム名 | OS | コピー先フォルダ | ||
1 | /opt/jp1pc/setup/jpcagt7w.EXE | PFM - Manager | Windows | PFM - Managerのインストール先フォルダ¥setup |
2 | /opt/jp1pc/setup/jpcagt7u.Z | UNIX | /opt/jp1pc/setup/ | |
3 | /opt/jp1pc/setup/jpcagt7w.EXE | PFM - Web Console | Windows | PFM - Web Consoleのインストール先フォルダ¥setup |
4 | /opt/jp1pc/setup/jpcagt7u.Z | UNIX | /opt/jp1pcwebcon/setup/ |
(b) PFM -Managerホストでセットアップコマンドを実行する
PFM -ManagerホストでPFM - RM for Platformのセットアップコマンドを実行します。
実行するコマンドを次に示します。
/opt/jp1pc/tools/jpcconf agent setup -key RMPlatform
ここでは,対話形式の実行例を示していますが,jpcconf agent setupコマンドは非対話形式でも実行できます。jpcconf agent setupコマンドの詳細については,マニュアル「JP1/Performance Management リファレンス」のコマンドについて説明している章を参照してください。
PFM -Managerホストでセットアップコマンドを実行したら,PFM - ManagerにコピーしたPFM - RM for Platformのセットアップファイルは,削除しても問題ありません。
(c) PFM - Web Consoleホストでセットアップコマンドを実行する
PFM - Web ConsoleホストでPFM - RM for Platformのセットアップコマンドを実行します。
実行するコマンドを次に示します。
/opt/jp1pcwebcon/tools/jpcwagtsetup
PFM - Web Consoleホストでセットアップコマンドを実行したら,PFM - Web ConsoleにコピーしたPFM - RM for Platformのセットアップファイルは,削除しても問題ありません。
(3) インスタンス環境の設定
PFM - RM for Platformのインスタンス環境をPFM - RMホストで設定します。複数のインスタンス環境を設定したい場合は,ここでの手順を繰り返し実施してください。
インスタンス環境の設定項目を次の表に示します。操作の開始前に情報をあらかじめ確認してください。
表2-26 PFM - RM for Platformのインスタンス環境の設定項目(UNIXの場合)
項番 | 項目名※1 | 説明 | 設定値 | デフォルト | jpcconf inst setupコマンドによる 再更新可否 |
---|---|---|---|---|---|
1 | Interval | 収集プロセスの収集間隔を指定します。 | 60~3,600(単位:秒)を指定します。 | 300 | ○ |
2 | Std_Category※2 | 収集プロセスで基本的な情報(PI,PI_CPUレコード)を収集するかどうかを指定します。 | 次に示すどちらかを指定します。
| Y | ○ |
3 | Disk_Category※2 | 収集プロセスでディスク情報(PI_PDSK,PI_LDSKレコード)を収集するかどうかを指定します。 | 次に示すどちらかを指定します。
| Y | ○ |
4 | Network_Category※2 | 収集プロセスでネットワーク情報(PI_NETレコード)を収集するかどうかを指定します。 | 次に示すどちらかを指定します。
| Y | ○ |
5 | Ps_Category※2 | 収集プロセスでプロセス情報(PD_APS,PD_ASVC,PD_APP2,PD_APPC,PD_APPDレコード)を収集するかどうかを指定します。 | 次に示すどちらかを指定します。
| Y | ○ |
6 | Log_Size | エージェントログ※3の1ファイルの最大サイズを指定します。 | 1~32(単位:メガバイト)を指定します。 推奨は3以上です。 | 3 | ○ |
インスタンス環境の設定には,jpcconf inst setupコマンドを使用します。
次に,jpcconf inst setupコマンドの実行手順を,対話形式の場合と非対話形式の場合に分けて説明します。jpcconf inst setupコマンドの詳細については,マニュアル「JP1/Performance Management リファレンス」のコマンドについて説明している章を参照してください。
●対話形式で実行する場合
/opt/jp1pc/tools/jpcconf inst setup -key RMPlatform -inst inst1
/opt/jp1pc/tools>jpcconf inst setup -key RMPlatform -inst inst1
Interval [300] :<Enter>
Std_Category [Y] :<Enter>
Disk_Category [Y] :<Enter>
Network_Category [Y] :<Enter>
Ps_Category [Y] :<Enter>
Log_Size (MB) [3] :<Enter>
KAVE05080-I インスタンス環境を作成しています (servicekey※=RMPlatform, inst=inst1)
KAVE05081-I インスタンス環境が作成されました (servicekey※=RMPlatform, inst=inst1)
●非対話形式で実行する場合
/opt/jp1pc/tools/jpcconf inst setup -key RMPlatform -noquery -template 定義ファイル名
[Common Definitions] |
/opt/jp1pc/tools/jpcconf inst setup -key RMPlatform -inst inst1 -noquery -input 定義ファイル名
すべての設定が完了すると,インスタンス環境が構築されます。インスタンス環境のディレクトリ構成を次の表に示します。
表2-27 インスタンス環境のディレクトリ構成(UNIXの場合)
項番 | 格納先ディレクトリ | ファイル名 | 説明 |
---|---|---|---|
1 | /opt※1/jp1pc/agt7/agent/インスタンス名 | jpcagt.ini | Remote Monitor Collectorサービス起動情報ファイルです。 |
2 | jpcagt.ini.lck | Remote Monitor Collectorサービス起動情報ファイル(インスタンスごと)のロックファイルです。 | |
3 | jpcagt.ini.model※2 | Remote Monitor Collectorサービス起動情報ファイルのモデルファイルです。 | |
4 | status.dat | 内部処理用中間ファイルです。 | |
5 | tstatuses.dat | 仮想Agentステータス情報です。※3 | |
6 | targetlist.ini | 監視対象一覧です。 | |
7 | grouplist.ini | グループ一覧です。 | |
8 | GARULES.DAT | グループ化ルールの記述ファイルです。 | |
9 | targets | リモートエージェント格納フォルダです。 | |
10 | groups | グループエージェント格納フォルダです。 | |
11 | log | ログファイル格納フォルダです。 | |
12 | /opt※1/jp1pc/agt7/store/インスタンス名 | *.DB | パフォーマンスデータファイルです。 |
13 | *.IDX | パフォーマンスデータファイルのインデックスファイルです。 | |
14 | *.LCK | パフォーマンスデータファイルのロックファイルです。 | |
15 | jpcsto.ini | Remote Monitor Storeサービス起動情報ファイルです。 | |
16 | jpcsto.ini.model※2 | Remote Monitor Storeサービス起動情報ファイルのモデルファイルです。 | |
17 | status.dat | 内部処理用中間ファイルです。 | |
18 | *.DAT | データモデル定義ファイルです。 | |
19 | dump | エクスポート先フォルダです。 | |
20 | backup | バックアップ先フォルダです。 | |
21 | partial | 部分バックアップ用フォルダです。 | |
22 | import | インポート用フォルダです。 | |
23 | log | ログファイル格納フォルダです。 |
インスタンス環境を変更したい場合は,再度jpcconf inst setupコマンドを実行し,インスタンス環境の各設定項目を更新してください。インスタンス環境の各設定項目を更新する詳細については,「2.6.2 インスタンス環境の更新」を参照してください。
設定した一部の情報は,PFM - Web Consoleのプロパティ編集で変更できます。プロパティ編集で変更できる情報の詳細については,「付録E.2 Remote Monitor Collectorサービスのプロパティ一覧」を参照してください。
なお,インスタンス環境でのサービスIDは次のようになります。
(4) 監視対象の設定
「(3) インスタンス環境の設定」で設定したインスタンスに監視対象ホストの情報を設定します。一つのインスタンスに対して,複数の監視対象ホストを設定できます。複数の監視対象ホストを設定する場合は,この手順を繰り返し実施してください。
なお,監視対象には必ず物理ホストを設定してください。PFM - RM for Platformでは,論理ホストの監視はサポートしていません。
監視対象ホストの設定項目を次の表に示します。操作の開始前に情報をあらかじめ確認してください。
表2-28 PFM - RM for Platformの監視対象ホストの設定項目
項番 | 項目名※1 | 説明 | 設定値 | デフォルト | jpcconf target setupコマンドによる 再更新可否 |
---|---|---|---|---|---|
1 | Target Host | 監視対象ホスト名を指定します。名前解決できるようなホスト名※2を指定してください。 指定した監視対象ホスト名は,稼働性能情報の収集とヘルスチェックの際に使用されます。JP1/IMまたはNNMと連携する場合はイベントホスト名としても使用されます。 | 1~32バイトの半角英数字と「-」だけ使用できます。 ただし,「-」から始まる名前は指定できません。 指定する値はインスタンス内でユニーク※3である必要があります。 | 監視対象ホスト名は指定されていません。※4 | ○ |
2 | User※5 | 監視対象ホストにログインするためのユーザーを指定します。 PFM - RM for Platformはこのユーザーで監視対象ホストにログインし,パフォーマンスデータを収集します。 | 1~256バイトの半角文字が使用できます。 ただし,タブは指定できません。 | - | ○ |
3 | Private_Key_File | SSH公開鍵方式で使用する秘密鍵ファイル※6の名前を指定します。 | 1~256バイトの半角文字が使用できます。 ただし,タブは指定できません。 | /opt/jp1pc/agt7/.ssh/agt7 | ○ |
4 | Port | 監視対象ホスト上のSSHサーバのポート番号を指定します。 | 1~65,535を指定します。 | 22 | ○ |
監視対象ホストの設定には,jpcconf target setupコマンドを使用します。
次に,jpcconf target setupコマンドの実行手順を,対話形式の場合と非対話形式の場合に分けて説明します。jpcconf target setupコマンドの詳細については,マニュアル「JP1/Performance Management リファレンス」のコマンドについて説明している章を参照してください。
●対話形式で実行する場合
/opt/jp1pc/tools/jpcconf target setup -key RMPlatform -inst inst1 -target targethost1
/opt/jp1pc/tools>jpcconf target setup -key RMPlatform -inst inst1 -target targethost1
Target Host [] :targethost1<Enter>
User :ssh-user<Enter>
Private_Key_File [/opt/jp1pc/agt7/.ssh/agt7]:<Enter>
Port [22※1] :<Enter>
KAVE05361-I 監視対象を追加しています (servicekey※2=RMPlatform, inst=inst1, target=targethost1)
KAVE05362-I 監視対象が追加されました (servicekey※2=RMPlatform, inst=inst1, target=targethost1)
●非対話形式で実行する場合
/opt/jp1pc/tools/jpcconf target setup -key RMPlatform -noquery -template 定義ファイル名
[Common Definitions] |
/opt/jp1pc/tools/jpcconf target setup -key RMPlatform -inst inst1 -target targethost1 -input 定義ファイル名 -noquery
すべての設定が完了すると,監視対象の環境が構築されます。監視対象の環境のディレクトリ構成を次の表に示します。
表2-29 監視対象の環境のディレクトリ構成
項番 | 格納先ディレクトリ | ファイル名 | 説明 |
---|---|---|---|
1 | /opt※/jp1pc/agt7/agent/インスタンス名/targets | 監視対象名.ini | 監視対象設定ファイルです。 |
2 | 監視対象名.ini.model | 監視対象設定ファイルのモデルファイルです。 | |
3 | /opt※/jp1pc/agt7/agent/インスタンス名/targets/監視対象名 | - | 監視対象用の作業ディレクトリです。 |
なお,監視対象の設定で追加されるサービスIDは次のようになります。
監視対象の情報を変更したい場合は,再度jpcconf target setupコマンドを実行し,監視対象の情報を更新してください。監視対象の更新の詳細については,「2.6.3 監視対象の更新」を参照してください。
設定した一部の情報は,PFM - Web Consoleのプロパティ編集で変更できます。プロパティ編集で変更できる情報の詳細については,「付録E.3 リモートエージェントとグループエージェントのプロパティ一覧」を参照してください。
(5) ネットワークの設定
Performance Managementを使用するネットワーク構成に応じて,ネットワーク環境の設定を変更したい場合に必要な設定です。
ネットワーク環境の設定として,次の二つの項目があります。必要に応じて設定を変更してください。
(6) ログのファイルサイズの変更
Performance Managementの稼働状況はPerformance Management独自のログファイルに出力されます。このログファイルのサイズを変更したい場合に必要な設定です。
共通メッセージログは,デフォルトで2,048キロバイトのファイルを2ファイル使用します。共通メッセージログの変更の詳細については,マニュアル「JP1/Performance Management 設計・構築ガイド」のインストールとセットアップについて説明している章を参照してください。
(7) パフォーマンスデータの格納先の変更
PFM - RM for Platformで管理されるパフォーマンスデータの次の内容を変更したい場合に必要な設定です。
パフォーマンスデータの格納先の変更については,「2.6.1 パフォーマンスデータの格納先の変更」を参照してください。
(8) 接続先PFM - Managerの設定
PFM - RMホストで,PFM - RM for Platformを管理するPFM - Managerについて設定します。この設定では,jpcconf mgrhost defineコマンドを使用します。
接続先のPFM - Managerを設定する手順を次に示します。
/opt/jp1pc/tools/jpcconf mgrhost define -host host01
(9) 動作ログの出力設定
次に示すタイミングで動作ログを出力したい場合に必要な設定です。
動作ログとは,システム負荷などによるしきい値オーバー情報をアラーム機能と連動して出力される履歴情報のことです。動作ログの出力設定の詳細については,「付録I 動作ログの出力」を参照してください。